dsh-composer-quick-actions 插件介紹

前言¶

在使用 DSH（DeepSeek Harness）開發智能體時，日常對話與「文件 / 目標 / 計劃 / 反饋」這四個動作的切換比較頻繁。每次都要展開右側的「+」菜單，再在「添加」小節裏點選，對高頻操作來說不夠直接。DSH 的理念是「一切皆插件」，社區裏也出現了不少類似工具，用來把常用動作從菜單中解放出來。

下面介紹的是 xdsT2 維護的 dsh-composer-quick-actions 插件，它把上述四個動作做成 composer 工具欄裏常駐的控件，減少一次展開菜單的開銷。

是什麼¶

這是一個 DSH 客戶端插件，作者爲 xdsT2。它的核心價值是把 DSH 原生「+」菜單裏「添加」小節的四項 —— 文件、目標、計劃、反饋 —— 做成 composer 輸入框工具欄裏的常駐控件，讓這些操作可以直接點擊，不用每次展開菜單。

插件適用於 DSH 的 Web / Desktop 客戶端。

核心功能¶

插件在 composer 工具欄上提供四個控件：文件、目標、計劃、反饋。每個控件對應一個底層調用，功能如下：

文件¶

點擊後打開當前輸入框的原生文件選擇器，調用 conversation.input.canPickFiles/pickFiles(sessionId)。

目標¶

點擊後在輸入框上方彈出原生樣式的目標編輯條，直接輸入目標內容。編輯條的行爲如下：

沒有目標：空輸入框；按下 Enter 或點擊 ✓ 會新建目標
已有目標：預填當前目標內容；按下 Enter 或點擊 ✓ 會更新目標
按 Esc 或點擊 ✕ 會關閉編輯條，不提交
內容爲空時，不發送請求，並提示「目標內容不能爲空」
保存失敗時，編輯條保持打開，內容不丟失，錯誤信息內聯顯示
保存中時，輸入框與按鍵會被禁用，重複按下 Enter 不會重複提交

編輯條只從目標自身取初值，不讀取輸入框草稿；寫入目標也不會改變輸入框內容。

計劃¶

點擊後進入計劃模式；再按一下退出。底層調用 /plan ⇄ /plan off。

反饋¶

點擊後打開當前會話的反饋對話框，調用 feedbackUi.openSession(sessionId)。

安裝與啓用¶

在 DSH 的 profile 目錄下執行：

dsh plugin --profile <profile> add <本倉庫的 clone 路徑或包名>

也可以手動登記，步驟如下：

把本倉庫 clone 到任意目錄，例如 ~/dsh-composer-quick-actions
在 profile 的 node_modules 下建立軟鏈或 junction 指向該目錄
在該 profile 的 package.json 裏登記：

{
  "dsh": {
    "profile": {
      "bundles": ["…", "dsh-composer-quick-actions"]
    }
  },
  "dependencies": {
    "dsh-composer-quick-actions": "link:~/dsh-composer-quick-actions"
  }
}

改完必須重啓 DSH Desktop 才生效。宿主在啓動時把 lib/client.js 快照進客戶端模塊圖，運行期改動不會熱更新。

典型用法¶

安裝並重啓後，composer 工具欄會多出三個控件，緊鄰官方的「+」與權限下拉：

[ + ] [ ⊘ 工作區內修改 ▾ ] [ ☑ 計劃 ]   [ 📎 文件 ] [ 🎯 目標 ] [ ✈ 反饋 ]        …… 輸入框
        └── 官方那一格 └─┘            └──── 左側一組 ────┘

點擊「文件」打開文件選擇器
點擊「目標」在目標欄位置彈出編輯條，輸入後按 Enter 或 ✓ 保存
點擊「計劃」進入計劃模式，再按一下退出
點擊「反饋」打開反饋對話框

適用場景與注意¶

適合在需要頻繁使用「文件 / 目標 / 計劃 / 反饋」的場景中使用，以減少操作步驟。

注意以下幾點：

接管計劃槽位依賴 DSH 的「最低優先級渲染」語義。如果官方將來給 PlanChip 顯式指定負優先級，接管會失效（最壞情況會退回官方行爲，不會崩潰）。
文件按鈕依賴輸入框已掛載；未掛載時點擊會提示「當前輸入框不接受文件」。
控件只在已選中會話的 composer 上出現（「+」與權限下拉本身也只在有會話時渲染）。
插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

短結尾¶

該插件通過把四個常用動作常駐到 composer 工具欄，降低了操作步驟。更多細節與源碼可查看：

GitHub：https://github.com/xdsT2/dsh-composer-quick-actions
插件目錄頁：https://www.skillhub.cn/plugins/xdsT2/dsh-composer-quick-actions