DeepSeek Harness (DSH) 採用插件化架構,Web 界面下的技能調用通常依賴原生掃描或文件操作。如果需要將特定目錄下的本地 SKILL.md 作爲技能直接集成到 / 菜單中,dsh-v-skill-links 插件提供了直接的映射方案。它允許用戶將本地目錄映射爲菜單技能、自定義指令及快捷按鈕,無需修改原生邏輯。
核心功能¶
該插件提供以下能力:
- 映射技能:將配置目錄的一級子目錄(包含
SKILL.md)映射爲/菜單中的技能,選中後注入全文。 - 自定義指令:在
/菜單中選中後立即發送 Prompt,適合固定套路觸發。 - 快捷按鈕:在輸入框下方顯示網格,點擊將 Prompt 追加進輸入框,支持繼續編輯、自動發送及模型/推理等級綁定。
- 可視化設置:提供設置頁,支持熱生效,無需重啓進程。
安裝¶
環境要求:Harness 0.1.2-rc.1 及以上版本。
使用官方安裝命令:
dsh plugin --profile web add "github:victor10035445/dsh-v-skill-links"
安裝後刷新頁面或重啓 dsh web 即可生效。
配置與使用¶
配置目錄¶
插件通過配置目錄掃描技能。你可以直接編輯配置文件,或使用可視化設置頁。
配置文件示例($DSH_HOME\profiles\web\cordis.patch.yml):
- id: dsh-v-skill-links
config:
directories:
- D:/skills/my-skills
- ~/my-skills
- ./skills
可視化設置頁¶
推薦使用側邊欄齒輪 → 設置 → 技能管理:
* 技能映射:每行輸入一個目錄路徑,保存後立即生效。
* 自定義指令:維護名稱與 Prompt。
* 快捷功能:維護名稱、Prompt、自動發送選項及模型綁定(支持跟隨會話或指定模型/推理等級)。
使用流程¶
- 在輸入框輸入
/,展開菜單。 - 在「映射技能」分組中選中技能(或直接手打
/名字)。 - 補充文字後發送。模型會收到你的消息原文及注入的
<skill_content>塊。
注意事項¶
- 掃描規則:只掃描配置目錄的一級子目錄。以
.開頭的隱藏目錄會被跳過。技能名默認取子目錄名,也可在SKILL.md的 frontmatter 中指定name或description。 - 命名衝突:當映射技能名與官方命令重名時,命令優先級更高,技能無法觸發。
- 注入機制:注入內容僅作用於消息進入的那一步,不回放歷史消息。
- 按鈕模型綁定:快捷按鈕可綁定模型與推理等級。若綁定失敗(如模型不可用),不會阻斷 Prompt 追加,僅提示錯誤。
- 子代理:子代理會話同樣顯示按鈕網格,但模型切換操作在子代理中靜默跳過。
結語¶
該插件爲本地技能管理提供了靈活的菜單集成方案,適合需要將特定腳本或文檔作爲技能直接調用的場景。