外观
P0 知识库深度体系与一致性门禁收口结果
交付结论
知识库重构后续阶段已收口。CPU/调度、内存、网络/I/O、流畅度、GPU、Energy/Battery/Thermal 已补齐系统原理、曲线形态、交叉诊断、实现数据流和证据限制。本批未改 Collector、Mac App、Registry 和指标公式;Startup S6 保持暂停。
完成项
- 深化 10 个非 Startup Canonical 指标页,统一使用“现象—可能方向—交叉验证—尚不能确认”的诊断语义。
- 新增指标数据流页,说明 DTX/Lockdown→Raw Adapter→Metric Engine→Report→UI/Export、三类时钟与 gauge/counter/interval/dynamic-schema 边界。
- 新增跨指标诊断指南,建立 process/device/foreground-device 三级 scope 和五步证据升级法。
- 新增 64 项 Registry 公式合同索引与 JSON 审阅镜像,逐项列出 source/sourceKey、definitionVersion、系统服务、调用、实现层和 Canonical 归属。
- 新增构建前
metric-knowledge-gate.py,检查 64/64 Registry 合同、metricID 唯一性、Canonical 唯一归属、十要素标记、侧栏和总览链接。 - 门禁实际发现并修正两个漂移:
ios.device.cpu.total.normalized未进入 Canonical frontmatter;ios.device.memory.available被两个 Canonical 页重复定义。 - 按阶段收口规则新增《架构演进与全指标采集溯源白皮书》,包含单 DTX 架构真相、Clean Adapter 演进和完整 64 项命令谱系。
验收证据
| 项目 | 结果 | 证据 |
|---|---|---|
| Swift Registry | 64 个定义 / 64 个唯一 metricID | E1 |
| JSON 字段镜像 | 64/64 与 Registry 的 metricID、displayName、scope、unit、source、sourceKey、definitionVersion 一致 | E1 |
| Canonical 所有权 | 64/64 唯一覆盖;重复 0,缺失 0,额外 0 | E2 脚本执行 |
| 指标合同索引 | 64/64 只出现一次 | E2 脚本执行 |
| 十要素、侧栏、总览 | 全部通过 | E2 脚本执行 |
| VitePress | 构建成功,0 报错、0 死链 | E2 |
| 真机/数值校准 | 本批未执行,不改变既有 E4 状态 | — |
状态边界
- 自动门禁证明文档合同与当前代码一致,不证明指标数值等价于 PerfDog。
- Battery 放电、ThermalStatus、GPU Counter data row、Frame PID 独占归因、B-VAL 与 iOS 版本覆盖等原有门禁均未因文档收口而关闭。
- Startup 只维护已有 S1~S5 证据,本批没有继续 S6。
下一阶段与整体进度
知识库重构计划已完成 100%,本批没有自动开启新的产品开发。下一阶段回到产品总计划的未关门问题:优先级建议为 P3 Frame 目标 PID 独占归因与真实长窗校准,其次是 Battery 纯放电 E4 和 GPU Counter data row。任何一项都需要单独方案、公式入档与用户批准。Startup S6 只在用户明确恢复后继续。