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

package/docs/cli-reference.ja.md

@@ -1,16 +1,16 @@
-# CLI コマンドリファレンス
+# CLIコマンドリファレンス
 
-このガイドは、利用可能なすべての `aigne doc` サブコマンド、その引数、およびオプションに関する包括的なリファレンスを提供します。コマンドラインインターフェースを最大限に活用したいユーザーを対象としています。
+このガイドは、利用可能なすべての`aigne doc`サブコマンド、その引数、およびオプションに関する包括的なリファレンスを提供します。コマンドラインインターフェースを最大限に活用したいユーザーを対象としています。
 
-一般的な構文は次のとおりです:
+一般的な構文は次のとおりです：
 
-```bash command
+```bash command icon=lucide:terminal
 aigne doc <command> [options]
 ```
 
 ### コマンドのワークフロー
 
-以下の図は、DocSmithのCLIコマンドを使用してドキュメントを作成および維持する典型的なライフサイクルと、それらが相互作用するデータを示しています。
+以下の図は、DocSmithのCLIコマンドを使用してドキュメントを作成および維持する一般的なライフサイクルと、それらが相互作用するデータを示しています。
 
 ```d2
 direction: down
@@ -73,11 +73,11 @@ Utilities: {
   grid-columns: 2
   
   prefs: {
-    label: "設定の表示\n`aigne doc prefs`"
+    label: "設定管理\n`aigne doc prefs`"
     shape: rectangle
   }
   clear: {
-    label: "データのクリア\n`aigne doc clear`"
+    label: "データ消去\n`aigne doc clear`"
     shape: rectangle
   }
 }
