上一篇更新写到 2026 年 8 月 21 日的 v1.7.0。从 8 月 21 日的 v1.7.0 到 9 月 17 日的 v1.12.0,这 28 个日历日内,SmartPerfetto 发布了 9 个新版本,仓库合入 141 个非 merge 提交。
这段时间增加了任意双 Trace 工作台、无需预建索引的源码分析、Auto/Fast/Full 显式模式、跨会话调查检查点,以及贯穿 Web、CLI、报告和快照的结论核验。变化很多,但方向很集中:让一次分析从「模型给出答案」变成「请求、工具执行、证据、断言和最终交付都能核对」。
项目地址:github.com/Gracker/SmartPerfetto。
历史版本说明(2026-10-14复核):本文记录v1.12.0及其之前的增量,源码基线为
2f9e8584。截至复核时最新公开Release已是 v1.16.2,下文安装命令用于复现历史版本,不代表当前升级建议。文末原“未发布主分支”进展已补发布归属。
版本跨度:v1.7.0 到 v1.12.0
| 口径 | 结果 |
|---|---|
| 时间范围 | 2026-08-21 至 2026-09-17 |
| 公开版本 | 9 个:v1.8.0、v1.8.1、v1.8.2、v1.8.3、v1.8.4、v1.9.0、v1.10.0、v1.11.0、v1.12.0 |
| 非 merge 提交 | 141 个 |
| YAML Skill | 240 → 245 |
| v1.12.0分发入口 | GitHub 三平台免安装包、npm CLI、Docker 多架构镜像、源码运行 |
这 9 个版本可以分成四条线:v1.8.x 扩展 Trace 与源码输入;v1.9.0 明确分析模式和请求意图;v1.10.0 处理长任务的连续性;v1.11.0 和 v1.12.0 把最终答案接到证据核验和交付诊断上。
统计区间是v1.7.0之后、包含v1.12.0:141为 git rev-list --no-merges v1.7.0..v1.12.0 的提交数;240→245统计两个tag下backend/skills中的 .skill.yaml 文件,不代表独立场景或测试通过数。28个日历日包含起止日,版本日期按本版本CHANGELOG。
1. 双 Trace 工作台支持任意两条 Trace

