# GitHub 与 DSH 市场发布工作流

目标仓库：`jueduihouqi-GG/dsh-runtime-map`，MIT。下面是维护者发布流程；实际发布与收录状态以 GitHub Release 和市场页面为准。

## 发布物

1. GitHub：当前干净源码、预构建 `lib`、版本说明、插件 `.tgz` 和 SHA-256 校验文件。
2. DSH 市场：同一个包名、版本与源码提交；索引提供发现/安装信息，不另起一份功能分支。
3. 两个 Skill 随插件和源码分发；WorkBuddy / Codex 附属观察器可单独下载，不能误称自动安装。

## 审阅后执行的顺序

1. 完成 `ACCEPTANCE.md`，确认剩余限制、图标出处及新机安装方式。
2. 在全新公开仓库提交干净目录，不能推送原工作区的历史。构建、审计和测试均通过后确定不可变 commit。
3. 将构建后的 `lib` 一同提交，Git 安装无需下载后运行本项目构建脚本。版本、manifest、说明与 tarball 一致。
4. `npm pack --ignore-scripts` 仅打包，不执行 `npm publish`。核对完整 tar 列表和校验值，再创建 GitHub release。
5. 用实际发布源码 commit 及其 committer 时间生成市场索引：

   ```powershell
   node scripts/market-index.mjs <真实40位提交号> <提交时间的Unix秒数> <输出index.json路径>
   ```

   索引使用 `next` 通道，RC 不冒充稳定 latest。空提交号/零填充提交号会拒绝。索引可在后续单独提交发布，仍引用先前的代码提交，不形成自引用。
6. 按官方格式校验索引，在 DSH 自定义插件索引中测试精确版本安装，再考虑提交社区市场。
7. 记录安装、升级、卸载结果。正式发布前由维护者确认，不以自动测试通过触发公开。

## 市场现状与入口

DSH 官方当前提供的是可配置的自定义插件索引，实验功能默认关闭；并没有一个由本项目可以直接“上传”的官方统一索引。[官方 bundle 说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/experimental/plugin-market-bundle/README.md)

格式 1 的 Git 来源要求不可变 40 位提交号；安装器还会核对 `dsh.bundle` 与 `engines.dsh`。不能把未创建的仓库或假 SHA 当可安装条目。[官方格式规则](https://github.com/deepseek-ai/deepseek-harness/blob/master/.agents/notes/implemented/feature/2026-10-02-plugin-market-index-format.md)

`dsh.pub` 是可另行提交的社区目录，需已公开的 GitHub 仓库；提交后仍需通过其独立校验与收录流程。[社区提交入口](https://dsh.pub/en/submit/)

## 市场提交说明

名称：Runtime Map

说明：在 DeepSeek Harness 中汇集原生目录、可信会话状态与共享关系画布。支持 Codex/本地 Work、WorkBuddy 等本机来源，两个内置 Skill 可同步目录及编辑地图。云端 ChatGPT/Work 实时状态未接入；WorkBuddy 状态需附属观察插件。Windows、DSH 0.2.0-rc.2，当前首次使用需配置本地后台。

分类：效率 / 开发工具。许可证：MIT。仓库：https://github.com/jueduihouqi-GG/dsh-runtime-map 。索引随不可变发布提交生成。