前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。随着生态发展,dsh-plugin topic 下已有 2600+ 个仓库。面对数量庞大的插件列表,开发者需要一种高效的方式来发现、筛选和获取插件。awesome-dsh 作为一个独立的目录与检索工具,解决了插件查找难的问题。它不仅提供静态目录,还内置了通过 Workers AI 自动翻译简介和按需检索的 Skill,帮助开发者快速定位目标插件。
核心功能¶
- 全量目录抓取:自动抓取 GitHub topic
dsh-plugin下的全部插件目录,支持 2600+ 插件。 - 自动翻译:利用 Workers AI 将英文插件简介自动翻译成中文,并采用永久缓存策略,仅对新增或变更的条目进行翻译。
- 按需检索:提供中英混合词检索能力,分类仅基于原文,搜索则同时匹配原文和译文。
- API 支持:提供
/api/search、/api/plugins.json、/api/facets.json、/api/status.json等接口,支持完整快照、分类标签、抓取进度查询及手动触发。
安装与启用¶
该插件提供两种启用方式,根据使用的环境选择其一。
装进 DSH:
运行以下命令将插件注册到 DSH 中:
dsh plugin --profile <profile> add github:stakeswky/awesome-dsh
装进 Claude Code:
复制 SKILL.md 到本地技能目录:
mkdir -p ~/.claude/skills/dsh-plugin-finder && cp SKILL.md ~/.claude/skills/dsh-plugin-finder/
典型用法¶
安装后,可以通过对话直接触发检索,或通过 API 进行程序化调用。
对话检索:
直接向 Claude Code 或 DSH 提出需求,例如:
“给 DSH 装个能看图的插件”
“DSH 有没有记忆类插件”
系统会检索本地目录并返回匹配的插件及安装命令。
API 检索:
使用 /api/search 端点,参数包括 q(查询词)、kind(种类)、fn(仓库名,可重复)和 limit(结果数量,默认 8,上限 25)。
curl "https://dsh.jamintextiles.com/api/search?q=vision&limit=5"
注意事项¶
- GitHub 限额:匿名抓取 GitHub 搜索 API 限额为每分钟 10 次,若需稳定运行全量抓取,需配置
GITHUB_TOKEN。 - 资源成本:Workers AI 与 KV 存储均需 Workers 付费计划,全量抓取过程超出免费版 CPU 与子请求额度。
- 包激活规则:未声明
dsh.bundle的包只会作为普通依赖装上,不会激活插件层。 - 构建限制:git 源插件首次
add会被 pnpm 的allowBuilds拦下,需手动处理。 - 翻译策略:翻译采用永久缓存,仅翻译新增或原文变更的条目。单条失败会跳过并重试,不影响整体。
- 搜索逻辑:分类标签仅匹配英文原文,搜索则同时匹配中英内容。
附录¶
- 在线目录:https://dsh.jamintextiles.com
- 项目主页:https://github.com/stakeswky/awesome-dsh