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 完整规范 - 详细格式说明、警报块用法、完整示例