@aigne/doc-smith 0.8.12-beta.6 → 0.8.12-beta.8

package/docs/guides-generating-documentation.zh.md

@@ -1,12 +1,12 @@
 # 生成文档
 
-本指南提供了一个系统化的流程，用于从您项目的源文件创建一套完整的文档。该过程通过 `aigne doc generate` 命令启动，该命令会分析您的代码库，提出一个逻辑结构，然后为每个文档编写内容。
+本指南提供了从项目源文件创建一套完整文档的系统化流程。该流程通过 `aigne doc generate` 命令启动，该命令会分析你的代码库，提出一个逻辑结构，然后为每个文档编写内容。
 
 该命令是初次创建文档的主要工具。如需在文档创建后进行修改，请参阅[更新文档](./guides-updating-documentation.md)指南。
 
 ### 生成工作流
 
-`generate` 命令执行一系列自动化步骤来构建您的文档。该过程设计为交互式，允许您在内容写入前审查和批准建议的结构。
+`generate` 命令会执行一系列自动化步骤来构建你的文档。该流程设计为交互式，允许你在内容写入前审查并批准建议的结构。
 
 ```d2
 direction: down
@@ -29,7 +29,7 @@ check_config: {
 interactive_setup: {
   label: "引导进行交互式设置"
   shape: rectangle
-  tooltip: "如果未找到 .aigne/doc-smith/config.yaml，将触发交互式设置。"
+  tooltip: "如果未找到 .aigne/doc-smith/config.yaml，则会触发交互式设置。"
 }
 
 propose_structure: {
@@ -50,7 +50,7 @@ user_approve: {
 provide_feedback: {
   label: "提供反馈以优化结构"
   shape: rectangle
-  tooltip: "用户可以请求更改，例如重命名、添加或删除部分。"
+  tooltip: "用户可以请求更改，例如重命名、添加或删除章节。"
 }
 
 generate_content: {
@@ -86,53 +86,55 @@ generate_content -> end
 
 ## 分步流程
 
-要生成您的文档，请在终端中导航到项目的根目录，并按照以下步骤操作。
+要生成文档，请在终端中导航到项目的根目录，并按照以下步骤操作。
 
 ### 1. 运行生成命令
 
-执行 `generate` 命令以开始该过程。该工具将首先分析您项目的文件和结构。
+执行 `generate` 命令以开始此过程。该工具将首先分析你项目的文件和结构。
 
-```bash 基础生成命令
+```bash 基本生成命令
 aigne doc generate
 ```
 
-为简洁起见，您也可以使用别名 `gen` 或 `g`。
+为简洁起见，你也可以使用别名 `gen` 或 `g`。
 
 ### 2. 审查文档结构
 
-分析完成后，该工具将呈现一个建议的文档结构。该结构是即将创建的文档的层级计划。
-
-系统将提示您审查此计划：
+分析完成后，该工具将显示建议的文档结构并提示你进行审查：
 
 ```
-您想优化文档结构吗？
-您可以编辑标题、重组章节。
-❯ 看起来不错 - 继续使用当前结构
-  是的，优化结构
+你希望优化文档结构吗？
+❯ 不，看起来不错
+  是的，优化结构（例如，将“入门指南”重命名为“快速入门”，将“API 参考”移至“配置”之前）
 ```
 
--   **看起来不错 - 继续使用当前结构**：选择此选项以批准建议的结构，并直接进入内容生成阶段。
--   **是的，优化结构**：如果您希望修改计划，请选择此选项。您将能够以纯文本形式提供反馈，例如“将‘API’重命名为‘API 参考’”或“为‘部署’添加一个新章节”。AI 将根据您的反馈修订结构，您可以再次审查。此循环可以重复，直到结构满足您的要求。
+-   **不，看起来不错**：选择此选项以批准建议的结构，并直接进入内容生成阶段。
+-   **是的，优化结构**：选择此选项以修改计划。该工具将在一个交互式循环中征求你的反馈。你可以用纯文本提供指令，例如：
+    -   `添加一个新文档“故障排除”`
+    -   `删除“旧版功能”文档`
+    -   `将“安装”移动到结构顶部`
+
+    在每次反馈后，AI 将修订结构，你可以再次审查。不输入任何反馈直接按 Enter 键即可退出循环并批准最终结构。
 
 ### 3. 内容生成
 
