DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在管理多设备环境或使用非官方插件时,缺乏统一的分发渠道会增加维护成本。dsh-plugin-repo 作为一个纯 Cordis 插件,解决了这一痛点。
它是什么¶
这是一个自托管插件仓库,运行在 DSH 进程之上。每台设备可以独立提供 HTTP 服务,支持对 .tgz 包的列表、上传和下载。插件内置了对非官方插件的检测能力,并支持基于版本的感知安装。它不修改 @deepseek-ai/* 核心包,完全通过 Cordis 扩展实现。
核心功能¶
- 自托管插件仓库 (HTTP 服务):在本地启动一个 HTTP 服务,提供插件分发能力。
- 包管理:支持列表、上传和下载
.tgz包。 - 官方插件保护:检测非官方插件,确保官方
@deepseek-ai/*插件永不在此仓库中列出或修改。 - 跨设备同步:支持跨设备拉取和推送,实现插件分发自动化。
- 版本感知安装:安装前对比版本,防止意外降级。
- 设置界面:提供带选项卡的 UI(本机/跨设备同步/高级)。
- 模型工具:提供
repo_list、repo_install等命令行工具。 - HTTP API:提供完整的 RESTful API 接口。
安装与启用¶
- 通过 npm 安装插件:
dsh plugin --profile web add dsh-plugin-repo
或者从本地 tarball 安装:
dsh plugin --profile web add ./dsh-plugin-repo-1.7.0.tgz
-
重启 DSH 服务。
-
打开设置,进入「插件仓库」页面。建议使用
Ctrl+Shift+R进行硬刷新以加载新界面。
典型用法¶
安装完成后,可以通过配置目录 repoDir 来管理本地仓库。在设置中,你可以直接在「本机」选项卡中查看已安装的插件,通过「跨设备同步」选项卡在不同设备间传递插件,或在「高级」选项卡中配置额外的搜索路径。
注意事项与架构¶
- 配置方式:配置使用 schemastery 风格,字段默认为可选。
- 凭据管理:插件不嵌入登录凭据,跨设备认证依赖本地 DSH 服务器。
- 请求发起:跨设备请求由本地 DSH 服务器发起(非浏览器直接请求),这确保了安全性。
- 权限要求:插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。
短结尾¶
dsh-plugin-repo 为 DSH 提供了可控的插件管理方案。它不仅支持自托管,还通过 HTTP API 和跨设备同步增强了工作流。查看目录或 GitHub 仓库获取更多细节。