@aigne/doc-smith 0.8.12-beta.3 → 0.8.12-beta.5

package/docs/guides-interactive-chat.md

@@ -0,0 +1,85 @@
+# Interactive Chat
+
+The interactive chat assistant provides a conversational interface for generating, modifying, and managing your documentation. Instead of running individual commands, you can describe what you need to do, and the assistant will guide you through the process, calling on the appropriate tools to complete the task.
+
+This approach simplifies the documentation workflow by handling the underlying commands for you. It is the recommended method for most interactions with the tool.
+
+## Starting the Chat Assistant
+
+To begin an interactive session, run the `chat` command from your terminal:
+
+```bash
+aigndoc chat
+```
+
+This will launch the assistant, and you can begin typing your requests.
+
+## Core Capabilities
+
+The chat assistant is designed to handle the entire documentation lifecycle. Its primary functions include:
+
+<x-cards data-columns="2">
+  <x-card data-title="Generate Documentation" data-icon="lucide:file-plus-2">
+    Create a complete documentation structure and initial content by analyzing your project's source files.
+  </x-card>
+  <x-card data-title="Refine and Update" data-icon="lucide:edit">
+    Regenerate specific sections or entire documents based on your feedback or changes in the source code.
+  </x-card>
+  <x-card data-title="Translate Content" data-icon="lucide:languages">
+    Translate existing documentation into multiple languages to reach a broader audience.
+  </x-card>
+  <x-card data-title="Publish and Manage" data-icon="lucide:upload-cloud">
+    Assist with publishing your documentation and managing team-based workflows.
+  </x-card>
+</x-cards>
+
+## Available Commands
+
+Within the chat, you can state your goal in plain language (e.g., "update the getting started guide") or invoke specific commands. The assistant understands the following core commands, which correspond to its specialized skills:
+
+| Command | Description |
+| :--- | :--- |
+| `generate` | Starts the process of creating a new documentation structure from source files. |
+| `update` | Modifies existing documents based on code changes or user feedback. |
+| `translate` | Translates documents into one or more supported languages. |
+| `publish` | Publishes your documentation to make it accessible online. |
+| `init` | Guides you through creating an initial configuration file for the project. |
+| `clear` | Removes generated files, configurations, and cached data. |
+| `prefs` | Manages your saved preferences for document generation. |
+| `evaluate` | Assesses the quality and completeness of your generated documentation. |
+| `history` | Shows the history of updates made to your documentation. |
+| `exit` | Ends the interactive chat session. |
+
+## Example Interaction
+
+Here is a sample conversation to illustrate how the interactive assistant works.
+
+```text
+You:
+> Hello, I need to create documentation for a new project.
+
+AI Assistant:
+Of course. To get started, I need to analyze your project structure. Could you please provide the path to your source code directory?
+
+You:
+> ./src
+
+AI Assistant:
+Thank you. I will now analyze the files in ./src to propose a documentation structure. This may take a few moments...
+...
+I have analyzed your project and created a proposed structure. Would you like to review it before I proceed with generating the content? (yes/no)
+
+You:
+> yes
+
+AI Assistant:
+(Displays the proposed documentation structure for review)
+...
+Please review the structure above. You can ask me to add, remove, or modify any part of it.
+```
+
+## Summary
+
+The interactive chat assistant is a powerful tool for managing your documentation in a guided, conversational manner. It streamlines complex tasks by handling the necessary steps and commands for you.
+
+For a more detailed walkthrough of a specific workflow, see the [Generating Documentation](./guides-generating-documentation.md) guide.

package/docs/guides-interactive-chat.zh-TW.md

