inkstonelisted

# Inkstone — 印刷图表规范 给非程序员用。用户给数据和场合，得到一个可以直接拖进 Word / LaTeX / InDesign 的矢量图。 **和屏幕图表库的根本分野**：这里的约束不是审美偏好，是印刷物理。栏宽由版式决定，中文字号有认读下限，0.35pt 以下的线胶印会断，浅于 L*49 的灰印小字看不清。**这些全部由 `scripts/validate.py` 机器判定，不靠自觉。** --- ## 零、硬约束（违反即返工） 1. **先认准 skill 根目录。** 就是这份 `SKILL.md` 所在的目录（装成 skill 时一般是 `~/.claude/skills/inkstone/`）。**你的工作目录是用户的项目，不是这里**——照字面敲 `python3 scripts/validate.py` 会找不到文件，`from charts.rank_bars import ...` 会 ModuleNotFoundError。出图前先把 skill 根目录放进 `sys.path`： ```python import sys; sys.path.insert(0, "<skill 根目录>") from charts.rank_bars import rank_bars from scripts.render import render ``` 之后所有命令都用它的绝对路径：`python3 <skill 根目录>/scripts/validate.py 你的图.svg`。 **产物写进用户的目录**（`render(svg, "名字", outdir=".")`），不要写回 skill 目录—— 那里是只读的参考实现，不是工作区。 2. **必须从 `catalog.md` 锁定图型编号**，再打开 `charts/` 里对应文件，按 `# ════ 编号 图名 ════` 注释块读实现。不得脱离既有图型另写一个"差不多的"。 3. **一切取值来自 `tokens.py`。** 不在代码里写 hex、写 pt、写字体名。与 token 冲突的取值一律以 token 为准。 4. **宽度必须是 `tokens.COLUMN` 里的某一个值。** 图的宽度由载体决定：期刊单栏 85mm、1.5 栏 114mm、双栏 170mm、A4 正文 156mm、幻灯片 254mm。不存在"我觉得这么宽好看"。五档都有测试覆盖。**图形区高度不要写常数**，用 `T.plot_height(图形区宽度, 档位)`——栏宽差三倍，常数高度会把宽栏图压成扁带。 **整图高度也有上限**（`tokens.PAGE_DEPTH`）：图不能比它要落进去的那一页还高。宽度由栏宽决定，高度由页面决定，两个方向都不是"我觉得多高好看"。超了就拆图 / 换宽栏 / 减类目。 5. **中文字号地板 7.5pt，拉丁 6.0pt。** 装不下的信息删掉或换图型，**不许缩小字号硬塞**——屏幕上 6.5px 的中文标签还能勉强认，印出来是一团墨。 6. **默认全灰。** 彩色需要用户明确要求，见第二点五节。 7. **柱长 ∝ 数值，不断轴。** 极端值的三个诚实做法：让它冲天 / 主图加放大镜小图 / 明说画不下并撕柱不撕轴。 **从零点单向长出来的图（R1 R3 S1 S3 C1 C2）不接受负值，代码强制。** 负值在这些 几何里没有画法