@aigne/doc-smith 0.8.10-beta → 0.8.10-beta.2

package/docs/features-generate-documentation.zh.md

@@ -1,12 +1,10 @@
 # 生成文档
 
-`aigne doc generate` 命令是 DocSmith 的核心功能，旨在通过一个命令将您的源代码转换为结构化的文档套件。
-
-该过程会分析您的代码库，规划逻辑文档结构，然后为每个部分生成内容。这是从零开始创建文档的主要方式。
+`aigne doc generate` 命令是从源代码创建完整文档集的核心功能。该过程会分析你的代码库，规划逻辑化的文档结构，然后为每个部分生成内容。这是从零开始创建文档的主要方式。
 
 ## 首次生成
 
-首先，请导航至您项目的根目录并运行以下命令：
+首先，请导航到项目的根目录并运行以下命令：
 
 ```bash
 aigne doc generate
@@ -14,29 +12,30 @@ aigne doc generate
 
 ### 自动配置
 
-如果您首次在项目中运行此命令，DocSmith 会检测到尚无配置。它将自动启动交互式设置向导，引导您完成初始设置。这可以确保您在生成开始前拥有一个正确配置的环境。
+如果这是你首次在项目中运行此命令，DocSmith 会检测到尚无配置。接着，它将启动一个交互式设置向导，引导你完成初始设置。这能确保在生成开始前，你拥有一个正确配置的环境。
 
 ![首次运行 generate 命令会触发设置向导](https://docsmith.aigne.io/image-bin/uploads/0c45a32667c5250e54194a61d9495965.png)
 
-系统会询问您一系列问题，用于定义：
+系统将询问你一系列问题，以定义：
+
 - 文档生成规则和风格
 - 目标受众
 - 主要语言和翻译语言
 - 源代码和输出路径
 
-![回答几个问题以配置您的文档风格、语言和源路径](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
+![回答问题以配置文档风格、语言和源路径](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
 
-配置完成后，DocSmith 会继续进行文档生成。
+配置完成后，DocSmith 将继续进行文档生成。
 
-![DocSmith 会分析您的代码、规划结构并生成每个文档](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
+![DocSmith 分析你的代码、规划结构并生成每个文档](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
 
-成功完成后，您新创建的文档将位于您指定的输出目录中。
+成功完成后，新创建的文档将位于你指定的输出目录中。
 
-![完成后，您将在指定的输出目录中找到新文档](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
+![完成后，你将在指定的输出目录中找到新文档](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
 
 ## 生成过程
 
-`generate` 命令遵循自动化工作流以确保结果的一致性。该过程可按如下方式可视化：
+`generate` 命令遵循一个自动化的工作流程。该过程可直观地表示如下：
 
 ```d2
 direction: down
@@ -57,7 +56,7 @@ interactive_setup: "启动交互式设置向导" {
   shape: rectangle
 }
 