@@ -0,0 +1,85 @@
+# 互動式聊天
+
+互動式聊天助理提供了一個對話式介面，用於產生、修改和管理您的文件。您無需執行單獨的指令，只需描述您需要做什麼，助理便會引導您完成整個流程，並呼叫適當的工具來完成任務。
+
+這種方法透過為您處理底層指令，簡化了文件工作流程。這是與此工具進行大多數互動時的建議方法。
+
+## 啟動聊天助理
+
+若要開始互動式對話，請在您的終端機中執行 `chat` 指令：
+
+```bash
+aigndoc chat
+```
+
+這將會啟動助理，您就可以開始輸入您的請求。
+
+## 核心功能
+
+聊天助理的設計旨在處理整個文件生命週期。其主要功能包括：
+
+<x-cards data-columns="2">
+  <x-card data-title="產生文件" data-icon="lucide:file-plus-2">
+    透過分析您專案的原始檔案，建立完整的文件結構和初始內容。
+  </x-card>
+  <x-card data-title="優化與更新" data-icon="lucide:edit">
+    根據您的回饋或原始碼的變更，重新產生特定章節或整份文件。
+  </x-card>
+  <x-card data-title="翻譯內容" data-icon="lucide:languages">
+    將現有文件翻譯成多種語言，以觸及更廣泛的受眾。
+  </x-card>
+  <x-card data-title="發布與管理" data-icon="lucide:upload-cloud">
+    協助發布您的文件並管理團隊協作流程。
+  </x-card>
+</x-cards>
+
+## 可用指令
+
+在聊天中，您可以用自然語言陳述您的目標（例如，「更新入門指南」），或呼叫特定指令。助理能理解以下核心指令，這些指令對應其專業技能：
+
+| Command | Description |
+| :--- | :--- |
+| `generate` | 從原始檔案開始建立新文件結構的流程。 |
+| `update` | 根據程式碼變更或使用者回饋修改現有文件。 |
+| `translate` | 將文件翻譯成一種或多種支援的語言。 |
+| `publish` | 發布您的文件，使其可在線上存取。 |
+| `init` | 引導您為專案建立初始設定檔。 |
+| `clear` | 移除產生的檔案、設定和快取資料。 |
+| `prefs` | 管理您儲存的文件產生偏好設定。 |
+| `evaluate` | 評估您產生的文件的品質和完整性。 |
+| `history` | 顯示您文件的更新歷史記錄。 |
+| `exit` | 結束互動式聊天對話。 |
+
+## 互動範例
+
+以下是一段範例對話，用來說明互動式助理如何運作。
+
+```text
+您：
+> 你好，我需要為一個新專案建立文件。
+
+AI 助理：
+當然。在開始之前，我需要分析您的專案結構。可以請您提供原始碼目錄的路徑嗎？
+
+您：
+> ./src
+
+AI 助理：
+謝謝您。我現在將分析 ./src 中的檔案，以提出一個文件結構建議。這可能需要一些時間...
+...
+我已經分析了您的專案並建立了一個建議的結構。在繼續產生內容之前，您想先檢視它嗎？ (yes/no)
+
+您：
+> yes
+
+AI 助理：
+(顯示建議的文件結構供檢視)
+...
+請檢視上方的結構。您可以要求我新增、移除或修改其中的任何部分。
+```
+
+## 總結
+
+互動式聊天助理是一個強大的工具，能以引導式、對話式的方式管理您的文件。它透過為您處理必要的步驟和指令，簡化了複雜的任務。
+
+若需特定工作流程的更詳細演練，請參閱 [產生文件](./guides-generating-documentation.md) 指南。

package/docs/guides-interactive-chat.zh.md

