// Cut a Pixiv-Shaft release — bump version, tag, draft a concise changelog, create GitHub release marked latest, upload the APK with the project's naming convention. Use when the user says /genupdate or asks to "发版 / 出新版本 / cut a release".
| name | genupdate |
| description | Cut a Pixiv-Shaft release — bump version, tag, draft a concise changelog, create GitHub release marked latest, upload the APK with the project's naming convention. Use when the user says /genupdate or asks to "发版 / 出新版本 / cut a release". |
把「改版本号 → commit/push → tag → 写 changelog → 建 release → 传 APK」一把梭。每步都要先看上次怎么做的，不要凭记忆推。
约束（项目偏好，别违反）：
classic，不开 PR、不开 feature branchchore(release): X.Y.Z），不能指向更早的功能 commit新功能 / 重要修复 / 其它，每条一句话，能合就合PixShaft_{version}_classic.apk——大小写、下划线位置严格照搬历史 releasegit status # 必须 clean 或只有 app/build.gradle
git log --oneline -1 # 确认在 classic 顶部
gh release list --repo CeuiLiSA/Pixiv-Shaft -L 3 # 拿到上一版本号 = $PREV
如果 app/build.gradle 还没改版本号，问用户要新版本号；如果用户已经手改了，从 diff 里读出来。
git add app/build.gradle
git commit -m "chore(release): X.Y.Z" # 末尾要带 Co-Authored-By,见全局约定
git push origin classic
记下这个 commit 的 sha = $VERSION_SHA。
git tag vX.Y.Z $VERSION_SHA # lightweight tag,不要 -a
git push origin vX.Y.Z
如果 tag 已经存在但指向错的 commit（比如用户提前 tag 了某个 feature commit）：
git tag -d vX.Y.Z
git push origin :refs/tags/vX.Y.Z
git tag vX.Y.Z $VERSION_SHA
git push origin vX.Y.Z
这步是 force-tag，移动前主动跟用户确认一句。
读 git log $PREV..HEAD --oneline，按下面规则归三段：
feat(*) 提交；功能向用户可感知的（picker、新筛选维度、新页面入口、深链等）fix(*) 中崩溃 / OOM / 数据错位 / 兼容性失效 / GitHub issue 关联的；多个零碎修复合成一行「多处崩溃和内存问题」精简原则（这条是 skill 的核心，违反会被打回）：
refactor / docs / chore 全部不要示例（v4.7.1 实战）：
v4.7.1 更新日志
新功能
- 接入 pixiv 官方通知和公告中心
- V3 搜索筛选器：插画/漫画加「长宽比」「分辨率」，小说加「正文长度」和「阅读预计用时」
- V3 搜索：会员可按男性/女性向人气排序
- 投稿期间 picker 改 7 行扁平布局，对齐官方
- 支持 shaftintent://search 外部深链调起搜索
- 作者有漫画作品时主页插入漫画 tab
重要修复
- 浏览历史导致的 CursorWindow OOM
- 下载管理器并发崩溃
- 幻灯片 Handler 泄漏
- R18 榜单被全局过滤清空
- 安装更新 API 失效，加浏览器兜底
- 多处崩溃和内存问题
- 搜索固定标签不再被历史挤掉
- 详情页相关作品/评论空态、白边、底部安全区
- 批量选择边框圆角对齐
- 反向搜图错误文案优化
其它
- 详情页标题/作者长按复制
- ID 搜索自动剥离非数字字符
- 长按热门标签直接看代表插画
草稿先给用户过一遍，他改完再上传。
gh release create vX.Y.Z \
--repo CeuiLiSA/Pixiv-Shaft \
--title "vX.Y.Z" \
--latest \
--notes "$(cat <<'EOF'
<上面 user 通过的 changelog>
EOF
)"
不依赖 GitHub CI（项目没用 CI 出 APK），APK 用户本机已 build 好，直接进第 5 步。
APK 永远在 app/github/release/app-github-release.apk（项目根的相对路径），用户本机 build 出来的。按约定改名后上传：
cp app/github/release/app-github-release.apk /tmp/PixShaft_X.Y.Z_classic.apk
gh release upload vX.Y.Z /tmp/PixShaft_X.Y.Z_classic.apk --repo CeuiLiSA/Pixiv-Shaft
rm /tmp/PixShaft_X.Y.Z_classic.apk
如果这条路径找不到 APK：不要 build，也不要等任何 CI，直接告诉用户「请先本地 build」然后停下来。
最后输出三条链接：release page、APK 下载链接、tag 链接。
./gradlew assembleGithubRelease（耗时长 + 签名钥匙在他手里）major * 10000 + minor * 100 + patch * 10（4.7.1 → 40710），照搬上一版本数学规律即可，对不上要停下问gh release edit 改 notes，不要 delete-recreate（download_count 会丢）