docs(hygiene): 文档卫生 batch-1——11 项漂移修复（Source Map/ADR 撞车/死引用/路径过期）(#2154)

[DeliciousBuding]

文档卫生 batch-1（#2154）

只读探索报告 11 项逐项处置，全部仅改 *.md，每条修复前已复核现场证据。

逐项处置

#	项	处置
1	app/web/README.md Source Map / Current Routes 失真	✅ 改。Source Map 重写为真实结构（main.tsx→App.tsx 挂载 AgentHubWorkbench、platform/、api/、components/、stores/hooks/i18n）；删除引用已删目录（src/layouts/、viewRegistryConfig.ts、src/views/、src/pages/、router.tsx）的假路由表，改述为 @agenthub/workbench WorkbenchRoutes.tsx 状态式路由；marker → 2026-09-02
2	app/desktop/README.md:23,25 指向已删文件	✅ 改。DesktopLayout.tsx → AppShell.tsx -> App.tsx；src/views/ → workbench 包 WorkbenchRoutes 各 route view；其余有效行保留；marker → 2026-09-02
3	docs/decisions.md ADR-021 编号撞车	✅ 改。核对表内最大号为 ADR-026；按 ADR-012 行续号规则将 2026-09-01 OTel GenAI tracing 裁决重编为 ADR-027 并移至 ADR-026 后（编号/时间双序）；原 ADR-021（2026-08-09 安全门禁四修）不动；marker → 2026-09-02
4	Card/Pill 已删（ed846d2）仍被引用	✅ 改。07-design-system-ssot 删除 §7 glass 表 Card variant 行（:99）、改写 consumer rule（:102）与 §8 applied-first（:115）；shared README import 示例改用现存导出 Button, StatusBadge（已核对 ui/index.ts）。孤儿 app/shared/src/ui/Pill.module.css 仍存在——属代码文件，本 PR 不删，登记待代码侧清理
5	api/events.md:16 owner 路径漂移	✅ 改。service/agent_edge_callback.go → service/agent/agent_edge_callback.go（随领域子包化迁移）；:3 marker → 2026-09-02
6	11-protocol-capability-mapping.md:88-90	✅ 改。target_handler.go → execution_target.go（已核实存在）；删除 router.go:326-340 / :316-318 行号锚，只留文件+节名
7	02-edge-server.md:56,97	✅ 改。decision_loop.go 已不存在——DecisionLoop 逻辑并入 process_executor_pure_*.go 族（现存证据为 process_executor_pure_adapter.go 的 stdin gating/interrupt 注释与辅助函数），行内如实改述；internal/adapters/testdata/ → internal/adapters/sdk/testdata/；marker → 2026-09-02
8	ui-core.md:34 Toast 测试文件名过期	✅ 改。Toast.test.tsx → ToastStack.test.tsx（已核实 toast/__tests__/ 内实为 ToastStack.test.tsx + toastStore.test.ts）；删除失实的「2026-08-23 复核存在」声明
9	05-deployment.md:142 指向 CHANGELOG Unreleased 落空	✅ 改。指向 v0.6.1 节（该节含实际升级注意内容）；该文件 marker 本已为 2026-09-02，未变动
10	component-acceptance.md:72-79 空壳节 + ui-core.md:42,64 重复段	✅ 改。删除无正文的「范本表」空壳节，信息并入「范本索引」；ui-core 保留信息更全的 :42 段（从 :64 合并 radius 分叉值与三件套事实），删除近似重复段
11	批量更新过期「最后更新」marker	✅ 部分。对本次实际修改且有 marker 的文件全部更新至 2026-09-02（web/desktop README、events.md、decisions.md、07-design-system-ssot、02-edge-server、component-acceptance.md；05-deployment 已为今日）。06-auth-identity.md 与 agent-protocol-compat.md 本次未修改，按「未修改的不乱动」不动；无 marker 的文件（shared README、11-protocol-capability-mapping、ui-core）不新增

验证（真实跑过）

$ python scripts/verify/verify-doc-ssot.py   → doc SSOT ok (exit 0)
$ python scripts/verify/verify-ci-gates.py   → ci gate policy ok (exit 0)
$ git diff --check                            → exit 0
$ 自跑相对链接快检                            → 11 个改动文件 77 条相对链接目标全部存在

遗留（不在本 lane 职权内）

• 孤儿文件 app/shared/src/ui/Pill.module.css（Card/Pill 组件已删，CSS 残留）——需代码侧清理
• CHANGELOG.md:42 「Tauri 安全加固（ADR-021）」引用的内容与 decisions.md ADR-023 对应，疑为历史笔误；不在本批清单，未动

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: aa1f5337-2219-49e4-85bb-74bb3b2c5c94

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}