* 从 H 段整章 markdown 中提取第一个 block（首段/首列表/首表格/首代码块）， * 让 hover 预览保持"一段的尺度"而非整章全景。 * * 启发式： * 1. 跳过开头的 H 标题行（## ...）与紧随的空行 * 2. 第一个非空起始行决定 block 类型：

给目标块加一段渐隐高亮，提示用户「就是这一段」。重复点同一锚点也能重新触发。 * 传入多个元素（标题 + 其正文）时用「仅背景」变体连成一片，不给每段都套外圈。

把对话历史拼成一个 prompt 串给 CC（CC 非交互模式只接受单 prompt） * 注：system 不在这里拼——通过 CLI 的 --append-system-prompt 单独传，让 CC 真当 system 处理

六类问题分组打印——每类有不同修复方向，分开看更清晰。

* 把 normalize 后的路径转成给读者看的友好标签： * wiki/concepts/attention.md → concepts/attention * wiki/sources/vaswani2017_x.md → sources/vaswani2017_

* 「结构签名」——只在图的结构（节点 / 边 / 工具状态 / 思考步骤标题）真正变化时改变； * 正文逐字增长（text-delta）不改变签名。 * * 用途：流式期间 message 每个增量都是新对象，若直接用它当 useMemo 依赖，会导致 * 每个字符都重建 + 重新布局整张

该 provider 支持的 model id 列表（写死，不去 API 拉）

返回文档所有 block 的扁平列表 + 顶部统计。 每个 block 含： anchor, kind (heading/paragraph/list/blockquote/table/code/figure), level/title (仅 heading), l

外层入口：把 resolve_doc_path 抛的 ValueError（路径越界 / 拒绝绝对路径 / my_thoughts 人类专属区）统一翻译为 exit 2，与其他错误路径（文件不存在 exit 2） 一致，而不是吐 traceback 给调用方（web/CI）。

* "裸"版本：通过 extractTrailingAnchor 剥离 anchor 文本（避免视觉污染）， * 但**不**输出 HTML id、**不**渲染 [n] 上标。 * * 适用场景：MiniMarkdown / BlocksTable 等局部预览渲染。 * 这些场景下： *

* 用空白字符替换 markdown 代码块（fenced + inline），让里面的 anchor / wikilink * 不被扫描注册到 registry（避免 ReactMarkdown 不渲染时产生 ghost references）。 * * 用空白替换而非删除：保持原 cont

把 JS/TS 注释（// 单行 + /* */ 多行）替换为等长空白，保留偏移与行号。

把 JSX 的单行 {…} 表达式替换为等长空白（保留偏移与行号），从最内层反复剥到无嵌套。 用途：硬编码中文混排被 `{...}` 表达式打断时（如 `<span>共 {n} 条</span>`）， JSX_TEXT_CN_RE 的字符类排除了 `{` `}` 导致跨表达式的中文