-plan_structure: "1. 分析代码和规划结构" {
+plan_structure: "1. 分析代码并规划结构" {
   shape: rectangle
 }
 
@@ -85,18 +84,18 @@ save_docs -> end
 
 ## 命令选项
 
-虽然默认的 `generate` 命令足以满足大多数用例，但您可以使用多个选项来控制生成过程。这些选项对于重新生成内容或优化文档结构非常有用。
+虽然默认的 `generate` 命令足以满足大多数使用场景，但你可以使用几个选项来控制生成过程。这些选项在重新生成内容或优化文档结构时非常有用。
 
-| 选项                | 描述                                                                                                                                     | 示例                                                                 |
-|---------------------|------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
-| `--forceRegenerate` | 删除所有现有文档并从头开始重新生成。在对源代码或配置进行重大更改后使用此选项。                                                                 | `aigne doc generate --forceRegenerate`                                 |
-| `--feedback`        | 提供高层级反馈以优化整体文档结构规划，例如添加、删除或重组部分。                                                                             | `aigne doc generate --feedback "添加一个 API 参考部分"`                  |
-| `--model`           | 指定 AIGNE Hub 中的特定大型语言模型用于内容生成，允许您在不同模型之间切换。                                                                  | `aigne doc generate --model claude:claude-3-5-sonnet`                |
+| 选项                | 描述                                                                                                                             | 示例                                                                 |
+|---------------------|----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
+| `--forceRegenerate` | 删除所有现有文档并从头开始重新生成。在对源代码或配置进行重大更改后使用此选项。                                                     | `aigne doc generate --forceRegenerate`                                 |
+| `--feedback`        | 提供高层反馈以优化整体文档结构，例如添加、删除或重组章节。                                                                       | `aigne doc generate --feedback "Add an API Reference section"`         |
+| `--model`           | 指定 AIGNE Hub 中的特定大型语言模型用于内容生成，允许你切换模型。                                                                  | `aigne doc generate --model claude:claude-3-5-sonnet`                |
 
-## 后续步骤
+## 接下来做什么？
 
-既然您已经生成了初始文档，您的项目将继续发展。为了使文档与代码保持同步，您需要更新它们。请继续阅读下一部分，了解如何进行有针对性的更改和重新生成特定文件。
+既然你已经生成了初始文档，你的项目将继续演进。为使文档与代码保持同步，你需要更新它们。请继续阅读下一部分，了解如何进行有针对性的更改和重新生成特定文件。
 
 <x-card data-title="更新和优化" data-icon="lucide:file-edit" data-href="/features/update-and-refine">
-  了解当代码发生变化时如何更新文档，或使用反馈进行特定改进。
+  了解当代码变更时如何更新文档，或使用反馈进行特定改进。
 </x-card>

package/docs/features-publish-your-docs.md

@@ -1,14 +1,12 @@
 # Publish Your Docs
 
-Once your documentation is generated, the next step is to make it accessible online. AIGNE DocSmith simplifies this process with the `aigne doc publish` command, which uploads your content to a Discuss Kit platform, making it available to your audience.
-
-This guide covers how to publish your documentation, whether you are using the official platform or your own website.
+After generating your documentation, the `aigne doc publish` command uploads your content to a Discuss Kit platform, making it accessible online. This guide explains how to publish your documentation to either the official platform or your own self-hosted website.
 
 ## The Publishing Process
 
-The `aigne doc publish` command initiates an interactive process that guides you through the necessary steps. The diagram below shows the typical workflow for publishing your documentation for the first time.
+The `aigne doc publish` command initiates an interactive process. The first time you publish to a new destination, it will guide you through authentication. Subsequent publishes will use saved credentials.
 
-```d2
+```d2 The Publishing Flow icon=lucide:upload-cloud
 direction: down
 shape: sequence_diagram
 
@@ -32,47 +30,49 @@ alt: "First-time publish or missing config" {
 CLI -> Platform: "Uploads docs & media files"
 Platform -> CLI: "Success response"
 CLI -> User: "✅ Published Successfully!"
+
 ```
 
 ## Publishing Options
 
-You have two primary options for hosting your documentation, catering to different needs for visibility and control.
-
-### Official Platform
-
-Publish to [docsmith.aigne.io](https://docsmith.aigne.io), the official hosting platform. This option is free, makes your documentation publicly accessible, and is recommended for open-source projects.
-
-### Your Own Website
+You have two main options for hosting your documentation:
 
-Publish to your own website by running a Discuss Kit instance. This gives you full control over who can access your documentation, making it suitable for internal or private projects. You can get started with running your own Discuss Kit from the [official store](https://www.arcblock.io/store/z8iZhf67n368m2k5a9fXvCL778jAnf3e5n2b).
+<x-cards data-columns="2">
+  <x-card data-title="Official Platform" data-icon="lucide:globe">
+    Publish to [docsmith.aigne.io](https://docsmith.aigne.io/app/), a free, public hosting platform provided by AIGNE. This is a good option for open-source projects or to quickly share your docs.
+  </x-card>
+  <x-card data-title="Your Own Website" data-icon="lucide:server">
+    Publish to your own Discuss Kit instance for full control over access and branding. This is suitable for internal or private documentation. You can get a Discuss Kit instance from the [Blocklet Store](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu).
+  </x-card>
+</x-cards>
 
 ## Step-by-Step Guide
 
-Publishing your documentation for the first time is a simple, interactive process.
+Follow these steps to publish your documentation for the first time.
 
 ### 1. Run the Publish Command
 
-Navigate to your project's root directory in your terminal and run the following command:
+In your project's root directory, run the following command:
 
-```bash
+```bash Terminal icon=lucide:terminal
 aigne doc publish
 ```
 
 ### 2. Choose Your Platform
 
-If you have not configured a publishing destination before, you will be prompted to choose between the official platform and a self-hosted one. Select the option that best suits your needs.
+If this is your first time publishing, you will be prompted to select a destination. Choose the option that fits your needs.
 
 ![Choose between the official platform or a self-hosted instance](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d03cf5eb7aea85aa.png)
 
-If you select your own website, you will be asked to enter the URL for your Discuss Kit instance.
+If you select your own website, you will be asked to enter its URL.
 
 ### 3. Authenticate Your Account
 
-For the first connection to a new platform, DocSmith will automatically open a browser window for you to log in and authorize the CLI. This is a one-time step; your access token will be saved locally for all future publishes to that platform.
+For the first connection to a new platform, a browser window will open for you to log in and authorize the CLI. This is a one-time step per platform; your access token is saved locally in `~/.aigne/doc-smith-connected.yaml` for future use.
 
 ### 4. Confirmation
 
-Once the upload is complete, you will see a success message in your terminal, and your documentation will be live.
+Once the upload is complete, a success message will appear in your terminal.
 
 ```
 ✅ Documentation Published Successfully!
@@ -80,20 +80,28 @@ Once the upload is complete, you will see a success message in your terminal, an
 
 ## Publishing in CI/CD Environments
 
-For automated workflows, you can bypass the interactive prompts by using command-line arguments or environment variables.
+For automated workflows, you can provide arguments and environment variables to bypass the interactive prompts.
 
-| Method     | Name                           | Description                                                                              | Example                                                     |
-| ---------- | ------------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
-| **Argument** | `--appUrl`                     | Specifies the URL of your Discuss Kit instance directly.                                 | `aigne doc publish --appUrl https://docs.mycompany.com`       |
-| **Env Var**  | `DOC_DISCUSS_KIT_URL`          | Sets the target platform URL, overriding any other configuration.                        | `export DOC_DISCUSS_KIT_URL=...`                              |
-| **Env Var**  | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | Provides the access token directly, skipping the interactive login.                      | `export DOC_DISCUSS_KIT_ACCESS_TOKEN=...`                     |
+| Method | Name | Description |
+|---|---|---|
+| **Argument** | `--appUrl` | Specifies the URL of your Discuss Kit instance directly. |
+| **Env Var** | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | Provides the access token, skipping the interactive login. |
+
+Here is an example of a non-interactive publish command suitable for a CI/CD pipeline:
+
+```bash CI/CD Example icon=lucide:workflow
+export DOC_DISCUSS_KIT_ACCESS_TOKEN="your_access_token_here"
+aigne doc publish --appUrl https://docs.mycompany.com
+```
 
 ## Troubleshooting
 
-If you encounter issues during the publishing process, here are some common causes and their solutions:
+If you encounter an issue during publishing, check for these common problems:
+
+- **Connection Error**: The provided URL for your self-hosted instance might be incorrect, or the server may be unreachable. Verify the URL and your network connection.
+
+- **Invalid Website URL**: The URL must point to a valid website built on the ArcBlock platform. The CLI will show an error like `The provided URL is not a valid website on ArcBlock platform`. To host your documentation, you can start by getting a [Discuss Kit instance from the store](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu).
 
--   **Connection Error**: This can happen if the provided URL for your own instance is incorrect or the server is not reachable. Check the URL and your network connection.
--   **Invalid Website URL**: The provided URL is not a valid website on the ArcBlock platform. To host your documentation, you need a website running on this platform. You can start by visiting the [Discuss Kit Store](https://www.arcblock.io/store/z8iZhf67n368m2k5a9fXvCL778jAnf3e5n2b).
--   **Missing Required Components**: The destination website must have the Discuss Kit component installed to host the documentation. If it is missing, the CLI will return an error with guidance on how to add the component. You can find instructions in the [Discuss Kit documentation](https://www.arcblock.io/docs/web3-kit/en/discuss-kit).
+- **Missing Required Components**: The destination website must have the Discuss Kit component installed. If it is missing, the CLI will return an error like `This website does not have required components for publishing`. Please refer to the [Discuss Kit documentation](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) to add the necessary component.
 
 For a complete list of commands and options, refer to the [CLI Command Reference](./cli-reference.md).

package/docs/features-publish-your-docs.zh.md

@@ -1,30 +1,28 @@
 # 发布你的文档
 
-文档生成后，下一步是使其可以在线访问。AIGNE DocSmith 通过 `aigne doc publish` 命令简化了这一过程，该命令会将你的内容上传到 Discuss Kit 平台，供你的受众访问。
+生成文档后，`aigne doc publish` 命令会将你的内容上传到 Discuss Kit 平台，使其可以在线访问。本指南将说明如何将文档发布到官方平台或你自己的自托管网站。
 
-本指南将介绍如何发布文档，无论你是使用官方平台还是自己的网站。
+## 发布过程
 
-## 发布流程
+`aigne doc publish` 命令会启动一个交互式过程。当你首次发布到新目标时，它将引导你完成身份验证。后续的发布将使用已保存的凭据。
 
-`aigne doc publish` 命令会启动一个交互式流程，引导你完成必要的步骤。下图展示了首次发布文档的典型工作流程。
-
-```d2
+```d2 发布流程 icon=lucide:upload-cloud
 direction: down
 shape: sequence_diagram
 
 User: { shape: c4-person }
 CLI: { label: "AIGNE CLI" }
-Browser: { label: "Browser" }
-Platform: { label: "Discuss Kit Platform" }
+Browser: { label: "浏览器" }
+Platform: { label: "Discuss Kit 平台" }
 
 User -> CLI: "aigne doc publish"
 
 alt: "首次发布或缺少配置" {
-  CLI -> User: "选择平台\n（官方/自托管）"
+  CLI -> User: "选择平台\n(官方 / 自托管)"
   User -> CLI: "提供选择"
   CLI -> Browser: "打开认证 URL"
   User -> Browser: "登录并授权"
-  Browser -> Platform: "发送凭证"
+  Browser -> Platform: "发送凭据"
   Platform -> CLI: "返回访问令牌"
   CLI -> CLI: "保存令牌以备将来使用"
 }
@@ -32,47 +30,49 @@ alt: "首次发布或缺少配置" {
 CLI -> Platform: "上传文档和媒体文件"
 Platform -> CLI: "成功响应"
 CLI -> User: "✅ 发布成功！"
+
 ```
 
 ## 发布选项
 
-你有两种主要选项来托管文档，以满足对可见性和控制的不同需求。
-
-### 官方平台
-
-发布到官方托管平台 [docsmith.aigne.io](https://docsmith.aigne.io)。此选项免费，可使你的文档公开访问，推荐用于开源项目。
-
-### 你自己的网站
+你有两种主要选项来托管你的文档：
 
-通过运行 Discuss Kit 实例发布到你自己的网站。这使你可以完全控制谁能访问你的文档，适合内部或私有项目。你可以从[官方商店](https://www.arcblock.io/store/z8iZhf67n368m2k5a9fXvCL778jAnf3e5n2b)开始运行你自己的 Discuss Kit。
+<x-cards data-columns="2">
+  <x-card data-title="官方平台" data-icon="lucide:globe">
+    发布到 [docsmith.aigne.io](https://docsmith.aigne.io/app/)，这是 AIGNE 提供的一个免费的公共托管平台。对于开源项目或希望快速分享文档的用户来说，这是一个不错的选择。
+  </x-card>
+  <x-card data-title="你自己的网站" data-icon="lucide:server">
+    发布到你自己的 Discuss Kit 实例，以完全控制访问和品牌。这适用于内部或私有文档。你可以从 [Blocklet 商店](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu) 获取 Discuss Kit 实例。
+  </x-card>
+</x-cards>
 
 ## 分步指南
 
-首次发布文档是一个简单的交互式过程。
+按照以下步骤首次发布你的文档。
 
 ### 1. 运行发布命令
 
-在终端中导航到项目根目录，并运行以下命令：
+在你的项目根目录中，运行以下命令：
 
-```bash
+```bash Terminal icon=lucide:terminal
 aigne doc publish
 ```
 
 ### 2. 选择你的平台
 
-如果你之前没有配置过发布目的地，系统将提示你在官方平台和自托管平台之间进行选择。请选择最适合你需求的选项。
+如果这是你第一次发布，系统将提示你选择一个目标。选择适合你需求的选项。
 
 ![在官方平台或自托管实例之间选择](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d03cf5eb7aea85aa.png)
 
-如果你选择自己的网站，系统将要求你输入 Discuss Kit 实例的 URL。
+如果你选择自己的网站，系统将要求你输入其 URL。
 
-### 3. 认证你的账户
+### 3. 验证你的账户
 
-首次连接到新平台时，DocSmith 会自动打开浏览器窗口，以便你登录并授权 CLI。这是一个一次性步骤；你的访问令牌将保存在本地，用于将来对该平台的所有发布操作。
+首次连接到新平台时，浏览器窗口将打开，以便你登录并授权 CLI。每个平台只需执行此步骤一次；你的访问令牌会保存在本地的 `~/.aigne/doc-smith-connected.yaml` 文件中，以供将来使用。
 
 ### 4. 确认
 
-上传完成后，你将在终端看到一条成功消息，你的文档即已上线。
+上传完成后，你的终端将显示一条成功消息。
 
 ```
 ✅ 文档发布成功！
@@ -80,20 +80,28 @@ aigne doc publish
 
 ## 在 CI/CD 环境中发布
 
-对于自动化工作流，你可以使用命令行参数或环境变量来绕过交互式提示。
+对于自动化工作流，你可以提供参数和环境变量来绕过交互式提示。
 
-| Method     | Name                           | Description                                                                              | Example                                                     |
-| ---------- | ------------------------------ | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
-| **Argument** | `--appUrl`                     | 直接指定你的 Discuss Kit 实例的 URL。                                 | `aigne doc publish --appUrl https://docs.mycompany.com`       |
-| **Env Var**  | `DOC_DISCUSS_KIT_URL`          | 设置目标平台 URL，覆盖任何其他配置。                        | `export DOC_DISCUSS_KIT_URL=...`                              |
-| **Env Var**  | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | 直接提供访问令牌，跳过交互式登录。                      | `export DOC_DISCUSS_KIT_ACCESS_TOKEN=...`                     |
+| 方法 | 名称 | 描述 |
+|---|---|---|
+| **参数** | `--appUrl` | 直接指定你的 Discuss Kit 实例的 URL。 |
+| **环境变量** | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | 提供访问令牌，跳过交互式登录。 |
+
+以下是一个适用于 CI/CD 流程的非交互式发布命令示例：
+
+```bash CI/CD Example icon=lucide:workflow
+export DOC_DISCUSS_KIT_ACCESS_TOKEN="your_access_token_here"
+aigne doc publish --appUrl https://docs.mycompany.com
+```
 
 ## 故障排除
 
-如果你在发布过程中遇到问题，以下是一些常见原因及其解决方案：
+如果你在发布过程中遇到问题，请检查以下常见问题：
+
+- **连接错误**：提供的自托管实例 URL 可能不正确，或者服务器可能无法访问。请验证 URL 和你的网络连接。
+
+- **无效的网站 URL**：该 URL 必须指向一个基于 ArcBlock 平台构建的有效网站。CLI 将显示类似 `The provided URL is not a valid website on ArcBlock platform` 的错误。要托管你的文档，你可以先从[商店获取一个 Discuss Kit 实例](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu)。
 
--   **连接错误**：如果提供的自有实例 URL 不正确或服务器无法访问，可能会发生此问题。请检查 URL 和你的网络连接。
--   **无效的网站 URL**：提供的 URL 不是 ArcBlock 平台上的有效网站。要托管你的文档，你需要一个在该平台上运行的网站。你可以从访问 [Discuss Kit 商店](https://www.arcblock.io/store/z8iZhf67n368m2k5a9fXvCL778jAnf3e5n2b) 开始。
--   **缺少必需组件**：目标网站必须安装 Discuss Kit 组件才能托管文档。如果缺少该组件，CLI 将返回错误并提供有关如何添加该组件的指导。你可以在 [Discuss Kit 文档](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) 中找到相关说明。
+- **缺少必需组件**：目标网站必须安装 Discuss Kit 组件。如果缺少该组件，CLI 将返回类似 `This website does not have required components for publishing` 的错误。请参阅 [Discuss Kit 文档](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) 以添加必要的组件。
 
-如需完整的命令和选项列表，请参阅 [CLI 命令参考](./cli-reference.md)。
+有关命令和选项的完整列表，请参阅 [CLI 命令参考](./cli-reference.md)。

package/docs/features-translate-documentation.md

@@ -1,76 +1,16 @@
 # Translate Documentation
 
-AIGNE DocSmith helps you reach a global audience by translating your documentation into 12 languages. This process can be managed through a simple interactive wizard or automated with command-line arguments for advanced control.
-
-### Translation Workflow
-
-The `aigne doc translate` command offers two primary modes of operation: interactive for a guided setup and command-line for automation.
-
-```d2
-direction: down
-
-start: {
-  label: "Run 'aigne doc translate'"
-  shape: rectangle
-}
-
-interactive_vs_cli: {
-  label: "With or without\narguments?"
-  shape: diamond
-}
-
-interactive_path: {
-  label: "Interactive Mode"
-  shape: rectangle
-
-  select_docs: {
-    label: "1. Select Documents"
-    shape: rectangle
-  }
-  select_langs: {
-    label: "2. Choose Languages"
-    shape: rectangle
-  }
-  select_docs -> select_langs
-}
-
-cli_path: {
-  label: "CLI Mode"
-  shape: rectangle
-
-  flags: {
-    label: "Provide arguments\n--docs, --langs, etc."
-    shape: rectangle
-  }
-}
-
-ai_translation: {
-  label: "AI-Powered Translation"
-  shape: rectangle
-}
-
-end: {
-  label: "Translated Documents\nSaved"
-  shape: rectangle
-}
-
-start -> interactive_vs_cli
-interactive_vs_cli -> interactive_path: "Without args"
-interactive_vs_cli -> cli_path: "With args"
-interactive_path -> ai_translation
-cli_path -> ai_translation
-ai_translation -> end
-```
+AIGNE DocSmith can translate your documentation into 12 different languages, making your project accessible to a global audience. The tool provides two ways to manage translations: an interactive mode for a guided setup and command-line arguments for precise control and automation.
 
 ## Interactive Translation
 
-For a guided experience, run the `translate` command without any arguments:
+For a guided experience, run the `translate` command without any arguments. This is ideal for users who prefer a step-by-step process.
 
 ```bash
 aigne doc translate
 ```
 
-This launches an interactive wizard that guides you through the process:
+This command launches an interactive wizard that guides you through the process:
 
 1.  **Select Documents to Translate:** You will be presented with a list of your existing documents. Use the spacebar to select the ones you want to translate.
 
@@ -84,18 +24,18 @@ This launches an interactive wizard that guides you through the process:
 
 ## Command-Line Translation
 
-For automation or more specific tasks, you can use command-line flags to control the translation process. This method is suitable for integration into CI/CD pipelines.
+For automation in scripts or CI/CD pipelines, use command-line flags to control the translation process. This method is suitable for developers and advanced users.
 
-Here are the primary options available:
+### Command Parameters
 
-| Parameter | Description |
-|---|---|
-| `--langs` | Specify one or more target languages. This flag can be used multiple times (e.g., `--langs zh --langs ja`). |
-| `--docs` | Specify the paths of the documents to translate. This flag can also be used multiple times. |
-| `--feedback` | Provide suggestions to the AI to improve the quality of future translations (e.g., `--feedback "Use a formal tone"`). |
-| `--glossary` | Use a glossary file in Markdown format to ensure consistent terminology for specific terms (e.g., `--glossary @path/to/glossary.md`). |
+<x-field data-name="--langs" data-type="string" data-required="false" data-desc="Specify one target language. This flag can be used multiple times to include several languages (e.g., --langs zh --langs ja)."></x-field>
+<x-field data-name="--docs" data-type="string" data-required="false" data-desc="Specify the path of a document to translate. This can also be used multiple times for batch translation."></x-field>
+<x-field data-name="--feedback" data-type="string" data-required="false" data-desc="Provide suggestions to the AI to guide the translation quality (e.g., --feedback &quot;Use a formal tone&quot;)."></x-field>
+<x-field data-name="--glossary" data-type="string" data-required="false" data-desc="Use a glossary file in Markdown format to ensure consistent terminology for specific terms (e.g., --glossary @path/to/glossary.md)."></x-field>
+
+### Examples
 
-### Example: Translating Specific Documents
+#### Translating Specific Documents
 
 To translate `overview.md` and `examples.md` into Chinese and Japanese, run:
 
@@ -103,7 +43,7 @@ To translate `overview.md` and `examples.md` into Chinese and Japanese, run:
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 ```
 
-### Example: Using a Glossary and Feedback
+#### Using a Glossary and Feedback
 
 To ensure brand names and technical terms are translated correctly, you can provide a glossary file. You can also give feedback to refine the translation style.
 
@@ -135,5 +75,5 @@ DocSmith supports automatic translation for the following languages:
 Once your documentation is translated, you are ready to share it with the world.
 
 <x-card data-title="Next: Publish Your Docs" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="Read More">
-  A guide on how to easily publish your documentation to a public platform or your own private website.
+  A guide on how to publish your documentation to a public platform or your own private website.
 </x-card>

package/docs/features-translate-documentation.zh.md

@@ -1,78 +1,18 @@
 # 翻译文档
 
-AIGNE DocSmith 可将您的文档翻译成 12 种语言，帮助您触达全球用户。此过程可通过简单的交互式向导进行管理，也可通过命令行参数实现自动化，以进行高级控制。
-
-### 翻译工作流
-
-`aigne doc translate` 命令提供两种主要操作模式：用于引导设置的交互模式和用于自动化的命令行模式。
-
-```d2
-direction: down
-
-start: {
-  label: "运行 'aigne doc translate'"
-  shape: rectangle
-}
-
-interactive_vs_cli: {
-  label: "是否带有\n参数？"
-  shape: diamond
-}
-
-interactive_path: {
-  label: "交互模式"
-  shape: rectangle
-
-  select_docs: {
-    label: "1. 选择文档"
-    shape: rectangle
-  }
-  select_langs: {
-    label: "2. 选择语言"
-    shape: rectangle
-  }
-  select_docs -> select_langs
-}
-
-cli_path: {
-  label: "CLI 模式"
-  shape: rectangle
-
-  flags: {
-    label: "提供参数\n--docs, --langs 等"
-    shape: rectangle
-  }
-}
-
-ai_translation: {
-  label: "AI 翻译"
-  shape: rectangle
-}
-
-end: {
-  label: "已翻译文档\n已保存"
-  shape: rectangle
-}
-
-start -> interactive_vs_cli
-interactive_vs_cli -> interactive_path: "无参数"
-interactive_vs_cli -> cli_path: "有参数"
-interactive_path -> ai_translation
-cli_path -> ai_translation
-ai_translation -> end
-```
+AIGNE DocSmith 可以将你的文档翻译成 12 种不同的语言，让你的项目面向全球受众。该工具提供两种管理翻译的方式：用于引导式设置的交互模式和用于精确控制与自动化的命令行参数。
 
 ## 交互式翻译
 
-如需引导式体验，请运行不带任何参数的 `translate` 命令：
+如需引导式体验，请运行不带任何参数的 `translate` 命令。这非常适合喜欢分步操作的用户。
 
 ```bash
 aigne doc translate
 ```
 
-这将启动一个交互式向导，引导您完成整个过程：
+该命令会启动一个交互式向导，引导你完成整个过程：
 
-1.  **选择要翻译的文档：** 系统将显示您现有文档的列表。使用空格键选择您想要翻译的文档。
+1.  **选择要翻译的文档：** 系统将显示你现有文档的列表。使用空格键选择要翻译的文档。
 
     ![选择要翻译的文档](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
 
@@ -80,22 +20,22 @@ aigne doc translate
 
     ![选择要翻译成的语言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
 
-3.  **确认并运行：** DocSmith 将处理翻译，为每个选定的语言生成所选文件的新版本。
+3.  **确认并运行：** DocSmith 随后将处理翻译，为每个选定的语言生成所选文件的新版本。
 
 ## 命令行翻译
 
-对于自动化或更具体的任务，您可以使用命令行标志来控制翻译过程。此方法适用于集成到 CI/CD 管道中。
+对于脚本或 CI/CD 流水线中的自动化，请使用命令行标志来控制翻译过程。此方法适合开发者和高级用户。
 
-以下是可用的主要选项：
+### 命令参数
 
-| 参数 | 描述 |
-|---|---|
-| `--langs` | 指定一种或多种目标语言。此标志可多次使用（例如，`--langs zh --langs ja`）。 |
-| `--docs` | 指定要翻译的文档路径。此标志也可多次使用。 |
-| `--feedback` | 向 AI 提供建议，以提高未来翻译的质量（例如，`--feedback "使用正式语气"`）。 |
-| `--glossary` | 使用 Markdown 格式的术语表文件，以确保特定术语的一致性（例如，`--glossary @path/to/glossary.md`）。 |
+<x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一种目标语言。此标志可多次使用以包含多种语言（例如，--langs zh --langs ja）。"></x-field>
+<x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻译的文档路径。此标志也可多次使用以进行批量翻译。"></x-field>
+<x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建议以指导翻译质量（例如，--feedback &quot;使用正式语调&quot;）。"></x-field>
+<x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的术语表文件，以确保特定术语的一致性（例如，--glossary @path/to/glossary.md）。"></x-field>
+
+### 示例
 
-### 示例：翻译特定文档
+#### 翻译特定文档
 
 要将 `overview.md` 和 `examples.md` 翻译成中文和日文，请运行：
 
@@ -103,9 +43,9 @@ aigne doc translate
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 ```
 
-### 示例：使用术语表和反馈
+#### 使用术语表和反馈
 
-为确保品牌名称和技术术语翻译正确，您可以提供一个术语表文件。您还可以提供反馈以优化翻译风格。
+为确保品牌名称和技术术语翻译正确，你可以提供一个术语表文件。你也可以提供反馈来优化翻译风格。
 
 ```bash
 aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
@@ -132,8 +72,8 @@ DocSmith 支持以下语言的自动翻译：
 
 ---
 
-文档翻译完成后，您就可以与世界分享了。
+文档翻译完成后，你就可以与世界分享了。
 
-<x-card data-title="下一步：发布您的文档" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="阅读更多">
-  一份关于如何轻松将您的文档发布到公共平台或您自己的私人网站的指南。
+<x-card data-title="下一步：发布你的文档" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="阅读更多">
+  关于如何将文档发布到公共平台或你自己的私人网站的指南。
 </x-card>