# WhaleHub 插件提交规范（按 vvlife/whalehub-dsh README 整理）

> 以后所有 DSH 插件（dsh-screen-agent / dsh-voice-chat / 新插件）发布到
> WhaleHub 市场，统一按本文档流程。来源：vvlife/whalehub-dsh README
> （WhaleHub — DeepSeek Harness 社区插件市场）。

## 0. 前置：必须是标准 bundle 插件

WhaleHub 校验门要求插件是 **标准 DSH bundle**（一行 `dsh plugin add` 可装）：

- 根 `package.json` 声明：
  - `dsh.bundle.patch` → 根 `cordis.patch.yml`（组合层，`- insert: - id: <自身> name: '<包名>'`）
  - `main` / `exports["."]` → Node half（Cordis entry：`name`/`inject`/`apply`）
  - `exports["./client"]` + `dsh.client.platform: "web"` → client bundle（`__ModuleLoader__.load` 格式）
  - **包根 = 仓库根**，构建产物入库（`files` 声明 host/ client/ 等）
  - 不声明官方依赖（`@deepseek-ai/*` 由 DSH profile 闭包注入）
- 反例（被拒原因，2026-08-17）：手动复制 `host/`+`client/` 注入 `cordis.patch.yml`、
  全仓无 `dsh.bundle.patch` → 不是 `dsh plugin add` 可装的标准插件。

安装命令示例：

```sh
dsh plugin --profile web add "github:<owner>/<repo>#<commit>&path:/"
```

## 1. 推送到 GitHub

整改后 push 到 `github.com/<owner>/<repo>`（本机凭据在 Windows 凭据管理器：
`git:https://github.com`，用户 lak321；token 为 `gho_*` OAuth token）。

## 2. 提交到 WhaleHub（二选一）

### 方式 A：提 Issue（提交插件表单，推荐，1 分钟）

URL：

```
https://github.com/vvlife/whalehub-dsh/issues/new?template=submit-plugin.yml
```

表单字段填写：

| 字段 | 填写 |
|---|---|
| 标题 | `[Plugin] <owner>/<repo>`（如 `[Plugin] lak321/dsh-filetree`） |
| GitHub 仓库地址 | `https://github.com/<owner>/<repo>`（需公开） |
| 分类 | Web-UI（界面与皮肤）/ 工具 / 其他（按插件性质选） |
| 一句话描述 | 一句话说清插件作用（中文，如"工作区文件树：浏览编辑工程文件"） |
| 依赖 | 无（官方包自动注入） |
| 已知坑点 | 安装后需重启 DSH 等 |

底部两个确认 checkbox（"仓库公开且 README 说明安装方式"、
"插件为开源免费不含恶意代码"）是**模板正文里的 markdown task list**——
在 Write 模式下是文本不可点击，需**切 Preview** 勾选，或把 `- [ ]` 改成 `- [x]`。
然后点 **Submit new issue**。

### 方式 B：提 PR（改注册表）

直接改 `registry/plugins.json` 加入插件条目，CI 自动校验 schema。
（需要 fork + 本地改 + PR，api.github.com 可达时操作。）

## 3. 同步 awesome 列表（可选，推荐）

也给 `awesome-deepseek-harness-plugins` 提 PR，WhaleHub 每日 cron 自动同步。

## 4. 已知坑（2026-08-17 实测）

- **api.github.com 在此网络被封锁**（503；github.com 主站可达）→ 无法 API 自动提交
  Issue/PR，只能走浏览器网页（新开 Edge 窗口放副屏，已登录 GitHub）。
- 浏览器自动化填表单：标题/仓库用剪贴板粘贴（点击输入框时若点中 placeholder
  中间会插入文本，需 Ctrl+A 全选重填）。
- 系统代理 127.0.0.1:7892 是 wandacloudCore 占用（非真代理），浏览器/请求若走
  代理会失败；git 用 github.com 主站不受影响。