@aigne/doc-smith 0.8.11-beta.5 → 0.8.11-beta.7

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

@@ -1,6 +1,6 @@
 # 互動式設定
 
-AIGNE DocSmith 包含一個互動式設定精靈，可透過 `aigne doc init` 指令啟動，以簡化專案設定。此引導式流程會詢問一系列關於您文件目標的問題，並根據您的回答產生一個 `config.yaml` 檔案。這是開始新文件專案的建議方法，因為它有助於防止設定錯誤，並根據您的輸入提供具體建議。
+AIGNE DocSmith 包含一個互動式設定精靈，可透過 `aigne doc init` 指令啟動，用以簡化專案設定。此引導式流程會詢問一系列關於您文件目標的問題，並根據您的回答產生一個 `config.yaml` 檔案。這是開始新文件專案的建議方法，因為它有助於防止設定錯誤，並根據您的輸入提供具體建議。
 
 ## 執行精靈
 
@@ -10,14 +10,14 @@ AIGNE DocSmith 包含一個互動式設定精靈，可透過 `aigne doc init`
 npx aigne doc init
 ```
 
-精靈接著會引導您完成一個 8 步驟的流程來設定您的文件。
+接著，此精靈將引導您完成一個 8 步驟的流程來設定您的文件。
 
 ## 引導式流程
 
-精靈會提示您輸入以下關鍵設定詳細資訊：
+此精靈會提示您輸入以下關鍵設定細節：
 
-1.  **主要目標**：定義讀者的主要目的（例如，開始使用、尋找答案）。
-2.  **目標受眾**：指明文件的主要讀者（例如，非技術性終端使用者、開發人員）。
+1.  **主要目標**：定義讀者的主要目的（例如：快速入門、尋找答案）。
+2.  **目標受眾**：指明文件的主要讀者（例如：非技術背景的終端使用者、開發人員）。
 3.  **讀者知識水平**：評估您受眾的典型起始知識水平。
 4.  **文件深度**：決定內容的詳細程度和範圍。
 5.  **主要語言**：設定文件的主要語言。
@@ -27,7 +27,7 @@ npx aigne doc init
 
 ## 輔助設定
 
-精靈使用一組預定義的規則來幫助您建立一個一致且有效的設定。
+此精靈使用一組預定義的規則來幫助您建立一個一致且有效的設定。
 
 ```d2
 direction: down
