| name | octane-release |
| description | Use when publishing a new Octane browser-extension version to GitHub Releases, bumping nothing but packaging the chrome MV3 build and creating a release with the version's changelog notes. Triggers on "发版 / release octane / 发 GitHub Release / ship a version". |
Octane Release
Overview
把 Octane 当前 package.json 版本发到 GitHub Release，最终 Release 页面必有 3 个文件：
Source code (zip) —— GitHub 自动生成（源码快照，不可加载）Source code (tar.gz) —— GitHub 自动生成（源码快照，不可加载）octane-<version>-chrome.zip —— 本流程上传的、可加载的 chrome MV3 扩展包
核心坑：WXT 的 zip 产物在 .output/，不是 dist/。dist/*.zip 永远匹配为空。
Prerequisites（执行前先校验）
gh auth status | grep -q "Logged in" || { echo "gh 未登录"; exit 1; }
git diff --quiet || { echo "工作区有未提交改动，先 commit"; exit 1; }
VERSION=$(node -p "require('./package.json').version")
git tag --list "v$VERSION" | grep -q "v$VERSION" || { echo "缺少 tag v$VERSION，先 git tag v$VERSION && git push origin v$VERSION"; exit 1; }
Steps（按序执行，每步验证）
1. 构建 chrome 包 → 验证：.output/chrome-mv3/manifest.json 存在
2. 打包 zip → 验证：.output/octane-<ver>-chrome.zip 存在且非空
3. 提取 release notes → 验证：输出非空、只含当前版本段
4. 创建 release → 验证：release 页面有 3 个文件
1. 构建 + 打包
pnpm run build
pnpm run zip
2. 校验产物
ZIP=".output/octane-${VERSION}-chrome.zip"
test -s "$ZIP" || { echo "zip 未生成或为空：$ZIP"; exit 1; }
ls -lh "$ZIP"
3. 提取当前版本的 CHANGELOG 段（只发本版本，非整个文件）
NOTES=$(node -e '
const v = process.argv[1];
const md = require("fs").readFileSync("CHANGELOG.md", "utf8");
const re = new RegExp("## \\[" + v + "\\][\\s\\S]*?(?=\\n## \\[|$)");
const m = md.match(re);
process.stdout.write(m ? m[0].trimEnd() : "");
' "$VERSION")
test -n "$NOTES" || { echo "CHANGELOG 找不到版本 $VERSION 段"; exit 1; }
4. 创建 Release（上传 zip）
gh release create "v$VERSION" "$ZIP" \
--title "v$VERSION" \
--notes "$NOTES"
5. 验证最终 3 个文件
gh release view "v$VERSION" --json assets --jq '.assets[].name'
gh release view --json assets 只列出上传的 assets（即 zip），Source code (zip/tar.gz) 是 GitHub 页面单独渲染、不在 assets 列表里。打开浏览器 Release 页面才能看到完整 3 项。
Common Mistakes
| 错误 | 结果 | 正解 |
|---|
用 dist/*.zip | 匹配为空，Release 没有扩展包 | 用 .output/*.zip |
--notes-file CHANGELOG.md | 整个 changelog 当 notes，历史全堆上去 | 用 node 截取当前版本段（awk 的整行位置参数在 skill 加载时会被管道清空，node 不受影响） |
忘了 pnpm run build 直接 zip | zip 为空或旧产物 | 先 build 再 zip |
| 没打 tag 就 create | gh 自动建 tag 但指向当前 HEAD，可能错位 | 先在目标 commit 打 tag 并 push |
| 想发 Firefox 包 | 只有 chrome | 另跑 pnpm run zip:firefox，asset 多传一个 .output/*-firefox.zip |
| 把 Source code 当扩展发 | 用户装不上（无编译后 assets） | 必须上传 .output/*.zip |
Fire and forget（一条命令版，已通过所有校验后用）
VERSION=$(node -p "require('./package.json').version") && \
pnpm run build && pnpm run zip && \
ZIP=".output/octane-${VERSION}-chrome.zip" && test -s "$ZIP" && \
NOTES="$(node -e 'const v=process.argv[1],md=require("fs").readFileSync("CHANGELOG.md","utf8"),m=md.match(new RegExp("## \\["+v+"\\][\\s\\S]*?(?=\\n## \\[|$)"));process.stdout.write(m?m[0].trimEnd():"")' "$VERSION")" && \
gh release create "v$VERSION" "$ZIP" --title "v$VERSION" --notes "$NOTES"
