概览
dsh-compact-agents
源码级技术说明DeepSeek Harness 会话上下文强制压缩插件:模型可调用的 compact_agents 工具,忽略自动压力阈值,覆盖进程内所有活会话(主会话/子代理/AgentTeams 成员),忙则排队、本轮结束补压,逐目标回报遮蔽节点数与估算 token 数。Session-context force-compaction plugin for DeepSeek Harness: a model-callable compact_agents tool that ignores the automatic pressure threshold and covers every live session in the process (main session, sub-agents, AgentTeams members alike), queues a busy target and compacts it when its turn ends, and reports shadowed node counts and estimated tokens per target.收起技术说明
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **只覆盖活着的会话**：已结束、已归档的会话拿不到 Agent 句柄，事后压缩也不省 token。 - **压缩不是免费的**：每个目标要真实调一次摘要模型，本身有 token 成本。 - **单个超大保留单元无法修复**：契约明确表面压缩修不了这种情况，回报 `noop`。 - **回合结束预压只覆盖一半情形**：跨线若由你的新消息自己造成（上一轮结束时离得远、你贴了一大段），预压当时不在带内，回答开头仍会等一次摘要 —— 判定点无法早于那条消息的存在。 - **`scope: "self"` 是异步的**：工具立刻返回 `queued`，真正的压缩发生在本轮 turn 结束之后，结果写进 DSH 日志而不是工具返回值。 - **已 composed 的会话拿不到新工具**：preset 改动只对新会话生效；老会话需新开（重启会丢成员会话）。 - **不做孤儿数据 / 状态清理**：本插件无状态（零持久化、零网络、不改变自动压缩策略）。 - **只支持 DSH 开发检出布局**：安装脚本要求检出里同时有 `packages/core/tools` 与 `vendor/cordis`；全局 `npm i -g` 的布局未验证。 - **插件页的启用 / 停用开关只管浏览器 half**：关掉它，动的是宿主组成里那一行（`compact-agents-client-host`），表单不再出现；而 `compact_agents` 工具由 preset 行提供，与这个开关无关，照常可用。 - **随包发行的 preset 会被它自己的插件升级冲掉**：`<profile>/node_modules/@linxin666/*/presets/*/agent.cordis.yml` 里那一行是安装时插进去的，插件升级会整份重写掉它；重跑 `scripts/install.mjs` 即可。同一处还有一层遮蔽：同 id 的发行 preset 会盖掉用户自建的 preset。