Skip to content
Skills Library
DevOps & cloud · Automation

release

/release

发布 B站下载器(bili-downloader)的新版本:定版本号、整理 CHANGELOG.md、提交并推送 v版本号 的 tag,由 GitHub Actions 自动测试、打 Windows、macOS 和 Linux 的安装包并发布到 GitHub Releases,再跟踪运行、核对 Release。用户要发布、发版、出新版本、打 tag、release、bump version,或问发布流程、发布失败怎么处理、想先验证能不能打出包时使用。

Licence
MIT
Last repository change
13.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

发布 B站下载器(bili-downloader)的新版本:定版本号、整理 CHANGELOG.md、提交并推送 v版本号 的 tag,由 GitHub Actions 自动测试、打 Windows、macOS 和 Linux 的安装包并发布到 GitHub Releases,再跟踪运行、核对 Release。用户要发布、发版、出新版本、打 tag、release、bump version,或问发布流程、发布失败怎么处理、想先验证能不能打出包时使用。

Original author description

发布 B站下载器(bili-downloader)的新版本:定版本号、整理 CHANGELOG.md、提交并推送 v版本号 的 tag,由 GitHub Actions 自动测试、打 Windows、macOS 和 Linux 的安装包并发布到 GitHub Releases,再跟踪运行、核对 Release。用户要发布、发版、出新版本、打 tag、release、bump version,或问发布流程、发布失败怎么处理、想先验证能不能打出包时使用。

How it works

  1. 1. 发布前检查
  2. 2. 定版本号
  3. 3. 写更新日志
  4. 4. 本地测试构建(必须通过)
  5. 5. 提交并推送 main
  6. 6. 推送 tag(必须先得到用户确认)
  7. 7. 跟踪工作流
  8. 8. 核对结果
  9. 出错怎么办
  10. 只验证打包,不发布
Original SKILL.md headings · 116 lines, 407 words
SKILL.md preview
---
name: release
description: 发布 B站下载器(bili-downloader)的新版本:定版本号、整理 CHANGELOG.md、提交并推送 v版本号 的 tag,由 GitHub Actions 自动测试、打 Windows、macOS 和 Linux 的安装包并发布到 GitHub Releases,再跟踪运行、核对 Release。用户要发布、发版、出新版本、打 tag、release、bump version,或问发布流程、发布失败怎么处理、想先验证能不能打出包时使用。
---

# 发布新版本

推送 `v版本号` 的 tag 会触发 `.github/workflows/release.yml`:检查版本 → Windows、macOS 和 Linux 三个 runner 并行 `npm ci`、类型检查、单元测试和覆盖率门槛(`npm run build:win` / `build:mac` / `build:linux` 里先跑 `npm run verify`)并打包(Windows x64 NSIS、macOS x64 和 arm64、Linux x64)→ 汇总后由 `scripts/release.mjs` 创建 Release,上传两个 zip、两个 dmg、一个 AppImage、一个 deb、一个 Windows `.exe` 和 `update.json`。已安装的应用从 `releases/latest/download/update.json` 检查更新,所以**推送 tag 就等于把新版本发给所有用户**,推送前必须得到用户明确同意。

更多背景见 `docs/RELEASING.md`。版本号和更新日志的解析规则以 `scripts/release.mjs` 和 `scripts/lib/release.mjs` 为准。

## 1. 发布前检查

```bash
git switch main && git pull --ff-only
git status --porcelain                          # 必须没有输出
gh run list --workflow release.yml --limit 3    # 不能有正在跑的发布
gh run list --workflow deploy-pages.yml --limit 3 # 不能有正在跑的官网部署
```

有未提交的改动、本地和 origin/main 不一致、或者测试没过,先停下来告诉用户,不要自行处理。

## 2. 定版本号

- 上一个版本:`git describe --tags --abbrev=0`;之后的改动:`git log --oneline <上一个 tag>..HEAD`
- 用户没给版本号时按 semver 提议一个,请用户确认:有新功能升 minor,只有修复升 patch;现在还是 0.x,除非用户要求,不升 major
- 带后缀的版本号(如 `1.0.0-beta.1`)会发成预发布版本,已安装的正式版收不到
- 版本号不能复用,`gh release view v<版本>` 能查到就换一个

```bash
npm version <版本> --no-git-tag-version   # 同时改 package.json 和 package-lock.json,不提交、不打 tag
```

## 3. 写更新日志

`CHANGELOG.md` 每个版本一段,标题必须是 `## <版本> - YYYY-MM-DD`(今天的日期,`date +%F`),下面用列表写变化,新的一段放在已有版本段的最上面。这段会原样显示在应用的更新弹窗和 Release 页面上,读者是普通用户:

- 有“未发布”一段就把它的标题改成新版本的标题,内容按下面的要求过一遍
- 没有就根据 `git log` 起草:只写用户能感知到的变化(新功能、修复、界面调整),不写重构、测试、CI、文档之类的内部改动
- 简体中文,一条说一件事,写清楚在哪里、有什么用,风格参照已有的段落;可以用 `**粗体**`、`` `代码` `` 和链接

起草的日志先给用户看,确认后再继续。

## 4. 本地测试构建(必须通过)

```bash
npm run release:preflight
```

预检先离线检查版本和 CHANGELOG,再在本机当前系统运行完整的 `build:mac`、`build:linux` 或 `build:win`。这些构建会运行类型检查、单元测试、覆盖率门槛并生成当前系统安装包;任何一步失败都不能提交发布 tag。离线检查不请求 GitHub,tag 工作流仍会在构建前用 `gh` 检查版本是否已发布,并在 macOS、Linux、Windows 上分别重新构建。

