@aigne/doc-smith 0.8.11-beta.6 → 0.8.11

package/docs/configuration-language-support.md

@@ -1,94 +1,64 @@
 # Language Support
 
-AIGNE DocSmith uses AI to provide automated documentation translation into 12 languages. 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) 指南。

package/docs/configuration-language-support.zh.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 驱动的翻译。您可以在初始设置期间定义项目的主要语言，并选择任意数量的目标语言进行翻译。
-
-| 语言 | 语言代码 | 示例文本 |
-|---|---|---|
-| 英语 | `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` 进行初始设置时定义项目的主要语言，并可以选择以下任意数量的语言进行翻译。
+
+| 语言 | 语言代码 |
+|---|---|
+| 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` 命令添加新语言或翻译文档，该命令有两种操作模式。
+语言设置在您初始化项目时进行配置。您可以随时使用 `aigne doc translate` 命令添加新语言或翻译现有文档，该命令支持两种操作模式。
 
 ### 用于引导式翻译的交互模式
 
-要获得分步指导的体验，请在不带任何参数的情况下运行该命令。这是大多数用户的推荐方法。
+如需分步引导流程，请运行不带任何参数的命令。建议大多数用户使用此方法。
 
 ```bash 交互式翻译 icon=lucide:wand
 aigne doc translate
 ```
 
-然后，交互模式将显示一系列提示，允许您：
+交互模式会显示一系列提示，允许您选择要翻译的文档并从列表中选择目标语言。如果项目中尚未包含某些翻译语言，此模式也允许您将其添加到项目配置中。
 
-1.  从列表中选择要翻译的现有文档。
-2.  从支持的语言列表中选择一个或多个目标语言。
-3.  如果项目中尚未包含新的翻译语言，则将其添加到项目配置中。
+![选择目标翻译语言](../assets/screenshots/doc-translate-langs.png)
 
 ### 用于自动化的命令行参数
 
-为了直接控制或在自动化脚本中使用，您可以直接将文档和语言指定为命令行参数。这对于开发人员和 CI/CD 流水线非常理想。
+为了直接控制或在自动化脚本中使用，您可以将文档和语言指定为命令行参数。此方法适用于集成到 CI/CD 管道中。
 
 ```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) 指南。

package/docs/configuration-llm-setup.ja.md

@@ -1,44 +1,46 @@
-# LLMセットアップ
+# LLM セットアップ
 
-AIGNE DocSmithは、大規模言語モデル（LLM）を使用してドキュメントコンテンツを生成します。AIモデルプロバイダーは、統合されたAIGNE Hubを使用する方法と、独自のカスタムAPIキーを接続する方法の2通りで設定できます。
+AIGNE DocSmith は、大規模言語モデル (LLM) を使用してドキュメンテーションコンテンツを生成します。AI モデルプロバイダーの設定は、主に 2 つの方法で行うことができます。統合された AIGNE Hub を利用する方法、またはお好みのプロバイダーから独自のカスタム API キーを接続する方法です。
 
-## AIGNE Hub（推奨）
+## AIGNE Hub (推奨)
 
-最も手軽に始める方法はAIGNE Hubを使用することです。これは複数のLLMプロバイダーへのゲートウェイとして機能し、主に2つの利点があります：
+LLM を設定する最も直接的な方法は、AIGNE Hub を使用することです。これは複数の LLM プロバイダーへのゲートウェイとして機能し、主に 2 つの利点があります。
 
-- **APIキー不要：** 独自のAPIキーやサービス契約を管理することなく、ドキュメントを生成できます。
-- **簡単なモデル切り替え：** `--model`フラグを使用することで、どのコマンドでもAIモデルを変更できます。
+- **API キー不要:** 独自の API キーやサービスサブスクリプションを管理する必要なく、ドキュメントを生成できます。
+- **柔軟なモデル切り替え:** `--model` フラグを使用することで、任意のコマンドの AI モデルを変更できます。
 
-AIGNE Hubを通じて特定のモデルを使用するには、コマンドに`--model`フラグを追加します。以下にいくつかの例を示します：
+AIGNE Hub を介して特定のモデルを使用するには、コマンドに `--model` フラグを追加します。以下の例でその使用方法を示します。
 
-```bash Using Different Models via AIGNE Hub icon=mdi:code-braces
-# GoogleのGemini 2.5 Flashモデルを使用
-aigne doc generate --model google:gemini-2.5-flash
+```bash AIGNE Hub経由で異なるモデルを使用する icon=mdi:code-braces
+# OpenAI の GPT-4o モデルを使用
+aigne doc generate --model openai:gpt-4o
 
