DeepSeek Harness (DSH) 中的长工具结果会导致巨大的上下文压力。DSH 自带一个优秀的 LLM 压缩机制 (/compact)，但它在压力建立后才运行，且需要额外的模型调用。dsh-ledger-compact 插件在结果到达模型之前处理整形，并提供一种本地机械折页方式，无需 LLM 调用。
插件概览¶
这是一个 DeepSeek Harness 插件，用于在工具结果到达模型前进行入境整形，并提供本地机械折页功能。该插件由 telagod 维护，采用 MIT 许可证。
核心功能¶
插件主要包含以下三个功能：
- 入境整形：在空闲预步骤中冻结过大的未发送工具结果。仅处理刚完成的步骤，确保不会破坏提供者的前缀缓存。
- 机械折页：通过
/fast-compact和输入栏折叠较旧的历史记录，生成简短的折页卡片。 - 替换默认压缩：可选地重用官方引擎的
summarize挂钩，使/compact、自动压缩和溢出恢复跳过 LLM。
安装与启用¶
安装前请确保 DeepSeek Harness 版本为 >= 0.1.2-rc.1。使用以下命令安装插件：
dsh plugin --profile web add github:telagod/dsh-ledger-compact
安装完成后，重启 web profile 即可生效。插件会通过 bundle patch 插入自身 ID。
典型用法¶
插件提供以下命令：
/fast-compact
/fast-compact status
/fast-compact：手动触发机械折页。/fast-compact status：查看健康状态，包括入境整形计数器、最后错误以及压缩引擎的挂钩情况。
注意事项¶
- 依赖要求：需要
dsh >= 0.1.2-rc.1。 - 引擎兼容：不替换 DSH 引擎本身，需要保留
@deepseek-ai/dsh-compaction-basic。 - 视觉功能：不支持 vision sidecar，且
/fast-compact vision …命令已被移除。 - PNG 限制：PNG 图片功能受限于特定条件，例如模型必须明确支持
image模态，且图像成本必须低于文本成本。
