dsh-plugin-compact-button：DeepSeek Harness Web 界面压缩控制

在 DeepSeek Harness 的 Web 界面中，会话压缩通常需要手动输入命令。dsh-plugin-compact-button 在模型选择器左侧添加了一个按钮，直接调用部署自带的 /compact 命令，将压缩操作转化为一次点击。

插件定位¶

名称：dsh-plugin-compact-button
作者：liutian11451-png
许可证：MIT

核心功能¶

该插件向 Web UI 提供了一个压缩手势。它通过 Session 的命令通道提交裸 /compact 行，确保了所有相关记录（持久化尝试、压缩锁、摘要路由、渲染的流程节点）均由 /compact 拥有。

1. 空白会话处理：会话为空时不渲染任何内容，因为没有历史记录可供压缩。
2. 代理运行状态：当代理正在运行时，按钮变灰且不可点击，保持其普通标签。手动压缩需要一个空闲的代理。
3. 压缩状态反馈：压缩期间显示“Compacting…”标签，直到压缩回合结束。
4. 拒绝原因展示：在 Composer 行上方显示内联拒绝原因。传输失败显示主机的消息；未安装 /compact 命令则报告为缺少能力。
5. 包声明：插件声明了 dsh.bundle。

安装与启用¶

使用官方插件管理命令安装。由于插件声明了 dsh.bundle，dsh plugin 会自动在配置文件中注册其补丁层。

dsh plugin --profile web add dsh-plugin-compact-button

请将 web 替换为您实际使用的配置文件名称。首次安装后，需要重启 dsh web 并重新加载页面；构建负载是在启动时组合的，因此初次安装时仅重新加载页面是不够的。

开发与测试¶

如果需要从源码开发或测试：

pnpm install
pnpm build       # 生成 lib/index.js 和 lib/client.js
pnpm typecheck
node smoke.mjs   # 在模拟 shell 上测试加载器契约

限制与注意事项¶

1. 前置要求：部署必须挂载压缩能力 —— 即 dsh-command-compact 加上压缩后端。如果没有该命令，按钮仍会渲染并因缺少能力而拒绝点击。
2. 运行时限制：
   • Web Profile Only：插件仅声明 platform: web，无终端界面等效物。
   • Idle Agents Only：当代理运行时禁用，与 compactNow 的要求一致。
   • No Region Selection：控制始终提交无参数的表单，因此它压缩后端的整个有用范围。
3. 行为细节：
   • 预约 ≠ 完成：命令 RPC 在主机预约该行时解析，因此“Compacting…”标签覆盖从手势到压缩回合结束的窗口。由自动策略或其他回合开始的压缩不会更改标签；控制仅在该回合运行时变灰。
   • 忙碌标签是有限的，不是精确的：如果已预约的尝试从未产生可观察的运行，则在 8 秒宽限期后释放。之后开始的压缩看起来像控制提前空闲。
4. 源码审查：此代码由 AI 代理（deepseek-flash）于 2026-09-12 生成。在使用前，尤其是允许其 prepare 脚本在您的机器上运行之前，请审查源码。

结语¶

该插件为 DSH Web 界面提供了一个标准化的压缩入口点，无需手动输入。更多细节与源码，请访问 GitHub 仓库。