From b2af0e4e535c02675761fb6bb9c96fc344fa7a6b Mon Sep 17 00:00:00 2001 From: huangjianwu Date: Thu, 7 May 2026 13:45:32 +0800 Subject: [PATCH] =?UTF-8?q?chore(repo):=20=E4=BB=93=E5=BA=93=E5=B7=A5?= =?UTF-8?q?=E5=85=B7=E9=93=BE=E2=80=94=E2=80=94issue/PR=20=E6=A8=A1?= =?UTF-8?q?=E6=9D=BF=20+=20commitlint=20CI=20+=20=E6=8F=92=E4=BB=B6?= =?UTF-8?q?=E5=8F=91=E7=89=88=E5=B7=A5=E4=BD=9C=E6=B5=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 把 CONTRIBUTING.md 里写的规范落到 GitHub 工程化层。 Issue / PR 模板： - .github/ISSUE_TEMPLATE/{config,bug_report,feature_request}.yml · yml 表单形式，跟随当前工作区分类（backend / frontend / extension / Tauri） · bug_report 强制选版本 + 部署方式 + 复现步骤；提交前自查不夹带 secrets · config.yml 禁用空白 issue，引导 Discussions - .github/pull_request_template.md：把 CONTRIBUTING §5.2 的 PR 正文要求落成 checklist - 删旧版 .md 模板（含中文文件名那条），避免新老两套并存 Commitlint： - .commitlintrc.json：extend conventional + 自定义 type 白名单（feat/fix/docs/style/refactor/perf/test/build/ci/chore/ui/revert） - .github/workflows/commitlint.yml：用 wagoid/commitlint-github-action@v6，PR + push develop/master 时校验 · subject-case / subject-full-stop 关掉，兼容中文 subject · header-max-length 100 字符 warn 级别，不阻塞合并 插件发版工作流： - .github/workflows/release-extension.yml：v* tag push 时 · cd BillNote_extension && pnpm install + build · pack:zip / pack:xpi / pack:crx（crx 缺 key 自动跳过） · 产物重命名带版本后缀，挂到对应 GitHub Release - 末尾保留 publish-chrome / publish-edge / publish-firefox 三段注释，配齐 secrets 即可启用商店自动发布 - RELEASING.md：发版执行手册，覆盖 release/* 流程 + 各商店人工上传步骤 + 自动发布所需 secrets CONTRIBUTING.md 关联文档区指到新增的 RELEASING.md，commit 章节加 commitlint 落地说明。 Co-Authored-By: Claude Opus 4.7 (1M context) --- .commitlintrc.json | 28 ++++ .github/ISSUE_TEMPLATE/bug_report.md | 49 ------- .github/ISSUE_TEMPLATE/bug_report.yml | 93 ++++++++++++ .github/ISSUE_TEMPLATE/config.yml | 8 ++ .github/ISSUE_TEMPLATE/feature_request.yml | 40 ++++++ .github/ISSUE_TEMPLATE/新增功能建议.md | 29 ---- .github/pull_request_template.md | 39 +++++ .github/workflows/commitlint.yml | 32 +++++ .github/workflows/release-extension.yml | 115 +++++++++++++++ CONTRIBUTING.md | 4 + RELEASING.md | 158 +++++++++++++++++++++ 11 files changed, 517 insertions(+), 78 deletions(-) create mode 100644 .commitlintrc.json delete mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/bug_report.yml create mode 100644 .github/ISSUE_TEMPLATE/config.yml create mode 100644 .github/ISSUE_TEMPLATE/feature_request.yml delete mode 100644 .github/ISSUE_TEMPLATE/新增功能建议.md create mode 100644 .github/pull_request_template.md create mode 100644 .github/workflows/commitlint.yml create mode 100644 .github/workflows/release-extension.yml create mode 100644 RELEASING.md diff --git a/.commitlintrc.json b/.commitlintrc.json new file mode 100644 index 0000000..e448880 --- /dev/null +++ b/.commitlintrc.json @@ -0,0 +1,28 @@ +{ + "extends": ["@commitlint/config-conventional"], + "rules": { + "type-enum": [ + 2, + "always", + [ + "feat", + "fix", + "docs", + "style", + "refactor", + "perf", + "test", + "build", + "ci", + "chore", + "ui", + "revert" + ] + ], + "subject-case": [0], + "subject-full-stop": [0], + "header-max-length": [1, "always", 100], + "body-max-line-length": [0], + "footer-max-line-length": [0] + } +} diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index e4b7d56..0000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -name: Bug report -about: 上报一些bug -title: "[BUG]" -labels: bug -assignees: JefferyHcool - ---- - ---- -name: 🐛 Bug 反馈 -about: 提交一个 Bug 报告，帮助我们改进 -title: "[Bug] " -labels: bug -assignees: '' ---- - -**版本说明** - -请说明的你的版本号 - -**部署方式** - -使用的是什么方式部署（代码环境部署，docker部署，桌面端，在线预览） - -**描述问题** -清晰、简明地描述你遇到的问题是什么。 - -**复现步骤** -复现该问题的步骤： - -1. 进入页面 '...' -2. 点击 '...' -3. 滚动到 '...' -4. 出现错误 - -**预期行为** -清晰、简明地描述你本来预期发生的行为。 - -**截图** -如果适用，请添加截图以帮助说明问题。 - -**桌面端（请补充以下信息）** - - - 操作系统：例如 Windows / macOS / Ubuntu - - 浏览器：例如 Chrome、Safari - -**其他补充信息** -请补充任何其他相关信息。 diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 0000000..d86736e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,93 @@ +name: 🐛 Bug 报告 +description: 报告一个可复现的问题 +title: "[Bug] " +labels: ["bug"] +body: + - type: markdown + attributes: + value: | + 感谢反馈。请尽量提供完整的复现路径与日志，便于排查。 + ⚠️ **不要**贴 API key、SESSDATA、密钥等敏感信息。 + - type: dropdown + id: workspace + attributes: + label: 受影响的工作区 + multiple: true + options: + - 后端 (backend/) + - Web 前端 (BillNote_frontend/) + - 浏览器插件 (BillNote_extension/) + - Tauri 桌面端 + - 文档 / 其他 + validations: + required: true + - type: input + id: version + attributes: + label: 版本 + description: BiliNote 版本号（README 顶部，例如 v2.1.0） + placeholder: v2.1.0 + validations: + required: true + - type: dropdown + id: deploy + attributes: + label: 部署方式 + options: + - 源码运行 + - Docker (docker-compose.yml) + - Docker GPU (docker-compose.gpu.yml) + - 桌面端安装包 (Tauri Release) + - 其他 + validations: + required: true + - type: textarea + id: repro + attributes: + label: 复现步骤 + description: 一步步说明如何触发问题 + placeholder: | + 1. 打开 ... + 2. 点击 ... + 3. 看到 ... + validations: + required: true + - type: textarea + id: expected + attributes: + label: 期望行为 + validations: + required: true + - type: textarea + id: actual + attributes: + label: 实际行为 + description: 含错误信息、截图、录屏均可 + validations: + required: true + - type: textarea + id: env + attributes: + label: 运行环境 + description: 操作系统、Python 版本、Node 版本、浏览器（如适用） + placeholder: | + - OS: macOS 14.5 / Windows 11 / Ubuntu 22.04 + - Python: 3.11.6 + - Node: 20.18.0 + - Browser: Chrome 124（如涉及插件/前端） + - GPU: 无 / NVIDIA 4070（如涉及 fast-whisper / video understanding） + - type: textarea + id: logs + attributes: + label: 日志 / 堆栈 + description: 后端 console、前端 DevTools、扩展 background 页都可以贴 + render: text + - type: checkboxes + id: pre-checks + attributes: + label: 提交前自查 + options: + - label: 我已搜索过 [Issues](https://github.com/JefferyHcool/BiliNote/issues?q=)，确认不是重复问题 + required: true + - label: 我提供的日志中**不**包含 API key、cookie、SESSDATA 等敏感信息 + required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..7f8703e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: false +contact_links: + - name: 📖 文档与常见问题 + url: https://docs.bilinote.app/ + about: 安装与配置遇到问题，先看一下文档 + - name: 💬 提问 / 讨论 + url: https://github.com/JefferyHcool/BiliNote/discussions + about: 用法咨询、想法征集请发到 Discussions（不是 bug 才用 Issues） diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 0000000..94c76ba --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,40 @@ +name: ✨ 功能建议 +description: 提议新功能或改进 +title: "[Feature] " +labels: ["enhancement"] +body: + - type: textarea + id: problem + attributes: + label: 想解决什么问题？ + description: 描述你遇到的实际场景或痛点。 + validations: + required: true + - type: textarea + id: proposal + attributes: + label: 建议方案 + description: 期望的功能或交互。可附草图 / 示例。 + validations: + required: true + - type: textarea + id: alternatives + attributes: + label: 备选方案 + description: 你考虑过哪些其他做法？为什么没采用？ + - type: dropdown + id: workspace + attributes: + label: 涉及的工作区 + multiple: true + options: + - 后端 (backend/) + - Web 前端 (BillNote_frontend/) + - 浏览器插件 (BillNote_extension/) + - Tauri 桌面端 + - 不确定 + - type: textarea + id: extra + attributes: + label: 其他补充 + description: 关联 issue、参考资料、产品截图等 diff --git a/.github/ISSUE_TEMPLATE/新增功能建议.md b/.github/ISSUE_TEMPLATE/新增功能建议.md deleted file mode 100644 index bdaeb29..0000000 --- a/.github/ISSUE_TEMPLATE/新增功能建议.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -name: 新增功能建议 -about: 一些新的功能建议 -title: "[FEATHURE]" -labels: enhancement -assignees: JefferyHcool - ---- - ---- -name: ✨ 功能请求 -about: 提出一个新的功能建议 -title: "[Feature] " -labels: enhancement -assignees: '' - ---- - -**这个功能请求是否与某个问题相关？请描述** -清晰简要地描述问题是什么。例如：每次遇到 [...] 都让我感到很沮丧。 - -**描述你希望实现的解决方案** -清晰简要地描述你希望发生的事情。 - -**描述你考虑过的备选方案** -清晰简要地描述你考虑过的其他解决方案或功能。 - -**其他补充信息** -请在此添加关于功能请求的其他上下文或截图。 diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..0110ac7 --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,39 @@ + + +## 改动概述 + + + +## 为什么 + + + +## 做了什么 + + + +## 测试方式 + +- [ ] `pnpm typecheck && pnpm build`（前端 / 插件）通过 +- [ ] `python -m py_compile <文件>` 或本地 backend 启动验证（后端）通过 +- [ ] 手动验证步骤： + + +## 回归风险 + + + +## Checklist + +- [ ] 分支命名遵循 [CONTRIBUTING.md §3](../CONTRIBUTING.md#3-分支命名)（`feature/*` / `fix/*` / `release/*` / `hotfix/*`） +- [ ] base 分支正确（常规改动 → `develop`；线上紧急 → `master`；发版 → 见 §4.3） +- [ ] Commit message 遵循 `type(scope): subject` 格式（[CONTRIBUTING.md §5.1](../CONTRIBUTING.md#51-commit-message-格式)） +- [ ] 已自测核心流程 +- [ ] 已更新相关文档（`README.md` / `CHANGELOG.md` / `CLAUDE.md` / 模块 README，如适用） +- [ ] 未夹带 secrets / `.env` / 大型二进制 +- [ ] 单 PR 不跨多个工作区做无关改动 diff --git a/.github/workflows/commitlint.yml b/.github/workflows/commitlint.yml new file mode 100644 index 0000000..8ae2aa6 --- /dev/null +++ b/.github/workflows/commitlint.yml @@ -0,0 +1,32 @@ +name: Commit Lint + +on: + pull_request: + types: [opened, synchronize, reopened, edited] + push: + branches: + - develop + - master + +permissions: + contents: read + pull-requests: read + +jobs: + commitlint: + name: Lint commit messages + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Run commitlint + uses: wagoid/commitlint-github-action@v6 + with: + configFile: .commitlintrc.json + # PR 上检查 base..head 之间所有 commit；push 上只校验最新 commit + firstParent: false + failOnWarnings: false + helpURL: https://github.com/JefferyHcool/BiliNote/blob/develop/CONTRIBUTING.md#5-提交规范 diff --git a/.github/workflows/release-extension.yml b/.github/workflows/release-extension.yml new file mode 100644 index 0000000..2bab3bc --- /dev/null +++ b/.github/workflows/release-extension.yml @@ -0,0 +1,115 @@ +name: Release Extension + +# 在 v* tag push 时触发，构建插件并把产物挂到对应 GitHub Release。 +# 商店上传仍走人工（详见 RELEASING.md）；如果将来配齐了商店 API secrets， +# 把本文件末尾注释的 publish-* job 解开就是自动发布。 + +on: + push: + tags: + - 'v*' + +permissions: + contents: write + +jobs: + build: + name: Build & attach to release + runs-on: ubuntu-latest + defaults: + run: + working-directory: BillNote_extension + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Setup pnpm + uses: pnpm/action-setup@v3 + with: + version: 9 + + - name: Setup Node + uses: actions/setup-node@v4 + with: + node-version: 20 + cache: pnpm + cache-dependency-path: BillNote_extension/pnpm-lock.yaml + + - name: Install + run: pnpm install --frozen-lockfile + + - name: Build + run: pnpm build + + - name: Pack zip (Chrome / Edge upload format) + run: pnpm pack:zip + + - name: Pack xpi (Firefox Add-ons) + run: pnpm pack:xpi + + - name: Pack crx (self-host sideload) + # crx 需要稳定 key.pem 才能保持插件 ID 不变；CI 没有就跳过，不阻塞主流程。 + # 想生成稳定 crx：把 key 存到 secret EXTENSION_CRX_KEY，下面解开几行。 + run: | + # if [ -n "${{ secrets.EXTENSION_CRX_KEY }}" ]; then + # echo "${{ secrets.EXTENSION_CRX_KEY }}" > key.pem + # pnpm pack:crx + # else + pnpm pack:crx || true + # fi + continue-on-error: true + + - name: Rename artifacts with version suffix + run: | + VERSION="${GITHUB_REF#refs/tags/v}" + [ -f extension.zip ] && mv extension.zip "bilinote-extension-${VERSION}.zip" + [ -f extension.xpi ] && mv extension.xpi "bilinote-extension-${VERSION}.xpi" + [ -f extension.crx ] && mv extension.crx "bilinote-extension-${VERSION}.crx" + ls -la *.zip *.xpi *.crx 2>/dev/null || true + + - name: Attach to GitHub Release + uses: softprops/action-gh-release@v2 + with: + files: | + BillNote_extension/bilinote-extension-*.zip + BillNote_extension/bilinote-extension-*.xpi + BillNote_extension/bilinote-extension-*.crx + fail_on_unmatched_files: false + generate_release_notes: false + +# ---------- 商店自动发布（默认禁用，配齐 secrets 后可启用） ---------- +# +# publish-chrome: +# needs: build +# runs-on: ubuntu-latest +# steps: +# - uses: actions/download-artifact@v4 +# - uses: mnao305/chrome-extension-upload@v5 +# with: +# file-path: BillNote_extension/bilinote-extension-${{ github.ref_name }}.zip +# extension-id: ${{ secrets.CHROME_EXTENSION_ID }} +# client-id: ${{ secrets.CHROME_CLIENT_ID }} +# client-secret: ${{ secrets.CHROME_CLIENT_SECRET }} +# refresh-token: ${{ secrets.CHROME_REFRESH_TOKEN }} +# +# publish-edge: +# needs: build +# runs-on: ubuntu-latest +# steps: +# - uses: wdzeng/edge-addon@v2 +# with: +# product-id: ${{ secrets.EDGE_PRODUCT_ID }} +# zip-path: BillNote_extension/bilinote-extension-${{ github.ref_name }}.zip +# client-id: ${{ secrets.EDGE_CLIENT_ID }} +# api-key: ${{ secrets.EDGE_API_KEY }} +# +# publish-firefox: +# needs: build +# runs-on: ubuntu-latest +# steps: +# - uses: trmcnvn/firefox-addon@v3 +# with: +# uuid: ${{ secrets.FIREFOX_ADDON_UUID }} +# xpi: BillNote_extension/bilinote-extension-${{ github.ref_name }}.xpi +# api-key: ${{ secrets.FIREFOX_API_KEY }} +# api-secret: ${{ secrets.FIREFOX_API_SECRET }} diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d39afb7..5085696 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,6 +6,7 @@ > - [README.md](./README.md)：项目概览、快速开始 > - [CLAUDE.md](./CLAUDE.md)：仓库结构 + 各 workspace 开发命令 > - [CHANGELOG.md](./CHANGELOG.md)：版本变更记录 +> - [RELEASING.md](./RELEASING.md)：发版执行手册（Release Manager 视角） --- @@ -174,6 +175,9 @@ git checkout -b hotfix/-<事项> ### 5.1 Commit message 格式 +> CI 已接入 [commitlint](https://commitlint.js.org)（[`.commitlintrc.json`](./.commitlintrc.json) + [`.github/workflows/commitlint.yml`](./.github/workflows/commitlint.yml)）。 +> PR 上所有 commit 都会被校验，type 不在白名单时合并按钮会被卡。 + ``` type(scope): subject ``` diff --git a/RELEASING.md b/RELEASING.md new file mode 100644 index 0000000..8a46202 --- /dev/null +++ b/RELEASING.md @@ -0,0 +1,158 @@ +# 发版手册（Release Manager） + +本文档面向**发版执行者**，覆盖从 `develop` 切发版到产物上架商店的完整步骤。日常分支与提交规范见 [CONTRIBUTING.md](./CONTRIBUTING.md)。 + +--- + +## 流程总览 + +``` +develop ──→ release/X.Y.Z ──→ PR ─→ master ──→ 打 tag vX.Y.Z + │ │ │ + └──→ PR 回灌 ──→ develop └──→ CI 自动构建插件产物 + 挂到 GitHub Release + ↓ + 人工上传商店（Chrome/Edge/Firefox） +``` + +--- + +## 1. 切发布分支 + +```bash +git checkout develop && git pull origin develop +git checkout -b release/X.Y.Z +``` + +版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)：`MAJOR.MINOR.PATCH`。 + +## 2. 写 CHANGELOG，更新版本号 + +在 `release/X.Y.Z` 上： + +- 编辑 [`CHANGELOG.md`](./CHANGELOG.md)，新增 `## [X.Y.Z] - YYYY-MM-DD` 段，按 Keep a Changelog 分类（Added / Changed / Fixed / Removed / Security / Internal） +- 编辑 [`README.md`](./README.md) 顶部标题中的版本号 + 新增"vX.Y.Z 新增"摘要段 +- 重大变更也同步更新 [`CLAUDE.md`](./CLAUDE.md) + +```bash +git commit -am "docs: vX.Y.Z CHANGELOG + README 版本" +git push -u origin release/X.Y.Z +``` + +## 3. 合并到 master + 回灌 develop + +在 GitHub 上发起两个 PR： + +| PR | base | 合并方式 | +|---|---|---| +| `release/X.Y.Z` → `master` | `master` | **Merge commit (--no-ff)** | +| `release/X.Y.Z` → `develop` | `develop` | **Merge commit (--no-ff)** | + +`master` 分支保护要求 review 通过。回灌 `develop` 是为了把发版冻结期内的小修同步回来。 + +## 4. 打 tag + +```bash +git checkout master && git pull origin master +git tag -a vX.Y.Z -m "BiliNote vX.Y.Z + +主线： +- ... + +详见 CHANGELOG.md" +git push origin vX.Y.Z +``` + +push tag **会自动触发 [`.github/workflows/release-extension.yml`](.github/workflows/release-extension.yml)**：构建插件并把 `.zip` / `.xpi` / `.crx` 挂到对应 GitHub Release。 + +## 5. 创建 GitHub Release（如果还没有） + +CI 默认会创建 / 更新 `vX.Y.Z` 对应的 Release。如果你想自己写 release notes： + +1. 打开 https://github.com/JefferyHcool/BiliNote/releases/new +2. Tag: 选 `vX.Y.Z` +3. Title: `vX.Y.Z` +4. Body: 直接贴 [`CHANGELOG.md`](./CHANGELOG.md) 的对应段 +5. CI 跑完后 Release 页面会自动出现 `bilinote-extension-X.Y.Z.zip` / `.xpi` / `.crx` + +## 6. 上传到各商店（人工） + +商店审核普遍 1-3 个工作日。建议**先上 Chrome → Edge → Firefox**（Edge 接受同一份 zip）。 + +### Chrome Web Store + +1. https://chrome.google.com/webstore/devconsole +2. 选 BiliNote → 左侧 **Package** → **Upload new package** +3. 上传 `bilinote-extension-X.Y.Z.zip` +4. 检查 listing（描述 / 图标 / 截图无变化可保持），点 **Submit for review** + +### Microsoft Edge Add-ons + +1. https://partner.microsoft.com/dashboard/microsoftedge +2. 选 BiliNote → **New submission** +3. 上传同一份 `.zip`（Edge Add-ons 与 Chrome 完全兼容 MV3） +4. 提交审核 + +### Firefox Add-ons (AMO) + +1. https://addons.mozilla.org/developers/ +2. 选 BiliNote → **Upload New Version** +3. 上传 `bilinote-extension-X.Y.Z.xpi` +4. 选择"在 AMO 公开"或"自托管" +5. 提交审核 + +### 桌面端 (Tauri) + +仓库已有 GitHub Actions 在 `v*` tag 时构建桌面端安装包并自动挂到 GitHub Release，无需额外操作。 + +## 7. 清理 + +```bash +# release 分支已合到 master 与 develop，删掉 +git push origin --delete release/X.Y.Z +git branch -d release/X.Y.Z +``` + +--- + +## 自动发布到商店（可选） + +`.github/workflows/release-extension.yml` 末尾有三段商店自动发布的 job 注释。要启用： + +1. 在 https://github.com/JefferyHcool/BiliNote/settings/secrets/actions 加 secrets： + +| 商店 | 需要的 secret | +|---|---| +| Chrome | `CHROME_EXTENSION_ID`、`CHROME_CLIENT_ID`、`CHROME_CLIENT_SECRET`、`CHROME_REFRESH_TOKEN` | +| Edge | `EDGE_PRODUCT_ID`、`EDGE_CLIENT_ID`、`EDGE_API_KEY` | +| Firefox | `FIREFOX_ADDON_UUID`、`FIREFOX_API_KEY`、`FIREFOX_API_SECRET` | + +2. 解开 workflow 文件末尾的 `publish-chrome` / `publish-edge` / `publish-firefox` job 注释。 +3. 推 tag 时即自动发布。 + +> Chrome 各 secret 的获取方式：[chrome-webstore-upload-cli 文档](https://github.com/fregante/chrome-webstore-upload-cli/blob/main/How%20to%20generate%20Google%20API%20keys.md) +> Edge：[Edge Add-ons API](https://learn.microsoft.com/en-us/microsoft-edge/extensions-chromium/publish/api/using-addons-api) +> Firefox：https://addons.mozilla.org/en-US/developers/addon/api/key/ + +--- + +## 紧急 hotfix 发版 + +线上紧急问题不走 `release/*`，走 `hotfix/*`： + +```bash +git checkout master && git pull +git checkout -b hotfix/-<事项> +# … 修复 ... +# PR base=master 合入；同时 PR base=develop 回灌 +``` + +合入 master 后通常打 patch tag（如 `v2.1.1`），CI 流程同上。 + +--- + +## 历史发布快查 + +| Version | Date | Tag | +|---|---|---| +| 2.1.0 | 2026-05-07 | [`v2.1.0`](https://github.com/JefferyHcool/BiliNote/releases/tag/v2.1.0) | +| 2.0.0 | (上游 web 端 v2.0.0) | [`v2.0.0`](https://github.com/JefferyHcool/BiliNote/releases/tag/v2.0.0) |