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

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) 指南，查看支援的語言完整列表並了解如何啟用它們。

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

@@ -1,44 +1,46 @@
 # LLM 设置
 
-AIGNE DocSmith 使用大语言模型 (LLMs) 生成文档内容。您可以通过两种方式配置 AI 模型提供商：使用集成的 AIGNE Hub，或连接您自己的自定义 API 密钥。
+AIGNE DocSmith 使用大语言模型 (LLM) 生成文档内容。配置 AI 模型提供商主要有两种方法：利用集成的 AIGNE Hub，或连接您选择的提供商的自定义 API 密钥。
 
 ## AIGNE Hub (推荐)
 
-最直接的入门方式是使用 AIGNE Hub。它充当多个 LLM 提供商的网关，提供两大主要优势：
+配置 LLM 最直接的方法是通过 AIGNE Hub。它作为多个 LLM 提供商的网关，提供两大优势：
 
 - **无需 API 密钥：** 您无需管理自己的 API 密钥或服务订阅即可生成文档。
-- **轻松切换模型：** 您可以使用 `--model` 标志为任何命令更改 AI 模型。
+- **灵活切换模型：** 您可以使用 `--model` 标志为任何命令更改 AI 模型。
 
-要通过 AIGNE Hub 使用特定模型，请在命令中添加 `--model` 标志。以下是一些示例：
+要通过 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
-
 # 使用 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 等提供商处的账户的用户，可以使用个人 API 密钥配置 DocSmith。这种方法可以对 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-preferences.ja.md

@@ -1,78 +1,93 @@
 # プリファレンスの管理
 
-AIGNE DocSmithは、ユーザーのフィードバックから学習するように設計されています。生成されたコンテンツを調整または修正すると、DocSmithはそのフィードバックを「プリファレンス」と呼ばれる永続的なルールに変換できます。これらのルールにより、特定のスタイル、構造要件、コンテンツポリシーが将来のドキュメント作成タスクで一貫して適用されるようになります。すべてのプリファレンスは、プロジェクトのルートにある人間が読めるYAMLファイル `.aigne/doc-smith/preferences.yml` に保存されます。
+AIGNE DocSmith は、フィードバックから学習するように設計されています。生成されたコンテンツを改良または修正すると、DocSmith はそのフィードバックをプリファレンスと呼ばれる永続的なルールに変換できます。これらのルールにより、特定のスタイル、構造要件、コンテンツポリシーが将来のドキュメント作成タスクで一貫して適用されるようになります。すべてのプリファレンスは、プロジェクトルートの `.aigne/doc-smith/preferences.yml` にある人間が読めるYAMLファイルに保存されます。
 
 ## プリファレンスのライフサイクル
 
-次の図は、フィードバックが再利用可能なルールとなり、将来のタスクに適用され、コマンドラインから管理されるまでの流れを示しています。
+次の図は、フィードバックが再利用可能なルールになり、将来のタスクに適用され、コマンドラインから管理される方法を示しています。
 
 ```d2 プリファレンスのライフサイクル
 direction: down
 
-feedback: {
-  label: "1. ユーザーが「refine」または「translate」中に\nフィードバックを提供"
-  shape: rectangle
+developer: {
+  label: "開発者"
+  shape: person
 }
 
-refiner: {
-  label: "2. Feedback Refiner Agentが\nフィードバックを分析"
+docsmith_system: {
+  label: "AIGNE DocSmith システム"
   shape: rectangle
-}
 
-decision: {
-  label: "再利用可能なポリシーか？"
-  shape: diamond
+  cli: {
+    label: "CLI コマンド\n(refine / translate)"
+    shape: rectangle
+  }
+
+  agent: {
+    label: "内部分析 Agent"
+    shape: rectangle
+  }
+
+  decision: {
+    label: "フィードバックは\n再利用可能なポリシーか？"
+    shape: diamond
+  }
+
+  create_rule: {
+    label: "新しいプリファレンスルールを作成"
+    shape: rectangle
+  }
 }
 
-pref_file: {
-  label: "3. preferences.yml\nルールが保存される"
+preferences_file: {
+  label: ".aigne/doc-smith/preferences.yml"
   shape: cylinder
 }
 
-future_tasks: {
-  label: "4. 将来のタスク\n保存されたルールが適用される"
-  shape: rectangle
-}
-
-cli: {
-  label: "5. CLI管理\n('aigne doc prefs')"
-  shape: rectangle
+one_time_fix: {
+  label: "一度限りの修正として適用"
+  shape: oval
 }
 
-feedback -> refiner: "入力"
-refiner -> decision: "分析"
-decision -> pref_file: "はい"
-decision -> "破棄（一度限りの修正）": "いいえ"
-pref_file -> future_tasks: "適用される"
-cli <-> pref_file: "管理"
-
+developer -> docsmith_system.cli: "1. フィードバックを提供"
+docsmith_system.cli -> docsmith_system.agent: "2. フィードバックをキャプチャ"
+docsmith_system.agent -> docsmith_system.decision: "3. 分析"
+docsmith_system.decision -> docsmith_system.create_rule: "はい"
+docsmith_system.create_rule -> preferences_file: "4. ルールをファイルに保存"
+docsmith_system.decision -> one_time_fix: "いいえ"
 ```
 
