vclike/dsh-find-plugin：在会话内发现 DSH 插件

DSH（DeepSeek Harness）生态强调“一切皆插件”。开发者在 Agent 会话中查找插件时，通常需要手动搜索 GitHub topic 或浏览外部列表。上游插件在调用 GitHub 搜索 API 时采用匿名调用，受限于每公网 IP 10 次/分钟的额度，且经常出现 403 错误，导致查找不稳定。vclike/dsh-find-plugin 解决了发现渠道单一和调用受限的问题。

这是一个什么工具¶

这是一个用于在 Agent 会话内发现 DSH 插件的工具。它同时查询 GitHub 的 dsh-plugin topic 和 curated 列表（约 3400 条），合并去重后返回可直接执行的 dsh plugin add 安装命令。

这个插件由 vclike 维护，基于上游 awesome-dsh-plugin/dsh-find-plugin 的维护分支开发。上游版本存在匿名 API 调用受限的问题，本分支补上了 token 鉴权、双源合并、磁盘缓存以及真正的降级链。

核心功能¶

双源搜索：同时搜索 GitHub 的 dsh-plugin topic 和 curated 列表。
结果合并与排序：将搜索结果合并，GitHub 结果按 stars 排序，curated-only 条目补足剩余名额。
Token 鉴权：支持通过 GITHUB_TOKEN 凭据调用 API，提升额度。
限流韧性：在 Token 鉴权下支持每分钟 30 次请求；未配置 Token 时每公网 IP 限制 10 次/分钟。
离线降级：提供完整的离线 fallback 链路（内存缓存 -> 磁盘缓存 -> 内置快照）。
零依赖：通过服务层解析凭据，不直接导入 @deepseek-ai/dsh-credentials。

安装与启用¶

使用官方插件管理器安装：

dsh plugin --profile web add github:vclike/dsh-find-plugin

安装后需要重启 dsh web，因为插件在启动时才会组合 bundle 层。

配置 GitHub Token（推荐）¶

为了获得更高的调用额度并避免共享出口 IP 的干扰，建议配置 GitHub Token。

插件通过 DSH 凭据服务读取名为 GITHUB_TOKEN 的凭据（与 dsh-github-companion 使用同一份）。该凭据通常由 DSH 进程的 GITHUB_TOKEN 环境变量提供。

无 Token：调用受限，且当 GitHub 额度耗尽时会降级使用 curated 列表。
有 Token：调用额度提升至 30 次/分钟，且不受出口 IP 共享限制。

典型用法¶

插件支持三个参数：

query（必填）：搜索关键词，例如 "wechat notifications" 或 "跨会话记忆"。
limit：返回结果数量上限，默认 8，最大 20。
lang：偏好描述语言，en 或 zh，默认 en。

执行搜索时，插件会先返回 GitHub 搜索结果（按 stars 排序），随后用 curated 列表中仅匹配关键词的条目补足剩余名额。

输出示例：

1. dsh-mnemon ★143 — 跨会话记忆 / cross-session memory
   https://github.com/owner/dsh-mnemon
   install: dsh plugin --profile web add github:owner/dsh-mnemon

2. some-curated-only ★7 [curated] — 仅见于 curated 列表的条目
   https://github.com/other/some-curated-only
   install: dsh plugin --profile web add github:other/some-curated-only

来源：GitHub 实时 `dsh-plugin` 搜索（按 stars 排序） + curated 列表（source=live，3408 条，
标 [curated] 的是仅见于 curated 的条目）。All plugins are third-party code — review the
source and pin a commit when installing. Browse https://awesome-dsh-plugin.com

注意事项¶

所有插件均为第三方代码：在使用任何通过此插件发现的插件前，请务必审查源码。
限流细节：
- 无 Token 时：10 次/分钟（按公网 IP）。
- 有 Token 时：30 次/分钟，不按 IP 共享。
数据来源：插件返回的插件列表基于社区维护的 curated 列表和 GitHub 实时搜索，不保证 100% 的完整性。

总结¶

vclike/dsh-find-plugin 解决了 DSH 开发者在会话中查找插件的痛点。它通过整合 GitHub 搜索和 curated 列表，提供了一致的发现体验。配合 Token 鉴权和离线降级机制，保证了在 API 限流或网络波动情况下的可用性。