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

package/docs/advanced-how-it-works.zh-TW.md

@@ -1,101 +0,0 @@
-# 運作方式
-
-AIGNE DocSmith 運作於一個多 Agent 系統之上。它並非單一的巨型流程，而是協調一個由專業化 AI Agent 組成的流程，其中每個 Agent 負責一項特定任務。這種方法實現了一個結構化和模組化的流程，能將原始程式碼轉換為完整的文件。
-
-此工具是更廣泛的 AIGNE 生態系統中不可或缺的一部分，該生態系統為開發和部署 AI 應用程式提供了一個平台。
-
-![AIGNE 生態系統架構](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
-
-## 文件產生流程
-
-DocSmith 的核心是一個將您的原始程式碼經過數個不同階段處理的流程。每個階段都由一個或多個專門的 Agent 管理。主要的工作流程，通常由 `aigne doc generate` 指令啟動，可視覺化如下：
-
-```d2
-direction: down
-
-Input: {
-  label: "原始程式碼與設定"
-  shape: rectangle
-}
-
-Pipeline: {
-  label: "核心產生流程"
-  shape: rectangle
-  grid-columns: 1
-  grid-gap: 40
-
-  Structure-Planning: {
-    label: "1. 結構規劃"
-    shape: rectangle
-  }
-
-  Content-Generation: {
-    label: "2. 內容產生"
-    shape: rectangle
-  }
-
-  Saving: {
-    label: "3. 儲存文件"
-    shape: rectangle
-  }
-}
-
-User-Feedback: {
-  label: "使用者回饋循環\n(透過 --feedback 旗標)"
-  shape: rectangle
-}
-
-Optional-Steps: {
-  label: "選用的後產生步驟"
-  shape: rectangle
-  grid-columns: 2
-  grid-gap: 40
-  
-  Translation: {
-    label: "翻譯\n(aigne doc translate)"
-    shape: rectangle
-  }
-
-  Publishing: {
-    label: "發布\n(aigne doc publish)"
-    shape: rectangle
-  }
-}
-
-Input -> Pipeline.Structure-Planning
-Pipeline.Structure-Planning -> Pipeline.Content-Generation
-Pipeline.Content-Generation -> Pipeline.Saving
-Pipeline.Saving -> Optional-Steps
-
-User-Feedback -> Pipeline.Structure-Planning: "優化結構"
-User-Feedback -> Pipeline.Content-Generation: "重新產生內容"
-```
-
-1.  **輸入分析**：當 Agent 載入您的原始程式碼和專案設定（`aigne.yaml`）時，流程便開始了。
-
-2.  **結構規劃**：一個 Agent 會分析程式庫以提出一個合乎邏輯的文件結構。它會根據專案的組成和任何指定的規則來建立大綱。
-
-3.  **內容產生**：結構就緒後，內容產生 Agent 會在文件計畫的每個部分填入詳細的文字、程式碼範例和說明。
-
-4.  **優化與更新**：當您透過 `aigne doc update` 或 `aigne doc generate --feedback` 提供輸入時，特定的 Agent 會被啟動以更新個別文件或調整整體結構。
-
-5.  **翻譯與發布**：主要內容產生後，選用的 Agent 會處理多語言翻譯和將最終文件發布到網路平台等任務。
-
-## 關鍵 AI Agent
-
-DocSmith 的功能由專案設定中定義的一系列 Agent 提供。每個 Agent 都有特定的角色。下表列出了一些關鍵 Agent 及其功能。
-
-| 功能角色 | 關鍵 Agent 檔案 | 說明 |
-| :--- | :--- | :--- |
-| **結構規劃** | `generate/generate-structure.yaml` | 分析原始程式碼以提出初始的文件大綱。 |
-| **結構優化** | `generate/refine-document-structure.yaml` | 根據使用者回饋修改文件結構。 |
-| **內容產生** | `update/batch-generate-document.yaml`, `update/generate-document.yaml` | 為文件結構的每個部分填入詳細內容。 |
-| **翻譯** | `translate/translate-document.yaml`, `translate/translate-multilingual.yaml` | 將產生的文件翻譯成多個目標語言。 |
-| **發布** | `publish/publish-docs.mjs` | 管理將文件發布到 Discuss Kit 實例的流程。 |
-| **資料 I/O** | `utils/load-sources.mjs`, `utils/save-docs.mjs` | 負責讀取來源檔案並將最終的 markdown 文件寫入磁碟。 |
-
-這種基於 Agent 的架構讓文件流程的每一步都由專門的工具處理，確保了工作流程的結構化和可維護性。
-
----
-
-要了解 DocSmith 為確保輸出準確性和格式所採取的措施，請前往 [品質保證](./advanced-quality-assurance.md) 部分。

package/docs/advanced-how-it-works.zh.md

@@ -1,101 +0,0 @@
-# 工作原理
-
-AIGNE DocSmith 在一个多 Agent 系统上运行。它不是一个单一的整体流程，而是协调一个由专门的 AI Agent 组成的管道，其中每个 Agent 负责一项特定任务。这种方法允许通过一个结构化和模块化的流程将源代码转换为完整的文档。
-
-该工具是更广泛的 AIGNE 生态系统的一个组成部分，该生态系统为开发和部署 AI 应用程序提供了一个平台。
-
-![AIGNE 生态系统架构](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
-
-## 文档生成管道
-
-DocSmith 的核心是一个通过几个不同阶段处理您的源代码的管道。每个阶段都由一个或多个专用 Agent 管理。主要工作流程通常由 `aigne doc generate` 命令启动，可以可视化如下：
-
-```d2
-direction: down
-
-Input: {
-  label: "源代码和配置"
-  shape: rectangle
-}
-
-Pipeline: {
-  label: "核心生成管道"
-  shape: rectangle
-  grid-columns: 1
-  grid-gap: 40
-
-  Structure-Planning: {
-    label: "1. 结构规划"
-    shape: rectangle
-  }
-
-  Content-Generation: {
-    label: "2. 内容生成"
-    shape: rectangle
-  }
-
-  Saving: {
-    label: "3. 保存文档"
-    shape: rectangle
-  }
-}
-
-User-Feedback: {
-  label: "用户反馈循环\n(通过 --feedback 标志)"
-  shape: rectangle
-}
-
-Optional-Steps: {
-  label: "可选的生成后步骤"
-  shape: rectangle
-  grid-columns: 2
-  grid-gap: 40
-  
-  Translation: {
-    label: "翻译\n(aigne doc translate)"
-    shape: rectangle
-  }
-
-  Publishing: {
-    label: "发布\n(aigne doc publish)"
-    shape: rectangle
-  }
-}
-
-Input -> Pipeline.Structure-Planning
-Pipeline.Structure-Planning -> Pipeline.Content-Generation
-Pipeline.Content-Generation -> Pipeline.Saving
-Pipeline.Saving -> Optional-Steps
-
-User-Feedback -> Pipeline.Structure-Planning: "优化结构"
-User-Feedback -> Pipeline.Content-Generation: "重新生成内容"
-```
-
-1.  **输入分析**：当 Agent 加载您的源代码和项目配置（`aigne.yaml`）时，该过程开始。
-
-2.  **结构规划**：一个 Agent 分析代码库以提出一个逻辑化的文档结构。它会根据项目的构成和任何指定的规则创建一个大纲。
-
-3.  **内容生成**：结构确定后，内容生成 Agent 会为文档计划的每个部分填充详细的文本、代码示例和解释。
-
-4.  **优化和更新**：当您通过 `aigne doc update` 或 `aigne doc generate --feedback` 提供输入时，特定的 Agent 会被激活以更新单个文档或调整整体结构。
-
-5.  **翻译和发布**：在主要内容生成后，可选的 Agent 会处理多语言翻译和将最终文档发布到 Web 平台等任务。
-
-## 关键 AI Agent
-
-DocSmith 的功能由项目配置中定义的一系列 Agent 提供。每个 Agent 都有特定的角色。下表列出了一些关键 Agent 及其功能。
-
-| 功能角色 | 关键 Agent 文件 | 描述 |
-| :--- | :--- | :--- |
-| **结构规划** | `generate/generate-structure.yaml` | 分析源代码以提出初始文档大纲。 |
-| **结构优化** | `generate/refine-document-structure.yaml` | 根据用户反馈修改文档结构。 |
-| **内容生成** | `update/batch-generate-document.yaml`, `update/generate-document.yaml` | 为文档结构的每个部分填充详细内容。 |
-| **翻译** | `translate/translate-document.yaml`, `translate/translate-multilingual.yaml` | 将生成的文档翻译成多种目标语言。 |
-| **发布** | `publish/publish-docs.mjs` | 管理将文档发布到 Discuss Kit 实例的过程。 |
-| **数据 I/O** | `utils/load-sources.mjs`, `utils/save-docs.mjs` | 负责读取源文件并将最终的 Markdown 文档写入磁盘。 |
-
-这种基于 Agent 的架构允许文档流程的每一步都由专门的工具处理，从而确保一个结构化且可维护的工作流程。
-
----
-
-要了解 DocSmith 为确保输出的准确性和格式而采取的措施，请继续阅读[质量保证](./advanced-quality-assurance.md)部分。

package/docs/advanced-quality-assurance.ja.md

@@ -1,92 +0,0 @@
-# 品質保証
-
-生成されるすべてのドキュメントが高い品質、一貫性、正確性の基準を満たすように、DocSmithには包括的で自動化された品質保証パイプラインが含まれています。これらの組み込みチェックは自動的に実行され、公開前に一般的なフォーマットエラー、リンク切れ、構造的な問題を特定してフラグを立てます。このプロセスにより、最終的な出力がプロフェッショナルで信頼性が高く、ユーザーがナビゲートしやすいものになることが保証されます。
-
-```d2 品質保証パイプライン icon=lucide:shield-check
-direction: down
-
-Documentation-Content: {
-  label: "ドキュメントコンテンツ"
-  shape: rectangle
-}
-
-Quality-Assurance-Pipeline: {
-  label: "品質保証パイプライン"
-  shape: rectangle
-  grid-columns: 3
-  grid-gap: 50
-
-  Markdown-Validation: {
-    label: "1. Markdownとコンテンツの検証\n(remark-lintベース)"
-    shape: rectangle
-
-    Check-1: "有効なMarkdown構文"
-    Check-2: "見出しの整合性"
-    Check-3: "テーブルのフォーマット"
-    Check-4: "コードブロックの整合性"
-    Check-5: "コンテンツの完全性"
-  }
-
-  Link-Asset-Validation: {
-    label: "2. リンクとアセットの整合性"
-    shape: rectangle
-
-    Check-6: "リンク切れの検出"
-    Check-7: "ローカル画像の検証"
-  }
-
-  D2-Diagram-Validation: {
-    label: "3. D2ダイアグラムの検証"
-    shape: rectangle
-
-    Check-8: "D2構文チェック"
-  }
-}
-
-Validation-Result: {
-  label: "すべてのチェックに合格？"
-  shape: diamond
-}
-
-Published-Documentation: {
-  label: "公開済みドキュメント"
-  shape: rectangle
-  style.fill: "#d4edda"
-}
-
-Error-Report: {
-  label: "エラーレポート"
-  shape: rectangle
-  style.fill: "#f8d7da"
-}
-
-Documentation-Content -> Quality-Assurance-Pipeline: "入力"
-Quality-Assurance-Pipeline -> Validation-Result: "検証"
-Validation-Result -> Published-Documentation: "はい"
-Validation-Result -> Error-Report: "いいえ"
-```
-
-## Markdownとコンテンツ構造の検証
-
-品質保証の基盤は、コアとなるMarkdownが整形され、構造的に健全であることを保証することです。DocSmithは`remark-lint`をベースにした高度なリンターを採用しており、一般的な構造上の問題を検出するためのカスタムチェックで補完されています。
-
-主な構造およびフォーマットのチェックには、次のものが含まれます。
-
-*   **有効なMarkdown構文**：標準のMarkdownおよびGFM（GitHub Flavored Markdown）仕様への準拠。
-*   **見出しの整合性**：同一ドキュメント内の重複した見出し、不適切な見出しのインデント、複数のトップレベル見出し（H1）の使用などの問題を検出します。
-*   **テーブルのフォーマット**：テーブル構造が正しいことを検証します。特に、ヘッダー、区切り線、およびデータ行の列数の不一致をチェックします。
-*   **コードブロックの整合性**：すべてのコードブロックが ``` で適切に開始および終了していることを保証します。また、レンダリングに影響を与える可能性のある、コードブロック内の一貫性のないインデントもチェックします。
-*   **コンテンツの完全性**：生成されたコンテンツが適切な句読点で終わっていることを確認し、コンテンツが切り捨てられていないことを保証する検証ステップです。
-
-## リンクとアセットの整合性
-
-リンク切れや画像が見つからないことは、ユーザーエクスペリエンスを低下させます。DocSmithは、すべてのローカルリソースを検証するためのチェックを実行します。
-
-*   **リンク切れの検出**：システムはすべての相対Markdownリンクをスキャンし、ターゲットパスがプロジェクトのドキュメント構造で定義された有効なドキュメントに対応していることを検証します。このチェックにより、ユーザーがドキュメントをナビゲートする際に「404 Not Found」エラーに遭遇するのを防ぎます。`http://`または`https://`で始まる外部リンクはチェックされません。
-*   **ローカル画像の検証**：`![]()`を介して含まれるすべてのローカル画像について、バリデーターは参照されている画像ファイルが指定されたパスに存在することを確認します。これにより、最終的な出力に壊れた画像が表示されないようにします。
-
-## D2ダイアグラムの検証
-
-すべてのダイアグラムが正しくレンダリングされることを保証するため、DocSmithはすべてのD2ダイアグラムの構文を検証します。
-
-`d2`とマークされた各コードブロックは、厳密な構文チェッカーによって処理されます。構文エラーが見つかった場合、生成プロセスは説明的なエラーメッセージとともに停止されます。これにより、壊れた、または不適切にレンダリングされた視覚的なダイアグラムを含むドキュメントの公開を防ぎます。

package/docs/advanced-quality-assurance.md

@@ -1,92 +0,0 @@
-# Quality Assurance
-
-To ensure that all generated documentation meets a high standard of quality, consistency, and accuracy, DocSmith includes a comprehensive, automated quality assurance pipeline. These built-in checks run automatically to identify and flag common formatting errors, broken links, and structural issues before publication. This process guarantees that the final output is professional, reliable, and easy for users to navigate.
-
-```d2 Quality Assurance Pipeline icon=lucide:shield-check
-direction: down
-
-Documentation-Content: {
-  label: "Documentation Content"
-  shape: rectangle
-}
-
-Quality-Assurance-Pipeline: {
-  label: "Quality Assurance Pipeline"
-  shape: rectangle
-  grid-columns: 3
-  grid-gap: 50
-
-  Markdown-Validation: {
-    label: "1. Markdown & Content Validation\n(remark-lint based)"
-    shape: rectangle
-
-    Check-1: "Valid Markdown Syntax"
-    Check-2: "Heading Integrity"
-    Check-3: "Table Formatting"
-    Check-4: "Code Block Integrity"
-    Check-5: "Content Completeness"
-  }
-
-  Link-Asset-Validation: {
-    label: "2. Link & Asset Integrity"
-    shape: rectangle
-
-    Check-6: "Dead Link Detection"
-    Check-7: "Local Image Validation"
-  }
-
-  D2-Diagram-Validation: {
-    label: "3. D2 Diagram Validation"
-    shape: rectangle
-
-    Check-8: "D2 Syntax Check"
-  }
-}
-
-Validation-Result: {
-  label: "All Checks Pass?"
-  shape: diamond
-}
-
-Published-Documentation: {
-  label: "Published Documentation"
-  shape: rectangle
-  style.fill: "#d4edda"
-}
-
-Error-Report: {
-  label: "Error Report"
-  shape: rectangle
-  style.fill: "#f8d7da"
-}
-
-Documentation-Content -> Quality-Assurance-Pipeline: "Input"
-Quality-Assurance-Pipeline -> Validation-Result: "Validation"
-Validation-Result -> Published-Documentation: "Yes"
-Validation-Result -> Error-Report: "No"
-```
-
-## Markdown and Content Structure Validation
-
-The foundation of quality assurance is ensuring the core Markdown is well-formed and structurally sound. DocSmith employs a sophisticated linter based on `remark-lint`, supplemented with custom checks to catch common structural problems.
-
-Key structural and formatting checks include:
-
-*   **Valid Markdown Syntax**: Adherence to standard Markdown and GFM (GitHub Flavored Markdown) specifications.
-*   **Heading Integrity**: Detects issues such as duplicate headings within the same document, incorrect heading indentation, and the use of more than one top-level heading (H1).
-*   **Table Formatting**: Verifies that table structures are correct, specifically checking for mismatches between the number of columns in the header, the separator line, and the data rows.
-*   **Code Block Integrity**: Ensures that all code blocks are properly opened and closed with ```. It also checks for inconsistent indentation within a code block, which can affect rendering.
-*   **Content Completeness**: A verification step to ensure that generated content does not appear truncated by checking that it ends with appropriate punctuation.
-
-## Link and Asset Integrity
-
-Broken links and missing images degrade the user experience. DocSmith performs checks to validate all local resources.
-
-*   **Dead Link Detection**: The system scans all relative Markdown links and verifies that the target path corresponds to a valid document defined in the project's documentation structure. This check prevents users from encountering "404 Not Found" errors when navigating the documentation. External links beginning with `http://` or `https://` are not checked.
-*   **Local Image Validation**: For all local images included via `![]()`, the validator confirms that the referenced image file exists at the specified path. This ensures that no broken images appear in the final output.
-
-## D2 Diagram Validation
-
-To guarantee that all diagrams are rendered correctly, DocSmith validates the syntax of every D2 diagram.
-
-Each code block marked with `d2` is processed through a strict syntax checker. If any syntax errors are found, the generation process is halted with a descriptive error message. This prevents the publication of documents containing broken or improperly rendered visual diagrams.

package/docs/advanced-quality-assurance.zh-TW.md

@@ -1,92 +0,0 @@
-# 品質保證
-
-為確保所有產生的文件都符合高品質、一致性和準確性的標準，DocSmith 內建了一個全面、自動化的品質保證流程。這些內建的檢查會在發布前自動運行，以識別並標記常見的格式錯誤、失效連結和結構性問題。此過程確保最終的輸出成品具備專業性、可靠性，並讓使用者易於瀏覽。
-
-```d2 品質保證流程 icon=lucide:shield-check
-direction: down
-
-Documentation-Content: {
-  label: "文件內容"
-  shape: rectangle
-}
-
-Quality-Assurance-Pipeline: {
-  label: "品質保證流程"
-  shape: rectangle
-  grid-columns: 3
-  grid-gap: 50
-
-  Markdown-Validation: {
-    label: "1. Markdown 與內容驗證\n(基於 remark-lint)"
-    shape: rectangle
-
-    Check-1: "有效的 Markdown 語法"
-    Check-2: "標題完整性"
-    Check-3: "表格格式"
-    Check-4: "程式碼區塊完整性"
-    Check-5: "內容完整性"
-  }
-
-  Link-Asset-Validation: {
-    label: "2. 連結與資源完整性"
-    shape: rectangle
-
-    Check-6: "失效連結偵測"
-    Check-7: "本地圖片驗證"
-  }
-
-  D2-Diagram-Validation: {
-    label: "3. D2 圖表驗證"
-    shape: rectangle
-
-    Check-8: "D2 語法檢查"
-  }
-}
-
-Validation-Result: {
-  label: "所有檢查是否通過？"
-  shape: diamond
-}
-
-Published-Documentation: {
-  label: "已發布的文件"
-  shape: rectangle
-  style.fill: "#d4edda"
-}
-
-Error-Report: {
-  label: "錯誤報告"
-  shape: rectangle
-  style.fill: "#f8d7da"
-}
-
-Documentation-Content -> Quality-Assurance-Pipeline: "輸入"
-Quality-Assurance-Pipeline -> Validation-Result: "驗證"
-Validation-Result -> Published-Documentation: "是"
-Validation-Result -> Error-Report: "否"
-```
-
-## Markdown 與內容結構驗證
-
-品質保證的基礎是確保核心 Markdown 格式正確且結構健全。DocSmith 採用一個基於 `remark-lint` 的精密 linter，並輔以自訂檢查來捕捉常見的結構性問題。
-
-主要的結構和格式檢查包括：
-
-*   **有效的 Markdown 語法**：遵循標準 Markdown 和 GFM (GitHub Flavored Markdown) 規範。
-*   **標題完整性**：偵測同一文件內的重複標題、不正確的標題縮排，以及使用超過一個頂層標題 (H1) 等問題。
-*   **表格格式**：驗證表格結構是否正確，特別是檢查標頭、分隔線和資料列之間的欄位數量是否不匹配。
-*   **程式碼區塊完整性**：確保所有程式碼區塊都以 ``` 正確地開啟和關閉。它還會檢查程式碼區塊內可能影響渲染結果的不一致縮排。
-*   **內容完整性**：一個驗證步驟，透過檢查產生的內容是否以適當的標點符號結尾，來確保內容不會看似被截斷。
-
-## 連結與資源完整性
-
-失效連結和遺失的圖片會降低使用者體驗。DocSmith 會執行檢查以驗證所有本地資源。
-
-*   **失效連結偵測**：系統會掃描所有相對 Markdown 連結，並驗證目標路徑是否對應到專案文件結構中定義的有效文件。此檢查可防止使用者在瀏覽文件時遇到「404 Not Found」錯誤。以 `http://` 或 `https://` 開頭的外部連結則不會被檢查。
-*   **本地圖片驗證**：對於所有透過 `![]()` 包含的本地圖片，驗證器會確認所引用的圖片檔案是否存在於指定路徑。這能確保最終的輸出成品中不會出現破損的圖片。
-
-## D2 圖表驗證
-
-為保證所有圖表都能正確渲染，DocSmith 會驗證每個 D2 圖表的語法。
-
-每個標記為 `d2` 的程式碼區塊都會經過嚴格的語法檢查器處理。若發現任何語法錯誤，產生過程將會被中止，並顯示一則描述性的錯誤訊息。這可以防止發布含有破損或渲染不當的視覺圖表的文件。

package/docs/advanced-quality-assurance.zh.md

@@ -1,92 +0,0 @@
-# 质量保证
-
-为确保所有生成的文档都符合高质量、一致性和准确性的标准，DocSmith 包含一个全面的自动化质量保证流程。这些内置检查会自动运行，以在发布前识别并标记常见的格式错误、断开的链接和结构性问题。此过程保证最终输出专业、可靠且易于用户浏览。
-
-```d2 质量保证流程 icon=lucide:shield-check
-direction: down
-
-Documentation-Content: {
-  label: "文档内容"
-  shape: rectangle
-}
-
-Quality-Assurance-Pipeline: {
-  label: "质量保证流程"
-  shape: rectangle
-  grid-columns: 3
-  grid-gap: 50
-
-  Markdown-Validation: {
-    label: "1. Markdown 和内容验证\n（基于 remark-lint）"
-    shape: rectangle
-
-    Check-1: "有效的 Markdown 语法"
-    Check-2: "标题完整性"
-    Check-3: "表格格式"
-    Check-4: "代码块完整性"
-    Check-5: "内容完整性"
-  }
-
-  Link-Asset-Validation: {
-    label: "2. 链接和资产完整性"
-    shape: rectangle
-
-    Check-6: "死链检测"
-    Check-7: "本地图片验证"
-  }
-
-  D2-Diagram-Validation: {
-    label: "3. D2 图表验证"
-    shape: rectangle
-
-    Check-8: "D2 语法检查"
-  }
-}
-
-Validation-Result: {
-  label: "所有检查是否通过？"
-  shape: diamond
-}
-
-Published-Documentation: {
-  label: "已发布的文档"
-  shape: rectangle
-  style.fill: "#d4edda"
-}
-
-Error-Report: {
-  label: "错误报告"
-  shape: rectangle
-  style.fill: "#f8d7da"
-}
-
-Documentation-Content -> Quality-Assurance-Pipeline: "输入"
-Quality-Assurance-Pipeline -> Validation-Result: "验证"
-Validation-Result -> Published-Documentation: "是"
-Validation-Result -> Error-Report: "否"
-```
-
-## Markdown 和内容结构验证
-
-质量保证的基础是确保核心 Markdown 格式良好且结构合理。DocSmith 采用基于 `remark-lint` 的精密 linter，并辅以自定义检查来捕获常见的结构性问题。
-
-关键的结构和格式检查包括：
-
-*   **有效的 Markdown 语法**：遵循标准 Markdown 和 GFM（GitHub Flavored Markdown）规范。
-*   **标题完整性**：检测同一文档中重复的标题、不正确的标题缩进以及使用多个顶级标题（H1）等问题。
-*   **表格格式**：验证表格结构是否正确，特别是检查表头、分隔行和数据行之间的列数是否不匹配。
-*   **代码块完整性**：确保所有代码块都使用 ``` 正确地开始和结束。它还会检查代码块内不一致的缩进，这可能会影响渲染。
-*   **内容完整性**：一个验证步骤，通过检查生成的内容是否以适当的标点符号结尾，来确保内容没有被截断。
-
-## 链接和资产完整性
-
-断开的链接和缺失的图片会降低用户体验。DocSmith 会执行检查以验证所有本地资源。
-
-*   **死链检测**：系统会扫描所有相对 Markdown 链接，并验证目标路径是否对应于项目文档结构中定义的有效文档。此检查可防止用户在浏览文档时遇到“404 Not Found”错误。以 `http://` 或 `https://` 开头的外部链接不会被检查。
-*   **本地图片验证**：对于所有通过 `![]()` 包含的本地图片，验证器会确认引用的图片文件是否存在于指定路径。这可以确保最终输出中不会出现损坏的图片。
-
-## D2 图表验证
-
-为保证所有图表都能正确渲染，DocSmith 会验证每个 D2 图表的语法。
-
-每个标记为 `d2` 的代码块都会经过严格的语法检查器处理。如果发现任何语法错误，生成过程将停止并显示描述性错误消息。这可以防止发布包含损坏或渲染不当的可视图表的文档。

package/docs/advanced.ja.md

@@ -1,20 +0,0 @@
-# 高度なトピック
-
-このセクションでは、AIGNE DocSmithの内部アーキテクチャと動作メカニズムについて詳しく説明します。このセクションは、ツールの機能についてより深く理解したいユーザーを対象としており、高度なカスタマイズやプロジェクトへの貢献に役立ちます。この情報は、標準的な使用には必要ありません。
-
-DocSmithは、AIアプリケーション開発のプラットフォームを提供するAIGNEエコシステムのコンポーネントです。次の図は、全体のアーキテクチャを示しています。
-
-![AIGNEエコシステムのアーキテクチャ](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
-
-DocSmith内の特定のプロセスと品質管理手段については、以下の詳細なセクションを参照してください。
-
-<x-cards data-columns="2">
-  <x-card data-title="仕組み" data-href="/advanced/how-it-works" data-icon="lucide:cpu">
-    DocSmithのアーキテクチャ概要。ドキュメント生成パイプラインにおけるAI Agentの役割を説明します。
-  </x-card>
-  <x-card data-title="品質保証" data-href="/advanced/quality-assurance" data-icon="lucide:shield-check">
-    リンクチェックやダイアグラム検証など、適切にフォーマットされエラーのないドキュメントを保証するためにDocSmithが実行する組み込みチェックについて理解します。
-  </x-card>
-</x-cards>
-
-これらのトピックを確認することで、DocSmithの機能を包括的に理解することができます。利用可能なすべてのコマンドとそのパラメータの完全なリファレンスについては、[CLIコマンドリファレンス](./cli-reference.md)を参照してください。

package/docs/advanced.md

@@ -1,20 +0,0 @@
-# Advanced Topics
-
-This section provides a detailed examination of the internal architecture and operational mechanics of AIGNE DocSmith. It is intended for users who wish to gain a deeper understanding of how the tool functions, which can be beneficial for advanced customization or contributing to the project. This information is not required for standard use.
-
-DocSmith is a component of the AIGNE ecosystem, which provides a platform for AI application development. The following diagram illustrates the overall architecture.
-
-![AIGNE Ecosystem Architecture](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
-
-To explore the specific processes and quality control measures within DocSmith, refer to the following detailed sections.
-
-<x-cards data-columns="2">
-  <x-card data-title="How It Works" data-href="/advanced/how-it-works" data-icon="lucide:cpu">
-    An architectural overview of DocSmith, explaining the role of AI agents in the documentation generation pipeline.
-  </x-card>
-  <x-card data-title="Quality Assurance" data-href="/advanced/quality-assurance" data-icon="lucide:shield-check">
-    Understand the built-in checks DocSmith performs to ensure well-formatted and error-free documentation, including link checking and diagram validation.
-  </x-card>
-</x-cards>
-
-By reviewing these topics, you can develop a comprehensive understanding of DocSmith's functionality. For a complete reference of all available commands and their parameters, please see the [CLI Command Reference](./cli-reference.md).

package/docs/advanced.zh-TW.md

@@ -1,20 +0,0 @@
-# 進階主題
-
-本節詳細介紹 AIGNE DocSmith 的內部架構和運作機制。它專為希望深入了解該工具如何運作的使用者而設計，這對於進階自訂或為專案做出貢獻非常有益。標準使用不需要這些資訊。
-
-DocSmith 是 AIGNE 生態系的一個元件，該生態系為 AI 應用程式開發提供了一個平台。下圖說明了整體架構。
-
-![AIGNE 生態系架構](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
-
-若要探索 DocSmith 內的具體流程和品質控制措施，請參閱以下詳細章節。
-
-<x-cards data-columns="2">
-  <x-card data-title="運作方式" data-href="/advanced/how-it-works" data-icon="lucide:cpu">
-    DocSmith 的架構概覽，解釋 AI agent 在文件生成流程中的角色。
-  </x-card>
-  <x-card data-title="品質保證" data-href="/advanced/quality-assurance" data-icon="lucide:shield-check">
-    了解 DocSmith 執行的內建檢查，以確保文件格式正確且無錯誤，包括連結檢查和圖表驗證。
-  </x-card>
-</x-cards>
-
-透過回顧這些主題，您可以全面了解 DocSmith 的功能。有關所有可用指令及其參數的完整參考，請參閱 [CLI 指令參考](./cli-reference.md)。

package/docs/advanced.zh.md

@@ -1,20 +0,0 @@
-# 高级主题
-
-本节详细阐述了 AIGNE DocSmith 的内部架构和运行机制。本节面向希望深入了解该工具工作原理的用户，这对于高级定制或为项目做出贡献大有裨益。标准使用无需了解这些信息。
-
-DocSmith 是 AIGNE 生态系统的一个组件，该生态系统为 AI 应用开发提供了一个平台。下图展示了其整体架构。
-
-![AIGNE 生态系统架构](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
-
-要了解 DocSmith 内部的具体流程和质量控制措施，请参阅以下详细章节。
-
-<x-cards data-columns="2">
-  <x-card data-title="工作原理" data-href="/advanced/how-it-works" data-icon="lucide:cpu">
-    DocSmith 的架构概述，解释了 AI Agent 在文档生成流程中的作用。
-  </x-card>
-  <x-card data-title="质量保证" data-href="/advanced/quality-assurance" data-icon="lucide:shield-check">
-    了解 DocSmith 为确保文档格式正确、无错误而执行的内置检查，包括链接检查和图表验证。
-  </x-card>
-</x-cards>
-
-通过阅读这些主题，您可以全面了解 DocSmith 的功能。有关所有可用命令及其参数的完整参考，请参阅 [CLI 命令参考](./cli-reference.md)。