content/docs 还剩 17 处悬空锚点（全仓实测），三类新成因：emoji 标题、标题后来加了后缀、zh 页沿用英文锚点

[yinlianghui]

发现于 #749 / #764 的实施扫尾（PM 认领评论第 3 条要求做一次全仓同类抽检）。只报不改 —— 本单不在 #749 的 PR 范围内（PR #868）。

基线：origin/main = ed6885e（#749 分支拉出点）。

测法

content/docs 下所有形如 ](/docs/…#anchor)、](/zh-Hans/docs/…#anchor)、](/zh-Hant/docs/…#anchor) 的站内链接，逐条按 fumadocs 的 slug 规则解析目标页标题、比对锚点是否存在。

• slug 规则：fumadocs-core 16.9.3 默认 remark-heading，用 github-slugger。用 github-slugger@2 实测，不是推断。
• 目标文件按 locale 后缀解析：/docs/x 到 content/docs/x.mdx，/zh-Hans/docs/x 到 content/docs/x.zh-Hans.mdx。
• 代码围栏内的 # 行不算标题；显式 {#id} 优先。
• 其它链接形式（href=、reference-style [x]: /docs/…、fumadocs Card 的 url=、content/blog）实测全仓零命中，所以内联 markdown 链接就是全集。

main 上共 36 条带锚点站内链接，22 条悬空。其中 5 条属 #749（3 条）与 #764（2 条），已由 PR #868 修掉；其余 17 条是本单。

17 处清单

A. emoji 开头的标题 —— slug 会多一个前导连字符（3 处）

github-slugger 把 emoji 整个删掉，但 emoji 与文字之间的空格仍然变成连字符，于是 slug 以 - 开头。作者按「显而易见的 slug」写链接就必然写错。

链接所在	锚点	目标标题	实际 slug
content/docs/service/sla-and-escalation.mdx:95	#case-triage	### 🚦 Case Triage	-case-triage
content/docs/service/sla-and-escalation.zh-Hans.mdx:95	#case-triage	### 🚦 工单分流	-工单分流
content/docs/service/sla-and-escalation.zh-Hant.mdx:95	#case-triage	### 🚦 工單分流	-工單分流

（zh 两处同时还叠了下面 C 类的成因。）

⚠️ 这三处与 #749 同页不同行 —— #749 的 PM 裁定把范围锁在 :128 一行，所以没有顺手改。

B. 标题后来长了、链接没跟上（3 处 + 3 处）

链接所在	锚点	目标标题	实际 slug
content/docs/reference/performance-and-limits.mdx:86	#scheduled-export	### Scheduled export to a warehouse (not shipped yet)	scheduled-export-to-a-warehouse-not-shipped-yet
content/docs/reference/performance-and-limits.zh-Hans.mdx:86	#scheduled-export	### 定时导出到数据仓库（尚未落地）	定时导出到数据仓库尚未落地
content/docs/reference/performance-and-limits.zh-Hant.mdx:86	#scheduled-export	### 排程匯出到資料倉儲（尚未落地）	排程匯出到資料倉儲尚未落地

另一组是锚点与标题根本不同名，像是标题被改过：

链接所在	锚点	目标页最接近的标题	实际 slug
content/docs/index.mdx:75	#sales-dashboard	## 📈 Sales Performance	-sales-performance
content/docs/index.zh-Hans.mdx:74	#sales-dashboard	同上（zh 页仪表盘标题保留英文）	-sales-performance
content/docs/index.zh-Hant.mdx:74	#sales-dashboard	同上	-sales-performance

content/docs/analytics/dashboards.* 三语都没有 Sales Dashboard 这个标题。改法要先定：是把链接指向 -sales-performance（带前导连字符，很丑），还是给那节加显式 id，还是去锚点。

C. zh 页沿用英文锚点，而目标 zh 页标题已本地化（8 处）

与 #764 完全同源（译了标题、没译锚点），只是 #764 只覆盖了 guides/mobile 两处。

链接所在	锚点	目标标题	实际 slug
content/docs/marketing/campaign-members.zh-Hans.mdx:14	#campaign-enrollment-flow	## 营销活动加入流程	营销活动加入流程
content/docs/marketing/campaign-members.zh-Hant.mdx:14	#campaign-enrollment-flow	## 行銷活動加入流程	行銷活動加入流程
content/docs/sales/opportunities.zh-Hans.mdx:148	#generating-a-quote	## 生成报价	生成报价
content/docs/sales/opportunities.zh-Hant.mdx:148	#generating-a-quote	## 生成報價	生成報價
content/docs/service/cases.zh-Hans.mdx:89	#case-escalation	## 工单升级	工单升级
content/docs/service/cases.zh-Hant.mdx:89	#case-escalation	## 工單升級	工單升級
content/docs/service/index.zh-Hans.mdx:30	#case-escalation	## 工单升级	工单升级
content/docs/service/index.zh-Hant.mdx:30	#case-escalation	## 工單升級	工單升級

对照组：content/docs/administration/sharing-and-security.zh-Hans.mdx:169 的 #字段级安全 是对的 —— 目标 content/docs/administration/profiles.zh-Hans.mdx 的 ## 字段级安全 实测 slug 就是 字段级安全。所以 zh 侧 CJK 锚点本身能用。

顺带记一条待定的写法分歧

zh 侧现在同时存在两种活写法，两种都能跳：

1. 本地化锚点 —— #字段级安全（sharing-and-security 三语）。
2. 不带锚点只链页面 —— PR docs(guides): email-and-calendar 按实测改写——Log a Call 的三写路径、活动指标所在仪表盘、连接器段落标注未落地 (#738) #755 / docs(guides): 按实际落地能力重述 integrations 页，并校正指南索引描述行 (#756) #762 立的写法，sla-and-escalation 三语都链到 /docs/administration/automation#case-escalation，而 automation 页没有这个锚点 #749 的 PM 裁定也按这条办（zh 侧 automation、whats-new 都去掉了锚点）。

本单 C 类 8 处按哪种改，取决于先把这个分歧定下来。建议随本单一起裁一次，否则下一批还会长出第三种。

影响

观察类，与 #749 / #764 同级：点击落到目标页页首而不是目标段落，信息本身不错。B 组第二例（#sales-dashboard）稍重一点 —— 它在 content/docs/index 的「按角色开始」清单里，是新用户第一屏就会点的链接。

去重

• 与 sla-and-escalation 三语都链到 /docs/administration/automation#case-escalation，而 automation 页没有这个锚点 #749 / guides/mobile 的 zh-Hans / zh-Hant 链到 whats-new#roadmap，而 zh 页的标题是「路线图」/「路線圖」——同为悬空锚点 #764 无行级重叠（sla-and-escalation 三语都链到 /docs/administration/automation#case-escalation，而 automation 页没有这个锚点 #749 = sla-and-escalation.*:128，guides/mobile 的 zh-Hans / zh-Hant 链到 whats-new#roadmap，而 zh 页的标题是「路线图」/「路線圖」——同为悬空锚点 #764 = guides/mobile.zh-Han{s,t}:10，本单 17 处均在别的行/别的文件）。
• 与 「工作流规则」在 automation 之外还散布 8 个页族 ×3 语言共 33 处，其中 4 处把可配置项指向了不存在的配置面 #850 无重叠（「工作流规则」在 automation 之外还散布 8 个页族 ×3 语言共 33 处，其中 4 处把可配置项指向了不存在的配置面 #850 是「工作流规则」措辞，其中 sla-and-escalation.mdx:129 与本单最近的一行相邻但不同行）。
• 已检索 open issues（关键词：锚点 / anchor / 悬空 / link-check / 站内链接 / slug / heading，以及 sales-dashboard、case-triage、scheduled-export、campaign-enrollment-flow 逐个 body 搜索），无在案单。

防复发的守卫能力单已另立 #867（锚点存在性 + 语言前缀一致性检查），本单只记存量缺陷。

Refs #749 #764 #867 #868

[yinlianghui]

🔒 认领(/pm-dispatch R29)— session session_01VHrPAGEgFDoHjphqYG4BMa,分支 claude/issue-866-dangling-anchors。

文件面:issue 17 处清单所列各页的链接行(A 类 sla-and-escalation :95 ×3;B 类 performance-and-limits :86 ×3、index :74/:75 ×3;C 类 campaign-members/opportunities/cases/service-index zh 各 2)+ 必要时目标标题行的显式 id。

裁定:

1. ⚠️ stale-premise 重验是本单第一步:立单基线 ed6885e 已陈旧——C 类 8 处中 4 处大概率已被修掉(cases zh :89 ×2 已由 PR docs(service): cases 升级整节与 index 生命周期第 2 步按 flow / hook 写实(#914、#915) #922 去锚、service/index zh :30 ×2 已由 PR docs(service): 把 service/index 的升级与通知五条说法按 flow / hook 写实(#904) #913 去锚),A 类所在的 sla 页经 docs(service): SLA 跟踪一节按实测行为改写(#903) #918/docs(service): write the sla page's views, report dimensions and business-hours claims to source (#917) #924 两轮改动行号已移。逐条用 github-slugger@2 重测,已修的从面内剔除并在 PR 记录,只改仍悬空的。
2. 写法分歧裁定:zh 侧一律去锚只链页面(docs(guides): email-and-calendar 按实测改写——Log a Call 的三写路径、活动指标所在仪表盘、连接器段落标注未落地 (#738) #755/docs(guides): 按实际落地能力重述 integrations 页，并校正指南索引描述行 (#756) #762/sla-and-escalation 三语都链到 /docs/administration/automation#case-escalation，而 automation 页没有这个锚点 #749/docs(service): 把 service/index 的升级与通知五条说法按 flow / hook 写实(#904) #913/docs(service): cases 升级整节与 index 生命周期第 2 步按 flow / hook 写实(#914、#915) #922 五次先例,不引入第三种);sharing-and-security 的本地化锚点作为既存活写法保留不动、不扩散。
3. en 侧 A/B 类:优先给目标标题加显式 {#id} 使既有锚点成立(如 ### 🚦 Case Triage {#case-triage}),避免 -case-triage 这类前导连字符 slug;#sales-dashboard 与标题不同名,dev 依语境定(显式 id 或改链接锚点),PR 逐处说明取舍。改标题行时只加 id 不动文字。
4. 验证:改后全仓重跑锚点解析(issue 的测法),悬空归零;两阶段红→绿参照 守卫能力：给 content/docs 的站内链接加「锚点存在性 + 语言前缀一致性」检查（#749 / #764 / #866 各自的成因都能被它抓住） #867 思路做一次性脚本验证即可(守卫能力单 守卫能力：给 content/docs 的站内链接加「锚点存在性 + 语言前缀一致性」检查（#749 / #764 / #866 各自的成因都能被它抓住） #867 本单不做,不新增守卫)。
5. 基线 rc.3;与 R29 并行单文件面互斥确认:cases/state-machines 归 bare workflows 残留族在 #899 枚举之外还有 4 处：whats-new 把真实的 contract_renewal 流程叫成 workflow，state-machines:133 在 PR #894 扫过该文件后仍留着 #912 族 dev、service/index 正文归 service/index 的《Where to find things》(:63-67) 四项与 crm.app.ts 的 Service 分组三项对不上：Service Board 不存在、Tasks 不在这个组、Knowledge 被漏掉、导航项实际叫 Service Overview #927 dev——你只动链接行/标题 id,若重验后 cases/index 的 C 类已修则完全无交集;万一仍需动同页行,先在 PR 里说明并保持 hunk 距离。
6. src/ 零改动;三语同步;changeset 站内路径反引号。

---

Generated by Claude Code

[yinlianghui]

✅ 验收通过 —— PR #934 已转 ready 并挂 auto-merge(CI 8/8 全绿实核)。

验收要点:

1. 重验缩面精确:17→13(4 处已被 PR docs(service): 把 service/index 的升级与通知五条说法按 flow / hook 写实(#904) #913/docs(service): cases 升级整节与 index 生命周期第 2 步按 flow / hook 写实(#914、#915) #922 顺带修掉,逐条确认剔除并留档);A 类行号漂移(:95→:113)如实重定位。
2. 证伪派单裁定是本单最有价值的产出:PM 裁定的显式 id 写法 {#id} 实测是错的——fumadocs-core 16.9.3 只认 [#id],{#id} 在 .mdx 里被当 JSX 表达式送进 acorn 直接打挂整页构建。dev 先按裁定写、自查实测发现、纠正为 [#id],并把重扫脚本从「自己复刻 slug 规则」改为直接调 fumadocs 的 remarkHeading 读 TOC 防假绿——这正是「按裁定办但对结果负责」的正确姿势,记档。
3. 逐处取舍清晰:A 类与 scheduled-export 保锚 + 目标标题加 [#id](只加 id 不动文字);#sales-dashboard 三语一致去锚——en 侧偏离「优先加 id」的唯一一处有红/绿实测支撑(docs-drift 的 headingLabel() 剥不掉尾部 id,加 id 必打红,两种写法都验过并复原);其余 9 条 zh 去锚沿五次先例;本地化锚点保留不扩散。
4. 归零可验:29 条带锚链接/13 悬空 → 18 条/0 悬空,防空转计数(11 页/162 标题 id)在册;198 页 MDX 解析失败 0;与 R29 并行三单文件面零交集。
5. 反向实测(预告红→实测红)、四守卫单跑 101 passed、一次性脚本未入库。

越界发现处置:#935(headingLabel 剥不掉尾部 [#id],dashboards 三语页永远加不了显式 id + 报错误导;附 [#id]/{#id} 实测更正)——finding 标签 dev 已打,留发现池;#867 的实测约束更正评论(守卫必须调 remarkHeading 而非 github-slugger,否则假红/漏拦打挂构建的写法)已确认,该单待派时以此为准。

---

Generated by Claude Code