Skip to content

feat(callstacks): preserve ordered frames and add event-time memory trees - #207

Closed
codeasier wants to merge 1 commit into
mainfrom
feat/ordered-frames-memory-tree
Closed

codeasier wants to merge 1 commit into
mainfrom
feat/ordered-frames-memory-tree

Conversation

@codeasier

Copy link
Copy Markdown
Owner

📝 Description

原先只有整条调用栈文本和整栈归因,无法无损读取原始帧或逐层解释事件时刻的内存占用。本改动保存原始有序帧,并按分配调用路径提供存活内存树和交互式 HTML 火焰图。

  • 共享 frame / callstack_frame 保存原始字段、位置和递归重复帧;栈身份使用有序结构化帧,保留旧展示文本。
  • 新增 event_frames、active_memory_frame_tree_at_event 与 report memory-tree;CLI/API 共用查询语义,提供 inclusive/self 字节、块数、requested bytes 与整体占比,静态、预存和缺失栈分别展示。
  • 支持文本、JSON 和自包含 HTML 的缩放、搜索、详情;完整树遵循“总占用=自身+直接子节点”,截断结果不能渲染成完整树。

🔗 Related Issue

Fixes #206

Related: #62, #197, #198, #203. 本 PR 提供单库的有序帧与调用路径树;分片来源解析和 msinsight 互操作由对应 roadmap 任务继续推进。

🧪 Testing

  • Tests added/updated:原始帧落盘与身份、顺序/递归、路径隔离、逐层守恒、free_completed 边界、类别/块大小筛选、多设备只读性、损坏/旧库、CLI/API 一致性、截断及 HTML 文本转义。
  • Fixture provenance gate、Ruff、Black、basedpyright(0 errors)、git diff --check。
  • 独立 worktree 最终全量复跑:1461 passed(Python 3.12);覆盖率 91.71%,import backend / allocator / mutator 的独立门槛均通过。
  • 离线非隔离构建 wheel、audit_wheel.py 内容审计、clean_wheel_agent_acceptance.py 均通过。隔离检查固定当前运行时的 PYTHONUSERBASE 以复用预装依赖;wheel 本身在临时 venv 内安装并验证导入路径,不是全新依赖解析测试。

✅ Checklist

  • Code follows project guidelines
  • English/Chinese documentation updated
  • Changes tested locally
  • Type checking has zero errors; informational warnings are not the gate

Snapshot Runtime Provenance

  • Snapshot provenance evaluation completed
    Snapshot provenance decision: updated

snapshot/PROVENANCE.md 追加本地结构化帧落盘的来源记录,既有记录及上游许可映射不变;base/head provenance guard 已验证。

📋 Additional Notes

import_format_version 从 2 升至 3,旧导入缓存会重建。已有文本查询继续兼容旧数据库;新增帧查询需要从原始 snapshot 重新导入,分析不会原地迁移或猜测原始帧。树使用事件之后的 active block 占用,pending-free 到 free_completed 才剔除,宽度不表示 CPU 时间或 reserved 内存。

pt-snap query snapshot.db --template-use event_frames --params '{"event_id":100}' --json
pt-snap report memory-tree snapshot.db --event-id 100 --format html > memory-tree.html

Store original frame fields and positions, then aggregate active memory by caller path with inclusive and self occupancy. Add shared queries plus text, JSON, and interactive HTML reports; rebuild old import caches.

Fixes #206

Copy link
Copy Markdown
Owner Author

已基于最新 main 的 #230/#231 内容重整单库功能,提交新草稿 #232 供审查。旧分支直接合入会混用 standalone format3 和 native format2,且 native writer 不走 standalone frame 写入路径;新实现显式隔离 producer/version/cache/frame 能力,保留当前 dataset frameJson/coverage 读取,暂不扩展跨片树。

同时补强损坏/截断帧、非整数position及路径树守恒验证。新 PR 的完整测试和 CI 正在跑;真实 Chromium 交互因环境socket限制尚未验收,已有实际renderer JS的DOM交互证据,边界在 #232 明确说明。

本条仅标记替代审阅入口,旧 #207 和 #206 暂未关闭,不将新草稿宣称已合入。

Copy link
Copy Markdown
Owner Author

替代实现 #232 已合入 main,merge commit 为 cd1aac689f653e2701334d26ae1f25489f7f5af9;合并后的 main CI 已 7/7 jobs 成功。

单库有序帧、事件时刻路径树与 HTML 可达性验收已在 #232 完成,#206 按原定单库范围收尾。本 PR 的旧方案由 #232 取代,不再合并,现关闭;保留原正文和分支供追溯。

@codeasier codeasier closed this Oct 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEATURE] 保留原始有序调用栈帧并支持事件时刻内存树与火焰图

1 participant