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

package/docs/cli-reference.zh.md

@@ -1,8 +1,8 @@
 # CLI 命令参考
 
-本指南为所有可用的 `aigne doc` 子命令及其参数和选项提供了参考。旨在帮助用户充分利用命令行界面。
+本指南为所有可用的 `aigne doc` 子命令及其参数和选项提供了参考。它旨在帮助希望充分利用命令行的用户。
 
-通用语法如下：
+通用语法为：
 
 ```bash
 aigne doc <command> [options]
@@ -10,7 +10,7 @@ aigne doc <command> [options]
 
 ### 命令工作流
 
-下图展示了使用 DocSmith 的 CLI 命令创建和维护文档的典型生命周期：
+下图展示了使用 DocSmith CLI 命令创建和维护文档的典型生命周期：
 
 ```d2
 direction: down
@@ -54,11 +54,6 @@ End: {
   style.fill: "#a2eeaf"
 }
 
-prefs: {
-  label: "aigne doc prefs\n(管理学习到的规则)"
-  shape: cylinder
-}
-
 Start -> init: "可选" {
   style.stroke-dash: 4
 }
@@ -68,50 +63,44 @@ generate -> refinement-cycle: "优化"
 refinement-cycle -> publish: "就绪"
 generate -> publish: "直接部署"
 publish -> End
-
-prefs <-> generate: "影响" {
-  style.stroke-dash: 2
-}
-prefs <-> refinement-cycle: "影响" {
-  style.stroke-dash: 2
-}
 ```
 
 ---
 
 ## `aigne doc generate`
 
-**别名：** `gen`, `g`
-
 分析您的源代码，并根据您的配置生成一套完整的文档。如果未找到配置，它将自动启动交互式设置向导。
 
 ### 选项
 
-| Option | Type | Description |
-|---|---|---|
-| `--feedback` | string | 提供反馈以调整和优化整体文档结构规划。 |
-| `--forceRegenerate` | boolean | 丢弃现有内容，从头开始重新生成所有文档。 |
-| `--model` | string | 指定用于生成的特定 LLM（例如，`openai:gpt-4o`）。此选项将覆盖默认模型。 |
-| `--glossary` | string | 用于保持术语一致性的术语表文件路径。使用 `@path/to/glossary.md` 格式。 |
+| Option              | Type    | Description                                                                                                   |
+| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
+| `--feedback`        | string  | 提供反馈以调整和优化整体文档结构。                                   |
+| `--forceRegenerate` | boolean | 丢弃现有内容并从头开始重新生成所有文档。                                     |
+| `--model`           | string  | 指定用于生成的特定大语言模型（例如，`openai:gpt-4o`）。此选项将覆盖默认设置。 |
 
 ### 使用示例
 
-**首次生成或更新文档：**
+**生成或更新文档：**
+
 ```bash
 aigne doc generate
 ```
 
 **强制完全重新生成所有文档：**
+
 ```bash
 aigne doc generate --forceRegenerate
 ```
 
 **通过反馈优化文档结构：**
+
 ```bash
