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

Author: eandreeva-twr

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

@@ -7,8 +7,10 @@ displayed_sidebar: sdkunity
 ---
 
 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 文档的最佳实践。
@@ -17,6 +19,9 @@ import TabItem from '@theme/TabItem';
 复制整个页面的 Markdown 内容并粘贴到您的 LLM 中以开始使用——点击页面顶部的 **Copy for LLM**，或打开 [.md 版本](https://adapty.io/docs/zh/adapty-cursor-unity.md)。LLM 将使用指南链接和检查点引导您完成每个阶段。
 :::
 
+:::tip
+复制整个页面的 Markdown 内容并粘贴到您的 LLM 中以开始使用——点击页面顶部的 **Copy for LLM**，或打开 [.md 版本](https://adapty.io/docs/zh/adapty-cursor-unity.md)。LLM 将使用指南链接和检查点引导您完成每个阶段。
+:::
 ## 开始之前：看板配置 \{#before-you-start-dashboard-setup\}
 
 Adapty 在您编写任何 SDK 代码之前，需要先完成一些看板配置。您可以通过交互式 LLM 技能，或手动通过看板来完成配置。
@@ -25,7 +30,7 @@ Adapty 在您编写任何 SDK 代码之前，需要先完成一些看板配置
 Adapty CLI skill 让你的 LLM 直接设置应用、产品、访问等级、付费墙和版位，无需为每个步骤打开看板。你只需要在看板中[连接你的商店](integrate-payments)。
 
 ```
-npx skills add adaptyteam/adapty --skill adapty-cli
+npx skills add adaptyteam/adapty-cli --skill adapty-cli
 ```
 
 添加 skill 后，在你的 agent 中运行 `/adapty-cli`。它将引导你完成每个步骤，包括何时需要打开看板连接你的商店。
@@ -45,6 +50,12 @@ npx skills add adaptyteam/adapty --skill adapty-cli
 :::tip
 一旦您拥有这五项信息，就可以开始编写代码了。告诉您的 LLM："我的公共 SDK 密钥是 X，我的版位 ID 是 Y"，这样它就能生成正确的初始化和付费墙获取代码。
 :::
+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)。
+:::tip
+一旦您拥有这五项信息，就可以开始编写代码了。告诉您的 LLM："我的公共 SDK 密钥是 X，我的版位 ID 是 Y"，这样它就能生成正确的初始化和付费墙获取代码。
+:::
 ### 准备就绪后进行设置 \{#set-up-when-ready\}
 
 这些内容不是开始编码的必要条件，但随着集成的成熟，你会需要它们：
@@ -67,12 +78,19 @@ npx ctx7 setup
 该命令会自动检测您的编辑器并配置 Context7 服务器。如需手动配置，请参阅 [Context7 GitHub 仓库](https://github.com/upstash/context7)。
 配置完成后，在你的提示词中引用 Adapty 库：
 
+```
+
+:::warning
+尽管 Context7 消除了手动粘贴文档链接的需求，但实施顺序至关重要。请按照下面的[实施步骤](#implementation-walkthrough)逐步操作，以确保一切正常运行。
+:::
+配置完成后，在您的提示词中引用 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\}
 
@@ -94,6 +112,11 @@ Use the adaptyteam/adapty-docs library to look up how to install the Unity SDK
 - [**观察者模式**](observer-vs-full-mode)：您保留现有的购买基础设施，仅将 Adapty 用于数据分析和集成。
 
 不确定选哪个？请阅读[快速入门中的对比表格](unity-quickstart-paywalls)。
+- [**Adapty 付费墙编辑工具**](adapty-paywall-builder)：您在 Adapty 的无代码编辑工具中创建付费墙，SDK 会自动渲染它们。
+- [**手动创建的付费墙**](unity-making-purchases)：您在代码中构建自己的付费墙 UI，但仍使用 Adapty 获取产品并处理购买。
+- [**观察者模式**](observer-vs-full-mode)：您保留现有的购买基础设施，仅使用 Adapty 进行分析和集成。
+
+不确定选择哪种方式？请阅读[快速入门中的对比表](unity-quickstart-paywalls)。
 ### 安装并配置 SDK \{#install-and-configure-the-sdk\}
 
 通过 Unity Package Manager 添加 Adapty SDK 包，并使用您的 Public SDK key 激活它。这是一切的基础——没有它，其他功能都无法运行。
@@ -109,6 +132,10 @@ Read these Adapty docs before writing code:
 - **预期结果：** 项目成功构建并运行。Unity 控制台显示 Adapty 激活日志。
 - **常见问题：** "Public API key is missing" → 检查是否已将占位符替换为来自 **App settings** 的真实密钥。
 :::
+:::tip[检查点]
+- **预期结果：** 项目成功构建并运行。Unity 控制台显示 Adapty 激活日志。
+- **常见问题：** "Public API key is missing" → 检查您是否已将占位符替换为来自 **App settings** 的真实密钥。
+:::
 ### 显示付费墙并处理购买 \{#show-paywalls-and-handle-purchases\}
 
 通过版位 ID 获取付费墙、显示它并处理购买事件。所需指南取决于您处理购买的方式。
@@ -174,6 +201,35 @@ Read these Adapty docs before writing code:
 
 </TabItem>
 
+</Tabs>
+```
+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 获取的产品。点击某个产品会触发沙盒购买对话框。
+- **注意事项：** 产品数组为空 → 请确认该付费墙在看板中已分配产品，且该版位已设置目标受众。
+:::
+
+</TabItem>
+
+<TabItem value="observer" label="Observer mode">
+
+**指南：**
+- [Observer 模式概述](observer-vs-full-mode)
+- [实现 Observer 模式](implement-observer-mode-unity)
+- [在 Observer 模式中上报交易](report-transactions-observer-mode-unity)
+:::tip[Checkpoint]
+- **预期结果：** 在使用现有购买流程完成沙盒购买后，该交易将出现在 Adapty 看板的 **Event Feed** 中。
+- **注意事项：** 没有事件 → 请确认您已向 Adapty 上报交易，并且两个应用商店的服务器通知均已配置。
+:::
+
+</TabItem>
+
 </Tabs>
 ### 检查订阅状态 \{#check-subscription-status\}
 
@@ -210,6 +266,10 @@ Read these Adapty docs before writing code:
 - **预期结果：** 调用 `Adapty.Identify("your-user-id")` 后，看板的 **Profiles** 部分将显示您的自定义用户 ID。
 - **注意事项：** 请在激活之后、获取付费墙之前调用 `Identify`，以避免匿名用户画像归因问题。
 :::
+:::tip[检查点]
+- **预期结果：** 调用 `Adapty.Identify("your-user-id")` 后，看板的 **Profiles** 部分显示你的自定义用户 ID。
+- **注意事项：** 请在激活之后、获取付费墙之前调用 `Identify`，以避免匿名用户画像归因问题。
+:::
 ### 准备发布 \{#prepare-for-release\}
 
 一旦您的集成在沙盒环境中正常运行，请完成发布检查清单，以确保一切准备就绪可以投入生产。
@@ -225,9 +285,16 @@ Read these Adapty docs before releasing:
 - **预期结果：** 所有清单项均已确认：应用商店连接、服务器通知、购买流程、访问等级检查以及隐私要求。
 - **常见问题：** 缺少服务器通知 → 请在 **App settings → iOS SDK** 中配置 App Store 服务器通知，并在 **App settings → Android SDK** 中配置 Google Play 实时开发者通知。
 :::
+:::tip[Checkpoint]
+- **预期结果：** 所有检查项均已确认：商店连接、服务器通知、购买流程、访问等级检查以及隐私要求。
+- **注意事项：** 缺少服务器通知 → 请在 **App settings → iOS SDK** 中配置 App Store Server Notifications，并在 **App settings → Android SDK** 中配置 Google Play Real-Time Developer Notifications。
+:::
 ## 纯文本文档索引文件 \{#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` 并将其作为文件上传到对话中。
 - [`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 用量。
+- 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 用量。
+- [`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 用量。