前言¶
DeepSeek Harness (DSH) 遵循“一切皆插件”的理念,插件生态迅速发展。开发者往往面临插件分散在 GitHub、官方目录和社区列表中的问题,手动查找安装命令效率低下。现有的雷达或市场通常依赖 README 抓取,数据源单一且容易遗漏。
dsh-plugin-store 提供了一个统一的解决方案。它以 App Store 风格的设置页呈现,集成了官方目录、社区精选和 GitHub 生态的探针能力,支持一键安装与卸载。
这是什么¶
dsh-plugin-store 是一个 DeepSeek Harness 插件雷达。它由 maoruoyu 维护,旨在解决插件发现与安装的碎片化问题。通过一个统一的设置入口,它将官方 API、精选注册表和 GitHub Topic 探针合并,提供类似应用商店的浏览体验。
核心功能¶
- 多源数据探针
- dsh.do API:调用官方目录接口,获取完整的分页包列表。
- 精选注册表:集成 awesome-dsh-plugin,获取包含分类和双语描述的条目。
- GitHub Topic:通过topic:dsh-plugin搜索,支持按 Star 或更新时间排序。 - App Store 风格界面
- 在 DSH Web 设置页中展示插件卡片。
- 支持按星标、实用性评分、分类、搜索和最近更新进行排序。
- 头像预加载与缓存机制,避免图标闪烁。 - 智能安装与卸载
- 源感知优先级:自动按以下顺序选择安装源:- dsh.do 的
installCommandNpm - dsh.do 的
installCommandGit - 精选注册表中的
install - GitHub 源 URL(仅作为兜底)
- 支持一键安装与卸载,安装命令会自动包含当前 profile。
- dsh.do 的
- 灵活刷新机制
- 支持手动刷新。
- 支持自动刷新,间隔可选 15、30、60 或 120 分钟。
安装与启用¶
在终端执行以下命令将插件安装到当前 DSH 实例:
dsh plugin --profile web add dsh-plugin-store
安装完成后,重启或刷新 DSH Web UI。进入设置页面,即可看到「Plugin Radar」入口。
典型用法¶
- 打开设置页中的「Plugin Radar」。
- 根据需要选择排序方式(如按实用性评分)或使用搜索框查找插件。
- 点击安装或卸载按钮,插件会自动通过正确的命令安装到当前 profile。
- 本地测试:运行
./scripts/test-local.sh 34129。
适用场景与注意¶
适用场景:DSH 用户需要批量管理插件、寻找高质量插件,或插件开发者需要测试插件分发流程。
注意事项:
1. 权限与安全:插件以当前 DSH 进程的权限运行。在安装第三方插件前,请检查源码与许可证。
2. 包名冲突:npm 包名 dsh-plugin-store 可能已被占用。发布前需在 package.json 的 name 字段和 lib/client.js 的 ID 中进行重命名。
3. 依赖要求:需要 React peer dependency。
4. 数据源配置:GitHub 探针可选 Token 以提高 API 限制,环境变量 DSH_GITHUB_TOKEN 或 GITHUB_TOKEN 可控制 API 基础地址。
总结¶
dsh-plugin-store 通过统一的数据源和 App Store 级别的交互体验,简化了 DSH 插件的发现与管理流程。无论是浏览官方目录还是社区精选,它都能提供一致的操作入口。
- GitHub: https://github.com/maoruoyu/dsh-plugin-store
- 目录页: https://www.skillhub.cn/plugins/maoruoyu/dsh-plugin-store