-aigne doc generate --feedback "为 API 示例添加一个新部分，并删除‘关于’页面。"
+aigne doc generate --feedback "Add a new section for API examples and remove the 'About' page."
 ```
 
-**使用 AIGNE Hub 中的特定模型进行生成：**
+**使用 AIGNE Hub 中的特定模型生成：**
+
 ```bash
 aigne doc generate --model google:gemini-1.5-flash
 ```
@@ -120,132 +109,102 @@ aigne doc generate --model google:gemini-1.5-flash
 
 ## `aigne doc update`
 
-**别名：** `up`
-
-优化并重新生成特定文档。您可以以交互方式运行以选择文档，或直接使用选项指定文档。此命令对于根据反馈进行有针对性的改进非常有用，无需重新生成整个项目。
+优化并重新生成特定文档。您可以以交互方式运行它来选择文档，或直接使用选项指定文档。这对于根据反馈进行有针对性的改进非常有用，而无需重新生成整个项目。
 
 ### 选项
 
-| Option | Type | Description |
-|---|---|---|
-| `--docs` | array | 要重新生成的文档路径列表（例如，`--docs overview.md`）。可多次使用。 |
-| `--feedback` | string | 提供具体反馈以改进所选文档的内容。 |
-| `--glossary` | string | 用于保持术语一致性的术语表文件路径。使用 `@path/to/glossary.md` 格式。 |
-| `--reset` | boolean | 忽略之前的结果，为所选文档从头开始重新生成内容。 |
+| Option     | Type  | Description                                                                                 |
+| ---------- | ----- | ------------------------------------------------------------------------------------------- |
+| `--docs`     | array | 要重新生成的文档路径列表。可多次使用。                         |
+| `--feedback` | string | 提供具体反馈以改进所选文档的内容。              |
 
 ### 使用示例
 
 **启动交互式会话以选择要更新的文档：**
+
 ```bash
 aigne doc update
 ```
 
-**使用针对性反馈更新特定文档：**
+**使用有针对性的反馈更新特定文档：**
+
 ```bash
-aigne doc update --docs /cli-reference --feedback "阐明 --docs 和 --langs 选项之间的区别。"
+aigne doc update --docs overview.md --feedback "Add more detailed FAQ entries"
 ```
 
 ---
 
 ## `aigne doc translate`
 
-将现有文档翻译成一种或多种语言。可以以交互方式运行以选择文档和语言，也可以通过参数指定以非交互方式运行。
+将现有文档翻译成一种或多种语言。可以以交互方式运行它来选择文档和语言，也可以通过将它们指定为参数以非交互方式运行。
 
 ### 选项
 
-| Option | Type | Description |
-|---|---|---|
-| `--docs` | array | 要翻译的文档路径列表。可多次使用。 |
-| `--langs` | array | 目标语言代码列表（例如，`zh`、`ja`、`es`）。可多次使用。 |
-| `--feedback` | string | 提供反馈以提高翻译质量。 |
-| `--glossary` | string | 用于确保跨语言术语一致性的术语表文件路径。使用 `@path/to/glossary.md`。 |
+| Option       | Type  | Description                                                                                                |
+| ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
+| `--docs`       | array | 要翻译的文档路径列表。可多次使用。                                         |
+| `--langs`      | array | 目标语言代码列表（例如，`zh`、`ja`）。可多次使用。                            |
+| `--feedback`   | string | 提供反馈以提高翻译质量。                                               |
+| `--glossary`   | string | 词汇表文件的路径，以确保跨语言术语的一致性。使用 `@path/to/glossary.md`。 |
 
 ### 使用示例
 
 **启动交互式翻译会话：**
+
 ```bash
 aigne doc translate
 ```
 
 **将特定文档翻译成中文和日文：**
+
 ```bash
-aigne doc translate --docs overview.md --docs getting-started.md --langs zh --langs ja
+aigne doc translate --langs zh --langs ja --docs examples.md --docs overview.md
 ```
 
-**结合使用术语表和反馈以获得更高质量的翻译：**
+**使用词汇表和反馈进行翻译以获得更好的质量：**
+
 ```bash
-aigne doc translate --glossary @glossary.md --feedback "日语翻译请使用正式语言。"
+aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently"
 ```
 
 ---
 
 ## `aigne doc publish`
 
-**别名：** `pub`, `p`
-
-将您生成的文档发布到 Discuss Kit 平台。您可以发布到官方的 AIGNE DocSmith 平台，也可以发布到您自己托管的实例。
+将您生成的文档发布到 Discuss Kit 平台。您可以发布到官方的 AIGNE DocSmith 平台或您自己托管的实例。
 
 ### 选项
 
-| Option | Type | Description |
-|---|---|---|
-| `--appUrl` | string | 您自托管的 Discuss Kit 实例的 URL。如果未提供，该命令将以交互方式运行。 |
+| Option     | Type   | Description                                                                                          |
+| ---------- | ------ | ---------------------------------------------------------------------------------------------------- |
+| `--appUrl` | string | 您自行托管的 Discuss Kit 实例的 URL。如果未提供，该命令将以交互方式运行。 |
 
 ### 使用示例
 
 **启动交互式发布会话：**
+
 ```bash
 aigne doc publish
 ```
 
-**直接发布到自托管实例：**
+**直接发布到自行托管的实例：**
+
 ```bash
