ci(release): 添加 macOS x86_64 构建和包管理器支持

- 在 macOS 构建作业中引入矩阵策略，同时构建 ARM64 和 x86_64 架构
- 更新发布说明，添加 Homebrew 和 cargo-binstall 安装说明
- 新增 Homebrew 公式自动更新工作流，在发布稳定版时同步
- 在 Cargo.toml 中添加 cargo-binstall 配置，支持多平台二进制分发
- 更新版本至 0.3.0-beta.3 并同步更新 CHANGELOG

Author: AptS-1547

.github/workflows/rust-release.yml

@@ -149,6 +149,13 @@ jobs:
   build-macos:
     needs: build-frontend
     runs-on: macos-latest
+    strategy:
+      matrix:
+        include:
+          - target: aarch64-apple-darwin
+            name: macos_aarch64
+          - target: x86_64-apple-darwin
+            name: macos_x86_64
     steps:
     - uses: actions/checkout@v4
 
@@ -159,25 +166,25 @@ jobs:
 
     - uses: dtolnay/rust-toolchain@stable
       with:
-        targets: aarch64-apple-darwin
+        targets: ${{ matrix.target }}
 
     - uses: Swatinem/rust-cache@v2
       with:
-        key: aarch64-apple-darwin
+        key: ${{ matrix.target }}
 
     - name: Build
       env:
         RUSTFLAGS: "-C link-arg=-s"
-      run: cargo build --release --target aarch64-apple-darwin --all-features
+      run: cargo build --release --target ${{ matrix.target }} --all-features
 
     - name: Rename binary
       run: |
         VERSION="${GITHUB_REF#refs/tags/}"
-        mv target/aarch64-apple-darwin/release/shortlinker "shortlinker_${VERSION}_macos_aarch64"
+        mv target/${{ matrix.target }}/release/shortlinker "shortlinker_${VERSION}_${{ matrix.name }}"
 
     - uses: actions/upload-artifact@v4
       with:
-        name: binary-macos_aarch64
+        name: binary-${{ matrix.name }}
         path: shortlinker_*
 
   release:
@@ -223,13 +230,26 @@ jobs:
 
           ---
 
-          ## Downloads
+          ## Installation
+
+          ### Homebrew (macOS/Linux)
+          ```bash
+          brew install AptS-1547/tap/shortlinker
+          ```
+
+          ### Cargo Binstall
+          ```bash
+          cargo binstall shortlinker
+          ```
+
+          ### Manual Download
 
           | Platform | Architecture | Download |
           |----------|--------------|----------|
           | Linux | x86_64 | [shortlinker_${{ github.ref_name }}_linux_x86_64](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/shortlinker_${{ github.ref_name }}_linux_x86_64) |
           | Linux | ARM64 | [shortlinker_${{ github.ref_name }}_linux_aarch64](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/shortlinker_${{ github.ref_name }}_linux_aarch64) |
           | Windows | x86_64 | [shortlinker_${{ github.ref_name }}_windows_x86_64.exe](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/shortlinker_${{ github.ref_name }}_windows_x86_64.exe) |
