前言¶

在使用 DeepSeek Harness（DSH）或 DPH Agent 进行长对话或复杂工作流时，上下文窗口很快就会逼近上限，继续追加新指令往往会被截断或稀释。社区提供的「上下文已用 %」通常只显示一个数字，没有干预机制，开发者需要手动新建会话、复制对话摘要再切过去，这个过程容易打断思路。Context Handoff（dsh-context-handoff）是一个针对 DSH/DPH Agent 的上下文守卫插件，在本地实时监控上下文占用，接近阈值时自动把当前工作交接给一个新会话，并让新会话接着干。

它是什么¶

Context Handoff 是一个 DSH 插件，维护者为 hunyu-feng，分类为「工作流」。它通过 host 插件监听会话事件、读取 DSH 的 contextPressure 投影（与界面自带的「上下文已用 %」口径一致），再通过 UI 插件在输入框下方显示当前上下文占用与进度条。当占用超过阈值时，插件会自动生成一份交接说明、创建一个新会话、发送说明并切换过去，避免手动操作。

核心功能¶

• 实时占用显示：输入框下方显示「上下文 xx%」与进度条，根据占用情况以绿/黄/红三档提示。
• 自动交接（默认阈值 85%，每会话触发一次）：当前模型把「用户目标 / 已完成 / 未完成 / 下一步」写成不超过 800 字的交接说明；创建一个空白会话（同一工作区、同一 Agent 预设）；把交接说明作为第一条消息发给新会话；界面自动切换到新会话。
• 手动交接：点击输入框旁的胶囊「立即交接」，胶囊先变红提示，再点击一次确认才执行，避免误触。
• 失败重试：摘要或新建会话失败时会显示原因，可点击「重试」。

安装与启用¶

在本地开发环境安装插件：

dsh plugin install /path/to/dsh-context-handoff

也可以通过 plugin_manager 的 install_bundle 指向本目录。安装后重启 DSH，输入框下方出现「上下文 xx%」即生效。

典型用法¶

• 正常对话：插件持续在输入框下方显示上下文占用百分比与进度条。
• 达到阈值：当占用超过设定的阈值时，插件会自动生成交接说明并创建新会话，界面自动切换过去。
• 手动交接：需要立即切换会话时，点击「立即交接」胶囊，第一次点击会变红提示，第二次点击确认后执行。
• 失败处理：如果交接失败，插件会显示原因，可点击「重试」再次尝试。

适用场景与注意¶

• 适合需要长时间对话、复杂工作流，且上下文窗口成为瓶颈的场景。
• 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
• 插件不会写入任何数据库，只在内存中跟踪最近 64 个活动会话的 token 数。
• 交接摘要由当前配置的模型生成，走的是本机 DSH 的模型通道，不会额外上传。
• 不会修改会话历史，旧会话原样保留，可随时查看。

短结尾¶

Context Handoff 通过自动监控上下文压力并触发交接，减少了手动新建会话和复制摘要的步骤，适合需要长时间对话与复杂工作流的场景。更多细节见项目目录页与 GitHub 仓库。

• 目录页：https://www.skillhub.cn/plugins/hunyu-feng/dsh-context-handoff
• GitHub：https://github.com/hunyu-feng/dsh-context-handoff