前言¶

在 DeepSeek Harness (DSH) 環境中開發智能體時，對輸入流的控制直接影響工作流的效率。默認的輸入行爲（例如在會話繁忙時按 Enter）往往無法滿足精細化編排的需求。dsh-steer-button 插件通過覆蓋運行會話的輸入行爲，提供更直觀的隊列管理方式。

這是什麼¶

dsh-steer-button 是一個 DeepSeek Harness 插件，由開發者 lyuwen 維護。它解決了在智能體運行期間，Composer 輸入框缺乏明確隊列控制的問題。插件通過三種交付模式，讓開發者能夠清晰地管理消息的發送時機和上下文關係。

核心功能¶

插件主要提供以下功能：

1. 三種交付模式

   • Queue 模式：按下 Enter 鍵，消息進入隊列。該消息將在當前步驟完成並提交觀察結果後，與觀察結果一同在下一輪 LLM 請求中發送。當前步驟不會被中斷。
   • Steer 模式：按下 Cmd/Ctrl + Enter，中止當前正在進行的 LLM 流式輸出，保留部分輸出作爲中斷的消息，隨後用新請求繼續對話。
   • Backlog 模式：按下 Cmd/Ctrl + Shift + Enter，使用 DSH 原生的整輪隊列模式。消息會等待當前整輪對話結束後，作爲獨立的下一輪運行。

2. 隊列可視化與交互

   • 隊列條帶：所有待處理的消息會顯示在文本框上方的隊列條帶中。
   • 編輯與撤銷：編輯按鈕將文本移回文本框進行自由編輯；向上箭頭 (↑) 可將最近一條已排隊消息拉回文本框。
   • 停止操作：按下 Esc 鍵，停止當前運行的智能體，並取消待處理隊列，將已提取的消息作爲轉向提示重新提交。

3. 狀態控制

   • 按鈕在智能體空閒、空白會話或已刪除會話時自動隱藏。
   • Esc 僅對當前可見會話生效，且僅在該會話運行時響應。

安裝與啓用¶

插件依賴特定的 DSH 版本和 React 環境。

依賴要求：
* DeepSeek Harness 版本：0.1.5-rc.1 或 0.1.5-rc.2
* React：18.2.0 或更高版本
* @deepseek-ai/cordis：^4.0.1

注意事項：
* 安裝或更新包後，必須重啓配置文件（Profile），頁面刷新無法生效。
* 插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證（MIT）。

典型用法¶

1. 排隊發送：在智能體思考過程中，輸入文本並按 Enter，文本會進入隊列，等待當前步驟結束。
2. 中途轉向：輸入指令並按 Cmd/Ctrl + Enter，強制中斷當前思考，立即應用新指令。
3. 整輪發送：輸入文本並按 Cmd/Ctrl + Shift + Enter，將消息放入原生回溯隊列。
4. 停止並處理：按 Esc 停止運行，將待處理隊列中的消息提取出來作爲新的轉向提示。
5. 修改草稿：在文本框按 ↑，將最近一條排隊消息拉回編輯。

適用場景¶

適合需要在智能體運行期間動態調整輸入流、需要精細控制上下文注入時機（例如在觀察結果之後注入）的開發者。對於習慣使用原生回溯隊列但希望擁有更直觀編輯界面的場景也適用。

短結尾¶

dsh-steer-button 通過重寫輸入行爲，將 Queue、Steer 和 Backlog 三種模式標準化。對於需要精細管理智能體輸入流的開發者，這是一個實用的工具。

• GitHub: https://github.com/lyuwen/dsh-steer-button
• 目錄: https://www.skillhub.cn/plugins/lyuwen/dsh-steer-button