GitHub Release

通过浏览器完成 GitHub Release 发布，自动生成符合规范的 Release Notes。

工作流程

1. 收集信息 - 同步远程仓库：git fetch --all - 获取上一版本号：git describe --tags --abbrev=0 - 获取两个版本间的 commit 列表：git log <prev>..HEAD --oneline - 确定下一版本号（版本号不带 v 前缀，如 0.10.1）

2. 生成 Release Notes - 按规范格式生成（详见 release-notes-spec.md） - 分类优先级：breaking > feat > fix > chore/docs - 过滤无意义 commit（如 "update version"、"merge branch"）

3. 发布 - 打开浏览器访问：https://github.com/Coooolfan/XiaomiAlbumSyncer/releases/new - 填写 Tag（版本号）、Title - 填写 Release Notes：使用 evaluate_script 而非 fill（见下方注意事项） - 必要时请求用户介入确认

4. 截图存档 - 发布成功后，获取页面快照（take_snapshot） - 找到 main 元素的 uid，对其截图（take_screenshot 的 uid 参数） - 保存路径：~/Downloads/release-<version>-<YYYYMMDD>.png

Release Notes 格式速查

> [!NOTE]
> 可选的警报块（测试版/breaking change 说明）

## feat
* 功能描述 https://github.com/Coooolfan/XiaomiAlbumSyncer/commit/<hash>

## fix
* 修复描述 https://github.com/Coooolfan/XiaomiAlbumSyncer/commit/<hash>

## chore / docs
* 变更描述 https://github.com/Coooolfan/XiaomiAlbumSyncer/commit/<hash>

Full Changelog: https://github.com/Coooolfan/XiaomiAlbumSyncer/compare/<prev>...<new>

格式要点： - 条目以 * 开头，重要内容用 **加粗** - 句末不加句号 - 每条后跟 commit 完整 URL - 结尾必须有 Full Changelog 链接

注意事项

Release Notes 填写方式

GitHub 的 Release Notes textarea 有 Markdown 列表自动补全功能。使用 fill 工具模拟键盘输入时，换行后以 * 开头的行会被自动补全为 * *（重复星号），空行也会丢失。

解决方案：使用 evaluate_script 直接设置 textarea 的 value：

(el) => {
  el.value = `## chore / docs
* 条目一
* 条目二

Full Changelog: ...`;
  el.dispatchEvent(new Event('input', { bubbles: true }));
  return el.value;
}

调用时传入 textarea 元素的 uid 作为参数。

参考资料

• Release Notes 完整规范 - 详细格式说明、警报块用法、完整示例