app-store-changelog

App Store 更新日志

概览

根据自上一个标签以来的 git 历史生成全面、面向用户的更新日志，然后将提交内容转换为清晰的 App Store 版本说明。

工作流

1) 收集更改

• 在仓库根目录运行 scripts/collect_release_changes.sh，收集提交和涉及的文件。
• 如有需要，传入特定标签或引用：scripts/collect_release_changes.sh v1.2.3 HEAD。
• 如果不存在标签，脚本会回退到完整历史记录。

2) 梳理用户影响

• 浏览提交和文件，找出用户可见的更改。
• 按主题归类更改（新增、改进、修复），并去除重复内容。
• 排除仅限内部的工作（构建脚本、重构、依赖项升级、CI）。

3) 起草 App Store 说明

• 为每项面向用户的更改撰写简短、突出收益的要点。
• 使用清晰的动词和通俗易懂的语言；避免内部术语。
• 除非用户要求其他长度，否则优先提供 5 到 10 条要点。

4) 验证

• 确保每条要点都能对应到此次范围内的实际更改。
• 检查是否存在重复内容或过于技术化的表述。
• 如果有更改含义不明确或可能仅限内部使用，请寻求澄清。

提交到要点的示例

以下示例展示了如何将原始提交转换为 App Store 要点：

原始提交消息	App Store 要点
fix(auth): resolve token refresh race condition on iOS 17	• 修复了一个登录问题，该问题可能导致部分用户意外退出登录。
feat(search): add voice input to search bar	• 使用新增的语音输入选项，即可免手动搜索你的资料库。
perf(timeline): lazy-load images to reduce scroll jank	• 现在浏览时间线时更加流畅、快速。

应排除的仅限内部提交（对用户没有影响）：

• chore: upgrade fastlane to 2.219
• refactor(network): extract URLSession wrapper into module
• ci: add nightly build job

输出示例

What's New in Version 3.4

• Search your library hands-free with the new voice input option.
• Scrolling through your timeline is now smoother and faster.
• Fixed a login issue that could leave some users unexpectedly signed out.
• Added dark-mode support to the settings screen.
• Improved load times when opening large photo albums.

输出格式

• 标题（可选）：“新内容”或产品名称 + 版本号。
• 仅使用项目符号列表；每条要点为一个句子。
• 如果用户提供了商店页面限制，请遵守。

资源

• scripts/collect_release_changes.sh：收集自上一个标签以来的提交和涉及的文件。
• references/release-notes-guidelines.md：App Store 说明的语言、筛选和质量检查规则。