@aigne/doc-smith 0.8.3 → 0.8.4

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

@@ -1,64 +1,99 @@
----
-labels: ["Reference"]
----
-
 # 质量保证
 
-为确保您的文档始终保持高质量，DocSmith 内置了一个强大的自动化质量保证流程。这些内置检查在生成和更新过程中自动运行，以检测并报告常见问题（从链接失效到格式错误），从而在问题影响到读者之前予以解决。
+为确保所有生成的文档功能正常、清晰且专业，DocSmith 引入了自动化的质量保证流程。该流程会对 Markdown 内容执行一系列检查，以便在发布前检测并报告从链接失效到图表格式错误等常见问题。
 
-该流程会验证您内容的多个方面，以保持结构的完整性和准确性。
+该自动化流程会验证内容结构、链接、媒体和语法，以保持一致的质量标准。
 
 ```d2
-direction: right
+direction: down
+
+Input-Markdown-Content: {
+  label: "输入：Markdown 内容"
+  shape: rectangle
+}
+
+QA-Pipeline: {
+  label: "质量保证流程"
+  shape: rectangle
+  grid-columns: 1
+  grid-gap: 50
 
-Input: "Markdown 内容"
+  Structural-Checks: {
+    label: "结构检查"
+    shape: rectangle
+    grid-columns: 2
+    Completeness: "确保内容未被截断"
+    Code-Blocks: "验证代码块语法和缩进"
+  }
+
+  Content-Validation: {
+    label: "内容验证"
+    shape: rectangle
+    grid-columns: 2
+    Link-Integrity: "验证内部链接"
+    Image-Paths: "检查本地图片是否存在"
+    Table-Formatting: "匹配列数"
+  }
 
-QA_Pipeline: "DocSmith QA 流程" {
-  shape: package
-  
-  Checks: {
+  Syntax-Validation: {
+    label: "语法验证"
+    shape: rectangle
     grid-columns: 2
-    "结构完整性": "代码块不完整和缩进不一致"
-    "链接和资源健康状况": "失效链接和本地图片缺失"
-    "图表验证": "D2 语法检查"
-    "Markdown 语法检查": "表格格式和标准规则"
+    D2-Diagrams: "验证 D2 语法"
+    Mermaid-Diagrams: "验证 Mermaid 语法"
+    Markdown-Linting: "强制执行样式规则"
   }
 }
 
-Output: "经验证的文档"
+Output-Validated-Content-or-Error-Report: {
+  label: "输出：验证通过的内容或错误报告"
+  shape: rectangle
+}
 
-Input -> QA_Pipeline: "分析"
-QA_Pipeline -> Output: "生成"
+Input-Markdown-Content -> QA-Pipeline
+QA-Pipeline -> Output-Validated-Content-or-Error-Report
 ```
 
-### 内容和结构完整性
+### 核心验证领域
+
+DocSmith 的质量保证流程涵盖了几个关键领域，以确保文档的完整性。
+
+#### 内容结构与完整性
 
-DocSmith 会分析 Markdown 文件的基本结构，以捕获那些经常导致渲染失败或输出混乱的问题。
+DocSmith 会执行多项检查以确保内容的结构完整性：
 
-- **代码块不完整**：验证器会确保每个以 ` ``` ` 开始的代码块都已正确关闭。未关闭的代码块可能导致文档的大部分内容无法正确渲染。
-- **缩进不一致**：系统会标记出缩进不一致的代码块。这对于缩进具有语法意义的代码示例以及防止意外的渲染问题尤为重要。
-- **内容完整性**：系统通过验证内容是否以适当的标点符号（例如 `.`、`)`、`|`）结尾，来检查内容是否被截断。这有助于捕获不完整的生成结果。
+- **不完整的代码块**：检测以 ```` ``` ```` 开头但未关闭的代码块。
+- **缺少换行符**：识别显示在单行上的内容，这可能表示缺少换行符。
+- **内容结尾**：验证内容是否以适当的标点符号（例如 `.`、`)`、`|`、`>`）结尾，以防止输出被截断。
 
-### 链接和资源验证
+#### 链接和媒体完整性
 
-失效链接和缺失图片会降低用户体验。DocSmith 会自动验证这些资源，以确保读者始终可以访问它们。
+- **链接完整性**：文档中的所有相对链接都会根据项目的 `structurePlan` 进行验证，以防止出现死链接。这确保了所有内部导航都能正常工作。检查程序会忽略外部链接（以 `http://` 或 `https://` 开头）和 `mailto:` 链接。
 
-- **失效链接检查**：所有内部链接都会与您项目结构计划中定义的路径进行交叉引用。任何指向不存在页面的链接都将被报告为失效链接。
-- **本地图片验证**：对于本地图片（即未托管在外部服务器上的图片），系统会检查引用的图片文件是否存在于指定的相对或绝对路径中。
+- **图片验证**：为避免图片损坏，检查程序会验证文档中引用的任何本地图片文件是否存在于文件系统中。它会解析相对路径和绝对路径以确认文件存在。外部图片 URL 和数据 URL 不会被检查。
 
