Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,35 @@
# Changelog

## [0.2.0] - 2026-08-08

本次发布重点补齐大型 PyTorch 内存快照的拆分与可追溯导入能力,并将快照运行时转为项目首方维护。导入和回放链路同时获得显著的时间与内存优化,SnapshotDB 查询性能和失败安全性也进一步提升。

### 新增

- 新增 `pt-snap split`,支持按设备使用 `--slices` 或 `--max-entries` 拆分快照,输出可独立回放的 pickle 或规范化 JSON 切片,并在发布前逐一执行回放验证。
- 为导入生成的 SnapshotDB 写入 `pt_snap_metadata`,记录源文件 SHA-256、设备选择、格式版本、导入器版本和完成时间;匹配的数据库可直接复用,`--force` 可强制重建。
- 新增 `pt-snap metadata`、`SnapshotAnalyzer.get_database_metadata()` 和 MCP `get_database_metadata`,统一查看数据库来源与兼容性信息。
- 新增安全的 pt-snap 环境安装与校验 skill,避免在错误的 Python 环境中安装或执行分析。

### 性能

- 优化 SQLite 导入事务、缓存和同步设置,并为常用 trace、block 查询列增加索引。
- 使用二分查找和已发现索引复用优化快照回放,同时保持 segment 顺序和边界行为。
- 数据库导入不再为每个 frame 引用构造 `Frame` 对象;基准样本显示耗时降低 58% 到 63%,峰值 RSS 降低 84% 到 87%,数据库结果保持一致。

### 稳定性与工程

- 将原 vendored snapshot runtime 迁移到首方 `pt_snap_cli.snapshot`,补充许可证、来源记录、变更治理和完整的回放/导入基线测试。
- 导入先在临时数据库中写入并校验 metadata,再原子发布;源快照在导入期间发生变化或导入失败时保留已有目标数据库。
- 拆分使用同文件系统 staging 目录和 no-replace 原子发布,失败时不覆盖或合并既有输出,也不遗留部分结果。
- 完善中英文拆分、数据库和快速入门文档,并使 GitHub Release 标题与发布标签一致。

### 兼容性提示

- 旧版或外部生成且没有 `pt_snap_metadata` 的兼容 SnapshotDB 仍可查询;再次导入时会重建一次后再参与缓存复用。
- `pt-snap import` 在缓存命中时输出 `Reused:`,重建时可能额外输出 `Cache miss:`;依赖精确终端文本的调用方需要相应调整。
- MCP 依赖范围收窄为 `mcp>=1.0.0,<2`。原内部 vendor 命名空间已随首方 runtime 迁移移除。

## [0.1.1] - 2026-06-22

本次发布将 pt-snap-cli 从早期查询工具推进为面向 PyTorch 内存快照分析的 CLI + MCP 双入口工具。核心变化集中在三方面:导入链路补齐、面向 Agent 的 MCP 集成,以及更实用的内存峰值分析与查询体验。由于仓库当前没有历史发布 tag,本条目以现有 `origin/main` 全量历史和已合并 PR 元数据为依据整理。
Expand Down
Loading