awesome-dsh-plugin/dsh-find-plugin

English | 中文

一个用来找插件的插件——就像 skills.sh 的 /find-skills，DSH 版。

想要什么能力，直接跟 agent 说（比如"任务完成时给我发微信通知"），它就去 GitHub 上的 DSH 插件生态里帮你搜——按 star 排序，每条带一句话说明和安装 命令。

安装

# npm 包（预构建，推荐）
dsh plugin --profile web add dsh-find-plugin

# 或从 GitHub 安装
dsh plugin --profile web add github:awesome-dsh-plugin/dsh-find-plugin

使用

安装后重启 dsh web，然后直接跟 agent 对话即可——需要找插件时它会自己调用 find_dsh_plugin：

• "有什么终端 TUI 插件？"
• "我想任务完成时收到微信通知，有插件吗？"
• "找个能在 DSH 里做 git diff 审查的东西。"

每条结果都带 star 数、功能描述、仓库链接和可直接执行的 dsh plugin add 安装命令——让 agent 帮你装，它可以直接替你执行。

工作方式

• 实时搜索打了官方 dsh-plugin topic 的 GitHub 仓库，按 star 数降序 （每查询 5 分钟缓存）。
• 命中 awesome-dsh-plugin 精选列表的仓库， 会换用列表中人工撰写的双语描述（lang 参数选择语言），排序不受影响。
• 每条结果附可直接执行的 dsh plugin add 安装命令；插件均为第三方代码， 请自行审阅源码并锁定 commit。

限流与离线兜底

GitHub 搜索接口在未认证时只有 10 次/分钟/公网 IP 的额度，且该额度由同一出口 IP 背后的所有主机共享（运营商 CGNAT、公司 NAT…），因此搜索可能因你无法控制的原因返回 HTTP 403。插件因此做了三件事：

• 配置了 DSH 的 GITHUB_TOKEN 凭据时会使用它（30 次/分钟、按账号计数，不受共享 IP 影响）。这是可选项——不配也能用，只是更接近匿名上限；
• 遇到限流（403/429）或请求失败时先重试一次，仍失败则降级而非报错：改用 curated 列表的关键词匹配，并在结果末尾的 note 里说明；
• 把 curated 列表缓存到磁盘（$DSH_HOME/cache/dsh-find-plugin/）并用 If-None-Match / If-Modified-Since 重新验证，因此重启和离线时用的是完整的 ~3400 条列表，而不是随包发布的小快照；
• 会说明失败原因。Node 把所有传输层失败都统一报成 fetch failed，真正有用的信息 藏在 cause 里，所以插件会把整条因果链显示出来 （fetch failed ← certificate has expired (CERT_HAS_EXPIRED)），并指出那个最容易被 误认为插件 bug 的坑：系统代理 / VPN 加速器。Node 的 fetch 在 DSH 自身启动时没有 NODE_USE_ENV_PROXY=1（或 --use-env-proxy）的情况下不读代理环境变量，而浏览器 没有这条规则——这就是「浏览器能打开 GitHub、插件却报错」的原因。

兼容性

DSH 的插件 API 是预发布版本号，而 node-semver 规定：只有当 range 里存在与版本号 major.minor.patch 相同的 prerelease 比较器时，预发布版本才算满足该 range。因此 把 peer range 钉在某一条宿主线上，下一条线一发布就会悄悄失效。本插件声明的 @deepseek-ai/dsh-tools range 覆盖到 0.1.7 为止的每一条已发布宿主线，CI 里的 npm run check:peers 会从 registry 解析当前 latest / next 两条线，一旦覆盖不到 就直接失败。

开发

npm run typecheck                     # tsc --noEmit
npm test                              # 离线用例（mock fetch）
FINDP_LIVE=1 npm run test:live        # 可选：真实网络用例

许可

MIT © awesome-dsh-plugin