@@ -0,0 +1,85 @@
+# 交互式聊天
+
+交互式聊天助手提供了一个对话式界面，用于生成、修改和管理您的文档。您无需运行单个命令，只需描述您需要做什么，助手就会引导您完成整个过程，并调用适当的工具来完成任务。
+
+这种方法通过为您处理底层命令来简化文档工作流。对于与该工具的大多数交互，这是推荐的方法。
+
+## 启动聊天助手
+
+要开始交互式会话，请在您的终端中运行 `chat` 命令：
+
+```bash
+aigndoc chat
+```
+
+这将启动助手，您可以开始输入您的请求。
+
+## 核心功能
+
+聊天助手旨在处理整个文档生命周期。其主要功能包括：
+
+<x-cards data-columns="2">
+  <x-card data-title="生成文档" data-icon="lucide:file-plus-2">
+    通过分析您项目的源文件，创建完整的文档结构和初始内容。
+  </x-card>
+  <x-card data-title="优化和更新" data-icon="lucide:edit">
+    根据您的反馈或源代码中的更改，重新生成特定部分或整个文档。
+  </x-card>
+  <x-card data-title="翻译内容" data-icon="lucide:languages">
+    将现有文档翻译成多种语言，以覆盖更广泛的受众。
+  </x-card>
+  <x-card data-title="发布和管理" data-icon="lucide:upload-cloud">
+    协助发布您的文档并管理基于团队的工作流。
+  </x-card>
+</x-cards>
+
+## 可用命令
+
+在聊天中，您可以用自然语言陈述您的目标（例如，“更新入门指南”），或调用特定命令。助手能理解以下核心命令，这些命令与其专业技能相对应：
+
+| Command | Description |
+| :--- | :--- |
+| `generate` | 从源文件开始创建新文档结构的过程。 |
+| `update` | 根据代码更改或用户反馈修改现有文档。 |
+| `translate` | 将文档翻译成一种或多种支持的语言。 |
+| `publish` | 发布您的文档，使其可以在线访问。 |
+| `init` | 指导您为项目创建初始配置文件。 |
+| `clear` | 删除生成的文件、配置和缓存数据。 |
+| `prefs` | 管理您保存的文档生成偏好设置。 |
+| `evaluate` | 评估您生成的文档的质量和完整性。 |
+| `history` | 显示您文档的更新历史。 |
+| `exit` | 结束交互式聊天会话。 |
+
+## 交互示例
+
+以下是一个示例对话，用以说明交互式助手的工作方式。
+
+```text
+You:
+> 你好，我需要为一个新项目创建文档。
+
+AI Assistant:
+当然。首先，我需要分析您的项目结构。您能提供源代码目录的路径吗？
+
+You:
+> ./src
+
+AI Assistant:
+谢谢。我现在将分析 ./src 中的文件，以提出一个文档结构。这可能需要一些时间...
+...
+我已经分析了您的项目并创建了一个建议的结构。在继续生成内容之前，您想先预览一下吗？ (yes/no)
+
+You:
+> yes
+
+AI Assistant:
+(显示建议的文档结构以供预览)
+...
+请预览上面的结构。您可以要求我添加、删除或修改其中的任何部分。
+```
+
+## 总结
+
+交互式聊天助手是一个强大的工具，能以引导式的对话方式管理您的文档。它通过为您处理必要的步骤和命令来简化复杂任务。
+
+关于特定工作流的更详细演练，请参阅 [生成文档](./guides-generating-documentation.md) 指南。

package/docs/guides-managing-history.ja.md

