From 88f049d8989fa975db2cf9236649d843d1e897bd Mon Sep 17 00:00:00 2001 From: codeasier Date: Sat, 8 Aug 2026 08:02:42 +0800 Subject: [PATCH 1/2] docs: prepare changelog for 0.2.0 release --- CHANGELOG.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index c114d02..f8d8ea5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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`。原内部 `pt_snap_cli.vendor.memsnapdump` 命名空间已随首方 runtime 迁移移除。 + ## [0.1.1] - 2026-06-22 本次发布将 pt-snap-cli 从早期查询工具推进为面向 PyTorch 内存快照分析的 CLI + MCP 双入口工具。核心变化集中在三方面:导入链路补齐、面向 Agent 的 MCP 集成,以及更实用的内存峰值分析与查询体验。由于仓库当前没有历史发布 tag,本条目以现有 `origin/main` 全量历史和已合并 PR 元数据为依据整理。 From 601125f11c21617c0f12fbf5fe1885eccf41c5cf Mon Sep 17 00:00:00 2001 From: codeasier Date: Sat, 8 Aug 2026 08:13:17 +0800 Subject: [PATCH 2/2] docs: align release notes with governance --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f8d8ea5..cc06a25 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -28,7 +28,7 @@ - 旧版或外部生成且没有 `pt_snap_metadata` 的兼容 SnapshotDB 仍可查询;再次导入时会重建一次后再参与缓存复用。 - `pt-snap import` 在缓存命中时输出 `Reused:`,重建时可能额外输出 `Cache miss:`;依赖精确终端文本的调用方需要相应调整。 -- MCP 依赖范围收窄为 `mcp>=1.0.0,<2`。原内部 `pt_snap_cli.vendor.memsnapdump` 命名空间已随首方 runtime 迁移移除。 +- MCP 依赖范围收窄为 `mcp>=1.0.0,<2`。原内部 vendor 命名空间已随首方 runtime 迁移移除。 ## [0.1.1] - 2026-06-22