前言¶
在 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