@@ -0,0 +1,51 @@
+# 履歴の管理
+
+AIGNE DocSmithは、ドキュメントに加えられたすべての更新の時系列ログを保持します。この機能により、変更を追跡し、更新時に提供されたフィードバックを確認し、時間とともにドキュメントがどのように進化してきたかを理解できます。このガイドでは、この履歴にアクセスして解釈する方法について説明します。
+
+## 更新履歴の表示
+
+すべてのドキュメント更新のログを表示するには、`history view` コマンドを使用します。このコマンドは、バージョン管理ログのように、各エントリの簡潔な1行の概要を表示します。
+
+ターミナルで次のコマンドを実行してください。
+
+```bash 履歴の表示 icon=material-symbols:history
+aigne history view
+```
+
+`history` コマンドは、`view` サブコマンドの2つのエイリアス、`log` と `list` もサポートしています。以下のコマンドは同等であり、同じ出力を生成します。
+
+```bash
+aigne history log
+```
+
+```bash
+aigne history list
+```
+
+### 履歴出力の理解
+
+`history view` コマンドの出力は、各更新に関する主要な情報を一目でわかるようにフォーマットされています。各行は単一の更新エントリを表します。
+
+以下にそのフォーマットの内訳を示します。
+
+| コンポーネント | 説明 |
+| :--- | :--- |
+| **短いハッシュ** | 更新のタイムスタンプから生成される7文字の一意の識別子。 |
+| **日付** | 更新が発生した時期を示す相対的なタイムスタンプ（例：「5分前」、「2日前」）。古いエントリについては、特定の日付が表示されます。 |
+| **操作** | 実行されたアクションの種類。例：`generate-document` や `update-document-detail`。 |
+| **ドキュメントパス** | 操作が単一のファイルを対象とした場合に、変更された特定のドキュメントのパス。これは括弧で囲まれています。 |
+| **フィードバック** | 更新が行われたときに提供されたフィードバックまたは概要メッセージ。 |
+
+### 例
+
+以下は、`aigne history view` コマンドを実行した際のサンプル出力です。
+
+```bash
+📜 更新履歴
+
+e5a4f8b 2 hours ago update-document-detail (/guides/generating-documentation): Added a new section on advanced configuration options.
+a3b1c9d 1 day ago  update-document-detail (/overview): Refined the introduction to be more concise.
+f8d2e0c 3 days ago generate-document (/guides/managing-history): Initial generation of the history management guide.
+```
+
+このログは、ドキュメントの変更履歴を明確かつ整然と記録するもので、進捗の追跡や過去の変更の確認に役立ちます。

package/docs/guides-managing-history.md

@@ -0,0 +1,51 @@
+# Managing History
+
+AIGNE DocSmith maintains a chronological log of all updates made to your documentation. This feature allows you to track changes, review feedback provided during updates, and understand the evolution of your documents over time. This guide provides instructions on how to access and interpret this history.
+
+## Viewing Update History
+
+To view the log of all documentation updates, you can use the `history view` command. This command displays a compact, one-line summary for each entry, similar to a version control log.
+
+Execute the following command in your terminal:
+
+```bash Viewing History icon=material-symbols:history
+aigne history view
+```
+
+The `history` command also supports two aliases for the `view` subcommand: `log` and `list`. The following commands are equivalent and will produce the same output:
+
+```bash
+aigne history log
+```
+
+```bash
+aigne history list
+```
+
+### Understanding the History Output
+
+The output of the `history view` command is formatted to provide key information about each update at a glance. Each line represents a single update entry.
+
+Here is a breakdown of the format:
+
+| Component | Description |
+| :--- | :--- |
+| **Short Hash** | A 7-character unique identifier generated from the timestamp of the update. |
+| **Date** | A relative timestamp indicating when the update occurred (e.g., "5 minutes ago", "2 days ago"). For older entries, a specific date is shown. |
+| **Operation** | The type of action performed, such as `generate-document` or `update-document-detail`. |
+| **Document Path** | The path of the specific document that was modified, if the operation targeted a single file. This is enclosed in parentheses. |
+| **Feedback** | The feedback or summary message that was provided when the update was made. |
+
+### Example
+
+Below is a sample output from running the `aigne history view` command.
+
+```bash
+📜 Update History
+
+e5a4f8b 2 hours ago update-document-detail (/guides/generating-documentation): Added a new section on advanced configuration options.
+a3b1c9d 1 day ago  update-document-detail (/overview): Refined the introduction to be more concise.
+f8d2e0c 3 days ago generate-document (/guides/managing-history): Initial generation of the history management guide.
+```
+
+This log provides a clear and orderly record of your documentation's modification history, which is useful for tracking progress and reviewing past changes.

package/docs/guides-managing-history.zh-TW.md

