给一对 trigger call+result 跑 mode augment（emit synthetic 事件）

从文本中剥离所有由 add_anchors 添加的锚点尾巴，恢复原始内容。

* 等待 main 容器的 scrollHeight 稳定（连续 N 帧不变），表示 React 渲染 + layout 完成； * 然后回调。避免在元素 *出现* 但页面 *还在长高* 时计算错位置。 * * 兜底：超过 maxFrames 仍未稳定 → 仍调 callback 但通过 on

与 read_block 同口径判断 anchor 是否可解析：精确命中，或 hash6 在该页唯一命中（容错回收）。

write-then-rename 原子写：先写到同目录的临时文件再 os.replace 重命名。 保证别的进程读 target 时只能看到完整旧内容或完整新内容，不会读到半截。 Windows 兼容：当目标文件被另一进程持 read handle（如 web server 正在

返回第一个 H2 (`## `) 行开始的内容；用于跳过 source_summary 顶部元信息块。 没有 H2 时返回原文（fallback：全文扫一遍，可能有少量误报可接受）。

逐行分类：blank / heading / hr / fence / text / fence-mid。

从段落原文提取干净的预览文字：去 markdown 标记、压空白、截 200 字。

提取 md 文件中所有锚点 id（heading + paragraph 等所有类型）。 注意：这是**内联文本扫描**——会把正文里出现的裸锚点文本（如表格里列举的 ^t-2-db7484、 或 [[...]] 引用内部的锚点）也当成"本页锚点"。对 raw 文件没问题（raw

读 raw 的 .outline.json，递归收集所有 heading section 的元信息。 返回 {anchor: {title, level, agent_summary}} 或 None（outline 文件不存在 / 路径越界）。

递归收集旧 outline 中所有非空 agent_summary。 返回 list[{anchor, title, summary}]——供 _restore_summaries 做 anchor → title 多级匹配（pipe-2）。

Brace expansion。 支持：单层 brace，可在同一 pattern 出现多个并列。 wiki/concepts/{rlhf,dpo} → [wiki/concepts/rlhf, wiki/concepts/dpo] {a,b}/{x,y}

检查文本是否含"块级引用"——即足以把论断 ground 到 raw 的引用形式： - [[raw/...]]（任意，有/无 anchor） - 任意带 ^anchor 的 wikilink（[[wiki/sources/X#^p-N-...]] 也算） 其他形式（如 [[w

plain wikilink 目标是否指向同一文件（自链）——自链不应报警。

每行起始字符偏移。lines[i] 起始于 starts[i]。

启发式：看起来像关系类型（用以判断是否要校验白名单）。

把绝对路径转换成相对 base root（workspace 根 / 项目根）的 POSIX 路径， 供 outline.json 的 doc_path 字段使用。

对每个超阈值关系词给具体到「可能偷懒」的方向，避免笼统说『复查』。 落到 7 个关系词各自的语义边界（与 .claude/skills/kb-ingest/SKILL.md 「关系词决策树」对齐）。

目标页**能被 read_block 解析**的锚点集合 + hash6 计数（与 read_block 完全同口径）。 用计算/回填的块锚点（parse_blocks_with_anchors，只认每个块行尾的真实锚点标记）， 而非 _collect_anchors_in_md

解析 sources[] 里的一条字符串（典型如 "[[wiki/sources/X]]" 或 "[[raw/papers/X]]"）， 返回 (target_file_exists, resolved_md_path)。 非 wikilink 字符串（纯文本 caption 等）

把旧摘要写回新 sections，返回回填条数。 pipe-2：先按 anchor 精确匹配；失配再按归一化 title 匹配。heading 锚点形如 `h-{level}-{seq}-{hash}` 含全局 seq，在文档前部插入新段 / 新标题会让后续所有 headi

按逗号 split scope，但忽略 `{}` 内的逗号。 例：'wiki/concepts/*, wiki/entities/{a,b}' → ['wiki/concepts/*', 'wiki/entities/{a,b}']

去掉文本末尾的 `^x-...` 锚点（用于生成 preview / 重生成时识别原标题）。

去掉 // 行注释——避免注释里的 "xxx": 误判为 key。 （i18n.ts 的 value 里不含裸 // ——都是中英文/界面词，安全。）

把 agent_summary 写入对应 section 并保存 .outline.json。 经 load_or_build_outline 取**新鲜**大纲（盘上缓存过期时现场重建）， 再原子写回——保证 annotate 的锚点视图与 `k.py outline` 展示的一

在 system prompt 末尾 append root_index 全文，让 AI 不需要花一轮调 read_page 读它

YAML 字段可能是 "foo"（字符串）或 ["foo", "bar"]（列表）；都规范化为字符串数组。 * 如果用户在 YAML 写 `tags: foo`，python-frontmatter / gray-matter 会给出字符串而非数组—— * 下游 .some(...) / 标

构造 wiki 链接图谱 JSON。 返回 {nodes: [...], edges: [...]} ： - 节点字段 path / title / type / status / tags / inbound_count / outbound_count - 边字

* 取某引用的「论断上下文」们（同 key 可多处出现）。每处：取本引用所在行内、从 * 「上一条引用结束/行首」到「本引用」之间的片段（剥 [[...]] 与表格 |）；为空则退到整行去引用。

收集目录下所有待处理的文件，跳过派生产物（*.outline.json / *.outline.md）。

转换/处理单个文件。返回 (成功与否, 消息)。 Pipeline: 1. 非 .md：markitdown 转为 markdown 文本；.md：直接读原文 2. postprocess.process 加锚点 + 生成 outline 数据

在 DATA_ROOT/workspaces/ 下创建一个新的空知识库骨架。 生成：标准目录结构 + wiki/root_index.md（标准 frontmatter 的空根索引） + log.md（首条 human 日志）。不碰已存在的 workspace（直接拒绝）。

* Next.js 客户端导航不会触发浏览器原生的 fragment 滚动—— * pathname/searchParams 变了，但浏览器认为是同一文档，hash 不会自动定位。 * * 本组件挂在 PageColumns 里，pathname 变化或 hashchange 时主动找 id

* read_block 失败时：是不是「确定性不存在」（vs 网络/超时/反代/DNS）。 * 只命中明确来自 KB 业务层的串；**不**匹配 ENOTFOUND/ECONNREFUSED/http_404/timeout 等传输层故障 * （那些归 unverified、不降级，避免主站抖

这张卡片是什么——返回通用讲解文案

从工具 args 里抽 path 字段（兼容 KB 工具的 path / CC 的 file_path）

抽 markdown 文本里所有的块锚点引用 [[wiki/X#^p-…]] / [[raw/Y#^h-…]]

从工具结果 data 里提取主文本内容（用于 audit 扫锚点）

抽 thoughts：每个 **【TYPE】标题** 或 【TYPE】 后到下一个同类标记或末尾的段落 * 兼容格式： * **【EXTRACT】提取关键信息** ← 加粗包裹（agent 推荐格式） * 【EXTRACT】提取关键信息 ← 无加粗 * 【extr

* 抽 thoughts：每个 **【TYPE】标题** 段，从标记后到下一个同类标记 / 末尾。 * 段内首行 = 标题（剥掉首尾的 ** 加粗符），其余 = 正文。 * * 注：控制台版用单条非贪婪正则，标题分组实测会被吞进 body 且残留 `**`；这里独立移植 * 改为「先定位所有

在 md 中找包含 snippet 的块，返回 anchor + 上下文。

在嵌套 sections 里递归查找：先按 anchor 精确匹配，再按 title 精确匹配。