Skip to content

v1.3.2:TUI 内存快照调试

发布日期:2026年3月25日


🎯 一句话总结

新增堆内存快照功能,可以抓取 TUI 和 Server 进程的内存状态,方便排查内存问题。


🆕 新功能:堆内存快照

这次更新了什么?

TUI 新增「Write heap snapshot」命令,可以捕获 TUI 和 Server 两个进程的内存快照,分别保存为 tui.heapsnapshotserver.heapsnapshot 文件。

堆内存快照是什么?

堆内存快照(Heap Snapshot)是进程在某一时刻的内存使用"照片"。它记录了所有内存中对象的数据结构,可以帮助你发现:

  • 内存泄漏:哪些对象不应该存在却没有被释放
  • 内存占用过高:哪些数据结构占用了大量内存
  • 异常增长:内存随时间不断增长的原因

这有什么用?

如果你发现 OpenCode 运行一段时间后变慢或占用内存越来越多,可以用这个功能抓取快照,交给开发者分析问题。

如何使用?

  1. 在 TUI 中打开命令面板(Cmd+K
  2. 搜索「Write heap snapshot」
  3. 执行后会在当前目录生成两个文件:
    • tui.heapsnapshot — TUI 界面进程的内存快照
    • server.heapsnapshot — 后端 Server 进程的内存快照
  4. 将快照文件提供给 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.heapsnapshot and server.heapsnapshot files.

← 返回更新日志