前言¶
DeepSeek Harness (DSH) 的插件生態支持針對特定場景的深度定製。在構建智能體應用時,任務級的中斷、網絡抖動或常規的低風險問題往往需要人工介入,這會顯著增加維護成本。dsh-continue 是一個 DeepSeek Harness 插件,專注於解決任務級別的恢復和安全無人值守繼續的問題。它結合了確定性恢復、精確的自適應網絡學習,以及任務範圍配置注入,旨在讓常規的低風險問題無需人工實時監控。
插件定位¶
dsh-continue 是 DeepSeek Harness 的一個可選插件,由 JuwanXu 維護,採用 MIT 許可證。
它解決的核心問題是:在模型重試和基礎網絡恢復之後,如何進行安全、確定性的任務繼續。它不替代通用的模型錯誤重試,而是作爲任務層級的繼續層,處理網絡故障後的決策、推薦選項的確認以及 Plan Mode 的自動退出。
核心能力¶
該插件提供以下經過覈實的功能:
- 安全無人值守繼續:提供安全的任務繼續機制,確保在無人值守狀態下不會執行特權或不可逆的操作。
- 確定性恢復:在下游重試之後提供確定性的網絡恢復策略。
- 精確自適應學習:支持基於 provider(提供商)、model(模型)和 error-code(錯誤碼)的精確網絡故障學習。
- 任務範圍配置注入:支持爲單個任務注入隔離的策略配置,配置會覆蓋全局默認值。
- 窄範圍自動化:將自動化限制在特定場景,包括唯一推薦答案的選擇、二進制繼續提示、有效的 Plan Mode 退出以及純文本繼續。
- 控制與記憶:支持暫停/恢復控制、持久化活動和學習事件、項目範圍的決策記憶(支持任務範圍回退)以及可驗證的手動決策來源。
- 安全邊界:配置可重試預算,並設置 fail-closed(失敗-關閉)的安全邊界。
- 僅建議模式:繼續候選僅作爲建議提供,不直接執行。
安裝與啓用¶
安裝插件不會自動改變任何任務交互、重試、學習或審批行爲。所有可執行功能默認爲關閉狀態。安裝後需要通過配置或命令手動啓用。
安裝命令如下:
dsh plugin --profile <profile-name> add dsh-continue
安裝後,需要在配置文件中開啓相應的功能模塊,或通過任務命令進行即時覆蓋。
典型用法¶
使用預設¶
插件提供三種預設配置,用於快速啓用一組功能:
/continue preset recommended
/continue preset resilient
/continue preset unattended-safe
| 預設名稱 | 啓用的功能 |
|---|---|
recommended |
啓用唯一推薦答案的選擇 |
resilient |
啓用臨時網絡恢復和推薦答案選擇 |
unattended-safe |
啓用上述功能,並增加二進制繼續確認、有效的 Plan Mode 退出以及純文本繼續 |
配置與命令¶
通過 /continue 命令集進行控制。以下爲常用命令示例:
# 查看當前狀態
/continue status
# 手動設置配置(JSON 對象)
/continue set {"network":{"enabled":true},"recommended":{"enabled":true}}
# 禁用插件對當前任務的影響
/continue off
# 重置爲全局默認配置
/continue reset
# 暫停自動化控制(支持時間單位)
/continue pause [<Nms|Ns|Nm|Nh>]
/continue resume
# 查看最近決策的解釋
/continue explain
# 管理學習機制
/continue learn <on|off|status>
/continue learn candidates
/continue learn approve <candidate-id>
/continue learn forget <record-id|--all>
全局配置示例¶
在 cordis.patch.yml 中設置全局默認值:
- id: continue
config:
defaults:
network:
enabled: true
mode: bounded
maxRetries: 5
recommended:
enabled: true
continuation:
enabled: false
優先級規則爲:任務會話覆蓋 > 插件全局默認 > 內置值。
使用注意¶
- 默認關閉:安裝後,每個可執行能力默認關閉。必須通過配置或命令顯式啓用。
- 輸入處理:插件不會使用 LLM 去猜測問題或錯誤的含義。對於未知、模糊、風險或未驗證的輸入,會委託給官方 UI 處理。
- 權限控制:插件永遠不會批准特權操作或不可逆的操作。
- 與 dsh-camel 的協作:插件不處理
RATE_LIMIT錯誤,該功能由dsh-camel處理。如果需要在 Continue 中處理RATE_LIMIT,需在配置中顯式添加並會觸發所有權重疊警告。 - 網絡恢復範圍:插件內置處理的網絡代碼爲
TIMEOUT、TRANSPORT和SERVER。其他代碼(如RATE_LIMIT)的處理邏輯需根據項目依賴的插件(如dsh-camel)進行協調。
生態背景¶
DSH 理念是「一切皆插件」,插件生態獨立於 DeepSeek 或幻方的官方關係,由社區維護。更多插件詳情及源碼可訪問插件目錄: