# 发版流程

## 0. 前置

- npm 账号，且**命令行**已登录：`npm whoami --registry=https://registry.npmjs.org/`
- 网页登录 ≠ 命令行登录，后者要的是 token。

## 1. 改版本

- `package.json` 的 `version`（与 git tag 一致：`v0.1.0` ↔ `0.1.0`）
- `CHANGELOG.md` 加一段，只写使用者能感知的变化

## 2. 跑测试

```bash
npm test
```

必须 0 失败。

## 3. 隐私核对（别省这一步）

```bash
npm pack --dry-run
```

逐项看清单：

- **不能出现**：`config.json`（里面有 token）、`seen.md`、`runs.md`、`out/`、`history.jsonl`、本机绝对路径、任何 `.env`
- **必须出现**：`lib/`（含 `client.js`，漏了客户端 bundle 插件会激活失败）、`prompts/duty.md`、`cordis.patch.yml`、`package.json`、`README.md`、`LICENSE`、`CHANGELOG.md`、`icon.svg`、`locale/*.json`
- `package.json` 里**不能有** `private: true`（会直接阻止 publish）
- `files` 白名单不能包含运行时数据文件

## 4. 提交与打 tag

```bash
git add -A
git commit -m "release: v0.1.0"
git tag -a v0.1.0 -m "github-duty 0.1.0"
git push origin main && git push origin v0.1.0
```

## 5. 发布

```bash
npm publish
```

`publishConfig.registry` 已指向官方源。网络不稳时 `ECONNRESET` 直接重试。

## 6. 发布后验证（别只看退出码）

```bash
npm view github-duty version --registry=https://registry.npmjs.org/
npm pack github-duty@0.1.0 --dry-run
```

再打开包页面看：README 渲染、icon、repository 链接、版本号与 tag 一致。

## 7. GitHub Release

选 tag，标题写版本号，正文贴 CHANGELOG 那一段。仓库加 topic `dsh-plugin`（生态检索按它找）。

## 8. 回滚（有限）

- `npm unpublish github-duty@X.Y.Z`：仅 72 小时内，且该版本号永久不可复用
- 超过 72 小时只能 `npm deprecate` 再发修复版
- 所以第 3 步的核对比事后回滚便宜得多