dsh-capability-index：让你的插件库不再吃灰

[777-Zen]

agent 明明下载有可用的插件/工具，却常常"闭门造车"：自己手搓一个解决方案，或者做到一半才发现"原来有个插件能用"。插件库利用率靠运气、靠机会主义直觉，不可预期。当所有的工具，模型都变成了插件，怎么让你的插件尽可能配合使用变得重要起来。

它做什么

一个元插件，在任务动手前给 agent 做一次插件库预检：

• 三层触发：关键词规则（硬层）→ 能力声明集中渲染（中层）→ 插件库总览兜底（软层）
• 任务型请求命中时，把"可能适用的 Top-K 插件 + 作者声明的 use_when/not_for"注入 runtime-context
  快照；commit-on-change，不逐轮堆积
• 零侵入：只读、不改写其他插件的工具定义、不强制调用，决策权始终在模型

能力声明约定

插件作者通过 ctx.provide('capabilityIndex.declarations', …) 为每个工具声明
use_when/not_for，命中时由本插件集中渲染。这是"约定 +最小消费者"的第一块多米诺；仲裁（重叠选谁）和自动补装是后续演进。

实验（如实说明）（agent跑的）

B/C 对照，同 profile、同会话、同消息原文，只切本插件开关；真值信 tool/call 日志，不信模型总结。

指标	B 组（无提示，14 条）	C 组（有提示，7 条）
正例工具调用率	50%	100%
误触发	0	0
上下文增量	0 字符	~194 字符/条

• 显而易见的内置工具（read/echo）：有无提示无差别
• 不显而易见的插件工具（concat_text/format_text…）：调用率 0% → 100%
• 样本 S9：模型正确拒绝了不适用工具——提示不会造成强制误用

边界，说清楚：样本 10 条、由模型自主执行记录（无人工筛选）、方向性结论、不构成统计显著性。32 单测 + 离线模拟器 +
评分脚本在仓库 eval-results/ 可复现。

安装

pnpm dsh plugin --profile <name> add <path>\dsh-capability-index

<name> 换成你的 profile 名（如 web），<path> 换成仓库目录绝对路径。

兼容性：在 dsh 0.1.0-rc.5（developer preview）上验证过。上游会有 breaking change，升级后提示块消失或异常，先查 README
和发布说明。

边界 / 不做什么：只读 + 建议性质；不自动补装缺失插件；不替代 dsh-tool-search 这类工具对比插件。隐私按
tools.schemas(agent) 口径——会话不可见的工具不进索引。

仓库：https://github.com/777-Zen/dsh-capability-index · MIT · dsh-plugin topic · 欢迎反馈、样本补充、能力声明

[Chloride233]

自荐收录：dsh-cot-profile — 实时思维链轨迹画像插件（Show Your Plugins! #2284）。

分析测量类插件：监听 reasoning 流，措辞指纹（let me / we / let's / I）→ 加权距离判定画像族 + 置信度；按回合自动记录聚合数据（只存统计不存原文）；设置页扫描记录文件 → 分组 → 基线差异/判定分布 → 一键校准基线。

DSH 深度集成：session-projection 推送 / additive 槽位 / webServer 路由。MIT · 40 单测 · 双语 README。

仓库：https://github.com/Chloride233/dsh-cot-profile

[777-Zen]

更新 v0.2.0（2026-08-26） 📦
GitHub：https://github.com/777-Zen/dsh-capability-index

这版从"规则词表"升级为"语义召回 + 三级合议"：

• 语义召回：进程内本地 embedding（bge-small-zh-v1.5，约 24MB），
  同一任务换种说法、甚至英文，也能匹配到合适插件——纯本地推理，零数据上传；
• not_for 守门闸：作者声明"不适用场景"后会实际核对，误推明显减少；
• 决策日志：每次注入本地落账，校准数据持续积累、可审计。

实验对照（真值信 tool/call 日志）：对不显而易见的冷门工具，
提示块把调用率从 0% 提升到 100%、零误触发；上下文增量约 180–200 字符/条。

已知限制：引用任务句的闲聊偶有误推（挂账校准中）；dsh 为 developer preview，
正式版可能不兼容——已做适配层 + 回归验证，会快速跟进。

[leenkcool]

我是插件库，我感觉你的想法很好，我想收录，可以提ISSUE。 具体提的方法如下。
#4456

[777-Zen]

顺着这个插件写了一篇小讨论，聊聊我对 dsh 插件生态的一点看法——为什么插件多了反而用不上、生态会怎么长：插件多了会用不上
？。感兴趣的可以来聊聊。