Z-6354/dsh-plugin-repo

dsh-plugin-repo

用于 DeepSeek Harness 的自托管插件仓库——一个纯 Cordis 插件（不修改 @deepseek-ai/ 包）。

每台设备通过 HTTP 运行自己的仓库：列出 / 上传 / 下载 .tgz，检测非官方插件，带版本校验地安装，并跨设备拉取或推送包。官方 @deepseek-ai/ 插件永远不会被列出或修改。

安装

从 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）。

设置界面（v1.8）

| 标签页 | 用途 |
| --- | --- |
| 本机 | 本地 .tgz 仓库 + 已安装插件（双栏） |
| 跨设备同步 | 连接到另一台 DSH；拉取 → 本地 或 推送 → 远程 |
| 高级 | 用于发现插件的额外搜索根目录 |

已安装插件（v1.7+）：

- 启用 / 关闭 — 切换 dsh.profile.bundles，但不移除依赖（需重启）
- 删除 — 当插件处于已关闭状态时，从 web profile 卸载（pnpm remove / dsh plugin remove）
- 从 npm 安装 — 将 pnpm add / dsh plugin add 安装到 web profile
- DSH 版本适配 — 读取 peerDependencies 并与正在运行的 @deepseek-ai/dsh 进行比较

跨设备同步使用双栏（本地 | 远程）。徽章显示具体版本（本机 1.5.2 > 对方 1.5.0）。使用 选需推送 / 选需拉取 仅选择有差异的包（包括 版本未知 → 默认推送）。推送时对降级会发出警告确认；相同的包显示为已同步。最近推送记录会持久保存在 repoDir/push-history.json 中，重启后依然保留，并说明远程原本是未知，还是推送时剥离了版本。

跨设备访问（v1.8+）

跨设备请求由本地 DSH 服务器发出（而非浏览器）。本插件不内嵌登录凭据。

当远程设备使用 dsh-local-hanaccount 时：

1. 推荐： 在双方设备的 设置 → 访问控制 → 对等设备 中配对设备。来自 DSH 的出站 fetch 将自动附加对等方 Bearer token。
2. 单侧 hc： 在装有 hc 的设备上，将 /pluginrepo 添加到 显式暴露（排除），以便局域网对等方无需配对即可同步。

没有 hc 的普通局域网 http://ip:3080 仍然可用。遇到 HTTP 401/403 时，界面会指向 hc 配对或显式暴露——而不是本插件中的 HTTP Basic。

仓库存储

默认位于配置的 repoDir 下（通常是 ~/.dsh/plugin-repo 或自定义路径）：

- packages/.tgz — 非官方包
- index.json — 元数据（name、version、filename、size、uploadedAt）

HTTP API（位于 DSH web 端口，例如 http://127.0.0.1:3080）

| 方法 | 路径 | 描述 |
| --- | --- | --- |
| GET | /pluginrepo | HTML 落地页 |
| GET | /pluginrepo/api/packages | 列出仓库中的包 |
| GET | /pluginrepo/api/unofficial | 已安装 + 仓库中的非官方插件 |
| POST | /pluginrepo/api/upload | 上传 .tgz（原始请求体；?name= 可选） |
| GET | /pluginrepo/download/.tgz | 下载 |
| GET/POST | /pluginrepo/api/remote | 列出另一台设备的包（POST 请求体：host，可选 port） |
| POST | /pluginrepo/api/remote-pull | 从另一台设备拉取到此仓库 |
| POST | /pluginrepo/api/remote-push | 将本地仓库的 .tgz 推送到另一台设备 |
| POST | /pluginrepo/api/install | 计划 / 确认安装到本地 profile |
| POST | /pluginrepo/api/profile/enable | 在 dsh.profile.bundles 中启用插件 |
| POST | /pluginrepo/api/profile/disable | 禁用插件（从 bundles 中移除） |
| POST | /pluginrepo/api/profile/uninstall | 从 profile 中卸载已禁用的插件 |
| POST | /pluginrepo/api/npm-add | 从 npm registry 安装（spec、confirm） |
| DELETE | /pluginrepo/api/packages/ | 删除仓库中的包 |

远程地址解析顺序：scheme → host → port。裸主机名 → http + 端口 3080；https:// → 端口 443；显式 :port 优先。URL 中的用户信息会被剥离并忽略。

模型工具

- repo_list / repo_unofficial / repo_push / repo_pull / repo_delete
- repo_remote / repo_remote_pull / repo_remote_push
- repo_install（需要 installConfirm=true 才能应用）

配置

可选的插件配置：

- repoDir — 绝对仓库目录
- logLevel — silent | info

注意： 使用 schemastery 风格的配置（字段默认可选）。不要对 schemastery schema 调用 zod 的 .optional()。

许可证

MIT