前言¶
DeepSeek Harness (DSH) 生態採用插件化架構，開發者通常需要通過斜槓命令來調用 Skill。面對大量 Skill，記憶命令的成本較高，且容易出錯。dsh-skills-input 插件在輸入框側邊增加了 Skill 選擇入口，允許用戶通過界面瀏覽、搜索並選擇 Skill，將生成的調用指令安全寫入草稿。
插件定位¶
dsh-skills-input 是一個 DSH Skill 選擇器和 Skill 瀏覽器。它幫助不熟悉命令的用戶發現當前會話可用的工作方式，通過可視化的方式將宿主實際識別的調用指令注入到編輯器中。
該插件由用戶 konglong87 維護，開源協議爲 MIT。
核心功能¶
該插件主要提供以下能力：
- UI 入口：在輸入框右側增加“選擇 Skill”按鈕。
- 瀏覽與搜索：支持按名稱搜索，並展示 Skill 的真實名稱和描述。
- 草稿注入：將調用指令安全寫入草稿，不自動發送，保留原有內容。
- 上下文過濾：按當前會話
cwd和項目根目錄過濾，避免將其他工作區的 Skill 混入列表。 - 權限過濾：自動過濾
userInvocable === false的模型專用 Skill。 - 交互支持：支持搜索、鍵盤操作、暗色模式適配。
安裝與啓用¶
安裝該插件需要啓用提供特定接口的 Skill Explorer 組件。
-
安裝插件
在已安裝 dsh 的環境中執行以下命令：
dsh plugin --profile web add github:konglong87/dsh-skills-input
-
依賴條件
本插件不掃描磁盤，也不維護獨立的 Skill 數據庫。它依賴宿主提供的接口來獲取 Skill 列表。請確保當前會話中已啓用一個提供
/api/dsh-skill-explorer/list接口的 Skill Explorer 組件。安裝並配置好依賴後，重啓 web profile 即可生效。
使用流程¶
使用該插件通常需要經過以下步驟：
- 打開 dsh 對話頁面，點擊輸入框右側的“選擇 Skill”按鈕。
- 在彈出的搜索框中輸入 Skill 名稱的片段，使用鼠標或鍵盤選擇目標 Skill。
- 確認選擇後，插件會將
/skill-name格式的調用指令寫入當前草稿。 - 檢查草稿內容，確認無誤後由用戶自行發送。
注意事項¶
該插件僅負責發現、選擇和回填草稿，不參與 Skill 的生命週期管理。
- 不負責 Skill 管理：不負責 Skill 的安裝、編輯或刪除。
- 無獨立數據：不掃描磁盤，不維護獨立的 Skill 數據庫。
- 不自動執行：不自動執行 Skill，發送權始終在用戶手中。
- 不修改核心：不修改 dsh 核心，僅作爲客戶端插件運行。
- 衝突檢測：當草稿首個非空命令行已有其他斜槓命令時，插件會提示衝突並停止插入。
- 依賴提示：如果缺少 Skill Explorer 依賴，插件會顯示提示信息，而不是僞裝成空列表。
結語¶
dsh-skills-input 是 DSH 生態中用於簡化 Skill 調用流程的實用工具。它通過複用宿主的 Skill Explorer 接口，提供了低門檻的 Skill 選擇體驗，適合需要頻繁切換或瀏覽 Skill 的開發者使用。更多細節可查閱 GitHub 倉庫。
