dsh-overflow-fallback：上下文溢出后的最后一道救援

前言¶

DeepSeek Harness 在请求超出上下文窗口时会触发压缩（compaction）。压缩不是每次都成功：一旦失败，后续每一条消息都会带着同样的超限请求再发一次，于是同一个错误反复出现，会话只能放弃。

dsh-overflow-fallback 挂在公开的 agent/request-error 瀑布上。当内置策略明确放弃这个失败时，它：

1. 确认失败码是 CONTEXT_WINDOW_EXCEEDED（不是网络、限流或鉴权）；
2. 请已加载的压缩后端以 context-overflow 触发再压一次；
3. 只有压缩真的产出了结果，才让这一轮重试一次；
4. 每个 agent 最多重试 maxAttempts 次，之后老实放弃，不制造无限重试。

它不会伪造成功、不会吞掉错误、不会改动会话日志、不会偷偷截断你的内容。

它是什么¶

dsh-overflow-fallback 是一个 DeepSeek Harness 插件，作者为 WALZX123，分类为「工作流」。插件名称是 dsh-overflow-fallback，在 GitHub 仓库中称为「溢出兜底」。它不做界面、不换压缩引擎，而是在既有策略全部放弃之后先自动再试一次；仍救不回来，就把原会话交接成一个新会话继续。

插件零运行时依赖，核心代码在 lib/ 目录，五个文件不到 700 行，可以完整读一遍。安装后不需要浏览器半区，界面上不会多出入口。

安装¶

从 npm 安装（推荐）：

dsh plugin --profile desktop add dsh-overflow-fallback

固定版本：

dsh plugin --profile desktop add dsh-overflow-fallback@0.4.0

或直接从 GitHub：

dsh plugin --profile desktop add github:WALZX123/dsh-overflow-fallback

本地开发安装：

dsh plugin --profile desktop add link:E:\path\to\dsh-overflow-fallback

安装完成后重启一次 DSH。之后改代码不必重启：输入 /reload 即可原地热重载。

配置¶

在 profile 的 cordis.patch.yml 里，对本插件那条装载行加 config：

- insert:
    - id: dsh-overflow-fallback
      name: 'dsh-overflow-fallback'
      config:
        enabled: true
        maxAttempts: 2

配置字段说明：

工具与命令¶

插件注册了几个模型工具：

recall_original 优先读内存中的父会话；DSH 重启后父会话变冷，会改用 sessionQuery 从磁盘读日志（需要日志文件仍在）。两者都不可用时才报错。

安全边界¶

完整威胁模型、代价清单与报告方式见 SECURITY.md。

兼容性¶

DSH 里主题、输入框、压缩后端都可能是第三方实现，所以本插件不假设它们存在，也不假设它们的顺序。完整规则见 docs/COMPATIBILITY.md，要点：

插件只依赖两处公开面：agent/request-error 事件与 ctx.compaction.compactIfNeeded()；任何一处改名都会在装载或调用时明确失败，而不是静默降级。

给插件作者：联动接口¶

本插件注册一个宿主服务 overflowFallback，并在 package.json 的 dshhub.capabilities.provides 里声明：

export const inject = ['overflowFallback']
export function apply(ctx) {
  const { markdown } = ctx.overflowFallback.handoffFor(session)
}

服务成员：

稳定契约（文档大小上限、锚点语法、必备章节、版本策略、失败语义）见 docs/SERVICE.md。服务是只读的：不改会话、不建会话、不发请求。

路线图¶

“续命”是真正的目标：聊死的会话不该等于丢掉的工作。兜底重试只是为了少走一步。完整版本路线见 docs/RELEASING.md。

改代码不用重启¶

两个入口，都调用 DSH 官方的 HMR 重载（ctx.hmr.reconcileProfile()）——和插件管理器装完插件后做的是同一件事：

• 人用：输入框敲 /reload，回车。命令在宿主侧注册，不占任何布局，只出现在 / 菜单里，不会和主题或其它插件冲突。
• 模型用：工具 reload_plugins，参数 ids 可指定条目，留空则重载所有改动过的。

/reload

• 不创建进程、不杀进程、不重启 desktop；
• 只重载”磁盘上的文件变了”的插件条目；
• 客户端插件如需重建 bundle，仍要刷新页面。

适用场景¶

这个插件适合以下场景：

• 在没有 GUI 入口的环境中使用 DSH（如 QQ/微信/飞书网关、--profile headless、TUI）；
• 需要在上下文溢出后自动尝试恢复，而不是让会话静默失败；
• 希望保留原有会话内容，通过新会话继续，同时能按序号或锚点回查原文。

安装前建议检查源码与许可证（MIT）。插件以当前 DSH 进程权限运行，能力范围与宿主相同，但自身已尽量压到最小。

总结¶

dsh-overflow-fallback 在 DSH 的上下文溢出场景中提供一个「最后一道救援」：在既定压缩策略放弃之后，先自动再压一次并重试；仍救不回来时，把原会话整理成交接包，在新会话里继续。它不换引擎、不加界面、零依赖，适合在各类 DSH 环境中部署，避免会话因为一次压缩失败而丢失。