@@ -0,0 +1,51 @@
+# 管理歷史記錄
+
+AIGNE DocSmith 會按時間順序記錄您對文件所做的所有更新。此功能可讓您追蹤變更、檢視更新期間提供的回饋，並了解文件隨時間的演變。本指南將說明如何存取和解讀此歷史記錄。
+
+## 檢視更新歷史記錄
+
+若要檢視所有文件更新的日誌，您可以使用 `history view` 指令。此指令會為每個條目顯示一個精簡的單行摘要，類似於版本控制日誌。
+
+在您的終端機中執行以下指令：
+
+```bash 檢視歷史記錄 icon=material-symbols:history
+aigne history view
+```
+
+`history` 指令也支援 `view` 子指令的兩個別名：`log` 和 `list`。以下指令是等效的，並會產生相同的輸出：
+
+```bash
+aigne history log
+```
+
+```bash
+aigne history list
+```
+
+### 了解歷史記錄輸出
+
+`history view` 指令的輸出格式旨在讓您能一目了然地獲取每次更新的關鍵資訊。每一行代表一個單獨的更新條目。
+
+以下是格式的詳細說明：
+
+| 元件 | 說明 |
+| :--- | :--- |
+| **短雜湊值** | 從更新時間戳記產生的 7 個字元唯一識別碼。 |
+| **日期** | 一個相對時間戳記，表示更新發生的時間（例如，「5 minutes ago」、「2 days ago」）。對於較舊的條目，則會顯示具體日期。 |
+| **操作** | 執行的操作類型，例如 `generate-document` 或 `update-document-detail`。 |
+| **文件路徑** | 如果操作針對單一檔案，則為被修改的特定文件路徑。此路徑會用括號括起來。 |
+| **回饋** | 進行更新時所提供的回饋或摘要訊息。 |
+
+### 範例
+
+以下是執行 `aigne history view` 指令的範例輸出。
+
+```bash
+📜 Update History
+
+e5a4f8b 2 hours ago update-document-detail (/guides/generating-documentation): Added a new section on advanced configuration options.
+a3b1c9d 1 day ago  update-document-detail (/overview): Refined the introduction to be more concise.
+f8d2e0c 3 days ago generate-document (/guides/managing-history): Initial generation of the history management guide.
+```
+
+此日誌提供了您文件修改歷史的清晰有序記錄，對於追蹤進度和檢視過去的變更非常有用。

package/docs/guides-managing-history.zh.md

@@ -0,0 +1,51 @@
+# 管理历史记录
+
+AIGNE DocSmith 会按时间顺序记录对您文档所做的所有更新。此功能让您可以跟踪变更，审查更新期间提供的反馈，并了解文档随时间的演变过程。本指南将说明如何访问和解读此历史记录。
+
+## 查看更新历史记录
+
+要查看所有文档更新的日志，您可以使用 `history view` 命令。该命令会为每个条目显示一个紧凑的单行摘要，类似于版本控制日志。
+
+在您的终端中执行以下命令：
+
+```bash 查看历史记录 icon=material-symbols:history
+aigne history view
+```
+
+`history` 命令还支持 `view` 子命令的两个别名：`log` 和 `list`。以下命令是等效的，将产生相同的输出：
+
+```bash
+aigne history log
+```
+
+```bash
+aigne history list
+```
+
+### 理解历史记录输出
+
+`history view` 命令的输出格式旨在让您能一目了然地获取每次更新的关键信息。每一行代表一个单独的更新条目。
+
+以下是格式的详细说明：
+
+| 组件 | 描述 |
+| :--- | :--- |
+| **短哈希** | 一个根据更新时间戳生成的 7 个字符的唯一标识符。 |
+| **日期** | 一个相对时间戳，指示更新发生的时间（例如，“5 minutes ago”、“2 days ago”）。对于较旧的条目，会显示具体日期。 |
+| **操作** | 执行的操作类型，例如 `generate-document` 或 `update-document-detail`。 |
+| **文档路径** | 被修改的具体文档的路径，如果操作针对单个文件。该路径包含在括号中。 |
+| **反馈** | 进行更新时提供的反馈或摘要信息。 |
+
+### 示例
+
+以下是运行 `aigne history view` 命令的示例输出。
+
+```bash
+📜 更新历史记录
+
+e5a4f8b 2 小时前 update-document-detail (/guides/generating-documentation): 添加了关于高级配置选项的新章节。
+a3b1c9d 1 天前  update-document-detail (/overview): 优化了引言，使其更加简洁。
+f8d2e0c 3 天前 generate-document (/guides/managing-history): 初次生成历史记录管理指南。
+```
+
+此日志为您的文档修改历史提供了清晰有序的记录，有助于跟踪进度和回顾过去的变更。

