dsh-compaction-local-handoff

LIMITATIONS

Known limitations

- **交接是“有界交接”，不是“智能摘要”。** 较早的决策理由、失败过的方案、跨文件的推理不会自动保留——与 ComeCode 的取舍一致。完整原文仍在会话日志里，但 **DSH 目前没有暴露给模型的“读历史”工具**（ComeCode 有 `ReadSessionContext`），所以模型只能靠重新读文件或重跑命令来恢复细节。 - **preset 清单被冻结。** 见[为什么 `cordis.patch.yml` 是生成出来的](#为什么-cordispatchyml-是生成出来的)：harness 升级改动 shipped preset 后需要重新跑 `npm run sync:presets`。 - **极短历史下会拒绝压缩。** 后端要求检查点必须小于被遮蔽的内容，而 DSH 会给每条检查点加一段固定 preamble（约 350 字符）；被遮蔽区间小于约 100 token 时无法再压，压缩会报 `summary is not smaller than the shadowed content`。这与默认后端的行为一致，且是非致命的（自动路径记一条警告后继续本轮）。 - **窗口贴着固定前缀时会反复压缩。** 阈值是 `min(W×0.8, W−O−headroom)`，而 system prompt + 工具 schema 是不可压缩的固定前缀。如果 `W` 只比前缀大一点（例如把 512K 调到 12K 做测试），每个 step 都会越过阈值、反复触发压缩。这是上游阈值策略的固有行为，不是本插件引入的；真实窗口下不会出现。 - 单条不可分单元（一次超大工具调用）仍无法被压缩。 - 图片内容不进入交接：只保留文本块。