-### プリファレンスが作成される仕組み
+### プリファレンスの作成方法
 
-`refine` または `translate` の段階でフィードバックを提供すると、内部のAgentがその入力を分析します。フィードバックが一度限りの修正（例：タイポの修正）なのか、再利用可能なポリシー（例：「コードコメントは常に英語で書く」）なのかを判断します。それが永続的な指示であると判断された場合、新しいプリファレンスルールが作成されます。
+`refine` または `translate` の段階でフィードバックを提供すると、内部 Agent が入力を分析します。フィードバックが一度限りの修正（例：タイポの修正）か、再利用可能なポリシー（例：「コードコメントは常に英語で書く」）かを判断します。それが永続的な指示を表す場合、新しいプリファレンスルールを作成し、プロジェクトの `preferences.yml` ファイルに保存します。
 
 ### ルールのプロパティ
 
-`preferences.yml` に保存される各ルールは、次の構造を持っています：
-
-<x-field data-name="id" data-type="string" data-desc="ルールの一意なランダムに生成された識別子（例：pref_a1b2c3d4e5f6g7h8）。"></x-field>
-<x-field data-name="active" data-type="boolean" data-desc="ルールが現在有効かどうかを示します。無効なルールは生成タスク中に無視されます。"></x-field>
-<x-field data-name="scope" data-type="string" data-desc="ルールをいつ適用するかを定義します。有効なスコープは 'global'、'structure'、'document'、または 'translation' です。"></x-field>
-<x-field data-name="rule" data-type="string" data-desc="将来のタスクでAIに渡される、具体的で洗練された指示。"></x-field>
-<x-field data-name="feedback" data-type="string" data-desc="参照用に保存される、ユーザーが提供した元の自然言語のフィードバック。"></x-field>
-<x-field data-name="createdAt" data-type="string" data-desc="ルールが作成された日時を示すISO 8601形式のタイムスタンプ。"></x-field>
-<x-field data-name="paths" data-type="string[]" data-required="false" data-desc="オプションのファイルパスのリスト。存在する場合、ルールはこれらの特定のソースファイルに対して生成されたコンテンツにのみ適用されます。"></x-field>
+`preferences.yml` に保存される各ルールは、次の構造を持ちます。
+
+<x-field-group>
+  <x-field data-name="id" data-type="string" data-desc="ルールの一意でランダムに生成された識別子（例：pref_a1b2c3d4e5f6g7h8）。"></x-field>
+  <x-field data-name="active" data-type="boolean" data-desc="ルールが現在有効かどうかを示します。無効なルールは生成タスク中に無視されます。"></x-field>
+  <x-field data-name="scope" data-type="string">
+    <x-field-desc markdown>ルールをいつ適用するかを定義します。有効なスコープは `global`、`structure`、`document`、または `translation` です。</x-field-desc>
+  </x-field>
+  <x-field data-name="rule" data-type="string" data-desc="将来のタスクでAIに渡される、具体的で洗練された指示。"></x-field>
+  <x-field data-name="feedback" data-type="string" data-desc="ユーザーから提供された元の自然言語のフィードバック。参照用に保存されます。"></x-field>
+  <x-field data-name="createdAt" data-type="string" data-desc="ルールが作成された日時を示すISO 8601タイムスタンプ。"></x-field>
+  <x-field data-name="paths" data-type="string[]" data-required="false">
+    <x-field-desc markdown>オプションのファイルパスのリスト。存在する場合、ルールはこれらの特定のソースファイルに対して生成されたコンテンツにのみ適用されます。</x-field-desc>
+  </x-field>
+</x-field-group>
 
 ## CLIによるプリファレンスの管理
 
-`aigne doc prefs` コマンドを使用して、保存されているすべてのプリファレンスを表示および管理できます。これにより、ルールの一覧表示、有効化、無効化、または恒久的な削除が可能です。
+`aigne doc prefs` コマンドを使用して、保存されているすべてのプリファレンスを表示および管理できます。これにより、ルールの一覧表示、有効化、無効化、または永久に削除することができます。
 
