dsh-memory-guard
在终端中运行以下命令:
dsh plugin install zeroed-07/dsh-memory-guard
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中打开「设置 → 插件 → 安装」,执行 dsh plugin install zeroed-07/dsh-memory-guard,或按仓库说明从 https://github.com/zeroed-07/dsh-memory-guard 安装后重启 Host 并刷新页面。
插件介绍
DeepSeek Harness 的会话日志会在一次对话里不断追加工具调用与 PTC 载荷;当单条参数或整份日志过大时,Host 可能在解析或打开会话时耗尽堆内存。真实场景里,一份解压后接近 1 GB 的日志里,绝大部分是同一段参数在 PTC start/final 中重复落盘——这类问题往往在 OOM 之前缺少可见预警。
dsh-memory-guard 在 Host 侧持续采样堆占用,并定期统计 $DSH_HOME/sessions 的总体积与最大会话;对即将执行的工具调用做体积估算,超过阈值则同步拒绝并提示分块写入或由脚本生成文件。对已写入日志的超大事件与会话体积分级告警,会话标题栏提供 MEM 与日志总量的直观读数。
对已经「冷」下来的会话,插件支持预览与确认的离线 vacuum:在保留原始 .orig- 备份的前提下,用占位符替换 oversized 参数字符串,同时满足 PTC 成对记录的 deep-equal 约束与 DSH 多帧 zstd 格式要求。配合 /memguard 命令与 memguard 工具,人和 Agent 都能查看状态或发起扫描。
适合长期跑大上下文、频繁 run_code/大文件写入,或需要维护大量本地会话目录的 DSH 用户;若你更关心「别等到打不开会话才后悔」,而不是手动删日志碰运气,这个插件就是为此设计的。
使用场景
- 单次工具参数过大导致 Host 拒绝或堆告警
- 会话目录膨胀、打开会话时堆内存吃紧
- 需要对已结束会话做离线瘦身并保留备份
适合人员
- 长期跑大上下文、频繁大写入的 DSH 用户
- 维护大量本地会话、担心日志失控的管理员
- 希望 Agent 在调用前就被参数体积约束的团队