diagram-makerlisted
Install: claude install-skill yy5zmb2myf-del/diagram-maker
# Diagram Maker — HTML/CSS 技术配图画图流水线
生成结构清晰、风格统一的中文技术配图(架构图、技术路线图、数据链路图、告警流程图等)。手写 HTML/CSS,不依赖任何画图软件,AI 辅助可一键出图并自动质检。
## 何时用
需要为文档 / 演示 / 竞赛材料画风格统一的技术配图时。
## 视觉语言(统一规范)
- **主色** `#17375E`(深蓝:标题 / 边框 / 标签底色)
- **辅助色** `#7f9cc0`(箭头)、`#3d4f63`(正文)、`#7f8c9b`(副标题)
- **字体** `"Microsoft YaHei","微软雅黑",sans-serif`
- **节点** `border:1.5px solid #17375E; border-radius:8px; background:linear-gradient(180deg,#ffffff 0%,#eef3f9 100%)`
- **层标签胶囊**(可选,标在节点名后)`display:inline-block; font-size:9.5px; background:#e6edf6; border:1px solid #c9d6e8; border-radius:8px`
- **箭头** 横向 `→`(`.arr{font-size:19-20px; color:#7f9cc0; font-weight:bold; width:24px}`),纵向 `↓`;层间双向上/下行用 CSS 三角形(�� templates/arch.html)
- **标题** 居中深蓝 19-20px、`letter-spacing:2px`;**副标题** 浅灰 12px
- 底部可加**深蓝信息条 / 胶囊**总结关键指标
- body 宽度按内容设 960-1020px,四周留白 30-40px
## 工作流(四步)
1. **选模板**:`templates/` 下 `arch.html`=分层架构、`route.html`=横向管线(两行)、`alert.html`=链路+分支+底部指标胶囊;不匹配就按「视觉语言」从零写 HTML
2. **渲染**:`python scripts/render_diagram.py --input 图.html --output 图.png [--width 1200 --height 650]`
3. **质检**:`python scripts/verify_vision.py 图.png` —— 文本模型看不到图,用 DeepSeek 视觉模型逐字转写文字 + 检查重叠 / 截断 / 乱码 / 箭头方向
4. **修正或交付**:有问题 → 改 HTML → 重新渲染;通过 → 交付
## 脚本说明
- `render_diagram.py`:无头 Chrome `--force-device-scale-factor=2` 渲染成 2x 清晰 PNG,再用 PIL 裁白边、报告墨量覆盖(正常约 40-70%)。Chrome 路径自动探测(可用环境变量 `CHROME_PATH` 指定)。**输出目录必须是可写路径**——权限不足(如某些系统桌面目录拒绝访问)时先输出到可写目录再复制。
- `verify_vision.py`:调 DeepSeek 视觉模型 `deepseek-v4-flash-vision-exp`(OpenAI 兼容,图片仅放 user 消息、base64 内联 ≤3