前言¶
跑 DSH 智能体时,常见只有两种结局:让它继续跑,或者点停止整轮作废。中间若只想「这一步先别往下发模型请求、等我看完再说」,用停止会丢进度、重开又要多耗 token。下面介绍社区插件 dsh-breather(维护者 zrrrrrrr77),它在「正在运行」和「终止」之间加了一个挂起态:当前步骤跑完后停住,继续时不重发请求、不重复工作。
这是什么¶
dsh-breather 是 DeepSeek Harness(DSH)的客户端类插件,仓库 github.com/zrrrrrrr77/dsh-breather,目录页 skillhub.cn/plugins/zrrrrrrr77/dsh-breather。包版本 0.3.3,许可证 MIT,声明的 DSH 引擎范围为 >=0.2.1-rc.2 <0.3.0-0(预发布 rc 需带 semver 下界 -0,否则安装可能被拒)。
插件由宿主半与浏览器半组成:宿主在每次发起模型请求前挂闸门;浏览器半在输入框旁提供按钮,并可选地冻结运行计时与侧栏状态。路由固定为 /api/session-pause,不可通过配置改路径(旧版 path 项在 0.3.0 起已移除且填了也不生效)。
核心功能¶
零成本暂停与继续¶
暂停本身不发出新请求。用户点 暂停 后,当前这一步会先跑完(流式输出、进行中的工具调用不会被打断);在下一次模型请求之前回合被挂住,按钮变为 继续。点继续后闸门放行,从停住的地方接着跑,不重发请求、不重复 token 消耗。只有手动点继续、或在暂停期间自己发送新消息才会恢复;子代理结算、定时提醒等后台唤醒不会解除暂停。
挂住前按钮可显示「暂停中…」,此阶段再点一次等于取消本次暂停请求。挂住后无超时:不点继续可一直保持暂停。
界面与计时¶
- 输入框右侧(模型选择器左边、与停止按钮同一行)增加 暂停 / 继续 按钮。
- 对话下方「深度求索中,用时 X」在暂停时冻住并变为「已暂停 · X」,流光动画停止;暂停时段不计入计时,恢复后从冻住的数字继续累加。
- 左侧会话列表:被暂停的行用蓝色暂停符号替代转圈;悬停卡片通过核心
sidebar.session.row.hover插槽提示继续方式。 - 暂停期间按停止或 Esc Esc 仍可按原逻辑终止,闸门随回合取消松开。
作用域与限制¶
- 单次暂停只作用于当前会话、当前这一轮(turn);不暂停子代理、后台任务和定时提醒。
- 不能立刻打断正在流式输出的那条回复;要立即停请用原有停止按钮。
- 同屏有子代理内嵌会话时,插件只接管主对话的计时器;认不出主对话时宁可不改 DOM,也不误改子代理计时。
- 回合总结里「深度思考了 X」按
turn.end - turn.start统计,包含暂停时段——插件为兼容多版本不改底层;重启 DSH 后暂停不保留,再点继续等价于终止并发一条「继续」类提示,会消耗 token。
配置¶
在 cordis.patch.yml 的 config 中:
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关 |
engagedTimeoutMs |
0 |
挂住超时毫秒数;0 表示永不自动放行 |
安装与启用¶
官方安装命令(资料原文):
dsh plugin --profile desktop add dsh-breather
安装后需完全退出 DSH 再打开(宿主半在启动时加载);浏览器半随页面刷新生效。包声明 dsh.bundle,会把 cordis.patch.yml 追加进 profile 并注册宿主插件行。
卸载:
dsh plugin --profile desktop remove dsh-breather
验证发布包时,README 建议用独立 profile,避免 pnpm 操作误动手装插件目录:
dsh --profile breathe-test --from-default-profile desktop
dsh plugin --profile breathe-test add dsh-breather
dsh --profile breathe-test
典型用法¶
- 会话运行中,在输入框右侧点 暂停。
- 等待当前步骤结束;按钮变为 继续,计时与侧栏进入已暂停态。
- 看完上下文或切去做别的事后,点 继续,或直接在输入框发新消息(视为继续)。
- 若需立刻中止整轮,仍用 停止,不要用暂停代替。
开发机若仍挂着历史包名 dsh-session-pause 的 Junction,README 说明旧 row 仍可加载,正常用户以 dsh plugin add dsh-breather 为准;换装时须先删 profile 里手写 row 再 remove 旧依赖,否则可能启动报错。
适用场景与注意¶
适合需要在长回合、多步工具调用之间人工审一下再往下跑的 DSH 桌面用户,且能接受「暂停在下一步请求前生效、不能截断当前流式输出」的语义。
插件以当前 DSH 进程权限运行;安装前请自行查看 仓库源码 与 MIT 许可证。SkillHub 目录为社区生态站点,与 DeepSeek / 幻方无官方从属关系。
核心 DOM 改版可能导致计时或侧栏图标的「接管」短暂失效:控制台会 warn,暂停按钮 title 会提示,暂停 / 继续与零成本恢复不受影响;钩子恢复后会自动撤销失效标记。可选地对安装包 app.asar 打 tools/patch-core-row-slot.mjs 补丁,让侧栏图标走核心插槽(升级 DSH 需重打,非必需)。
结尾¶
dsh-breather 把 DSH 对话从「只能跑或停」扩展成「步骤间可挂起、继续不重发请求」,并配合冻结计时与侧栏状态,方便在长任务里临时让出注意力。进一步了解可看目录页 skillhub.cn/plugins/zrrrrrrr77/dsh-breather 与 GitHub github.com/zrrrrrrr77/dsh-breather。