readable-diagrams
在终端中运行以下命令:
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 用户