+          | macOS | x86_64 | [shortlinker_${{ github.ref_name }}_macos_x86_64](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/shortlinker_${{ github.ref_name }}_macos_x86_64) |
           | macOS | ARM64 | [shortlinker_${{ github.ref_name }}_macos_aarch64](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/shortlinker_${{ github.ref_name }}_macos_aarch64) |
           | Admin Panel | - | [shortlinker-admin-panel_${{ github.ref_name }}.tar.gz](https://github.com/${{ github.repository }}/releases/download/${{ github.ref_name }}/shortlinker-admin-panel_${{ github.ref_name }}.tar.gz) |
 
@@ -239,3 +259,119 @@ jobs:
         prerelease: ${{ contains(github.ref_name, 'alpha') || contains(github.ref_name, 'beta') || contains(github.ref_name, 'rc') }}
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  update-homebrew:
+    name: Update Homebrew Tap
+    needs: release
+    runs-on: ubuntu-latest
+    # 只在非预发布版本时更新 Homebrew
+    if: ${{ !contains(github.ref_name, 'alpha') && !contains(github.ref_name, 'beta') && !contains(github.ref_name, 'rc') }}
+    steps:
+    - name: Download release assets and calculate SHA256
+      id: sha256
+      run: |
+        VERSION="${GITHUB_REF#refs/tags/}"
+        BASE_URL="https://github.com/${{ github.repository }}/releases/download/${VERSION}"
+
+        curl -sL "${BASE_URL}/shortlinker_${VERSION}_macos_aarch64" -o macos-arm64
+        curl -sL "${BASE_URL}/shortlinker_${VERSION}_macos_x86_64" -o macos-amd64
+        curl -sL "${BASE_URL}/shortlinker_${VERSION}_linux_aarch64" -o linux-arm64
+        curl -sL "${BASE_URL}/shortlinker_${VERSION}_linux_x86_64" -o linux-amd64
+
+        echo "macos_arm64=$(sha256sum macos-arm64 | cut -d' ' -f1)" >> $GITHUB_OUTPUT
+        echo "macos_amd64=$(sha256sum macos-amd64 | cut -d' ' -f1)" >> $GITHUB_OUTPUT
+        echo "linux_arm64=$(sha256sum linux-arm64 | cut -d' ' -f1)" >> $GITHUB_OUTPUT
+        echo "linux_amd64=$(sha256sum linux-amd64 | cut -d' ' -f1)" >> $GITHUB_OUTPUT
+
+    - name: Update Homebrew Formula
+      uses: actions/github-script@v7
+      with:
+        github-token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        script: |
+          const version = '${{ github.ref_name }}'.replace(/^v/, '');
+          const tagVersion = '${{ github.ref_name }}';
+          const sha256 = {
+            macos_arm64: '${{ steps.sha256.outputs.macos_arm64 }}',
+            macos_amd64: '${{ steps.sha256.outputs.macos_amd64 }}',
+            linux_arm64: '${{ steps.sha256.outputs.linux_arm64 }}',
+            linux_amd64: '${{ steps.sha256.outputs.linux_amd64 }}'
+          };
+
+          const formula = `# typed: false
+          # frozen_string_literal: true
+
+          class Shortlinker < Formula
+            desc "A minimalist URL shortener service supporting HTTP 307 redirection"
+            homepage "https://github.com/AptS-1547/shortlinker"
+            version "${version}"
+            license "MIT"
+
+            on_macos do
+              on_arm do
+                url "https://github.com/AptS-1547/shortlinker/releases/download/${tagVersion}/shortlinker_${tagVersion}_macos_aarch64"
+                sha256 "${sha256.macos_arm64}"
+
+                def install
+                  bin.install "shortlinker_${tagVersion}_macos_aarch64" => "shortlinker"
+                end
+              end
+
+              on_intel do
+                url "https://github.com/AptS-1547/shortlinker/releases/download/${tagVersion}/shortlinker_${tagVersion}_macos_x86_64"
+                sha256 "${sha256.macos_amd64}"
+
+                def install
+                  bin.install "shortlinker_${tagVersion}_macos_x86_64" => "shortlinker"
+                end
+              end
+            end
+
+            on_linux do
+              on_arm do
+                url "https://github.com/AptS-1547/shortlinker/releases/download/${tagVersion}/shortlinker_${tagVersion}_linux_aarch64"
+                sha256 "${sha256.linux_arm64}"
+
+                def install
+                  bin.install "shortlinker_${tagVersion}_linux_aarch64" => "shortlinker"
+                end
+              end
+
+              on_intel do
+                url "https://github.com/AptS-1547/shortlinker/releases/download/${tagVersion}/shortlinker_${tagVersion}_linux_x86_64"
+                sha256 "${sha256.linux_amd64}"
+
+                def install
+                  bin.install "shortlinker_${tagVersion}_linux_x86_64" => "shortlinker"
+                end
+              end
+            end
+
+            test do
+              assert_match version.to_s, shell_output("#{bin}/shortlinker --version")
+            end
+          end
+          `.split('\n').map(line => line.replace(/^          /, '')).join('\n');
+
+          // Get current file (if exists) to get its SHA
+          let fileSha;
+          try {
+            const { data } = await github.rest.repos.getContent({
+              owner: 'AptS-1547',
+              repo: 'homebrew-tap',
+              path: 'Formula/shortlinker.rb'
+            });
+            fileSha = data.sha;
+          } catch (e) {
+            // File doesn't exist yet
+            fileSha = undefined;
+          }
+
+          // Create or update the formula file
+          await github.rest.repos.createOrUpdateFileContents({
+            owner: 'AptS-1547',
+            repo: 'homebrew-tap',
+            path: 'Formula/shortlinker.rb',
+            message: `chore: bump shortlinker to ${tagVersion}`,
+            content: Buffer.from(formula).toString('base64'),
+            sha: fileSha
+          });

CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v0.3.0-beta.3] - 2026-01-18
+
+### Added
+- **ClickManager 性能基准测试** - 新增 criterion 基准测试套件
+  - 包括单线程/多线程 increment、不同 key 场景和 drain 操作的性能测试
+  - 添加并发 increment 和 increment+drain 场景的单元测试，验证数据一致性
+- **cargo-binstall 支持** - 用户可通过 `cargo binstall shortlinker` 直接安装预编译二进制
+- **Homebrew 发布支持** - 用户可通过 `brew install AptS-1547/tap/shortlinker` 安装
+- **macOS x86_64 (Intel Mac) 构建** - Release 现已支持 Intel Mac 平台
+
+### Fixed
+- **ClickBuffer 数据竞争修复** - 重构 `drain` 方法，通过先快照 key 再逐个删除的方式避免数据竞争 (#40, #41)
+- **刷盘失败恢复机制** - 新增 `restore` 方法，刷盘失败时自动将数据写回缓冲区，避免数据丢失
+- **ClickBuffer 竞态条件修复** - 使用 `entry` API 重构 `increment` 方法，消除检查后插入（TOCTOU）的竞态条件
+- **点击计数下溢防护** - 将 `fetch_sub` 替换为 `fetch_update`，确保总点击数减法操作不会下溢
+
+### Docs
+- 更新健康检查 API 鉴权逻辑文档
+- 更新短链接路径格式约束说明
+- 更新配置项说明：CORS 默认禁用、Cookie 配置热更新说明
+- 更新存储配置文档：移除 `DATABASE_BACKEND` 说明，明确从 `DATABASE_URL` 自动推断
+- 更新部署要求：Rust 版本提升至 1.85+ (Edition 2024)
+- 同步更新英文文档
+
+### Dependencies
+- 添加 `criterion` 依赖用于基准测试
+- 升级 `colored` 至 3.1.1
+
 ## [v0.3.0-beta.2] - 2026-01-16
 
 ### Added
@@ -722,7 +750,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Update README.md
 - Initial commit
 
-[Unreleased]: https://github.com/AptS-1547/shortlinker/compare/v0.3.0-beta.2...HEAD
+[Unreleased]: https://github.com/AptS-1547/shortlinker/compare/v0.3.0-beta.3...HEAD
+[v0.3.0-beta.3]: https://github.com/AptS-1547/shortlinker/compare/v0.3.0-beta.2...v0.3.0-beta.3
 [v0.3.0-beta.2]: https://github.com/AptS-1547/shortlinker/compare/v0.3.0-beta.1...v0.3.0-beta.2
 [v0.3.0-beta.1]: https://github.com/AptS-1547/shortlinker/compare/v0.3.0-alpha.7...v0.3.0-beta.1
 [v0.3.0-alpha.7]: https://github.com/AptS-1547/shortlinker/compare/v0.3.0-alpha.6...v0.3.0-alpha.7

Cargo.lock

@@ -1,8 +1,9 @@
 [package]
 name = "shortlinker"
-version = "0.3.0-beta.2"
+version = "0.3.0-beta.3"
 description = "A minimalist URL shortener service supporting HTTP 307 redirection, built with Rust. Easy to deploy and lightning fast."
 authors = ["AptS-1547 <apts-1547@esaps.net>"]
+repository = "https://github.com/AptS-1547/shortlinker"
 edition = "2024"
 
 [features]
@@ -111,3 +112,30 @@ criterion = { version = "0.5", features = ["async_tokio"] }
 [[bench]]
 name = "click_manager"
 harness = false
+
+# cargo-binstall 配置
+[package.metadata.binstall]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_{ target }{ binary-ext }"
+bin-dir = "shortlinker_{ version }_{ target }{ binary-ext }"
+pkg-fmt = "bin"
+
+[package.metadata.binstall.overrides.x86_64-apple-darwin]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_macos_x86_64"
+
+[package.metadata.binstall.overrides.aarch64-apple-darwin]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_macos_aarch64"
+
+[package.metadata.binstall.overrides.x86_64-unknown-linux-gnu]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_linux_x86_64"
+
+[package.metadata.binstall.overrides.x86_64-unknown-linux-musl]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_linux_x86_64"
+
+[package.metadata.binstall.overrides.aarch64-unknown-linux-gnu]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_linux_aarch64"
+
+[package.metadata.binstall.overrides.x86_64-pc-windows-gnu]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_windows_x86_64.exe"
+
+[package.metadata.binstall.overrides.x86_64-pc-windows-msvc]
+pkg-url = "{ repo }/releases/download/{ version }/shortlinker_{ version }_windows_x86_64.exe"