chore: add GitHub release workflow (#47)

Author: hex2dec

.github/workflows/release.yml

@@ -0,0 +1,89 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-14
+            target: aarch64-apple-darwin
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-musl
+
+    env:
+      ASSET_BASENAME: gitee-${{ github.ref_name }}-${{ matrix.target }}
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Read Rust version
+        id: rust-version
+        run: echo "version=$(awk '/^rust / { print $2 }' .tool-versions)" >> "$GITHUB_OUTPUT"
+
+      - name: Install Rust toolchain
+        run: |
+          rustup toolchain install "${{ steps.rust-version.outputs.version }}" --profile minimal
+          rustup default "${{ steps.rust-version.outputs.version }}"
+          rustup target add "${{ matrix.target }}"
+
+      - name: Install musl tools
+        if: matrix.target == 'x86_64-unknown-linux-musl'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y musl-tools
+
+      - name: Build release binary
+        run: cargo build --locked --release --target "${{ matrix.target }}"
+
+      - name: Package release archive
+        run: |
+          mkdir -p "dist/${ASSET_BASENAME}"
+          cp "target/${{ matrix.target }}/release/gitee" "dist/${ASSET_BASENAME}/gitee"
+          cp LICENSE README.md README_CN.md "dist/${ASSET_BASENAME}/"
+          tar -C dist -czf "dist/${ASSET_BASENAME}.tar.gz" "${ASSET_BASENAME}"
+
+      - name: Upload release archive
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.target }}
+          path: dist/${{ env.ASSET_BASENAME }}.tar.gz
+          if-no-files-found: error
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Download release archives
+        uses: actions/download-artifact@v4
+        with:
+          path: release-assets
+          merge-multiple: true
+
+      - name: Generate checksums
+        run: |
+          cd release-assets
+          shasum -a 256 *.tar.gz > "gitee-${GITHUB_REF_NAME}-checksums.txt"
+
+      - name: Create or update draft GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          draft: true
+          generate_release_notes: true
+          overwrite_files: true
+          fail_on_unmatched_files: true
+          working_directory: release-assets
+          files: |
+            *.tar.gz
+            gitee-${{ github.ref_name }}-checksums.txt

CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+The changelog can be found on the releases page.

Cargo.toml

@@ -3,6 +3,13 @@ name = "gitee-cli"
 version = "0.1.0"
 edition = "2024"
 license = "MIT"
+description = "Agent-first CLI for gitee.com workflows"
+readme = "README.md"
+repository = "https://github.com/hex2dec/gitee-cli"
+homepage = "https://github.com/hex2dec/gitee-cli"
+rust-version = "1.94.0"
+keywords = ["gitee", "cli", "git", "automation"]
+categories = ["command-line-utilities"]
 
 [[bin]]
 name = "gitee"

README.md

@@ -53,9 +53,22 @@ Use `gitee-cli` if you want:
 - write operations that accept flags, files, or stdin instead of prompts
 - predictable behavior that can be scripted safely
 
-## Start Here
+## Install
 
-Today the project is built from source.
+Tagged GitHub releases publish prebuilt binaries for:
+
+- Apple Silicon macOS: `aarch64-apple-darwin`
+- Linux x86_64: `x86_64-unknown-linux-musl`
+
+Download the matching archive from the GitHub Releases page, extract it, and
+place `gitee` somewhere on your `PATH`.
+
+Each release also includes `gitee-<version>-checksums.txt`.
+
+## Build From Source
+
+If you need a development build or a platform outside the published release
+assets, build from source:
 
 Build the binary locally:
 

README_CN.md

@@ -53,9 +53,21 @@ gitee help --json
 - 写操作通过参数、文件或 stdin 提供内容，而不是依赖交互式提示
 - 行为稳定、便于脚本安全调用
 
-## 从这里开始
+## 安装
 
-当前项目通过源码构建。
+打了 tag 的 GitHub Release 会提供以下预构建二进制：
+
+- Apple Silicon macOS：`aarch64-apple-darwin`
+- Linux x86_64：`x86_64-unknown-linux-musl`
+
+从 GitHub Releases 页面下载对应平台的压缩包，解压后将 `gitee` 放到你的
+`PATH` 中即可。
+
+每个 release 还会额外提供 `gitee-<version>-checksums.txt`。
+
+## 从源码构建
+
+如果你需要开发版，或者目标平台不在当前发布资产范围内，可以从源码构建：
 
 本地构建二进制：