@@ -87,8 +87,8 @@ Utilities: {
 
 # Setup and Generation
 Lifecycle.init -> Configuration: "作成"
-Source-Code -> Lifecycle.generate: "読み取り"
-Configuration -> Lifecycle.generate: "読み取り"
+Source-Code -> Lifecycle.generate: "読み込み"
+Configuration -> Lifecycle.generate: "読み込み"
 Lifecycle.generate -> Generated-Docs: "作成 / 上書き"
 Lifecycle.generate -> Lifecycle.init: {
   label: "設定がない場合に実行"
@@ -96,14 +96,14 @@ Lifecycle.generate -> Lifecycle.init: {
 }
 
 # Refinement Loop
-Generated-Docs <-> Lifecycle.Refinement: "読み取り & 書き込み"
+Generated-Docs <-> Lifecycle.Refinement: "読み書き"
 
 # Publishing
 Lifecycle.Refinement -> Lifecycle.publish
-Lifecycle.publish -> Published-Docs: "アップロード先"
+Lifecycle.publish -> Published-Docs: "アップロード"
 
 # Utility Connections
-Utilities.prefs -> Configuration: "読み取り"
+Utilities.prefs -> Configuration: "読み込み"
 Utilities.clear -> Configuration: "削除"
 Utilities.clear -> Generated-Docs: "削除"
 ```
@@ -116,11 +116,12 @@ Utilities.clear -> Generated-Docs: "削除"
 
 ### 使用例
 
-**セットアップウィザードを起動する:**
+**セットアップウィザードを起動します：**
 
 ```bash
 aigne doc init
 ```
+![対話型セットアップウィザード完了のスクリーンショット。](../assets/screenshots/doc-complete-setup.png)
 
 DocSmithをニーズに合わせて調整する方法の詳細については、[設定ガイド](./configuration.md)を参照してください。
 
@@ -128,37 +129,39 @@ DocSmithをニーズに合わせて調整する方法の詳細については、
 
 ## `aigne doc generate`
 
-ソースコードを分析し、設定に基づいてドキュメントの完全なセットを生成します。設定が見つからない場合は、対話式の設​​定ウィザード (`aigne doc init`) が自動的に起動します。
+ソースコードを分析し、設定に基づいて完全なドキュメントセットを生成します。設定が見つからない場合は、自動的に対話式のセットアップウィザード（`aigne doc init`）を起動します。
+
+![generateコマンド実行中のスクリーンショット。](../assets/screenshots/doc-generate.png)
 
 ### オプション
 
-| オプション              | タイプ    | 説明                                                                                                   |
-| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
-| `--forceRegenerate` | boolean | 既存のコンテンツを破棄し、すべてのドキュメントを最初から再生成します。                                     |
-| `--feedback`        | string  | ドキュメント全体の構造を調整および改良するためのフィードバックを提供します。                                   |
-| `--model`           | string  | 生成に使用する特定の言語モデルを指定します (例: `anthropic:claude-3-5-sonnet`)。デフォルトを上書きします。 |
+| オプション | タイプ | 説明 |
+| :------------------ | :------ | :------------------------------------------------------------------------------------------------------- |
+| `--forceRegenerate` | boolean | 既存のコンテンツを破棄し、すべてのドキュメントを最初から再生成します。 |
+| `--feedback` | string | ドキュメント全体の構造を調整・改良するためのフィードバックを提供します。 |
+| `--model` | string | 生成に使用する特定の言語モデルを指定します（例：`openai:gpt-4o`）。デフォルト設定を上書きします。 |
 
 ### 使用例
 
-**ドキュメントを生成または更新する:**
+**ドキュメントを生成または更新します：**
 
 ```bash
 aigne doc generate
 ```
 
-**すべてのドキュメントを強制的に完全に再生成する:**
+**すべてのドキュメントの完全な再生成を強制します：**
 
 ```bash
 aigne doc generate --forceRegenerate
 ```
 
-**フィードバックを元にドキュメント構造を改良する:**
+**フィードバックを反映してドキュメント構造を改良します：**
 
 ```bash
 aigne doc generate --feedback "APIの例のセクションを新しく追加し、「概要」ページを削除してください。"
 ```
 
-**特定のモデルを使用して生成する:**
+**特定のモデルを使用して生成します：**
 
 ```bash
 aigne doc generate --model openai:gpt-4o
@@ -168,59 +171,63 @@ aigne doc generate --model openai:gpt-4o
 
 ## `aigne doc update`
 
-特定のドキュメントを最適化し、再生成します。対話形式で実行してドキュメントを選択するか、オプションで直接指定できます。これは、プロジェクト全体を再生成することなく、フィードバックに基づいて対象を絞った改善を行うのに役立ちます。
+特定のドキュメントを最適化し、再生成します。対話形式で実行してドキュメントを選択するか、オプションで直接指定できます。これは、プロジェクト全体を再生成することなく、フィードバックに基づいて的を絞った改善を行うのに役立ちます。
+
+![updateコマンド実行中のスクリーンショット。](../assets/screenshots/doc-update.png)
 
 ### オプション
 
-| オプション     | タイプ  | 説明                                                                                 |
-| ---------- | ----- | ------------------------------------------------------------------------------------------- |
-| `--docs`     | array | 再生成するドキュメントパスのリスト。複数回指定できます。                         |
-| `--feedback` | string | 選択したドキュメントのコンテンツを改善するための具体的なフィードバックを提供します。              |
+| オプション | タイプ | 説明 |
+| :--------- | :---- | :-------------------------------------------------------------------------- |
+| `--docs` | array | 再生成するドキュメントのパスのリスト。複数回指定できます。 |
+| `--feedback` | string | 選択したドキュメントのコンテンツを改善するための具体的なフィードバックを提供します。 |
 
 ### 使用例
 
-**対話セッションを開始して更新するドキュメントを選択する:**
+**対話セッションを開始して更新するドキュメントを選択します：**
 
 ```bash
 aigne doc update
 ```
 
-**特定のドキュメントを対象を絞ったフィードバックで更新する:**
+**特定のドキュメントを的を絞ったフィードバックで更新します：**
 
 ```bash
-aigne doc update --docs /overview.md --feedback "より詳細なFAQ項目を追加してください"
+aigne doc update --docs /overview --feedback "より詳細なFAQ項目を追加してください"
 ```
 
 ---
 
 ## `aigne doc translate`
 
-既存のドキュメントを1つ以上の言語に翻訳します。対話形式で実行してドキュメントと言語を選択するか、引数として指定して非対話形式で実行できます。
+既存のドキュメントを1つ以上の言語に翻訳します。対話形式で実行してドキュメントや言語を選択することも、引数として指定して非対話形式で実行することもできます。
+
+![translateコマンド実行中のスクリーンショット。](../assets/screenshots/doc-translate.png)
 
 ### オプション
 
-| オプション       | タイプ  | 説明                                                                                                |
-| ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
-| `--docs`       | array | 翻訳するドキュメントパスのリスト。複数回指定できます。                                         |
-| `--langs`      | array | ターゲット言語コードのリスト (例: `zh-CN`, `ja`)。複数回指定できます。                            |
-| `--feedback`   | string | 翻訳の品質を向上させるためのフィードバックを提供します。                                               |
-| `--glossary`   | string | 言語間で一貫した用語を確保するための用語集ファイルへのパス。`@path/to/glossary.md` を使用します。 |
+| オプション | タイプ | 説明 |
+| :--------- | :---- | :----------------------------------------------------------------------------------- |
+| `--docs` | array | 翻訳するドキュメントのパスのリスト。複数回指定できます。 |
+| `--langs` | array | 翻訳先の言語コードのリスト（例：`zh-CN`、`ja`）。複数回指定できます。 |
+| `--feedback` | string | 翻訳の質を向上させるためのフィードバックを提供します。 |
+| `--glossary` | string | 言語間で一貫した用語を確保するための用語集ファイルへのパス。`@path/to/glossary.md`を使用します。 |
 
 ### 使用例
 
-**対話式の翻訳セッションを開始する:**
+**対話式の翻訳セッションを開始します：**
 
 ```bash
 aigne doc translate
 ```
 
-**特定のドキュメントを中国語と日本語に翻訳する:**
+**特定のドキュメントを中国語と日本語に翻訳します：**
 
 ```bash
-aigne doc translate --langs zh-CN --langs ja --docs /features/generate-documentation.md --docs /overview.md
+aigne doc translate --langs zh-CN --langs ja --docs /features/generate-documentation --docs /overview
 ```
 
-**用語集とフィードバックを使用して品質を向上させる翻訳:**
+**用語集とフィードバックを使用して翻訳品質を向上させます：**
 
 ```bash
 aigne doc translate --glossary @glossary.md --feedback "技術用語を一貫して使用してください"
@@ -232,21 +239,23 @@ aigne doc translate --glossary @glossary.md --feedback "技術用語を一貫し
 
 ドキュメントを公開し、共有可能なリンクを生成します。このコマンドは、コンテンツをDiscuss Kitインスタンスにアップロードします。公式のAIGNE DocSmithプラットフォームを使用するか、独自の[Discuss Kit](https://www.web3kit.rocks/discuss-kit)インスタンスを実行できます。
 
+![publishコマンド実行中のスクリーンショット。](../assets/screenshots/doc-publish.png)
+
 ### オプション
 
-| オプション     | タイプ   | 説明                                                                                          |
-| ---------- | ------ | ---------------------------------------------------------------------------------------------------- |
-| `--appUrl` | string | セルフホストしている Discuss Kit インスタンスの URL。指定しない場合、コマンドは対話形式で実行されます。 |
+| オプション | タイプ | 説明 |
+| :------- | :----- | :------------------------------------------------------------------------------------------------------ |
+| `--appUrl` | string | セルフホストしているDiscuss KitインスタンスのURL。指定しない場合、コマンドは対話形式で実行されます。 |
 
 ### 使用例
 
-**対話式の公開セッションを開始する:**
+**対話式の公開セッションを開始します：**
 
 ```bash
 aigne doc publish
 ```
 
-**セルフホストのインスタンスに直接公開する:**
+**セルフホストのインスタンスに直接公開します：**
 
 ```bash
 aigne doc publish --appUrl https://your-discuss-kit-instance.com
@@ -256,25 +265,46 @@ aigne doc publish --appUrl https://your-discuss-kit-instance.com
 
 ## `aigne doc prefs`
 
-プロジェクトの現在の設定を表示します。これは読み取り専用のコマンドで、`init` または `generate` プロセス中に適用された設定を確認するのに役立ちます。
+ユーザー設定とフィードバックに基づくルールを管理します。DocSmithは時間とともにフィードバックから学習し、永続的な設定を作成します。このコマンドを使用すると、これらの学習済みルールを表示、切り替え、または削除できます。
+
+### オプション
+
+| オプション | タイプ | 説明 |
+| :------- | :------ | :------------------------------------------------------------------------- |
+| `--list` | boolean | 保存されているすべての設定を一覧表示します。 |
+| `--remove` | boolean | 対話形式で1つ以上の設定を選択して削除するように促します。 |
+| `--toggle` | boolean | 対話形式で設定を選択し、その有効状態を切り替えるように促します。 |
+| `--id` | array | 直接削除または切り替える1つ以上の設定IDを指定します。 |
 
 ### 使用例
 
-**現在のプロジェクト設定を表示する:**
+**保存されているすべての設定を一覧表示します：**
+
+```bash
+aigne doc prefs --list
+```
+
+**対話式の削除モードを開始します：**
+
+```bash
+aigne doc prefs --remove
+```
+
+**IDで特定の設定を切り替えます：**
 
 ```bash
-aigne doc prefs
+aigne doc prefs --toggle --id "pref_2a1dfe2b09695aab"
 ```
 
 ---
 
 ## `aigne doc clear`
 
-ローカルに保存されたデータをクリアするための対話セッションを起動します。これを使用して、生成されたドキュメント、ドキュメント構造の設定、またはキャッシュされた認証トークンを削除できます。
+ローカルに保存されたデータを消去するための対話セッションを起動します。これを使用して、生成されたドキュメント、ドキュメント構造の設定、またはキャッシュされた認証トークンを削除できます。
 
 ### 使用例
 
-**対話式のクリーンアッププロセスを開始する:**
+**対話式のクリーンアッププロセスを開始します：**
 
 ```bash
 aigne doc clear

package/docs/cli-reference.md

@@ -4,7 +4,7 @@ This guide provides a comprehensive reference for all available `aigne doc` sub-
 
 The general syntax is:
 
-```bash command
+```bash command icon=lucide:terminal
 aigne doc <command> [options]
 ```
 
@@ -73,7 +73,7 @@ Utilities: {
   grid-columns: 2
   
   prefs: {
-    label: "View Config\n`aigne doc prefs`"
+    label: "Manage Prefs\n`aigne doc prefs`"
     shape: rectangle
   }
   clear: {
@@ -121,6 +121,7 @@ Manually starts the interactive configuration wizard. This is useful for setting
 ```bash
 aigne doc init
 ```
+![Screenshot of the interactive setup wizard completion.](../assets/screenshots/doc-complete-setup.png)
 
 For more details on how to tailor DocSmith to your needs, see the [Configuration Guide](./configuration.md).
 
@@ -130,13 +131,15 @@ For more details on how to tailor DocSmith to your needs, see the [Configuration
 
 Analyzes your source code and generates a complete set of documentation based on your configuration. If no configuration is found, it automatically launches the interactive setup wizard (`aigne doc init`).
 
+![Screenshot of the generate command running.](../assets/screenshots/doc-generate.png)
+
 ### Options
 
-| Option              | Type    | Description                                                                                                   |
-| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
-| `--forceRegenerate` | boolean | Discards existing content and regenerates all documentation from scratch.                                     |
-| `--feedback`        | string  | Provides feedback to adjust and refine the overall documentation structure.                                   |
-| `--model`           | string  | Specifies a particular large language model to use for generation (e.g., `anthropic:claude-3-5-sonnet`). Overrides the default. |
+| Option              | Type    | Description                                                                                              |
+| :------------------ | :------ | :------------------------------------------------------------------------------------------------------- |
+| `--forceRegenerate` | boolean | Discards existing content and regenerates all documentation from scratch.                                |
+| `--feedback`        | string  | Provides feedback to adjust and refine the overall documentation structure.                              |
+| `--model`           | string  | Specifies a particular large language model to use for generation (e.g., `openai:gpt-4o`). Overrides the default. |
 
 ### Usage Examples
 
@@ -170,12 +173,14 @@ aigne doc generate --model openai:gpt-4o
 
 Optimizes and regenerates specific documents. You can run it interactively to select documents or specify them directly with options. This is useful for making targeted improvements based on feedback without regenerating the entire project.
 
+![Screenshot of the update command running.](../assets/screenshots/doc-update.png)
+
 ### Options
 
-| Option     | Type  | Description                                                                                 |
-| ---------- | ----- | ------------------------------------------------------------------------------------------- |
-| `--docs`     | array | A list of document paths to regenerate. Can be specified multiple times.                         |
-| `--feedback` | string | Provides specific feedback to improve the content of the selected document(s).              |
+| Option     | Type  | Description                                                                 |
+| :--------- | :---- | :-------------------------------------------------------------------------- |
+| `--docs`     | array | A list of document paths to regenerate. Can be specified multiple times.    |
+| `--feedback` | string  | Provides specific feedback to improve the content of the selected document(s). |
 
 ### Usage Examples
 
@@ -188,7 +193,7 @@ aigne doc update
 **Update a specific document with targeted feedback:**
 
 ```bash
-aigne doc update --docs /overview.md --feedback "Add more detailed FAQ entries"
+aigne doc update --docs /overview --feedback "Add more detailed FAQ entries"
 ```
 
 ---
@@ -197,14 +202,16 @@ aigne doc update --docs /overview.md --feedback "Add more detailed FAQ entries"
 
 Translates existing documentation into one or more languages. It can be run interactively to select documents and languages, or non-interactively by specifying them as arguments.
 
+![Screenshot of the translate command running.](../assets/screenshots/doc-translate.png)
+
 ### Options
 
-| Option       | Type  | Description                                                                                                |
-| ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
-| `--docs`       | array | A list of document paths to translate. Can be specified multiple times.                                         |
-| `--langs`      | array | A list of target language codes (e.g., `zh-CN`, `ja`). Can be specified multiple times.                            |
-| `--feedback`   | string | Provides feedback to improve the quality of the translation.                                               |
-| `--glossary`   | string | Path to a glossary file to ensure consistent terminology across languages. Use `@path/to/glossary.md`. |
+| Option     | Type  | Description                                                                          |
+| :--------- | :---- | :----------------------------------------------------------------------------------- |
+| `--docs`     | array | A list of document paths to translate. Can be specified multiple times.              |
+| `--langs`    | array | A list of target language codes (e.g., `zh-CN`, `ja`). Can be specified multiple times. |
+| `--feedback` | string  | Provides feedback to improve the quality of the translation.                       |
+| `--glossary` | string  | Path to a glossary file to ensure consistent terminology across languages. Use `@path/to/glossary.md`. |
 
 ### Usage Examples
 
@@ -217,7 +224,7 @@ aigne doc translate
 **Translate specific documents into Chinese and Japanese:**
 
 ```bash
-aigne doc translate --langs zh-CN --langs ja --docs /features/generate-documentation.md --docs /overview.md
+aigne doc translate --langs zh-CN --langs ja --docs /features/generate-documentation --docs /overview
 ```
 
 **Translate with a glossary and feedback for improved quality:**
@@ -232,10 +239,12 @@ aigne doc translate --glossary @glossary.md --feedback "Use technical terminolog
 
 Publishes your documentation and generates a shareable link. This command uploads your content to a Discuss Kit instance. You can use the official AIGNE DocSmith platform or run your own instance of [Discuss Kit](https://www.web3kit.rocks/discuss-kit).
 
+![Screenshot of the publish command running.](../assets/screenshots/doc-publish.png)
+
 ### Options
 
-| Option     | Type   | Description                                                                                          |
-| ---------- | ------ | ---------------------------------------------------------------------------------------------------- |
+| Option   | Type   | Description                                                                                             |
+| :------- | :----- | :------------------------------------------------------------------------------------------------------ |
 | `--appUrl` | string | The URL of your self-hosted Discuss Kit instance. If not provided, the command runs interactively. |
 
 ### Usage Examples
@@ -256,14 +265,35 @@ aigne doc publish --appUrl https://your-discuss-kit-instance.com
 
 ## `aigne doc prefs`
 
-Displays the current configuration settings for the project. This is a read-only command that helps you verify the settings applied during the `init` or `generate` process.
+Manages user preferences and feedback-driven rules. Over time, DocSmith learns from your feedback and creates persistent preferences. This command allows you to view, toggle, or remove these learned rules.
 
-### Usage Example
+### Options
+
+| Option   | Type    | Description                                                                |
+| :------- | :------ | :------------------------------------------------------------------------- |
+| `--list`   | boolean | Lists all saved preferences.                                               |
+| `--remove` | boolean | Interactively prompts to select and remove one or more preferences.        |
+| `--toggle` | boolean | Interactively prompts to select and toggle the active state of preferences. |
+| `--id`     | array   | Specifies one or more preference IDs to remove or toggle directly.         |
+
+### Usage Examples
 
-**View current project configuration:**
+**List all saved preferences:**
 
 ```bash
-aigne doc prefs
+aigne doc prefs --list
+```
+
+**Start interactive removal mode:**
+
+```bash
+aigne doc prefs --remove
+```
+
+**Toggle a specific preference by ID:**
+
+```bash
+aigne doc prefs --toggle --id "pref_2a1dfe2b09695aab"
 ```
 
 ---
@@ -278,4 +308,4 @@ Launches an interactive session to clear locally stored data. This can be used t
 
 ```bash
 aigne doc clear
-```
+```