-一旦文档结构获得批准，DocSmith 将开始为计划中的每个文档生成详细内容。此过程自动运行，其持续时间取决于项目的规模和复杂性。
+文档结构一经批准，DocSmith 将开始为计划中的每个文档生成详细内容。此过程自动运行，其持续时间取决于项目的规模和复杂性。
 
-完成后，生成的文件将保存到您在配置中指定的输出目录（例如 `./docs`）。
+完成后，生成的文件将保存到你在配置中指定的输出目录（例如 `./docs`）。
 
 ## 命令参数
 
-`generate` 命令接受几个可选参数来控制其行为。
+`generate` 命令接受几个可选参数以控制其行为。
 
 | 参数 | 描述 | 示例 |
-| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
-| `--forceRegenerate` | 从头开始重建所有文档，忽略任何现有结构或内容。这对于从头开始很有用。 | `aigne doc generate --forceRegenerate` |
-| `--feedback` | 在结构生成阶段提供初始指令以指导 AI。 | `aigne doc generate --feedback "添加更多 API 示例和故障排除章节"` |
-| `--glossary` | 指定一个术语表文件（`.md`），以确保在整个文档中术语使用的一致性。 | `aigne doc generate --glossary @/path/to/glossary.md` |
+|---|---|---|
+| `--forceRegenerate` | 从头开始重建所有文档，忽略任何现有结构或内容。当你想要完全重置时，此选项非常有用。 | `aigne doc generate --forceRegenerate` |
+| `--feedback` | 在交互式审查开始前，提供基于文本的初始指令，以在结构生成阶段指导 AI。 | `aigne doc generate --feedback "添加更多 API 示例"` |
+| `--glossary` | 指定一个术语表文件（例如 `glossary.md`），以确保在整个文档中术语使用的一致性。 | `aigne doc generate --glossary @/path/to/glossary.md` |
 
 ### 示例：强制完全重建
 
