跳到主要內容

DocSmith 0.9.8 發佈:增強型 AI 圖表生成與評估

Pengfei Zhu
AIGNEDocSmithProduct Release

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 時,您可以要求對圖表進行特定修改:

javascript
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

stand.jpg

hand-drawn.jpg

anthropomorphic.jpg

flat.jpg

image (1).jpg

image (1).jpg

image (2).jpg

2. 增強型文檔評估

AIGNE DocSmith 提供了一個專門的 Agent,幫助您了解文檔質量。評估 Agent 現在會考量整個文檔集,而不僅僅是單個文件。

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

分析內容:
  • 每個文檔在集合中的角色與定位
  • 文檔間的關聯性與一致性
  • 術語、風格和格式的不一致性
  • 重複內容與缺失的交叉引用
  • 文檔間的依賴問題
  • 文檔組織結構
評估維度:

系統在審閱文檔時會考量多個因素,包括:

  • 可讀性 — 語言清晰度、語法、拼字
  • 連貫性 — 邏輯流暢度、過渡、一致性
  • 內容質量 — 覆蓋範圍、準確性、可操作性
  • 一致性 — 術語、風格、格式統一
  • 目標匹配 — 內容與目標的匹配度
  • 受眾契合度 — 對目標受眾的適用性
  • 知識水平匹配 — 與讀者預期知識儲備的契合度

使用方式

要開始使用評估器,只需使用以下指令,這將生成一份可供閱讀的 .html 報告。

javascript
aigne doc evaluate

全域上下文預設啟用。系統會收集所有文檔內容,執行分析並生成評估報告。

升級指南

版本要求

  • AI 圖表生成功能:需要 AIGNE CLI 版本 >= 1.57.2
  • 請確保您的 CLI 版本符合要求;否則,圖表生成功能可能無法如預期運作。

升級步驟

1. 檢查 CLI 版本

javascript
aigne --version

確保版本 >= 1.57.2。如果版本過低,請先升級 CLI:

javascript
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 體驗並查看即時文檔站點。

本頁涉及

產品

  • AIGNE active

    面向開發者的 agent 開發框架。從命令列建立並執行一個專案,需要細節時再查框架文件。

  • DocSmith superseded

    讓文件跟著它描述的程式碼一起產生和維護,包括多語言版本。這部分工作已併入 ARC;獨立工具不再維護。