-# AnthropicのClaude 3.5 Sonnetモデルを使用
-aigne doc generate --model claude:claude-3-5-sonnet
+# Anthropic の Claude 4.5 Sonnet モデルを使用
+aigne doc generate --model anthropic:claude-sonnet-4-5
 
-# OpenAIのGPT-4oモデルを使用
-aigne doc generate --model openai:gpt-4o
+# Google の Gemini 2.5 Pro モデルを使用
+aigne doc generate --model google:gemini-2.5-pro
 ```
 
-モデルを指定しない場合、DocSmithはプロジェクトの設定ファイルで定義されたデフォルトのモデルを使用します。
+`--model` フラグが指定されていない場合、DocSmith はプロジェクトの設定ファイルで定義されたモデルをデフォルトで使用します。
 
-## カスタムAPIキーの使用
+## カスタム API キーの使用
 
-OpenAIやAnthropicのようなプロバイダーで自身のアカウントを使用したい場合は、個人のAPIキーでDocSmithを設定できます。この方法により、APIの使用状況と請求を直接管理できます。
+OpenAI、Anthropic、Google などのプロバイダーで独自のアカウントを使用したいユーザーのために、DocSmith は個人の API キーで設定できます。この方法により、API の使用状況と請求を直接管理できます。
 
-設定は対話型のウィザードを通じて行われます。ウィザードを起動するには、次のコマンドを実行してください：
+設定は対話型ウィザードを通じて行われます。起動するには、次のコマンドを実行します。
 
-```bash
+```bash 対話型ウィザードの起動 icon=lucide:magic-wand
 aigne doc init
 ```
 
-ウィザードがプロバイダーの選択と認証情報の入力を求めます。詳細なガイドについては、[対話型セットアップ](./configuration-interactive-setup.md)のドキュメントを参照してください。
+ウィザードがプロバイダーの選択と必要な認証情報の入力を求めます。このプロセスの完全なステップバイステップガイドについては、[インタラクティブ設定](./configuration-interactive-setup.md) のドキュメントを参照してください。
 
 ## デフォルトモデルの設定
 
-すべてのドキュメント生成タスクで一貫性を保つために、プロジェクトの`aigne.yaml`設定ファイルでデフォルトのLLMを設定できます。このモデルは、`--model`フラグを含まないコマンドで使用されます。
+すべてのドキュメント生成タスクで一貫性を保つため、プロジェクトの `aigne.yaml` 設定ファイルでデフォルトの LLM を設定できます。このモデルは、`--model` フラグを明示的に含まないすべてのコマンドで使用されます。
+
+以下は設定例です。
 
 ```yaml aigne.yaml icon=mdi:file-code
 chat_model:
@@ -47,8 +49,8 @@ chat_model:
   temperature: 0.8
 ```
 
-この例では、DocSmithはGoogleの`gemini-2.5-pro`モデルをデフォルトで使用し、`temperature`設定は`0.8`に設定されています。
+この例では、DocSmith は Google の `gemini-2.5-pro` モデルを `temperature` 設定 `0.8` で、すべての生成タスクのデフォルトとして使用するように設定されています。
 
 ---
 
-LLMプロバイダーの設定が完了したら、ドキュメントの言語設定を管理する準備が整いました。サポートされている言語の完全なリストを確認し、それらを有効にする方法については、[言語サポート](./configuration-language-support.md)ガイドに進んでください。
+LLM プロバイダーの設定が完了したら、次のステップはドキュメントの言語設定を管理することです。[言語サポート](./configuration-language-support.md) ガイドに進み、サポートされている言語の全リストを確認し、それらを有効にする方法を学んでください。

package/docs/configuration-llm-setup.md

@@ -1,44 +1,46 @@
 # LLM Setup
 
-AIGNE DocSmith uses Large Language Models (LLMs) to generate documentation content. You can configure the AI model provider in two ways: using the integrated AIGNE Hub, or by connecting your own custom API keys.
+AIGNE DocSmith uses Large Language Models (LLMs) to generate documentation content. Configuration of the AI model provider can be accomplished through two primary methods: utilizing the integrated AIGNE Hub or connecting your own custom API keys from a provider of your choice.
 
 ## AIGNE Hub (Recommended)
 