-如果您想丢弃所有先前生成的文档，并根据代码的当前状态创建一套新的文档，请使用 `--forceRegenerate` 标志。
+如果你想丢弃所有先前生成的文档，并根据代码的当前状态创建一套新文档，请使用 `--forceRegenerate` 标志。
 
 ```bash 强制重新生成
 aigne doc generate --forceRegenerate
@@ -142,8 +144,8 @@ aigne doc generate --forceRegenerate
 
 `generate` 命令协调了创建初始项目文档的整个过程。它将自动代码分析与交互式审查过程相结合，以生成一套结构化且相关的文档。
 
-文档生成后，您可能希望：
+文档生成后，你可能希望：
 
 -   [更新文档](./guides-updating-documentation.md)：对特定文档进行更改。
--   [翻译文档](./guides-translating-documentation.md)：将您的内容翻译成其他语言。
--   [发布您的文档](./guides-publishing-your-docs.md)：将您的文档在线发布。
+-   [翻译文档](./guides-translating-documentation.md)：将你的内容翻译成其他语言。
+-   [发布你的文档](./guides-publishing-your-docs.md)：将你的文档在线发布。

package/docs/guides-interactive-chat.md

@@ -1,85 +1,93 @@
 # Interactive Chat
 
-The interactive chat assistant provides a conversational interface for generating, modifying, and managing your documentation. Instead of running individual commands, you can describe what you need to do, and the assistant will guide you through the process, calling on the appropriate tools to complete the task.
+The interactive chat assistant provides a conversational command-line interface to manage all aspects of your documentation lifecycle. It interprets natural language instructions to execute commands for document generation, updates, translation, and publishing.
 
-This approach simplifies the documentation workflow by handling the underlying commands for you. It is the recommended method for most interactions with the tool.
+This guided approach removes the need to memorize individual commands and options, making it the recommended method for most documentation tasks.
 
 ## Starting the Chat Assistant
 
-To begin an interactive session, run the `chat` command from your terminal:
+To begin an interactive session, run the `chat` command from your project's root directory:
 
 ```bash
 aigndoc chat
 ```
 
-This will launch the assistant, and you can begin typing your requests.
+This command launches the assistant and presents a prompt, ready to receive your instructions.
 
 ## Core Capabilities
 
-The chat assistant is designed to handle the entire documentation lifecycle. Its primary functions include:
+The chat assistant is designed to handle the entire documentation lifecycle. Its primary functions are based on a set of specialized skills that it can call upon based on your requests.
 
 <x-cards data-columns="2">
   <x-card data-title="Generate Documentation" data-icon="lucide:file-plus-2">
-    Create a complete documentation structure and initial content by analyzing your project's source files.
+    Creates a complete documentation structure and initial content by analyzing your project's source code.
   </x-card>
   <x-card data-title="Refine and Update" data-icon="lucide:edit">
-    Regenerate specific sections or entire documents based on your feedback or changes in the source code.
+    Modifies specific documents or sections based on your feedback or changes in the source code.
   </x-card>
   <x-card data-title="Translate Content" data-icon="lucide:languages">
-    Translate existing documentation into multiple languages to reach a broader audience.
+    Translates existing documentation into multiple supported languages to reach a broader audience.
   </x-card>
   <x-card data-title="Publish and Manage" data-icon="lucide:upload-cloud">
-    Assist with publishing your documentation and managing team-based workflows.
+    Guides you through the process of publishing your documentation and managing team-based workflows.
   </x-card>
 </x-cards>
 
+## How It Works
+
+You can interact with the assistant in two ways:
+
+1.  **Natural Language**: State your goal in plain language. The assistant will identify the correct tool and guide you through the required steps. For example, you can type "update the getting started guide" or "I need to translate my docs into French."
+2.  **Direct Commands**: You can also type specific commands directly into the chat prompt to initiate a task, such as `generate` or `publish`.
+
 ## Available Commands
 
-Within the chat, you can state your goal in plain language (e.g., "update the getting started guide") or invoke specific commands. The assistant understands the following core commands, which correspond to its specialized skills:
+The assistant understands a set of core commands that correspond to its specialized skills. You can invoke these directly or describe a task that requires them.
 
 | Command | Description |
 | :--- | :--- |
-| `generate` | Starts the process of creating a new documentation structure from source files. |
-| `update` | Modifies existing documents based on code changes or user feedback. |
+| `generate` | Starts the process of creating a new documentation structure from your source files. |
+| `update` | Modifies existing documents based on code changes or specific feedback. |
 | `translate` | Translates documents into one or more supported languages. |
 | `publish` | Publishes your documentation to make it accessible online. |
 | `init` | Guides you through creating an initial configuration file for the project. |
 | `clear` | Removes generated files, configurations, and cached data. |
 | `prefs` | Manages your saved preferences for document generation. |
 | `evaluate` | Assesses the quality and completeness of your generated documentation. |
-| `history` | Shows the history of updates made to your documentation. |
-| `exit` | Ends the interactive chat session. |
+| `history` | Shows the history of updates and changes made to your documentation. |
+| `exit` | Ends the interactive chat session and returns you to the standard terminal prompt. |
 
 ## Example Interaction
 
-Here is a sample conversation to illustrate how the interactive assistant works.
+The following is a sample conversation that illustrates a typical workflow for generating new documentation.
 
 ```text
 You:
-> Hello, I need to create documentation for a new project.
+> I need to create documentation for my project located in the 'src' folder.
 
 AI Assistant:
-Of course. To get started, I need to analyze your project structure. Could you please provide the path to your source code directory?
+Understood. I will start the documentation generation process for the directory './src'.
+First, I will analyze your project to propose a documentation structure. This may take a few moments...
+...
+Analysis complete. I have created a proposed structure. Would you like to review it before I generate the content? (yes/no)
 
 You:
-> ./src
+> yes
 
 AI Assistant:
-Thank you. I will now analyze the files in ./src to propose a documentation structure. This may take a few moments...
+(The proposed documentation structure is displayed here for your review.)
 ...
-I have analyzed your project and created a proposed structure. Would you like to review it before I proceed with generating the content? (yes/no)
+You can request changes, such as 'add a guide for API authentication' or 'remove the section on deployment'. If the structure is correct, simply type 'continue'.
 
 You:
-> yes
+> continue
 
 AI Assistant:
-(Displays the proposed documentation structure for review)
-...
-Please review the structure above. You can ask me to add, remove, or modify any part of it.
+Great. I will now proceed with generating the content for each document. This may take a few minutes.
 ```
 
 ## Summary
 
-The interactive chat assistant is a powerful tool for managing your documentation in a guided, conversational manner. It streamlines complex tasks by handling the necessary steps and commands for you.
+The interactive chat assistant provides a structured and guided method for managing your documentation. It consolidates the functionality of all individual commands into a single, conversational interface, ensuring a consistent and straightforward workflow.
 
-For a more detailed walkthrough of a specific workflow, see the [Generating Documentation](./guides-generating-documentation.md) guide.
+For a detailed walkthrough of creating your first set of documents using the assistant, please proceed to the [Generating Documentation](./guides-generating-documentation.md) guide.

package/docs/guides-managing-history.ja.md

@@ -1,51 +1,48 @@
 # 履歴の管理
 
-AIGNE DocSmithは、ドキュメントに加えられたすべての更新の時系列ログを保持します。この機能により、変更を追跡し、更新時に提供されたフィードバックを確認し、時間とともにドキュメントがどのように進化してきたかを理解できます。このガイドでは、この履歴にアクセスして解釈する方法について説明します。
+AIGNE DocSmithは、ドキュメントに加えられたすべての更新の時系列ログを保持します。この機能により、変更を追跡し、更新時に提供されたフィードバックを確認し、時間とともにドキュメントがどのように変化したかを理解できます。このガイドでは、この履歴にアクセスして解釈する方法について説明します。
 
 ## 更新履歴の表示
 
-すべてのドキュメント更新のログを表示するには、`history view` コマンドを使用します。このコマンドは、バージョン管理ログのように、各エントリの簡潔な1行の概要を表示します。
+すべてのドキュメント更新のログを表示するには、`history view` コマンドを使用します。このコマンドは、バージョン管理ログのように、各エントリの簡潔な1行の要約を表示します。
 
-ターミナルで次のコマンドを実行してください。
+ターミナルで次のコマンドを実行してください：
 
 ```bash 履歴の表示 icon=material-symbols:history
 aigne history view
 ```
 
-`history` コマンドは、`view` サブコマンドの2つのエイリアス、`log` と `list` もサポートしています。以下のコマンドは同等であり、同じ出力を生成します。
+`history` コマンドは、`view` サブコマンドの2つのエイリアス、`log` と `list` もサポートしています。以下のコマンドは同等であり、同じ出力を生成します：
 
 ```bash
 aigne history log
-```
-
-```bash
 aigne history list
 ```
 
 ### 履歴出力の理解
 
-`history view` コマンドの出力は、各更新に関する主要な情報を一目でわかるようにフォーマットされています。各行は単一の更新エントリを表します。
+`history view` コマンドの出力は、各更新に関する主要な情報を一目でわかるようにフォーマットされています。各行は、1つの更新エントリを表します。
 
-以下にそのフォーマットの内訳を示します。
+以下にそのフォーマットの内訳を示します：
 
 | コンポーネント | 説明 |
 | :--- | :--- |
-| **短いハッシュ** | 更新のタイムスタンプから生成される7文字の一意の識別子。 |
-| **日付** | 更新が発生した時期を示す相対的なタイムスタンプ（例：「5分前」、「2日前」）。古いエントリについては、特定の日付が表示されます。 |
-| **操作** | 実行されたアクションの種類。例：`generate-document` や `update-document-detail`。 |
-| **ドキュメントパス** | 操作が単一のファイルを対象とした場合に、変更された特定のドキュメントのパス。これは括弧で囲まれています。 |
-| **フィードバック** | 更新が行われたときに提供されたフィードバックまたは概要メッセージ。 |
+| **Short Hash** | 更新のタイムスタンプから生成される8文字の一意の識別子。 |
+| **Date** | 更新が発生した時期を示す相対的なタイムスタンプ（例：「5 minutes ago」、「2 days ago」）。古いエントリには、特定の日付が表示されます。 |
+| **Operation** | `generate_document` や `update_document_detail` など、実行されたアクションの種類。 |
+| **Document Path** | 操作が単一ファイルを対象とした場合に、変更された特定のドキュメントのパス。これは括弧で囲まれます。 |
+| **Feedback** | 更新が行われたときに提供されたフィードバックまたは要約メッセージ。 |
 
 ### 例
 
-以下は、`aigne history view` コマンドを実行した際のサンプル出力です。
+以下は `aigne history view` コマンドを実行した際のサンプル出力です。
 
 ```bash
-📜 更新履歴
+📜 Update History
 
