在 DSH（DeepSeek Harness）開發環境中，頻繁在終端中切換目錄來執行腳本（如 npm run lint 或 pytest）會打斷工作流。dsh-quick-commands 插件通過在工作區頭部提供快捷命令入口，解決了這一問題。
這是什麼¶
dsh-quick-commands 是一個 DSH Web 插件，由 fonlan 維護。它允許爲每個 DSH 工作區配置命名 shell 命令。用戶無需在終端中切換目錄，只需點擊會話頭部的圖標即可運行命令，並通過浮動彈窗實時查看輸出。
核心功能¶
- 按工作區管理命令：爲每個工作區配置獨立的命名命令。
- 會話頭部執行：從 Session log 左側的
▶快捷運行圖標點擊執行。 - 實時輸出彈窗：約 200ms 頻率流式輸出 stdout/stderr，純文本顯示，自動跟隨滾動，支持分頁籤。
- 設置卡片管理：在插件設置中列出所有工作區，支持新增、重命名和刪除命令。
- 遠程 SSH 支持：通過 SSH 在遠程主機上執行命令，需加載
@dsh-ssh/dsh-ssh宿主插件。 - 串行執行：同一工作區同時只運行一個命令。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add @fonlan/dsh-quick-commands
安裝完成後，重啓 DSH (dsh web) 即可生效。
典型用法¶
- 配置命令：進入設置 → 插件配置 → Quick commands，爲特定工作區添加命令（例如
npm run lint）。 - 運行命令：在會話頭部點擊
▶圖標，選擇對應命令。 - 使用佔位符：命令文本中可使用
{workspace}、{cwd}、{title}等佔位符，插件會自動替換爲實際路徑或標題。 - 調整彈窗：拖動彈窗邊框或角手柄調整大小，尺寸會自動保存。
適用場景與注意¶
- 遠程工作區：使用遠程工作區時，必須加載
@dsh-ssh/dsh-ssh宿主插件，否則無法執行遠程命令。 - 權限與安全：命令由用戶配置並點擊執行，不涉及模型請求或審批提示。插件以宿主進程自身的環境變量和 PATH，在工作區目錄下執行命令。本地 macOS/Linux 使用
bash -c，本地 Windows 使用pwsh -c。遠程命令以遠程用戶權限執行。請只配置信任的命令。
該插件爲 DSH 工作區提供了標準化的腳本執行層。更多細節可參考 GitHub 倉庫。
