Merge remote-tracking branch 'origin/develop' into develop

Author: eandreeva-twr

src/locales/zh/adapty-cursor-unity.mdx

@@ -1,7 +1,7 @@
 ---
 title: "借助 AI 将 Adapty 集成到您的 Unity 应用中"
 description: "使用 Cursor、Context7、ChatGPT、Claude 或其他 AI 工具将 Adapty 集成到 Unity 应用的分步指南。"
-metadataTitle: "借助 AI 将 Adapty 集成到 Unity 应用中 | Adapty 文档"
+metadataTitle: "借助 AI 将 Adapty 集成到 Unity 中 | Adapty 文档"
 customSlug: /adapty-cursor-unity
 displayed_sidebar: sdkunity
 ---
@@ -10,9 +10,9 @@ import Zoom from 'react-medium-image-zoom';
 import 'react-medium-image-zoom/dist/styles.css';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
-本指南帮助您借助 LLM 将 Adapty 集成到您的 Unity 应用中。您将从准备 Adapty 看板开始，然后通过向 LLM 发送精准的文档链接，逐步完成每个实现阶段。最后，您还将找到使用 AI 工具配合 Adapty 文档的最佳实践。
+本指南帮助您在 LLM 的辅助下将 Adapty 集成到 Unity 应用中。您将从准备 Adapty 看板开始，然后通过向 LLM 发送精准的文档链接，逐步完成每个实现阶段。在指南末尾，您还将找到使用 AI 工具配合 Adapty 文档的最佳实践。
 :::tip
-复制本页完整 Markdown 内容并粘贴到您的 LLM 中即可开始——点击页面顶部的 **Copy for LLM**，或打开 [.md 版本](https://adapty.io/docs/zh/adapty-cursor-unity.md)。LLM 将根据指南链接和检查点引导您完成每个阶段。
+复制整个页面的 Markdown 内容并粘贴到您的 LLM 中以开始使用——点击页面顶部的 **Copy for LLM**，或打开 [.md 版本](https://adapty.io/docs/zh/adapty-cursor-unity.md)。LLM 将使用指南链接和检查点引导您完成每个阶段。
 :::
 ## 开始之前：看板配置 \{#before-you-start-dashboard-setup\}
 
@@ -22,25 +22,25 @@ Adapty 在您编写任何 SDK 代码之前，需要先完成一些看板配置
 Adapty CLI skill 让你的 LLM 直接设置应用、产品、访问等级、付费墙和版位，无需为每个步骤打开看板。你只需要在看板中[连接你的商店](integrate-payments)。
 
 ```
-npx skills add adaptyteam/adapty-cli --skill adapty-cli
+npx skills add adaptyteam/adapty --skill adapty-cli
 ```
 
 添加 skill 后，在你的 agent 中运行 `/adapty-cli`。它将引导你完成每个步骤，包括何时需要打开看板连接你的商店。
 ### 看板配置方式 \{#dashboard-approach\}
 
-如果您倾向于手动配置所有内容，以下是编写任何代码之前所需的准备工作。您的 LLM 无法自动查找看板中的值——您需要自行提供这些信息。
+如果您更倾向于手动配置所有内容，以下是在编写任何代码之前需要准备的内容。您的 LLM 无法为您查找看板中的值——您需要自行提供。
 
 1. **连接您的应用商店**：在 Adapty 看板中，前往 **App settings → General**。如果您的 Unity 应用同时面向两个平台，请同时连接 App Store 和 Google Play。这是购买功能正常运行的必要条件。
    [连接应用商店](integrate-payments)
 2. **复制您的公共 SDK 密钥**：在 Adapty 看板中，前往 **App settings → General**，找到 **API keys** 部分。在代码中，这是您传递给 Adapty 配置构建器的字符串。
 
-3. **至少创建一个产品**：在 Adapty 看板中，前往 **Products** 页面。您无需在代码中直接引用产品——Adapty 通过付费墙来分发产品。
+3. **至少创建一个产品**：在 Adapty 看板中，前往 **Products** 页面。您无需在代码中直接引用产品——Adapty 通过付费墙来分发它们。
    [添加产品](quickstart-products)
-4. **创建付费墙和版位**：在 Adapty 看板中，在 **Paywalls** 页面创建付费墙，然后在 **Placements** 页面将其分配到一个版位。在代码中，版位 ID 是您传递给 `Adapty.GetPaywall("YOUR_PLACEMENT_ID")` 的字符串。
+4. **创建付费墙和版位**：在 Adapty 看板中，在 **Paywalls** 页面创建付费墙，然后在 **Placements** 页面将其分配到一个版位。在代码中，版位 ID 是你传递给 `Adapty.GetPaywall("YOUR_PLACEMENT_ID")` 的字符串。
    [创建付费墙](quickstart-paywalls)
-5. **设置访问等级**：在 Adapty 看板的 **Products** 页面中，为每个产品进行配置。在代码中，通过 `profile.AccessLevels["premium"]?.IsActive` 检查相应字符串。默认的 `premium` 访问等级适用于大多数应用。如果付费用户根据所购产品获得不同功能的访问权限（例如 `basic` 方案与 `pro` 方案），请在开始编写代码前[创建额外的访问等级](assigning-access-level-to-a-product)。
+5. **设置访问等级**：在 Adapty 看板的 **Products** 页面中，为每个产品进行配置。在代码中，通过 `profile.AccessLevels["premium"]?.IsActive` 字符串进行检查。默认的 `premium` 访问等级适用于大多数应用。如果付费用户根据产品获得不同功能的访问权限（例如，`basic` 计划与 `pro` 计划），请在开始编写代码前[创建额外的访问等级](assigning-access-level-to-a-product)。
 :::tip
-一旦您集齐了这五项信息，就可以开始编写代码了。告诉您的 LLM："我的 Public SDK key 是 X，我的版位 ID 是 Y"，这样它就能生成正确的初始化和付费墙获取代码。
+一旦您拥有这五项信息，就可以开始编写代码了。告诉您的 LLM："我的公共 SDK 密钥是 X，我的版位 ID 是 Y"，这样它就能生成正确的初始化和付费墙获取代码。
 :::
 ### 准备就绪后进行设置 \{#set-up-when-ready\}
 
@@ -53,23 +53,23 @@ npx skills add adaptyteam/adapty-cli --skill adapty-cli
 ## 将 Adapty 文档输入到您的 LLM \{#feed-adapty-docs-to-your-llm\}
 ### 使用 Context7（推荐）\{#use-context7-recommended\}
 
-[Context7](https://context7.com) 是一个 MCP 服务器，可让您的 LLM 直接访问最新的 Adapty 文档。您的 LLM 会根据您的提问自动获取相关文档——无需手动粘贴 URL。
+[Context7](https://context7.com) 是一个 MCP 服务器，可让您的 LLM 直接访问最新的 Adapty 文档。您的 LLM 会根据您的提问自动获取相关文档，无需手动粘贴 URL。
 
-Context7 支持 **Cursor**、**Claude Code**、**Windsurf** 及其他兼容 MCP 的工具。如需配置，请运行：
+Context7 支持 **Cursor**、**Claude Code**、**Windsurf** 以及其他兼容 MCP 的工具。运行以下命令即可完成配置：
 
 ```
 npx ctx7 setup
 ```
 
 该命令会自动检测您的编辑器并配置 Context7 服务器。如需手动配置，请参阅 [Context7 GitHub 仓库](https://github.com/upstash/context7)。
-配置完成后，在提示中引用 Adapty 库：
+配置完成后，在你的提示词中引用 Adapty 库：
 
 ```
 Use the adaptyteam/adapty-docs library to look up how to install the Unity SDK
 ```
 
 :::warning
-尽管 Context7 无需手动粘贴文档链接，但实现顺序非常重要。请按照以下[实现演练](#implementation-walkthrough)逐步操作，确保一切正常运行。
+尽管 Context7 消除了手动粘贴文档链接的需求，但实施顺序至关重要。请按照下面的[实施步骤](#implementation-walkthrough)逐步操作，以确保一切正常运行。
 :::
 ### 使用纯文本文档 \{#use-plain-text-docs\}
 
@@ -81,19 +81,19 @@ Use the adaptyteam/adapty-docs library to look up how to install the Unity SDK
 ## 实施演练 \{#implementation-walkthrough\}
 
 本指南的其余部分按实施顺序介绍 Adapty 集成流程。每个阶段包含需要发送给 LLM 的文档、完成后应看到的效果以及常见问题。
-### 规划你的集成 \{#plan-your-integration\}
+### 规划你的集成方案 \{#plan-your-integration\}
 
-在开始编写代码之前，请让你的 LLM 分析你的项目并制定实施计划。如果你的 AI 工具支持规划模式（如 Cursor 或 Claude Code 的 plan 模式），请使用该模式，以便 LLM 在编写任何代码之前，能够同时读取你的项目结构和 Adapty 文档。
+在开始编写代码之前，先让你的 LLM 分析你的项目并制定实现计划。如果你使用的 AI 工具支持规划模式（例如 Cursor 或 Claude Code 的 plan 模式），请使用该模式，这样 LLM 就能在编写任何代码之前同时读取你的项目结构和 Adapty 文档。
 
-告诉你的 LLM 你使用哪种购买方式——这将影响它应该遵循哪些指南：
+告知你的 LLM 你采用的购买方式——这将影响它应参考的指南：
 - [**Adapty 付费墙编辑工具**](adapty-paywall-builder)：您在 Adapty 的无代码编辑工具中创建付费墙，SDK 会自动渲染。
-- [**手动创建的付费墙**](unity-making-purchases)：您在代码中构建自己的付费墙 UI，但仍使用 Adapty 获取产品并处理购买。
-- [**观察者模式**](observer-vs-full-mode)：您保留现有的购买基础设施，仅使用 Adapty 进行分析和集成。
+- [**手动创建付费墙**](unity-making-purchases)：您在代码中构建自己的付费墙 UI，但仍使用 Adapty 获取产品并处理购买。
+- [**观察者模式**](observer-vs-full-mode)：您保留现有的购买基础设施，仅将 Adapty 用于数据分析和集成。
 
-不确定选哪个？请阅读[快速入门中的对比表](unity-quickstart-paywalls)。
+不确定选哪个？请阅读[快速入门中的对比表格](unity-quickstart-paywalls)。
 ### 安装并配置 SDK \{#install-and-configure-the-sdk\}
 
-通过 Unity Package Manager 添加 Adapty SDK 包，并使用您的 Public SDK key 激活。这是基础步骤——没有它，其他功能都无法正常使用。
+通过 Unity Package Manager 添加 Adapty SDK 包，并使用您的 Public SDK key 激活它。这是一切的基础——没有它，其他功能都无法运行。
 
 **指南：** [安装并配置 Adapty SDK](sdk-installation-unity)
 
@@ -102,37 +102,36 @@ Use the adaptyteam/adapty-docs library to look up how to install the Unity SDK
 Read these Adapty docs before writing code:
 - https://adapty.io/docs/zh/sdk-installation-unity.md
 ```
-:::tip[检查点]
+:::tip[Checkpoint]
 - **预期结果：** 项目成功构建并运行。Unity 控制台显示 Adapty 激活日志。
-- **常见问题：** "Public API key is missing" → 检查你是否已将占位符替换为来自 **App settings** 的真实密钥。
+- **常见问题：** "Public API key is missing" → 检查是否已将占位符替换为来自 **App settings** 的真实密钥。
 :::
-### 展示付费墙并处理购买 \{#show-paywalls-and-handle-purchases\}
+### 显示付费墙并处理购买 \{#show-paywalls-and-handle-purchases\}
 
-通过版位 ID 获取付费墙，展示付费墙，并处理购买事件。您需要参考的指南取决于您如何处理购买。
+通过版位 ID 获取付费墙、显示它并处理购买事件。所需指南取决于您处理购买的方式。
 
-在操作过程中，请在沙盒环境中测试每次购买——不要等到最后再测试。设置说明请参阅[在沙盒中测试购买](test-purchases-in-sandbox)。
+在操作过程中随时在沙盒中测试每笔购买——不要等到最后再测试。请参阅[在沙盒中测试购买](test-purchases-in-sandbox)了解设置说明。
 
 <Tabs groupId="paywall-approach">
 
 <TabItem value="builder" label="Paywall Builder" default>
 **指南：**
-- [使用付费墙启用购买（快速入门）](unity-quickstart-paywalls)
+- [使用付费墙启用购买功能（快速入门）](unity-quickstart-paywalls)
 - [获取付费墙编辑工具付费墙及其配置](unity-get-pb-paywalls)
 - [展示付费墙](unity-present-paywalls)
 - [处理付费墙事件](unity-handling-events)
 - [响应按钮操作](unity-handle-paywall-actions)
-将以下内容发送给您的 LLM：
 ```
-在编写代码之前，请阅读以下 Adapty 文档：
+读取以下 Adapty 文档后再编写代码：
 - https://adapty.io/docs/zh/unity-quickstart-paywalls.md
 - https://adapty.io/docs/zh/unity-get-pb-paywalls.md
 - https://adapty.io/docs/zh/unity-present-paywalls.md
 - https://adapty.io/docs/zh/unity-handling-events.md
 - https://adapty.io/docs/zh/unity-handle-paywall-actions.md
 ```
 :::tip[Checkpoint]
-- **预期结果：** 付费墙显示已配置的产品。点击某个产品会触发沙盒购买对话框。
-- **注意事项：** 付费墙为空或出现 `GetPaywall` 错误 → 请确认版位 ID 与看板中的完全一致，且该版位已分配目标受众。
+- **预期结果：** 付费墙显示您配置的产品。点击产品后触发沙盒购买对话框。
+- **常见问题：** 付费墙为空或出现 `GetPaywall` 错误 → 请确认版位 ID 与看板中完全一致，且该版位已分配目标受众。
 :::
 
 </TabItem>
@@ -144,31 +143,30 @@ Read these Adapty docs before writing code:
 - [渲染由远程配置设计的付费墙](present-remote-config-paywalls-unity)
 - [进行购买](unity-making-purchases)
 - [恢复购买](unity-restore-purchase)
-将以下内容发送给您的 LLM：
 ```
-在编写代码之前，请阅读以下 Adapty 文档：
+Read these Adapty docs before writing code:
 - https://adapty.io/docs/zh/unity-quickstart-manual.md
 - https://adapty.io/docs/zh/fetch-paywalls-and-products-unity.md
 - https://adapty.io/docs/zh/present-remote-config-paywalls-unity.md
 - https://adapty.io/docs/zh/unity-making-purchases.md
 - https://adapty.io/docs/zh/unity-restore-purchase.md
 ```
 :::tip[检查点]
-- **预期效果：** 您的自定义付费墙显示从 Adapty 获取的产品。点击某个产品会触发沙盒购买对话框。
-- **注意事项：** 产品数组为空 → 请确认付费墙已在看板中分配了产品，且版位已设置目标受众。
+- **预期：** 你的自定义付费墙显示从 Adapty 获取的产品。点击某个产品会触发沙盒购买对话框。
+- **注意：** 产品数组为空 → 请确认看板中该付费墙已分配产品，且版位已设置目标受众。
 :::
 
 </TabItem>
 
 <TabItem value="observer" label="Observer mode">
 
-**相关指南：**
-- [Observer 模式概览](observer-vs-full-mode)
+**指南：**
+- [Observer 模式概述](observer-vs-full-mode)
 - [实现 Observer 模式](implement-observer-mode-unity)
-- [在 Observer 模式中报告交易](report-transactions-observer-mode-unity)
-:::tip[检查点]
-- **预期效果：** 使用现有购买流程完成沙盒购买后，交易出现在 Adapty 看板的 **Event Feed** 中。
-- **常见问题：** 没有事件 → 请确认您已向 Adapty 上报交易，并且两个应用商店的服务器通知均已配置。
+- [在 Observer 模式下上报交易](report-transactions-observer-mode-unity)
+:::tip[Checkpoint]
+- **预期结果：** 在使用现有购买流程完成沙盒购买后，该交易将出现在 Adapty 看板的 **Event Feed** 中。
+- **注意事项：** 没有事件 → 请确认您已向 Adapty 上报交易，并且已为两个商店配置了服务器通知。
 :::
 
 </TabItem>
@@ -192,7 +190,7 @@ Read these Adapty docs before writing code:
 :::
 ### 识别用户 \{#identify-users\}
 
-将您的应用用户账户与 Adapty 用户画像关联，使购买记录可跨设备持久保存。
+将您的应用用户账户与 Adapty 用户画像关联，以便购买记录在设备间持久保存。
 
 :::important
 如果您的应用无需身份验证，请跳过此步骤。
@@ -205,13 +203,13 @@ Read these Adapty docs before writing code:
 Read these Adapty docs before writing code:
 - https://adapty.io/docs/zh/unity-quickstart-identify.md
 ```
-:::tip[Checkpoint]
-- **预期结果：** 调用 `Adapty.Identify("your-user-id")` 后，看板的 **Profiles** 部分会显示您的自定义用户 ID。
+:::tip[检查点]
+- **预期结果：** 调用 `Adapty.Identify("your-user-id")` 后，看板的 **Profiles** 部分将显示您的自定义用户 ID。
 - **注意事项：** 请在激活之后、获取付费墙之前调用 `Identify`，以避免匿名用户画像归因问题。
 :::
 ### 准备发布 \{#prepare-for-release\}
 
-一旦您的集成在沙盒环境中正常运行，请仔细阅读发布检查清单，确保一切已准备好投入生产环境。
+一旦您的集成在沙盒环境中正常运行，请完成发布检查清单，以确保一切准备就绪可以投入生产。
 
 **指南：** [发布检查清单](release-checklist)
 
@@ -220,13 +218,13 @@ Read these Adapty docs before writing code:
 Read these Adapty docs before releasing:
 - https://adapty.io/docs/zh/release-checklist.md
 ```
-:::tip[Checkpoint]
-- **预期结果：** 所有检查项均已确认：商店连接、服务器通知、购买流程、访问等级检查及隐私要求。
-- **注意事项：** 缺少服务器通知 → 请在 **App settings → iOS SDK** 中配置 App Store 服务器通知，并在 **App settings → Android SDK** 中配置 Google Play 实时开发者通知。
+:::tip[检查点]
+- **预期结果：** 所有清单项均已确认：应用商店连接、服务器通知、购买流程、访问等级检查以及隐私要求。
+- **常见问题：** 缺少服务器通知 → 请在 **App settings → iOS SDK** 中配置 App Store 服务器通知，并在 **App settings → Android SDK** 中配置 Google Play 实时开发者通知。
 :::
 ## 纯文本文档索引文件 \{#plain-text-doc-index-files\}
 
-如果您需要为 LLM 提供超出单个页面范围的更广泛上下文，我们提供了列出或汇总所有 Adapty 文档的索引文件：
-- [`llms.txt`](https://adapty.io/docs/zh/llms.txt)：列出所有页面的 `.md` 链接。这是一种[新兴标准](https://llmstxt.org/)，用于让网站对大语言模型（LLM）可访问。请注意，对于某些 AI 智能体（例如 ChatGPT），您需要下载 `llms.txt` 并将其作为文件上传到对话中。
+如果您需要为您的 LLM 提供超出单个页面范围的更广泛上下文，我们托管了列出或汇总所有 Adapty 文档的索引文件：
+- [`llms.txt`](https://adapty.io/docs/zh/llms.txt)：列出所有页面的 `.md` 链接。这是一项[新兴标准](https://llmstxt.org/)，旨在让 LLM 能够访问网站内容。请注意，对于某些 AI 智能体（例如 ChatGPT），您需要下载 `llms.txt` 并将其作为文件上传到对话中。
 - [`llms-full.txt`](https://adapty.io/docs/zh/llms-full.txt)：将整个 Adapty 文档站点合并为单个文件。体积非常大——仅在需要完整内容时使用。
 - Unity 专用的 [`unity-llms.txt`](https://adapty.io/docs/zh/unity-llms.txt) 和 [`unity-llms-full.txt`](https://adapty.io/docs/zh/unity-llms-full.txt)：平台专属子集，与完整站点相比可节省 token 用量。