@aigne/doc-smith 0.8.2 → 0.8.4

package/docs/features-translate-documentation.md

@@ -1,34 +1,90 @@
----
-labels: ["Reference"]
----
-
 # Translate Documentation
 
-AIGNE DocSmith helps you reach a global audience by automatically translating your documentation into over 12 languages. This feature streamlines the localization process, ensuring your content is accessible to users worldwide with a single command.
+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
+```
 
-## Easy Translation with Interactive Mode
+## Interactive Translation
 
-For a guided experience, the simplest way to start is by running the `translate` command without any arguments:
+For a guided experience, run the `translate` command without any arguments:
 
 ```bash
 aigne doc translate
 ```
 
-This will launch an interactive wizard that walks you through the process:
+This launches an interactive wizard that guides you through the process:
 
-1.  **Select Documents to Translate:** You'll be presented with a list of your existing documents. Simply choose the ones you want to translate.
+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.
 
     ![Select documents to translate](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
 
-2.  **Choose Target Languages:** After selecting your documents, you can pick one or more target languages from the list of supported options.
+2.  **Choose Target Languages:** After selecting your documents, pick one or more target languages from the list of supported options.
 
     ![Select languages to translate into](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
 
-3.  **Confirm and Run:** DocSmith will then handle the translation, generating new versions of your selected files for each language.
+3.  **Confirm and Run:** DocSmith will then process the translation, generating new versions of your selected files for each chosen language.
 
-## Advanced Control with Command-Line Flags
+## Command-Line Translation
 
-For automation or more specific tasks, you can use command-line flags to control the translation process directly. This is ideal for integrating into CI/CD pipelines or for power users who prefer the command line.
+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.
 
 Here are the primary options available:
 
@@ -36,12 +92,12 @@ Here are the primary options available:
 |---|---|
 | `--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 feedback to the AI to improve the quality of future translations (e.g., `--feedback "Use formal tone"`). |
-| `--glossary` | Use a glossary file in markdown format to ensure consistent terminology for specific terms (e.g., `--glossary @path/to/glossary.md`). |
+| `--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`). |
 
 ### Example: Translating Specific Documents
 
-To translate `overview.md` and `examples.md` into Chinese and Japanese, you would run:
+To translate `overview.md` and `examples.md` into Chinese and Japanese, run:
 
 ```bash
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -76,7 +132,7 @@ DocSmith supports automatic translation for the following languages:
 
 ---
 
-Once your documentation is translated, you're ready to share it with the world. Learn how in the next section.
+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.

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

@@ -1,47 +1,103 @@
----
-labels: ["Reference"]
----
-
 # 翻译文档
 
-AIGNE DocSmith 可将您的文档自动翻译成 12 种以上的语言，帮助您触及全球受众。该功能简化了本地化流程，确保您的内容仅需一条命令即可触达全球用户。
+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
+```
 
-## 使用交互模式轻松翻译
+## 交互式翻译
 
-如需引导式体验，最简单的方式是直接运行 `translate` 命令，无需添加任何参数：
+如需引导式体验，请运行不带任何参数的 `translate` 命令：
 
 ```bash
 aigne doc translate
 ```
 
-这将启动一个交互式向导，逐步引导您完成整个过程：
+这将启动一个交互式向导，引导您完成整个过程：
 