早期双窗模式依赖「当前 Trace + 历史参考 Trace」。v1.8.0 改成了更完整的工作台:没有打开 Trace 时也能直接进入双窗,两个窗格分别上传或替换文件,再把这对 Trace 交给主 Viewer。基线与对照的身份保持稳定,也可以显式交换;页面刷新后,Trace 配对和布局会恢复。
刷新恢复仍依赖保存的Trace引用和文件可用;清理浏览器数据、服务端文件或更换环境后不能把布局记录当作Trace备份。“任意两条”描述工作台输入方式,不表示采样、版本、进程或时间窗天然可比。
比较结果继续使用同一套后端身份和证据契约。Trace 摘要、时间选区、进程与线程归属、trace processor 能力版本都会进入分析回执。已覆盖的身份和选区合同不满足时会拒绝或降级;把相关性与因果分开是核验目标,不能据此保证模型永远不会误判。
这一版同时同步到 Perfetto v58.2,浏览器 Viewer、原生 trace_processor_shell、SQL 文档和索引按各自的固定版本运行。浏览器时间线能展示什么,与 AI/CLI 用哪一个原生处理器取证,仍然是两条明确边界。
2. 源码分析不再要求先建完整索引
v1.8.1 到 v1.10.0 连续补齐了 Code-Aware 的输入和授权流程。注册代码库前,界面会显示包含与排除范围;App、AOSP/OEM 和 Kernel 目录都可以使用有界的 Git、ripgrep 或 Node 扫描。源码文件可按需搜索和读取,索引成为可选的加速与语义检索能力。
源码上下文不会只靠一个「已同意」开关。当前 source selection、Provider 发送同意、活动或待定索引代际、Git 来源和内容指纹共同决定一次运行能否继续。选区扩大、同意状态变化、索引替换或运行中的上下文漂移都会触发确认或拒绝。
从 v1.9.0 开始,源码使用来源也进入报告:分析使用了哪个注册目录、通过按需读取还是索引命中、哪些引用绑定到当前 Trace,都可以在后续报告和审计里回看。v1.10.0 又允许已授权目录在没有活动索引时按需参与分析,减少「先等建库,才能查一行代码」的阻塞。
报告中的来源投影与模型实际读取内容有不同边界:不应因此承诺导出绝对root或全部snippet。发送源码仍需对应Provider授权;同一目录已注册,不等于所有后续选区扩展都获授权。
3. Auto、Fast、Full 成为显式分析模式
v1.9.0 把 Auto、Fast、Full 放到 AI Assistant 里,后续提问也保留本轮的模式意图。
- Fast:采用quick预算,保留本轮已授权工具与共享finalization;不是“只跑确定性SQL、不调用模型”的模式。
- Full:采用full预算;是否需要计划、完整报告或额外源码查询仍由本轮请求决定,不自动扩展任务。
- Auto:使用typed intent的复杂度建议;不可用时走明确fallback。预算、交付形式和证据访问权限分别约束,不用模式名代替完整性验收。
界面开关下面还有运行时契约。五条运行时——Claude、OpenAI、Pi、OpenCode、Qoder——共享带类型的 turn intent、调查要求和证据上下文。计划和报告按用户本轮请求展开,不再由固定场景模板提前决定所有章节。工具进度会叙述结果,例如「定位到一次 42 ms 主线程等待」;SQL 行数和序列化 payload 不会被当作发现。
4. 长任务可以保存调查检查点并继续
长 Trace、源码联合分析和多轮 Provider 调用容易碰到超时、上下文上限或临时网络错误。v1.10.0 引入持久化调查检查点:已经形成的假设、取到的证据、父运行身份和后续待查项会保存在会话、报告与快照里。后续提问可以沿用这些状态,不必把前一轮重新跑一遍。
检查点是后续轮次的恢复依据,不是后台任务自动续跑,也不恢复尚未完成的工具执行。Provider、授权或输入身份不再有效时仍须重新核验;partial状态不会因为保存了检查点就变成完成。
v1.11.0 又给 OpenAI 路径增加了有界延期和交付预留。工具持续返回数据或 Provider 仍在输出时,运行可以在硬上限内延长;接近终止时保留一次不调用工具的交付机会,用已经取得的证据返回 partial 或 timeout 结论。最终状态会说明是完整结束、部分交付、Provider 失败还是用户停止。
Provider 配置边界也更清楚。Claude Agent SDK 不再读取本机 Claude Code 登录作为隐式后备;没有 API key、Bedrock 或 Vertex 配置时会提前停止并给出设置入口。CLI Provider 存储与源码启动的 Web 后端默认独立,只有两边显式使用同一个 SMARTPERFETTO_BACKEND_DATA_DIR 才共享数据。
5. 最终答案现在有独立的证据核验结果
v1.11.0 的主要变化发生在最终交付边界。模型生成结论后,SmartPerfetto 会把结论声明与本轮保留的工具执行证据绑定,再做一次有界、禁用工具的语义复核。每条声明会得到 verified、partial、inference、unsupported 或 not_checked 状态;整轮核验另有 passed、failed、partial 和 not_checked 结果。原始结论正文仍然保留。
核验结果会投影到所有主要输出:
- Web 对话保持可读,同时显示结论级核验状态和交付诊断;
- CLI 使用
✓、~、!、✗标记,并在 JSON/NDJSONcomplete事件里输出deliveryVerdict; - HTML 报告保留声明、证据引用、语义复核和未核验原因;
- 快照和 CLI turn artifact 保存证据包,后续导出报告仍能复查原始依据。
v1.12.0 补齐了诊断细节。声明格式问题、关系提案字段错误、传输状态和尝试次数会使用固定原因码显示在 CLI、报告、持久化证据和前端里。OpenAI 语义复核只重试连接错误、408/425/429 和 5xx;确定性的 4xx 或带错误内容的 200 响应不会重复发送同一个失败请求。
候选答案、协议是否有效、声明核验和整轮 E2E 是否完成,是四个不同结果。文章、日志或 UI 只显示一个绿色图标会丢掉这些差异,因此 v1.11.0 之后的输出会把它们分开。
“独立核验结果”是交付阶段独立记录的检查状态,不等于第三方专家或真机重复实验。语义复核仍受保留证据、模型和预算限制;超时、取消或预算不足时可能not_checked,verified也只针对具体声明和当前证据,不是整篇报告或所有设备正确的保证。OpenAI传输在同一deadline内最多重试一次;读取/解析响应抛错也可能按瞬时故障处理,不能把所有HTTP200异常都说成绝不重试。
6. 场景方法从固定清单变成证据条件
启动和滑动分析这轮也在变化。v1.11.0 为启动分析增加显式调查要求:调度状态、阻塞、CPU 频率、主线程状态和启动窗口需要用对应证据回答,精确值与近似值也要区分。
v1.12.0 把同样的原则扩展到滑动背压。只有 render.frame.buffer_stuffing.rate 或 render.buffer.dequeue.wait.duration 等证据显示 buffer stuffing 占主导时,系统才要求进一步调查 Render/GPU/Buffer 生产者与消费者边界。指标缺失保持 unknown,不会被当成「已经排除」。
仓库同时增加了 14 个系统分析 E2E 场景:3 个真实 Trace 路径覆盖单 Trace 启动、单 Trace 滑动和双 Trace 启动对比;11 个构造场景覆盖 scheduler、input、ANR、game、media、IO、memory、power、Linux、network 和 rendering pipeline。构造 Trace 只证明合成事件与选区内的系统证据读取,不冒充真机领域机制或因果证明。
14是manifest中定义的场景数,不是本文实跑通过数。该版本all/all-deepseek集合只涵盖OpenAI/Pi/OpenCode,Claude和Qoder需独立运行;必须按具体Provider、场景、证据和终态记录验收。
批量运行新增 smp probe。v1.12.0实际先输出入口信息,再显示 strategies OK N scene(s),成功退出码为0;加载失败时为 strategies FAIL ...、退出码1,错误可带requirementId和源文件。它检查当前调用artifact的策略loader与文件是否兼容,不检查Provider可用性、真实Trace SQL或完整分析结果。批任务必须显式使用同一artifact并按退出码停止,不能把源码侧probe成功当打包侧通过。
7. 分发与更新仍然保持四条入口