-aigne doc publish --appUrl https://docs.my-company.com
+aigne doc publish --appUrl https://your-discuss-kit-instance.com
 ```
 
 ---
 
 ## `aigne doc init`
 
-手动启动交互式配置向导。这对于设置新项目或修改现有项目的配置非常有用。该向导将引导您定义源代码路径、设置输出目录、选择语言以及定义文档的风格和目标受众。
+手动启动交互式配置向导。这对于设置新项目或修改现有项目的配置非常有用。该向导会引导您定义源代码路径、设置输出目录、选择语言以及定义文档的风格和目标受众。
 
 ### 使用示例
 
 **启动设置向导：**
-```bash
-aigne doc init
-```
-
----
-
-## `aigne doc prefs`
-
-管理 DocSmith 随时间从您的反馈中学习到的用户偏好。这些偏好将在未来的生成和更新任务中作为规则应用，以保持与您的风格一致。
-
-### 选项
-
-| Option | Type | Description |
-|---|---|---|
-| `--list` | boolean | 列出所有已保存的偏好，显示其状态（激活/未激活）、范围和内容。 |
-| `--remove` | boolean | 移除一个或多个偏好。如果未提供 `--id`，则以交互方式运行。 |
-| `--toggle` | boolean | 切换一个或多个偏好的激活状态。如果未提供 `--id`，则以交互方式运行。 |
-| `--id` | array | 为 `--remove` 或 `--toggle` 指定要操作的偏好 ID。可多次使用。 |
 
-### 使用示例
-
-**列出所有已保存的偏好：**
-```bash
-aigne doc prefs --list
-```
-
-**以交互方式选择要移除的偏好：**
 ```bash
-aigne doc prefs --remove
-```
-
-**通过 ID 切换特定偏好的状态：**
-```bash
-aigne doc prefs --toggle --id <preference-id>
+aigne doc init
 ```
 
-有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。
+有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。

package/docs/configuration-interactive-setup.md

@@ -1,33 +1,33 @@
 # Interactive Setup
 
-To simplify project configuration, AIGNE DocSmith provides an interactive setup wizard launched with the `aigne doc init` command. This guided process asks a series of questions about your documentation goals and generates a `config.yaml` file based on your answers. It is the recommended way to start a new documentation project, as it helps prevent configuration errors and provides specific recommendations.
+AIGNE DocSmith includes an interactive setup wizard, launched with the `aigne doc init` command, to streamline project configuration. This guided process asks a series of questions about your documentation goals and generates a `config.yaml` file from your answers. It is the recommended method for starting a new documentation project, as it helps prevent configuration errors and provides specific recommendations based on your inputs.
 
 ## Running the Wizard
 
-To begin, run the following command in your project's root directory:
+To start the process, run the following command in the root directory of your project:
 
 ```bash aigne doc init icon=lucide:sparkles
 npx aigne doc init
 ```
 
-The wizard will then guide you through an 8-step process to configure your documentation.
+The wizard will then walk you through an 8-step process to configure your documentation.
 
 ## The Guided Process
 
-The wizard covers the following key areas:
+The wizard prompts for the following key configuration details:
 
-1.  **Primary Goal**: Defines the main outcome for your readers (e.g., getting started quickly, finding answers fast).
-2.  **Target Audience**: Specifies who will be reading the documentation (e.g., non-technical end-users, developers).
+1.  **Primary Goal**: Defines the main purpose for your readers (e.g., getting started, finding answers).
+2.  **Target Audience**: Specifies the primary readers of the documentation (e.g., non-technical end-users, developers).
 3.  **Reader Knowledge Level**: Assesses the typical starting knowledge of your audience.
-4.  **Documentation Depth**: Determines how comprehensive the content should be.
+4.  **Documentation Depth**: Determines the level of detail and scope of the content.
 5.  **Primary Language**: Sets the main language for the documentation.
 6.  **Translation Languages**: Selects additional languages for translation.
-7.  **Output Directory**: Specifies where to save the generated documentation files.
+7.  **Output Directory**: Specifies the location for the generated documentation files.
 8.  **Source Code Paths**: Defines which files and directories to analyze, with support for glob patterns.
 
 ## Assisted Configuration
 
-The wizard includes built-in logic to help you create a more effective and coherent configuration.
+The wizard uses a set of predefined rules to help you create a coherent and effective configuration.
 
 ```d2
 direction: down
