前言¶
在 DeepSeek Harness (DSH) 的開發實踐中，智能體經常面臨需要調用特定技能或專家時，卻不知道本地或市場上有哪些可用項的情況。傳統的做法需要手動瀏覽目錄或編寫複雜的查詢邏輯。dsh-skill-matcher 是一個用於解決這一痛點的 Cordis 插件，它通過掃描本地環境與聯網的開源目錄，爲 DSH 提供一個統一的技能與專家匹配層。
插件介紹¶
該插件由 axel286137079-dot 維護，遵循 MIT 協議。它本質上是一個 Skill & Expert Matcher，功能與 SKILL.md 版本一致，但封裝爲 DSH 插件形態。核心作用是在用戶詢問“該用哪個技能/專家”時，提供自動化的推薦與匹配服務。
核心功能¶
插件提供了三個主要工具函數和一套自動注入機制：
-
skill_matcher_scan
掃描本機技能與專家（支持多環境），同時聯網獲取開源目錄數據。它會將這些數據合併構建索引，並緩存至本地。 -
skill_matcher_match(query, topN?, includeExperts?)
根據用戶需求（query）進行匹配，返回 Top-N 推薦結果。結果包含匹配度、命中的關鍵詞以及具體的安裝方式。 -
skill_matcher_list(scope?)
用於瀏覽本機已安裝、市場或開源目錄中的技能與專家列表。
自動注入與引擎¶
插件會在 system prompt 中注入一段引導文本。當用戶的問題涉及技能選擇時，系統會優先調用 skill_matcher_match。
核心引擎位於 lib/engine.js，這是對 Python 腳本 bin/sync_index.py 的 JS 移植。其處理流程包括：
* 環境探測
* 解析 SKILL.md 的 frontmatter 或 plugin.json
* 拉取遠程開源數據
* 優先級合併
* 關鍵詞召回
內置了 13 條開源種子數據，在無網絡環境下亦可使用。
安裝與啓用¶
推薦使用項目根目錄的一鍵安裝器：
bash ../install.sh --dsh-only
或者手動添加（需使用絕對路徑）：
dsh plugin --profile web add file:<本項目絕對路徑>/plugin
安裝完成後，需要重啓 DSH Web 服務以生效：
launchctl kickstart -k gui/$(id -u)/com.deepseek.harness.web
典型用法¶
- 查看列表：調用
skill_matcher_list瀏覽本地或市場資源。 - 匹配技能：調用
skill_matcher_match並傳入具體需求，獲取推薦及安裝命令。 - 緩存機制：索引數據會寫入
~/.dsh/dsh-skill-matcher/cache.json，緩存有效期爲 24 小時。
注意事項¶
- 安全與合規：插件僅進行本地掃描，且僅拉取 JSON 格式的目錄數據，不會執行任何遠程代碼。
- 離線可用：得益於內置的 13 條開源種子，插件在斷網環境下也能運行。
- 排序中立：推薦排序由需求匹配度決定，不摻雜其他因素。
- 安裝故障處理：如果
dsh plugin add因 profile 的 pnpm 供應鏈策略（如 minimumReleaseAge 過期）失敗，建議改用根目錄的install.sh腳本，它會直接寫入 profile 的 package.json 並自動備份。
結尾¶
dsh-skill-matcher 爲 DSH 提供了標準化的技能發現與匹配能力。其純本地、無遠程代碼執行的特性，使其適合在注重安全與離線運行的環境中使用。更多細節可參考：GitHub。
