前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的架构。为了方便管理社区插件,需要一种集中式的目录与验证机制。dsh-plugin-store 将插件市场直接集成到 DSH Web GUI 的设置中,提供精选目录、GitHub 发现以及结构验证功能,让用户无需离开界面即可完成插件的校验与安装。
核心功能¶
- 目录与发现:提供基于
awesome-dsh-plugin生态的精选目录(包含离线优先快照)以及 GitHubtopic:dsh-plugin的实时发现(取前 30 个非 Fork 仓库)。 - 结构验证:仅允许安装根目录
package.json声明了name、version和dsh.bundle.patch的插件。安装前会进行实时重新验证。 - 安全机制:所有修改操作(POST)限制在 8KB 以下,必须通过同源检查和进程级随机令牌验证。
安装与启用¶
通过 CLI 安装到 web 配置文件:
dsh plugin --profile web add github:anjaymi/dsh-plugin-store
安装完成后需重启 Web GUI:
dsh web
重启后,在 Web GUI 的「设置 → 插件」中会出现「插件市场 / Plugin Store」标签页。
使用方法¶
- 过滤与搜索:支持按仓库名或描述搜索;标签页提供「全部 / 精选 / 新发现 / 结构已验证 / 已安装」的分类筛选;支持按分类筛选。
- 操作:点击「校验并安装」或「安装」触发验证或安装流程。任务面板会实时显示安装状态和输出。
- 星标展示:显示真实的 GitHub 星标数量。精选条目缺失星标时,会通过后台接口回填。
注意事项¶
- 卸载:v0.1 版本暂不支持卸载功能。
- 安装限制:仅接受
owner/repo格式的 Git 规范,不接受二进制文件或本地路径。 - 重启要求:安装成功后,需重启
dsh web才能使插件生效。 - 缓存机制:目录缓存每 2 小时刷新一次。
- 配置要求:插件以当前 DSH 进程的权限运行,安装前应检查源码与许可证。
结尾¶
该插件解决了 DSH Web 环境下插件管理的痛点,通过结构化验证和安全限制,确保了安装的可靠性。更多细节请参考项目主页。