Skip to content

P0 知识库深度体系与一致性门禁收口结果 ​

交付结论 ​

知识库重构后续阶段已收口。CPU/调度、内存、网络/I/O、流畅度、GPU、Energy/Battery/Thermal 已补齐系统原理、曲线形态、交叉诊断、实现数据流和证据限制。本批未改 Collector、Mac App、Registry 和指标公式;Startup S6 保持暂停。

完成项 ​

  1. 深化 10 个非 Startup Canonical 指标页,统一使用“现象—可能方向—交叉验证—尚不能确认”的诊断语义。
  2. 新增指标数据流页,说明 DTX/Lockdown→Raw Adapter→Metric Engine→Report→UI/Export、三类时钟与 gauge/counter/interval/dynamic-schema 边界。
  3. 新增跨指标诊断指南,建立 process/device/foreground-device 三级 scope 和五步证据升级法。
  4. 新增 64 项 Registry 公式合同索引与 JSON 审阅镜像,逐项列出 source/sourceKey、definitionVersion、系统服务、调用、实现层和 Canonical 归属。
  5. 新增构建前 metric-knowledge-gate.py,检查 64/64 Registry 合同、metricID 唯一性、Canonical 唯一归属、十要素标记、侧栏和总览链接。
  6. 门禁实际发现并修正两个漂移:ios.device.cpu.total.normalized 未进入 Canonical frontmatter;ios.device.memory.available 被两个 Canonical 页重复定义。
  7. 按阶段收口规则新增《架构演进与全指标采集溯源白皮书》,包含单 DTX 架构真相、Clean Adapter 演进和完整 64 项命令谱系。

验收证据 ​

项目结果证据
Swift Registry64 个定义 / 64 个唯一 metricIDE1
JSON 字段镜像64/64 与 Registry 的 metricID、displayName、scope、unit、source、sourceKey、definitionVersion 一致E1
Canonical 所有权64/64 唯一覆盖;重复 0,缺失 0,额外 0E2 脚本执行
指标合同索引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 只在用户明确恢复后继续。

Perfowl · Performance Observer