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

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

@@ -1,12 +1,12 @@
 # 產生文件
 
-本指南提供了一套系統化程序，說明如何從專案的原始檔案建立完整文件。此流程使用 `aigne doc generate` 命令啟動，該命令會分析您的程式碼庫、提出邏輯結構，然後為每份文件撰寫內容。
+本指南提供了一套系統化程序，可從您的專案原始檔案建立一套完整的文件。此程序透過 `aigne doc generate` 指令啟動，該指令會分析您的程式碼庫、提出邏輯結構，然後為每份文件撰寫內容。
 
-此命令是初次建立您文件的主要工具。若要在文件建立後進行修改，請參閱 [更新文件](./guides-updating-documentation.md) 指南。
+此指令是初次建立文件的主要工具。若要在文件建立後進行修改，請參閱 [更新文件](./guides-updating-documentation.md) 指南。
 
 ### 產生工作流程
 
-`generate` 命令會執行一系列自動化步驟來建立您的文件。此過程設計為互動式，讓您能在內容寫入前，審查並核准建議的結構。
+`generate` 指令會執行一系列自動化步驟來建置您的文件。此程序設計為互動式，讓您能在內容撰寫前審閱並批准建議的結構。
 
 ```d2
 direction: down
@@ -38,12 +38,12 @@ propose_structure: {
 }
 
 review_structure: {
-  label: "使用者審查建議的結構"
+  label: "使用者審閱建議的結構"
   shape: rectangle
 }
 
 user_approve: {
-  label: "核准結構？"
+  label: "批准結構？"
   shape: diamond
 }
 
@@ -54,7 +54,7 @@ provide_feedback: {
 }
 
 generate_content: {
-  label: "為所有文件產生內容"
+  label: "為所有文件生成內容"
   shape: rectangle
 }
 
@@ -86,53 +86,55 @@ generate_content -> end
 
 ## 逐步流程
 
-若要產生您的文件，請在您的終端機中導覽至專案的根目錄，並遵循以下步驟。
+若要產生您的文件，請在終端機中導覽至您專案的根目錄，並依照下列步驟操作。
 
-### 1. 執行 Generate 命令
+### 1. 執行 Generate 指令
 
-執行 `generate` 命令以開始此流程。該工具將首先分析您專案的檔案和結構。
+執行 `generate` 指令以開始此程序。工具將首先分析您專案的檔案與結構。
 
-```bash 基本產生命令
+```bash 基本產生指令
 aigne doc generate
 ```
 
-您也可以使用別名 `gen` 或 `g` 以求簡潔。
+為求簡潔，您也可以使用別名 `gen` 或 `g`。
 
-### 2. 審查文件結構
+### 2. 審閱文件結構
 
-分析完成後，該工具將呈現一個建議的文件結構。此結構是將要建立的各份文件的一個階層式規劃。
-
-系統會提示您審查此計畫：
+分析完成後，工具將顯示建議的文件結構，並提示您進行審閱：
 
 ```
-您想最佳化文件結構嗎？
-您可以編輯標題、重組章節。
-❯ 看起來不錯 - 繼續使用目前結構
-  是，最佳化結構
+Would you like to optimize the documentation structure?
+❯ No, looks good
+  Yes, optimize the structure (e.g. rename 'Getting Started' to 'Quick Start', move 'API Reference' before 'Configuration')
 ```
 
--   **看起來不錯 - 繼續使用目前結構**：選擇此選項以核准建議的結構，並直接進入內容產生階段。
--   **是，最佳化結構**：如果您希望修改計畫，請選擇此選項。您將能夠以純文字形式提供回饋，例如「將『API』重新命名為『API 參考』」或「新增一個『部署』的章節」。AI 將根據您的回饋修訂結構，您可以再次審查。此循環可以重複進行，直到結構符合您的要求。
+-   **不，看起來不錯**：選擇此選項可批准建議的結構，並直接進入內容產生階段。
+-   **是的，最佳化結構**：選擇此選項可修改計畫。工具接著會以互動式循環徵詢您的回饋。您可以用純文字提供指令，例如：
+    -   `新增一份名為「疑難排解」的文件`
+    -   `移除「舊版功能」文件`
+    -   `將「安裝」移至結構頂部`
+
+    在每次回饋後，AI 將會修訂結構，您可以再次審閱。若要結束循環並批准最終結構，直接按下 Enter 鍵，不輸入任何回饋即可。
 
 ### 3. 內容產生
 
