find-dsh-plugins
jazzulu/find-dsh-plugins
对话式查找 DSH 插件的增强版 skill：四源聚合统一索引，BM25 粗筛 + LLM 语义精排，候选表带证据分级与本地静态安全审计，安装走安全确认流程并自动验证。
安装
dsh plugin --profile web add github:jazzulu/find-dsh-pluginsREADME
find-dsh-plugins
中文 | English
对话式查找 DeepSeek Harness 插件的增强版 skill —— 语义检索 × 四源聚合 × 安全审计。
问一句"有没有能统计 token 用量的插件？"，Agent 检索四源统一索引、语义精排、 给出带安全标记的候选表，拍板后安全安装并验证。
目录
与别人的差异
| 能力 | find-dsh-plugins（本仓库） | dsh-find-plugins | dsh-find-plugin | dsh-plugin-finder |
|---|---|---|---|---|
| 检索方式 | BM25 粗筛 + LLM 语义精排 | 关键词匹配 | 关键词 + stars 重排 | 注册表单源匹配 |
| 数据源 | 四源聚合（岚叔/awesome/dsh.so/GitHub topic） | GitHub topic 单源 | 2 源 | dsh.so 单源 |
| 安全审计 | evidence 分级 + 本地静态审计 | 无 | 无 | 无 |
| 形态 | skill 免重启 | skill | 插件需重启 | 插件需重启 |
| 数据新鲜度 | 分层 TTL + 查询时同步刷新 | 每次现拉 | 5 分钟缓存 | - |
支持哪些 Agent
遵循业界通用的 Agent Skills（SKILL.md）开放规范，同一份技能本体可被多家 Agent 加载：
| Agent | 安装方式 | 说明 |
|---|---|---|
| skills.sh 生态（Claude Code / Cursor / Codex 等） | npx skills add JazzuLu/find-dsh-plugins | 标准 SKILL.md，skills.sh 原生支持 |
| DeepSeek Harness (dsh) | 复制目录到 ~/.dsh/skills/，或 dsh plugin add github:JazzuLu/find-dsh-plugins | dsh skill-filesystem 扫描该目录，watcher 即时加载 |
| 其余遵循 Agent Skills 规范的 Agent | 按各自文档中的 skills 目录放置 | 同一份 SKILL.md 直接可用 |
快速开始
方式 1：Skills CLI 安装（推荐，支持各类 Agent）
# 项目级安装
npx skills add JazzuLu/find-dsh-plugins
# 或全局安装（对当前用户的所有项目生效）
npx skills add JazzuLu/find-dsh-plugins -g
方式 2：手动复制到 DSH 目录（DSH 专用，免重启）
# 1. 复制 skill 运行目录（仅 AI 运行所需文件：指令 + 脚本 + 参考）
mkdir -p ~/.dsh/skills/find-dsh-plugins
cp -r SKILL.md scripts references ~/.dsh/skills/find-dsh-plugins/
# 2. 新会话（或当前会话等待 watcher 加载）
# 3. 直接对话：
# "有没有能统计 token 用量的插件？"
# "帮我装个 SSH 远程运维面板"
# "生态里有什么好玩的 UI 增强插件？"
方式 3：bundle 安装（DSH，需重启 dsh web）
dsh plugin --profile web add github:JazzuLu/find-dsh-plugins
dsh web # 重启加载
升级 / 卸载
# 升级（bundle 方式）：重新执行安装命令
dsh plugin --profile web add github:JazzuLu/find-dsh-plugins
# 卸载（bundle 方式）：务必用包名，不要传本地路径
dsh plugin --profile web remove find-dsh-plugins
# 卸载（复制方式）：删除目录即可
rm -rf ~/.dsh/skills/find-dsh-plugins
使用示例
你：有没有能统计 token 用量的插件？
AI：
候选 1：dsh-web-ui（合集） ★1416 [LISTED]
一句话用途：DSH Web UI 插件与皮肤合集，内含实时令牌统计
为什么匹配：需求是 token 用量统计，该合集包含 live-stats 组件且为四源精选
安装：dsh plugin --profile web add @linxin666/dsh-web-ui-all
工作原理
四源（岚叔 / awesome / dsh.so / GitHub topic）
→ build-index.mjs 统一索引（分层新鲜度，查询时同步刷新）
→ search.mjs BM25 粗筛 top-30
→ Agent LLM 语义精排 → 候选表（带安全标记）
→ install-methods.md 安全安装 → 装后验证
兼容性
- Node.js ≥ 22：脚本使用内置
fetch与node:test，零第三方依赖。 - 网络：需要访问四个数据源（岚叔 / awesome-dsh-plugin / dsh.so / GitHub API）。
- DSH：实测 0.1.x 系列（web profile）；与各 Agent 的
SKILL.md加载器通用。
数据源与更新机制
| 数据源 | 链接 | 说明 |
|---|---|---|
| 岚叔 DSH 插件资源站 | https://dsh.lanshuagent.com | 30 分钟自动巡检，evidence 证据分级 |
| awesome-dsh-plugin | https://github.com/awesome-dsh-plugin/awesome-dsh-plugin | 社区精选目录，中英双语描述 |
| dsh.so | https://www.dsh.so | DeepSeek Harness 开发者中心，开放数据许可 |
| GitHub dsh-plugin topic | https://github.com/topics/dsh-plugin | 生态全量仓库 |
新鲜度：curated 源 TTL 30 分钟、GitHub 增量 15 分钟、GitHub 全量每日，查询时 过期层自动同步刷新。可选定时任务（更快的常驻新鲜度）：
# launchd/cron 每小时刷新 curated 与增量层
0 * * * * cd <skill目录> && node scripts/build-index.mjs --quiet
# 每日全量
0 3 * * * cd <skill目录> && node scripts/build-index.mjs --refresh-full --quiet
数据源与致谢
本插件索引数据来自以下公开数据源，数据版权归各源所有，本插件仅做聚合与检索：
- 岚叔 DSH 插件资源站（https://dsh.lanshuagent.com）—— 30 分钟自动巡检与 evidence 证据分级体系；
- awesome-dsh-plugin（https://github.com/awesome-dsh-plugin/awesome-dsh-plugin）—— 社区维护的精选目录与中英双语描述；
- dsh.so（https://www.dsh.so）—— DeepSeek Harness 开发者中心，其插件索引以 "Free to reuse with attribution" 许可开放，特此致谢；
- GitHub dsh-plugin topic（https://github.com/topics/dsh-plugin）。
安全模型
- evidence 分级：LISTED（岚叔精选）> CURATED（awesome 精选）> INDEXED（dsh.so）
TOPIC（仅 GitHub 话题）。
- 本地静态审计：lifecycle 脚本、写 HOME 外路径、修改 shell 配置，仅在用户拍板 前对 top-3 候选实时执行（GitHub 匿名 API 限流预算）。
- 免责声明：插件均为第三方代码，安装即信任；本 skill 只做信号提示，不构成背书。
FAQ
Q: 为什么结果偶尔不是最新？ A: 索引按分层 TTL 自动刷新（curated 30 分钟 / GitHub 增量 15 分钟 / 全量每日）， 查询时过期层会同步刷新——拿到的是"查询时刻能拿到的最新状态"，不可能比源头更新。
Q: 没找到插件怎么办？ A: SKILL.md 会先换一组同义词重试一次；仍无结果说明生态里真没有，可转 make-dsh-plugin 现写一个。
Q: 安全审计会执行插件代码吗？ A: 不会。静态审计只读 package.json 与 README 文本（lifecycle 脚本、写路径、 shell 配置关键词），不装依赖、不运行代码。
Q: 需要 API key 或付费吗？ A: 不需要。BM25 粗筛在本地零成本执行，LLM 精排复用当前会话的模型，无外部 API 调用。
Q: 和 dsh-find-plugin / dsh-plugin-finder 有什么区别？ A: 见与别人的差异对比表——语义检索、四源聚合、安全审计是三项核心差异。
开发与贡献
- 测试：
npm test（node:test，零依赖）。 - 脚本：build-index.mjs（索引）、search.mjs（检索）、audit.mjs（审计）。
- PR 欢迎：修正数据源字段映射、补充审计规则、提升 BM25 权重。
LICENSE
BSD-3-Clause。代码全部原创，不继承任何上游实现。