# npm 发布检查清单

## 发布前

- [ ] 版本号已升级，且 `package-lock.json` 已同步。
- [ ] `README.md`、客户说明和技能文档已更新。
- [ ] `npm run claude-voc:acceptance` 通过，确认包级 smoke、MCP smoke、npm pack dry-run 和 workspace 安装断言都正常。
- [ ] `npm run claude-voc:npm-pack` 通过。
- [ ] `npm run claude-voc:build` 通过，zip 交付方式没有被破坏。
- [ ] 无 VOC token / 余额不足 / 未开通权限时，工具返回充值链接，不向用户暴露底层 403 或接口报错。
- [ ] `npm publish --dry-run` 能看到关键文件：
  - `.claude-plugin/plugin.json`
  - `.mcp.json`
  - `bin/claude-voc.js`
  - `skills/xiaohongshu-trend-intelligence/SKILL.md`
  - `mcp/src/server.js`

## 发布

```powershell
powershell -ExecutionPolicy Bypass -File release/npm/claude-code-voc-intelligence/publish.ps1
```

## 发布后

- [ ] 执行 `npm view @vocmarket/voc-skill version` 确认版本。
- [ ] 执行 `npx --yes @vocmarket/voc-skill@latest workspace --smoke` 做线上工作区安装验证。
- [ ] 更新教学文档或下载页里的版本信息。