-文件結構一經核准，DocSmith 將開始為計畫中的每份文件產生詳細內容。此過程會自動執行，其持續時間取決於您專案的規模與複雜度。
+文件結構一經批准，DocSmith 將開始為計畫中的每份文件產生詳細內容。此過程會自動執行，其持續時間取決於您專案的規模與複雜度。
 
 完成後，產生的檔案將儲存至您設定中指定的輸出目錄（例如 `./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
@@ -140,10 +142,10 @@ aigne doc generate --forceRegenerate
 
 ## 總結
 
-`generate` 命令統籌了建立您初始專案文件的整個流程。它結合了自動化程式碼分析與互動式審查流程，以產出一套結構化且相關的文件。
+`generate` 指令統籌了建立您初始專案文件的整個過程。它結合了自動化程式碼分析與互動式審閱流程，以產出一套結構化且相關的文件。
 
 文件產生後，您可能會想：
 
 -   [更新文件](./guides-updating-documentation.md)：對特定文件進行變更。
 -   [翻譯文件](./guides-translating-documentation.md)：將您的內容翻譯成其他語言。
--   [發佈您的文件](./guides-publishing-your-docs.md)：將您的文件發佈到網路上。
+-   [發布您的文件](./guides-publishing-your-docs.md)：將您的文件發布上線。

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-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

@@ -16,9 +16,6 @@ The `history` command also supports two aliases for the `view` subcommand: `log`
 
 ```bash
 aigne history log
-```
-
-```bash
 aigne history list
 ```
 
@@ -30,9 +27,9 @@ Here is a breakdown of the format:
 
 | Component | Description |
 | :--- | :--- |
-| **Short Hash** | A 7-character unique identifier generated from the timestamp of the update. |
+| **Short Hash** | An 8-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`. |
+| **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. |
 
@@ -43,9 +40,9 @@ Below is a sample output from running the `aigne history view` command.
 ```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.

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.
 ```
 
 此日志为您的文档修改历史提供了清晰有序的记录，有助于跟踪进度和回顾过去的变更。

package/docs/guides-translating-documentation.ja.md

@@ -1,14 +1,14 @@
 # ドキュメントの翻訳
 
-このガイドでは、`aigne doc translate` コマンドを使用して、生成されたドキュメントを複数の言語に翻訳する方法について説明します。このプロセスではAIを利用して、翻訳が文脈を認識し、技術的な正確性を維持するようにします。
+このガイドでは、`aigne doc translate` コマンドを使用して、生成されたドキュメントを多言語に翻訳する方法について説明します。このプロセスでは AI を使用して、翻訳が文脈を認識し、技術的な正確性を維持するようにします。
 
 このツールは12の言語をサポートしており、世界中のオーディエンスにリーチすることができます。ソースドキュメントの主要言語は、利用可能な翻訳言語のリストから自動的に除外されます。
 
 ## `translate` コマンド
 
-`aigne doc translate` コマンドは、既存のドキュメントファイルの翻訳を生成するために使用されます。インタラクティブに実行して、対象のドキュメントと言語を選択することも、コマンドラインフラグを使用してこれらのオプションを直接指定し、ワークフローを自動化することもできます。
+`aigne doc translate` コマンドは、既存のドキュメントファイルの翻訳を生成するために使用されます。対話形式で実行して、翻訳したいドキュメントと言語を選択することも、自動化されたワークフローのためにコマンドラインフラグを使用してこれらのオプションを直接指定することもできます。
 
-### インタラクティブモード
+### 対話モード
 
 ガイド付きのエクスペリエンスを利用するには、引数なしでコマンドを実行します。
 
@@ -18,21 +18,21 @@ aigne doc translate
 
 実行されると、ツールは以下の手順を実行します。
 1.  既存のドキュメントをスキャンします。
-2.  リストから翻訳したい特定のドキュメントを選択するよう促します。
-3.  翻訳の対象言語を選択するよう促します。以前に選択した言語は、便宜上あらかじめチェックされています。
-4.  選択された各ドキュメントと言語のペアについて翻訳プロセスを開始します。
-5.  翻訳されたファイルを、言語ごとに適切なディレクトリに保存します。
+2.  リストから翻訳したい特定のドキュメントを選択するように求めます。
+3.  翻訳の対象言語を選択するように求めます。以前に選択した言語は、便宜上、事前にチェックされています。
+4.  選択された各ドキュメントと言語のペアに対して翻訳プロセスを開始します。
+5.  翻訳されたファイルを同じディレクトリに保存します。新しいファイルは、元のファイル名に言語コードを追加して命名されます（例：`overview.md` の中国語翻訳は `overview.zh.md` になります）。
 
 ### コマンドラインオプション
 
