# 上架社区市场

调研结论（2026-05）：DSH 生态没有单一官方市场，社区是「GitHub 仓库 + PR 提交 registry 条目」模式。
官方 npm 发布路径见 [deepseek-harness 发布插件文档](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.zh.md)
（Koishi 生态规范，见 [Koishi 发布指南](https://koishi.chat/zh-CN/guide/develop/publish.html)）。

> **状态（2026-10-24）**：本版为 `0.5.10`（`0.5.9` 未发布，tag 已删除，内容并入本版）。npm 上此前的 `latest` 是 `0.5.7`，`0.5.8` / `0.5.10` 之间隔了两代：`0.5.8` 是三代 DSH 契约适配，`0.5.10` 是设置页 V3 改版 + 工作区静音重写 + 界面语言跟随 DSH locale。发布由维护者执行 `npm publish`（账号启用了 2FA，无人值守环境过不了 EOTP）。

## 发布前检查

- [x] `package.json` 的 `repository.url` / `bugs.url` 换成真实仓库地址（`nienieai/dsh-chime-alerts`）
- [ ] `LICENSE` 版权行换成作者真名/昵称
- [x] npm 包名 `dsh-chime-alerts` 未被占用（已于 2026-08-25 发布 `0.5.6`，`0.5.7` 为当前 `latest`；`0.5.8` / `0.5.10` 待补发）
- [ ] README 放一段演示 GIF（九声试听：完成/子任务/后台完成/授权/提问/评审/受阻/打断/失败 + 工作区静音标记）
- [x] `npm publish`（package.json 已配 `publishConfig.access: public`；2026-08-25 首次发布 `0.5.6`；`0.5.10` 待维护者本地执行）
- [x] 静态双端完成后再声明 `dsh.client`（v0.5.0 起已声明并实测：经典脚本封套 + `exports["./client"]`）

## 已实证的静态 bundle 模板

本仓库的 package.json 形态（`dsh.bundle.patch` + `exports` types/default + `publishConfig` + `files` + Node 测试）已按社区静态 bundle 模板验证：
- `dsh.bundle.patch` → `cordis.patch.yml`（`insert: [{ id, name: 包名 }]`）让 `dsh plugin --profile <name> add <包>` 一键安装
- 完整静态双端 = `exports["./client"]`（`window.__ModuleLoader__.load` 经典脚本封套）+ `dsh.client: { platform: "web", inject: [客户端服务模块 id] }`
- 客户端检测可以**不需要宿主桥**：inject `sessions`/`workspaces` 服务订阅快照（只保留 goal 投影——`pendingInteraction` 与 `jobsBySession` 分别在 DSH 0.1.5 / 0.1.7 起已不在 `SessionSummary` / `SessionListState` 内；`complete`/`subcomplete`/`interrupt` 原先也用 `pendingInteraction` 守卫、恒真会误判，故与前述各类一并须走宿主 `/events` 桥）。宿主桥的 `/events` 响应带 `boot` 令牌，每次宿主重启都会更换且 `seq` 从 0 重新计数；客户端**必须**在 `boot` 变化时把游标归零（宿主侧按 `ev.seq > after` 过滤，不归零会让该标签页此后永久失声，只能靠刷新恢复）
- 设置页插槽一致（`settings.section`），label 支持 `() => string` 函数形式；样式用 `<style data-plugin data-plugin-css>` + HMR 去重

## 各市场提交入口

| 市场 | 仓库 | 提交方式 |
|---|---|---|
| WhaleHub 🐋 | [vvlife/whalehub-dsh](https://github.com/vvlife/whalehub-dsh) | 按仓库 README 的 registry 格式发 PR（发现/搜索/一键安装） |
| dsh-market | [dsh-market/dsh-market](https://github.com/dsh-market/dsh-market) | 按仓库 README 发 PR（DSH 内可视化市场） |
| dshfind | [hikariming/dshfind](https://github.com/hikariming/dshfind) | 发 PR / issue（插件市场 + 最佳实践） |
| awesome-deepseek-harness | [0xsline/awesome-deepseek-harness](https://github.com/0xsline/awesome-deepseek-harness) | 发 PR 加一条精选条目（低门槛高曝光） |

各市场 registry 字段名略有差异，以目标仓库 README 为准；通用元数据块：

```json
{
  "name": "dsh-chime-alerts",
  "description": "十类 Agent 事件的声音提醒：任务完成 / 子任务完成 / 后台任务完成 / 需要授权 / 插件授权 / Agent 提问 / 计划评审 / 目标受阻 / 其他打断 / 后台任务失败。浏览器 Web Audio 合成音 + 系统蜂鸣混合发声，每事件独立开关/声音/音量，按工作区静音（设置页分组 + 侧栏只读标记）。",
  "repo": "https://github.com/nienieai/dsh-chime-alerts",
  "npm": "dsh-chime-alerts",
  "tags": ["notification", "sound", "audio", "提醒", "声音"],
  "install": "动态插件：cordis_define 粘贴 lib/host.js + lib/client.js；静态 npm：dsh plugin add dsh-chime-alerts（npm 当前发布 v0.5.7，v0.5.10 待补发）",
  "platforms": ["windows", "linux", "macos"],
  "license": "MIT"
}
```

## 参考案例

- 官方发布文档：[publish.zh.md](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.zh.md)
- 官方脚手架 RFC（模板仓库 + `pnpm create dsh-plugin`）：[Discussion #1629](https://github.com/deepseek-ai/deepseek-harness/discussions/1629)
- 社区开发引导（含 entry-contract 参考）：[vlln/plugin-registry](https://github.com/vlln/plugin-registry)