知识库全域技术叙事重排与事实校准实施结果
交付结论
Display Performance 样板已推广至 Startup、CPU & Scheduling、Memory、Network & I/O、GPU、Energy/Battery/Thermal、Session/Replay 全部七个领域。knowledge 文件从基线 49 个增至 79 个,新增约 30 个领域专属页面(Canonical 拆分 + 技术演进文章),公共诊断模型(跨指标诊断)从"五步法 + 七大临床诊断模型"重构为 Level 0-5 证据层级模型。门禁脚本新增 knowledgeRole 治理与内容风险审计。本批为纯文档/站点治理改动,未修改 MacApp 产品代码、Collector 算法实现或已有 docs 历史归档。
Canonical ownership 迁移
| 领域 | 旧 Canonical(降级为兼容索引) | 新 Canonical 拆分 |
|---|---|---|
| Startup | startup-timing.md | app-launch-total.md / startup-observation.md / startup-phases.md |
| CPU / Network 混装 | system-condition-metrics.md | thread-count.md / context-switch-rate.md / interrupt-wakeup-rate.md(CPU);disk-io-rate.md(Network & I/O) |
| Memory | memory-metrics.md | physical-footprint.md / real-memory.md / virtual-memory.md / available-memory.md / free-memory.md |
| Network | network-send-recv.md | process-network-rate.md / device-network-rate.md |
| GPU | gpu-counter.md | gpu-utilization.md / gpu-dynamic-counter.md |
| Energy/Battery/Thermal | energy-battery-thermal.md | process-energy-cost.md / battery-electrical.md / battery-temperature.md / thermal-status.md |
新增技术演进与 Session 架构文章
startup-evolution.md、cpu-sysmontap-evolution.md、memory-contract-evolution.md、network-acquisition-evolution.md、gpu-acquisition-evolution.md、energy-battery-thermal-evolution.md—— 均回链真实 devlog 证据,标注被证伪路线与仍未关闭的门禁,不编造未发生的实验。session-data-model.md、session-integrity-and-replay.md、session-architecture-evolution.md—— 新增 Session 数据模型总览与完整性证据边界,纠正旧版"纳秒级统一硬件时钟""可复现且不可篡改""PNG 无损持久化"等与当前代码不符的表述。
代表性事实纠偏
- Battery Current/Voltage/Power 产品状态由旧版"⚡️ 条件受限"更正为
Unsupported(fail-closed 逻辑已验证,但截至最新已整理的 devlog 时间线从未取得真实 battery-only 放电数值)。 - Thermal Status 删除"0-Normal/1-Fair/2-Serious/3-Critical"固定枚举映射与"电池温度超过 40℃ 触发降频"表述,改为如实披露"未找到跨 iOS 版本稳定的 0-3 当前值来源"。
- Process Energy Cost 删除"score (0~100)"固定量程描述,明确 source-native cost 不可换算为瓦特/焦耳/mAh。
- Session 完整性表述由"可复现且不可篡改"更正为"append-only + SHA-256 校验,篡改可被检测,非密码学签名意义的不可篡改"。
- 跨指标诊断手册删除"临床确诊""一锤定音"等确定性语言,改为 Level 0-5 证据层级模型,每条候选症候群标注还需要什么证据才能升级确认。
- CPU/Network/Memory/GPU 多处"确诊""直接证明"等表述改写为"候选原因,需交叉验证"。
验收证据
| 项目 | 结果 | 证据 |
|---|---|---|
| Registry / Canonical 唯一覆盖 | 66/66 | E2 |
| knowledge 文件数 | 基线 49 → 79 | E2 |
| knowledgeRole 治理 | 79/79 页均已分类,metric-canonical/evolution/methodology 约束通过 | E2 |
| 内容风险审计 | 全部剩余命中人工复核确认为否定式合规表述(如"不能确诊""不是不可篡改") | E2 |
metric-knowledge-gate.py | PASS,耗时约 0.18s(基线 0.15s) | E2 |
npm run build | build complete,0 报错、0 死链,约 15-19s(基线 16.09s) | E2 |
| evolution 文章 devlog 链接 | 全部指向真实存在的 site/devlog/*.md 文件 | E2 |
| 产品代码 / Collector 算法 / 已有 docs 历史归档 | 未修改 | E1 |
未关闭门禁
- 本批不改变任何产品能力状态:Battery Electrical 仍为
Unsupported、ThermalStatus 仍为Partial、GPU Dynamic Counter data row 仍为 0(FTI-009)、Screenshot HEIC 修复版本的 E4 真机验证仍待执行、CoreProfile 存储分级 30 分钟长测仍待执行——这些是产品工程门禁,不在本轮文档重排范围内,需独立开发批次处理。 - Frame Experience 与工程参考在侧栏中的分组命名可进一步微调,但职责划分(不退回按 Registry 表格组织知识库)已经确立。
下一阶段与整体进度
知识库全域技术叙事重排与事实校准方案(P0 文档治理批次)完成度 100%。下一阶段建议:(1)针对本结果披露的产品工程开放门禁(Battery battery-only 真机数据、ThermalStatus 稳定来源、GPU Counter data-row 协议、Screenshot HEIC E4)安排独立开发批次;(2)后续新增指标或 source 变更时,按本批建立的 knowledgeRole 治理与三层文章模型同步维护知识库,不退回单页堆叠。