-1.  **选择待翻译文档：** 系统将列出您现有的所有文档。您只需选择想要翻译的文档即可。
+1.  **选择要翻译的文档：** 系统将显示您现有文档的列表。使用空格键选择您想要翻译的文档。
 
     ![选择要翻译的文档](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
 
-2.  **选择目标语言：** 选择文档后，您可以从支持的语言列表中选择一个或多个目标语言。
+2.  **选择目标语言：** 选择文档后，从支持的选项列表中选择一种或多种目标语言。
 
     ![选择要翻译成的语言](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 "Use formal tone"）。 |
-| `--glossary` | 使用 Markdown 格式的术语表文件，以确保特定术语的翻译保持一致（例如，--glossary @path/to/glossary.md）。 |
+| `--langs` | 指定一种或多种目标语言。此标志可多次使用（例如，`--langs zh --langs ja`）。 |
+| `--docs` | 指定要翻译的文档路径。此标志也可多次使用。 |
+| `--feedback` | 向 AI 提供建议，以提高未来翻译的质量（例如，`--feedback "使用正式语气"`）。 |
+| `--glossary` | 使用 Markdown 格式的术语表文件，以确保特定术语的一致性（例如，`--glossary @path/to/glossary.md`）。 |
 
 ### 示例：翻译特定文档
 
-要将 `overview.md` 和 `examples.md` 翻译成中文和日文，您需要运行：
+要将 `overview.md` 和 `examples.md` 翻译成中文和日文，请运行：
 
 ```bash
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -49,7 +105,7 @@ 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
@@ -76,7 +132,7 @@ DocSmith 支持以下语言的自动翻译：
 
 ---
 
-文档翻译完成后，您就可以与世界分享了。请在下一节中了解如何操作。
+文档翻译完成后，您就可以与世界分享了。
 
 <x-card data-title="下一步：发布您的文档" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="阅读更多">
   一份关于如何轻松将您的文档发布到公共平台或您自己的私人网站的指南。

package/docs/features-update-and-refine.md

@@ -1,32 +1,83 @@
----
-labels: ["Reference"]
----
-
 # Update and Refine
 
-Keeping documentation synchronized with your evolving source code is crucial. AIGNE DocSmith provides powerful and flexible ways to keep your content up-to-date, whether through intelligent automatic updates or precise, feedback-driven refinements.
+Keeping documentation synchronized with an evolving codebase is essential. AIGNE DocSmith provides direct and flexible methods to keep your content current, whether through automatic updates triggered by code changes or precise, feedback-driven refinements.
 
 This guide covers how to:
 - Automatically update documents when your code changes.
 - Manually regenerate specific documents with targeted feedback.
 - Optimize the overall documentation structure.
 
+### Document Update Workflows
+
+The following diagram illustrates the different paths you can take to update your documentation:
+
+```d2
+direction: down
+
+Start: {
+  shape: circle
+  label: "Start"
+}
+
+Code-Change: {
+  label: "Source Code or\nConfig Changes"
+  shape: rectangle
+}
+
+Content-Tweak: {
+  label: "Need Content\nImprovement?"
+  shape: rectangle
+}
+
+Structure-Tweak: {
+  label: "Need Structure\nImprovement?"
+  shape: rectangle
+}
+
+Start -> Code-Change
+Start -> Content-Tweak
+Start -> Structure-Tweak
+
+Code-Change -> Generate-Command: "aigne doc generate"
+
+Generate-Command -> Change-Detection: {
+  label: "Change Detection"
+  shape: diamond
+}
+Change-Detection -> Auto-Regen: "Regenerates\nAffected Docs"
+
+Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
+Update-Command -> Manual-Regen: "Regenerates\nSpecific Doc"
+
+Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
+Generate-Feedback-Command -> Replan: "Re-plans Document\nStructure"
+
+End: {
+  shape: circle
+  label: "Docs Updated"
+}
+
+Auto-Regen -> End
+Manual-Regen -> End
+Replan -> End
+```
+
 ---
 
-## Automatic Updates with Smart Detection
+## Automatic Updates with Change Detection
 
-When you run the `aigne doc generate` command, DocSmith doesn't blindly regenerate everything. It intelligently analyzes your codebase, detects changes since the last run, and only regenerates the documents that are affected. This efficient process saves time and reduces unnecessary LLM API calls.
+When you run the `aigne doc generate` command, DocSmith analyzes your codebase, detects any changes since the last run, and regenerates only the documents that are affected. This process saves time and reduces unnecessary LLM API calls.
 
 ```bash
-# DocSmith will automatically detect changes and update only what's necessary
+# DocSmith will detect changes and update only what's necessary
 aigne doc generate
 ```
 
-![DocSmith intelligently detects changes and regenerates only the required documents.](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
+![DocSmith detects changes and regenerates only the required documents.](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
 
 ### Forcing a Full Regeneration
 
-If you need to regenerate all documentation from scratch, ignoring the cache and previous state, use the `--forceRegenerate` flag. This is useful after significant configuration changes or when you want to ensure a completely fresh build.
+If you need to regenerate all documentation from scratch, ignoring any cached or previous state, use the `--forceRegenerate` flag. This is useful after significant configuration changes or when you want to ensure a completely fresh build.
 
 ```bash
 # Regenerate all documentation from the ground up
@@ -35,15 +86,15 @@ aigne doc generate --forceRegenerate
 
 ---
 
-## Refining Individual Documents with Feedback
+## Refining Individual Documents
 
-Sometimes, you need to improve a specific document without any corresponding code changes. The `aigne doc update` command is designed for this purpose, allowing you to provide targeted feedback to the AI for content refinement.
+To improve a specific document without any corresponding code changes, the `aigne doc update` command allows you to provide targeted feedback to the AI for content refinement.
 
 You can use this command in two ways: interactively or directly via command-line arguments.
 
 ### Interactive Mode
 
-For an easy, guided experience, simply run the command without any arguments. DocSmith will present you with an interactive menu to select which document you want to update. After you choose, you'll be prompted to enter your feedback.
+For a guided experience, run the command without any arguments. DocSmith will present an interactive menu to select which document you want to update. After you choose, you'll be prompted to enter your feedback.
 
 ```bash
 # Start the interactive update process
@@ -63,24 +114,24 @@ aigne doc update --docs overview.md --feedback "Add a more comprehensive FAQ sec
 
 Key parameters for the `update` command:
 
-| Parameter | Description |
-|---|---|
-| `--docs` | The path to the document you want to update. You can use this flag multiple times for multiple documents. |
-| `--feedback` | The specific feedback or instructions for the AI to use when regenerating the content. |
+| Parameter  | Description                                                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------ |
+| `--docs`     | The path to the document you want to update. You can use this flag multiple times for batch updates. |
+| `--feedback` | The specific instructions for the AI to use when regenerating the content.                       |
 
 ---
 
 ## Optimizing the Overall Structure
 
-Beyond refining the content of individual documents, you can also refine the overall documentation structure. If you feel a section is missing, or the existing organization could be improved, you can provide feedback to the structure planning agent using the `generate` command.
+Beyond refining the content of individual documents, you can also adjust the overall documentation structure. If a section is missing or the existing organization could be improved, you can provide feedback to the structure planning agent using the `generate` command with the `--feedback` flag.
 
-This command tells DocSmith to reconsider the entire document plan based on your new input.
+This command instructs DocSmith to reconsider the entire document plan based on your new input.
 
 ```bash
 # Regenerate the structure plan with specific feedback
 aigne doc generate --feedback "Remove the 'About' section and add a more detailed 'API Reference'."
 ```
 
-This approach is best for high-level changes to the table of contents, rather than line-by-line content edits.
+This approach is best for high-level changes to the document's table of contents, rather than line-by-line content edits.
 
-With these tools, you can maintain accurate, high-quality documentation that evolves alongside your project. Once your content is refined, you may want to make it available to a global audience. Learn how in the [Translate Documentation](./features-translate-documentation.md) guide.
+With these tools, you can maintain accurate documentation that evolves alongside your project. Once your content is refined, you can make it available to a global audience. Learn how in the [Translate Documentation](./features-translate-documentation.md) guide.

package/docs/features-update-and-refine.zh.md

@@ -1,32 +1,83 @@
----
-labels: ["Reference"]
----
-
-# 更新与优化
+# 更新和优化
 
-让文档与不断演进的源代码保持同步至关重要。AIGNE DocSmith 提供了强大而灵活的方式来保持内容更新，无论是通过智能自动更新，还是通过精确的、由反馈驱动的优化。
+保持文档与不断演进的代码库同步至关重要。AIGNE DocSmith 提供了直接且灵活的方法来保持内容最新，无论是通过代码变更触发的自动更新，还是通过精确的、由反馈驱动的优化。
 
-本指南将介绍如何：
-- 在代码变更时自动更新文档。
-- 通过有针对性的反馈手动重新生成特定文档。
+本指南涵盖了如何：
+- 当代码变更时自动更新文档。
+- 使用有针对性的反馈手动重新生成特定文档。
 - 优化整体文档结构。
 
+### 文档更新工作流
+
+下图说明了更新文档可以采取的不同路径：
+
+```d2
+direction: down
+
+Start: {
+  shape: circle
+  label: "开始"
+}
+
+Code-Change: {
+  label: "源代码或\n配置变更"
+  shape: rectangle
+}
+
+Content-Tweak: {
+  label: "需要改进\n内容？"
+  shape: rectangle
+}
+
+Structure-Tweak: {
+  label: "需要改进\n结构？"
+  shape: rectangle
+}
+
+Start -> Code-Change
+Start -> Content-Tweak
+Start -> Structure-Tweak
+
+Code-Change -> Generate-Command: "aigne doc generate"
+
+Generate-Command -> Change-Detection: {
+  label: "变更检测"
+  shape: diamond
+}
+Change-Detection -> Auto-Regen: "重新生成\n受影响的文档"
+
+Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
+Update-Command -> Manual-Regen: "重新生成\n特定文档"
+
+Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
+Generate-Feedback-Command -> Replan: "重新规划文档\n结构"
+
+End: {
+  shape: circle
+  label: "文档已更新"
+}
+
+Auto-Regen -> End
+Manual-Regen -> End
+Replan -> End
+```
+
 ---
 
-## 智能检测与自动更新
+## 通过变更检测自动更新
 
-当您运行 `aigne doc generate` 命令时，DocSmith 不会盲目地重新生成所有内容。它会智能地分析您的代码库，检测自上次运行以来的变更，并仅重新生成受影响的文档。这个高效的流程可以节省时间，并减少不必要的 LLM API 调用。
+当您运行 `aigne doc generate` 命令时，DocSmith 会分析您的代码库，检测自上次运行以来的任何变更，并仅重新生成受影响的文档。此过程可以节省时间并减少不必要的 LLM API 调用。
 
 ```bash
-# DocSmith 将自动检测变更并仅更新必要的部分
+# DocSmith 将检测变更并仅更新必要的部分
 aigne doc generate
 ```
 
-![DocSmith 能够智能检测变更，并仅重新生成必要的文档。](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
+![DocSmith 会检测变更并仅重新生成所需的文档。](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
 
 ### 强制完全重新生成
 
-如果您需要从头开始重新生成所有文档，忽略缓存和先前的状态，请使用 `--forceRegenerate` 标志。这在发生重大配置变更后，或当您希望确保完全重新构建时非常有用。
+如果您需要从头开始重新生成所有文档，忽略任何缓存或先前的状态，请使用 `--forceRegenerate` 标志。这在进行重大配置更改或希望确保完全重新构建时非常有用。
 
 ```bash
 # 从头开始重新生成所有文档
@@ -35,15 +86,15 @@ aigne doc generate --forceRegenerate
 
 ---
 
-## 通过反馈优化单个文档
+## 优化单个文档
 
-有时，您需要在没有任何相应代码变更的情况下改进特定文档。`aigne doc update` 命令正是为此设计的，它允许您向 AI 提供有针对性的反馈，以优化内容。
+要在没有任何相应代码变更的情况下改进特定文档，`aigne doc update` 命令允许您向 AI 提供有针对性的反馈以进行内容优化。
 
-您可以通过两种方式使用此命令：交互式方式或直接通过命令行参数。
+您可以通过两种方式使用此命令：交互式或直接通过命令行参数。
 
 ### 交互模式
 
-要获得简单的引导式体验，只需运行不带任何参数的命令即可。DocSmith 将为您呈现一个交互式菜单，供您选择要更新的文档。选择后，系统将提示您输入反馈。
+要获得引导式体验，请在不带任何参数的情况下运行该命令。DocSmith 将呈现一个交互式菜单，供您选择要更新的文档。选择后，系统将提示您输入反馈。
 
 ```bash
 # 启动交互式更新流程
@@ -54,7 +105,7 @@ aigne doc update
 
 ### 直接通过命令行更新
 
-为了实现更快的工作流或脚本化操作，您可以使用标志直接指定文档和反馈。这允许进行精确的非交互式更新。
+对于更快捷的工作流或脚本编写，您可以使用标志直接指定文档和反馈。这允许进行精确的非交互式更新。
 
 ```bash
 # 使用反馈更新特定文档
@@ -63,24 +114,24 @@ aigne doc update --docs overview.md --feedback "在末尾添加一个更全面
 
 `update` 命令的关键参数：
 
-| Parameter | Description |
-|---|---|
-| `--docs` | 您想要更新的文档路径。您可以多次使用此标志来更新多个文档。 |
-| `--feedback` | 供 AI 在重新生成内容时使用的具体反馈或指令。 |
+| Parameter  | Description                                                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------ |
+| `--docs`     | 要更新的文档路径。您可以多次使用此标志进行批量更新。 |
+| `--feedback` | 供 AI 在重新生成内容时使用的具体说明。                       |
 
 ---
 
 ## 优化整体结构
 
-除了优化单个文档的内容，您还可以优化整体文档结构。如果您觉得某个部分缺失，或者现有组织结构可以改进，您可以使用 `generate` 命令向结构规划 Agent 提供反馈。
+除了优化单个文档的内容外，您还可以调整整体文档结构。如果缺少某个部分或现有组织结构可以改进，您可以使用带 `--feedback` 标志的 `generate` 命令向结构规划 agent 提供反馈。
 
-此命令会告知 DocSmith 根据您的新输入重新考虑整个文档计划。
+此命令指示 DocSmith 根据您的新输入重新考虑整个文档计划。
 
 ```bash
-# 使用特定反馈重新生成结构规划
-aigne doc generate --feedback "删除‘关于’部分，并添加一个更详细的‘API 参考’。"
+# 使用特定反馈重新生成结构计划
+aigne doc generate --feedback "移除‘关于’部分，并添加一个更详细的‘API 参考’。"
 ```
 
-这种方法最适合对目录进行高级别的更改，而不是逐行编辑内容。
+此方法最适用于文档目录的高层级更改，而非逐行内容编辑。
 
-借助这些工具，您可以维护与项目一同演进的准确、高质量的文档。内容优化后，您可能希望将其提供给全球受众。在 [翻译文档](./features-translate-documentation.md) 指南中了解如何操作。
+借助这些工具，您可以维护与项目一同演进的准确文档。内容优化后，您可以将其提供给全球受众。在 [翻译文档](./features-translate-documentation.md) 指南中了解如何操作。

package/docs/features.md

@@ -1,56 +1,52 @@
----
-labels: ["Reference"]
----
-
 # Core Features
 
-AIGNE DocSmith provides a comprehensive suite of tools to manage your documentation lifecycle, from initial creation to global distribution. It streamlines the process with a few simple commands, leveraging AI to automate complex tasks.
-
-The typical workflow follows a logical progression, allowing you to generate, refine, translate, and finally publish your documentation.
+AIGNE DocSmith provides a set of commands to manage your documentation lifecycle, from initial creation to global distribution. The process is organized into a standard workflow: generating, refining, translating, and publishing your documentation.
 
 ```d2
-direction: right
+direction: down
 
-"Generate Docs": {
-  shape: step
-  description: "Automated creation from source code"
+Generate: {
+  label: "1. Generate\naigne doc generate"
+  shape: rectangle
+  description: "Create a full documentation set from your source code."
 }
 
-"Update & Refine": {
-  shape: step
-  description: "Sync with code changes and apply feedback"
+Refine: {
+  label: "2. Update & Refine\naigne doc update"
+  shape: rectangle
+  description: "Keep docs in sync with code and apply targeted feedback."
 }
 
-"Translate": {
-  shape: step
-  description: "Reach a global audience with 12+ languages"
+Translate: {
+  label: "3. Translate\naigne doc translate"
+  shape: rectangle
+  description: "Localize content into multiple languages for a global audience."
 }
 
-"Publish": {
-  shape: step
-  description: "Share your docs on public or private platforms"
+Publish: {
+  label: "4. Publish\naigne doc publish"
+  shape: rectangle
+  description: "Deploy your documentation to public or private platforms."
 }
 
-"Generate Docs" -> "Update & Refine" -> "Translate" -> "Publish" {
-  style.animated: true
-}
+Generate -> Refine -> Translate -> Publish
 ```
 
 Explore the main capabilities of DocSmith in the following sections:
 
 <x-cards data-columns="2">
   <x-card data-title="Generate Documentation" data-icon="lucide:file-plus-2" data-href="/features/generate-documentation">
-    Automatically create a complete, well-structured set of documentation directly from your source code with a single command.
+    Create a complete set of documentation from your source code using a single command.
   </x-card>
   <x-card data-title="Update and Refine" data-icon="lucide:edit" data-href="/features/update-and-refine">
-    Keep your documentation synchronized with code changes or regenerate specific sections with targeted feedback to improve quality.
+    Keep your documentation synchronized with code changes or regenerate specific documents with targeted feedback.
   </x-card>
   <x-card data-title="Translate Documentation" data-icon="lucide:languages" data-href="/features/translate-documentation">
-    Effortlessly translate your content into over 12 languages, making your project accessible to a global audience.
+    Translate your content into multiple supported languages to make your project accessible to a global audience.
   </x-card>
   <x-card data-title="Publish Your Docs" data-icon="lucide:send" data-href="/features/publish-your-docs">
-    Publish your generated documentation to the official DocSmith platform or your own self-hosted instance with an interactive command.
+    Publish your generated documentation to the official DocSmith platform or your own self-hosted instance.
   </x-card>
 </x-cards>
 
-These core features work together to create a seamless documentation workflow. To see all available commands and their options in detail, head over to the [CLI Command Reference](./cli-reference.md).
+These features provide a structured workflow for documentation. For a detailed list of all available commands and their options, see the [CLI Command Reference](./cli-reference.md).