Observability Product Hub
守望性能，洞察每一次变化
统一查看 PerfDog 对标调研、技术判断、产品方案和实施结果。所有开发都从可追踪的证据开始，并按阶段完成本地提交。
官网与文档中心已迁移（2026-09-04）
Perfowl 官网、知识库与开发记录现由仓库 site/ 下的 VitePress 站点承载：知识库按一指标一页发布口径文档，开发记录提供八阶段进度看板与最新置顶时间线。本目录（docs/）自此冻结为只读归档，继续作为时间线节点的原文链接源；新文档一律以 Markdown 写入站点，并遵循根目录 AGENTS.md 的文档产出规则。
Why Perfowl
全向观察，持续守望
猫头鹰的头部能大范围转动，象征覆盖全链路的观察能力；大眼睛代表不遗漏异常；贯穿双眼的性能曲线，让“监控”成为品牌本身。
最新实施结果
批准后开发、验证、文档与本地基线
- Perfowl Mac B 批次系统与口径校准实施结果 v1B CODE PASS · B-VAL OPEN
TotalCPU raw/candidate 双轨、分核负载、iOS 17+ 路由审计、generation 质量统计、兼容旧版 quality.json 与 PerfDog 同时间窗校准脚本；当前真机两目标后台短采集完成。
- Perfowl FRAME-1 帧分析引擎基础 v1ENGINE PASS · SOURCE OPEN
DisplayFrameEvent、FrameTime/FPS、Drop、MedRange、Small/Jank/BigJank、1% Low 和 Stutter candidate 的可回放分析层；实时逐帧源与同场校准仍待验证。
- Perfowl FRAME-SOURCE-1 逐帧输入契约 v1INGRESS PASS · TRACE OPEN
显式时间单位的 JSONL/CSV 逐帧归一化、错误行与质量报告；秒级 Graphics FPS 不升级为逐帧事件，真实 xctrace schema 仍待真机样本。
- Perfowl Mac DATA-1 TotalCPU 与 Network 承接及真机验收 v1DATA-1 PASS · CALIBRATION OPEN
同一 DVT socket 读取泵、sysmontap 真实回包展开、TotalCPU、设备级 Send/Recv、scope/unit/quality 与两个匿名目标 App 真机短采集。
- Perfowl 工作台 UI-1 实施与验收记录 v1SELECTED PATH PASS
启动连接 Toast、选中设备/App、动态曲线、右下角 `＋`、17 项名称与禁用态、面板滚动及 Disk 添加/回滚均已观察；物理拔线分支保持独立待测。
- Perfowl 工作台 UI 与指标对齐方案 v1UI-1 已实施
四张参考图拆解、USB 状态浮层、顶部截图、默认三组多曲线、17 项指标选择器、能力差距与分批验收。
- Perfowl A 批次 0 值正确性复核 v1IDENTITY/VALUE PASS
同名 executable 误绑已修复；正式内置 Collector 的目标身份、动态数值和前台归属门禁通过。
- Perfowl Mac 指标基座 A 批次实施与验收记录 v1UI GATE PENDING
Python 10/10、Swift 26/26、内置 Collector 与 Controller/Session 真机闭环通过；人工 UI 点击回归待补。
- Perfowl Mac 第二阶段性能采集基座交付结果 v12026-09-02
Collector 协议、目标进程绑定、本地 Session、三条实时曲线、Fixture UI 与真机只读采集分层证据。
- Perfowl Mac 第一阶段基座交付结果 v12026-09-02
原生 SwiftUI 客户端、usbmuxd 事件发现、pymobiledevice3 设备与 User App 目录、设备/App 选择链和真机只读验收。
调研台账
固定代码快照、证据等级和借鉴边界
| 调研对象 | 范围 | 结论 | 证据 | 更新 |
|---|---|---|---|---|
| PerfDog 官方资料中心与 iOS 指标口径 71 个菜单记录、70 个唯一官方页面、关键公式、模式限制、冲突台账与第三方历史参考 |
官方帮助中心 | 主体指标定义已确认，TinyJank/Smooth 仍待消歧 | E0 官方 + E1 交叉 | 2026-09-02 |
| PerfDog 导出样本与 Perfowl 基座差距 44 个秒级字段、1,845 个帧样本、公式复算、当前承接层级与补齐顺序 |
iOS 导出 | 3 条基础链路已通，帧体验与分析层待补 | E1 + E2 样本复算 | 2026-09-02 |
| Apple Instruments 专项调研 产品定位、采集架构、模板与 Instrument、xctrace、指标语义及混合路线 |
一方基准 | 诊断真值老师，不是实时 SDK | E0 + E1 本机冒烟 | 2026-09-01 |
| Instruments 生态与 PerfDog 复刻差距 开源项目雷达、PerfDog 能力地图、差距矩阵与分阶段复刻路线 |
产品全景 | 先做 iOS 可信 MVP，再扩平台与 AI | E0 + E1 静态调研 | 2026-08-31 |
| Codesign4QC DVT 采集、Schema v2、Probe、场景规则与离线报告 |
iOS 性能 | 核心参考项目，指标口径先校准 | E1 + 仓库历史记录 | 2026-08-31 |
| client_perf iOS 数据链路、指标口径、风险与 PerfDog 差距 |
iOS | 借鉴路线，不直接作为代码基座 | E1 + 部分 E2 | 2026-08-31 |
能力观察站
以 PerfDog 为目标的能力轴，不用虚构分数
- Apple Instruments 基准专项已补齐
已完成本体调研和本机 xctrace 冒烟；下一步需 iOS 真机 Trace Schema 与指标对照。
- iOS 数据采集链路DATA-1 已落地
已剥离为 Perfowl 自有 Collector 协议、目标绑定、Session Store 与实时图表；TotalCPU、设备级 Network 和质量状态已承接，口径校准继续进行。
- 帧体验指标定义部分完成
Drop、MedRange、Small/Jank/BigJank、1% Low、Stutter 主体定义已确认；逐帧数据源、120Hz 与边界规则待验证，TinyJank/Smooth 公式仍未知。
- 正式采集底座Identity/Value PASS
Bundle ID/PID 精确绑定、同名进程隔离、前台状态门禁、长静止 suspect 和 Session 文件闭环已通过真机复验。
- Mac + Cloud 产品闭环Phase 2 已完成
设备/App、性能采集骨架和本地 Session 已交付；本地历史、断点上传、Cloud Run 与 Web 报告继续按阶段批准与实施。
设计与规范
品牌和执行约束
- 工作台 UI-1 实施与验收记录 v1选中路径通过
自动测试、Release App、原生未选择态、启动连接 Toast、真机选中和 17 项指标面板主路径通过；物理拔线分支保持独立待测。
- 工作台 UI 与指标对齐方案 v1UI-1 已实现
USB Toast、截图预览、多曲线默认图、17 项指标选择器、能力矩阵和五批实施顺序。
- Perfowl 对齐 PerfDog 指标基座开发计划 v1FRAME-SOURCE-1 完成 · 真机源开放
pymobiledevice3 主采集、xctrace 增强、Schema/Registry、八阶段路线、统一验收门禁和四张批准单。
- Mac 指标基座 A 批次结果 v1UI 门禁待补
P0/P1、目标身份、动态数值、前台归属和 Controller/Session 真机闭环已通过；人工 UI 点击回归待补。
- Perfowl Mac + Cloud 基座方案 v1已批准
pymobiledevice3/xctrace、Codesign4QC 复用、Mac 客户端、Session、上传、后端、Web 报告和阶段门禁。
- Mac 第一阶段基座交付结果 v1已交付
真实设备发现、34 个 User App、第一版客户端、测试、构建和 UI 运行证据。
- Mac 第二阶段性能采集基座交付结果 v1已交付
Sidecar、目标绑定、Session Schema/Store、三条实时曲线和分层验收台账。
- Perfowl Gate F0 详细验证计划 v1A 已执行 · B Hold
设备矩阵、F0-00 至 F0-12 实验、候选误差门槛、并发判定、开销、稳定性、证据与停止条件。
- Gate F0 · A 批次静态门禁结果 v1Conditional Pass
版本冻结、F0-00 GPL-3.0 交付边界、Host/Fixture 盘点和 B 批次进入条件。
- Gate F0 · B 批次连接冒烟结果 v1Partial · E2
iOS 16 USB 发现、Lockdown、Developer image、App/进程和 DVT 只读入口证据。
- Gate F0 · B 批次 Fixture 构建与签名 v1Build PASS · Signing Blocked
可控 Fixture 源码、未签名 Release 产物、签名候选和 F0-02 停止点。
- Perfowl 无侵入底层能力 v1F0 范围已批准
xctrace 官方能力与结合方式、pymobiledevice3/go-ios 对比、授权边界、指标和 Gate F0。
- Perfowl 产品成熟方案 v1已暂停
包含 Probe/Extension 的历史架构草案；已由新版 Mac + Cloud 基座方案取代。
- Perfowl 品牌说明
猫头鹰图标、性能曲线与颜色规范。
- 调研与开发规则
先调研、记录指标计算方式、明确批准、HTML 归档、本地提交。
- 文档中心 Design Plan
IA、Token、布局、Signature 与 Anti-Slop 记录。