v1.12.0 已经可以从四条公开入口获得:
| 入口 | v1.12.0发布状态 |
|---|---|
| GitHub Release | Windows x64、macOS arm64、Linux x64 三个免安装包 |
| npm | @gracker/smartperfetto@1.12.0 |
| Docker | w553000664/smartperfetto:1.12.0,linux/amd64 与 linux/arm64 |
| 源码 | v1.12.0 tag;默认入口仍是 ./start.sh |
应用内更新检查只负责提示,不会自动安装、替换源码、重启容器或迁移数据。版本tag用于固定发布选择,但Docker tag本身不是不可变内容标识;严格复现还需记录并固定digest。免安装包应解压到新目录,数据迁移另按对应版本文档操作,不能把“更新检查不覆盖文件”理解为人工替换操作也没有风险。
历史CLI安装示例要求Node.js 24.x(该npm版本engines为>=24且<25)。doctor和probe只是不同层级诊断,不能替代加载固定Trace与Provider验收:
1 | npm install -g @gracker/smartperfetto@1.12.0 |
Docker示例应在v1.12.0的Compose文件所在目录执行,使用文件已有的 SMARTPERFETTO_DOCKER_TAG 变量;该文件默认是latest,不能只在正文说“固定版本”却仍用默认值。保留原项目名、数据卷和配置,pull失败时不继续重建:
1 | SMARTPERFETTO_DOCKER_TAG=1.12.0 docker compose -f docker-compose.hub.yml pull || exit 1 |
8. 仍需知道的边界
严格核验会暴露以前容易被忽略的问题。v1.11.0 发布说明记录了一项已知问题,v1.12.0 没有把它列为已修复:真实 Provider 运行长启动或滑动报告时,近似数值没有标记、正文断言没有对应声明,都会让语义复核把结果标成 partial。答案仍然交付,失败项也会显示;partial 表示交付质量没有全部通过,不等于 Trace 分析进程崩溃。
另一个边界是证据层级。构造 Trace 能验证查询、身份、选区和报告协议,不能替代真机 GPU、IO、能耗或厂商 Camera 数据。相关性也不能直接写成因果关系。SmartPerfetto 会尽量把「没有证据」「没有检查」「检查失败」分开,但最终结论仍取决于输入 Trace 是否包含对应数据源。
v1.12.0 之后的主分支进展
原稿在2026-09-19记录的后续改动——HTTP507磁盘预检、启动wakeup chain与sleep attribution、假设重新求解、提示词预算——已进入2026-09-21的 v1.12.1 CHANGELOG,不再属于当前未发布工作。
这些内容仍不计入v1.12.0的历史功能范围。2026-10-14的 v1.16.2 继续修复声明位置、报告恢复与私有文档检索,并明确部分真实模型严格核验仍未完成。较新的版本号不自动消除本文关于证据、partial和实际运行验收的边界。
版本时间线
| 版本 | 日期 | 主要变化 |
|---|---|---|
| v1.8.0 | 2026-08-25 | 任意双 Trace 工作台、Perfetto v58.2、trace processor 能力归属与评估基础 |
| v1.8.1 | 2026-08-26 | 无需预建索引的代码库预览、注册、搜索与读取;授权和索引生命周期 |
| v1.8.2 | 2026-08-26 | 源码遍历 time_budget 语义修复 |
| v1.8.3 | 2026-08-27 | 源码选区扩大确认、npm Trusted Publishing、检索边界修复 |
| v1.8.4 | 2026-08-27 | npm Sigstore provenance 所需仓库元数据 |
| v1.9.0 | 2026-09-08 | Auto/Fast/Full、typed turn intent、工具叙述、跨输出证据保留 |
| v1.10.0 | 2026-09-11 | 调查检查点、会话恢复、主线程调度证据、按需源码分析 |
| v1.11.0 | 2026-09-16 | 结论核验、语义复核、CLI 交付标记、有界延期与部分交付 |
| v1.12.0 | 2026-09-17 | 条件化调查要求、smp probe、Trace lease 升级和失败原因码 |