# Releasing

这个文件用于记录把当前仓库正式发布到 GitHub 的最小流程。

## 发布前检查

1. 确认 `README.md`、`LICENSE`、`THIRD_PARTY_NOTICES.md` 已更新
2. 确认本次 Release 文案已经整理完成，建议放在 `docs/releases/` 目录留档
3. 确认 `manifest.json`、侧边栏标题和版本展示文案已经同步到目标版本号
4. 检查代码、截图、默认配置里没有真实密钥、代理、手机号、邮箱、Cookie、回调地址
5. 确认 `docs/images` 中的 README 图片可以正常显示
6. 运行测试或至少完成关键功能自测
7. 检查 `git diff`，确认没有把本地临时文件一起带上

## 当前版本建议

- 当前待发布版本：`v0.1.7`
- 当前扩展版本号：`0.1.7`
- Release 文案文件：`docs/releases/v0.1.7.md`
- GitHub Release 正文可直接复制 `docs/releases/v0.1.7.md`

## 首次发布

1. 创建新的 GitHub 仓库
2. 设置默认分支为 `main`
3. 推送当前代码
4. 检查仓库首页 README、图片和许可证识别是否正常
5. 创建首个 Release，例如 `v0.1.0`

## 推送示例

```powershell
git status
git add .
git commit -m "Initial open source release"
git remote remove origin
git remote add origin https://github.com/<your-name>/<your-repo>.git
git branch -M main
git push -u origin main
```

## 常规发版建议

```powershell
git status
git add manifest.json sidepanel/sidepanel.html sidepanel/update-service.js sidepanel/sidepanel.js docs/releases/v0.1.7.md RELEASING.md
git commit -m "Prepare v0.1.7 release"
git tag -a v0.1.7 -m "GuJumpgate v0.1.7"
git push origin main
git push origin v0.1.7
```

## Release 说明建议

建议在 Release 页面说明：

- 本次版本的核心新增能力
- 关键修复项
- 目前仍推荐的导出方式和使用限制
- 需要用户自行配置的外部服务
- 与 Issue / 社区反馈对应的改动来源