DSH Plugins
返回列表
readable-diagrams

readable-diagrams

工作流 更新于 2026.11.02

在终端中运行以下命令:

dsh plugin install bingomu/readable-diagrams

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install bingomu/readable-diagrams,或通过插件市场添加源码仓库 https://github.com/bingomu/readable-diagrams 后重启应用。

插件介绍

很多 diagram 工具能把结构画对,却不保证人一眼能读懂:缺结论标题、阅读顺序或图例时,再漂亮的 SVG 也只是装饰。readable-diagrams 在 Archify 的规范渲染与 diagram-design 的编辑视觉之上,补上「可读性契约」——页面在通过校验前不得交付,必须齐备结论、要点、编号阅读路径、图例与说明,并满足对比度、正交连线和 accent 预算等门槛。

核心流程是一份 JSON 规范对应一页自包含 HTML:内置九种规范驱动类型(架构、流程、状态、序列、时间线、树、分层、柱状、象限),同一套家具与门禁也覆盖折线、散点、Sankey 等手绘图表族。self_check.py 与 comprehension_check.py 两道门禁须同时通过;生成页支持无 JavaScript 的悬停高亮、深浅色与 CJK 排版,并可从 Mermaid、draw.io、Excalidraw 导入,导出 SVG 与 PNG。

适合需要在文档、评审或 Agent 工作流里交付「可被人类快速理解」的图,而不是只交一张结构正确的图的人——技术写作者、架构说明、产品流程与任何把 diagram 当沟通媒介的团队都会用得顺手。

截图预览

使用场景

  • 架构评审前把系统关系整理成带阅读路径的单页 HTML
  • 产品或业务流程需要结论标题、图例与编号步骤一并交付
  • Agent 生成 diagram 规范后自动跑双门禁,不合格则改 spec 重渲染

适合人员

  • 需要图表「人能读懂」而非仅结构正确的技术写作者
  • 做架构说明、设计评审的工程师与架构师
  • 在 Harness 等工作流里自动生成并验收 diagram 的 Agent 用户