DSH 插件盒子

在 DeepSeek Harness 网页客户端里打开一个插件市场：浏览 GitHub 上现有的社区插件、阅读中文简介、按 star 排序，选中后复制官方安装命令。

• 目录来自社区维护的 Oh-My-DSH
• 只收录插件（type = 插件）。官方仓库、合集、教程、渠道、技能等不会出现
• 点「刷新目录」会拉取最新清单：更新已有条目（星数、简介），把新插件追加进盒子，并记住（下次打开还在）
• 盒子不会在你的电脑上直接安装第三方插件，只复制命令，由你自己在终端执行

仓库：https://github.com/boyuan623-coder/deepseek_harness_plugin_box

---

使用前需要什么

1. 已经能打开 DeepSeek Harness 的 Web 界面（浏览器访问本地端口，或桌面客户端套了同一套网页）。
2. 终端里能运行 dsh。若你是从 Harness 源码目录启动，把下面的 dsh 换成 pnpm dsh。
3. 安装目标是 web profile（网页客户端用的那份配置）。命令里的 --profile web 不要省略。

还没有 Web 客户端时，请先按 DeepSeek Harness 的说明把网页端跑起来，再装本插件。

---

一、安装插件盒子本身

在终端执行：

dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box

从源码启动 Harness 时：

pnpm dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box

想钉死某一版、避免仓库以后改动自动生效，可以在地址后加提交号：

dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box#<commit-sha>

本仓库已经提交构建好的 lib/，一般不需要在 profile 里打开 allowBuilds。

装完后必须 完全退出再打开 Web / 桌面客户端（只刷新页面有时仍是旧会话）。打开后应能看到：

• 左侧栏最底部、设置按钮附近：插件盒子（折叠成窄栏时是蓝鲸盒子图标）
• 设置 → 插件 里多一个标签页：插件盒子

如果没有出现，见下方 排错。

卸下插件盒子

dsh plugin --profile web remove dsh-plugin-box

然后同样完全退出再打开客户端。浏览器里记住的目录缓存在 localStorage，卸掉插件后不会自动清除，但不影响使用。

---

二、打开插件盒子

两种入口，内容相同：

入口	操作
侧栏	点击底部「插件盒子」或盒子图标，弹出全屏面板。按 Esc 或点右上角 ✕ 关闭
设置	打开设置 → 左侧选「插件」→ 顶部点「插件盒子」

顶部会显示当前插件数量和最近一次目录时间。

---

三、浏览、搜索、分类

• 列表 始终按 GitHub star 从高到低 排列，没有「精选优先」。
• 搜索框可匹配：插件名、作者、仓库全名、中文简介、英文描述。
• 分类芯片（Agent、Web UI、皮肤主题等）只过滤当前盒子里的插件；「全部」显示整份清单。
• 卡片上有：中文简介、star、分类、许可证。点插件名或「GitHub」打开仓库页，安装前请先看源码。

---

四、从盒子里安装某个社区插件

插件盒子 只复制命令，不替你执行安装。

1. 在卡片上点 「+ 复制安装命令」。剪贴板内容形如：

   dsh plugin --profile web add github:<作者>/<仓库>
   

   从源码启动时，在命令前自行加上 pnpm。

2. 粘贴到终端运行。这是 DeepSeek Harness 的官方装法。

3. 完全退出再打开 客户端，新插件才会出现。

4. 若对方仓库是 TypeScript、且 GitHub 安装需要在本机编译：pnpm 10 会拒绝自动跑 prepare。按终端提示，把打印出的包名写进该 profile 的 pnpm-workspace.yaml：

   allowBuilds:
     对方的包名: true
   

   再重新执行一次 add。这表示 允许该包装载时在你的机器上执行它的构建脚本。只对你审查过、信任的仓库这样做。

另外两个按钮：

• git clone：复制 git clone https://github.com/<作者>/<仓库>.git，适合你想先本地看代码再手工加载。
• GitHub：浏览器打开仓库首页。

---

五、刷新目录

点右上角 「刷新目录」。

发生的事情：

1. 本机 Harness 向 Oh-My-DSH 拉取最新 plugins.json（以及可用的中文说明）。
2. 仍然 只留下 type = 插件 的仓库。
3. 已在盒子里的插件：更新 star、简介、许可证等；若新说明为空，会保留你盒子里原来的中文简介。
4. 目录里新出现的插件：追加进当前列表，不会清空重来。
5. 合并后的清单写入浏览器 localStorage（键名 dsh.plugin-box.catalog.v1），关掉客户端再打开仍在。

需要联网。失败时面板会显示原因（连不上服务、或上游目录暂时不可用），原有列表不会被删掉。

刷新 不会 自动安装任何插件，也 不会 删除你已经用 dsh plugin add 装上的包。

---

六、安全说明

• 插件盒子只做目录展示和命令复制，不托管、不修改社区插件的代码。
• 你从终端执行 dsh plugin add github:... 之后，该仓库的代码会在你的机器上运行。安装前请打开 GitHub 页阅读 README 与源码，优先选择活跃、有许可证、有 star 的仓库。
• 目录由 Oh-My-DSH 社区同步，仅供参考，不构成官方认证。

---

排错

侧栏没有「插件盒子」

• 确认安装时用了 --profile web，并且当前启动的也是 web profile。
• 是否已经完全退出再打开（桌面客户端尤其需要关干净再开）。
• 再执行一次 dsh plugin --profile web add github:boyuan623-coder/deepseek_harness_plugin_box，看终端是否报错。

刷新失败 / 提示无法连接 DSH 服务

• 网页必须打在 Harness 自己的 Web 服务上（例如本地 127.0.0.1 端口），刷新请求发往 /api/dsh-plugin-box/catalog。
• 本机需要能访问 GitHub（raw.githubusercontent.com），否则拉不到 Oh-My-DSH。

复制了安装命令，对方插件没出现

• 命令有没有在终端真正执行成功。
• 执行后有没有重启客户端。
• 对方若是源码仓库，是否需要按上面第 4 节配置 allowBuilds。
• 命令是否带了 --profile web（盒子复制的命令已包含）。

想清掉记住的目录、回到安装包自带的清单

在该网页的开发者工具 → Application / 存储 → Local Storage 里删除键 dsh.plugin-box.catalog.v1，再刷新页面。

---

维护者：更新内嵌目录

用户安装只使用仓库里的 lib/。重新生成内嵌清单：

node scripts/build.mjs

可用环境变量覆盖数据路径：

• OH_MY_DSH_PLUGINS — Oh-My-DSH 的 data/plugins.json
• PLUGIN_BOX_JSON — 带中文简介的清单（all[].id / all[].zh）