# 发布流程

## 前置条件

登录 npm（首次或 token 过期时执行）：

```bash
npm login
```

验证登录状态：

```bash
npm whoami
```

## 发布步骤

### 1. 确认代码已提交

```bash
git status
```

确保工作区干净，所有变更已 commit。

### 2. 升级版本号并发布

根据变更类型选择对应命令：

| 变更类型 | 命令 | 示例 |
|----------|------|------|
| Bug 修复 | `npm version patch` | 1.1.1 → 1.1.2 |
| 新功能（向下兼容） | `npm version minor` | 1.1.1 → 1.2.0 |
| 破坏性变更 | `npm version major` | 1.1.1 → 2.0.0 |

执行命令后会自动完成以下步骤：

1. **build** — 编译 TypeScript，生成 `dist/`
2. **doc** — 生成 TypeDoc 文档，输出到 `docs/`
3. **git push** — 推送代码到远程
4. **git push --tags** — 推送版本 tag
5. **npm publish** — 发布到 npm registry

## 发布验证

发布后可通过以下地址查看文档：

- https://unpkg.com/im2-link-jssdk/docs/index.html
- https://cdn.jsdelivr.net/npm/im2-link-jssdk/docs/index.html

## 注意事项

- 发布目标 registry 为 `https://registry.npmjs.org/`
- 发布内容仅包含 `dist/` 和 `docs/` 目录（由 `files` 字段控制）
- Node.js 要求 `>=22.0.0`