-e5a4f8b 2 hours ago update-document-detail (/guides/generating-documentation): Added a new section on advanced configuration options.
-a3b1c9d 1 day ago  update-document-detail (/overview): Refined the introduction to be more concise.
-f8d2e0c 3 days ago generate-document (/guides/managing-history): Initial generation of the history management guide.
+e5a4f8b1 2 hours ago update_document_detail (/guides/generating-documentation): Added a new section on advanced configuration options.
+a3b1c9d2 1 day ago  update_document_detail (/overview): Refined the introduction to be more concise.
+f8d2e0c3 3 days ago generate_document (/guides/managing-history): Initial generation of the history management guide.
 ```
 
-このログは、ドキュメントの変更履歴を明確かつ整然と記録するもので、進捗の追跡や過去の変更の確認に役立ちます。
+このログは、ドキュメントの変更履歴を明確かつ整理された記録として提供し、進捗の追跡や過去の変更の確認に役立ちます。

package/docs/guides-managing-history.md

@@ -1,18 +1,18 @@
 # Managing History
 
-AIGNE DocSmith maintains a chronological log of all updates made to your documentation. This feature allows you to track changes, review feedback provided during updates, and understand the evolution of your documents over time. This guide provides instructions on how to access and interpret this history.
+AIGNE DocSmith maintains a chronological log of all updates made to your documentation. This feature allows you to track changes, review the feedback provided for each update, and observe the evolution of your documents over time. This guide provides instructions on how to access and interpret this history log.
 
 ## Viewing Update History
 
-To view the log of all documentation updates, you can use the `history view` command. This command displays a compact, one-line summary for each entry, similar to a version control log.
+To view the log of all documentation updates, use the `history view` command. This command displays a compact, one-line summary for each entry, formatted similarly to a version control log.
 
-Execute the following command in your terminal:
+Execute the following command in your project's root directory:
 
 ```bash Viewing History icon=material-symbols:history
 aigne history view
 ```
 
-The `history` command also supports two aliases for the `view` subcommand: `log` and `list`. The following commands are equivalent and will produce the same output:
+For convenience, the `history` command also supports two aliases for the `view` subcommand: `log` and `list`. The following commands are equivalent to the one above and will produce the identical output:
 
 ```bash
 aigne history log
@@ -22,30 +22,32 @@ aigne history log
 aigne history list
 ```
 
+If no updates have been made yet, the tool will display the message: `No update history found`.
+
 ### Understanding the History Output
 
-The output of the `history view` command is formatted to provide key information about each update at a glance. Each line represents a single update entry.
+The output of the `history view` command is structured to provide key information about each update in a concise format. Each line in the log represents a single update event.
 
-Here is a breakdown of the format:
+The format is composed of the following components:
 
 | Component | Description |
 | :--- | :--- |
-| **Short Hash** | A 7-character unique identifier generated from the timestamp of the update. |
-| **Date** | A relative timestamp indicating when the update occurred (e.g., "5 minutes ago", "2 days ago"). For older entries, a specific date is shown. |
-| **Operation** | The type of action performed, such as `generate-document` or `update-document-detail`. |
-| **Document Path** | The path of the specific document that was modified, if the operation targeted a single file. This is enclosed in parentheses. |
-| **Feedback** | The feedback or summary message that was provided when the update was made. |
+| **Short Hash** | An 8-character unique identifier generated from the timestamp of the update. This hash is deterministic, meaning the same timestamp will always produce the same hash. |
+| **Date** | A relative timestamp indicating when the update occurred (e.g., "5 minutes ago", "2 days ago"). For entries older than one week, a specific date is shown. |
+| **Operation** | The type of action performed, such as `generate_document` or `update_document_detail`. |
+| **Document Path** | The path of the specific document that was modified, if the operation targeted a single file. This is enclosed in parentheses for clarity. |
+| **Feedback** | The summary message or feedback that was provided when the update was executed. |
 
-### Example
+### Example Output
 
-Below is a sample output from running the `aigne history view` command.
+Below is a sample output from running the `aigne history view` command. This example illustrates how different operations are recorded in the log.
 
 ```bash
 📜 Update History
 
