返回目录

dsh-context-compression-improved

精选清单收录维护状态: 活跃

drscrewdriver/dsh-context-compression-improved

改进版 dsh-context-compression-selector,增加正交的代码骨架压缩门控,帮助 DSH 在压缩上下文时保留更有用的代码结构信息。

前往 GitHub
$ dsh plugin --profile web add dsh-context-compression-improved@latest

11

星标

1

Fork

TypeScript

语言

MIT

许可证

2026-09-05

创建于

2026-11-20

最近推送

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

安装步骤

  1. 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

  2. 02

    用 `dsh --profile web --dump-config` 打印该 profile 的配置

    $ dsh --profile web --dump-config

  3. 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

  4. 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 适配原生运行时

以 `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 下保留上游版权声明。
2026-09-052026-11-10v0.11.2

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`,跨宿主重启保留,删掉文件即彻底重置。记录里只有计数、序号、会话标识与枚举组件名,原始文本和自由文本从不入库。

08数据与来源

  • 作者声明github.com82703d80c522…

    The plugin uses only public Harness extension APIs and does not modify Harness core code.

  • 作者声明github.com82703d80c522…

    - Built and tested against the official DeepSeek Harness releases; peers declare the full supported-hosts enum

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。