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

package/docs/features-publish-your-docs.zh-TW.md

@@ -0,0 +1,107 @@
+# 發布您的文件
+
+產生文件後，`aigne doc publish` 指令會將您的內容上傳到 Discuss Kit 平台，使其可以在線上存取。本指南將說明如何將您的文件發布到官方平台或您自己託管的網站。
+
+## 發布流程
+
+`aigne doc publish` 指令會啟動一個互動式流程。當您首次發布到新目標時，它會引導您進行身份驗證。後續的發布將使用已儲存的憑證。
+
+```d2 發布流程 icon=lucide:upload-cloud
+direction: down
+shape: sequence_diagram
+
+使用者: { shape: c4-person }
+CLI: { label: "AIGNE CLI" }
+瀏覽器: { label: "瀏覽器" }
+平台: { label: "Discuss Kit 平台" }
+
+使用者 -> CLI: "aigne doc publish"
+
+alt: "首次發布或缺少設定" {
+  CLI -> 使用者: "選擇平台\n(官方 / 自行託管)"
+  使用者 -> CLI: "提供選擇"
+  CLI -> 瀏覽器: "開啟驗證 URL"
+  使用者 -> 瀏覽器: "登入並授權"
+  瀏覽器 -> 平台: "傳送憑證"
+  平台 -> CLI: "返回存取權杖"
+  CLI -> CLI: "儲存權杖以供未來使用"
+}
+
+CLI -> 平台: "上傳文件與媒體檔案"
+平台 -> CLI: "成功回應"
+CLI -> 使用者: "✅ 發布成功！"
+
+```
+
+## 發布選項
+
+您有兩種主要選項來託管您的文件：
+
+<x-cards data-columns="2">
+  <x-card data-title="官方平台" data-icon="lucide:globe">
+    發布到 [docsmith.aigne.io](https://docsmith.aigne.io/app/)，這是由 AIGNE 提供的免費公開託管平台。對於開源專案或需要快速分享文件的情況，這是一個不錯的選擇。
+  </x-card>
+  <x-card data-title="您自己的網站" data-icon="lucide:server">
+    發布到您自己的 Discuss Kit 實例，以完全控制存取權限和品牌。這適用於內部或私密文件。您可以從 [Blocklet 商店](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu) 取得 Discuss Kit 實例。
+  </x-card>
+</x-cards>
+
+## 步驟指南
+
+請按照以下步驟首次發布您的文件。
+
+### 1. 執行發布指令
+
+在您專案的根目錄中，執行以下指令：
+
+```bash Terminal icon=lucide:terminal
+aigne doc publish
+```
+
+### 2. 選擇您的平台
+
+如果這是您第一次發布，系統會提示您選擇一個目標。請選擇符合您需求的選項。
+
+![在官方平台或自行託管的實例之間選擇](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d03cf5eb7aea85aa.png)
+
+如果您選擇自己的網站，系統會要求您輸入其 URL。
+
+### 3. 驗證您的帳戶
+
+首次連接到新平台時，會開啟一個瀏覽器視窗讓您登入並授權 CLI。每個平台只需執行此步驟一次；您的存取權杖會儲存在本地的 `~/.aigne/doc-smith-connected.yaml` 檔案中，以供未來使用。
+
+### 4. 確認
+
+上傳完成後，您的終端機中會顯示一條成功訊息。
+
+```
+✅ 文件發布成功！
+```
+
+## 在 CI/CD 環境中發布
+
+對於自動化工作流程，您可以提供參數和環境變數來繞過互動式提示。
+
+| 方法 | 名稱 | 說明 |
+|---|---|---|
+| **參數** | `--appUrl` | 直接指定您的 Discuss Kit 實例的 URL。 |
+| **環境變數** | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | 提供存取權杖，跳過互動式登入。 |
+
+以下是一個適合 CI/CD 管線的非互動式發布指令範例：
+
+```bash CI/CD 範例 icon=lucide:workflow
+export DOC_DISCUSS_KIT_ACCESS_TOKEN="your_access_token_here"
+aigne doc publish --appUrl https://docs.mycompany.com
+```
+
+## 疑難排解
+
+如果在發布過程中遇到問題，請檢查以下常見問題：
+
+- **連線錯誤**：您提供的自行託管實例的 URL 可能不正確，或者伺服器無法連線。請驗證 URL 和您的網路連線。
+
+- **無效的網站 URL**：該 URL 必須指向一個在 ArcBlock 平台上建立的有效網站。CLI 會顯示類似 `The provided URL is not a valid website on ArcBlock platform` 的錯誤。若要託管您的文件，您可以先從[商店取得 Discuss Kit 實例](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu)。
+
+- **缺少必要元件**：目標網站必須安裝 Discuss Kit 元件。如果缺少該元件，CLI 將返回類似 `This website does not have required components for publishing` 的錯誤。請參考 [Discuss Kit 文件](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) 來新增必要的元件。
+
+有關指令和選項的完整清單，請參考 [CLI 指令參考](./cli-reference.md)。

package/docs/features-publish-your-docs.zh.md

@@ -1,10 +1,10 @@
-# 发布你的文档
+# 发布您的文档
 
-生成文档后，`aigne doc publish` 命令会将你的内容上传到 Discuss Kit 平台，使其可以在线访问。本指南将说明如何将文档发布到官方平台或你自己的自托管网站。
+生成文档后，`aigne doc publish` 命令会将您的内容上传到 Discuss Kit 平台，使其可以在线访问。本指南将说明如何将您的文档发布到官方平台或您自己的自托管网站。
 
-## 发布过程
+## 发布流程
 
-`aigne doc publish` 命令会启动一个交互式过程。当你首次发布到新目标时，它将引导你完成身份验证。后续的发布将使用已保存的凭据。
+`aigne doc publish` 命令会启动一个交互式流程。首次发布到新目的地时，它将引导您完成身份验证。后续的发布将使用已保存的凭据。
 
 ```d2 发布流程 icon=lucide:upload-cloud
 direction: down
@@ -35,44 +35,44 @@ CLI -> User: "✅ 发布成功！"
 
 ## 发布选项
 
-你有两种主要选项来托管你的文档：
+您有两个主要选项来托管您的文档：
 
 <x-cards data-columns="2">
   <x-card data-title="官方平台" data-icon="lucide:globe">
     发布到 [docsmith.aigne.io](https://docsmith.aigne.io/app/)，这是 AIGNE 提供的一个免费的公共托管平台。对于开源项目或希望快速分享文档的用户来说，这是一个不错的选择。
   </x-card>
-  <x-card data-title="你自己的网站" data-icon="lucide:server">
-    发布到你自己的 Discuss Kit 实例，以完全控制访问和品牌。这适用于内部或私有文档。你可以从 [Blocklet 商店](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu) 获取 Discuss Kit 实例。
+  <x-card data-title="您自己的网站" data-icon="lucide:server">
+    发布到您自己的 Discuss Kit 实例，以完全控制访问和品牌。这适用于内部或私有文档。您可以从 [Blocklet 商店](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu) 获取 Discuss Kit 实例。
   </x-card>
 </x-cards>
 
 ## 分步指南
 
-按照以下步骤首次发布你的文档。
+请按照以下步骤首次发布您的文档。
 
 ### 1. 运行发布命令
 
-在你的项目根目录中，运行以下命令：
+在您的项目根目录中，运行以下命令：
 
 ```bash Terminal icon=lucide:terminal
 aigne doc publish
 ```
 
-### 2. 选择你的平台
+### 2. 选择您的平台
 
-如果这是你第一次发布，系统将提示你选择一个目标。选择适合你需求的选项。
+如果这是您第一次发布，系统将提示您选择一个目的地。请选择适合您需求的选项。
 
 ![在官方平台或自托管实例之间选择](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d03cf5eb7aea85aa.png)
 
-如果你选择自己的网站，系统将要求你输入其 URL。
+如果您选择自己的网站，系统将要求您输入其 URL。
 
-### 3. 验证你的账户
+### 3. 验证您的账户
 
-首次连接到新平台时，浏览器窗口将打开，以便你登录并授权 CLI。每个平台只需执行此步骤一次；你的访问令牌会保存在本地的 `~/.aigne/doc-smith-connected.yaml` 文件中，以供将来使用。
+首次连接到新平台时，将打开一个浏览器窗口供您登录并授权 CLI。每个平台只需执行一次此步骤；您的访问令牌将保存在本地的 `~/.aigne/doc-smith-connected.yaml` 文件中，以备将来使用。
 
 ### 4. 确认
 
-上传完成后，你的终端将显示一条成功消息。
+上传完成后，您的终端将显示一条成功消息。
 
 ```
 ✅ 文档发布成功！
@@ -80,11 +80,11 @@ aigne doc publish
 
 ## 在 CI/CD 环境中发布
 
-对于自动化工作流，你可以提供参数和环境变量来绕过交互式提示。
+对于自动化工作流，您可以通过提供参数和环境变量来绕过交互式提示。
 
 | 方法 | 名称 | 描述 |
 |---|---|---|
-| **参数** | `--appUrl` | 直接指定你的 Discuss Kit 实例的 URL。 |
+| **参数** | `--appUrl` | 直接指定您的 Discuss Kit 实例的 URL。 |
 | **环境变量** | `DOC_DISCUSS_KIT_ACCESS_TOKEN` | 提供访问令牌，跳过交互式登录。 |
 
 以下是一个适用于 CI/CD 流程的非交互式发布命令示例：
@@ -94,14 +94,14 @@ export DOC_DISCUSS_KIT_ACCESS_TOKEN="your_access_token_here"
 aigne doc publish --appUrl https://docs.mycompany.com
 ```
 
-## 故障排除
+## 问题排查
 
-如果你在发布过程中遇到问题，请检查以下常见问题：
+如果在发布过程中遇到问题，请检查以下常见问题：
 
-- **连接错误**：提供的自托管实例 URL 可能不正确，或者服务器可能无法访问。请验证 URL 和你的网络连接。
+- **连接错误**：您提供的自托管实例的 URL 可能不正确，或者服务器可能无法访问。请验证 URL 和您的网络连接。
 
-- **无效的网站 URL**：该 URL 必须指向一个基于 ArcBlock 平台构建的有效网站。CLI 将显示类似 `The provided URL is not a valid website on ArcBlock platform` 的错误。要托管你的文档，你可以先从[商店获取一个 Discuss Kit 实例](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu)。
+- **无效的网站 URL**：该 URL 必须指向一个在 ArcBlock 平台上构建的有效网站。CLI 将显示类似 `The provided URL is not a valid website on ArcBlock platform` 的错误。要托管您的文档，您可以从[商店获取一个 Discuss Kit 实例](https://store.blocklet.dev/blocklets/z8ia1WEiBZ7hxURf6LwH21Wpg99vophFwSJdu)开始。
 
-- **缺少必需组件**：目标网站必须安装 Discuss Kit 组件。如果缺少该组件，CLI 将返回类似 `This website does not have required components for publishing` 的错误。请参阅 [Discuss Kit 文档](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) 以添加必要的组件。
+- **缺少必需组件**：目标网站必须安装 Discuss Kit 组件。如果缺少该组件，CLI 将返回类似 `This website does not have required components for publishing` 的错误。请参阅 [Discuss Kit 文档](https://www.arcblock.io/docs/web3-kit/en/discuss-kit)以添加必要的组件。
 
 有关命令和选项的完整列表，请参阅 [CLI 命令参考](./cli-reference.md)。

package/docs/features-translate-documentation.ja.md

@@ -0,0 +1,79 @@
+# ドキュメントの翻訳
+
+AIGNE DocSmithは、ドキュメントを12の異なる言語に翻訳でき、プロジェクトを世界中のオーディエンスに届けることができます。このツールは翻訳を管理するための2つの方法を提供します。ガイド付きセットアップのためのインタラクティブモードと、正確な制御と自動化のためのコマンドライン引数です。
+
+## インタラクティブな翻訳
+
+ガイド付きの体験には、引数なしで`translate`コマンドを実行します。これは、ステップバイステップのプロセスを好むユーザーに最適です。
+
+```bash
+aigne doc translate
+```
+
+このコマンドは、プロセスを案内するインタラクティブなウィザードを起動します。
+
+1.  **翻訳するドキュメントを選択：**既存のドキュメントのリストが表示されます。スペースバーを使用して、翻訳したいものを選択します。
+
+    ![翻訳するドキュメントを選択](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
+
+2.  **ターゲット言語を選択：**ドキュメントを選択した後、サポートされているオプションのリストから1つ以上のターゲット言語を選びます。
+
+    ![翻訳する言語を選択](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
+
+3.  **確認と実行：**DocSmithは翻訳を処理し、選択した各言語に対して選択されたファイルの新しいバージョンを生成します。
+
+## コマンドラインによる翻訳
+
+スクリプトやCI/CDパイプラインでの自動化には、コマンドラインフラグを使用して翻訳プロセスを制御します。この方法は、開発者や上級ユーザーに適しています。
+
+### コマンドパラメータ
+
+<x-field data-name="--langs" data-type="string" data-required="false" data-desc="ターゲット言語を1つ指定します。このフラグを複数回使用して、複数の言語を含めることができます（例：--langs zh --langs ja）。"></x-field>
+<x-field data-name="--docs" data-type="string" data-required="false" data-desc="翻訳するドキュメントのパスを指定します。これも複数回使用してバッチ翻訳が可能です。"></x-field>
+<x-field data-name="--feedback" data-type="string" data-required="false" data-desc="AIに提案を提供して、翻訳の品質をガイドします（例：--feedback &quot;フォーマルなトーンを使用してください&quot;）。"></x-field>
+<x-field data-name="--glossary" data-type="string" data-required="false" data-desc="Markdown形式の用語集ファイルを使用して、特定の用語の一貫性を確保します（例：--glossary @path/to/glossary.md）。"></x-field>
+
+### 例
+
+#### 特定のドキュメントの翻訳
+
+`overview.md`と`examples.md`を中国語と日本語に翻訳するには、以下を実行します。
+
+```bash
+aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
+```
+
+#### 用語集とフィードバックの使用
+
+ブランド名や技術用語が正しく翻訳されるように、用語集ファイルを提供できます。また、フィードバックを与えて翻訳スタイルを洗練させることもできます。
+
+```bash
+aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
+```
+
+## サポートされている言語
+
+DocSmithは、以下の言語の自動翻訳をサポートしています。
+
+| Language | Code |
+|---|---|
+| 英語 | en |
+| 簡体字中国語 | zh-CN |
+| 繁体字中国語 | zh-TW |
+| 日本語 | ja |
+| 韓国語 | ko |
+| スペイン語 | es |
+| フランス語 | fr |
+| ドイツ語 | de |
+| ポルトガル語 | pt-BR |
+| ロシア語 | ru |
+| イタリア語 | it |
+| アラビア語 | ar |
+
+---
+
+ドキュメントが翻訳されたら、世界と共有する準備が整いました。
+
+<x-card data-title="次へ：ドキュメントの公開" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="続きを読む">
+  ドキュメントを公開プラットフォームまたは独自のプライベートウェブサイトに公開する方法についてのガイド。
+</x-card>

package/docs/features-translate-documentation.zh-TW.md

@@ -0,0 +1,79 @@
+# 翻譯文件
+
+AIGNE DocSmith 可以將您的文件翻譯成 12 種不同的語言，讓您的專案能夠觸及全球受眾。此工具提供兩種管理翻譯的方式：用於引導式設定的互動模式，以及用於精確控制和自動化的命令列參數。
+
+## 互動式翻譯
+
+若想獲得引導式體驗，請執行不含任何參數的 `translate` 指令。這對於偏好逐步操作的使用者來說非常理想。
+
+```bash
+aigne doc translate
+```
+
+此指令會啟動一個互動式精靈，引導您完成整個過程：
+
+1.  **選取要翻譯的文件：** 您將看到現有文件的列表。使用空格鍵選取您想要翻譯的文件。
+
+    ![選取要翻譯的文件](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
+
+2.  **選擇目標語言：** 選取文件後，從支援的選項列表中選擇一種或多種目標語言。
+
+    ![選擇要翻譯的語言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
+
+3.  **確認並執行：** 接著 DocSmith 將處理翻譯，為每個選擇的語言產生您所選檔案的新版本。
+
+## 命令列翻譯
+
+對於指令稿或 CI/CD 管線中的自動化，請使用命令列旗標來控制翻譯過程。此方法適合開發人員和進階使用者。
+
+### 指令參數
+
+<x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一個目標語言。此旗標可多次使用以包含多種語言（例如，--langs zh --langs ja）。"></x-field>
+<x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻譯的文件的路徑。此旗標也可多次使用以進行批次翻譯。"></x-field>
+<x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建議以引導翻譯品質（例如，--feedback &quot;使用正式語氣&quot;）。"></x-field>
+<x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的詞彙表檔案，以確保特定術語的術語一致性（例如，--glossary @path/to/glossary.md）。"></x-field>
+
+### 範例
+
+#### 翻譯特定文件
+
+若要將 `overview.md` 和 `examples.md` 翻譯成中文和日文，請執行：
+
+```bash
+aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
+```
+
+#### 使用詞彙表和回饋
+
+為確保品牌名稱和技術術語翻譯正確，您可以提供一個詞彙表檔案。您也可以提供回饋來改善翻譯風格。
+
+```bash
+aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
+```
+
+## 支援的語言
+
+DocSmith 支援以下語言的自動翻譯：
+
+| 語言 | 代碼 |
+|---|---|
+| 英文 | en |
+| 簡體中文 | zh-CN |
+| 繁體中文 | zh-TW |
+| 日文 | ja |
+| 韓文 | ko |
+| 西班牙文 | es |
+| 法文 | fr |
+| 德文 | de |
+| 葡萄牙文 | pt-BR |
+| 俄文 | ru |
+| 義大利文 | it |
+| 阿拉伯文 | ar |
+
+---
+
+文件翻譯完成後，您就可以與世界分享了。
+
+<x-card data-title="下一步：發佈您的文件" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="閱讀更多">
+  關於如何將您的文件發佈到公共平台或您自己的私人網站的指南。
+</x-card>

package/docs/features-translate-documentation.zh.md

@@ -1,18 +1,18 @@
 # 翻译文档
 
-AIGNE DocSmith 可以将你的文档翻译成 12 种不同的语言，让你的项目面向全球受众。该工具提供两种管理翻译的方式：用于引导式设置的交互模式和用于精确控制与自动化的命令行参数。
+AIGNE DocSmith 可以将您的文档翻译成 12 种不同的语言，使您的项目能够覆盖全球受众。该工具提供两种管理翻译的方式：用于引导式设置的交互模式和用于精确控制和自动化的命令行参数。
 
 ## 交互式翻译
 
-如需引导式体验，请运行不带任何参数的 `translate` 命令。这非常适合喜欢分步操作的用户。
+如需引导式体验，请运行不带任何参数的 `translate` 命令。这对于喜欢逐步操作的用户来说是理想的选择。
 
 ```bash
 aigne doc translate
 ```
 
-该命令会启动一个交互式向导，引导你完成整个过程：
+此命令会启动一个交互式向导，引导您完成整个过程：
 
-1.  **选择要翻译的文档：** 系统将显示你现有文档的列表。使用空格键选择要翻译的文档。
+1.  **选择要翻译的文档：** 您将看到一个现有文档的列表。使用空格键选择您想要翻译的文档。
 
     ![选择要翻译的文档](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
 
@@ -24,13 +24,13 @@ aigne doc translate
 
 ## 命令行翻译
 
-对于脚本或 CI/CD 流水线中的自动化，请使用命令行标志来控制翻译过程。此方法适合开发者和高级用户。
+对于脚本或 CI/CD 管道中的自动化，请使用命令行标志来控制翻译过程。此方法适合开发人员和高级用户。
 
 ### 命令参数
 
-<x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一种目标语言。此标志可多次使用以包含多种语言（例如，--langs zh --langs ja）。"></x-field>
-<x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻译的文档路径。此标志也可多次使用以进行批量翻译。"></x-field>
-<x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建议以指导翻译质量（例如，--feedback &quot;使用正式语调&quot;）。"></x-field>
+<x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一个目标语言。此标志可以多次使用以包含多种语言（例如，--langs zh --langs ja）。"></x-field>
+<x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻译的文档的路径。此标志也可以多次使用以进行批量翻译。"></x-field>
+<x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建议以指导翻译质量（例如，--feedback &quot;使用正式语气&quot;）。"></x-field>
 <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的术语表文件，以确保特定术语的一致性（例如，--glossary @path/to/glossary.md）。"></x-field>
 
 ### 示例
@@ -45,7 +45,7 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 
 #### 使用术语表和反馈
 
-为确保品牌名称和技术术语翻译正确，你可以提供一个术语表文件。你也可以提供反馈来优化翻译风格。
+为确保品牌名称和技术术语翻译正确，您可以提供一个术语表文件。您还可以提供反馈以优化翻译风格。
 
 ```bash
 aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
@@ -72,8 +72,8 @@ DocSmith 支持以下语言的自动翻译：
 
 ---
 
-文档翻译完成后，你就可以与世界分享了。
+文档翻译完成后，您就可以与世界分享了。
 
-<x-card data-title="下一步：发布你的文档" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="阅读更多">
-  关于如何将文档发布到公共平台或你自己的私人网站的指南。
+<x-card data-title="下一步：发布您的文档" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="阅读更多">
+  关于如何将您的文档发布到公共平台或您自己的私人网站的指南。
 </x-card>

package/docs/features-update-and-refine.ja.md

@@ -0,0 +1,138 @@
+# 更新と改良
+
+進化するコードベースとドキュメントを同期させることは、重要なタスクです。AIGNE DocSmithは、コードの変更に基づく自動更新や、フィードバックに基づいた正確な改良を通じて、コンテンツを最新の状態に保つための直接的で柔軟な方法を提供します。
+
+このガイドでは、以下の方法について説明します：
+
+- ソースコードが変更されたときにドキュメントを自動的に更新する。
+- 特定のフィードバックを使用して特定のドキュメントを再生成する。
+- ドキュメント全体の構造を調整する。
+
+### ドキュメント更新のワークフロー
+
+以下の図は、ドキュメントを更新するために利用できるさまざまなパスを示しています：
+
+```d2 更新ワークフロー
+direction: down
+
+Start: {
+  shape: circle
+  label: "開始"
+}
+
+Code-Change: {
+  label: "ソースコードまたは\n設定の変更"
+  shape: rectangle
+}
+
+Content-Tweak: {
+  label: "コンテンツの\n改善が必要か？"
+  shape: rectangle
+}
+
+Structure-Tweak: {
+  label: "構造の\n改善が必要か？"
+  shape: rectangle
+}
+
+Start -> Code-Change
+Start -> Content-Tweak
+Start -> Structure-Tweak
+
+Code-Change -> Generate-Command: "aigne doc generate"
+
+Generate-Command -> Change-Detection: {
+  label: "変更検出"
+  shape: diamond
+}
+Change-Detection -> Auto-Regen: "影響を受ける\nドキュメントを再生成"
+
+Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
+Update-Command -> Manual-Regen: "特定の\nドキュメントを再生成"
+
+Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
+Generate-Feedback-Command -> Replan: "ドキュメント構造を\n再計画"
+
+End: {
+  shape: circle
+  label: "ドキュメント更新済み"
+}
+
+Auto-Regen -> End
+Manual-Regen -> End
+Replan -> End
+```
+
+---
+
+## 変更検出による自動更新
+
+`aigne doc generate` コマンドを実行すると、DocSmithはコードベースを分析し、前回の実行からの変更を検出し、影響を受けるドキュメントのみを再生成します。このプロセスにより、時間を節約し、不要なAPI呼び出しを削減できます。
+
+```shell icon=lucide:terminal
+# DocSmithが変更を検出し、必要なものだけを更新します
+aigne doc generate
+```
+
+![DocSmithが変更を検出し、必要なドキュメントのみを再生成します。](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
+
+### 完全な再生成を強制する
+
+キャッシュや以前の状態を無視して、すべてのドキュメントを最初から再生成する必要がある場合は、`--forceRegenerate` フラグを使用します。これは、大幅な設定変更後や、完全に新しいビルドを確実にしたい場合に便利です。
+
+```shell icon=lucide:terminal
+# すべてのドキュメントをゼロから再生成します
+aigne doc generate --forceRegenerate
+```
+
+---
+
+## 個々のドキュメントの改良
+
+対応するコードの変更なしに特定のドキュメントを改善するために、`aigne doc update` コマンドを使用すると、コンテンツの改良に関する的を絞った指示を提供できます。
+
+このコマンドは、対話形式またはコマンドライン引数を介して直接、2つの方法で使用できます。
+
+### 対話モード
+
+ガイド付きの体験をしたい場合は、引数なしでコマンドを実行します。DocSmithは、更新したいドキュメントを選択するためのメニューを表示します。選択後、フィードバックを入力するよう求められます。
+
+```shell icon=lucide:terminal
+# 対話式の更新プロセスを開始します
+aigne doc update
+```
+
+![更新したいドキュメントを対話形式で選択します。](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
+
+### 直接的なコマンドライン更新
+
+より高速なワークフローやスクリプト作成のために、フラグを使用してドキュメントとフィードバックを直接指定できます。これにより、正確で非対話的な更新が可能になります。
+
+```shell icon=lucide:terminal
+# 特定のドキュメントにフィードバックを付けて更新します
+aigne doc update --docs overview.md --feedback "Add a more detailed FAQ section at the end."
+```
+
+`update` コマンドの主要なパラメータ：
+
+| パラメータ  | 説明                                                                                      |
+| ---------- | ------------------------------------------------------------------------------------------------ |
+| `--docs`     | 更新したいドキュメントへのパス。バッチ更新のためにこのフラグを複数回使用できます。 |
+| `--feedback` | コンテンツを再生成する際に使用する具体的な指示。                       |
+
+---
+
+## 全体構造の最適化
+
+個々のドキュメントのコンテンツを改良するだけでなく、ドキュメント全体の構造も調整できます。セクションが欠けている場合や、既存の構成を改善できる場合は、`generate` コマンドにフィードバックを提供できます。
+
+このコマンドは、DocSmithに新しい入力に基づいてドキュメントプラン全体を再評価するよう指示します。
+
+```shell icon=lucide:terminal
+# 特定のフィードバックを付けてドキュメント構造を再生成します
+aigne doc generate --feedback "Remove the 'About' section and add a detailed 'API Reference'."
+```
+
+このアプローチは、行単位のコンテンツ編集ではなく、ドキュメントの目次に対する高レベルの変更に最適です。
+
+これらのツールを使用すると、プロジェクトと共に進化する正確なドキュメントを維持できます。コンテンツが改良されたら、世界中のオーディエンスに公開できます。その方法については、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドで学んでください。