-e5a4f8b 2 hours ago update-document-detail (/guides/generating-documentation): Added a new section on advanced configuration options.
-a3b1c9d 1 day ago  update-document-detail (/overview): Refined the introduction to be more concise.
-f8d2e0c 3 days ago generate-document (/guides/managing-history): Initial generation of the history management guide.
+e5a4f8b1 2 hours ago update_document_detail (/guides/generating-documentation): Added a new section on advanced configuration options.
+a3b1c9d2 1 day ago  update_document_detail (/overview): Refined the introduction to be more concise.
+f8d2e0c3 3 days ago generate_document (/guides/managing-history): Initial generation of the history management guide.
 ```
 
-This log provides a clear and orderly record of your documentation's modification history, which is useful for tracking progress and reviewing past changes.
+This log provides a clear and orderly record of your documentation's modification history, which is an effective tool for tracking progress and reviewing past changes.

package/docs/guides-managing-history.zh-TW.md

@@ -1,39 +1,36 @@
-# 管理歷史記錄
+# 管理歷史紀錄
 
-AIGNE DocSmith 會按時間順序記錄您對文件所做的所有更新。此功能可讓您追蹤變更、檢視更新期間提供的回饋，並了解文件隨時間的演變。本指南將說明如何存取和解讀此歷史記錄。
+AIGNE DocSmith 會按時間順序記錄您對文件所做的所有更新。此功能可讓您追蹤變更、檢閱更新期間提供的回饋，並了解文件隨時間的演變過程。本指南將說明如何存取和解讀此歷史紀錄。
 
-## 檢視更新歷史記錄
+## 查看更新歷史紀錄
 
-若要檢視所有文件更新的日誌，您可以使用 `history view` 指令。此指令會為每個條目顯示一個精簡的單行摘要，類似於版本控制日誌。
+若要查看所有文件的更新日誌，您可以使用 `history view` 指令。此指令會為每個項目顯示精簡的單行摘要，類似於版本控制的日誌。
 
 在您的終端機中執行以下指令：
 
-```bash 檢視歷史記錄 icon=material-symbols:history
+```bash 查看歷史紀錄 icon=material-symbols:history
 aigne history view
 ```
 
-`history` 指令也支援 `view` 子指令的兩個別名：`log` 和 `list`。以下指令是等效的，並會產生相同的輸出：
+`history` 指令也支援 `view` 子指令的兩個別名：`log` 和 `list`。以下指令是等效的，將會產生相同的輸出：
 
 ```bash
 aigne history log
-```
-
-```bash
 aigne history list
 ```
 
-### 了解歷史記錄輸出
+### 了解歷史紀錄輸出
 
-`history view` 指令的輸出格式旨在讓您能一目了然地獲取每次更新的關鍵資訊。每一行代表一個單獨的更新條目。
+`history view` 指令的輸出格式旨在讓您能一目了然地獲取每次更新的關鍵資訊。每一行代表一個單獨的更新項目。
 
-以下是格式的詳細說明：
+以下是其格式的詳細說明：
 
 | 元件 | 說明 |
 | :--- | :--- |
-| **短雜湊值** | 從更新時間戳記產生的 7 個字元唯一識別碼。 |
-| **日期** | 一個相對時間戳記，表示更新發生的時間（例如，「5 minutes ago」、「2 days ago」）。對於較舊的條目，則會顯示具體日期。 |
-| **操作** | 執行的操作類型，例如 `generate-document` 或 `update-document-detail`。 |
-| **文件路徑** | 如果操作針對單一檔案，則為被修改的特定文件路徑。此路徑會用括號括起來。 |
+| **簡短雜湊值** | 一個從更新時間戳產生的 8 字元唯一識別碼。 |
+| **日期** | 一個相對時間戳，表示更新發生的時間（例如，「5 分鐘前」、「2 天前」）。對於較舊的項目，則會顯示具體日期。 |
+| **操作** | 執行的操作類型，例如 `generate_document` 或 `update_document_detail`。 |
+| **文件路徑** | 如果操作針對的是單一檔案，則為被修改的特定文件的路徑。此路徑會用括號括起來。 |
 | **回饋** | 進行更新時所提供的回饋或摘要訊息。 |
 
 ### 範例
@@ -41,11 +38,11 @@ aigne history list
 以下是執行 `aigne history view` 指令的範例輸出。
 
 ```bash
-📜 Update History
+📜 更新歷史紀錄
 
-e5a4f8b 2 hours ago update-document-detail (/guides/generating-documentation): Added a new section on advanced configuration options.
-a3b1c9d 1 day ago  update-document-detail (/overview): Refined the introduction to be more concise.
-f8d2e0c 3 days ago generate-document (/guides/managing-history): Initial generation of the history management guide.
+e5a4f8b1 2 小時前 update_document_detail (/guides/generating-documentation): 新增了關於進階設定選項的新章節。
+a3b1c9d2 1 天前  update_document_detail (/overview): 修訂了簡介，使其更加簡潔。
+f8d2e0c3 3 天前 generate_document (/guides/managing-history): 初次產生歷史紀錄管理指南。
 ```
 
