## 功能描述 解析 snapshot 时保存原始结构化 frame,并让事件经 callstackId 关联一组有序帧;在指定事件之后,将存活内存按分配调用路径逐层拆解,提供文本、JSON 和交互式 HTML 火焰图。 ## 使用场景 目前数据库仅保存整条调用栈的格式化文本,无法无损恢复原始文件名、行号、函数名与帧顺序。按整条栈归因也无法回答“哪个上层调用路径占用了多少内存”,或逐层下钻到分配点。 ## 期望的实现方式 - 新增共享 frame 表和 callstack_frame 关联表,保存 filename、line、name 和零起始 position;事件继续使用 callstackId,保留原有调用栈展示文本。 - 栈身份由有序结构化帧决定,保留递归重复帧,避免格式化字符串相同造成不同原始帧数组合并。 - event_frames 返回原始顺序;显式 root_first 只反向展示,不改写 position。 - active_memory_frame_tree_at_event 按“外层调用者 → 内层分配点”构建路径树;同一帧位于不同调用路径时分别归因。 - 分析 event_id 之后的 active block 占用,free_completed 时剔除,pending-free 仍计入;静态、采集前已有和缺失/损坏调用栈独立分类。 - 输出 inclusive size_bytes 与 self_bytes,以及块数、requested bytes 和整体占比,满足每层“总占用=自身+直接子节点”,禁止跨层累加 inclusive bytes。 - report memory-tree 复用共享查询契约,提供文本、--json 和可缩放、搜索、悬浮查看详情的自包含 HTML。 - import_format_version 升至 3,使旧缓存重建;旧数据库继续支持原有文本查询,新帧查询须从原始 snapshot 重新导入,不猜测恢复帧字段。 ## 示例 ```bash pt-snap query snapshot.db --template-use event_frames --params '{"event_id":100}' --json pt-snap report memory-tree snapshot.db --event-id 100 --json pt-snap report memory-tree snapshot.db --event-id 100 --format html > memory-tree.html ``` ## 验收标准 - [ ] 原始帧字段、顺序、递归重复及结构化身份在落盘后保持一致。 - [ ] 同帧不同路径分别归因,每个节点的字节数、requested bytes 与块数守恒。 - [ ] 释放完成边界、pending-free、静态/预存、空栈、损坏关联和多设备有回归覆盖。 - [ ] CLI、ReportService 与 SnapshotAnalyzer 经共享查询返回一致的帧树;截断结果显式标记并拒绝渲染成完整树。 - [ ] HTML 支持缩放、重置、搜索和详情,安全处理特殊帧文本。 - [ ] 旧库错误提示可操作,导入缓存版本更新,英文/中文文档同步。 - [ ] 完整测试、静态检查、打包与 snapshot provenance 检查通过。 ## 参考资源 关联 #62 的峰值内存拆解能力,以及 #197、#198、#203 的分片互操作 roadmap。本 issue 实现单库有序帧与路径树基础能力;跨片来源解析及 msinsight 互操作仍由对应 roadmap 任务负责。 涉及 snapshot/tools/adaptors/database/、core/report_service.py、query/templates/ 与 CLI report 入口。
Activity
feat: rework standalone ordered frames and memory-tree reports (#206) (…
codeasier commentedon Oct 11, 2026
验收完成,按原定单库范围关闭为 completed。
实现已随 #232 合入 main(merge commit
cd1aac689f653e2701334d26ae1f25489f7f5af9):standalone format v3 保留原始有序帧、递归与结构化身份;事件时刻路径树逐层守恒,CLI/API/ReportService 共用查询语义;report memory-tree 支持文本、JSON 和自包含 HTML。全树搜索、子节点列表、父级导航与稳定键盘焦点使微小/零字节节点可达,旧库提示、缓存版本、损坏/截断检查及中英文文档均已覆盖。验收证据见 #232:5 份真实 pickle 独立核对 51,936 事件、325,233 帧出现、19,308 生命周期及 81 棵完整树;6 份真实 HTML 输出完成云 Chrome 交互验收;独立 Chromium CI 的 12 项交互测试全部通过、0 skip。合并后的 main CI 38102500076 已 7/7 jobs 成功,覆盖 Python 3.10–3.13、Chromium、Lint/格式/类型、provenance,以及 Python 3.13 wheel 构建/审计和 clean-wheel 验收。
本 issue 的范围仍为单库原始帧与路径树基础能力;跨片树和 msinsight 互操作由对应 roadmap 继续跟踪,不计入本次完成范围。