科研架构图
把「一段研究逻辑」变成「一张能投出去的结构图」。默认产物是手写 SVG + 同名 PNG,因为中文小字只有矢量文本才不糊、可改、可复现——AI 生图在中文标签上不可靠。
技能沉淀自 150 张中文核心期刊架构图的逐张仿绘与验收。规范是三样东西:模板资产(37 个成品骨架,全部取自仿绘)、布局公式(坐标怎么算)、质检门禁(lint_svg.py 拦住零长度箭头、文字出框、白底缺角等已知翻车)。
三条不变式
改动任何模板之前先记住这三条,它们是处理未列举场景的推理依据。
- 结构先于美化。 先把「层级/流向/闭环/对照」定死,再谈配色。原图的骨架、层次、箭头方向必须还原;配色与对齐按本技能统一。不为好看改语义。
- 标签忠实原文。 术语、编号、英文缩写、型号等标注照抄,不换同义词、不合并。只修明显错别字;每个词都要能在原图或提纲里找到出处。
- 一图一主题。 顶层实体超过 8 个先分组,嵌套超过两层考虑拆图。宁可少画一个模块,不把图塞成文字墙。
三种入口
| 入口 | 输入 | 做法 |
|---|---|---|
| 仿绘 | 原图(截图/PDF) | 判读结构 → 选模板 → 逐模块还原文字与层级;不重排原图逻辑,只统一风格 |
| 新绘 | 描述、提纲、小节 | 先写「一句话重点」→ 抽实体与关系 → 归入结构族 → 从模板起步 |
| 改图 | 已有 SVG | 只改文字/增删模块 → 位置按等分公式重算,不局部挪动 |
新绘时只给一串名词的,先补关系(谁作用于谁、谁包含谁、先后),否则只是"词摆成框"。
六步工作流
- 判读结构:数层数、数环节、看箭头方向、找闭环。结构模糊时按「层级→流程→闭环→矩阵」试归族。
- 选模板:查路由表,从 assets/templates/index.json 取骨架;拿不准读 references/template-catalog.md。
- 定画布:按原图宽高比取整,常用 1200×800 / 1000×700 / 1400×500;四周留白 ≥40px;新增/改动的元素落在 8px 网格(模板既有坐标是语料原样,豁免)。图题不画进图内。
- 算布局:用 references/layout-recipes.md 的公式算等分、层带、居中基线,不要目测。文字先估宽再决定框宽。
- 写 SVG:复制模板,逐块替换文字与坐标;特殊图元从 references/svg-cookbook.md 粘。
- 渲染 + 质检:
render_svg.py出 PNG,lint_svg.py跑静态检查,按「七项质检」目检。修完重跑,最多 3 轮。
结构路由表
| 结构族 | 原图信号 | 模板 | 硬约束 |
|---|---|---|---|
| 层级/分层 | 横向层带、技术分层 | TP01 TP06 TP11 TP12 TP13 TP25 | 层 ≤6,每层 ≤6 模块 |
| 关系/机制 | 因果链、支撑树、治理关系、潜变量路径 | TP02 TP03 TP07 TP10 TP14 TP17 TP27 TP29 TP31 | 中心辐射 ≤8 条 |
| 流程/闭环 | 循环、闭环、反馈、阶段推进 | TP04 TP05 TP19 TP20 TP21 TP22 TP23 | 环上 3–6 节点 |
| 分解 | 总—分、功能树 | TP09 TP24 | 树 ≤3 级 |
| 评价 | 指标体系、评估流程 | TP08 TP18 | 维度 3–8 |
| 结构/其他 | 矩阵、总线、关系网、集群、拓扑、多域 | TP15 TP16 TP26 TP28 TP30 TP32 TP33 TP34 TP35 TP36 TP37 | 同层等距 |
每个模板的骨架与改法见 references/template-catalog.md 总表。
结构族不互斥:常见「上层分层 + 下层流程」,按主叙事选主模板,次结构用背景带承载。
设计令牌
| 项 | 值 |
|---|---|
| 画布 | 白底 #FFFFFF;按原图比例取整;留白 ≥40px;8px 网格 |
| 字体 | Noto Sans CJK SC, sans-serif(根 <svg> 声明一次,不写 <style>) |
| 字号 | 一级标题 16/700;模块标题 14–15/700;框内正文 13/400;注释 11/400 #666666 |
| 文字色 | 默认 #1A1A1A;深色底用 #FFFFFF |
| 圆角 | 普通框 rx=6;背景带 rx=10;胶囊/药丸 rx=高/2 |
| 描边 | 默认 1.5;强调框 2;次级连线 1.2–1.3 |
| 虚线 | 边界/可选框 6 3;弱关联/反馈箭头 5 4 |
| 间距 | 同层横向 24、纵向 20;层间 40 为公式缺省,套模板以该模板实测坐标为准 |
语义色板(每张图主色 ≤4 种,同层同色):
| 语义 | 主色 | 浅底 |
|---|---|---|
| 核心/主结构 | #2F6BB0 | #EEF4FB |
| 次级/一般模块 | #4A86C5 | #F4F8FD |
| 关键节点/输出 | #E8833A | #FDF3EA |
| 结果/成效 | #3E9B6C | #EDF7F2 |
| 问题/约束 | #C94F44 | #FBF0EF |
| 中性/背景带 | #8A94A6 | #F3F5F8 |
背景带用低透明度而不是实色:fill="#2F6BB0" fill-opacity="0.06"。完整色值与例外(深底反白、语义紫 #7B5EA7)见 references/style-spec.md。
布局计算
不要目测坐标,按公式算。完整配方(层带、树形、泳道、环形)见 references/layout-recipes.md;竖排与长英文标签的排法见 references/style-spec.md。
- 等分模块宽:
w = (内容区宽 - 间距 × (n-1)) / n,x_i = 左边界 + i × (w + 间距)。 - 层带内容区:
内左 = 带.x + 24,内宽 = 带.w - 48,模块高 72,模块顶带.y + 56(+56 是公式缺省,各模板实测不同,套模板以实测为准)。 - 框内文字垂直居中:单行基线
y = 框.y + 框.h/2 + 0.35 × 字号;两行时两基线围绕中心对称,行距 ≥1.5×字号。 - 文本宽度估算:中文/全角 ≈ 1.0×字号,大写字母 ≈ 0.72×(W/M 0.9×),小写与数字 ≈ 0.55×,空格 0.3×;中文字串里的
·、希腊字母等歧义宽字符按全角算。超过框宽 90% 必须用<tspan>手动换行——宁多一行,不挤一行。
连线与箭头
- 语义:实线 = 直接影响/主流程;虚线
5 4= 弱关联/反馈/间接影响;粗箭头/块箭头 = 支撑或资源流;双向 marker = 相互影响。 - 颜色:默认
#5A6B7E;主流程可用#2F6BB0;与框同色时箭头跟随该语义色。 - marker 规范值(全库通用,直接复用):
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7"
orient="auto-start-reverse">
<path d="M0,0 L10,5 L0,10 z" fill="#5A6B7E"/>
</marker>
- 正交优先:用
H/V或水平/竖直线段,拐点落在元素中线;禁止斜线穿越其他框。语义确为"作用于"的短斜箭头可以保留,但不许压到别的模块上。 - 箭头起止于框边线,允许留 0–4px 防 marker 压线;同一张图内保持一致。
- 连线标签 11px,放线段中点上方 4px,必要时垫白底。
七项质检
任何一项不过就回第 5 步。多数项 lint 有对应检查(图题仅识别「图N/Fig」前缀,重心靠目检);catalog 注明「原图设计」的既有 WARN(TP32–TP35、贴边 8px 组)豁免,不返工。最终以渲染 PNG 目检为准。
- 文字压框线 / 出框 / 断字
- 行距过挤(< 1.4×字号)
- 同层模块不等高或间距不一致
- 箭头穿越其他图元
- 分组框与成员框间距 < 12px
- 图面重心偏移(一侧大片留白)
- 图题被画进图内
脚本
# 1) 静态质检:XML/marker/零长度箭头/白底覆盖/出框/行距/互压/穿框/同层/贴边/调色板
python3 scripts/lint_svg.py <svg文件或目录>
python3 scripts/lint_svg.py <目录> --json # 机器可读,批量汇总
python3 scripts/lint_svg.py --self-test # 确认检查规则本身会报错
# 2) 渲染 PNG + 拼版总览
python3 scripts/render_svg.py <svg文件或目录> --scale 2
python3 scripts/render_svg.py assets/templates --sheet /tmp/sheet.png
退出码:0 干净、1 有 FAIL(不要交付)、2 仅有 WARN。WARN 是估算不是判决,以渲染 PNG 为准。
批量模式
模板先保证量与合规,子代理再保证还原度。
- 按结构族轮转套模板,程序化生成合规 SVG。
- 拆给子代理对照原图精修,每人 4–5 张。
- 全部过 lint + render,抽检 20%,不合格整批全查。
交付
默认交付同名 .svg + .png(2 倍缩放)。渲染图和原图并排看一遍,缺陷与修法见 references/qc-checklist.md 对照表。
Reference Map
- references/style-spec.md——完整色值、字号阶梯、阈值与边界情况。
- references/template-catalog.md——37 个成品模板的总表:来源、骨架、改法与已知偏差。
- references/svg-cookbook.md——21 组可粘贴片段(marker/背景带/胶囊/竖排/多行 tspan)。
- references/layout-recipes.md——7 族坐标公式与算例,含等分与居中校验。
- references/corpus-index.md——150 张仿绘按结构归类的索引,找原型用。
- references/qc-checklist.md——交付清单、缺陷对照、批量抽检与验收话术。
验证清单
- 结构族判定有依据,模板选型与原图逻辑一致
- 原图标签全在图上,术语未改写
- 新增/改动的坐标落在 8px 网格(模板既有坐标豁免),同层等高、等距
- 文字不超过框宽 90%,行距 ≥1.5×字号
- 箭头不穿框,线型语义正确
-
lint_svg.py无 FAIL;WARN 已逐条确认 - 渲染 PNG 目检三项通过(字号 / 位置 / 文字与边框,见 qc-checklist)
- 图内无图题,四周留白 ≥40px