## 5. 提交并推送 main

```bash
git add package.json package-lock.json CHANGELOG.md
git commit -m "chore: 发布 <版本>"
git push origin main
```

## 6. 推送 tag(必须先得到用户确认)

把版本号和更新日志再给用户过一遍,说明推送后会自动发给所有用户,得到明确同意后:

```bash
git tag v<版本>
git push origin v<版本>
```

## 7. 跟踪工作流

```bash
gh run list --workflow release.yml --event push --limit 1   # 拿到 run id
gh run watch <run-id> --exit-status                          # 一般 3~5 分钟
```

能在后台运行命令的话放到后台等,不要反复轮询。失败时用 `gh run view <run-id> --log-failed` 看原因。

## 8. 核对结果

```bash
gh release view v<版本> --json isPrerelease,url,assets -q '.url, .isPrerelease, .assets[].name'
node -e "fetch('https://github.com/wangzi6224/bili-downloader/releases/latest/download/update.json').then(r => r.json()).then(m => console.log(m.version))"
```

- 资源里应有 `bili-downloader-<版本>-arm64.zip`、`-arm64.dmg`、`-x64.zip`、`-x64.dmg`、`-x86_64.AppImage`、`-amd64.deb`、`-x64.exe` 和 `update.json`
- `update.json` 的 `files` 里应有 `arm64`、`x64`、`linux-x64`、`win32-x64` 四项
- 正式版:`latest` 清单的版本应等于新版本;预发布版本不会改变 `latest`

最后把 Release 链接和核对结果告诉用户。

## 出错怎么办

| 情况 | 处理 |
| --- | --- |
| “检查版本”这一步失败 | 看日志:tag 和 `package.json` 版本不一致、更新日志里没有这个版本、或已经发布过。修好并推送到 main 后,告诉用户要删掉旧 tag 重打:`git push origin :refs/tags/v<版本> && git tag -d v<版本>`,再回到第 6 步 |
| 类型检查、测试、覆盖率门槛或打包失败 | 同上:修复 → 删 tag → 在修好的提交上重打 |
| 网络之类的偶发失败,Release 还没创建 | `gh run rerun <run-id> --failed` |
| Release 已经创建但有问题 | 用户可能已经更新了,不要删掉后用同一个版本号重发;告诉用户,一般是修好后发一个新的补丁版本 |

## 只验证打包,不发布

改了 `electron-builder.yml`、`scripts/fetch-ffmpeg.mjs`、依赖等打包相关的内容,推送到 main 后可以先手动跑一次:

```bash
gh workflow run release.yml --ref main
```

手动运行只打包不发布,三个系统的安装包和 `update.json` 作为这次运行的产物保留 7 天。

## Actions 不可用时

在本机运行 `npm run release`:它先执行同一个离线预检并打当前系统安装包,然后才用 `gh` 检查并创建 Release。`dist/` 必须已经包含 macOS、Linux 和 Windows 全部安装包;缺任何一个包脚本都会停下。只在 Actions 确实不可用时这样做,不要和工作流同时发同一个版本。

## 不要做

- 不要在用户确认前推送 tag,不要强推或移动已经有 Release 的 tag
- 不要在官网部署运行或等待时开始应用发布;最终发布 job 共用并发锁,一次只启动一个待发布操作
- 不要手动替换已发布 Release 里的文件:`update.json` 里记录了所有自动更新包的 sha512,对不上应用会拒绝更新
- 不要跳过 `CHANGELOG.md`:没有这个版本的说明,工作流第一步就会失败
Files in this package (2)
  • SKILL.md 7 KB
  • agents/openai.yaml 1 KB

Versions

RepositoryScoreLicence
This page · wangzi6224/bili-downloader100MIT
josephfung/curia100MIT
max-sixty/worktrunk100MIT
gtapps/hermitd100MIT
gtapps/hermitd100MIT
anthony-chaudhary/fak100Apache-2.0
tractorjuice/arc-kit100MIT
drvoss/everything-copilot-cli100MIT
sma1lboy/rove100MIT

Database snapshot: 13.11.2026 · package version 154f4db6e4fa (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100version-release
    Use when bumping version, creating a release tag, or pushing a version tag. Triggers on "version up", "release", "tag push", "bump version".
  • 91nacl-tl-release
    Full release pipeline: merge verified PRs to main, wait for production CI, health check, version bump, git tag, changelog, GitHub release, YouGile notification. Use when: create release, bump version, merge and release, generate release notes, tag version, or the user says "/nacl-tl-release".
  • 100release-this
    Orchestrates the full powerball-harness plugin release with build, validation, version bump, CHANGELOG, tag, and GitHub Release. Use when releasing this plugin.
  • 100release-cli
    Release a new version of the pd CLI. Runs tests, bumps version, creates git tag, and pushes to remote. Use when releasing a new CLI version.
  • 100release-plugin
    Use when cutting a new version release for the squads Claude Code plugin — version bump, tag, or GitHub release.
  • 100ship-release
    Use when the user asks to release, ship, publish, cut or tag a version of a project ("release v0.2.0", "ship a patch", "bump and publish"). Bumps every version manifest, updates CHANGELOG and README badges, commits, lands it directly or through a pull request (pre-PR check,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.