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

package/docs/getting-started.zh.md

@@ -1,121 +1,118 @@
 # 快速入门
 
-本指南将引导您逐步安装 AIGNE DocSmith、配置项目，并从您的源代码生成一套完整的文档。
+本指南将引导您逐步完成 AIGNE DocSmith 的安装、项目配置，并在几分钟内从源代码生成一套完整的文档。
 
 ## 第 1 步：先决条件
 
-在开始之前，请确保您的系统上已安装 Node.js 及其包管理器 npm。DocSmith 是一个在 Node.js 环境下运行的命令行工具。
+在开始之前，请确保您的系统上已安装 Node.js 20 或更高版本。DocSmith 是一个在 Node.js 环境中运行的命令行工具。我们建议使用 Node.js 自带的 Node Package Manager (npm) 进行安装。
 
-### 安装 Node.js
-
-以下是在各种操作系统上安装 Node.js 的简要说明。
+有关详细的安装说明，请参阅 [Node.js 官方网站](https://nodejs.org/)。下面提供了针对常见操作系统的简要指南。
 
 **Windows**
-1.  从 [Node.js 官方网站](https://nodejs.org/) 下载安装程序。
-2.  运行 `.msi` 安装程序，并按照安装向导中的步骤操作。
+1.  从 [Node.js 下载页面](https://nodejs.org/en/download) 下载 Windows 安装程序（`.msi`）。
+2.  运行安装程序，并按照设置向导中的提示进行操作。
 
 **macOS**
 
-推荐的方法是使用 [Homebrew](https://brew.sh/)：
+推荐的安装方法是使用 macOS 的包管理器 [Homebrew](https://brew.sh/)。
 
-```bash 终端 icon=lucide:apple
-# 如果您还没有安装 Homebrew，请先安装
+```bash Terminal icon=lucide:apple
+# 如果尚未安装 Homebrew，请先安装
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
 # 安装 Node.js
 brew install node
 ```
 
-或者，您也可以从 [Node.js 网站](https://nodejs.org/) 下载 `.pkg` 安装程序。
+或者，您也可以直接从 [Node.js 网站](https://nodejs.org/) 下载 macOS 安装程序（`.pkg`）。
 
 **Linux**
 
-对于基于 Ubuntu/Debian 的系统：
+对于基于 Debian 和 Ubuntu 的发行版，请使用以下命令：
 
-```bash 终端 icon=lucide:laptop
-sudo apt update
+```bash Terminal icon=lucide:laptop
+sudo apt-get update
+sudo apt-get install -y ca-certificates curl gnupg
 curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
 sudo apt-get install -y nodejs
 ```
 
-对于基于 CentOS/RHEL/Fedora 的系统：
+对于 Red Hat、CentOS 和 Fedora，请使用以下命令：
 
-```bash 终端 icon=lucide:laptop
+```bash Terminal icon=lucide:laptop
 curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
 sudo yum install nodejs
 ```
 
-### 验证
+### 验证安装
 
-安装完成后，在终端中运行以下命令，验证 Node.js 和 npm 是否可用：
+安装完成后，打开您的终端并运行以下命令，以确认 Node.js 和 npm 已正确安装：
 
-```bash 终端
+```bash Terminal
 node --version
 npm --version
 ```
 
 ## 第 2 步：安装 AIGNE CLI
 
-DocSmith 工具包含在 AIGNE 命令行界面 (CLI) 中。使用 npm 全局安装最新版本的 AIGNE CLI：
+DocSmith 工具作为官方 AIGNE 命令行界面（CLI）的一部分进行分发。使用 npm 在您的系统上全局安装 CLI：
 
-```bash 终端 icon=logos:npm
-npm i -g @aigne/cli
+```bash Terminal icon=logos:npm
+npm install -g @aigne/cli
 ```
 
-安装完成后，运行文档工具的帮助命令进行验证：
+安装完成后，运行其帮助命令来验证 DocSmith 是否可用：
 
-```bash 终端
-aigne doc -h
+```bash Terminal
+aigne doc --help
 ```
 
-该命令将显示 DocSmith 的帮助菜单，确认其已准备就绪。
+此命令应显示 DocSmith 的帮助菜单，确认其已安装并准备就绪。
 
-## 第 3 步：生成文档
+## 第 3 步：生成您的文档
 
-安装 CLI 后，您只需一个命令即可生成文档。在终端中导航到您项目的根目录并运行：
+安装 AIGNE CLI 后，您现在可以生成文档了。在您的终端中，导航到项目的根目录并执行以下命令：
 
-```bash 终端 icon=lucide:sparkles
+```bash Terminal icon=lucide:sparkles
 aigne doc generate
 ```
 
-### 自动配置
+![运行 generate 命令会启动该过程并触发智能设置向导。](../assets/screenshots/doc-generate.png)
 
-当您在项目中首次运行此命令时，DocSmith 会检测到尚无配置，并自动启动一个交互式设置向导。
+### 自动配置
 
-![运行 generate 命令会启动设置向导](https://docsmith.aigne.io/image-bin/uploads/0c45a32667c5250e54194a61d9495965.png)
+当您第一次在新项目中运行此命令时，DocSmith 会检测到不存在配置文件，并会自动启动一个交互式设置向导来引导您完成整个过程。
 
-系统将提示您一系列问题，以定义文档的特性，包括：
+该向导将提出一系列问题来定义您文档的特性，包括：
 
-- 主要目的和风格。
-- 目标受众。
-- 主要语言及其他需要翻译的语言。
-- 供 AI 分析的源代码路径。
-- 生成文档的输出目录。
+*   主要目的和写作风格。
+*   预期的目标受众（例如，开发者、最终用户）。
+*   主要语言以及用于翻译的其他语言。
+*   供 AI 分析的源代码路径。
+*   生成文档文件的输出目录。
 
-![回答提示以完成项目设置](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
+![回答一系列问题以完成项目设置。](../assets/screenshots/doc-complete-setup.png)
 
-配置完成后，DocSmith 将开始分析您的源代码，规划文档结构，并生成内容。
+在您回答完提示后，DocSmith 会将您的选择保存到配置文件中，开始分析您的代码库，规划文档结构，并生成内容。
 
-![DocSmith 正在规划结构并生成文档](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
+![DocSmith 将规划文档结构并开始生成文件。](../assets/screenshots/doc-generate-docs.png)
 
 ## 第 4 步：查看您的输出
 
-生成过程结束后，您的终端将显示一条确认消息。
-
-![文档生成成功消息](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
+生成过程完成后，您的终端中将显示一条确认消息，表明您的文档已成功创建。您的新文档现在位于您在设置过程中指定的输出目录中。如果您使用了默认设置，可以在 `.aigne/doc-smith/docs` 中找到它。
 
-您的新文档现已位于您在设置过程中指定的输出目录中。默认位置是 `.aigne/doc-smith/docs`。
+![一条确认消息表示文档已成功生成。](../assets/screenshots/doc-generated-successfully.png)
 
 ## 接下来做什么？
 
-既然您已经生成了第一套文档，您可以探索其他功能：
+您已成功生成了第一套文档。现在，您可以开始探索更高级的功能和自定义选项。
 
 <x-cards>
   <x-card data-title="核心功能" data-icon="lucide:box" data-href="/features">
-    探索从更新文档到在线发布的主要命令和功能。
+    探索主要命令和功能，从更新文档到在线发布。
   </x-card>
   <x-card data-title="配置指南" data-icon="lucide:settings" data-href="/configuration">
-    了解如何通过编辑 config.yaml 文件来微调文档的风格、受众和语言。
+    了解如何通过编辑配置文件来微调文档的风格、受众和语言。
   </x-card>
   <x-card data-title="CLI 命令参考" data-icon="lucide:terminal" data-href="/cli-reference">
     获取所有可用的 `aigne doc` 命令及其选项的完整参考。

package/docs/overview.ja.md

@@ -2,29 +2,81 @@
 
 AIGNE DocSmithは、ソースコードから直接ドキュメントを生成するAI駆動のツールです。[AIGNE Framework](https://www.aigne.io/en/framework)上に構築されており、構造化された多言語ドキュメントの作成を自動化します。このプロセスにより、ドキュメントの作成と保守にかかる手作業が削減され、コードベースとの同期が確保されます。
 
-## AIGNEエコシステムの一部
+以下の図は、DocSmithのハイレベルなワークフローを示しています。
+
+```d2
+direction: right
+style: {
+  font-size: 14
+}
+
+# Actors
+source_code: "ソースコードリポジトリ" {
+  shape: cloud
+  style: {
+    fill: "#F0F4F8"
+    stroke: "#4A5568"
+  }
+}
+
+docsmith: "AIGNE DocSmithエンジン" {
+  shape: hexagon
+  style: {
+    fill: "#E6FFFA"
+    stroke: "#2C7A7B"
+  }
+}
+
+published_docs: "公開されたドキュメント" {
+  shape: document
+  style: {
+    fill: "#FEFCBF"
+    stroke: "#B7791F"
+  }
+}
 
-DocSmithは、AIアプリケーション開発プラットフォームである[AIGNE](https://www.aigne.io)エコシステムの主要なコンポーネントです。他のAIGNEコンポーネントと統合し、プラットフォームのAI機能とインフラストラクチャを利用します。
+# Main Flow
+source_code -> docsmith: "1. コードを分析"
+docsmith -> published_docs: "2. 生成と公開"
 
-以下の図は、DocSmithがAIGNEアーキテクチャ内でどのように位置づけられるかを示しています。
+# DocSmith Internal Process
+subflow: {
+  direction: down
+  
+  analyze: "構造の分析と計画"
+  generate: "コンテンツの生成"
+  translate: "翻訳（オプション）"
+  publish: "公開"
+  
+  analyze -> generate -> translate -> publish
+}
 
-![AIGNEエコシステムアーキテクチャ](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+docsmith.subflow: subflow
+```
 
 ## 主な機能
 
 DocSmithは、ドキュメント作成プロセスを自動化し、簡素化するための一連の機能を提供します。
 
-*   **構造計画：** コードベースを分析して、論理的なドキュメント構造を生成します。
-*   **コンテンツ生成：** 計画されたドキュメント構造に、ソースコードから生成されたコンテンツを埋め込みます。
-*   **多言語サポート：** 英語、中国語、日本語、スペイン語を含む12言語にドキュメントを翻訳します。
-*   **AIGNE Hubとの統合：** [AIGNE Hub](https://www.aigne.io/en/hub)をLLMプロバイダーとして使用し、個別のAPIキーを管理することなくモデルを切り替えることができます。
-*   **ドキュメント公開：** 公式プラットフォーム[docsmith.aigne.io](https://docsmith.aigne.io/app/)またはユーザー自身の[Discuss Kit](https://www.arcblock.io/docs/web3-kit/en/discuss-kit)インスタンスにドキュメントを公開します。
-*   **反復更新：** ソースコードの変更を検出してドキュメントを更新し、ユーザーのフィードバックに基づいて特定のドキュメントのターゲットを絞った再生成をサポートします。
+*   **構造計画:** コードベースを分析して、論理的なドキュメント構造を生成します。
+*   **コンテンツ生成:** 計画されたドキュメント構造に、ソースコードから生成されたコンテンツを埋め込みます。
+*   **多言語サポート:** ドキュメントを英語、中国語、スペイン語を含む12言語に翻訳します。
+*   **AIGNE Hub統合:** Google、OpenAI、Anthropicなどのさまざまな大規模言語モデル（LLM）へのアクセスを提供するサービスである[AIGNE Hub](https://www.aigne.io/en/hub)を使用し、個別のAPIキーを管理することなくモデルを切り替えることができます。
+*   **ワンクリック公開:** 共有可能なリンクでドキュメントを公開します。公式プラットフォームに公開するか、[Discuss Kit](https://www.web3kit.rocks/discuss-kit)を使用して独自のインスタンスを実行できます。
+*   **反復的な更新:** ソースコードの変更を検知してドキュメントを更新し、ユーザーのフィードバックに基づいて特定のドキュメントのターゲット再生成をサポートします。
+
+## AIGNEエコシステムの一部
+
+DocSmithは、AIアプリケーション開発のためのプラットフォームである[AIGNE](https://www.aigne.io)エコシステムのコンポーネントです。他のAIGNEコンポーネントと統合し、プラットフォームのAI機能とインフラストラクチャを利用します。
+
+以下の図は、DocSmithがAIGNEアーキテクチャ内でどのように位置づけられているかを示しています。
+
+![AIGNEエコシステムのアーキテクチャ](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
 
 ## 次のステップ
 
 DocSmithの使用を開始するには、インストールおよび設定ガイドに進んでください。
 
 <x-card data-title="次へ：はじめに" data-href="/getting-started" data-icon="lucide:arrow-right-circle" data-cta="ガイドを開始">
-  ステップバイステップのガイドに従って、ツールをインストールし、最初のプロジェクトを設定して、ドキュメントを生成します。
+ステップバイステップのガイドに従って、ツールをインストールし、最初のプロジェクトを設定し、ドキュメントを生成します。
 </x-card>

package/docs/overview.md

@@ -2,13 +2,57 @@
 
 AIGNE DocSmith is an AI-driven tool that generates documentation directly from your source code. Built on the [AIGNE Framework](https://www.aigne.io/en/framework), it automates the creation of structured, multi-language documents. This process reduces the manual effort of writing and maintaining documentation, ensuring it stays synchronized with the codebase.
 
-## Part of the AIGNE Ecosystem
+The following diagram illustrates the high-level workflow of DocSmith:
 
-DocSmith is a key component of the [AIGNE](https://www.aigne.io) ecosystem, a platform for developing AI applications. It integrates with other AIGNE components to use the platform's AI capabilities and infrastructure.
+```d2
+direction: right
+style: {
+  font-size: 14
+}
 
-The following diagram illustrates how DocSmith fits within the AIGNE architecture:
+# Actors
+source_code: "Source Code Repository" {
+  shape: cloud
+  style: {
+    fill: "#F0F4F8"
+    stroke: "#4A5568"
+  }
+}
 
-![AIGNE Ecosystem Architecture](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+docsmith: "AIGNE DocSmith Engine" {
+  shape: hexagon
+  style: {
+    fill: "#E6FFFA"
+    stroke: "#2C7A7B"
+  }
+}
+
+published_docs: "Published Documentation" {
+  shape: document
+  style: {
+    fill: "#FEFCBF"
+    stroke: "#B7791F"
+  }
+}
+
+# Main Flow
+source_code -> docsmith: "1. Analyze Code"
+docsmith -> published_docs: "2. Generate & Publish"
+
+# DocSmith Internal Process
+subflow: {
+  direction: down
+  
+  analyze: "Analyze & Plan Structure"
+  generate: "Generate Content"
+  translate: "Translate (Optional)"
+  publish: "Publish"
+  
+  analyze -> generate -> translate -> publish
+}
+
+docsmith.subflow: subflow
+```
 
 ## Core Features
 
@@ -16,15 +60,23 @@ DocSmith provides a set of features to automate and simplify the documentation p
 
 *   **Structure Planning:** Analyzes a codebase to generate a logical documentation structure.
 *   **Content Generation:** Populates the planned documentation structure with content generated from the source code.
-*   **Multi-Language Support:** Translates documentation into 12 languages, including English, Chinese, Japanese, and Spanish.
-*   **AIGNE Hub Integration:** Uses [AIGNE Hub](https://www.aigne.io/en/hub) as an LLM provider, allowing model switching without managing individual API keys.
-*   **One-Click Publishing:** Makes your documentation live with shareable links for your team or users. Publish to the official platform at [docsmith.aigne.io](https://docsmith.aigne.io/app/) or to your own [Discuss Kit](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) instance.
+*   **Multi-Language Support:** Translates documentation into 12 languages, including English, Chinese, and Spanish.
+*   **AIGNE Hub Integration:** Uses [AIGNE Hub](https://www.aigne.io/en/hub), a service that provides access to various Large Language Models (LLMs) like those from Google, OpenAI, and Anthropic, allowing model switching without managing individual API keys.
+*   **One-Click Publishing:** Makes your documentation live with shareable links. You can publish to the official platform or run your own instance using [Discuss Kit](https://www.web3kit.rocks/discuss-kit).
 *   **Iterative Updates:** Detects source code changes to update documentation and supports targeted regeneration of specific documents based on user feedback.
 
+## Part of the AIGNE Ecosystem
+
+DocSmith is a component of the [AIGNE](https://www.aigne.io) ecosystem, a platform for developing AI applications. It integrates with other AIGNE components to use the platform's AI capabilities and infrastructure.
+
+The following diagram shows how DocSmith fits within the AIGNE architecture:
+
+![AIGNE Ecosystem Architecture](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+
 ## Next Steps
 
 To begin using DocSmith, proceed to the installation and configuration guide.
 
 <x-card data-title="Next: Getting Started" data-href="/getting-started" data-icon="lucide:arrow-right-circle" data-cta="Start the guide">
-  Follow the step-by-step guide to install the tool, configure your first project, and generate documentation.
+Follow the step-by-step guide to install the tool, configure your first project, and generate documentation.
 </x-card>

package/docs/overview.zh-TW.md

@@ -1,30 +1,82 @@
 # 總覽
 
-AIGNE DocSmith 是一個由 AI 驅動的工具，可以直接從您的原始碼產生文件。它建立在 [AIGNE 框架](https://www.aigne.io/en/framework)之上，可自動建立結構化、多語言的文件。這個過程減少了撰寫和維護文件的人工工作，確保文件與程式碼庫保持同步。
+AIGNE DocSmith 是一款由 AI 驅動的工具，可直接從您的原始程式碼生成文件。它基於 [AIGNE 框架](https://www.aigne.io/en/framework) 建構，能自動化建立結構化、多語言的文件。此過程減少了手動編寫和維護文件的工作量，確保文件與程式碼庫保持同步。
 
-## AIGNE 生態系統的一部分
+下圖說明了 DocSmith 的高階工作流程：
 
-DocSmith 是 [AIGNE](https://www.aigne.io) 生態系統的關鍵組件，該生態系統是開發 AI 應用程式的平台。它與其他 AIGNE 組件整合，以利用平台的 AI 功能和基礎設施。
+```d2
+direction: right
+style: {
+  font-size: 14
+}
 
-下圖說明了 DocSmith 如何融入 AIGNE 架構：
+# 參與者
+source_code: "原始程式碼儲存庫" {
+  shape: cloud
+  style: {
+    fill: "#F0F4F8"
+    stroke: "#4A5568"
+  }
+}
 
-![AIGNE Ecosystem Architecture](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+docsmith: "AIGNE DocSmith 引擎" {
+  shape: hexagon
+  style: {
+    fill: "#E6FFFA"
+    stroke: "#2C7A7B"
+  }
+}
+
+published_docs: "已發佈文件" {
+  shape: document
+  style: {
+    fill: "#FEFCBF"
+    stroke: "#B7791F"
+  }
+}
+
+# 主要流程
+source_code -> docsmith: "1. 分析程式碼"
+docsmith -> published_docs: "2. 生成與發佈"
+
+# DocSmith 內部流程
+subflow: {
+  direction: down
+  
+  analyze: "分析與規劃結構"
+  generate: "生成內容"
+  translate: "翻譯（選用）"
+  publish: "發佈"
+  
+  analyze -> generate -> translate -> publish
+}
+
+docsmith.subflow: subflow
+```
 
 ## 核心功能
 
-DocSmith 提供了一系列功能來自動化和簡化文件編寫過程：
+DocSmith 提供一系列功能來自動化並簡化文件製作過程：
+
+*   **結構規劃：** 分析程式碼庫以生成邏輯性的文件結構。
+*   **內容生成：** 用從原始程式碼生成的內容填充已規劃的文件結構。
+*   **多語言支援：** 將文件翻譯成 12 種語言，包括英文、中文和西班牙文。
+*   **AIGNE Hub 整合：** 使用 [AIGNE Hub](https://www.aigne.io/en/hub)，該服務提供對各種大型語言模型（LLMs）的存取，例如來自 Google、OpenAI 和 Anthropic 的模型，讓您無需管理個別的 API 金鑰即可切換模型。
+*   **一鍵發佈：** 透過可分享的連結讓您的文件上線。您可以發佈到官方平台，或使用 [Discuss Kit](https://www.web3kit.rocks/discuss-kit) 運行您自己的實例。
+*   **迭代更新：** 偵測原始程式碼的變更以更新文件，並支援根據使用者回饋對特定文件進行針對性地重新生成。
+
+## AIGNE 生態系的一部分
+
+DocSmith 是 [AIGNE](https://www.aigne.io) 生態系的一個組件，該生態系是一個用於開發 AI 應用程式的平台。它與其他 AIGNE 組件整合，以利用該平台的人工智慧能力和基礎設施。
+
+下圖顯示了 DocSmith 如何融入 AIGNE 架構中：
 
-*   **結構規劃：** 分析程式碼庫以產生邏輯性的文件結構。
-*   **內容生成：** 用從原始碼生成的內容填充規劃好的文件結構。
-*   **多語言支援：** 將文件翻譯成 12 種語言，包括英語、中文、日語和西班牙語。
-*   **AIGNE Hub 整合：** 使用 [AIGNE Hub](https://www.aigne.io/en/hub) 作為 LLM 提供者，允許切換模型而無需管理單獨的 API 金鑰。
-*   **文件發布：** 將文件發布到官方平台 [docsmith.aigne.io](https://docsmith.aigne.io/app/) 或使用者自己的 [Discuss Kit](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) 實例。
-*   **迭代更新：** 偵測原始碼變更以更新文件，並支援根據使用者回饋對特定文件進行定向重新生成。
+![AIGNE 生態系架構](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
 
 ## 後續步驟
 
-要開始使用 DocSmith，請繼續閱讀安裝和設定指南。
+若要開始使用 DocSmith，請參閱安裝與設定指南。
 
-<x-card data-title="下一步：入門" data-href="/getting-started" data-icon="lucide:arrow-right-circle" data-cta="開始指南">
-  請遵循逐步指南安裝工具、設定您的第一個專案並產生文件。
+<x-card data-title="下一步：入門指南" data-href="/getting-started" data-icon="lucide:arrow-right-circle" data-cta="開始指南">
+遵循逐步指南來安裝工具、設定您的第一個專案並生成文件。
 </x-card>

package/docs/overview.zh.md

@@ -1,30 +1,82 @@
 # 概述
 
-AIGNE DocSmith 是一款 AI 驱动的工具，可直接从您的源代码生成文档。它基于 [AIGNE 框架](https://www.aigne.io/en/framework) 构建，能够自动创建结构化、多语言的文档。这一过程减少了编写和维护文档的人工工作量，并确保文档与代码库保持同步。
+AIGNE DocSmith 是一款 AI 驱动的工具，可直接从您的源代码生成文档。它基于 [AIGNE 框架](https://www.aigne.io/en/framework) 构建，能够自动化创建结构化、多语言的文档。此过程减少了编写和维护文档的人工工作，确保文档与代码库保持同步。
 
-## AIGNE 生态系统的一部分
+下图说明了 DocSmith 的高级工作流程：
 
-DocSmith 是 [AIGNE](https://www.aigne.io) 生态系统的重要组成部分，该生态系统是用于开发 AI 应用程序的平台。它与其他 AIGNE 组件集成，以利用该平台的 AI 功能和基础设施。
+```d2
+direction: right
+style: {
+  font-size: 14
+}
 
-下图说明了 DocSmith 在 AIGNE 架构中的位置：
+# Actors
+source_code: "源代码仓库" {
+  shape: cloud
+  style: {
+    fill: "#F0F4F8"
+    stroke: "#4A5568"
+  }
+}
 
-![AIGNE 生态系统架构](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+docsmith: "AIGNE DocSmith 引擎" {
+  shape: hexagon
+  style: {
+    fill: "#E6FFFA"
+    stroke: "#2C7A7B"
+  }
+}
+
+published_docs: "已发布的文档" {
+  shape: document
+  style: {
+    fill: "#FEFCBF"
+    stroke: "#B7791F"
+  }
+}
+
+# Main Flow
+source_code -> docsmith: "1. 分析代码"
+docsmith -> published_docs: "2. 生成并发布"
+
+# DocSmith Internal Process
+subflow: {
+  direction: down
+  
+  analyze: "分析并规划结构"
+  generate: "生成内容"
+  translate: "翻译（可选）"
+  publish: "发布"
+  
+  analyze -> generate -> translate -> publish
+}
+
+docsmith.subflow: subflow
+```
 
 ## 核心功能
 
 DocSmith 提供了一系列功能来自动化和简化文档流程：
 
-*   **结构规划：** 分析代码库以生成逻辑清晰的文档结构。
+*   **结构规划：** 分析代码库以生成逻辑化的文档结构。
 *   **内容生成：** 使用从源代码生成的内容填充规划好的文档结构。
-*   **多语言支持：** 可将文档翻译成 12 种语言，包括英语、中文、日语和西班牙语。
-*   **AIGNE Hub 集成：** 使用 [AIGNE Hub](https://www.aigne.io/en/hub) 作为 LLM 提供商，无需管理单独的 API 密钥即可切换模型。
-*   **文档发布：** 将文档发布到官方平台 [docsmith.aigne.io](https://docsmith.aigne.io/app/) 或用户自己的 [Discuss Kit](https://www.arcblock.io/docs/web3-kit/en/discuss-kit) 实例。
+*   **多语言支持：** 可将文档翻译成 12 种语言，包括英语、中文和西班牙语。
+*   **AIGNE Hub 集成：** 使用 [AIGNE Hub](https://www.aigne.io/en/hub)，该服务提供对各种大语言模型 (LLM) 的访问，例如来自 Google、OpenAI 和 Anthropic 的模型，允许切换模型而无需管理各个 API 密钥。
+*   **一键发布：** 通过可共享的链接发布您的文档。您可以发布到官方平台，也可以使用 [Discuss Kit](https://www.web3kit.rocks/discuss-kit) 运行您自己的实例。
 *   **迭代更新：** 检测源代码变更以更新文档，并支持根据用户反馈对特定文档进行定向重新生成。
 
+## AIGNE 生态系统的一部分
+
+DocSmith 是 [AIGNE](https://www.aigne.io) 生态系统的一个组件，该生态系统是一个用于开发 AI 应用程序的平台。它与其他 AIGNE 组件集成，以利用该平台的人工智能能力和基础设施。
+
+下图展示了 DocSmith 如何融入 AIGNE 架构：
+
+![AIGNE 生态系统架构](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+
 ## 后续步骤
 
 要开始使用 DocSmith，请继续阅读安装和配置指南。
 
 <x-card data-title="下一步：开始使用" data-href="/getting-started" data-icon="lucide:arrow-right-circle" data-cta="开始阅读指南">
-  请按照分步指南安装工具、配置您的第一个项目并生成文档。
+按照分步指南安装工具、配置您的第一个项目并生成文档。
 </x-card>

package/media.md

@@ -1,19 +1,19 @@
 # 提供在文档中可使用的媒体素材
 
-![运行 generate 命令，智能执行初始化](https://docsmith.aigne.io/image-bin/uploads/0c45a32667c5250e54194a61d9495965.png)
+![运行 generate 命令，智能执行初始化](./assets/screenshots/doc-generate.png)
 
-![回答问题完成项目设置](https://docsmith.aigne.io/image-bin/uploads/fbedbfa256036ad6375a6c18047a75ad.png)
+![回答问题完成项目设置](./assets/screenshots/doc-complete-setup.png)
 
-![执行结构规划和生成文档](https://docsmith.aigne.io/image-bin/uploads/d0766c19380a02eb8a6f8ce86a838849.png)
+![执行结构规划和生成文档](./assets/screenshots/doc-generate-docs.png)
 
-![文档生成成功](https://docsmith.aigne.io/image-bin/uploads/0967443611408ad9d0042793d590b8fd.png)
+![文档生成成功](./assets/screenshots/doc-generated-successfully.png)
 
-![智能检测，只重新生成需要的文档](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
+![智能检测，只重新生成需要的文档](./assets/screenshots/doc-regenerate.png)
 
-![交互式选择需要更新文档](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
+![交互式选择需要更新文档](./assets/screenshots/doc-update.png)
 
-![发布文档到官方平台或自部署平台](https://docsmith.aigne.io/image-bin/uploads/9fd929060b5abe13d03cf5eb7aea85aa.png)
+![发布文档到官方平台或自部署平台](./assets/screenshots/doc-publish.png)
 
-![选择需要翻译的文档](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
+![选择需要翻译的文档](./assets/screenshots/doc-translate.png)
 
-![选择需要翻译的语言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
+![选择需要翻译的语言](./assets/screenshots/doc-translate-langs.png)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/doc-smith",
-  "version": "0.8.11-beta.6",
+  "version": "0.8.11",
   "description": "AI-driven documentation generation tool built on the AIGNE Framework",
   "publishConfig": {
     "access": "public"