-The most direct way to start is with AIGNE Hub. It functions as a gateway to multiple LLM providers, offering two main benefits:
+The most direct method for configuring the LLM is through AIGNE Hub. It functions as a gateway to multiple LLM providers, offering two main benefits:
 
-- **No API Key Required:** You can generate documents without managing your own API keys or service subscriptions.
-- **Easy Model Switching:** You can change the AI model for any command by using the `--model` flag.
+- **No API Key Required:** You can generate documents without the need to manage your own API keys or service subscriptions.
+- **Flexible Model Switching:** You can change the AI model for any command by using the `--model` flag.
 
-To use a specific model through AIGNE Hub, add the `--model` flag to your command. Here are a few examples:
+To use a specific model through AIGNE Hub, append the `--model` flag to your command. The following examples demonstrate its usage:
 
 ```bash Using Different Models via AIGNE Hub icon=mdi:code-braces
-# Use Google's Gemini 2.5 Flash model
-aigne doc generate --model google:gemini-2.5-flash
-
-# Use Anthropic's Claude 3.5 Sonnet model
-aigne doc generate --model claude:claude-3-5-sonnet
-
 # Use OpenAI's GPT-4o model
 aigne doc generate --model openai:gpt-4o
+
+# Use Anthropic's Claude 4.5 Sonnet model
+aigne doc generate --model anthropic:claude-sonnet-4-5
+
+# Use Google's Gemini 2.5 Pro model
+aigne doc generate --model google:gemini-2.5-pro
 ```
 
-If you do not specify a model, DocSmith will use the default model defined in your project's configuration.
+If the `--model` flag is not specified, DocSmith will default to the model defined in your project's configuration file.
 
 ## Using Custom API Keys
 
-If you prefer to use your own accounts with providers like OpenAI or Anthropic, you can configure DocSmith with your personal API keys. This method gives you direct control over API usage and billing.
+For users who prefer to use their own accounts with providers such as OpenAI, Anthropic, or Google, DocSmith can be configured with personal API keys. This method provides direct control over API usage and billing.
 
 Configuration is handled through an interactive wizard. To launch it, run the following command:
 
-```bash
+```bash Launching the Interactive Wizard icon=lucide:magic-wand
 aigne doc init
 ```
 
-The wizard will prompt you to select your provider and enter your credentials. For a complete guide, refer to the [Interactive Setup](./configuration-interactive-setup.md) documentation.
+The wizard will prompt you to select your provider and enter the necessary credentials. For a complete, step-by-step guide on this process, refer to the [Interactive Setup](./configuration-interactive-setup.md) documentation.
 
 ## Setting a Default Model
 
-To maintain consistency across all documentation generation tasks, you can set a default LLM in your project's `aigne.yaml` configuration file. This model will be used for any command that does not include the `--model` flag.
+To maintain consistency across all documentation generation tasks, a default LLM can be set in your project's `aigne.yaml` configuration file. This model will be used for any command that does not explicitly include the `--model` flag.
+
+The following is an example configuration:
 
 ```yaml aigne.yaml icon=mdi:file-code
 chat_model:
@@ -47,8 +49,8 @@ chat_model:
   temperature: 0.8
 ```
 
-In this example, DocSmith is configured to use Google's `gemini-2.5-pro` model with a `temperature` setting of `0.8` by default.
+In this example, DocSmith is configured to use Google's `gemini-2.5-pro` model with a `temperature` setting of `0.8` as the default for all generation tasks.
 
 ---
 
-With your LLM provider configured, you are ready to manage language settings for your documentation. Proceed to the [Language Support](./configuration-language-support.md) guide to see the full list of supported languages and learn how to enable them.
+With the LLM provider configured, the next step is to manage language settings for your documentation. Proceed to the [Language Support](./configuration-language-support.md) guide to see the full list of supported languages and learn how to enable them.

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

@@ -1,44 +1,46 @@
 # LLM 設定
 
-AIGNE DocSmith 使用大型語言模型 (LLM) 來產生文件內容。您可以透過兩種方式設定 AI 模型提供者：使用整合的 AIGNE Hub，或連接您自己的自訂 API 金鑰。
+AIGNE DocSmith 使用大型語言模型 (LLM) 來產生文件內容。AI 模型提供者的設定可以透過兩種主要方式完成：使用整合的 AIGNE Hub 或連接您自己選擇的提供者的自訂 API 金鑰。
 
 ## AIGNE Hub (推薦)
 
-最直接的開始方式是使用 AIGNE Hub。它作為多個 LLM 提供者的閘道，提供兩大好處：
+設定 LLM 最直接的方法是透過 AIGNE Hub。它作為多個 LLM 提供者的閘道，提供兩大好處：
 
-- **無需 API 金鑰：** 您無需管理自己的 API 金鑰或服務訂閱即可產生文件。
-- **輕鬆切換模型：** 您可以使用 `--model` 旗標為任何指令變更 AI 模型。
+- **無需 API 金鑰：** 您可以產生文件，而無需管理自己的 API 金鑰或服務訂閱。
+- **靈活的模型切換：** 您可以使用 `--model` 旗標為任何指令變更 AI 模型。
 
-若要透過 AIGNE Hub 使用特定模型，請在您的指令中加入 `--model` 旗標。以下是一些範例：
-
-```bash 使用不同模型透過 AIGNE Hub icon=mdi:code-braces
-# 使用 Google 的 Gemini 2.5 Flash 模型
-aigne doc generate --model google:gemini-2.5-flash
-
-# 使用 Anthropic 的 Claude 3.5 Sonnet 模型
-aigne doc generate --model claude:claude-3-5-sonnet
+若要透過 AIGNE Hub 使用特定模型，請在您的指令後加上 `--model` 旗標。以下範例展示了其用法：
 
