v1.3.2:TUI 内存快照调试
发布日期:2026年3月25日
🎯 一句话总结
新增堆内存快照功能,可以抓取 TUI 和 Server 进程的内存状态,方便排查内存问题。
🆕 新功能:堆内存快照
这次更新了什么?
TUI 新增「Write heap snapshot」命令,可以捕获 TUI 和 Server 两个进程的内存快照,分别保存为 tui.heapsnapshot 和 server.heapsnapshot 文件。
堆内存快照是什么?
堆内存快照(Heap Snapshot)是进程在某一时刻的内存使用"照片"。它记录了所有内存中对象的数据结构,可以帮助你发现:
- 内存泄漏:哪些对象不应该存在却没有被释放
- 内存占用过高:哪些数据结构占用了大量内存
- 异常增长:内存随时间不断增长的原因
这有什么用?
如果你发现 OpenCode 运行一段时间后变慢或占用内存越来越多,可以用这个功能抓取快照,交给开发者分析问题。
如何使用?
- 在 TUI 中打开命令面板(
Cmd+K) - 搜索「Write heap snapshot」
- 执行后会在当前目录生成两个文件:
tui.heapsnapshot— TUI 界面进程的内存快照server.heapsnapshot— 后端 Server 进程的内存快照
- 将快照文件提供给 OpenCode 开发者或自行分析
提示:快照文件可能比较大,不建议频繁生成。建议在发现内存异常时生成一次即可。
📊 要不要升级?
| 情况 | 建议 |
|---|---|
| 遇到内存问题 | ✅ 推荐 |
| 想帮助排查问题 | ✅ 推荐 |
| 正常使用中 | 可以等下次 |
⬆️ 升级命令
bash
opencode upgrade📋 技术细节
点击展开完整更新列表
TUI
- Added heap snapshot functionality allowing users to capture memory snapshots of both TUI and server processes via the "Write heap snapshot" command. Snapshots are saved to
tui.heapsnapshotandserver.heapsnapshotfiles.

