MIT 许可的 DeepSeek Harness 上下文压缩插件,是 dsh-context-compression-selector 的改进分支,新增默认关闭的代码骨架闸、可选压缩策略与可审计的省 token 统计,通过 `dsh plugin add` 装进 dsh profile。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-15
许可证
MIT
01它能帮你完成什么?
让长时间运行的 DeepSeek Harness 会话不超出上下文预算——把持续累积的工具结果压缩掉
按可选、可审计的策略(Fresh / Aggregate / History micro-compact / TailTrim / Native)产出的更短工具结果上下文,并为每次裁剪记录阶段、reducer、触发条件、跳过原因与精确 token 数
需要跑长程多轮编码任务的 DSH 用户:工具输出越滚越大,最后先把上下文窗口撑爆
把首次出现的超大源码工具结果压成「导入 + 声明」骨架,而不是直接砍头剪裁
保留 import 与类型 / 函数 / 类声明、函数体用标记省略、被省略函数体里的报错行仍然保留的骨架结果
经常用 `read_file` 这类工具读取大源文件、单个结果就吃满上下文窗口的团队
02如何接入 DeepSeek Harness?
前置条件
- Node `^22.19.0 || >=24` 与 pnpm `11.7.0`(README 明列的要求)
- 一个出现在生成式支持列表里的 DeepSeek Harness rc 版本——覆盖 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 / 0.2.1 七条线、共 21 个 rc 发布
- 仅支持 DeepSeek 模型:无损测量与有损压缩都依赖随包内置的官方 DeepSeek tokenizer
安装步骤
- 01
在目标 Harness profile 里从 npm 安装:`dsh plugin --profile web add dsh-context-compression-improved@latest`(README 的推荐路径,一个版本覆盖全部受支持的 Harness 版本线)
$ dsh plugin --profile web add dsh-context-compression-improved@latest
- 02
用 `dsh --profile web --dump-config` 打印该 profile 的配置
$ dsh --profile web --dump-config
- 03
源码构建替代方案:`git clone https://github.com/drscrewdriver/dsh-context-compression-improved.git`,再执行 `pnpm install --frozen-lockfile` 与 `pnpm build`,然后打包 selector 包并加入 Harness profile
$ git clone https://github.com/drscrewdriver/dsh-context-compression-improved.git
- 04
在该插件的设置区选择压缩策略、设定 Auto Compact 触发档位,并按需打开代码骨架压缩开关(出厂默认 `codeSkeleton: { enabled: false }`)
验证接入成功
- 安装后执行 `dsh --profile web --dump-config`(README 紧接安装命令给出的命令),检查打印出的 profile 配置里是否列出 `dsh-context-compression-improved`
- 设置里的开关随改随存,重新加载后仍显示已保存的状态
- 按仓库安装指南 `docs/installation.md` 中的验证步骤逐项确认(README 指向其中的 verification 与 uninstall 步骤)
回滚
- 卸载步骤写在仓库安装指南 `docs/installation.md` 里
- 删除 `~/.dsh/storages/dsh-context-compression/stats.sqlite` 即可把持久化统计彻底重置
03DSH 适配与能力边界
以 `dsh plugin --profile web add …` 装进 dsh profile 的 DeepSeek Harness 插件;只调用公开的 plugin / profile API,不修改 Harness 核心代码
代码骨架压缩闸(code skeleton gate)
过大的新鲜源码工具结果(例如一次大的 `read_file`)→由 import 与类型 / 函数 / 类声明组成的骨架,函数体用标记省略,被省略函数体里的报错行保留
默认关闭——`codeSkeleton: { enabled: false }`,需要手动打开骨架生成或校验失败时回落到原来的头部剪裁压缩策略(profiles)
新鲜与累积的工具结果上下文→预压缩的新鲜片段、二次压缩的聚合内容、被替换的旧历史结果,以及可选的 TailTrim 与 Harness 风格的 Native 剪裁
可审计的决策记录
插件做出的每一个压缩决策→阶段、reducer、触发条件、跳过原因,以及可获取时的精确 token 数
压缩监控面板与 `/ccip` 命令
正在运行压缩的会话→净 / 毛节省量、偏移、上下文占用、缓存命中率与成本估算,紧挨着会话的上下文趋势图
`/ccip` 可按会话恢复或关闭压缩(`session <id|latest|off>`)SQLite 统计持久化
压缩决策与请求边界→跨宿主重启保留的存量、累计与省下金额三项统计,历史会话从磁盘行为记录回填
写入 `~/.dsh/storages/dsh-context-compression/stats.sqlite`;驱动缺失或写入失败会退化为内存回退记录里只有计数、序号、会话标识与枚举组件名,原始文本与自由文本不入库
04适合谁?何时不该用?
适合
- 需要跑长程多轮编码任务的 DSH 用户:工具输出越滚越大,最后先把上下文窗口撑爆
- 经常用 `read_file` 这类工具读取大源文件、单个结果就吃满上下文窗口的团队
不适合
- 仅支持 DeepSeek 模型:无损测量与有损压缩依赖随包内置的官方 DeepSeek tokenizer(`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`),其他情况一律 fail-open,保留原始工具结果。
- 代码骨架闸受测量条件约束:必须能拿到精确的 DeepSeek tokenizer,拿不到就 fail-open,不做压缩。
- 设置是会话冻结的:与所有 selector 设置一样,改动只影响之后新观测到的会话,正在跑的会话沿用旧配置。
- `codeSkeleton` 必须严格是 `{ enabled: boolean }`;格式不对时运行时会抛错,浏览器界面里显示为不可读。
- README 建议使用自建 OpenAI 兼容的 `/v1/responses` 端点,而不是官方账号的 Messages API 路由——后者的恢复重放 400 无法从插件侧修复。
05兼容性、维护与安全提示
- 仅支持 DeepSeek 模型:无损测量与有损压缩依赖随包内置的官方 DeepSeek tokenizer(`deepseek-v4-flash`、`deepseek-v4-pro`、`deepseek-v4-flash-vision-exp`),其他情况一律 fail-open,保留原始工具结果。
- 代码骨架闸受测量条件约束:必须能拿到精确的 DeepSeek tokenizer,拿不到就 fail-open,不做压缩。
- 设置是会话冻结的:与所有 selector 设置一样,改动只影响之后新观测到的会话,正在跑的会话沿用旧配置。
- `codeSkeleton` 必须严格是 `{ enabled: boolean }`;格式不对时运行时会抛错,浏览器界面里显示为不可读。
- README 建议使用自建 OpenAI 兼容的 `/v1/responses` 端点,而不是官方账号的 Messages API 路由——后者的恢复重放 400 无法从插件侧修复。
- 源码构建与开发流程要求 Node `^22.19.0 || >=24` 与 pnpm `11.7.0`。
- 这是 WilliamShi666/dsh-context-compression-selector 的非官方社区分支,与 DeepSeek 无隶属关系、也未获其背书;MIT 下保留上游版权声明。
MIT · latest release v0.11.2 (2026-11-14T17:14:44Z)
06常见问题
打开代码骨架闸会不会改变我已经选定的压缩策略?
不会。它和策略是正交的:`balanced`、`savings`、`cache-strict`、`adaptive`、`custom`、`off`、`native` 全都能用这道闸,而且默认关闭,把 `codeSkeleton.enabled` 设为 true 之前不会有任何变化。
换成非 DeepSeek 模型还能用吗?
不能。本项目只支持 DeepSeek 模型:无损测量与有损压缩依赖随包内置的官方 DeepSeek tokenizer,其他情况一律 fail-open,保留原始工具结果。
骨架化会不会反而让上下文更糟?
README 明确说不会:骨架生成或校验失败就回落到原来的头部剪裁,这道闸永远不会让上下文变差。
改了设置,当前正在跑的会话会立刻生效吗?
不会。与所有 selector 设置一样是会话冻结的,改动只影响之后新观测到的会话。
省下的 token 统计存在哪里、都记了什么?
存在 SQLite:`~/.dsh/storages/dsh-context-compression/stats.sqlite`,跨宿主重启保留,删掉文件即彻底重置。记录里只有计数、序号、会话标识与枚举组件名,原始文本和自由文本从不入库。
07相关的 DSH 工作流
dsh-univer-office
作者 dream-num
在 DSH 内预览、创建与编辑表格、文档和幻灯片,由 Univer 驱动
clearai-dsh
作者 clearailhc
ClearAI:以本体为纲的原生 DSH 插件 —— 经证据核验的研究长成可浏览的领域本体。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 鱼的记忆:给会话一份会淡忘的长期记忆,每条都带时间。名字里的「鱼」来自 DeepSeek 的鲸鱼。
dsh-trading
作者 zhu1090093659
基于 DeepSeek Harness 的智能体原生交易终端,三栏界面聚合币圈、美股、A股与港股,内置 19+ 可热插拔连接器,默认模拟交易并需人工确认。
08数据与来源
The plugin uses only public Harness extension APIs and does not modify Harness core code.
- Built and tested against the official DeepSeek Harness releases; peers declare the full supported-hosts enum
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
