dsh-zcontext
在终端中运行以下命令:
dsh plugin install zsagi1368/dsh-zcontext
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在已启用插件支持的 DeepSeek Harness 中执行 dsh plugin install zsagi1368/dsh-zcontext,即可从 https://github.com/zsagi1368/dsh-zcontext 安装 dsh-zcontext。
插件介绍
官方 DeepSeek Harness 自带 compaction-basic,会在压力下把整段窗口压成摘要,但缺少由模型主动、分段推进的增量折叠。超长对话里窗口很快被占满,要么频繁触发硬压缩,要么在工具与多轮往返中失去对「哪些段已经可以收束」的精细控制。dsh-zcontext 在官方插件面上复现「模型写摘要、模型选区间、缓存感知的轻推」这一机制:只走 surface-replace,与上游压缩并存而不拦截。
核心是一套围绕折叠生命周期的工具与观测:zctx_fold / zctx_unfold / zctx_recall / zctx_status 让模型在受约束的校验下批量提交折叠,保留最近尾部、首条用户消息与系统头等不可动区域;静态 guidance 与可配置的占用率 nudge 教会模型何时折、折什么;账本完全由会话日志重建,无独立存储,恢复与分叉自然延续。还可选启用预检(observe/enforce)、自带端点的 zctx 路由、以及 v0.3.0 的服务端 autoFold;安装后即开始记录可观测量,便于对照真实会话调参。
适合需要在 Harness 上跑很长 agent 会话的开发者与高级用户:希望窗口长期保持低位占用、又不愿 fork 或打补丁改宿主的人。也适合愿意对照 zctx_status 输出做校准反馈的人——README 标明仍为 BETA,估计阈值未充分校准,官方 compaction 仍是最后防线。若你只想要「压力来了再整窗压缩」,继续用内置能力即可;若要在模型侧 proactively 做小步折叠,这个插件是对应的官方面实现。
使用场景
- 在 Harness 上跑数小时 agent 对话,需要主动缩小工作窗口
- 多轮工具调用堆叠导致上下文逼近上限,希望模型分段折叠而非整窗硬压
- 需要检索已折叠历史或在 fold/unfold 间切换而不丢失会话日志
适合人员
- 在官方 Harness 上使用插件、不愿 fork 宿主的开发者
- 愿意根据 zctx_status 与账本输出参与 BETA 校准的高级用户
- 长链路 coding/agent 工作流且接受与官方 compaction 并存的团队