dsh-plugin-box

Readme

# DSH 插件盒子

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

- 目录来自社区维护的 [Oh-My-DSH](https://github.com/like-study1/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](https://github.com/deepseek-ai/deepseek-harness) 的说明把网页端跑起来，再装本插件。

---

## 一、安装插件盒子本身

在终端执行：

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

从源码启动 Harness 时：

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

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

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

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

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

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

如果没有出现，见下方 [排错](#排错)。

### 卸下插件盒子

```sh
dsh plugin --profile web remove dsh-plugin-box
```

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

---

## 二、打开插件盒子

两种入口，内容相同：

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

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

---

## 三、浏览、搜索、分类

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

---

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

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

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

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

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

2. 粘贴到终端运行。这是 DeepSeek Harness 的官方装法。
3. **完全退出再打开** 客户端，新插件才会出现。
4. 若对方仓库是 TypeScript、且 GitHub 安装需要在本机编译：pnpm 10 会拒绝自动跑 `prepare`。按终端提示，把打印出的包名写进该 profile 的 `pnpm-workspace.yaml`：

   ```yaml
   allowBuilds:
     对方的包名: true
   ```

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

另外两个按钮：

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

---

## 五、刷新目录

点右上角 **「刷新目录」**。

发生的事情：

1. 本机 Harness 向 [Oh-My-DSH](https://github.com/like-study1/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/`。重新生成内嵌清单：

```sh
node scripts/build.mjs
```

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

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