simplechart
/simplechart
Rysuje diagramy PNG: procesy, mapy myśli, sekwencje, ER i architekturę, a przed oddaniem sprawdza geometrię i piksele.
- Autor
- L-XUN ↗
- Repozytorium
- SimpleChart ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 05.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 7
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Rysuje diagramy PNG: procesy, mapy myśli, sekwencje, ER i architekturę, a przed oddaniem sprawdza geometrię i piksele.
Wyzwalacze z opisu
Oryginalny opis (EN)
把流程、层级、交互顺序、数据关系或系统组成画成一张 PNG 图(流程图 / 思维导图 / 时序图 / ER 图 / 架构图)。先量字再定框、连线走正交端口、白底黑字加语义浅色,出图后自动跑几何与像素自检,自检不通过不算完成。用户说"画个流程图""整理成思维导图""画个时序图""画个 ER 图""表结构怎么设计""画个架构图""系统分几层""谁先谁后""mind map""flowchart""sequence diagram""ER diagram""architecture diagram"时使用。不画 UML 类图、甘特图、部署图、C4 全景图。
Jak działa
- 0. 用 / 不用,以及先定类型
- 1. 五条硬规则
- 2. 开工前先确认(缺就一次问清,别猜)
- 3. 工作流程
- 4. spec.json(唯一输入)
- 5. 默认排版(不用你调,知道就行)
- 6. 自检清单
- 7. 常见问题 → 怎么修
- 8. 产物约定
- 9. 已有示例
Podgląd SKILL.md
---
name: simplechart
description: 把流程、层级、交互顺序、数据关系或系统组成画成一张 PNG 图(流程图 / 思维导图 / 时序图 / ER 图 / 架构图)。先量字再定框、连线走正交端口、白底黑字加语义浅色,出图后自动跑几何与像素自检,自检不通过不算完成。用户说"画个流程图""整理成思维导图""画个时序图""画个 ER 图""表结构怎么设计""画个架构图""系统分几层""谁先谁后""mind map""flowchart""sequence diagram""ER diagram""architecture diagram"时使用。不画 UML 类图、甘特图、部署图、C4 全景图。
whenToUse: 需要把审批链、判断分支、步骤流程、层级结构、交互时序、数据库表关系或系统分层输出成一张能直接贴进文档 / PPT 的 PNG 时。
metadata:
version: 1.3.0
renderer: svg + sharp
font: SimHei (fallback Microsoft YaHei / Noto Sans SC)
types: flowchart / mindmap / sequence / er / arch
---
# simplechart
一句话:**写一份 `spec.json`,用同目录 `scripts/` 里的渲染器出 PNG,自检 PASS 才算画完。**
不要把"怎么画"现场再发明一遍——渲染器已经在这里了。你的工作是**把结构想清楚、把字写好**,不是拼 SVG。
## 0. 用 / 不用,以及**先定类型**
用:审批流、操作步骤、判断分支、故障处理流程、组织结构、知识点拆解、会议决策树、**消息传递与机制时序**、**数据库表关系**、**系统分层与模块组成**。
不用:UML 类图、甘特图、部署图(IP/端口/容器)、C4 全景图——这些硬套本 skill 的符号会画歪。用户要这些时说明一下,别硬画。
### 填 spec 之前,先按下表定 `type`(这一步不要跳)
| 用户说的 | `type` | 接下来必读 |
|---|---|---|
| 流程、审批、步骤、判断走哪一步、故障怎么处理 | `flowchart` | 本文档 §4 + §5,够用 |
| 整理成思维导图、脑图、拆解层级、知识点结构 | `mindmap` | 本文档 §4「思维导图字段」,够用 |
| 谁先谁后、谁调用谁、消息怎么传、机制通路 | `sequence` | **`references/sequence.md`** |
| 数据库设计、表结构、实体关系、一对多/多对多、字段与主键 | `er` | **`references/er.md`** |
| 系统分几层、由哪些模块组成、模块之间怎么依赖 | `arch` | **`references/arch.md`** |
| 判断不出来 | — | **先问用户一句**,别猜着画 |
**read reference 是硬要求,不是建议**:`sequence` 是 `actors` + `messages`,`er` 是 `entities` + `relations`,`arch` 是 `layers` + `links`,都不是 `nodes` + `edges`。没读就写,`render.mjs` 会直接报字段缺失;这不是提醒,是跑不通。
## 1. 五条硬规则
1. **先量文字,再定框。** 已由渲染器保证;不要手写 `w` / `h` 去压框,压小了自检会 FAIL。
2. **连线只能贴在框边,其余部分不得与任何框相交**(净距 ≥ 4px)。穿框 = 自检 FAIL。
3. **判断(菱形)必须有 ≥ 2 个出口,每条出口必须标条件**(是 / 否 / 具体条件)。
4. **一图一个开始;开始无入边、结束无出边;除结束外每个节点都要有出边。**
5. **出图后必须跑自检**;FAIL 就改 spec 重跑,**不许手改 PNG / SVG 去糊**。
> 第 2~4 条只针对流程图;时序图、ER 图、架构图的对应规则在各自的 reference 里。
## 2. 开工前先确认(缺就一次问清,别猜)
- 图类型:流程图 / 思维导图
- 节点粒度:一句话一个框?还是几个框?
- 用词:沿用用户原话("直属主管"不要改写成"直线经理")
- 用途:贴文档 / 上 PPT / 打印 → 决定 `--scale`(文档 1x、PPT 与打印 2x)
- 数据来源:用户给的,还是需要检索?**检索来的内容要能说出来源;查不到就写 `[待确认]`,绝不编造数字**
## 3. 工作流程
1. **定类型**:按 §0 的表定 `type`;是 `sequence` 就先读完 `references/sequence.md` 再动手。
2. **理结构**:先想清楚节点与边(或参与者与消息),再落 `spec.json`(格式见第 4 节)。
3. **排网格**:流程图给每个节点一个 `row`(行,从上到下)、`col`(列,从左到右)。主干走 `col: 0`,分支往右放到 `col: 1`。**别让两个节点抢同一个格子。**
4. **出图 + 自检**(脚本在 skill 目录的 `scripts/`,下面路径里的 `<skill>` 换成加载时给出的目录):
```powershell
node "<skill>/scripts/render.mjs" spec.json out.png # 1x
node "<skill>/scripts/render.mjs" spec.json out.png --scale 2 # 2x(PPT/打印)
node "<skill>/scripts/check.mjs" spec.json out.png # 只查不画
```
5. **看图复核**:用 `read_image` 打开产物,看四件事——① 汉字有没有变豆腐块 ② 有没有字贴框线 ③ 有没有线穿框 / 线交叉 ④ 阅读顺序是不是从上到下、从左到右。
6. **交付**:贴图 + 说明产物路径 + 报自检结论;有 `[注意]` 项就直说,不要隐瞒。
## 4. spec.json(唯一输入)
最小可用:
```json
{
"type": "flowchart",
"title": "请假审批流程",
"nodes": [
{ "id": "s", "shape": "start", "text": "提交申请", "row": 0, "col": 0 },
{ "id": "p1", "shape": "process", "text": "直属主管审批", "row": 1, "col": 0 },
{ "id": "d1", "shape": "decision", "text": "≤ 3 天?", "row": 2, "col": 0 },
{ "id": "e1", "shape": "end", "text": "人事备案", "row": 3, "col": 0 },
{ "id": "e2", "shape": "end", "text": "驳回", "row": 3, "col": 1 }
],
"edges": [
{ "from": "s", "to": "p1" },
{ "from": "p1", "to": "d1" },
{ "from": "d1", "to": "e1", "label": "是" },
{ "from": "d1", "to": "e2", "label": "否" }
]
}
```
这段是**语法样本**,不是示例成品:照它抄就不会写错字段。它本身能通过自检(判断双出口、两个结束),可以直接丢给 `render.mjs` 试。
### 流程图字段
| 字段 | 说明 |
|---|---|
| `shape` | `start` 胶囊起 / `end` 胶囊止 / `process` 矩形 / `decision` 菱形 / `io` 平行四边形 / `subprocess` 圆角矩形。也认中文:开始、结束、判断、输入输出、子流程 |
| `text` | 标签。**一个框最多 4 行**;超过就拆节点,别缩字号 |
| `row` / `col` | 网格坐标,整数。不写则 row=序号、col=0 |
| `textWidth` | 可选,换行宽度(默认:普通框 190、判断 118、输入输出 150) |
| `w` / `h` | 可选,强制尺寸。**一般不要用**,用了就要保证装得下字 |
| `edges[].label` | 出口条件。判断节点的每条出边必填,其他边建议不填 |
注意:判断的两个出口要落到不同 `col`,否则两条线会叠在一起。
### 思维导图字段
```json
{
"type": "mindmap",
"title": "刷 B 站的取舍",
"root": { "text": "刷 B 站" },
"branches": [
{ "text": "时间预算", "children": ["午休 20 分钟", "睡前 15 分钟"] },
{ "text": "内容偏好", "children": ["技术 / 硬件", "剪辑与运镜"] }
]
}
```
规则:中心 1 个;主分支 ≥ 2 且**左右交替排**(第 1、3、5 条在右,第 2、4、6 条在左);深度 ≤ 4 层;节点只用矩形;连线不带箭头;每条主分支一套颜色,子层继承。
### 时序图字段
**不在本文档里,去读 `references/sequence.md`。** 它的结构是 `actors` + `messages`,与 `nodes` + `edges` 完全不同;没读就写,渲染器会直接报字段缺失。
### ER 图字段
**不在本文档里,去读 `references/er.md`。** 它的结构是 `entities` + `relations`,字段列表内嵌在实体里。没读就写,渲染器会直接报字段缺失。
### 架构图字段
**不在本文档里,去读 `references/arch.md`。** 它的结构是 `layers` + `links`,模块必须落在层里。没读就写,渲染器会直接报字段缺失。
### 主题(可选)
`"theme": { "bg": "#FFFFFF", "stroke": "#1F2328", "palette": { "process": "#FFFFFF" } }`。
默认值已够用,**不要为了好看加渐变、阴影、3D、装饰图标**。
## 5. 默认排版(不用你调,知道就行)
- 字号 16,行高 1.45,标题 20;框内留白 14×10;行距 56、列距 68;画布外边距 40
- 框线 2px、连线 2px、箭头 9px,全部同色同粗
- 白底、深灰黑字(`#1F2328`)、按语义浅色填充;文字与填充对比度 ≥ 4.5:1
- 连线自动选口:朝空隙大的那条轴出,同侧多条线自动错开;走不通就绕外侧或列间通道
- 拐点默认 ≤ 2 个;回头线走图外侧,不横穿中间
- 时序图:列距 112、参与者框统一高度、消息行距 26、生命线虚线
- ER 图:实体列距 124、行距 78、字段行高 26、基数标签贴两端、关系动词放线的另一侧
- 架构图:层内模块间距 56、层间间距 24、层容器浅底 + 层名、模块可带一行小号技术栈
## 6. 自检清单
脚本查(`check.mjs`):标签非空、起止与分支齐备、判断出口与条件、无孤立/断头节点、框不重叠、线不穿框、端点落在框边、文字按各自形状几何内切不溢出、文字真的落到了像素上、对比度、画布尺寸。
时序图查的是另一套:参与者 ≥ 2、每条消息有标签、重复消息、标签不越界、标签不压参与者框(详见 `references/sequence.md`)。
ER 图查的也是另一套:实体有字段、字段有名字、缺主键(WARN)、字段过多(WARN)、关系动词(WARN)、同一对实体多条关系(WARN)、基数标签不压实体(详见 `references/er.md`)。
架构图:每层有模块、模块必须在自己层内、模块不能连自己、重复连接(WARN)、缺标签(WARN)、单层模块过多(WARN)、**连线不能和模块边框重合**、标签不压模块(详见 `references/arch.md`)。
人眼查(`read_image`):字体是否真的渲染、是否有视觉拥挤、阅读顺序是否顺畅、语义是否和用户说的一致。
**任何一项 FAIL:改 spec 重跑。** 不要用"调一下 JSON 里的 w/h"来掩盖文字放不下的事实——那是该拆节点。
## 7. 常见问题 → 怎么修
| 现象 | 修法 |
|---|---|
| `文字必须完整在框内` FAIL | 删掉手写的 `w`/`h`;或把长标签拆成两个框 |
| `连线不得穿过线框` FAIL | 调 `row`/`col`,把挡路的节点挪开一列;或让目标换一行 |
| `判断的出口必须标条件` FAIL | 给该边补 `"label": "是"` / `"否"` |
| 两条线叠在一起 | 两个出口放到不同 `col`;同侧多线本来会自动错开 |
| 一个字被挤到下一行 | 缩短标签,或调小该节点的 `textWidth` 换个断行点 |
| 图太大放不进一页 | 拆成两张图(主流程 + 子流程展开),别缩字号 |
| 报错 `sequence 需要 actors 数组` | 你在画时序图但写了 `nodes`,去读 `references/sequence.md` |
| 报错 `er 需要 entities 数组` | 你在画 ER 但写了 `nodes`,去读 `references/er.md` |
| `关系必须标两端基数` FAIL | 把 `N` 改成 `1:N`(两端都要) |
| ER 关系线穿过别的实体 | 调 `row`/`col` 挪开挡路的实体;ER 对排布比流程图敏感 |
| 报错 `arch 需要 layers 数组` | 你在画架构图但写了 `nodes`,去读 `references/arch.md` |
| `模块必须落在所在层内` FAIL | 删掉模块上多余的手写定位字段,位置由层自动排 |
| 架构图连线穿过别的模块 | 把目标模块挪到同层另一侧;跨层链路超过 3 条就拆图 |
| 报错 `不支持的 type` | 拼写错了;可用 `flowchart` / `mindmap` / `sequence`,也认中文名 |
| 报错 `没找到 sharp` | 先照常出 SVG(会留在旁边),再按提示用无头 Edge 截图 |
## 8. 产物约定
- 图:`<任务名>.png`(需要 2x 时另存 `-2x.png`)
- 结构:`spec.json`(**必须留**,改图只改它再重渲染,幂等)
- 中间件:`.svg`(调试用,交付时不用给)
- 落盘位置:用户指定优先;没指定就放当前工作目录,**文件名带主题,不要覆盖同名文件**(重名加 `-2`)
- 交付时用 `present` 把 PNG 给出去,并说明 spec.json 的位置
## 9. 已有示例
- `examples/approval-flow/` —— 8 节点审批流(含退回回边、判断双出口)
- `examples/team-mindmap/` —— 15 节点思维导图(左右平衡 + 分支配色)
- `examples/stress-20/` —— 20 节点压力用例(长标签、三条回边),验证排版上限
- `examples/iprgc-sequence/` —— 时序图(蓝光 → ipRGC → SCN → 松果体,含自调用与反馈虚线)
- `examples/shop-er/` —— ER 图(用户 / 订单 / 明细 / SKU / 地址,1:N 关系与基数标注)
- `examples/service-arch/` —— 架构图(4 层 / 9 模块 / 8 条依赖,含跨层链路)
改图最快的路径:复制一个示例的 `spec.json`,改成自己的内容,重渲染。
Pliki w paczce (7)
- .gitattributes 1 KB
- .gitignore 1 KB
- CHANGELOG.md 2 KB
- LICENSE 1 KB
- README.md 6 KB
- SKILL.md 13 KB
- package.json 1 KB
Wersje
W bazie nie ma innych skilli o nazwie simplechart.
Migawka bazy z 13.11.2026 · wersja paczki 491d334d3d91 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100flow-diagram
Tworzy, sprawdza i eksportuje diagramy FlowSVG: schematy przepływu, architektury i sekwencje, także animowane, w JSON, HTML, SVG, PNG lub GIF. - 100mermaid
Tworzy diagramy jako tekst w Mermaid: przepływy, sekwencje, Gantta, ER, klas, mapy myśli i stany, do wklejenia w Markdown, Notion lub GitHub. - 100diagram
Generuje profesjonalne diagramy PNG, HTML lub DSL Mermaid, dobierając typ spośród 29 (przepływy, architektura, sekwencje, ER, Gantt oraz wykresy statystyczne) według jednolitych zasad projektowych. - 95fireworks-tech-graph
Tworzy diagramy techniczne: architektury, przepływy danych, sekwencje i mapy pojęć, eksportując je jako SVG i PNG. - 100fireworks-tech-graph
Renderuje opisane tekstem struktury techniczne jako diagramy SVG i PNG w 14 typach, od architektury i sekwencji po ER i topologię sieci, w 7 stylach wizualnych. - 100mermaid-diagrams
Pisze diagramy tekstowo w Mermaid: przepływy, sekwencje, ER, Gantta i inne, by były czytelne w READMe, PR-ach i dokumentach.