前言¶

在 DSH 插件生態裏，單個插件是否可用容易判斷，難的是“這個任務到底該裝哪些”。插件之間可能互斥，成本也不一致；直接把插件列表交給 agent，並不能解決組合問題。

wuykjl/dsh-equip-engine 是一個任務驅動的 DSH 插件配裝引擎。它給任務配整套插件，而不是給一個列表。

這是什麼¶

倉庫：https://github.com/wuykjl/dsh-equip-engine。維護者：wuykjl。許可證：MIT。

它按任務描述檢索候選插件，再根據組合評分給出配裝建議。核心思路是：先按任務階段拆分能力，再判斷哪些插件可以放在一起，哪些插件不能共存。

核心能力¶

五槽位配裝¶

配裝分爲五個槽位：感知、決策、行動、記憶、輸出。

這些槽位按 agent 循環階段劃分，比單純按能力名稱分類更穩定。

組合評分¶

組合評分是核心能力。評分包含：

• 協同加成：體現套裝效應。
• 衝突懲罰：互斥插件不共存。
• 成本：控制組合開銷。
• 信任：由 stars、實測狀態和個人反饋組成。

也就是說，評分看的不是“單個插件好不好”，而是“這一組插件放在一起是否合適”。

雙檢索¶

檢索包含兩類路徑：

• 規則精編庫：精確匹配。
• LLM 語義理解：處理任務描述中的語義表達。

兩階段預篩流程是：從 2000+ 插件 manifest 中篩到 ≤48 個候選，再交給 LLM 精排。這樣做快且省 token。

數據與評測¶

manifest 數據共 2052 條：19 條手工精編，2033 條 LLM 生成。插件 id 使用 owner/repo 全限定形式，避免撞名歧義。

評測數據：

• 19 個任務上，規則 must 通過率 100%。
• 弱關鍵詞任務下，TF-IDF 召回 97%；SEM 等已覆蓋。

數據保鮮方面，它會每週自動同步生態（cron），新增插件會自動收錄。

安裝與啓用¶

插件會以當前 dsh 進程權限運行。安裝前建議檢查源碼和許可證；本插件許可證爲 MIT。

運行環境要求 node >=18。

下面使用 README 快速開始給出的示例命令。

1、安裝：

dsh plugin --profile web add github:wuykjl/dsh-equip-engine

2、執行 dsh web，用於重啓或啓動 dsh web：

dsh web

3、在聊天框輸入 slash 命令，例如：

/equip 寫代碼時要處理大量 JSON 和 CSV 文件

典型用法¶

聊天框命令¶

/equip 寫代碼時要處理大量 JSON 和 CSV 文件

這是規則檢索路徑的示例，適合任務描述能命中本地規則的任務。

/equip.mix 幫我做一份關於細胞基因編輯的深度研究報告，需要看實驗圖片

/equip.mix 是 LLM 混合檢索版，需要配置 API key。

CLI 用法¶

在倉庫目錄內運行：

node src/equip.js "任務描述"

這條命令用於本地規則版檢索。

node src/equip-export.js "任務" --dsh

這條命令用於導出安裝命令。

node src/equip-html.js "任務"

這條命令用於生成裝備欄可視化 HTML。

node src/eval-suite.js

這條命令用於運行金標評測。

適用場景與注意¶

適合以下場景：

• 需要按任務快速配置 DSH 插件組合。
• 希望避免互斥插件同時裝入。
• 希望控制插件組合成本。
• 需要看到組合建議，而不是隻看插件列表。

需要注意：

• 生成庫 caps 仍有噪聲。2033 條 LLM 生成 manifest 中，capQuality 分佈顯示 low(<0.4) 約 97 條，主峯在 0.6–0.8。匹配時對 generated 按質量分降權；無有效 desc 的條目不交給 LLM 猜測。
• cost 語義：生成庫 cost 已與 stars 解耦，統一中性值 0.35；failed 仍 +0.2。熱度只由 trustScore(stars) 表達。MAX_COST=1.5 近似“約 4 個插件”的數量預算。
• 極端同義改寫仍可能漏召回。當任務描述與 caps/desc 幾乎無共享詞時，本地 TF-IDF 可能不足，可能需要真正 embedding 或人工補 caps。

結尾¶

經過上面的步驟，dsh-equip-engine 提供的是一個任務級配裝流程：先按五槽位理解任務，再用規則和 LLM 雙檢索縮小候選，最後用協同、衝突、成本、信任做組合評分。

倉庫地址：

• GitHub：https://github.com/wuykjl/dsh-equip-engine