# 发布五会话自进化

本页为维护者发布指南。`OWNER`、`COMMIT_SHA` 等是需要替换的占位符；它们不代表已经存在的在线仓库。

## 1. 核验并发布仓库

目标环境：DSH 0.2.1-rc.5、Node.js 22+。

```sh
npm install
npm run check
npm test
npm pack --dry-run
```

发布仓库仅包含此项目的源码、测试和说明。请检查暂存区，确认项目记忆、个人会话日志、环境配置和依赖目录已排除。

GitHub 仓库建议名称 `dsh-five-session-evolution`，公开可见，添加 topic `dsh-plugin`、`deepseek-harness`、`memory`、`self-improvement`。建议描述：

> Review every five ended DeepSeek Harness project sessions, retain sourced lessons and workflow drafts, and bring project memory into later conversations.

确认 GitHub 已登录后，可通过 GitHub CLI 发布：

```sh
gh auth status
git init -b main
git add .
git commit -m "Release five-session evolution plugin v0.1.0"
gh repo create OWNER/dsh-five-session-evolution --public --source . --push --description "Evidence-backed project memory and workflow drafts after every five ended DeepSeek Harness sessions."
gh repo edit OWNER/dsh-five-session-evolution --add-topic dsh-plugin,deepseek-harness,memory,self-improvement
```

登录由标准 GitHub CLI 或 BrowserSkill 中的现有浏览器登录处理。仓库所有者以实际登录结果为准。

## 2. 生成固定提交的 Discover 索引

在源码和发布说明已提交后，取得源码提交的完整 40 位 SHA：

```sh
git rev-parse HEAD
node scripts/market-index.mjs https://github.com/OWNER/dsh-five-session-evolution COMMIT_SHA market-index.json
```

检查生成结果后提交并推送索引。索引引用上一个源码提交，避免索引文件本身与提交 SHA 相互依赖：

```sh
git add market-index.json
git commit -m "Publish pinned DSH Discover index"
git push
```

自定义索引 URL：

```text
https://raw.githubusercontent.com/OWNER/dsh-five-session-evolution/main/market-index.json
```

在支持自定义市场源的 DSH 中，打开插件管理 → 发现 / Discover → 添加索引源，填入此 URL。启用相应的实验性插件市场功能后，刷新列表并搜索 `Five-session Evolution` 或 `五会话自进化`。索引是 format 1，来源为 Git HTTPS 仓库和固定提交。

生成脚本的测试使用 DSH 官方 `parseMarketIndex` 校验器。远程发布后，还应重新读取实际 raw URL 并校验版本、来源提交与包名称。自定义源可见性取决于用户添加了该源。

## 3. 打包 Release

```sh
npm pack

gh release create v0.1.0 ./dsh-five-session-evolution-0.1.0.tgz --title "Five-session Evolution v0.1.0" --notes-file RELEASE_NOTES.md
```

检查打包文件清单及安装补丁。版本号变动时，同时更新 manifest、发布说明与索引。当前包通过 Git / Release 供安装；npm registry 发布是另一个独立步骤。

## 4. 提交社区市场收录

社区目录为 [awesome-dsh-plugin/awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)。请以仓库当前 [contributing.md](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md) 为准。

截至本项目实现时的规则：公开仓库、包含有效 `dsh.bundle` 的 manifest、topic `dsh-plugin`、可用代码，且仓库创建时间至少一天。新仓库的收录检查可能等待年龄条件通过。目录维护者合并后，社区市场再按自己的刷新策略同步。

在目录 fork 中新建 `data/plugins/OWNER__dsh-five-session-evolution.yml`，将占位符替换为真实信息：

```yaml
name: OWNER/dsh-five-session-evolution
url: https://github.com/OWNER/dsh-five-session-evolution
category: memory
description:
  en: Review every five ended DeepSeek Harness project sessions and retain evidence-backed lessons and workflow drafts.
  zh: 每五次项目会话结束自动复盘，积累有来源的项目经验，提炼工作流候选，并为后续会话带入记忆。
```

仅新增自己的条目，按目录当前模板补充字段。提交 PR，记录 PR URL 与检查结果。社区市场的收录状态以合并和实际目录内容为准；自定义源发布不代表社区目录已收录。

## 安装后的验收

1. 在测试项目中启用插件，调用 `evolution_status`，确认状态工具可用。
2. 创建并正常结束五个不同的根会话。至少两个会话包含相同、已核验的项目经验。
3. 确认总数为 5、待满批为 0；批次完成后可见复盘摘要及带来源 ID 的经验。
4. 恢复并再次结束其中一个会话，确认计数保持 5。
5. 在同一项目的新会话中核对经验上下文，在另一个项目中核对计数和经验隔离。
6. 核对模型提供方、费用、失败日志和持久记录位置，记录实际 DSH 版本。

本地测试采用固定模型输出并包含真实 Cordis 加载/卸载；完整桌面流程与真实模型调用需要以上安装后验收。