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 应用"
+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
 ---
@@ -12,9 +12,9 @@ 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 发送针对性的文档链接，逐步完成每个实现阶段。最后，您还将找到使用 Adapty 文档配置 AI 工具的最佳实践。
 :::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\}
 
@@ -24,25 +24,25 @@ Adapty 在您编写任何 SDK 代码之前，需要先完成一些看板配置
 Adapty CLI 技能让您的 LLM 可以直接设置您的应用、产品、访问等级、付费墙和版位——无需为每个步骤打开看板。您只需在看板中[连接您的应用商店](integrate-payments)即可。
 
 ```
-npx skills add adaptyteam/adapty --skill adapty-cli
+npx skills add adaptyteam/adapty-cli --skill adapty-cli
 ```
 
 添加技能后，在您的 Agent 中运行 `/adapty-cli`。它将引导您完成每个步骤——包括何时打开看板以连接您的应用商店。
 ### 看板配置方式 \{#dashboard-approach\}
 
-如果您更倾向于手动配置所有内容，以下是您在编写任何代码之前所需准备的内容。您的大语言模型无法为您查找看板中的值——您需要自行提供这些值。
+如果您倾向于手动配置所有内容，以下是编写任何代码之前所需的准备工作。您的 LLM 无法为您查找看板中的值——您需要自行提供这些信息。
 
 1. **连接您的应用商店**：在 Adapty 看板中，前往 **App settings → General**。如果您的 Unity 应用同时面向两个平台，请同时连接 App Store 和 Google Play。这是购买功能正常运行的必要条件。
    [连接应用商店](integrate-payments)
-2. **复制您的公共 SDK 密钥**：在 Adapty 看板中，前往 **App settings → General**，找到 **API keys** 部分。在代码中，这是您传递给 Adapty 配置构建器的字符串。
+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\}
 
@@ -55,23 +55,23 @@ npx skills add adaptyteam/adapty --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)。
+此命令会检测您的编辑器并配置 Context7 服务器。如需手动设置，请参阅 [Context7 GitHub 仓库](https://github.com/upstash/context7)。
 配置完成后，在您的提示词中引用 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\}
 
@@ -83,19 +83,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 mode），请使用该模式，以便 LLM 在编写任何代码之前能够读取你的项目结构和 Adapty 文档。
+在开始编写代码之前，请让您的 LLM 分析您的项目并创建实施计划。如果您的 AI 工具支持规划模式（例如 Cursor 或 Claude Code 的 plan mode），请使用该模式，以便 LLM 在编写任何代码之前能够同时读取您的项目结构和 Adapty 文档。
 
-告诉你的 LLM 你使用哪种购买方式——这将影响它应该遵循的指南：
-- [**Adapty 付费墙编辑工具**](adapty-paywall-builder)：您在 Adapty 的无代码编辑工具中创建付费墙，SDK 会自动渲染它们。
-- [**手动创建的付费墙**](unity-making-purchases)：您在代码中构建自己的付费墙 UI，但仍使用 Adapty 获取产品并处理购买。
-- [**观察者模式**](observer-vs-full-mode)：您保留现有的购买基础设施，仅使用 Adapty 进行分析和集成。
+请告诉您的 LLM 您使用哪种购买方式——这将影响它应遵循的指南：
+- [**Adapty 付费墙编辑工具**](adapty-paywall-builder): 您在 Adapty 的无代码编辑工具中创建付费墙，SDK 会自动渲染它们。
+- [**手动创建的付费墙**](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)
 
@@ -108,31 +108,32 @@ Read these Adapty docs before writing code:
 - **预期结果：** 项目成功构建并运行。Unity 控制台显示 Adapty 激活日志。
 - **常见问题：** "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-get-pb-paywalls)
+- [获取付费墙编辑工具的付费墙及其配置](unity-get-pb-paywalls)
 - [展示付费墙](unity-present-paywalls)
 - [处理付费墙事件](unity-handling-events)
 - [响应按钮操作](unity-handle-paywall-actions)
+将以下内容发送给您的 LLM：
 ```
-Read these Adapty docs before writing code:
+在编写代码之前，请阅读以下 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[检查点]
-- **预期结果：** 付费墙显示您配置的产品。点击产品后触发沙盒购买对话框。
+- **预期效果：** 付费墙显示您配置的产品。点击产品会触发沙盒购买对话框。
 - **常见问题：** 付费墙为空或出现 `GetPaywall` 错误 → 请确认版位 ID 与看板中完全一致，且该版位已分配目标受众。
 :::
 
@@ -145,6 +146,8 @@ Read these Adapty docs before writing code:
 - [渲染由远程配置设计的付费墙](present-remote-config-paywalls-unity)
 - [进行购买](unity-making-purchases)
 - [恢复购买](unity-restore-purchase)
+将以下内容发送给您的 LLM：
+
 ```
 Read these Adapty docs before writing code:
 - https://adapty.io/docs/zh/unity-quickstart-manual.md