-### 图表验证
+#### 图表语法验证
 
-为确保所有图表都能正确渲染，DocSmith 会专门验证 D2 代码块的语法。在处理之前，系统会检查 D2 内容的语法正确性。如果发现错误，系统会进行标记，以防止发布损坏的图表。
+- **D2 图表**：DocSmith 通过将代码发送到渲染服务来验证 D2 图表语法。此过程会确认图表能否成功编译为 SVG 图片，从而在导致图形损坏前捕获任何语法错误。
 
-### Markdown 格式化与语法检查
+- **Mermaid 图表**：Mermaid 图表会经过多项检查：一次主语法验证，以及针对已知会导致渲染问题的模式的特定检查，例如节点标签内的反引号或编号列表，以及需要加引号但未加的特殊字符。
 
-除了主要的结构性问题，DocSmith 还会对 Markdown 进行语法检查，以确保格式的一致性和正确性，并利用既定标准来强制执行清晰易读的风格。关键检查包括：
+#### 格式化与样式强制
 
-| 检查类别 | 描述 |
+- **表格格式化**：检查表格的表头、分隔线和数据行之间的列数是否不匹配。此检查可防止常见的表格渲染失败。
+
+- **代码块缩进**：检查程序会分析代码块中不一致的缩进。如果某行代码的缩进小于开头的 ```` ``` ```` 标记，可能会导致渲染问题。此检查有助于保持正确的代码呈现。
+
+- **Markdown Linting**：内置的 linter 会强制执行一致的 Markdown 结构。关键规则包括：
+
+| 规则 ID | 描述 |
 |---|---|
-| **表格格式化** | 验证表格的表头、分隔线和数据行中的列数是否一致。列数不匹配是导致表格损坏的常见原因。 |
-| **标题问题** | 检测同一文档中的重复标题或使用不当缩进的标题，这些问题可能会破坏文档大纲。 |
-| **引用验证** | 检查未定义的引用，例如使用了链接引用 `[text][ref]`，但未在其他地方定义 `[ref]: url`。 |
-| **代码块样式** | 确保一致地使用代码块标记，以提高可读性和解析效率。 |
+| `no-duplicate-headings` | 防止同一节中出现内容相同的多个标题。 |
+| `no-undefined-references` | 确保所有链接和图片引用都已定义。 |
+| `no-heading-content-indent` | 不允许在标题内容前缩进。 |
+| `no-multiple-toplevel-headings` | 每个文档只允许一个顶级标题 (H1)。 |
+| `code-block-style` | 强制代码块使用一致的样式（例如，使用反引号）。 |
+
+通过自动化这些检查，DocSmith 保持了文档的一致标准，确保最终输出准确且易于导航。
 
-这个自动化的质量保证层是 DocSmith 架构的核心部分，旨在最大限度地减少人工审查，并确保您的文档始终准确、专业且可靠。要了解有关整体生成流程的更多信息，请参阅[工作原理](./advanced-how-it-works.md)。
+要了解有关整体架构的更多信息，请参阅 [工作原理](./advanced-how-it-works.md) 部分。

package/docs/advanced.md

@@ -1,18 +1,6 @@
----
-labels: ["Reference"]
----
-
 # Advanced Topics
 
-For those who wish to look under the hood, this section provides a deeper dive into the architecture of AIGNE DocSmith. Here, you'll learn how the tool functions, its place within the AIGNE ecosystem, and the internal mechanisms it uses to generate high-quality documentation.
-
-While a deep understanding of these topics isn't necessary for general use, it can be valuable for customizing behavior, troubleshooting issues, or contributing to the project.
-
-## The AIGNE Ecosystem
-
-AIGNE DocSmith is not a standalone tool; it is a key component of the [AIGNE Framework](https://www.aigne.io/en/framework), a comprehensive platform for AI application development. This integration allows DocSmith to leverage the platform's advanced AI capabilities and robust infrastructure. The following diagram illustrates how DocSmith fits into the broader ecosystem.
-
-![AIGNE Ecosystem Architecture](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+For users who wish to understand the internal mechanics, this section provides a deeper look into the architecture of AIGNE DocSmith. It explains how the tool functions behind the scenes. While this level of detail is not required for general use, it can be valuable for customizing behavior or contributing to the project.
 
 To better understand the internal processes and quality controls, explore the following sections.
 
@@ -21,7 +9,7 @@ To better understand the internal processes and quality controls, explore the fo
     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 high-quality, well-formatted, and error-free documentation.
+    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>
 

package/docs/advanced.zh.md

@@ -1,28 +1,16 @@
----
-labels: ["Reference"]
----
-
 # 高级主题
 
-对于希望深入了解其内部机制的用户，本节将深入解析 AIGNE DocSmith 的架构。在这里，你将了解到该工具的运作方式、其在 AIGNE 生态系统中的定位，以及它用于生成高质量文档的内部机制。
-
-虽然深入理解这些主题对于一般使用并非必要，但它对于自定义行为、排查问题或为项目做出贡献非常有价值。
-
-## AIGNE 生态系统
-
-AIGNE DocSmith 并非一个独立的工具，而是 [AIGNE 框架](https://www.aigne.io/en/framework) 的关键组件，该框架是一个用于 AI 应用开发的综合平台。这种集成使 DocSmith 能够利用该平台的先进 AI 功能和强大的基础设施。下图展示了 DocSmith 如何融入更广泛的生态系统。
-
-![AIGNE 生态系统架构](https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png)
+对于希望了解内部机制的用户，本节将深入介绍 AIGNE DocSmith 的架构。它解释了该工具在后台如何运作。虽然一般使用不需要了解这些细节，但对于自定义行为或为项目做贡献而言，这些信息可能很有价值。
 
-要更好地了解其内部流程和质量控制，请浏览以下章节。
+要更好地了解内部流程和质量控制，请浏览以下部分。
 
 <x-cards data-columns="2">
   <x-card data-title="工作原理" data-href="/advanced/how-it-works" data-icon="lucide:cpu">
-    DocSmith 的架构概览，解释了 AI Agent 在文档生成流程中的作用。
+    DocSmith 的架构概述，解释了 AI Agent 在文档生成流程中的作用。
   </x-card>
   <x-card data-title="质量保证" data-href="/advanced/quality-assurance" data-icon="lucide:shield-check">
-    了解 DocSmith 为确保文档高质量、格式良好且无错误而执行的内置检查。
+    了解 DocSmith 为确保文档格式正确、无错误而执行的内置检查，包括链接检查和图表验证。
   </x-card>
 </x-cards>
 
-通过探索这些主题，你可以更全面地了解 DocSmith 的功能。要获取所有可用命令及其选项的详细说明，请参阅 [CLI 命令参考](./cli-reference.md)。
+通过探索这些主题，你可以更全面地了解 DocSmith 的功能。要详细了解所有可用命令及其选项，请继续阅读 [CLI 命令参考](./cli-reference.md)。

package/docs/changelog.md

@@ -1,11 +1,48 @@
----
-labels: ["Reference"]
----
-
 # Changelog
 
 A detailed log of all notable changes, features, and bug fixes for each version of the project.
 
+## [0.8.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.1...v0.8.2) (2025-09-04)
+
+
+### Miscellaneous Chores
+
+* release 0.8.2 ([849bc69](https://github.com/AIGNE-io/aigne-doc-smith/commit/849bc694edf167187f65cb34f1dd9a3966efd96c))
+
+## [0.8.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.0...v0.8.1) (2025-09-03)
+
+
+### Features
+
+* tune d2 chart generating with comprehensive examples ([#80](https://github.com/AIGNE-io/aigne-doc-smith/issues/80)) ([3423e4c](https://github.com/AIGNE-io/aigne-doc-smith/commit/3423e4cff24335552503916694a3489e5d91bf6c))
+
+
+### Miscellaneous Chores
+
+* release 0.8.1 ([21f64d4](https://github.com/AIGNE-io/aigne-doc-smith/commit/21f64d450377b1aef00f12613ba3b87aa4ef1d31))
+
+## [0.8.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.7.2...v0.8.0) (2025-09-03)
+
+
+### Features
+
+* **tests:** add comprehensive workflow test coverage ([#76](https://github.com/AIGNE-io/aigne-doc-smith/issues/76)) ([d5f6062](https://github.com/AIGNE-io/aigne-doc-smith/commit/d5f6062311f36dc5b6394ae0768583fb8f3853a4))
+* update custom component guidelines with formatting restrictions ([#79](https://github.com/AIGNE-io/aigne-doc-smith/issues/79)) ([76158de](https://github.com/AIGNE-io/aigne-doc-smith/commit/76158de236696e68c63c057f5ea4b8458a15e787))
+
+## [0.7.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.7.1...v0.7.2) (2025-09-01)
+
+
+### Miscellaneous Chores
+
+* release 0.7.2 ([c3be232](https://github.com/AIGNE-io/aigne-doc-smith/commit/c3be2323e885cf5d11d654629fe30cc3720f79d3))
+
+## [0.7.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.7.0...v0.7.1) (2025-08-31)
+
+
+### Bug Fixes
+
+* fix tab key path selection bug ([#72](https://github.com/AIGNE-io/aigne-doc-smith/issues/72)) ([369b342](https://github.com/AIGNE-io/aigne-doc-smith/commit/369b342d8ab8ce95b61a3b72e367157d2f71cce4))
+
 ## [0.7.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.6.0...v0.7.0) (2025-08-30)
 
 

package/docs/changelog.zh.md

@@ -1,34 +1,71 @@
----
-labels: ["Reference"]
----
-
 # 更新日志
 
-项目每个版本所有重要变更、功能和错误修复的详细日志。
+项目每个版本的所有重要变更、功能和错误修复的详细日志。
+
+## [0.8.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.1...v0.8.2) (2025-09-04)
+
+
+### 其他杂项
+
+* 发布 0.8.2 ([849bc69](https://github.com/AIGNE-io/aigne-doc-smith/commit/849bc694edf167187f65cb34f1dd9a3966efd96c))
+
+## [0.8.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.0...v0.8.1) (2025-09-03)
+
+
+### 功能
+
+* 通过综合示例调整 d2 图表生成 ([#80](https://github.com/AIGNE-io/aigne-doc-smith/issues/80)) ([3423e4c](https://github.com/AIGNE-io/aigne-doc-smith/commit/3423e4cff24335552503916694a3489e5d91bf6c))
+
+
+### 其他杂项
+
+* 发布 0.8.1 ([21f64d4](https://github.com/AIGNE-io/aigne-doc-smith/commit/21f64d450377b1aef00f12613ba3b87aa4ef1d31))
+
+## [0.8.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.7.2...v0.8.0) (2025-09-03)
+
+
+### 功能
+
+* **测试：**添加全面的工作流测试覆盖率 ([#76](https://github.com/AIGNE-io/aigne-doc-smith/issues/76)) ([d5f6062](https://github.com/AIGNE-io/aigne-doc-smith/commit/d5f6062311f36dc5b6394ae0768583fb8f3853a4))
+* 更新自定义组件指南，增加格式限制 ([#79](https://github.com/AIGNE-io/aigne-doc-smith/issues/79)) ([76158de](https://github.com/AIGNE-io/aigne-doc-smith/commit/76158de236696e68c63c057f5ea4b8458a15e787))
+
+## [0.7.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.7.1...v0.7.2) (2025-09-01)
+
+
+### 其他杂项
+
+* 发布 0.7.2 ([c3be232](https://github.com/AIGNE-io/aigne-doc-smith/commit/c3be2323e885cf5d11d654629fe30cc3720f79d3))
+
+## [0.7.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.7.0...v0.7.1) (2025-08-31)
+
+
+### 错误修复
+
+* 修复 Tab 键路径选择错误 ([#72](https://github.com/AIGNE-io/aigne-doc-smith/issues/72)) ([369b342](https://github.com/AIGNE-io/aigne-doc-smith/commit/369b342d8ab8ce95b61a3b72e367157d2f71cce4))
 
 ## [0.7.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.6.0...v0.7.0) (2025-08-30)
 
 
 ### 功能
 
-* 新增聊天模式支持 ([#60](https://github.com/AIGNE-io/aigne-doc-smith/issues/60)) ([9b2ce50](https://github.com/AIGNE-io/aigne-doc-smith/commit/9b2ce50014d1894a4e41bf043e699fdc4f1d74b7))
-* 支持自定义组件和更稳健的配置处理 ([#70](https://github.com/AIGNE-io/aigne-doc-smith/issues/70)) ([727ab42](https://github.com/AIGNE-io/aigne-doc-smith/commit/727ab429b00f924ef605530b35d2a12b4be77e3a))
+* 增加聊天模式支持 ([#60](https://github.com/AIGNE-io/aigne-doc-smith/issues/60)) ([9b2ce50](https://github.com/AIGNE-io/aigne-doc-smith/commit/9b2ce50014d1894a4e41bf043e699fdc4f1d74b7))
+* 支持自定义组件和更强大的配置处理 ([#70](https://github.com/AIGNE-io/aigne-doc-smith/issues/70)) ([727ab42](https://github.com/AIGNE-io/aigne-doc-smith/commit/727ab429b00f924ef605530b35d2a12b4be77e3a))
 * 在文档生成和发布工作流中支持 d2 图表 ([#69](https://github.com/AIGNE-io/aigne-doc-smith/issues/69)) ([bf95889](https://github.com/AIGNE-io/aigne-doc-smith/commit/bf958891516973636c4847b084c6fe75d1ea124b))
-* 支持多用途文档规划与生成 ([#68](https://github.com/AIGNE-io/aigne-doc-smith/issues/68)) ([44152c5](https://github.com/AIGNE-io/aigne-doc-smith/commit/44152c53b7e8f82e3af1245a1affd77b9817486d))
+* 支持多用途文档规划和生成 ([#68](https://github.com/AIGNE-io/aigne-doc-smith/issues/68)) ([44152c5](https://github.com/AIGNE-io/aigne-doc-smith/commit/44152c53b7e8f82e3af1245a1affd77b9817486d))
 
 ## [0.6.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.5.1...v0.6.0) (2025-08-27)
 
 
 ### 功能
 
-* 在发布前全面支持媒体处理 ([#63](https://github.com/AIGNE-io/aigne-doc-smith/issues/63)) ([5257ca1](https://github.com/AIGNE-io/aigne-doc-smith/commit/5257ca1756f47487b65a1813949e547b6fc51aca))
+* 完成发布前媒体处理的全面支持 ([#63](https://github.com/AIGNE-io/aigne-doc-smith/issues/63)) ([5257ca1](https://github.com/AIGNE-io/aigne-doc-smith/commit/5257ca1756f47487b65a1813949e547b6fc51aca))
 
 ## [0.5.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.5.0...v0.5.1) (2025-08-26)
 
 
 ### 其他杂项
 
-* 发布 0.5.1 版本 ([892d96e](https://github.com/AIGNE-io/aigne-doc-smith/commit/892d96e939a6404a42e8d2521f95bb7acfeabe27))
+* 发布 0.5.1 ([892d96e](https://github.com/AIGNE-io/aigne-doc-smith/commit/892d96e939a6404a42e8d2521f95bb7acfeabe27))
 
 ## [0.5.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.4.5...v0.5.0) (2025-08-26)
 
@@ -40,14 +77,14 @@ labels: ["Reference"]
 
 ### 错误修复
 
-* 优化初始化问题的文案 ([#65](https://github.com/AIGNE-io/aigne-doc-smith/issues/65)) ([d4e8762](https://github.com/AIGNE-io/aigne-doc-smith/commit/d4e8762f26fd757bde43427860a0c1dade384269))
+* 优化初始问题文案 ([#65](https://github.com/AIGNE-io/aigne-doc-smith/issues/65)) ([d4e8762](https://github.com/AIGNE-io/aigne-doc-smith/commit/d4e8762f26fd757bde43427860a0c1dade384269))
 
 ## [0.4.5](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.4.4...v0.4.5) (2025-08-25)
 
 
 ### 其他杂项
 
-* 发布 0.4.5 版本 ([12aa6c3](https://github.com/AIGNE-io/aigne-doc-smith/commit/12aa6c340fdd95cbd74833662f4c3a80f19dfa30))
+* 发布 0.4.5 ([12aa6c3](https://github.com/AIGNE-io/aigne-doc-smith/commit/12aa6c340fdd95cbd74833662f4c3a80f19dfa30))
 
 ## [0.4.4](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.4.3...v0.4.4) (2025-08-22)
 
@@ -61,14 +98,14 @@ labels: ["Reference"]
 
 ### 其他杂项
 
-* 发布 0.4.3 版本 ([f37ac7c](https://github.com/AIGNE-io/aigne-doc-smith/commit/f37ac7cd1fd129d8e3019cc7e952a0cf7dcb3db7))
+* 发布 0.4.3 ([f37ac7c](https://github.com/AIGNE-io/aigne-doc-smith/commit/f37ac7cd1fd129d8e3019cc7e952a0cf7dcb3db7))
 
 ## [0.4.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.4.1...v0.4.2) (2025-08-21)
 
 
 ### 其他杂项
 
-* 发布 0.4.2 版本 ([9e36cf6](https://github.com/AIGNE-io/aigne-doc-smith/commit/9e36cf678ac51a0f4e7b3c19e4b5248e42b80437))
+* 发布 0.4.2 ([9e36cf6](https://github.com/AIGNE-io/aigne-doc-smith/commit/9e36cf678ac51a0f4e7b3c19e4b5248e42b80437))
 
 ## [0.4.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.4.0...v0.4.1) (2025-08-21)
 
@@ -89,14 +126,14 @@ labels: ["Reference"]
 
 ### 错误修复
 
-* 优化加载源的模式 ([#48](https://github.com/AIGNE-io/aigne-doc-smith/issues/48)) ([5f83b91](https://github.com/AIGNE-io/aigne-doc-smith/commit/5f83b917ea6779ba79418e3ff2490eb692c3e48a))
+* 优化加载源模式 ([#48](https://github.com/AIGNE-io/aigne-doc-smith/issues/48)) ([5f83b91](https://github.com/AIGNE-io/aigne-doc-smith/commit/5f83b917ea6779ba79418e3ff2490eb692c3e48a))
 
 ## [0.3.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.11...v0.3.0) (2025-08-19)
 
 
 ### 功能
 
-* **core:** 优化生成上下文收集工作流 ([#46](https://github.com/AIGNE-io/aigne-doc-smith/issues/46)) ([687d06a](https://github.com/AIGNE-io/aigne-doc-smith/commit/687d06afd648e0e697d25e85dcc841b17c3c311c))
+* **核心：**优化生成上下文收集工作流 ([#46](https://github.com/AIGNE-io/aigne-doc-smith/issues/46)) ([687d06a](https://github.com/AIGNE-io/aigne-doc-smith/commit/687d06afd648e0e697d25e85dcc841b17c3c311c))
 
 
 ### 错误修复
@@ -129,7 +166,7 @@ labels: ["Reference"]
 
 ### 其他杂项
 
-* 发布 0.2.8 版本 ([da19bc0](https://github.com/AIGNE-io/aigne-doc-smith/commit/da19bc0b2c6c4e5fddaff84b4fa85c9d495b3ba0))
+* 发布 0.2.8 ([da19bc0](https://github.com/AIGNE-io/aigne-doc-smith/commit/da19bc0b2c6c4e5fddaff84b4fa85c9d495b3ba0))
 
 ## [0.2.7](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.6...v0.2.7) (2025-08-12)
 
@@ -141,28 +178,28 @@ labels: ["Reference"]
 
 ### 其他杂项
 
-* 发布 0.2.7 版本 ([3b807fe](https://github.com/AIGNE-io/aigne-doc-smith/commit/3b807fed833a5160931747bce37aac00cf11d9ac))
+* 发布 0.2.7 ([3b807fe](https://github.com/AIGNE-io/aigne-doc-smith/commit/3b807fed833a5160931747bce37aac00cf11d9ac))
 
 ## [0.2.6](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.5...v0.2.6) (2025-08-12)
 
 
 ### 其他杂项
 
-* 发布 0.2.6 版本 ([c5b5ea5](https://github.com/AIGNE-io/aigne-doc-smith/commit/c5b5ea5c404d44f3b0d420f0b57e4ae64ae5d624))
+* 发布 0.2.6 ([c5b5ea5](https://github.com/AIGNE-io/aigne-doc-smith/commit/c5b5ea5c404d44f3b0d420f0b57e4ae64ae5d624))
 
 ## [0.2.5](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.4...v0.2.5) (2025-08-08)
 
 
 ### 错误修复
 
-* 优化 cli 流程 ([#17](https://github.com/AIGNE-io/aigne-doc-smith/issues/17)) ([4c94263](https://github.com/AIGNE-io/aigne-doc-smith/commit/4c9426378dff9ca3270bd0e455aa6fb1045f6abb))
+* 优化 CLI 流程 ([#17](https://github.com/AIGNE-io/aigne-doc-smith/issues/17)) ([4c94263](https://github.com/AIGNE-io/aigne-doc-smith/commit/4c9426378dff9ca3270bd0e455aa6fb1045f6abb))
 
 ## [0.2.4](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.3...v0.2.4) (2025-08-07)
 
 
 ### 错误修复
 
-* 优化 agent 输出日志 ([40a2451](https://github.com/AIGNE-io/aigne-doc-smith/commit/40a245122ce4d8747e5b5dbe88be6986047c38ae))
+* 优化 Agent 输出日志 ([40a2451](https://github.com/AIGNE-io/aigne-doc-smith/commit/40a245122ce4d8747e5b5dbe88be6986047c38ae))
 
 ## [0.2.3](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.2...v0.2.3) (2025-08-07)
 
@@ -176,21 +213,21 @@ labels: ["Reference"]
 
 ### 其他杂项
 
-* 发布 0.2.2 版本 ([c3fb52a](https://github.com/AIGNE-io/aigne-doc-smith/commit/c3fb52a78b95676e1c13361b30ebec2914a89fa8))
+* 发布 0.2.2 ([c3fb52a](https://github.com/AIGNE-io/aigne-doc-smith/commit/c3fb52a78b95676e1c13361b30ebec2914a89fa8))
 
 ## [0.2.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.2.0...v0.2.1) (2025-08-06)
 
 
 ### 其他杂项
 
-* 发布 0.2.1 版本 ([e3a39ae](https://github.com/AIGNE-io/aigne-doc-smith/commit/e3a39aedcee129deae424e96942f9798b9191663))
+* 发布 0.2.1 ([e3a39ae](https://github.com/AIGNE-io/aigne-doc-smith/commit/e3a39aedcee129deae424e96942f9798b9191663))
 
 ## [0.2.0](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.1.4...v0.2.0) (2025-08-05)
 
 
 ### 功能
 
-* 支持调用 agents 时自动初始化配置 ([24d29db](https://github.com/AIGNE-io/aigne-doc-smith/commit/24d29db4dd86709750aa22ff649e7dacc4124126))
+* 支持调用 Agent 时自动初始化配置 ([24d29db](https://github.com/AIGNE-io/aigne-doc-smith/commit/24d29db4dd86709750aa22ff649e7dacc4124126))
 * 源文件变更时更新文档 ([#9](https://github.com/AIGNE-io/aigne-doc-smith/issues/9)) ([4adcecf](https://github.com/AIGNE-io/aigne-doc-smith/commit/4adcecfb32e72c9e88d0b0bd8ce0a91022847ca7))
 
 ## [0.1.4](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.1.3...v0.1.4) (2025-08-04)
@@ -198,14 +235,14 @@ labels: ["Reference"]
 
 ### 其他杂项
 
-* 发布 0.1.4 版本 ([4122cf5](https://github.com/AIGNE-io/aigne-doc-smith/commit/4122cf5cc0285bef2b96803f393e744121d22acf))
+* 发布 0.1.4 ([4122cf5](https://github.com/AIGNE-io/aigne-doc-smith/commit/4122cf5cc0285bef2b96803f393e744121d22acf))
 
 ## [0.1.3](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.1.2...v0.1.3) (2025-08-04)
 
 
 ### 错误修复
 
-* 从 options.context 访问 agents，而不是加载新的 aigne 实例 ([#6](https://github.com/AIGNE-io/aigne-doc-smith/issues/6)) ([0e7ce1d](https://github.com/AIGNE-io/aigne-doc-smith/commit/0e7ce1d3889aab435b029a511cb7ebdbb213ab8a))
+* 从 options.context 访问 Agent，而不是加载新的 AIGNE 实例 ([#6](https://github.com/AIGNE-io/aigne-doc-smith/issues/6)) ([0e7ce1d](https://github.com/AIGNE-io/aigne-doc-smith/commit/0e7ce1d3889aab435b029a511cb7ebdbb213ab8a))
 
 ## [0.1.2](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.1.1...v0.1.2) (2025-08-01)
 
@@ -219,7 +256,7 @@ labels: ["Reference"]
 
 ### 错误修复
 
-* agent 添加别名 ([7e25014](https://github.com/AIGNE-io/aigne-doc-smith/commit/7e250147309849fe0f4cc554077134d2e443d344))
+* Agent 添加别名 ([7e25014](https://github.com/AIGNE-io/aigne-doc-smith/commit/7e250147309849fe0f4cc554077134d2e443d344))
 * docs mcp 添加文档搜索 ([de96e0e](https://github.com/AIGNE-io/aigne-doc-smith/commit/de96e0e08455831dc6918d5fbc59d38b6a921373))
 * 优化代码 ([8cb0a5c](https://github.com/AIGNE-io/aigne-doc-smith/commit/8cb0a5ce67cf009c672b2fb1aa9b89ef6d965a86))
 
@@ -228,33 +265,33 @@ labels: ["Reference"]
 
 ### 功能
 
-* 为 mcp 服务器和 cli 添加入口 agents ([fa85d65](https://github.com/AIGNE-io/aigne-doc-smith/commit/fa85d651e8dc723e2b97150fc2258b115c6c5bb0))
+* 为 mcp 服务器和 CLI 添加入口 Agent ([fa85d65](https://github.com/AIGNE-io/aigne-doc-smith/commit/fa85d651e8dc723e2b97150fc2258b115c6c5bb0))
 
 
 ### 错误修复
 
 * 优化命令参数 ([#3](https://github.com/AIGNE-io/aigne-doc-smith/issues/3)) ([003f6b8](https://github.com/AIGNE-io/aigne-doc-smith/commit/003f6b8ae2c9e1af55ba1841458fa8567a0eb2f0))
-* 优化 docs mcp agent ([8654cd4](https://github.com/AIGNE-io/aigne-doc-smith/commit/8654cd4ea38034f3af0244f56b27acf66ba704e1))
+* 优化 docs mcp Agent ([8654cd4](https://github.com/AIGNE-io/aigne-doc-smith/commit/8654cd4ea38034f3af0244f56b27acf66ba704e1))
 
 ## 0.0.2 (2025-07-30)
 
 
 ### 功能
 
-* 新增自动创建看板 ([3ff06ad](https://github.com/AIGNE-io/aigne-doc-smith/commit/3ff06ad0241e208b09bcf828c52c2c5051c67ef8))
-* 新增 docs-mcp ([a7508a1](https://github.com/AIGNE-io/aigne-doc-smith/commit/a7508a13abb2222968b1bc9c14948427af509f97))
-* 新增 input generator agent ([20c01bb](https://github.com/AIGNE-io/aigne-doc-smith/commit/20c01bbca6d6f9414695071fc907bd7cf43d7f62))
-* 新增发布文档功能 ([41bb126](https://github.com/AIGNE-io/aigne-doc-smith/commit/41bb126caeb1c3c242c7a2be27abb114aeab9953))
-* 新增对文档标签的支持 ([4522c07](https://github.com/AIGNE-io/aigne-doc-smith/commit/4522c07b1ceb05664a1f5b5fb4df06feee536eba))
-* 详情添加审查功能 ([8f1aa4f](https://github.com/AIGNE-io/aigne-doc-smith/commit/8f1aa4f22e2d2e590d7aa37288c2e1ee7ea48f07))
+* 添加自动创建看板 ([3ff06ad](https://github.com/AIGNE-io/aigne-doc-smith/commit/3ff06ad0241e208b09bcf828c52c2c5051c67ef8))
+* 添加 docs-mcp ([a7508a1](https://github.com/AIGNE-io/aigne-doc-smith/commit/a7508a13abb2222968b1bc9c14948427af509f97))
+* 添加输入生成器 Agent ([20c01bb](https://github.com/AIGNE-io/aigne-doc-smith/commit/20c01bbca6d6f9414695071fc907bd7cf43d7f62))
+* 添加发布文档功能 ([41bb126](https://github.com/AIGNE-io/aigne-doc-smith/commit/41bb126caeb1c3c242c7a2be27abb114aeab9953))
+* 添加对文档标签的支持 ([4522c07](https://github.com/AIGNE-io/aigne-doc-smith/commit/4522c07b1ceb05664a1f5b5fb4df06feee536eba))
+* 详情添加审查 ([8f1aa4f](https://github.com/AIGNE-io/aigne-doc-smith/commit/8f1aa4f22e2d2e590d7aa37288c2e1ee7ea48f07))
 * 初始提交 ([dafc40e](https://github.com/AIGNE-io/aigne-doc-smith/commit/dafc40e94f3c407e50b2c46ecb46237f23a15cf7))
-* 结构规划添加审查功能 ([b56e83e](https://github.com/AIGNE-io/aigne-doc-smith/commit/b56e83e558f509302b422205f30e9b2adb42d452))
+* 结构规划添加审查 ([b56e83e](https://github.com/AIGNE-io/aigne-doc-smith/commit/b56e83e558f509302b422205f30e9b2adb42d452))
 
 
 ### 错误修复
 
-* 优化 agent 名称 ([25875a0](https://github.com/AIGNE-io/aigne-doc-smith/commit/25875a0688ebbca71f6c25bf4bd5246361f3dd2d))
-* 优化 agent 参数和描述 ([290eb24](https://github.com/AIGNE-io/aigne-doc-smith/commit/290eb240ce986b0f1f406bf42824ce1235df11e5))
+* 优化 Agent 名称 ([25875a0](https://github.com/AIGNE-io/aigne-doc-smith/commit/25875a0688ebbca71f6c25bf4bd5246361f3dd2d))
+* 优化 Agent 参数和描述 ([290eb24](https://github.com/AIGNE-io/aigne-doc-smith/commit/290eb240ce986b0f1f406bf42824ce1235df11e5))
 * 优化代码 ([34f9a24](https://github.com/AIGNE-io/aigne-doc-smith/commit/34f9a24fc3748b4177cad2b5330fe6b3ccd99175))
 * 优化代码 ([0343486](https://github.com/AIGNE-io/aigne-doc-smith/commit/0343486aa086bbe2ced8de849de6a4a42567719c))
 * 优化代码 ([7b7dfb9](https://github.com/AIGNE-io/aigne-doc-smith/commit/7b7dfb925b3aa55956ef7a99ededc749fb6a42d7))
@@ -262,11 +299,11 @@ labels: ["Reference"]
 * 优化代码 ([74fee51](https://github.com/AIGNE-io/aigne-doc-smith/commit/74fee51ad6337af8811a35f2a4334b67ec109439))
 * 优化代码 ([7fa1675](https://github.com/AIGNE-io/aigne-doc-smith/commit/7fa1675b2cab6144d1fb9d4388130209c6cfa0bc))
 * 优化文档审查 ([70374ab](https://github.com/AIGNE-io/aigne-doc-smith/commit/70374abed74946eafa7b0f87331c2e496fa61592))
-* 优化 input generator agent ([ae908bb](https://github.com/AIGNE-io/aigne-doc-smith/commit/ae908bbc0cb98b9b196e8b08f23149e5693e0abe))
+* 优化输入生成器 Agent ([ae908bb](https://github.com/AIGNE-io/aigne-doc-smith/commit/ae908bbc0cb98b9b196e8b08f23149e5693e0abe))
 * 优化结构规划 ([3a0a196](https://github.com/AIGNE-io/aigne-doc-smith/commit/3a0a196a97196ba445c4709d3466ff355917ac53))
 * 保存文档时移除无用文档 ([bec5ba3](https://github.com/AIGNE-io/aigne-doc-smith/commit/bec5ba3afd462c990a0aa813bbe38ce9a61363ee))
 
 
 ### 其他杂项
 
-* 发布 0.0.2 版本 ([73bf26a](https://github.com/AIGNE-io/aigne-doc-smith/commit/73bf26a5c55fa4726d866cff64bd48d1ca37a3b3))
+* 发布 0.0.2 ([73bf26a](https://github.com/AIGNE-io/aigne-doc-smith/commit/73bf26a5c55fa4726d866cff64bd48d1ca37a3b3))