@@ -54,12 +54,12 @@ Wizard-Engine: {
 Guided-Experience: {
   label: "3. 引導式體驗"
   shape: rectangle
-  content: "使用者看到簡化且相關的選項"
+  content: "使用者看到簡化、相關的選項"
 }
 
 Final-Config: {
   label: "4. 最終設定"
-  content: "config.yaml 產生時帶有\n衝突解決策略"
+  content: "config.yaml 根據\n衝突解決策略產生"
 }
 
 User-Selections -> Wizard-Engine
@@ -68,34 +68,33 @@ Wizard-Engine.Conflict-Detection -> Final-Config
 Guided-Experience -> User-Selections: "優化"
 ```
 
-### 預設建議與選項篩選
+### 選項篩選
 
-當您進行選擇時，精靈會提供預設值並篩選後續選項，以引導您進行邏輯性的設定。這是基於一組跨問題的衝突規則。
+當您進行選擇時，精靈會篩選後續選項，引導您達成一個合乎邏輯的設定。這是基於一組跨問題的衝突規則，用以防止不相容的選擇。
 
--   **預設建議**：如果您選擇「快速入門」作為主要目標，精靈會建議將讀者的知識水平設定為「完全是初學者」。
--   **即時篩選**：如果您的目標受眾是「終端使用者（非技術人員）」，精靈將會隱藏「是專家」的知識水平選項。此規則的理由是非技術使用者通常不是經驗豐富的技術使用者，從而防止不相容的選擇。
+例如，如果您選擇「終端使用者（非技術背景）」作為您的目標受眾，精靈將會隱藏「是專家」這個知識水平選項。該規則的理由是「非技術背景的使用者通常不是經驗豐富的技術使用者」，從而防止不合邏輯的選擇。
 
 ### 衝突偵測與解決
 
-在某些情況下，您可能有多個目標或受眾，需要特定的文件結構才能有效，例如為非技術性的**終端使用者**和專家級的**開發人員**建立文件。精靈會將這些情況識別為「可解決的衝突」。
+在某些情況下，您可能有多個目標或受眾，需要特定的文件結構才能有效，例如為非技術背景的**終端使用者**和專業的**開發人員**建立文件。精靈將這些情況識別為「可解決的衝突」。
 
-然後，它會制定一個策略，在文件結構中解決這些需求。對於終端使用者與開發人員的例子，解決策略是建立獨立的使用者路徑：
+然後，它會制定一個策略，在文件結構內解決這些需求。以終端使用者與開發人員的例子來說，解決策略是建立獨立的使用者路徑：
 
--   **使用者指南路徑**：使用淺顯的語言，專注於 UI 互動，並以業務成果為導向。
--   **開發人員指南路徑**：以程式碼為優先，技術上精確，並包含 SDK 範例和設定片段。
+-   **使用者指南路徑**：使用淺顯的語言，專注於使用者介面互動，並以業務成果為導向。
+-   **開發人員指南路徑**：以程式碼優先，技術上精確，並包含 SDK 範例和設定片段。
 
-這種方法確保最終的文件結構能夠有效地服務多個受眾，而不是建立單一、混亂的內容組合。
+這種方法確保最終的文件結構能有效地服務多個受眾，而不是創造一個單一、混亂的內容組合。
 
 ## 產生的輸出
 
-完成精靈後，它會在您的專案中儲存一個 `config.yaml` 檔案。此檔案有完整的註解，解釋了每個選項並列出了所有可用的選擇，使其易於稍後手動檢閱和修改。
+完成精靈後，它會在您的專案中儲存一個 `config.yaml` 檔案。這個檔案有完整的註解，解釋了每個選項並列出了所有可用選擇，使其易於日後手動檢視和修改。
 
 以下是產生的檔案片段：
 
 ```yaml config.yaml icon=logos:yaml
 # 用於文件發布的專案資訊
 projectName: your-project-name
-projectDesc: 您的專案描述。
+projectDesc: Your project description.
 projectLogo: ""
 
 # =============================================================================
@@ -110,10 +109,10 @@ documentPurpose:
   - completeTasks
   - findAnswers
 
-# 目標受眾：誰會最常閱讀此文件？
+# 目標受眾：誰會最常閱讀這份文件？
 # 可用選項（取消註解並視需要修改）：
-#   endUsers         - 終端使用者（非技術人員）：使用產品但不編寫程式碼的人
-#   developers       - 開發人員整合您的產品/API：將此產品/API 加入其專案的工程師
+#   endUsers         - 終端使用者（非技術背景）：使用產品但不寫程式的人
+#   developers       - 開發人員整合您的產品/API：將此加入其專案的工程師
 targetAudienceTypes:
   - endUsers
   - developers
@@ -121,6 +120,10 @@ targetAudienceTypes:
 # ... 其他設定
 ```
 
+完成後，您將在終端機中看到一條確認訊息。
+
+![一個終端機視窗，顯示互動式設定精靈已成功完成。](../assets/screenshots/doc-complete-setup.png)
+
 ## 後續步驟
 
 設定檔案就緒後，您就可以產生、翻譯或發布您的文件了。
@@ -130,6 +133,6 @@ targetAudienceTypes:
     了解如何使用單一指令從您的原始碼自動建立一套完整的文件。
   </x-card>
   <x-card data-title="設定指南" data-icon="lucide:settings" data-href="/configuration">
-    深入了解所有可用的設定，並學習如何手動微調 config.yaml 檔案。
+    深入了解所有可用設定，並學習如何手動微調 config.yaml 檔案。
   </x-card>
 </x-cards>

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.  **目标受众**：指定文档的主要读者（例如，非技术最终用户、开发者）。
+2.  **目标受众**：明确文档的主要读者（例如，非技术最终用户、开发者）。
 3.  **读者知识水平**：评估受众的典型初始知识水平。
 4.  **文档深度**：确定内容的详细程度和范围。
 5.  **主要语言**：设置文档的主要语言。
 6.  **翻译语言**：选择用于翻译的其他语言。
-7.  **输出目录**：指定生成的文档文件的位置。
+7.  **输出目录**：指定生成文档文件的位置。
 8.  **源代码路径**：定义要分析的文件和目录，支持 glob 模式。
 
 ## 辅助配置
 
-向导使用一套预定义的规则来帮助您创建连贯且有效的配置。
+向导使用一套预定义规则来帮助您创建连贯有效的配置。
 
 ```d2
 direction: down
@@ -59,7 +59,7 @@ Guided-Experience: {
 
 Final-Config: {
   label: "4. 最终配置"
-  content: "生成 config.yaml 并包含\n冲突解决策略"
+  content: "config.yaml 生成时\n包含冲突解决策略"
 }
 
 User-Selections -> Wizard-Engine
@@ -68,43 +68,42 @@ Wizard-Engine.Conflict-Detection -> Final-Config
 Guided-Experience -> User-Selections: "优化"
 ```
 
-### 默认建议和选项过滤
+### 选项过滤
 
-当您进行选择时，向导会提供默认值并过滤后续选项，以引导您进行逻辑配置。这是基于一套跨问题冲突规则。
+在您做出选择时，向导会过滤后续选项，以引导您进行逻辑配置。这是基于一套跨问题冲突规则，可防止不兼容的选择。
 
--   **默认建议**：如果您选择“快速入门”作为主要目标，向导将推荐“完全是初学者”作为读者的知识水平。
--   **实时过滤**：如果您的目标受众是“最终用户（非技术人员）”，向导将隐藏“是专家”这个知识水平选项。该规则的理由是，非技术用户通常不是经验丰富的技术用户，从而防止了不兼容的选择。
+例如，如果您选择“最终用户（非技术）”作为目标受众，向导将隐藏“是专家”这一知识水平选项。该规则的理由是“非技术用户通常不是经验丰富的技术用户”，从而防止不合逻辑的选择。
 
 ### 冲突检测与解决
 
 在某些情况下，您可能有多个目标或受众，需要特定的文档结构才能有效，例如为非技术的**最终用户**和专业的**开发者**创建文档。向导将这些情况识别为“可解决的冲突”。
 
-然后，它会制定一个策略来在文档结构中满足这些需求。对于最终用户与开发者的例子，解决策略是创建独立的用户路径：
+然后，它会制定一个策略，在文档结构中满足这些需求。对于最终用户与开发者的例子，解决方法是创建独立的用户路径：
 
--   **用户指南路径**：使用通俗易懂的语言，侧重于 UI 交互，并面向业务成果。
+-   **用户指南路径**：使用通俗易懂的语言，侧重于 UI 交互，并以业务成果为导向。
 -   **开发者指南路径**：代码优先，技术上精确，并包含 SDK 示例和配置片段。
 
 这种方法确保最终的文档结构能够有效地服务于多个受众，而不是创建一个单一、混乱的内容混合体。
 
 ## 生成的输出
 
-完成向导后，它会在您的项目中保存一个 `config.yaml` 文件。该文件带有完整的注释，解释了每个选项并列出了所有可用选择，这使得以后手动审查和修改变得容易。
+完成向导后，它会在您的项目中保存一个 `config.yaml` 文件。该文件有完整的注释，解释了每个选项并列出了所有可用选项，便于以后手动审查和修改。
 
 以下是生成文件的片段：
 
 ```yaml config.yaml icon=logos:yaml
 # 用于文档发布的项目信息
 projectName: your-project-name
-projectDesc: 您的项目描述。
+projectDesc: Your project description.
 projectLogo: ""
 
 # =============================================================================
 # 文档配置
 # =============================================================================
 
-# 目的：您希望读者达到的主要结果是什么？
+# 目的：您希望读者达成的最主要成果是什么？
 # 可用选项（根据需要取消注释并修改）：
-#   getStarted       - 快速入门：帮助新用户在 <30 分钟内从零到上手
+#   getStarted       - 快速入门：帮助新用户在 30 分钟内从零开始上手
 #   completeTasks    - 完成特定任务：引导用户完成常见工作流程和用例
 documentPurpose:
   - completeTasks
@@ -112,8 +111,8 @@ documentPurpose:
 
 # 目标受众：谁会最常阅读这份文档？
 # 可用选项（根据需要取消注释并修改）：
-#   endUsers         - 最终用户（非技术人员）：使用产品但不编码的人
-#   developers       - 开发者（集成您的产品/API）：将此添加到其项目中的工程师
+#   endUsers         - 最终用户（非技术）：使用产品但不编写代码的人
+#   developers       - 集成您的产品/API 的开发者：将此产品添加到其项目中的工程师
 targetAudienceTypes:
   - endUsers
   - developers
@@ -121,9 +120,13 @@ targetAudienceTypes:
 # ... 其他设置
 ```
 
+完成后，您将在终端中看到一条确认消息。
+
+![一个终端窗口，显示交互式设置向导成功完成。](../assets/screenshots/doc-complete-setup.png)
+
 ## 后续步骤
 
-配置文件就位后，您就可以生成、翻译或发布您的文档了。
+配置文件就绪后，您就可以生成、翻译或发布您的文档了。
 
 <x-cards>
   <x-card data-title="生成文档" data-icon="lucide:play-circle" data-href="/features/generate-documentation">

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

@@ -1,94 +1,64 @@
 # 言語サポート
 
-AIGNE DocSmithはAIを使用して、12言語への自動ドキュメント翻訳を提供します。これにより、`aigne doc translate`コマンドを使用して、世界中の読者向けのドキュメントを生成および維持できます。
-
-翻訳ワークフローは、ソースドキュメントをAIエンジンで処理し、選択したターゲット言語でローカライズされたバージョンを生成します。
-
-```d2
-direction: down
-
-Source-Doc: {
-  label: "ソースドキュメント\n(例：英語)"
-  shape: rectangle
-}
-
-AI-Engine: {
-  label: "AIGNE DocSmith\nAI翻訳エンジン"
-  shape: rectangle
-}
-
-Translated-Docs: {
-  label: "翻訳済みドキュメント"
-  shape: rectangle
-  grid-columns: 3
-
-  zh: "简体中文"
-  ja: "日本語"
-  es: "Español"
-  fr: "Français"
-  de: "Deutsch"
-  more: "..."
-}
-
-Source-Doc -> AI-Engine: "`aigne doc translate`"
-AI-Engine -> Translated-Docs: "生成"
-```
+AIGNE DocSmithは、12言語へのドキュメントの自動翻訳を提供し、グローバルな読者向けのローカライズされたコンテンツの生成と維持を可能にします。この機能は主に `aigne doc translate` コマンドを通じて管理されます。
+
+翻訳ワークフローは、AIエンジンを使用してソースドキュメントを処理し、選択したターゲット言語でバージョンを生成します。`aigne doc translate` コマンドは、翻訳するドキュメントと言語を選択するためのインタラクティブなインターフェースを提供します。
+
+![インタラクティブなドキュメント翻訳フロー](../assets/screenshots/doc-translate.png)
 
 ## サポートされている言語
 
-DocSmithは、以下の言語に対してAIによる翻訳を提供します。プロジェクトの初期設定時に主要言語を定義し、翻訳対象として任意の数のターゲット言語を選択できます。
-
-| 言語 | 言語コード | サンプルテキスト |
-|---|---|---|
-| English | `en` | こんにちは |
-| 简体中文 | `zh` | 你好 |
-| 繁體中文 | `zh-TW` | 你好 |
-| 日本語 | `ja` | こんにちは |
-| 한국어 | `ko` | 안녕하세요 |
-| Español | `es` | Hola |
-| Français | `fr` | Bonjour |
-| Deutsch | `de` | Hallo |
-| Português | `pt` | Olá |
-| Русский | `ru` | Привет |
-| Italiano | `it` | Ciao |
-| العربية | `ar` | مرحبا |
+DocSmithは、以下の言語に対するAIによる翻訳をサポートしています。プロジェクトの主要言語は `aigne doc init` による初期設定時に定義でき、以下の言語からいくつでも翻訳対象として選択できます。
+
+| Language | Language Code |
+|---|---|
+| English | `en` |
+| 简体中文 | `zh` |
+| 繁體中文 | `zh-TW` |
+| 日本語 | `ja` |
+| 한국어 | `ko` |
+| Español | `es` |
+| Français | `fr` |
+| Deutsch | `de` |
+| Português | `pt` |
+| Русский | `ru` |
+| Italiano | `it` |
+| العربية | `ar` |
 
 ## 翻訳の設定と使用方法
 
-翻訳言語は、`aigne doc init`でプロジェクトを初期化する際に設定されます。`aigne doc translate`コマンドを使用すれば、いつでも新しい言語を追加したり、ドキュメントを翻訳したりできます。このコマンドには2つの操作モードがあります。
+言語設定は、プロジェクトを初期化する際に設定します。`aigne doc translate` コマンドを使用して、いつでも新しい言語を追加したり、既存のドキュメントを翻訳したりできます。このコマンドは2つの操作モードをサポートしています。
 
 ### ガイド付き翻訳のためのインタラクティブモード
 
-ステップバイステップのガイド付きエクスペリエンスを利用するには、引数なしでコマンドを実行します。これはほとんどのユーザーに推奨されるアプローチです。
+ステップバイステップのガイド付きプロセスについては、引数なしでコマンドを実行してください。この方法はほとんどのユーザーに推奨されます。
 
 ```bash Interactive Translation icon=lucide:wand
 aigne doc translate
 ```
 
-インタラクティブモードでは、一連のプロンプトが表示され、以下の操作が可能です：
+インタラクティブモードでは、一連のプロンプトが表示され、翻訳するドキュメントを選択し、リストからターゲット言語を選ぶことができます。このモードでは、プロジェクトの設定にまだ含まれていない新しい翻訳言語を追加することもできます。
 
-1.  既存のドキュメントのリストから翻訳するものを選択する。
-2.  サポートされているリストから1つ以上のターゲット言語を選択する。
-3.  プロジェクトの設定にまだ含まれていない新しい翻訳言語を追加する。
+![翻訳対象言語の選択](../assets/screenshots/doc-translate-langs.png)
 
 ### 自動化のためのコマンドライン引数
 
-直接的な制御や自動化スクリプトで使用するために、ドキュメントと言語をコマンドライン引数として直接指定できます。これは開発者やCI/CDパイプラインに最適です。
+直接制御したり、自動化スクリプトで使用したりする場合は、ドキュメントと言語をコマンドライン引数として指定できます。この方法は、CI/CDパイプラインへの統合に適しています。
 
 ```bash Command Example icon=lucide:terminal
-# overview.mdとexamples.mdを中国語と日本語に翻訳
+# overview.mdとexamples.mdを中国語と日本語に翻訳する
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 ```
 
-このコマンドの主要なパラメータは次のとおりです：
+以下の表は、`translate` コマンドの主要なパラメータを詳述しています。
 
-| パラメータ | 説明 |
+| Parameter | Description |
 |---|---|
-| `--langs` | ターゲット言語の言語コードを指定します。このフラグは複数回使用して、いくつかの言語を選択できます。 |
-| `--docs` | 翻訳するドキュメントへのパスを指定します（例：`overview.md`）。これも複数回使用できます。 |
-| `--feedback` | 翻訳モデルをガイドするための具体的な指示を提供します（例：`"フォーマルなトーンを使用する"`）。 |
+| `--langs` | ターゲット言語の言語コードを指定します。このフラグを複数回使用して、複数の言語を選択できます。 |
+| `--docs` | 翻訳するドキュメントへのパス（例：`overview.md`）を指定します。このフラグも複数回使用できます。 |
+| `--feedback` | 翻訳モデルをガイドするための特定の指示を提供します（例：`"Use a formal tone"`）。 |
 | `--glossary` | カスタム用語集ファイル（例：`@path/to/glossary.md`）を使用して、プロジェクト固有の用語の一貫した翻訳を保証します。 |
 
 ---
 
-このセクションでは、利用可能な言語とその有効化方法について説明しました。翻訳ワークフローに関する完全なガイドについては、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。
+このセクションでは、利用可能な言語とその有効化方法の概要を説明しました。翻訳ワークフローに関する完全なガイドについては、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。

package/docs/configuration-language-support.md

@@ -1,94 +1,64 @@
 # Language Support
 
-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 an AI engine to generate localized versions in your selected target languages.
-
-```d2
-direction: down
-
-Source-Doc: {
-  label: "Source Document\n(e.g., English)"
-  shape: rectangle
-}
-
-AI-Engine: {
-  label: "AIGNE DocSmith\nAI Translation Engine"
-  shape: rectangle
-}
-
-Translated-Docs: {
-  label: "Translated Documents"
-  shape: rectangle
-  grid-columns: 3
-
-  zh: "简体中文"
-  ja: "日本語"
-  es: "Español"
-  fr: "Français"
-  de: "Deutsch"
-  more: "..."
-}
-
-Source-Doc -> AI-Engine: "`aigne doc translate`"
-AI-Engine -> Translated-Docs: "Generates"
-```
+AIGNE DocSmith provides automated documentation translation into 12 languages, enabling you to generate and maintain localized content for a global audience. This functionality is primarily managed through the `aigne doc translate` command.
+
+The translation workflow uses an AI engine to process your source documents and generate versions in your selected target languages. The `aigne doc translate` command offers an interactive interface to guide you through selecting documents and languages for translation.
+
+![Interactive document translation flow](../assets/screenshots/doc-translate.png)
 
 ## Supported Languages
 
-DocSmith offers AI-powered translations for the following languages. You can define your project's primary language during the initial setup and select any number of target languages for translation.
-
-| Language | Language Code | Sample Text |
-|---|---|---|
-| English | `en` | Hello |
-| 简体中文 | `zh` | 你好 |
-| 繁體中文 | `zh-TW` | 你好 |
-| 日本語 | `ja` | こんにちは |
-| 한국어 | `ko` | 안녕하세요 |
-| Español | `es` | Hola |
-| Français | `fr` | Bonjour |
-| Deutsch | `de` | Hallo |
-| Português | `pt` | Olá |
-| Русский | `ru` | Привет |
-| Italiano | `it` | Ciao |
-| العربية | `ar` | مرحبا |
+DocSmith supports AI-powered translations for the following languages. Your project's primary language can be defined during the initial setup with `aigne doc init`, and you can select any number of the following languages for translation.
+
+| Language | Language Code |
+|---|---|
+| English | `en` |
+| 简体中文 | `zh` |
+| 繁體中文 | `zh-TW` |
+| 日本語 | `ja` |
+| 한국어 | `ko` |
+| Español | `es` |
+| Français | `fr` |
+| Deutsch | `de` |
+| Português | `pt` |
+| Русский | `ru` |
+| Italiano | `it` |
+| العربية | `ar` |
 
 ## 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 has two modes of operation.
+Language settings are configured when you initialize a project. You can add new languages or translate existing documents at any time using the `aigne doc translate` command, which supports two operational modes.
 
 ### Interactive Mode for Guided Translation
 
-For a step-by-step guided experience, run the command without any arguments. This is the recommended approach for most users.
+For a step-by-step guided process, run the command without any arguments. This method is recommended for most users.
 
 ```bash Interactive Translation icon=lucide:wand
 aigne doc translate
 ```
 
-The interactive mode will then present a series of prompts that allow you to:
+The interactive mode presents a series of prompts, allowing you to select which documents to translate and choose your target languages from a list. This mode also allows you to 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.
+![Selecting target languages for translation](../assets/screenshots/doc-translate-langs.png)
 
 ### Command-Line Arguments for Automation
 
-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.
+For direct control or for use in automated scripts, you can specify documents and languages as command-line arguments. This method is suitable for integration into CI/CD pipelines.
 
 ```bash Command Example icon=lucide:terminal
 # Translate overview.md and examples.md into Chinese and Japanese
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 ```
 
-Key parameters for the command include:
+The following table details the key parameters for the `translate` command:
 
 | Parameter | Description |
 |---|---|
-| `--langs` | Specify a target language code. This flag can be used multiple times to select several languages. |
-| `--docs` | Specify the path to a document to translate (e.g., `overview.md`). This can also be used multiple times. |
-| `--feedback` | Provide specific instructions to guide the translation model (e.g., `"Use a formal tone"`). |
-| `--glossary` | Use a custom glossary file (e.g., `@path/to/glossary.md`) to ensure consistent translation of project-specific terms. |
+| `--langs` | Specifies a target language code. This flag can be used multiple times to select several languages. |
+| `--docs` | Specifies the path to a document to translate (e.g., `overview.md`). This flag can also be used multiple times. |
+| `--feedback` | Provides specific instructions to guide the translation model (e.g., `"Use a formal tone"`). |
+| `--glossary` | Uses a custom glossary file (e.g., `@path/to/glossary.md`) to ensure consistent translation of project-specific terms. |
 
 ---
 
-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.
+This section provides an overview of the available languages and how to enable them. For a complete guide on the translation workflow, refer to the [Translate Documentation](./features-translate-documentation.md) guide.

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

@@ -1,94 +1,64 @@
 # 語言支援
 
-AIGNE DocSmith 使用 AI 提供 12 種語言的自動化文件翻譯。這讓您可以使用 `aigne doc translate` 命令為全球使用者產生和維護文件。
-
-翻譯工作流程會透過 AI 引擎處理您的來源文件，以產生您所選目標語言的本地化版本。
-
-```d2
-direction: down
-
-Source-Doc: {
-  label: "來源文件\n（例如，英文）"
-  shape: rectangle
-}
-
-AI-Engine: {
-  label: "AIGNE DocSmith\nAI 翻譯引擎"
-  shape: rectangle
-}
-
-Translated-Docs: {
-  label: "翻譯後的文件"
-  shape: rectangle
-  grid-columns: 3
-
-  zh: "简体中文"
-  ja: "日本語"
-  es: "Español"
-  fr: "Français"
-  de: "Deutsch"
-  more: "..."
-}
-
-Source-Doc -> AI-Engine: "`aigne doc translate`"
-AI-Engine -> Translated-Docs: "產生"
-```
+AIGNE DocSmith 提供 12 種語言的自動化文件翻譯功能，讓您能夠為全球受眾產生並維護本地化內容。此功能主要透過 `aigne doc translate` 命令進行管理。
 
-## 支援的語言
+翻譯工作流程使用 AI 引擎處理您的來源文件，並產生您所選目標語言的版本。`aigne doc translate` 命令提供一個互動式介面，引導您選擇要翻譯的文件和語言。
 
-DocSmith 為以下語言提供 AI 驅動的翻譯。您可以在初始設定時定義專案的主要語言，並選擇任意數量的目標語言進行翻譯。
+![互動式文件翻譯流程](../assets/screenshots/doc-translate.png)
 
-| 語言 | 語言代碼 | 範例文字 |
-|---|---|---|
-| English | `en` | Hello |
-| 简体中文 | `zh` | 你好 |
-| 繁體中文 | `zh-TW` | 你好 |
-| 日本語 | `ja` | こんにちは |
-| 한국어 | `ko` | 안녕하세요 |
-| Español | `es` | Hola |
-| Français | `fr` | Bonjour |
-| Deutsch | `de` | Hallo |
-| Português | `pt` | Olá |
-| Русский | `ru` | Привет |
-| Italiano | `it` | Ciao |
-| العربية | `ar` | مرحبا |
+## 支援的語言
 
-## 如何設定與使用翻譯
+DocSmith 支援以下語言的 AI 翻譯。您可以在使用 `aigne doc init` 進行初始設定時定義專案的主要語言，並可選擇以下任何數量的語言進行翻譯。
 
-翻譯語言是在您使用 `aigne doc init` 初始化專案時設定的。您可以隨時使用 `aigne doc translate` 命令新增語言或翻譯文件，該命令有兩種操作模式。
+| 語言 | 語言代碼 |
+|---|---|
+| 英語 | `en` |
+| 简体中文 | `zh` |
+| 繁體中文 | `zh-TW` |
+| 日本語 | `ja` |
+| 한국어 | `ko` |
+| Español | `es` |
+| Français | `fr` |
+| Deutsch | `de` |
+| Português | `pt` |
+| Русский | `ru` |
+| Italiano | `it` |
+| العربية | `ar` |
+
+## 如何設定與使用翻譯功能
+
+語言設定在您初始化專案時進行配置。您可以隨時使用 `aigne doc translate` 命令新增語言或翻譯現有文件，該命令支援兩種操作模式。
 
 ### 用於引導式翻譯的互動模式
 
-若要獲得逐步引導的體驗，請在不帶任何參數的情況下執行此命令。這是對大多數使用者推薦的方法。
+若要進行逐步引導的流程，請執行不含任何參數的命令。建議大多數使用者使用此方法。
 
-```bash Interactive Translation icon=lucide:wand
+```bash 互動式翻譯 icon=lucide:wand
 aigne doc translate
 ```
 
-互動模式將會顯示一系列提示，讓您可以：
+互動模式會顯示一系列提示，讓您能夠選擇要翻譯的文件，並從清單中選擇您的目標語言。如果專案設定中尚未包含新的翻譯語言，此模式也允許您新增。
 
-1.  從清單中選擇要翻譯的現有文件。
-2.  從支援的清單中選擇一種或多種目標語言。
-3.  如果專案設定中尚未包含新的翻譯語言，則可以將其新增。
+![選擇目標翻譯語言](../assets/screenshots/doc-translate-langs.png)
 
 ### 用於自動化的命令列參數
 
-若要直接控制或在自動化腳本中使用，您可以直接將文件和語言指定為命令列參數。這對於開發人員和 CI/CD 管線來說是理想的選擇。
+為了直接控制或在自動化腳本中使用，您可以將文件和語言指定為命令列參數。此方法適合整合到 CI/CD 管線中。
 
-```bash Command Example icon=lucide:terminal
+```bash 命令範例 icon=lucide:terminal
 # 將 overview.md 和 examples.md 翻譯成中文和日文
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 ```
 
-該命令的主要參數包括：
+下表詳細說明了 `translate` 命令的主要參數：
 
 | 參數 | 說明 |
 |---|---|
-| `--langs` | 指定目標語言代碼。此旗標可以多次使用以選擇多種語言。 |
-| `--docs` | 指定要翻譯的文件的路徑（例如，`overview.md`）。此旗標也可以多次使用。 |
-| `--feedback` | 提供具體說明以指導翻譯模型（例如，`"使用正式語氣"`）。 |
-| `--glossary` | 使用自訂詞彙表檔案（例如，`@path/to/glossary.md`）以確保專案特定術語的翻譯一致性。 |
+| `--langs` | 指定目標語言代碼。此旗標可多次使用以選擇多種語言。 |
+| `--docs` | 指定要翻譯的文件的路徑（例如 `overview.md`）。此旗標也可多次使用。 |
+| `--feedback` | 提供具體指令以引導翻譯模型（例如 `「使用正式語氣」`）。 |
+| `--glossary` | 使用自訂詞彙表檔案（例如 `@path/to/glossary.md`）以確保專案特定術語的翻譯一致性。 |
 
 ---
 
-本節介紹了可用的語言以及如何啟用它們。有關翻譯工作流程的完整指南，請參閱 [翻譯文件](./features-translate-documentation.md) 指南。
+本節概述了可用的語言以及如何啟用它們。有關翻譯工作流程的完整指南，請參閱 [翻譯文件](./features-translate-documentation.md) 指南。