-此日誌提供了您文件修改歷史的清晰有序記錄，對於追蹤進度和檢視過去的變更非常有用。
+此日誌提供了您文件修改歷史的清晰有序記錄，有助於追蹤進度和檢閱過去的變更。

package/docs/guides-managing-history.zh.md

@@ -1,10 +1,10 @@
 # 管理历史记录
 
-AIGNE DocSmith 会按时间顺序记录对您文档所做的所有更新。此功能让您可以跟踪变更，审查更新期间提供的反馈，并了解文档随时间的演变过程。本指南将说明如何访问和解读此历史记录。
+AIGNE DocSmith 会为您的文档所做的所有更新保留一份按时间顺序排列的日志。此功能允许您跟踪变更、审查更新期间提供的反馈，并了解文档随时间的演变过程。本指南说明了如何访问和解读此历史记录。
 
 ## 查看更新历史记录
 
-要查看所有文档更新的日志，您可以使用 `history view` 命令。该命令会为每个条目显示一个紧凑的单行摘要，类似于版本控制日志。
+要查看所有文档更新的日志，您可以使用 `history view` 命令。该命令会为每条记录显示一个紧凑的单行摘要，类似于版本控制日志。
 
 在您的终端中执行以下命令：
 
@@ -12,29 +12,26 @@ AIGNE DocSmith 会按时间顺序记录对您文档所做的所有更新。此
 aigne history view
 ```
 
-`history` 命令还支持 `view` 子命令的两个别名：`log` 和 `list`。以下命令是等效的，将产生相同的输出：
+`history` 命令还支持 `view` 子命令的两个别名：`log` 和 `list`。以下命令是等效的，并将产生相同的输出：
 
 ```bash
 aigne history log
-```
-
-```bash
 aigne history list
 ```
 
 ### 理解历史记录输出
 
-`history view` 命令的输出格式旨在让您能一目了然地获取每次更新的关键信息。每一行代表一个单独的更新条目。
+`history view` 命令的输出经过格式化，以便一目了然地提供每次更新的关键信息。每一行代表一条更新记录。
 
-以下是格式的详细说明：
+以下是其格式的分解说明：
 
 | 组件 | 描述 |
 | :--- | :--- |
-| **短哈希** | 一个根据更新时间戳生成的 7 个字符的唯一标识符。 |
-| **日期** | 一个相对时间戳，指示更新发生的时间（例如，“5 minutes ago”、“2 days ago”）。对于较旧的条目，会显示具体日期。 |
-| **操作** | 执行的操作类型，例如 `generate-document` 或 `update-document-detail`。 |
-| **文档路径** | 被修改的具体文档的路径，如果操作针对单个文件。该路径包含在括号中。 |
-| **反馈** | 进行更新时提供的反馈或摘要信息。 |
+| **短哈希值** | 根据更新时间戳生成的 8 位字符唯一标识符。 |
+| **日期** | 一个相对时间戳，表示更新发生的时间（例如，“5 分钟前”、“2 天前”）。对于较早的记录，会显示具体日期。 |
+| **操作** | 执行的操作类型，例如 `generate_document` 或 `update_document_detail`。 |
+| **文档路径** | 如果操作针对单个文件，则为被修改的具体文档的路径。该路径包含在括号中。 |
+| **反馈** | 更新时提供的反馈或摘要信息。 |
 
 ### 示例
 
@@ -43,9 +40,9 @@ aigne history list
 ```bash
 📜 更新历史记录
 
-e5a4f8b 2 小时前 update-document-detail (/guides/generating-documentation): 添加了关于高级配置选项的新章节。
-a3b1c9d 1 天前  update-document-detail (/overview): 优化了引言，使其更加简洁。
-f8d2e0c 3 天前 generate-document (/guides/managing-history): 初次生成历史记录管理指南。
+e5a4f8b1 2 hours ago update_document_detail (/guides/generating-documentation): Added a new section on advanced configuration options.
+a3b1c9d2 1 day ago  update_document_detail (/overview): Refined the introduction to be more concise.
+f8d2e0c3 3 days ago generate_document (/guides/managing-history): Initial generation of the history management guide.
 ```
 
 此日志为您的文档修改历史提供了清晰有序的记录，有助于跟踪进度和回顾过去的变更。