读取 md 文件，切分块，把块末尾已有的锚点回填到 block.anchor。

* 并行执行多个 synthetic call。前端 UI 体验： * 1. 所有 tool-call 卡片瞬间批量出现（pending 状态） * 2. 后端 Promise.all 并行 executeTool * 3. 所有完成后批量 emit tool-result（按 spec

跑一个 turn，流式输出事件

容错：把误带的 `workspaces/<当前ws>/` 前缀剥掉。 convert.py 的 `--dir` 用仓库根相对路径（`workspaces/<ws>/raw/...`），而 k.py 的路径参数相对**当前 workspace**（`raw/...`）——两套口径新手

YAML 字段可能是 list 或单字符串；都规范化为字符串列表。 如果用户写 `tags: foo` 而非 `tags: [foo]`，python-frontmatter 返回字符串。 旧逻辑 `list(meta.get("tags") or [])` 会把字符串拆成字符列表

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

抽出对象体里所有 "key": ... 的 key（key 一律是双引号字符串字面量）。

从 TRANSLATIONS = { zh: {...}, en: {...} } as const 中切出某 locale 的对象体。 用大括号配平定位，避免被 value 里的 `}`/`{`（如本项目没有，但稳妥）误切。 返回 `{ ... }` 内部那段（不含最外层花括号）

index 页 frontmatter 的 scope 字段 → 实际匹配的 wiki .md 路径集合。 支持： wiki/concepts/* 目录下直接 .md wiki/** 递归所有

在 root 下搭一个 workspaces/proj 数据目录（root 即"项目数据根"）。

归一化标题文本：压空白 + 转小写，用于跨 re-convert 的 title 级匹配。

生成 hash 用的归一化文本：去 markdown 标记、压空白。 pipe-1：旧版会 `[:64]` 截断——导致超过 64 字边界的关键数字 / 论断被编辑时 归一化文本不变、hash6 与锚点都不变，`k.py list-broken-refs` 这条安全网兜不住

把"看起来像项目内相对路径"的字符串安全拼到 PROJECT_ROOT 下。 用途：当 wiki 内容里的 [[link]] 目标拼接到磁盘路径时，必须防止 `[[raw/../etc/passwd]]` 这种越界——我们扫描时会试图打开它检查存在性， 虽然内容不会回到响应

构造调 web `/api/agent-tool` 的请求头；上下文带合法 workspace 时附 Cookie。

把 [key,count] 列表按 count 降序排，纯展示层用。

从 backlinks/outlinks 结果里抽 paths

raw/ 与 my_thoughts/ 下的文件用专门的虚拟 type，区别于 wiki schema 的真实 type

模糊：标题完全相等（去空白、忽略大小写）

深度优先扁平化所有 sections。

获取项目根目录（scripts/ 的父目录）

文本里是否出现了 ANSWER 段标记（容忍各种间隔与加粗包裹）

env 是否配置好

检查 frontmatter 是否含 locked / human-only 锁。

字边界判定：空白、标点、CJK 与 ASCII 切换处都算边界

扫 wiki paragraph / list / blockquote 块：含具体数字（百分比 / 量级 / NLP 指标 / 年份 / 金额 / 倍数）但**不**含 [[raw/...]] 引用、也**不**含 [需要来源] 占位 → 列入"裸论断"。 跳过：

扫描 wiki/ 所有页面里带 ^anchor 的双链，列出失效的引用。 覆盖两类目标： - [[raw/...#^anchor]] — raw 文件不存在 / anchor 不存在（raw 有 outline，但 anchor 集合直接从 .md 扫，与

扫 wiki paragraph / list / blockquote 块：含具体数字论断、且**只挂整页 `[[raw/X]]` 引用、未精确到块级 `[[raw/X#^anchor]]`** → 列入「引用粒度不足」。 与 list_bare_claims 互补：bare =

扫 web/ 下 .tsx，找硬编码中文（JSX text + UI 属性）。 跳过： - node_modules / .next / web/app/api/（API 响应不是 UI） - i18n.ts / i18n-client.tsx（基建自身）

扫 plain wikilink（alias / 无 RELATION）+ 判断/立场动词，提示应补 RELATION。 跳过：raw 链接（走 anchor 编号）、已合规的 RELATION 链接、自链、 归档区 / index / stub 标签、callout、表格行、代码

扫所有 type=index 页：scope 实际匹配数 vs 写死的 page_count 不等 → 列出。 page_count 语义：该索引覆盖的页面数量。drift 通常意味着新加的页面没被加进 索引、或者旧页面已 deprecate 但 page_count 没改。

扫全库 wikilinks：单一关系词频次 / 总关系引用 > threshold 则报警。 Args: min_total: 关系词总数 < 此值不报警（避免小样本噪声；5 个关系词以下说明 wiki 还在早期，单一关系词主导是正常起步阶段，

扫所有 wikilinks，找出"看起来像关系类型但不在 RELATION_TYPES 白名单"的引用。 典型场景： - 拼写错误：[[X|SUPORTS]]、[[X|EXTNDS]] - 用了非标准关系：[[X|IMPLEMENTS]]、[[X|CONTRADIC

扫所有 wiki 页，六类问题： 1. count-mismatch — source_count 字段 ≠ sources 数组长度 2. missing-source — type ∈ CLAIM_TYPES 且 source_count == 0 但未标 stub 3

扫 `status: reviewed` 但 `last_modified_by != Human` 的页面： reviewed（"已审阅"）语义 = 人类审阅过；LLM 自己写入的页面不该自称已审， 应保持 `draft`，由人类审阅后才改成 `reviewed` + `last_

扫 wiki 中 [[raw/...#^h-...]] 形式的章节级引用，列出对应 raw outline 里 agent_summary 为 null 的章节（即被引用却没回填摘要）。 去重：同一 (raw, anchor) 只列一次，但带上所有引用方供溯源。

* 返回 clamp 后的侧栏宽度（px），或 null（cookie 不存在 → 由 client 用 default）。 * * server 端就 clamp 到 [min, max]，让首帧 SSR 宽度恒在合法区间——即使 cookie * 被手改成越界值也不会渲染出畸形宽度。与 c

* 锚点查找 fallback：AI 常把一条**真实的 raw 块锚点**（如 [[raw/papers/2024-10-lightrag#^p-54]]） * 误标到它正在读的摘要页路径上（写成 [[wiki/sources/lightrag#^p-54]]）——锚点是对的、路径错了。 *