前言¶
跑 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。