DocSmith 0.9.8 版发布:AI 图表生成与评估能力提升

Pengfei Zhu
Dec 13, 2025 · edited
B
Blogs
cover

AIGNE DocSmith 发布了一个新的 Beta 版,为开发者和团队引入了两项重要的核心功能。

  1. AI图表生成:高效简化专业图表创作,助力文档阅览体验与视觉呈现升级
  2. 增强的评估功能:全局视角评估,提供更全面的质量分析

主要功能#

1. AI 图表生成#

版本要求:此功能需要 AIGNE CLI 1.57.2 或更高版本。请确保您的 CLI 版本符合此要求。

以下是来自 AIGNE DocSmith 文档 的使用示例:

image.png

功能描述#

AI 会自动分析文档内容,判断是否需要插入图表以及插入位置,并根据上下文自动生成对应的架构图、流程图等各类图表。整个过程无需手动指定位置或内容。

核心能力#
  • 根据内容分析,确定图表的恰当位置
  • 根据上下文选择图表类型:流程图、架构图、概念图、序列图、网络图
  • 自动选择视觉风格(现代、标准、手绘、扁平、极简或 3D 风格等)和最佳宽高比
  • 生成符合 Material Design 规范的图表
  • 自动优化图像大小并同步到所有翻译版本的文档中

用法#

目标

命令

通过交互式反馈更新单个文档

aigne doc update

选择包含图表的文档

aigne doc update --diagram

更新所有包含图表的文档

aigne doc update --diagram-all

注意: --diagram--diagram-all 适用于批量操作。对于单个文档,请使用 aigne doc update 命令并进行交互式反馈。


示例:交互式反馈#

当运行 aigne doc update 时,您可以请求特定的图表修改:

Feedback: "Add architecture diagram to the deployment section"
Result: Diagram inserted at identified location, style: modern

Feedback: "Change the flowchart to hand-drawn style"
Result: Chart regenerated with hand-drawn style

Feedback: "Delete the diagram in section 3"
Result: Diagram removed

更新后的图表会自动同步至所有译文文档。

样式示例#

以下列举了一些参考示例,旨在展示适用于各类别的基础样式,并支持用户自定义样式(例如,“3D‑Glass”)。请注意,最终呈现效果将以实际生成图像为准。我们致力于逐步推出更为多样化的增强功能。

overview-diagram-0.jpg

Modern

stand.jpg

Standard

hand-drawn.jpg

Hand-Drawn

anthropomorphic.jpg

Anthropomorphic

flat.jpg

Flat

image (1).jpg

Minimalist

image (1).jpg

3D

image (2).jpg

3D-Glass


2. 增强文档评估#

AIGNE DocSmith 提供了一个专用代理,旨在帮助您了解文档质量。现在,此评估代理能够全面考量整个文档集,而非仅限于单个文件。

Snipaste_2025-12-08_09-56-47.png

分析内容:#
  • 理解每个文档在文档集中的角色和位置
  • 检查文档间的关联性和一致性
  • 识别术语、风格和格式的不一致问题
  • 发现重复内容和缺失的关联
  • 识别文档间的依赖关系问题
  • 建议更好的文档组织结构
评估维度:#

系统在审查文档时会考量以下几个因素,包括:

  • 可读性 — 语言清晰度、语法、拼写
  • 连贯性 — 逻辑流畅、过渡、一致性
  • 内容质量 — 覆盖范围、准确性、可操作性
  • 一致性 — 术语、风格、格式统一
  • 目标对齐 — 内容与目标的一致性
  • 受众契合度 — 目标受众的适用性
  • 知识水平匹配 — 与读者预期的知识水平保持一致

用法#

要开始使用评估器,只需使用以下命令,即可生成一份 .html 格式的报告。

aigne doc evaluate

全局上下文默认启用。系统会收集所有文档内容,运行分析,并生成评估报告。

升级指南#

版本要求#

  • AI 图表生成功能:需要 AIGNE CLI 版本 1.57.2 或更高。
  • 请确保您的 CLI 版本符合要求,否则图表生成功能可能无法按预期运行。

升级步骤#

1. 检查 CLI 版本#

aigne --version

请确认版本至少为 1.57.2。如果版本过低,请先升级 CLI:

npm install -g @aigne/cli@latest
# 或
pnpm add -g @aigne/cli@latest

2. 入门#

  • 图表生成:运行 aigne doc update --diagram 即可开始(需要 CLI 版本 >= 1.57.2)
  • 增强评估:运行 aigne doc evaluate,即可进行全面的全局评估

3. 可选配置#

为了自定义图表样式,请在 aigne.yaml 中添加 diagramming 配置(参见上方使用指南)。

摘要#

版本 0.9.8 新增:

  • AI 图表生成 — 自动创建并排布图表(要求 CLI ≥1.57.2)
  • 增强评估 — 结合全局上下文的跨文档分析

更新您的 CLI,即可使用图表功能。前往 https://docsmith.aigne.io,即刻体验并查看实时文档站点。