@@ -38,12 +38,12 @@ User-Selections: {
 }
 
 Wizard-Engine: {
-  label: "2. Wizard's Logic Engine"
+  label: "2. Wizard's Rule Engine"
   shape: rectangle
   grid-columns: 2
 
   Filtering: {
-    label: "Option Filtering\n(Prevents invalid combos)"
+    label: "Option Filtering\n(Prevents incompatible selections)"
   }
 
   Conflict-Detection: {
@@ -70,27 +70,27 @@ Guided-Experience -> User-Selections: "Refines"
 
 ### Default Suggestions and Option Filtering
 
-As you answer questions, the wizard provides defaults and filters subsequent options to guide you toward a logical configuration. For instance:
+As you make selections, the wizard provides defaults and filters subsequent options to guide you toward a logical configuration. This is based on a set of cross-question conflict rules.
 
 -   **Default Suggestions**: If you select "Get started quickly" as your primary goal, the wizard will recommend "Is a total beginner" as the reader's knowledge level.
--   **Real-time Filtering**: If your target audience is "End users (non-technical)," the wizard will hide technically advanced knowledge levels like "Is an expert trying to do something specific" to prevent incompatible selections.
+-   **Real-time Filtering**: If your target audience is "End users (non-technical)," the wizard will hide the "Is an expert" knowledge level. The rule's reasoning is that non-technical users are typically not experienced technical users, thus preventing an incompatible selection.
 
 ### Conflict Detection and Resolution
 
-Sometimes, you may have multiple goals or audiences that seem to conflict, such as creating documentation for both non-technical **End Users** and expert **Developers**. The wizard identifies these as "resolvable conflicts."
+In some cases, you may have multiple goals or audiences that require a specific documentation structure to be effective, such as creating documentation for both non-technical **End Users** and expert **Developers**. The wizard identifies these as "resolvable conflicts."
 
-It then formulates a strategy to address these diverse needs within the documentation's structure. For the End User vs. Developer example, the resolution strategy is to create separate user paths:
+It then formulates a strategy to address these needs within the document structure. For the End User vs. Developer example, the resolution strategy is to create separate user paths:
 
 -   **User Guide Path**: Uses plain language, focuses on UI interactions, and is oriented toward business outcomes.
 -   **Developer Guide Path**: Is code-first, technically precise, and includes SDK examples and configuration snippets.
 
-This approach ensures that the final documentation is structured to serve multiple audiences effectively, rather than creating a confusing mix of content.
+This approach ensures the final documentation is structured to serve multiple audiences effectively, rather than creating a single, confusing mix of content.
 
 ## Generated Output
 
-Upon completion, the wizard saves a `config.yaml` file in your project. This file is fully commented, explaining each option and listing all available choices, making it easy to review and modify manually later.
+After you complete the wizard, it saves a `config.yaml` file in your project. This file is fully commented, explaining each option and listing all available choices, which makes it easy to review and modify manually later.
 
-Here is a snippet of what the generated file looks like:
+Here is a snippet of a generated file:
 
 ```yaml config.yaml icon=logos:yaml
 # Project information for documentation publishing

package/docs/configuration-interactive-setup.zh.md

@@ -1,33 +1,33 @@
 # 交互式设置
 
-为简化项目配置，AIGNE DocSmith 提供了一个交互式设置向导，可通过 `aigne doc init` 命令启动。该引导式流程会询问一系列关于文档目标的问题，并根据您的回答生成一个 `config.yaml` 文件。这是开始新文档项目的推荐方式，因为它有助于防止配置错误并提供具体建议。
+AIGNE DocSmith 包含一个交互式设置向导，通过 `aigne doc init` 命令启动，以简化项目配置。该引导过程会询问一系列关于你的文档目标的问题，并根据你的回答生成一个 `config.yaml` 文件。这是启动新文档项目的推荐方法，因为它有助于防止配置错误，并根据你的输入提供具体建议。
 
 ## 运行向导
 
-首先，在您项目的根目录中运行以下命令：
+要开始此过程，请在项目的根目录中运行以下命令：
 
 ```bash aigne doc init icon=lucide:sparkles
 npx aigne doc init
 ```
 
-然后，向导将引导您完成一个 8 步流程来配置您的文档。
+然后，向导将引导你完成一个 8 步流程来配置文档。
 
-## 引导式流程
+## 引导流程
 
-向导涵盖以下关键领域：
+向导会提示输入以下关键配置细节：
 
-1.  **主要目标**：定义读者的主要预期成果（例如，快速入门、快速找到答案）。
-2.  **目标受众**：明确文档的阅读对象（例如，非技术最终用户、开发者）。
+1.  **主要目标**：定义读者的主要目的（例如，入门、寻找答案）。
+2.  **目标受众**：指明文档的主要读者（例如，非技术最终用户、开发者）。
 3.  **读者知识水平**：评估受众的典型初始知识水平。
-4.  **文档深度**：决定内容的详尽程度。
+4.  **文档深度**：确定内容的详细程度和范围。
 5.  **主要语言**：设置文档的主要语言。
-6.  **翻译语言**：选择用于翻译的其他语言。
-7.  **输出目录**：指定保存生成的文档文件的位置。
+6.  **翻译语言**：选择其他需要翻译的语言。
+7.  **输出目录**：指定生成文档文件的位置。
 8.  **源代码路径**：定义要分析的文件和目录，支持 glob 模式。
 
 ## 辅助配置
 
-该向导包含内置逻辑，可帮助您创建更有效、更一致的配置。
+向导使用一套预定义规则来帮助你创建一致且有效的配置。
 
 ```d2
 direction: down
@@ -38,12 +38,12 @@ User-Selections: {
 }
 
 Wizard-Engine: {
-  label: "2. 向导的逻辑引擎"
+  label: "2. 向导的规则引擎"
   shape: rectangle
   grid-columns: 2
 
   Filtering: {
-    label: "选项过滤\n（防止无效组合）"
+    label: "选项筛选\n（防止不兼容的选择）"
   }
 
   Conflict-Detection: {
@@ -59,61 +59,61 @@ Guided-Experience: {
 
 Final-Config: {
   label: "4. 最终配置"
-  content: "config.yaml 根据\n冲突解决策略生成"
+  content: "config.yaml 生成时\n包含冲突解决策略"
 }
 
 User-Selections -> Wizard-Engine
 Wizard-Engine.Filtering -> Guided-Experience
 Wizard-Engine.Conflict-Detection -> Final-Config
-Guided-Experience -> User-Selections: "优化"
+Guided-Experience -> User-Selections: "完善"
 ```
 
-### 默认建议和选项过滤
+### 默认建议和选项筛选
 
-在您回答问题时，向导会提供默认值并筛选后续选项，以引导您进行逻辑配置。例如：
+在你进行选择时，向导会提供默认值并筛选后续选项，以引导你进行逻辑配置。这是基于一套跨问题冲突规则。
 
--   **默认建议**：如果您选择“快速入门”作为主要目标，向导将推荐“完全是初学者”作为读者的知识水平。
--   **实时过滤**：如果您的目标受众是“最终用户（非技术人员）”，向导将隐藏“试图做特定事情的专家”等技术高级知识水平，以防止不兼容的选择。
+-   **默认建议**：如果你选择“快速入门”作为主要目标，向导将推荐“完全是初学者”作为读者的知识水平。
+-   **实时筛选**：如果你的目标受众是“最终用户（非技术人员）”，向导将隐藏“是专家”这一知识水平选项。该规则的理由是，非技术用户通常不是经验丰富的技术用户，从而防止不兼容的选择。
 
 ### 冲突检测与解决
 
-有时，您可能有多个似乎相互冲突的目标或受众，例如同时为非技术的**最终用户**和专业的**开发者**创建文档。向导会将这些识别为“可解决的冲突”。
+在某些情况下，你可能有多个目标或受众，需要特定的文档结构才能有效，例如为非技术的 **最终用户** 和专业的 **开发者** 创建文档。向导将这些识别为“可解决的冲突”。
 
-然后，它会制定一个策略，在文档结构中解决这些多样化的需求。对于最终用户与开发者的例子，解决方法是创建独立的用户路径：
+然后，它会制定一个策略来解决文档结构中的这些需求。对于最终用户与开发者的例子，解决策略是创建独立的用户路径：
 
--   **用户指南路径**：使用通俗易懂的语言，侧重于 UI 交互，并面向业务成果。
+-   **用户指南路径**：使用通俗易懂的语言，侧重于 UI 交互，并以业务成果为导向。
 -   **开发者指南路径**：代码优先，技术上精确，并包含 SDK 示例和配置片段。
 
-这种方法可确保最终的文档结构能够有效地服务于多个受众，而不是产生令人困惑的内容混合。
+这种方法确保最终的文档结构能够有效地服务于多个受众，而不是创建一个单一、混乱的内容混合体。
 
-## 生成的输出
+## 生成输出
 
-完成后，向导会在您的项目中保存一个 `config.yaml` 文件。该文件带有完整的注释，解释了每个选项并列出了所有可用选择，方便日后手动审查和修改。
+完成向导后，它会在你的项目中保存一个 `config.yaml` 文件。该文件带有完整的注释，解释了每个选项并列出了所有可用选择，这使得以后手动审查和修改变得容易。
 
-以下是生成文件的片段示例：
+以下是生成文件的片段：
 
 ```yaml config.yaml icon=logos:yaml
 # 用于文档发布的项目信息
 projectName: your-project-name
-projectDesc: 您的项目描述。
+projectDesc: 你的项目描述。
 projectLogo: ""
 
 # =============================================================================
 # 文档配置
 # =============================================================================
 
-# 目的：您希望读者达到的主要成果是什么？
+# 目的：你希望读者实现的主要成果是什么？
 # 可用选项（根据需要取消注释并修改）：
 #   getStarted       - 快速入门：帮助新用户在 30 分钟内从零开始上手
-#   completeTasks    - 完成特定任务：引导用户完成常见的工作流程和用例
+#   completeTasks    - 完成特定任务：引导用户了解常见工作流程和用例
 documentPurpose:
   - completeTasks
   - findAnswers
 
-# 目标受众：谁会最常阅读这份文档？
+# 目标受众：谁会最常阅读本文档？
 # 可用选项（根据需要取消注释并修改）：
 #   endUsers         - 最终用户（非技术人员）：使用产品但不编写代码的人
-#   developers       - 开发者（集成您的产品/API）：将此添加到其项目中的工程师
+#   developers       - 集成你的产品/API 的开发者：将此产品添加到其项目中的工程师
 targetAudienceTypes:
   - endUsers
   - developers
@@ -123,11 +123,11 @@ targetAudienceTypes:
 
 ## 后续步骤
 
-配置文件就绪后，您就可以生成、翻译或发布您的文档了。
+配置文件就绪后，你就可以生成、翻译或发布文档了。
 
 <x-cards>
   <x-card data-title="生成文档" data-icon="lucide:play-circle" data-href="/features/generate-documentation">
-    了解如何使用单个命令从您的源代码自动创建一套完整的文档。
+    了解如何使用单个命令从源代码自动创建一套完整的文档。
   </x-card>
   <x-card data-title="配置指南" data-icon="lucide:settings" data-href="/configuration">
     深入了解所有可用设置，并学习如何手动微调 config.yaml 文件。

package/docs/configuration-language-support.md

@@ -1,8 +1,8 @@
 # Language Support
 
-AIGNE DocSmith provides automated translation for 12 languages, allowing you to generate and maintain documentation for a global audience. The entire process is handled by the `aigne doc translate` command, which uses an AI engine to process your source documents and create localized versions.
+AIGNE DocSmith uses AI to provide automated documentation translation into 12 languages. This allows you to generate and maintain documentation for a global audience using the `aigne doc translate` command.
 
-The translation workflow processes your source documents through the AIGNE AI engine to generate localized versions in your selected target languages.
+The translation workflow processes your source documents through an AI engine to generate localized versions in your selected target languages.
 
 ```d2
 direction: down
@@ -55,25 +55,25 @@ DocSmith offers AI-powered translations for the following languages. You can def
 
 ## How to Configure and Use Translation
 
-Translation languages are set when you initialize your project with `aigne doc init`. You can add new languages or translate documents at any time using the `aigne doc translate` command, which offers two modes of operation.
+Translation languages are set when you initialize your project with `aigne doc init`. You can add new languages or translate documents at any time using the `aigne doc translate` command, which has two modes of operation.
 
-### Interactive Mode
+### Interactive Mode for Guided Translation
 
-For a guided experience, run the command without any arguments. This is the recommended approach for most users.
+For a step-by-step guided experience, run the command without any arguments. This is the recommended approach for most users.
 
 ```bash Interactive Translation icon=lucide:wand
 aigne doc translate
 ```
 
-The interactive mode will then prompt you to:
+The interactive mode will then present a series of prompts that allow you to:
 
-- Select which of your existing documents to translate.
-- Choose one or more target languages from the supported list.
-- Add new translation languages to your project's configuration if they are not already included.
+1.  Select which of your existing documents to translate from a list.
+2.  Choose one or more target languages from the supported list.
+3.  Add new translation languages to your project's configuration if they are not already included.
 
-### Command-Line Arguments
+### Command-Line Arguments for Automation
 
-For direct control or for use in automated scripts (like CI/CD pipelines), you can specify documents and languages directly as command-line arguments.
+For direct control or for use in automated scripts, you can specify documents and languages directly as command-line arguments. This is ideal for developers and CI/CD pipelines.
 
 ```bash Command Example icon=lucide:terminal
 # Translate overview.md and examples.md into Chinese and Japanese
@@ -91,4 +91,4 @@ Key parameters for the command include:
 
 ---
 
-This section covers the available languages and how to enable them. For a complete guide on the translation workflow, including advanced options and best practices, see the [Translate Documentation](./features-translate-documentation.md) guide.
+This section covers the available languages and how to enable them. For a complete guide on the translation workflow, see the [Translate Documentation](./features-translate-documentation.md) guide.

package/docs/configuration-language-support.zh.md

@@ -1,8 +1,8 @@
 # 语言支持
 
-AIGNE DocSmith 提供 12 种语言的自动翻译功能，让你能够为全球用户生成和维护文档。整个过程由 `aigne doc translate` 命令处理，该命令使用 AI 引擎处理你的源文档并创建本地化版本。
+AIGNE DocSmith 使用 AI 提供 12 种语言的自动化文档翻译。这使您可以使用 `aigne doc translate` 命令为全球用户生成和维护文档。
 
-翻译工作流通过 AIGNE AI 引擎处理你的源文档，以在你选择的目标语言中生成本地化版本。
+翻译工作流通过 AI 引擎处理您的源文档，以生成您所选目标语言的本地化版本。
 
 ```d2
 direction: down
@@ -18,7 +18,7 @@ AI-Engine: {
 }
 
 Translated-Docs: {
-  label: "翻译后文档"
+  label: "翻译后的文档"
   shape: rectangle
   grid-columns: 3
 
@@ -36,11 +36,11 @@ AI-Engine -> Translated-Docs: "生成"
 
 ## 支持的语言
 
-DocSmith 为以下语言提供 AI 翻译功能。你可以在初始设置期间定义项目的主要语言，并选择任意数量的目标语言进行翻译。
+DocSmith 为以下语言提供 AI 翻译。您可以在初始设置期间定义项目的主要语言，并选择任意数量的目标语言进行翻译。
 
 | 语言 | 语言代码 | 示例文本 |
 |---|---|---|
-| 英语 | `en` | Hello |
+| English | `en` | Hello |
 | 简体中文 | `zh` | 你好 |
 | 繁體中文 | `zh-TW` | 你好 |
 | 日本語 | `ja` | こんにちは |
@@ -53,27 +53,27 @@ DocSmith 为以下语言提供 AI 翻译功能。你可以在初始设置期间
 | Italiano | `it` | Ciao |
 | العربية | `ar` | مرحبا |
 
-## 如何配置和使用翻译功能
+## 如何配置和使用翻译
 
-翻译语言在你使用 `aigne doc init` 初始化项目时设置。你可以随时使用 `aigne doc translate` 命令添加新语言或翻译文档，该命令提供两种操作模式。
+翻译语言在您使用 `aigne doc init` 初始化项目时设置。您可以随时使用 `aigne doc translate` 命令添加新语言或翻译文档，该命令有两种操作模式。
 
-### 交互模式
+### 用于引导式翻译的交互模式
 
-如需引导式体验，请在不带任何参数的情况下运行该命令。这是为大多数用户推荐的方法。
+要获得分步指导体验，请在不带任何参数的情况下运行该命令。这是推荐给大多数用户的方法。
 
 ```bash Interactive Translation icon=lucide:wand
 aigne doc translate
 ```
 
-交互模式将提示你：
+然后，交互模式将显示一系列提示，允许您：
 
-- 选择要翻译的现有文档。
-- 从支持的语言列表中选择一个或多个目标语言。
-- 如果项目中尚未包含新的翻译语言，则将其添加到项目配置中。
+1.  从列表中选择要翻译的现有文档。
+2.  从支持的列表中选择一个或多个目标语言。
+3.  如果项目中尚未包含新的翻译语言，则将其添加到项目配置中。
 
-### 命令行参数
+### 用于自动化的命令行参数
 
-为了直接控制或在自动化脚本（如 CI/CD 流水线）中使用，你可以直接将文档和语言指定为命令行参数。
+为了直接控制或在自动化脚本中使用，您可以直接将文档和语言指定为命令行参数。这对于开发人员和 CI/CD 流水线非常理想。
 
 ```bash Command Example icon=lucide:terminal
 # 将 overview.md 和 examples.md 翻译成中文和日文
@@ -84,11 +84,11 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 
 | 参数 | 描述 |
 |---|---|
-| `--langs` | 指定目标语言代码。该标志可以多次使用以选择多种语言。 |
-| `--docs` | 指定要翻译的文档路径（例如 `overview.md`）。该标志也可以多次使用。 |
-| `--feedback` | 提供具体指令以指导翻译模型（例如，`"Use a formal tone"`）。 |
-| `--glossary` | 使用自定义术语表文件（例如 `@path/to/glossary.md`）以确保项目特定术语的翻译一致性。 |
+| `--langs` | 指定目标语言代码。此标志可多次使用以选择多种语言。 |
+| `--docs` | 指定要翻译的文档路径（例如 `overview.md`）。此标志也可以多次使用。 |
+| `--feedback` | 提供具体说明以指导翻译模型（例如 `"Use a formal tone"`）。 |
+| `--glossary` | 使用自定义术语表文件（例如 `@path/to/glossary.md`）以确保项目特定术语的翻译一致。 |
 
 ---
 
-本节介绍了可用语言以及如何启用它们。有关翻译工作流的完整指南，包括高级选项和最佳实践，请参阅[翻译文档](./features-translate-documentation.md)指南。
+本节介绍了可用的语言以及如何启用它们。有关翻译工作流的完整指南，请参阅[翻译文档](./features-translate-documentation.md)指南。