package/docs/guides-publishing-your-docs.ja.md

@@ -0,0 +1,78 @@
+# ドキュメントの公開
+
+ドキュメントを生成したら、次のステップはそれをオンラインで公開し、読者がアクセスできるようにすることです。このガイドでは、`aigne doc publish` コマンドを使用した公開プロセスの体系的な概要を説明します。
+
+## 公開コマンド
+
+ドキュメントを公開するための主要なコマンドは `aigne doc publish` です。このコマンドは、生成されたファイルをウェブサービスにアップロードし、ブラウザで表示できるようにします。
+
+このコマンドは、フルネームまたは短いエイリアスで実行できます：
+
+```bash
+# フルコマンド
+aigne doc publish
+
+# エイリアス
+aigne doc pub
+aigne doc p
+```
+
+publish コマンドを初めて実行すると、希望する公開プラットフォームを選択するための対話型プロンプトが表示されます。
+
+## 公開オプション
+
+ドキュメントをホストする場所にはいくつかのオプションがあります。対話型プロンプトが選択をガイドします。
+
+### 1. DocSmith Cloud（無料ホスティング）
+
+このオプションは、AIGNE が提供する無料のホスティングサービスである `docsmith.aigne.io` にドキュメントを公開します。
+
+-   **ユースケース：** オープンソースプロジェクト、個人ブログなど、カスタムインフラを必要とせず公開アクセスが必要なあらゆるシナリオに最適です。
+-   **コスト：** 無料。
+-   **結果：** 公開が成功すると、提供された URL でドキュメントが公開されます。
+
+### 2. 既存のウェブサイト
+
+このオプションを使用すると、すでに所有および管理しているウェブサイトにドキュメントを公開できます。
+
+-   **ユースケース：** 既存の会社のウェブサイト、製品サイト、または個人ドメインにドキュメントを直接統合する場合に最適です。この方法では、Discuss Kit の独自のインスタンスを実行する必要があります。
+-   **コスト：** 独自のホスティングインフラが必要です。
+-   **セットアップ：**
+    1.  プロンプトでこのオプションを選択します。
+    2.  ウェブサイトの URL を入力するよう求められます（例：`https://docs.your-company.com`）。
+    3.  独自のドキュメントウェブサイトをセットアップするには、公式ストアから Discuss Kit インスタンスを入手できます：[https://www.web3kit.rocks/discuss-kit](https://www.web3kit.rocks/discuss-kit)。
+
+### 3. 新規ウェブサイト（有料サービス）
+
+既存のウェブサイトがない場合、このサービスはドキュメント専用の新しいサイトをセットアップするのに役立ちます。
+
+-   **ユースケース：** カスタムドメインと管理されたホスティングを備えた、プロフェッショナルでスタンドアロンのドキュメントポータルを作成するのに適しています。
+-   **コスト：** これは有料サービスです。
+-   **プロセス：** コマンドは、新しい Discuss Kit インスタンスのデプロイと設定に必要な手順をガイドします。このプロセスを以前に開始したことがある場合は、以前のセットアップを再開するオプションも表示されます。
+
+## 直接公開
+
+CI/CD パイプラインなどの自動化されたワークフローの場合、または初期設定が完了した後は、アプリケーションの URL を直接指定することで対話型プロンプトをバイパスできます。
+
+`--appUrl` フラグに続けてウェブサイトの URL を指定します。
+
+```bash
+# カスタムドキュメントサイトの例
+aigne doc publish --appUrl https://docs.your-company.com
+```
+
+特定の URL への公開に成功すると（プロンプトでオプションを選択するか、`--appUrl` フラグを使用するかのいずれか）、DocSmith はこの URL をローカル設定に保存します。次回以降の実行時には、再度尋ねることなく、保存された URL に自動的に公開します。
+
+## トラブルシューティング
+
+### 認証エラー
+
+「401」または「403」を含むエラーメッセージが表示された場合、認証トークンが無効であるか、期限切れであることを示します。これは、権限が変更された場合や、トークンが古い場合に発生する可能性があります。
+
+これを解決するには、`clear` コマンドを実行して、保存されているすべての設定と認証情報をクリアします：
+
+```bash
+aigne doc clear
+```
+
+設定をクリアした後、再度 `aigne doc publish` を実行してください。初めて実行したときのように、認証とセットアップのプロセスがガイドされます。

package/docs/guides-publishing-your-docs.md

@@ -0,0 +1,78 @@
+# Publishing Your Docs
+
+Once you have generated your documentation, the next step is to publish it online, making it accessible to your audience. This guide provides a systematic overview of the publishing process using the `aigne doc publish` command.
+
+## The Publish Command
+
+The primary command for making your documentation live is `aigne doc publish`. This command uploads your generated files to a web service, where they can be viewed in a browser.
+
+You can execute the command using its full name or its shorter aliases:
+
+```bash
+# Full command
+aigne doc publish
+
+# Aliases
+aigne doc pub
+aigne doc p
+```
+
+When you run the publish command for the first time, you will be presented with an interactive prompt to select your preferred publishing platform.
+
+## Publishing Options
+
+You have several options for where to host your documentation. The interactive prompt will guide you through the selection.
+
+### 1. DocSmith Cloud (Free Hosting)
+
+This option publishes your documentation to `docsmith.aigne.io`, a free hosting service provided by AIGNE.
+
+-   **Use Case:** Ideal for open-source projects, personal blogs, or any scenario where public accessibility is desired without the need for custom infrastructure.
+-   **Cost:** Free.
+-   **Outcome:** Your documents will be publicly available at a URL provided upon successful publication.
+
+### 2. Your Existing Website
+
+This option allows you to publish the documentation to a website that you already own and manage.
+
+-   **Use Case:** Best for integrating documentation directly into an existing company website, product site, or personal domain. This method requires you to run your own instance of Discuss Kit.
+-   **Cost:** Requires your own hosting infrastructure.
+-   **Setup:**
+    1.  Select this option in the prompt.
+    2.  You will be asked to enter the URL of your website (e.g., `https://docs.your-company.com`).
+    3.  To set up your own documentation website, you can get a Discuss Kit instance from the official store: [https://www.web3kit.rocks/discuss-kit](https://www.web3kit.rocks/discuss-kit).
+
+### 3. New Website (Paid Service)
+
+If you do not have an existing website, this service helps you set up a new, dedicated site for your documentation.
+
+-   **Use Case:** Suitable for creating a professional, standalone documentation portal with a custom domain and hosting managed for you.
+-   **Cost:** This is a paid service.
+-   **Process:** The command will guide you through the necessary steps to deploy and configure a new Discuss Kit instance. If you have started this process before, you will also see an option to resume your previous setup.
+
+## Direct Publishing
+
+For automated workflows, such as CI/CD pipelines, or after you have completed the initial setup, you can bypass the interactive prompt by specifying the application URL directly.
+
+Use the `--appUrl` flag followed by your website's URL.
+
+```bash
+# Example for a custom documentation site
+aigne doc publish --appUrl https://docs.your-company.com
+```
+
+Once you successfully publish to a specific URL (either by selecting an option in the prompt or by using the `--appUrl` flag), DocSmith saves this URL in your local configuration. On subsequent runs, it will automatically publish to the saved URL without asking again.
+
+## Troubleshooting
+
+### Authorization Errors
+
+If you encounter an error message containing "401" or "403," it indicates that your authentication token is invalid or has expired. This can happen if permissions have changed or if the token is old.
+
+To resolve this, you can clear all stored configuration and credentials by running the `clear` command:
+
+```bash
+aigne doc clear
+```
+
+After clearing the configuration, run `aigne doc publish` again. You will be guided through the authentication and setup process as if it were the first time.