前言¶
DeepSeek Harness (DSH) 采用插件化架构,社区生态中提供了多种工具来扩展智能体能力。在上下文管理方面,官方默认的压缩后端(compaction-basic)每次压缩都会让模型重新总结旧对话,这不仅消耗额外的 token,且结果不稳定。dsh-dcp 针对这一痛点,提供了一个确定性压缩后端。
核心定位¶
dsh-dcp 是由 fan56 维护的 DSH 插件,定位为确定性上下文剪枝压缩后端。它不调用 LLM 进行摘要,只保留对话中出现的事实(如路径、命令、报错、用户原话),因此输出稳定,相同输入永远得到相同结果。
核心功能¶
该插件主要解决以下问题:
- 零 LLM 调用摘要:压缩过程本身不消耗任何额外 token。
- 输出稳定:去除了 LLM 生成的不确定性。
- 中文友好:内容逐字保留,不做英文转写;按 CJK 真实密度计价(中/日/韩/全角约 2 字符/token),而非沿用宿主的低估值。
- 机制继承:继承了 DSH 官方的安全机制、触发策略、保留尾巴与事务锁,检查点格式兼容。
- 命令支持:提供
/dcp命令用于压缩、查看状态和调参。
安装与启用¶
安装过程非常简单,使用 npm 即可完成。
1、安装插件包:
npm i @aiwayds/dsh-dcp
2、运行初始化脚本:
npx dsh-dcp-setup
该脚本会自动处理配置备份和幂等判断,确保安装过程安全且不覆盖现有配置。
使用方法¶
插件挂载后,可以在会话中直接使用 /dcp 命令:
/dcp:立即压缩历史上下文(零 LLM 调用)。/dcp status:查看当前配置和节省的 token。/dcp set dedup true:在会话内动态调整参数。
插件支持多种触发条件,包括压力触发、溢出恢复、轮数触发(默认每 50 条 assistant message 触发一次)以及模型切换触发。
卸载¶
如需卸载,请使用官方提供的脚本或 DSH 插件管理命令。
通过脚本卸载:
npx dsh-dcp-setup --remove
通过 DSH 插件管理:
dsh plugin remove @aiwayds/dsh-dcp
注意事项¶
- 版本要求:本插件要求 DSH 版本 >= 0.1.7-rc.1,不再支持 alpha 线。
- 功能范围:插件不做语义归纳,只保留出现的事实。需要深度语义摘要的场景,建议继续使用官方的
compaction-basic。 - 计价机制:默认按 CJK 真实密度计价,中文场景下不会出现 token 预算被饿死的情况。
结语¶
dsh-dcp 适合需要稳定、低成本上下文压缩的场景,特别是中文对话。它通过代码替代 LLM 调用,大幅降低了上下文管理的成本。