-非インタラクティブな使用やスクリプト作成のために、以下のコマンドラインフラグを使用して翻訳プロセスを制御できます。
+非対話的な使用やスクリプト作成のために、以下のコマンドラインフラグを使用して翻訳プロセスを制御できます。
 
 <x-field-group>
   <x-field data-name="--docs" data-type="array<string>">
-    <x-field-desc markdown>翻訳するドキュメントのパスを1つ以上指定します。指定しない場合、ツールはインタラクティブモードに入り、利用可能なドキュメントのリストから選択できるようになります。</x-field-desc>
+    <x-field-desc markdown>翻訳する1つ以上のドキュメントパスを指定します。指定しない場合、ツールは対話モードに入り、利用可能なドキュメントのリストから選択できるようになります。</x-field-desc>
   </x-field>
   <x-field data-name="--langs" data-type="array<string>">
-    <x-field-desc markdown>対象となる言語コード（例：`zh`、`ja`）を1つ以上指定します。省略した場合、インタラクティブに言語を選択するよう促されます。</x-field-desc>
+    <x-field-desc markdown>1つ以上のターゲット言語コード（例：`zh`、`ja`）を指定します。省略した場合、対話形式で言語を選択するように求められます。</x-field-desc>
   </x-field>
   <x-field data-name="--glossary" data-type="string">
     <x-field-desc markdown>用語集ファイルへのパス（例：`@path/to/glossary.md`）を提供します。これにより、特定の技術用語がすべてのドキュメントで一貫して翻訳されるようになります。</x-field-desc>
@@ -46,13 +46,13 @@ aigne doc translate
 
 #### 1. 特定のドキュメントを複数の言語に翻訳する
 
-インタラクティブなプロンプトなしで `overview.md` と `examples.md` を中国語（`zh`）と日本語（`ja`）に翻訳するには：
+対話プロンプトなしで `overview.md` と `examples.md` を中国語（`zh`）と日本語（`ja`）に翻訳するには：
 
 ```bash
 aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 ```
 
-#### 2. 用語集を使用して用語の一貫性を保つ
+#### 2. 用語集を使用して一貫した用語を確保する
 
 技術用語が正しく翻訳されるように、用語集ファイルを提供します。これは、ブランド名や専門用語の一貫性を維持するのに役立ちます。
 
@@ -60,9 +60,9 @@ aigne doc translate --docs overview.md --docs examples.md --langs zh --langs ja
 aigne doc translate --glossary @./glossary.md
 ```
 
-#### 3. フィードバックを提供して翻訳スタイルを調整する
+#### 3. フィードバックを提供して翻訳スタイルを洗練させる
 
-フィードバックを提供することで、翻訳スタイルをガイドできます。例えば、よりフォーマルなトーンを要求するには：
+フィードバックを提供することで、翻訳スタイルをガイドできます。例えば、よりフォーマルなトーンをリクエストするには：
 
 ```bash
 aigne doc translate --feedback "Use a formal, technical tone for all translations."
@@ -88,8 +88,8 @@ aigne doc translate --feedback "Use a formal, technical tone for all translation
 | イタリア語 | `it` |
 | アラビア語 | `ar` |
 
-## まとめ
+## 概要
 
-`translate` コマンドは、ドキュメントをローカライズするための構造化された方法を提供します。ガイド付き翻訳のためのインタラクティブモードを使用することも、自動化されたワークフローのためのコマンドラインオプションを使用することもできます。用語集やフィードバックなどの機能を使用することで、翻訳されたコンテンツの品質と一貫性を維持するのに役立ちます。
+`translate` コマンドは、ドキュメントをローカライズするための構造化された方法を提供します。対話モードを使用してガイド付きの翻訳を行ったり、コマンドラインオプションを使用して自動化されたワークフローを構築したりできます。用語集やフィードバックなどの機能を使用することで、翻訳コンテンツの品質と一貫性を維持するのに役立ちます。
 
-ドキュメントを翻訳した後、[ドキュメントの公開](./guides-publishing-your-docs.md) に進むことができます。
+ドキュメントを翻訳した後、[ドキュメントの公開](./guides-publishing-your-docs.md)に進むことができます。

package/docs/guides-translating-documentation.md

@@ -21,7 +21,7 @@ When executed, the tool will perform the following steps:
 2.  Prompt you to select the specific documents you wish to translate from a list.
 3.  Prompt you to select the target languages for translation. Previously selected languages will be pre-checked for convenience.
 4.  Begin the translation process for each selected document and language pair.
-5.  Save the translated files in the appropriate language-specific directories.
+5.  Save the translated files in the same directory. The new files are named by appending a language code to the original filename (e.g., a Chinese translation of `overview.md` becomes `overview.zh.md`).
 
 ### Command-Line Options