-### すべてのプリファレンスを一覧表示する
+### すべてのプリファレンスを一覧表示
 
-有効なものと無効なものを含め、保存されているすべてのプリファレンスを表示するには、`--list` フラグを使用します。
+保存されているすべてのプリファレンス（有効なものと無効なものの両方）の完全なリストを表示するには、`--list` フラグを使用します。
 
-```bash すべてのプリファレンスを一覧表示する icon=lucide:terminal
+```bash すべてのプリファレンスを一覧表示 icon=lucide:terminal
 aigne doc prefs --list
 ```
 
@@ -83,12 +98,12 @@ aigne doc prefs --list
 
 **フォーマットの説明：**
 - 🟢 = 有効なプリファレンス, ⚪ = 無効なプリファレンス
-- [scope] = プリファレンスのスコープ (global, structure, document, translation)
+- [scope] = プリファレンススコープ (global, structure, document, translation)
 - ID = 一意のプリファレンス識別子
 - Paths = 特定のファイルパス（該当する場合）
 
 🟢 [structure] pref_a1b2c3d4e5f6g7h8 | Paths: overview.md
-   概要ドキュメントの末尾に「次のステップ」セクションを追加する。
+   概要ドキュメントの最後に「次のステップ」セクションを追加します。
  
 ⚪ [document] pref_i9j0k1l2m3n4o5p6
    コードコメントは英語で記述する必要があります。
@@ -96,13 +111,13 @@ aigne doc prefs --list
 
 ### プリファレンスの無効化と再有効化
 
-ルールを削除せずに一時的に無効にしたい場合は、`--toggle` フラグを使用してアクティブステータスを切り替えることができます。IDなしでコマンドを実行すると、対話モードが起動し、切り替えたいプリファレンスを1つ以上選択できます。
+ルールを削除せずに一時的に無効にする必要がある場合は、`--toggle` フラグで有効ステータスを切り替えることができます。IDなしでコマンドを実行すると対話モードが起動し、切り替えるプリファレンスを1つ以上選択できます。
 
-```bash 対話形式でプリファレンスを切り替える icon=lucide:terminal
+```bash プリファレンスを対話的に切り替える icon=lucide:terminal
 aigne doc prefs --toggle
 ```
 
-特定のルールを直接切り替えるには、`--id` フラグでそのIDを指定します。これは `deactivateRule` 関数に対応しており、ルールの `active` プロパティを `false` に設定します。
+特定のルールを直接切り替えるには、`--id` フラグでそのIDを指定します。このアクションは、ルールの `active` プロパティを変更します。
 
 ```bash 特定のプリファレンスを切り替える icon=lucide:terminal
 aigne doc prefs --toggle --id pref_i9j0k1l2m3n4o5p6
@@ -110,15 +125,15 @@ aigne doc prefs --toggle --id pref_i9j0k1l2m3n4o5p6
 
 ### プリファレンスの削除
 
-1つ以上のプリファレンスを完全に削除するには、`--remove` フラグを使用します。この操作は `removeRule` 関数に対応し、元に戻すことはできません。
+1つ以上のプリファレンスを完全に削除するには、`--remove` フラグを使用します。この操作は元に戻せません。
 
 対話的な選択プロンプトを表示するには、IDなしでコマンドを実行します。
 
-```bash 対話形式でプリファレンスを削除する icon=lucide:terminal
+```bash プリファレンスを対話的に削除する icon=lucide:terminal
 aigne doc prefs --remove
 ```
 
-特定のルールをIDで直接削除するには、`--id` フラグを使用します。
+特定のルールを直接削除するには、`--id` フラグでそのIDを指定します。
 
 ```bash 特定のプリファレンスを削除する icon=lucide:terminal
 aigne doc prefs --remove --id pref_a1b2c3d4e5f6g7h8
@@ -126,4 +141,4 @@ aigne doc prefs --remove --id pref_a1b2c3d4e5f6g7h8
 
 ## 次のステップ
 
-プリファレンスの管理は、DocSmithをプロジェクトの特定のニーズに合わせて調整するための重要な部分です。さらなるカスタマイズオプションについては、メインの[設定ガイド](./configuration.md)をご覧ください。
+プリファレンスの管理は、DocSmithをプロジェクトの特定のニーズに合わせて調整する上で重要な部分です。その他のカスタマイズオプションについては、メインの[設定ガイド](./configuration.md)をご覧ください。