长期运行的智能体任务会积累大量工具输出，导致上下文迅速膨胀。DeepSeek Harness 的设计理念是“一切皆插件”，允许在不修改核心代码的情况下扩展上下文管理能力。dsh-context-compression-improved 是 dsh-context-compression-selector 的改进分叉，专注于提供可审计的工具结果上下文压缩策略，并新增了正交的代码骨架压缩门。
这是一个为 DeepSeek 模型优化的上下文压缩选择器插件。它通过预压缩、聚合替换、历史紧凑等机制减少上下文长度。与上游的主要区别是增加了代码骨架压缩门，专门处理超大源代码工具结果，在保留关键声明的同时大幅缩减冗余代码体。
核心功能¶
该插件提供多种压缩策略，均记录了决策日志（阶段、压缩器、触发条件、跳过原因及 token 数）：
- Fresh 预压缩：在模型接收新工具结果之前，先对超大的结果段进行压缩。
- Aggregate 预压缩：当工具结果材料增长超过预算时，再次对新鲜材料进行压缩。
- 历史 / 微紧凑：用符合条件的旧工具结果替换当前结果，同时保留最近的上下文。
- TailTrim：可选的自定义尾部减少路径。
- Native profile：显式保留 Harness 风格的 head/middle/tail 剪切。
- 代码骨架门：这是新增的正交功能。当启用时，超大源代码工具结果（如
read_file）首先尝试骨架减少：保留导入和类型/函数/类声明，省略函数体，但保留函数体中的错误行。如果骨架无法生成或验证，则回退到原始头部修剪。
安装与启用¶
通过插件安装：
dsh plugin --profile web add dsh-context-compression-improved@dsh-0.2.0
安装后，进入 Harness 的设置界面。在“Context Compression Selector”设置区域，选择一个压缩配置文件，设置“Auto Compact trigger level”，并切换“Code skeleton compression”开关。该开关默认为关闭状态。
适用场景与注意¶
- 模型支持：仅支持 DeepSeek 系列模型，包括
deepseek-v4-flash、deepseek-v4-pro和deepseek-v4-flash-vision-exp。插件依赖官方 DeepSeek 分词器进行无损测量和有损压缩。如果缺少正确的分词器，插件会回退到保留原始结果。 - 代码骨架默认关闭：配置项为
codeSkeleton: { enabled: false }。只有手动开启后，对超大源代码结果才会生效。 - 会话冻结：设置修改后，仅对新建的会话生效，已运行的会话配置不变。
- 代码格式：
codeSkeleton配置项必须是{ enabled: boolean }格式，格式错误会在运行时抛出异常。
该插件通过分层压缩策略和代码骨架门，帮助开发者控制上下文长度，提升 DeepSeek 模型的推理效率。项目遵循 MIT 许可证，源码托管在 GitHub。
