前言¶
在 DeepSeek Harness (DSH) 的開發流程中,經常需要在智能體任務執行中途介入,提供新的指導或修正方向。直接在對話流中追加消息往往容易打斷正在進行的工具調用,或者破壞上下文的連貫性。dsh-user-steer 插件旨在解決這一痛點,它允許在任務運行中給 agent 一句指導,消息在工具批次邊界注入當前 turn,絕不打斷正在執行的工具調用。
插件簡介¶
這是一個 DeepSeek Harness 用戶中途指導(mid-turn steering)插件,由開發者 wht567 維護,遵循 MIT 許可證。它爲 DSH 提供了在智能體運行過程中進行安全、無干擾中途指導的能力。
核心功能¶
插件提供了多種指導注入方式,滿足不同場景的需求:
-
/steer <指導>—— 醒目插話
輸入該命令後,指導會以 steering 氣泡的形態進入對話,視覺上非常醒目,適合需要立即引起注意的修正。 -
/inject <指導>—— 靜默注入
指導會靜默地被模型讀取。在對話流中,它僅顯示爲一行緊湊的上下文提示,不打擾正常的對話閱讀體驗。 -
注入條
在 composer 輸入框上方,始終可見一個與輸入框等寬的注入條。支持一鍵靜默注入,方便重複使用。 -
模型側提示詞
插件會在系統提示詞中新增 mid-turn steering 章節,明確告訴模型“中途到達的消息是對當前任務的航向修正”,確保模型能正確理解指令意圖。
安裝與啓用¶
通過命令行安裝插件,安裝後需重啓 DSH 生效:
# 通過插件市場安裝(推薦)
dsh plugin --profile web add github:wht567/dsh-user-steer
# 或使用本地路徑安裝
dsh plugin --profile web add file:/path/to/dsh-user-steer
工作機制¶
插件內部通過 Agent.steer() 方法將消息推入 inbox 的 next-step 隊列。這確保了指令不會立即打斷當前進程,而是在下一個 step 邊界被認領爲真實的 user/message 事件。這種設計保證了不殺工具、不破壞角色交替,同時保持 prompt 前綴緩存完好。
典型用法¶
在對話中直接使用以下命令:
/steer 把重點放在生成報告的格式上
/inject 請忽略之前的錯誤數據,重新計算
適用場景與注意¶
該插件適合需要在智能體執行過程中實時調整方向、進行中途糾偏的開發者。使用時需注意,插件以當前 DSH 進程的權限運行,建議在安裝前檢查源碼與許可證。
總結¶
dsh-user-steer 讓開發者能夠在不中斷任務流程的前提下,精準地對智能體進行中途指導。更多細節請查看 插件目錄 或 GitHub 倉庫。