@@ -154,8 +157,8 @@ Read these Adapty docs before writing code:
 - https://adapty.io/docs/zh/unity-restore-purchase.md
 ```
 :::tip[检查点]
-- **预期效果：** 您的自定义付费墙显示从 Adapty 获取的产品。点击某个产品会触发沙盒购买对话框。
-- **常见问题：** 产品数组为空 → 请确认该付费墙在看板中已分配产品，且该版位已设置目标受众。
+- **预期结果：** 自定义付费墙显示从 Adapty 获取的产品。点击产品会触发沙盒购买对话框。
+- **注意事项：** 产品数组为空 → 请确认已在看板中为付费墙分配了产品，且版位已设置目标受众。
 :::
 
 </TabItem>
@@ -165,10 +168,18 @@ Read these Adapty docs before writing code:
 **指南：**
 - [Observer 模式概述](observer-vs-full-mode)
 - [实现 Observer 模式](implement-observer-mode-unity)
-- [在 Observer 模式下上报交易](report-transactions-observer-mode-unity)
-:::tip[Checkpoint]
-- **预期结果：** 在使用现有购买流程完成沙盒购买后，该交易将出现在 Adapty 看板的 **Event Feed** 中。
-- **注意事项：** 没有事件 → 请确认您已向 Adapty 上报交易，并且两个应用商店的服务器通知均已配置。
+- [在 Observer 模式中上报交易](report-transactions-observer-mode-unity)
+将以下内容发送给您的 LLM：
+```
+Read these Adapty docs before writing code:
+- https://adapty.io/docs/zh/observer-vs-full-mode.md
+- https://adapty.io/docs/zh/implement-observer-mode-unity.md
+- https://adapty.io/docs/zh/report-transactions-observer-mode-unity.md
+```
+
+:::tip[检查点]
+- **预期结果：** 使用现有购买流程完成沙盒购买后，该交易将出现在 Adapty 看板的 **Event Feed** 中。
+- **注意事项：** 若无事件，请确认您已向 Adapty 上报交易，并且两个应用商店均已配置服务器通知。
 :::
 
 </TabItem>
@@ -192,7 +203,7 @@ Read these Adapty docs before writing code:
 :::
 ### 识别用户 \{#identify-users\}
 
-将您的应用用户账户与 Adapty 用户画像关联，以便购买记录在多设备间持久保存。
+将您的应用用户账户与 Adapty 用户画像关联，以便购买记录在设备间持久保存。
 
 :::important
 如果您的应用无需身份验证，请跳过此步骤。
@@ -206,27 +217,27 @@ Read these Adapty docs before writing code:
 - https://adapty.io/docs/zh/unity-quickstart-identify.md
 ```
 :::tip[检查点]
-- **预期效果：** 调用 `Adapty.Identify("your-user-id")` 后，看板的 **Profiles** 部分将显示您的自定义用户 ID。
+- **预期效果：** 调用 `Adapty.Identify("your-user-id")` 后，看板的 **Profiles** 页面会显示你的自定义用户 ID。
 - **注意事项：** 请在激活之后、获取付费墙之前调用 `Identify`，以避免匿名用户画像归因问题。
 :::
 ### 准备发布 \{#prepare-for-release\}
 
-一旦您的集成在沙盒环境中正常运行，请按照发布检查清单逐项确认，确保一切已为生产环境做好准备。
+一旦您的集成在沙盒环境中正常运行，请按照发布清单逐项检查，确保一切已准备好用于生产环境。
 
-**指南：** [发布检查清单](release-checklist)
+**指南：** [发布清单](release-checklist)
 
 将以下内容发送给您的 LLM：
 ```
 Read these Adapty docs before releasing:
 - https://adapty.io/docs/zh/release-checklist.md
 ```
 :::tip[Checkpoint]
-- **预期：** 所有检查项均已确认：商店连接、服务器通知、购买流程、访问等级检查及隐私要求。
-- **注意：** 缺少服务器通知 → 请在 **App settings → iOS SDK** 中配置 App Store Server Notifications，并在 **App settings → Android SDK** 中配置 Google Play Real-Time Developer Notifications。
+- **预期结果：** 所有清单项均已确认：商店连接、服务器通知、购买流程、访问等级检查以及隐私合规要求。
+- **注意事项：** 缺少服务器通知 → 请在 **App settings → iOS SDK** 中配置 App Store Server Notifications，并在 **App settings → Android SDK** 中配置 Google Play Real-Time Developer Notifications。
 :::
 ## 纯文本文档索引文件 \{#plain-text-doc-index-files\}
 
-如果您需要为您的大语言模型提供超出单个页面范围的更广泛上下文，我们提供了列出或汇总所有 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 用量。
+如果您需要为大型语言模型提供超出单个页面范围的更广泛上下文，我们提供了列出或合并所有 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 用量。