+```bash 透過 AIGNE Hub 使用不同模型 icon=mdi:code-braces
 # 使用 OpenAI 的 GPT-4o 模型
 aigne doc generate --model openai:gpt-4o
+
+# 使用 Anthropic 的 Claude 4.5 Sonnet 模型
+aigne doc generate --model anthropic:claude-sonnet-4-5
+
+# 使用 Google 的 Gemini 2.5 Pro 模型
+aigne doc generate --model google:gemini-2.5-pro
 ```
 
-如果您未指定模型，DocSmith 將使用您專案設定中定義的預設模型。
+如果未指定 `--model` 旗標，DocSmith 將預設使用您專案設定檔中定義的模型。
 
 ## 使用自訂 API 金鑰
 
-如果您偏好使用自己像 OpenAI 或 Anthropic 等提供者的帳戶，您可以使用個人 API 金鑰來設定 DocSmith。這種方法讓您可以直接控制 API 的使用和計費。
+對於偏好使用自己在 OpenAI、Anthropic 或 Google 等提供者帳戶的使用者，DocSmith 可以設定個人 API 金鑰。此方法可直接控制 API 的使用和計費。
 
 設定是透過互動式精靈處理的。若要啟動它，請執行以下指令：
 
-```bash
+```bash 啟動互動式精靈 icon=lucide:magic-wand
 aigne doc init
 ```
 
-精靈會提示您選擇您的提供者並輸入您的憑證。有關完整的指南，請參閱 [互動式設定](./configuration-interactive-setup.md) 文件。
+精靈會提示您選擇您的提供者並輸入必要的憑證。有關此過程的完整逐步指南，請參閱 [互動式設定](./configuration-interactive-setup.md) 文件。
 
 ## 設定預設模型
 
-為了在所有文件產生任務中保持一致性，您可以在專案的 `aigne.yaml` 設定檔中設定預設的 LLM。此模型將用於任何不包含 `--model` 旗標的指令。
+為維持所有文件產生任務的一致性，可以在您專案的 `aigne.yaml` 設定檔中設定預設的 LLM。此模型將用於任何未明確包含 `--model` 旗標的指令。
+
+以下是範例設定：
 
 ```yaml aigne.yaml icon=mdi:file-code
 chat_model:
@@ -47,8 +49,8 @@ chat_model:
   temperature: 0.8
 ```
 
-在此範例中，DocSmith 預設設定為使用 Google 的 `gemini-2.5-pro` 模型，並將 `temperature` 設定為 `0.8`。
+在此範例中，DocSmith 設定為使用 Google 的 `gemini-2.5-pro` 模型，並將 `temperature` 設定為 `0.8`，作為所有產生任務的預設值。
 
 ---
 
-設定好您的 LLM 提供者後，您就可以開始管理文件的語言設定了。請前往 [語言支援](./configuration-language-support.md) 指南查看支援的語言完整清單，並了解如何啟用它們。
+設定好 LLM 提供者後，下一步是管理您文件的語言設定。請前往 [語言支援](./configuration-language-support.md) 指南，查看支援的語言完整列表並了解如何啟用它們。