meme-dog/dsh-plugin-finder

dsh-plugin-finder

在会话内搜索 GitHub 上的社区 DeepSeek Harness (DSH) 插件，按 star 排序，每个结果带一键安装命令。

灵感来自 OpenClaw / Claude Code 时代的 skills.sh 与 npx skill：让 agent 自己发现生态插件，而不是靠人肉翻列表。

功能

- search_dsh_plugins：实时搜索 GitHub 公开 dsh-plugin topic（约 1000+ 仓库），排除官方 deepseek-ai 组织
- 按 star 排序，返回：插件名、star 数、最近更新时间、简介、issue 数
- 每个结果附带可直接执行的安装命令：dsh plugin --profile web add github:/
- audit_dsh_plugin：安装前审查仓库
- 下载源码到工作区沙盒 /.dsh-plugin-cache/__/（限 50MB；缓存 24h，可传 refresh: true 强制重下）
- 解压后体积守卫：超过 200MB 自动清理并报错（防压缩炸弹）
- 检测 dsh.bundle 安装清单与 cordis.patch.yml
- 扫描 7 类危险模式：进程执行 / 动态执行 / 密钥与环境变量 / 文件写入删除 / 网络访问 / 危险命令 / 动态导入
- 输出入口源码摘录 + "试用 → 转正式" 安装计划（含回滚步骤）
- 结果内存缓存 5 分钟，减少匿名 GitHub API 限流压力
- 纯只读：不安装、不修改任何插件或配置

安装

dsh plugin --profile web add github:meme-dog/dsh-plugin-finder

安装后重启 dsh web 生效。重启后直接对 agent 说：

- "找找有没有微信通知插件"
- "有什么 TUI 插件？"
- "审查一下 / 这个插件再装"

agent 会自动调用 search_dsh_plugins / audit_dsh_plugin 工具。

用法（作为动态插件试跑）

在会话内通过 cordis_define / cordis_run 注册，重启后失效；适合先体验。

工作原理

| 层 | 说明 |
|---|---|
| 数据源 | GitHub Search API q=topic:dsh-plugin -org:deepseek-ai &sort=stars |
| 传输 | ctx.shell + curl（本部署禁用 fetch provider 以防御 SSRF；curl 走与 bash 工具相同的沙箱/审批链路） |
| 缓存 | 按 (query, limit) 内存缓存 5 分钟 |
| 插件形态 | 标准 out-of-tree bundle：package.json 声明 dsh.bundle.patch，cordis.patch.yml 插入一行 |

安全

- 工具只做只读 GET 请求，不执行任何安装动作
- 返回的安装命令需要你/agent 显式执行；安装第三方插件前请审阅源码
- 沙箱拒绝网络请求时会明确报错，不会静默降级

后续可扩展

- [ ] 合并 awesome-dsh-plugin 精选列表的中文简介（数据文件就绪后）
- [ ] --verify 冒烟测试：检查目标仓库是否声明 dsh.bundle manifest
- [ ] 按类别过滤（TUI / 记忆 / 通知 / 整活…）
- [ ] 检查插件 npm 是否已发布，优先给 npm 安装命令

License

MIT