半径按「相对本图最高度数」映射：孤立 ~6 → 本图枢纽 ~48。 * 用相对度数（而非绝对）→ 无论稀疏图还是稠密图（度数都很高）都保持大小对比。

归一：全角数字→半角、去千分位逗号、percent→%、小写。

把 Date 对象规范化为 YYYY-MM-DD 字符串（UTC）；保持其他类型不变。 * 用 UTC 与 operations.ts 的 todayISO()（new Date().toISOString().slice(0,10)）对齐—— * 两边混用时区会导致跨时区下日期来回切换，产

* 把裸 slug 引用转回标准 `[[wiki/.../X#^anchor]]` 形式。 * 这是渲染层兜底——保证即使模型违规也能正确编号 + 显示 + 点击。 * * 不处理代码块/行内 code（先 maskCode 再调本函数；上游 ReactMarkdown 是块级解析， * 这

YAML tags 字段可能是数组或字符串；都规范化为字符串数组。

* 解析 raw md 按锚点切块。简单状态机： * - 首行 "---" 进入 frontmatter 模式，直到下一个 "---" * - body 模式：扫描每一行，行末匹配锚点 → flush 当前 buf 为一个 body block

解析用户指定的扩展名列表

从 pathname 解析 wiki 路径；不是 /page/... 则返回 null

把 raw 文件名去 .md 后缀 + 不带路径前缀，方便 References 区展示

把 ReadableStream<Buffer> 转成行迭代器

根据 ^p-/^t-/^c-/^f- anchor 取出单个 block 原文。 精确锚点未命中时，做一次**哈希容错回收**：按 anchor 末段的 hash6（内容指纹）在全文块里找， 仅当**恰好一个**块命中该 hash6 时才返回它（附 recovered_from）。

根据 anchor 或 title 取出整段 H 段（到下一同级 heading 之前）。

从 tool result 提取路径加入注册表

按关系类型选 Tailwind 颜色 class。 * 与 GraphView 边色规则保持一致——读者在正文里看到的徽章颜色和图谱里看到的边颜色一致。

* 删除带 `#to-be-updated` 的整个尾部块。 * 通常的写法是： * * --- * #to-be-updated 2026-04-22: <说明> * * 把这一段（含前面的 `---` 与空行）整体清掉。 * * 边界处理： * - 跳过围栏代码块（

* 把锚点元素归一到「该参考块的起点元素」。 * * convert.py 把「块级锚点」一律追加到块的**最后一行**，于是渲染后 id 落在块的最后一个 * 子元素上： * - 表格 → 最后一行的某个 `<td>`（经 relocateTableRowAnchors 搬入单元格）

* 决定「高亮哪些元素」。 * * 标题锚点（^h-N → `<h1..6>`）特殊：它只是一行标题，只高亮 `<h>` 会让用户看到「只高亮了 * 标题、下面的小字没高亮」。所以把**标题 + 紧随其后的首个正文块**一起高亮——这恰好与悬浮 * 「章节预览」展示的内容一致（预览也是标题

* Server-rendered hierarchical breadcrumb. * 例：wiki/concepts/transformer.md → wiki / concepts / transformer * * 索引解析（按优先级）： * 1. "wiki" 段（顶层） →

* 把容器还原到 top 像素处。 * * 难点：目标页正文（尤其长篇 markdown）可能还在渲染/长高，此刻直接设 scrollTop * 会被浏览器夹断到当前 scrollHeight。于是：先立即尽力还原一次（内容已缓存时无 * 闪动），随后在内容长高的每一帧持续跟随目标，直到 s

* 把 el 滚到其滚动容器的顶部。 * * 不用 el.scrollIntoView：在多层 overflow 嵌套（如 PageColumns 的 main）下， * 浏览器对"该让谁滚"判断不稳；显式找最近 scroll ancestor 自己算 offset 最可控。

关键词搜索：标题命中 ×5、正文命中 ×1，按总分降序

浅层比较两个 frontmatter 是否同 keyset + 同字段值（忽略顺序）。 * * 比较策略： * - typeof 必须相同——避免 `null` vs `"null"` / `1` vs `"1"` / `true` vs `"true"` * 这种跨类型被

判断文件是否需要（重新）处理。 - .md：检查是否已加锚点 && outline.json 是否存在 - 其他：检查 .md 是否存在、mtime、outline.json 是否存在

* codex 0.13+ 事件 schema（行分隔 JSON）： * {type:"thread.started", thread_id} * {type:"turn.started"} * {type:"item.started"|"item.completed"|"item

把分布卡片的 key 翻译为对应字段的展示文字（type/status/confidence）。 * 如果 i18n 表里没有对应翻译就回退为原 key——保证未来加新字段值不会显示 "undefined"。

卡片内部的类型标签（取代 FILE_COLOR.unknown 的 "?"）

卡片内部的类型标签

同文档 trailing anchor 的上标：从 context 拿编号，渲染 [n] + 点击复制