排版与信息架构规范
同一屏里 5 套强调系统全部同级(emoji / 彩色胶囊 / 加粗 / 行内代码 / 超链接), 读者无法判断「该看哪里」,于是每一处都在抢注意力 = 处处都不突出。
排版与信息架构规范
本页回答「怎么组织」,不回答「长什么样」。
视觉与交互(字号、颜色、圆角、动效、毛玻璃)见 框架/Apple HIG 排版与交互规范,
那是
.obsidian/snippets/apple-hig.css的唯一口径来源。归属声明(防共写):本页归排版 / 信息架构线;HIG 页归视觉线。
各自单一所有者,需要动对方的内容时只提要求,不直接改。
0 病根与解法
0.1 一句话诊断
同一屏里 5 套强调系统全部同级(emoji / 彩色胶囊 / 加粗 / 行内代码 / 超链接), 读者无法判断「该看哪里」,于是每一处都在抢注意力 = 处处都不突出。
Apple HIG(Typography)把这直接列为设计失败:
"Mixing too many different typefaces can obscure your information hierarchy and hinder
readability, in addition to making an interface feel internally inconsistent or poorly designed."
解法是减法,不是加装饰:每屏只允许一种强调。
0.2 实测基线(2026-10-04,scripts/typo_check.py v1.0 口径)
| 指标 | 基线 | 目标 |
|---|---|---|
| 彩色 pictograph | 200 个 / 23 文件 | 0 |
⚠ 基线时点 = 本规范落盘之前(2026-10-04,
typo_checkv1.0 指纹e0e66faf…)。本页自身不引入任何 pictograph(§3.3 刻意用码位记号),
落盘后 T1 仍为 200,与基线一致;其余规则的命中数会因本页正文而小幅上升,属正常计入。
单色符号字形(→ ✅ ✔ ⚠ ★) | 6784 个 | 允许,按 §2.3 白名单限位 |
|---|---|---|
| 正文段落内 >1 处加粗 | 1209 处 / 188 文件 | 文件数下降(非总数下降) |
| 裸链接墙 | 47 处 / 17 文件 | 0 |
字面量 ** 泄漏 | 2 处 / 2 文件 | 0 |
| 标题内 pictograph | 18 处 / 12 文件 | 0 |
| 判定符号越位 | 149 处 / 46 文件 | 0 |
立论依据(本规范的立论根据): 加粗 10475 处 : wikilink 1324 个 ≈ 8 : 1 ⇒ 能点的东西比被强调的东西少一个数量级 ⇒ 加粗已被当作装饰使用,而非用于引导。
0.3 ⚠ 口径定义(写死,避免各说各话)
| 项 | 定义 |
|---|---|
| 彩色 pictograph | 码位在 U+1F300–1FAFF / U+1F900–1F9FF(渲染成彩色小表情)⇒ 计入违规 |
| 单色符号字形 | → ✅ ✔ ⚠ ★ ─ 等(渲染为文字)⇒ 不计入违规 |
| 扫描范围 | 库根递归,剔除 .git / .obsidian / __pycache__ / scripts / tests / 数据;与 arch_check 的 SKIP_DIRS 完全一致 |
| 冻结区 | 复盘/历史原始记录/(44 份)完全不动,不计入任何规则判定 |
| 计数粒度 | 命中 N = 出现次数(一行内多个各计一次);文件 M = 去重文件数 |
| 代码剥离 | 先剔除整段代码围栏,再逐行剥行内代码,再计数 |
| 规则指纹 | 每次 --baseline 输出 md5(DEFAULT_RULES ∪ state/typo_check_rules.json),让基线可追溯到规则版本 |
⚠ 历史教训:本规范 v0.1–v0.3 期间曾出现「212 个 / 91 篇」这个错误数字——
212 是含代码块的粗数,91 是「含任意 emoji 字形的文件数」,两个口径混用。
权威值 = 200 / 23,以
python3 scripts/typo_check.py --baseline为准。
1 四条通用原则
| # | 原则 | 判定问句 |
|---|---|---|
| P1 | 一屏一强调 | 这一屏最该被看到的是哪一样?其余全部降级。 |
| P2 | 层级靠字号跳跃 + 双色层次 + 可视锚点(v0.4 修订) | 这一屏有没有节奏?留白是让锚点突出,不是留白本身好看。 |
| P3 | 几何线性图标 > 彩色 emoji | 要点缀就用 scripts/apple_style.py 的 8 枚单色图标,不用表情。 |
| P4 | 链接是文字,不是按钮 | 每篇每个 wikilink 都做成玻璃按钮 = 噪音压过层级。 |
⚠ P2 修订记录(v0.4):原表述是「层级靠字号与留白,不靠颜色」——过于单线,
会导向「素到发闷、纯文字单调」的结果,与交易场景不匹配。
用户参照系是 Apple 营销页(不是 Support 支持文档):营销页不是"少即是多",
而是用大标题、双色层次、可视锚点制造节奏。⇒ 修订如上,并新增 §9 视觉锚点规范。
P2 验收法(必须用):截图转黑白,若去色后平淡无结构 ⇒ 靠颜色撑的,不合格。
P3 的 8 枚图标:chart / receipt / sliders / shield / pulse / layers / gauge / clock (24 网格、1.7 笔画、currentColor,随深浅色自动适配)。 ⚠ heading() 只返回片段、不含语法前缀;Markdown 用 section() 拼前缀,HTML 各自拼 <h2>。
2 五类强调元素的可判定规则
2.0 强调预算表(核心)
优先级 1 → 5,同屏只允许 1 号出场;2–5 号同时出现时必须满足降级形态。
| 优先级 | 元素 | 允许的强调 | 每屏上限 | 何时必须降级 |
|---|---|---|---|---|
| 0 | 双色标题的粗体部分(§9 A3) | 粗体引导 + 灰色续写 | 不占正文预算 | — |
| 1 | 章节标题 | 字号 + 字重 600(不用 700) | 每屏 1 个 H1 | — |
| 2 | 状态词(通过/失败/down) | 语义色 + 中性描边胶囊 | 1 组 | 有更重要对象 → 转纯文字 |
| 3 | 关键数字 / 结论 | 加粗 600,全屏 ≤3 处 | 3 | 超过 3 → 只留最重要 3 处 |
| 4 | 行内代码 | 次级色,不加粗不用胶囊 | 不限 | 出现 ≥5 处 → 改代码块 |
| 5 | 超链接 | 文字 + 链接色/下划线,不做玻璃按钮 | 不限 | 高频目标应在首页直达 |
2.1 加粗 **…**
⚠ 不用「全库总数」当判据。理由:总数大头是 scripts/fetch.py::render_snapshot 模板产出的状态列加粗,而历史复盘不得覆盖(红线)——用总数会把「改不动的历史」算成「没收敛」。
| 编号 | 规则 | 可判定性 |
|---|---|---|
| A | 正文段落内 ** ≤1 处/段;列表项内 ≤1 处/项 | ✔ 机器可判(T2) |
| B | 加粗只允许用于「状态词 / 判定结论 / 关键数值」;禁止「把整句变重要」「让某段突出」 | ⚠ 人工抽检 |
| 基线 | 10475 处(原始总数);T2 = 1209 处 / 188 文件。P3 后测文件数下降,非总数 | ✔ |
字重上限 600(apple.com 实测 h1 = 34px/600;700 是廉价感主要来源)。 禁止 Ultralight / Thin / Light。
2.2 行内代码 `…`
- 只装字面量:文件名、字段名、命令、正则、数字口径。
- ✘ 禁止用行内代码表示强调;✘ 禁止把中文散文塞进反引号。
- 样式:次级色,不加粗、无背景胶囊。同一屏 ≥5 处 → 改代码块。
2.3 判定符号白名单
✅ ✔ ✓ ❌ ✘ ⚠ 是单色字形,与 emoji=0 不冲突,但限位。
| 允许(白名单三处) | 禁止 |
|---|---|
| ① 表格的「状态 / 判定 / 结果」列 | 各级标题(含 H1–H4) |
② 门禁 / 闸门 / 验收结论行(如 G1 **PASS**、10/10 ✔) | 正文句子中间 |
| ③ 复盘的结论判定行 | 导航文本、列表项 |
| 纯装饰位置(如「收盘复盘 + 书本图标」这类分类标记) |
分级:
| 级别 | 符号 | 位置 | 实测 |
|---|---|---|---|
| A 结构级 | → ← | 流程 / 映射 / 路径,不限 | 2695 ✔ 全保留 |
| B 判定级 | ✅ ✔ ✓ ❌ ✘ ⚠ | 仅限上表白名单 | 542 |
| C 装饰级 | ★ ☆ ─ │ ├ ▸ | 结构用途不限;纯装饰禁止 | 1004+ |
2.4 超链接与链接墙
- 裸链接墙 = 0:同段落 / 同单元格 wikilink ≥3 个 → ✘(机器可判 T3)
改法:一句话「去 Y」,或拆成表格一行一个。
- 信息气味(NN/g):链接文字自解释。
[[复盘/复盘索引]]✔ 好过点这里。 - 首页 / 分区页入口必须动词短语(见 §5)。
2.5 彩色胶囊 / 玻璃
- Apple 真实做法:中性底 + 语义色描边 + 语义色文字,几乎不用彩色填充。
- 玻璃只属身份层(≈20%):状态胶囊 / 入口卡片 / 主按钮。
判定问句:这个元素需要被点吗?需要 → 身份层;只是被读的 → 正文层。
- ✘ 禁止
color-mix()(本 WebKit 不支持,整条声明失效、胶囊变透明)。
语义色各自带 --tag-bg1 / --tag-bg2 / --tag-edge 字面量。---
3 emoji 规则
3.1 硬规则
- 彩色 pictograph 计数 = 0(机器可判 T1),且重跑
scripts/moc_index.py后不复发。 - 必须从生成器删——只改正文会长回来(上一轮最大教训)。
3.2 源头清单【实测 2026-10-04】
| 位置 | 内容 | 数量 | 处理 |
|---|---|---|---|
scripts/moc_index.py L37–41 | KINDS 硬编码 5 个 pictograph(U+1F4D5/1F4F8/1F305/1F6CC/1F6AB) | 写进 AUTO:INDEX 每个单元格 | P0 必修 |
00 驾驶舱(投资MOC).md | 已被生成器写入的存量 | 114(单文件,占过半) | 随重生成清除 |
复盘/数据治理/数据勘误报告_2026-09-09.md | 存量正文 | 19 | P3 |
框架/模板/排版优化模板.md | 存量 | 10 | P3 |
optimization/报告/全库修复报告_2026-09-12.md | 存量 | 9 | P3 |
图谱导航图.md L90 | 正文中间的导航装饰 | 7 | P3 最高优先 |
分区/02 全库文件地图.md / 数据库说明.md / 图谱配置指南.md 等 | 存量 | 各 4–5 | P3 |
| 其余约 14 份 | 零散 | 合计 200 | P3 |
复盘/历史原始记录/(冻结区 44 份) | — | 0 | 不动 |
⚠ 高优先:正文句子中间的 pictograph——emoji 夹在正文中间是「排版被表情打断」的典型,
是本库最刺眼的一类。已定位到行,见
06-SPEC-DRAFT.md§8.6。
3.3 替换映射(一一对应,不留空)
| 原符号(码位) | 语义 | 替换为 |
|---|---|---|
U+1F4D5 | 收盘复盘 | 文字 + --hig-blue 描边胶囊 |
U+1F4F8 | 收盘数据快照 | 文字 + --hig-teal 描边胶囊 |
U+1F305 | 盘前简报 | 文字 + --hig-orange 描边胶囊 |
U+1F6CC | 非交易日备忘 | 文字 + --hig-gray 描边胶囊 |
U+1F6AB | 数据缺失占位 | 文字 + --hig-red 描边胶囊 |
U+1F7E2/1F7E1/1F7E0/1F534 | 灯号(绿黄橙红) | 去掉色块,用 .st-ok/.st-warn/.st-bad + 文字 |
U+1F4A1/1F3AF/1F6E1/1F578/1F4CA/1F680 | 装饰(灯泡/靶/盾/网/图表/火箭) | 直接删除(或改用 apple_style.py 图标) |
⚠ 本页自身刻意不含 pictograph 字形,否则规范会违反自己的 T1 规则。
上表用码位记号,既保留可查性,又不引入违规字形。
3.4 清理的上下文分支(不是无脑 replace)
同一 emoji 在不同上下文处置方式不同:
| 上下文 | 处置 |
|---|---|
| H2–H4 标题内 | 删除(R2 白名单禁止标题) |
表格「状态/判定」列内的 ✅✔⚠❌ | ✔ 保留(单色字形) |
| 表格内的彩色灯号(绿/黄/橙/红方块) | 去色块,改 .st-ok/.st-warn/.st-bad 类 + 文字 |
| 正文句子中间的 pictograph | 删除或改几何图标(最高优先) |
| 导航 / 分类标记(书本图标 + 收盘复盘) | 删除,改纯文字 + 语义描边胶囊 |
复盘/历史原始记录/ | 跳过,不读不写 |
含 [推断]/[待验证]/[未能复核] 的行 | 跳过整行 |
4 排版规格
4.1 字号阶梯(Apple HIG 原文表,非推断)
| Style | Weight | Size/Leading (pt) | Emphasized | 本库映射 |
|---|---|---|---|---|
| Large Title | Regular | 31/38 | Bold | 页面 H1 |
| Title 1 | Regular | 25/31 | Bold | 章节 H2 |
| Title 2 | Regular | 19/24 | Bold | 小节 H3 |
| Title 3 | Regular | 17/22 | Semibold | H4 |
| Headline | Semibold | 14/19 | Semibold | 表格表头 |
| Body | Regular | 14/19 | Semibold | 正文 |
| Callout | Regular | 13/18 | Semibold | 次要说明 |
| Subhead / Footnote | Regular | 12/16 | Semibold | 脚注 |
| Caption 1/2 | Regular | 11/13 | Semibold | 图注 / 元信息 |
5 条可判定规则
- 强调只有 Bold / Semibold 两种字重,没有第三种。
- 行距随字号变化,非固定倍数:31→1.23、25→1.24、14→1.36、12→1.33、11→1.18。
⇒ 字号越小行距倍数越大(与中文密排需更松行距同原理)。
- 三行以上不得用紧行距(HIG 原文:"If you need to display three or more lines of
text, avoid tight leading even in areas where height is limited.")。
- 宽栏 / 长段落必须加行距(HIG 原文点名 wide columns / long passages)。
- 字号下限 iOS = 11pt。
4.2 中文排版三件套
| 项 | 规范 | 依据 |
|---|---|---|
| 行长 | 正文/列表/引用 max-width: 40em;表格与代码块不受限 | HIG §3 宽度影响行距 |
| 行高 | 中文正文 1.78;西文 1.36 是下限不是上限(HIG Body = 19/14) | HIG 阶梯 |
| 断行 | 表格 word-break: keep-all(CJK 不竖切);首列 nowrap;padding: .5em/.7em | 验收项 |
⚠ 度量陷阱:判定颜色越界必须用绝对通道差 (max−min),别用归一化饱和度 (rgb(21,21,23) 归一化饱和度 8.7%,绝对差仅 2/255 = 1%,肉眼不可见)。 ⚠ JPEG 截图在低亮度区有色度噪点,影响任何颜色测量。
4.3 标题级数与命名
- 上限 H1 → H4,共 4 级;H5+ 一律违规。
- 每篇 H1 恰好 1 个;H2 建议 4–9 个;每个 H2 下 H3 ≤ 12 个。
- 命名:章节 H2 用动词短语或判断句,空标题(
## 一、单独一行)不合格;
复盘文件名必须 YYYY-MM-DD <类型>.md(scripts/review_write.py 唯一口径,日期前缀不可改); 分区页 分区/NN <名称>.md,两位序号固定。
4.4 引用 vs 卡片(判定条件)
引用块(>) | 卡片(.hig-entry / 玻璃) | |
|---|---|---|
| 需要被点 | 否 | 是 |
| 内容性质 | 别人的话、证据原文、规格条文 | 可点击入口、可操作对象 |
| 一屏数量 | 不限 | ≤ 3 |
| 视觉 | 无深色底、无彩色左边线,仅 2px 中性左边线 | 玻璃材质 |
5 首页规范
5.1 必含区块(5–9 个)
依据:六个真实文档站入口页实测(K8s / Vercel / Linear / Stripe / MDN / GOV.UK), 区块数都在 5–9,且先给热门/入门项,再给全量分类。
| # | 区块 | 必须含 |
|---|---|---|
| 1 | 今日状态 | 目标交易日 / G1 / L0 / 数据更新时间(权威 = 驾驶舱自动生成区块) |
| 2 | 高频入口 | 动词短语;Reference 类(复盘)单列一块 |
| 3 | 我要做 X → 去 Y | 高频任务直达(NN/g 第 4 条) |
| 4 | 分区页地图 | 每分区一句话 |
| 5 | 硬规矩 | 改文件前必读 3 条 |
5.2 硬性指标
| 指标 | 值 |
|---|---|
| 行数 | ≤ 150 行 |
| 区块数 | 5–9 个 |
| 入口命名 | 全部动词短语 |
| 「我要做 X」行数 | ≥ 12 行 |
| 声明数 | 与实际文件数一致(否则 arch_check 红) |
5.3 ⛔ 禁用:「3 次点击」
NN/g《The 3-Click Rule for Navigation Is False》原文:该规则 "has not been supported by data in any published studies to date", 被 Joshua Porter 研究 debunked——"user dropoff does not increase when the task involves more than 3 clicks, nor does satisfaction decrease"。
验收改用 NN/g 五条:
- 菜单项有强信息气味(不生僻、不纯品牌词)
- 提供清晰方位指示(当前位置 / 面包屑)
- 避免多层级下拉
- 最重要的检索任务从首页直接给入口
- 控制认知负荷(不要求读长列表、不要求自己判断在结构中的位置)
⚠ 连带清除:全库不得再出现「跳数 / 点击数 / 点击深度 / 3-click」作为指标或字段 (已定位:00 首页 L43 表头、分区/07 可达性矩阵.md 整页)。
5.4 Diátaxis 四类映射(本库文档分层依据)
"There are fundamentally four identifiable kinds of documentation, that respond to four
different needs. The four kinds are: tutorials, how-to guides, reference and explanation."
| Diátaxis | 本库 | |
|---|---|---|
| Tutorials(起点) | 00 首页 | |
| How-to(怎么做) | 框架/技能/ SOP 与提示词 | |
| Reference(查什么) | 复盘/ · 分区/02 全库文件地图 | |
| Explanation(为什么) | 框架/(数据口径定义、终极决策框架) | --- |
6 自检清单(可逐条勾;标 [S] 可脚本化)
每阶段改完立刻跑
python3 scripts/selfcheck.py,不达标不进下一阶段。⚠
typo_check只告警、永不阻断,且不参与all_ok——排版违规是「存量债」不是发布闸门,让它进
all_ok会把发布卡死在存量 pictograph 上。
A. 门控(必跑)
- [ ]
python3 scripts/selfcheck.py→all_ok: true - [ ]
arch_check11/11 |doc_sync_check --strictrc=0(死链 0) - [ ] 改过
SKILL.md⇒ 三处 md5 同步(仓库副本 //var/minis/skills/副本 / 驾驶舱技能行)
B. 排版(抽样 20 篇)
- [ ] B1 彩色 pictograph = 0(不是"少",是 0)〔S〕
- [ ] B2 单屏加粗处数 ≤ 3
- [ ] B3 字重 ≤ 600,无整段 / 整行加粗
- [ ] B4 行内代码只装字面量,无中文散文
- [ ] B5 判定符号只在白名单三处;标题内 = 0;正文散文 = 0 〔S〕
- [ ] B6 行内代码 ≥5 处 → 改代码块
- [ ] B7 表格首列不竖切(
word-break: keep-all) - [ ] B8 表格列数 ≤ 7(超了改列表);首列
nowrap - [ ] B9 同构条目 ≥3 且字段 ≤3 → 列表;需横向对比 ≥3 维 → 表格
C. 链接
- [ ] C1 裸链接墙 = 0(同段落 / 同单元格 wikilink ≥3)〔S〕
- [ ] C2 链接文字有信息气味(无「点这里」)
- [ ] C3 链接是文字,不是玻璃按钮
- [ ] C4 新增 / 移动任何
.md⇒ 驾驶舱文件地图声明数同步 + 至少一条入链
D. 结构
- [ ] D1 H1 恰好 1 个,级数 ≤ H4
- [ ] D2 引用块:无深色底、无彩色左边线,仅 2px 中性左边线
- [ ] D3 玻璃卡片一屏 ≤3,且只用于"需要被点"的对象
- [ ] D4 表格无竖线,hairline 行分隔,表头小一号
- [ ] D5 字面量
**泄漏 = 0;代码围栏配对 〔S〕
E. 首页
- [ ] E1 行数 ≤ 150 | E2 区块数 5–9 | E3 入口全部动词短语
- [ ] E4 「我要做 X → 去 Y」≥12 行,已删除「跳数」列
- [ ] E5 Reference(复盘)单列一块
- [ ] E6 NN/g 五条逐条核对
- [ ] E7 ⛔ 全文不含「3 次点击 / 3-click / 跳数」作为验收标准〔S〕
F. 视觉终审(用户验收法)
- [ ] F1 截图转黑白后结构仍完整(去色后平淡 = 靠颜色撑)
- [ ] F2 环境层绝对通道差 (max−min) 平均 < 8/255
- [ ] F3 底层真的有东西(真实数据曲线 / 内容)
- [ ] F4 before/after 截图对照已提供
- [ ] F5 深色模式为首要优化目标
- [ ] F6 无大面积
filter: blur()/feTurbulence(会卡死渲染器) - [ ] F7 无
color-mix()
F8. 视觉锚点(v0.4 新增,见 §9)
- [ ] F8a 每页超大标题(≥28px)不超过 1 个
- [ ] F8b 每个一级板块都有眉标
- [ ] F8c ≥80% 的板块标题使用双色结构(粗体引导 + 灰色续写)
- [ ] F8d 不存在连续 3 屏纯文字(每 3 屏内 ≥1 个可视锚点)
- [ ] F8e 状态一律用状态点 + 文字,不用彩色 emoji
- [ ] F8f 涨跌使用
▲▼+ 语义色(不是 emoji)
G. 回归防护〔全部 S,见 scripts/typo_check.py〕
| 规则 | 基线(2026-10-04) | 目标 |
|---|---|---|
| T1 彩色 pictograph | 200 / 23 文件 | 0 |
| T2 段落内 >1 处加粗 | 1209 / 188 文件 | 文件数下降 |
| T3 裸链接墙 | 47 / 17 文件 | 0 |
| T4 字面量泄漏 | 2 / 2 文件 | 0 |
| T5 标题内 pictograph | 18 / 12 文件 | 0 |
| T7 判定符号越位 | 149 / 46 文件 | 0 |
重跑:
python3 scripts/typo_check.py --baseline(输出含扫描范围 / 计数粒度 / T1 双口径 / 规则指纹 md5 四行,保证可复现)
⛔ 已移除 T6「多级下拉
[[a\|b]]」(2026-10-04,范畴错误):
[[a|b]]是 Obsidian 的带别名 wikilink,不是「多级下拉菜单」。NN/g 第 3 条讲的是网站导航 UI(避免层级下拉、改用 mega menu),与别名链接毫无关系。
保留它会制造 56 处误报,并教错后来者。
⚠ 写脚本别踩的坑:
doc_sync从快照正则抓目标交易日: <date>,简单值必须裸写,加引号会被判"未指向"。规则配置 JSON 里的
rules_version同样裸写。
7 执行机制
7.1 三层执行(缺一层就会被下一次改动绕过)
| 层 | 载体 | 阻断力 | 归属 |
|---|---|---|---|
| L1 文档 | 本规范 + 框架/Apple HIG 排版与交互规范 | 无——会被绕过 | 排版线 / 视觉线各自单一所有者 |
| L2 自检 | scripts/selfcheck.py(门控三项 + typo_check)+ scripts/typo_check.py | 只告警,永不阻断 | 排版线 |
| L3 生成器 | moc_index.py / fetch.py::render_snapshot | 强——改源头,产物自动合规 | 视觉线 / 排版线 |
核心判断:写在文档里的规则必然被绕过(这是"越改越乱"的机制性原因)。
⇒ 每条规范立项时必须问:它能不能落到 L2 或 L3? 落不上去的,明写"这是人工项"。
7.2 可脚本化率(M 率)—— 本规范的元指标
| 级别 | 含义 | 条目 |
|---|---|---|
| M(机器) | typo_check.py 可 100% 判定 | T1–T5 · T7 · C1 · E7 |
| H(半机器) | 语法可判,语义需限位规则 | 加粗规则 B · 表格列数 · 引用 vs 卡片 |
| A(人工) | 只能抽检 / 看截图 | 灰度去色后结构完整性 · 玻璃用量 · 信息气味 · 认知负荷 |
当前 M 率基线:可判定 11 条 / 已可脚本化 8 条 = 73%(口径见 §0.3)
⚠ M 率只应上升,不应下降:
- 下降即触发复查——说明有人加了新规则却没加检测
- 新加规则若落不到 L2/L3,必须明写"这是人工项",不许混进可判定清单
(否则 M 率虚高,验收时会被假通过)
- 收尾时须重新计算并写入收尾报告
7.3 规则增补的义务(防规范腐化)
新增任何一条规则,同一批次内必须同时给出:
- 可判定问句(人怎么用)
- 脚本判据(机器怎么查),或明确标为"人工项"
- 进
state/typo_check_rules.json的开关名(每条可单独关闭)
⇒ 禁止只写"应该注意 X"这类无法判定的规则。 这是本规范与旧文档最大的区别。
9 视觉锚点规范(v0.4 · 取代原「层级靠留白」单线思路)
参照系是 Apple 营销页(不是 Support 支持文档——那是反面例子)。
营销页不是"少即是多",而是:用大标题、双色层次、可视锚点制造节奏。
9.1 视觉锚点语法
| # | 元素 | 营销页实例 | 本库对应 | 可判定规则 |
|---|---|---|---|---|
| A1 | 眉标 | MacBook Air / Versatility / Color | 板块眉标(指标组名,如 账户 成交 绩效 风控) | 每个一级板块必须有眉标;次级色小字,不带图标 |
| A2 | 超大主标题 | Reimagined iOS. Anything's possible. | 页面主标题 / 关键结论句 | 一页只允许 1 个超大标题(≥28px);其余最高 22px |
| A3 | 双色标题 ⭐ | **Split View multitasking.** Multitasking across… | 见 §9.2 | 每个板块标题必须用双色结构(粗体引导 + 灰色续写) |
| A4 | 可展开行 | Get $35–$885 for your trade-in. ⊕ | 可折叠明细(Obsidian callout) | 超过 5 行的明细块必须可折叠 |
| A5 | 圆点指示 / 色带 | ●○○○○ | 时间轴进度 / regime 色带 | 序列类内容优先用色带,不用文字罗列 |
| A6 | 锚点密度 | 每屏都有东西可看 | 数据墨水 | 连续 3 屏内必须出现 ≥1 个可视锚点 |
9.2 双色标题(A3)落地映射 —— 优先级最高
本轮性价比最高的一条:几乎零成本,立刻打破纯文字单调。
| 内容 | 单调(现状) | 双色标题 |
|---|---|---|
| 账户 | 净值 0.979029 当前空仓 回撤 2.06% | 净值 0.979029,当前空仓。回撤 2.06%,连亏 0 日。 |
| 成交 | 共 5 笔 买 2 卖 3 | 5 笔成交,买 2 卖 3。最近一笔 09-29 止损离场。 |
| 绩效 | Agent -2.06% L1 0.00% 持有 -4.52% | Agent 落后机械基线 2.06pp。样本仅 9 日,不作决策依据。 |
| 风控 | 最大回撤 2.06% 未超限 | 回撤 2.06%,未触及 15% 上限。连续亏损 0 日。 |
| 复盘结论 | 本日无已确认模式 | 无已确认模式。A 未达门槛,C 未达门槛,B 不可判定。 |
规则:板块标题写成一个句子,前半句粗体(结论)、后半句灰色(补充)。 ✘ 禁止写成「XX:YY」这种标签式。
⚠ 灰色部分不得弱化重要信息——它承载的是「限定条件」,读者必须能读到。
9.3 数据墨水:用数据填回删掉装饰留下的空
删 emoji 不是让页面变空。以下是替代物:
| 原来(装饰,要删) | 换成(数据墨水) |
|---|---|
| 书本图标 + 收盘复盘 | 文字 + 计数(如 收盘复盘 · 82) |
✅ 面板 89 行 | 状态点 ● + 数字 + 迷你进度条 ▇▇▇▇▇░░ |
| 净值平铺成一行 | stat tile:标签 / 数值 / ▲▼ 涨跌 / 语义色 |
| 5 日净值文字列罗列 | sparkline ▁▂▃▄▅▆▇█(或内联 SVG) |
| regime 写文字 | ribbon 色带(逐日一条) |
| 表格里只有百分比 | 单元格数据条 ▇▇▇▇░░ + 数值 |
涨跌用 ▲▼ + 语义色 —— 这是内容色不是装饰色,允许且应当使用。
⚠ 字符
▇ ░ ▁▂▃▄▅▆▇█ ● ▲ ▼均为单色字形,不受 §3 的 emoji 规则约束。
9.4 色彩定位(不变,重申)
- 环境层纯中性(大面积,不用彩色光斑)
- 语义色只出现在数值与状态上,且面积小
- 原则:大面积克制 + 小面积精准
9.5 本节验收(已并入 §6 的 F8 组)
见 §6 F8a–F8f 六条。
8 相关文件
- 视觉与交互口径:框架/Apple HIG 排版与交互规范(
.obsidian/snippets/apple-hig.css的唯一来源) - 排版层自检:
scripts/typo_check.py· 规则集state/typo_check_rules.json - 门控自检:
scripts/selfcheck.py·scripts/arch_check.py·scripts/doc_sync_check.py - 图标与设计令牌:
scripts/apple_style.py - 写作口径:框架/技能/reference §2.0
- 导航验收页:分区/07 可达性矩阵(验收自检页,不作为日常入口)
_本页由排版 / 信息架构线维护;规则变更须同步 state/typo_check_rules.json 并重算 M 率。_