fix(release): simplify macOS Homebrew publishing

Keep the hub.opencsg.com installer as the primary path, make Homebrew a macOS-focused extra entrypoint from the main repo, and include release checksums in the local packaging flow. Also correct the swapped AI Apps English and Chinese labels.

Made-with: Cursor

Author: ganisback

.github/workflows/ci.yml

@@ -128,18 +128,15 @@ jobs:
         with:
           go-version: "1.22"
 
-      # Without HOMEBREW_TAP_TOKEN, publishing the tap fails with 401 and marks the job failed
-      # even though the GitHub release assets already uploaded.
       - uses: goreleaser/goreleaser-action@v6
         with:
           version: latest
-          args: release --clean${{ secrets.HOMEBREW_TAP_TOKEN == '' && ' --skip=homebrew' || '' }}
+          args: release --clean
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
 
-      # GitLab releases are not created by GoReleaser. Mirror the five platform archives
-      # to GitLab generic packages + release links (same layout as scripts/push.sh).
+      # GitLab releases are not created by GoReleaser. Mirror the packaged release
+      # assets to GitLab generic packages + release links (same layout as scripts/push.sh).
       - name: Upload release assets to GitLab
         if: ${{ secrets.GITLAB_TOKEN != '' }}
         env:

.goreleaser.yml

@@ -38,24 +38,6 @@ archives:
       - README.md
       - LICENSE*
 
-brews:
-  - name: csghub-lite
-    repository:
-      owner: opencsgs
-      name: homebrew-tap
-      token: "{{ .Env.HOMEBREW_TAP_TOKEN }}"
-    directory: Formula
-    homepage: "https://github.com/opencsgs/csghub-lite"
-    description: "Lightweight tool for running LLMs locally with CSGHub platform"
-    license: "Apache-2.0"
-    dependencies:
-      - name: llama.cpp
-        type: recommended
-    test: |
-      system "#{bin}/csghub-lite", "--version"
-    install: |
-      bin.install "csghub-lite"
-
 nfpms:
   - id: packages
     package_name: csghub-lite

Formula/csghub-lite.rb

@@ -1,25 +1,30 @@
 class CsghubLite < Formula
   desc "Lightweight tool for running LLMs locally with CSGHub platform"
   homepage "https://github.com/opencsgs/csghub-lite"
-  version "0.1.0"
+  version "0.6.3"
   license "Apache-2.0"
 
   on_macos do
     on_arm do
-      url "https://github.com/opencsgs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_darwin_arm64.tar.gz"
-      # sha256 will be filled in by goreleaser or manually after release
+      url "https://github.com/OpenCSGs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_darwin-arm64.tar.gz"
+      sha256 "9d4534750197f88972672c32db9acab0361571f2fa507d0281f729a17d9bc667"
     end
+
     on_intel do
-      url "https://github.com/opencsgs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_darwin_amd64.tar.gz"
+      url "https://github.com/OpenCSGs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_darwin-amd64.tar.gz"
+      sha256 "488e4447c5005e6f2f5cd6f38f4510e6e2b7d6cdc1ec2a58c1964f55c04ee489"
     end
   end
 
   on_linux do
     on_arm do
-      url "https://github.com/opencsgs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_linux_arm64.tar.gz"
+      url "https://github.com/OpenCSGs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_linux-arm64.tar.gz"
+      sha256 "c085909632c83c0286961b87828e1332683f29ef11b5c742891bd3d9ae1934f9"
     end
+
     on_intel do
-      url "https://github.com/opencsgs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_linux_amd64.tar.gz"
+      url "https://github.com/OpenCSGs/csghub-lite/releases/download/v#{version}/csghub-lite_#{version}_linux-amd64.tar.gz"
+      sha256 "af094fdf3df3724da762294a7781e48dbc455bf3bf4e84ed2e83538778b7b67a"
     end
   end
 

Makefile

@@ -51,6 +51,8 @@ package: clean-dist build-all
 	cd $${TMPDIR} && zip -q -r $(CURDIR)/dist/$(BINARY_NAME)_$(VERSION)_windows-amd64.zip *; \
 	rm -rf $${TMPDIR}; \
 	echo "Created dist/$(BINARY_NAME)_$(VERSION)_windows-amd64.zip"
+	@./scripts/write-checksums.sh dist
+	@echo "Created dist/checksums.txt"
 
 release:
 	@scripts/push.sh

README.md

@@ -24,6 +24,16 @@ Inspired by [Ollama](https://ollama.com), csghub-lite provides model download, l
 curl -fsSL https://hub.opencsg.com/csghub-lite/install.sh | sh
 ```
 
+### Optional: Homebrew (mainly macOS)
+
+```bash
+brew tap opencsgs/csghub-lite https://github.com/OpenCSGs/csghub-lite
+brew install opencsgs/csghub-lite/csghub-lite
+```
+
+Homebrew is provided as an extra install path mainly for macOS users. On Linux,
+prefer `curl ... | sh`, release tarballs, or native packages.
+
 ### Quick install (Windows PowerShell)
 
 ```powershell

docs/README.md

@@ -6,7 +6,7 @@ csghub-lite 是一个轻量级的本地大语言模型运行工具，基于 [CSG
 
 ### 快速上手
 
-- [安装指南](getting-started/installation.md) — 多种安装方式：一键脚本、Homebrew、源码编译
+- [安装指南](getting-started/installation.md) — 多种安装方式：一键脚本、Homebrew（主要面向 macOS）、源码编译
 - [快速入门](getting-started/quickstart.md) — 5 分钟上手：搜索、下载、对话、启动 API
 
 ### CLI 命令参考
@@ -36,5 +36,5 @@ csghub-lite 是一个轻量级的本地大语言模型运行工具，基于 [CSG
 
 - [配置说明](guides/configuration.md) — 配置文件、私有化部署、环境变量
 - [模型格式](guides/model-formats.md) — GGUF / SafeTensors 格式说明与转换
-- [打包与发布](guides/packaging.md) — GoReleaser、Homebrew、安装脚本
+- [打包与发布](guides/packaging.md) — GoReleaser、Homebrew（主要面向 macOS）、安装脚本
 - [架构设计](guides/architecture.md) — 项目结构与模块设计

docs/getting-started/installation.md

@@ -13,13 +13,13 @@
 适用于 Linux 和 macOS，自动检测系统架构，从 GitHub Releases 下载安装。
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/opencsgs/csghub-lite/main/scripts/install.sh | sh
+curl -fsSL https://hub.opencsg.com/csghub-lite/install.sh | sh
 ```
 
 指定版本安装：
 
 ```bash
-CSGHUB_LITE_VERSION=v0.1.0 curl -fsSL https://raw.githubusercontent.com/opencsgs/csghub-lite/main/scripts/install.sh | sh
+CSGHUB_LITE_VERSION=v0.1.0 curl -fsSL https://hub.opencsg.com/csghub-lite/install.sh | sh
 ```
 
 安装脚本环境变量（可选）：
@@ -31,13 +31,13 @@ CSGHUB_LITE_VERSION=v0.1.0 curl -fsSL https://raw.githubusercontent.com/opencsgs
 
 说明：若远程 llama.cpp 与本地 **build 号一致**，脚本会跳过重新下载；此前若因缺少 `libmtmd.so.0` 等导致 `llama-server --version` 失败，会被误判为需要升级——新版本已用 `LD_LIBRARY_PATH` 检测版本，并从压缩包 **递归** 安装所有 `.so`。
 
-### 方式二：Homebrew
+### 方式二：Homebrew（主要面向 macOS）
 
-适用于 macOS 和 Linux。
+可选额外入口，主安装入口仍然推荐使用上面的 `curl ... | sh`。Linux 仍建议优先使用安装脚本、release 压缩包或系统包管理器。
 
 ```bash
-brew tap opencsgs/tap
-brew install csghub-lite
+brew tap opencsgs/csghub-lite https://github.com/OpenCSGs/csghub-lite
+brew install opencsgs/csghub-lite/csghub-lite
 ```
 
 ### 方式三：GitHub Releases 手动下载

docs/guides/packaging.md

@@ -1,22 +1,20 @@
 # 打包与发布
 
-csghub-lite 使用 [GoReleaser](https://goreleaser.com) 进行跨平台构建和发布。
+csghub-lite 当前以本地 `make package` + `scripts/push.sh` 手动发布为主。GoReleaser 仍然保留用于定义归档格式、生成 GitHub Release 产物，以及执行本地 snapshot 验证，但不再负责 Homebrew tap 发布。
 
 ## 支持的分发形式
 
 | 分发方式 | 平台 | 文件/命令 |
 |---------|------|-----------|
-| 一键安装脚本 | Linux / macOS | `curl -fsSL .../install.sh \| sh` |
-| Homebrew | macOS / Linux | `brew install csghub-lite` |
+| 一键安装脚本 | Linux / macOS | `curl -fsSL https://hub.opencsg.com/csghub-lite/install.sh \| sh` |
+| Homebrew | macOS | `brew tap opencsgs/csghub-lite https://github.com/OpenCSGs/csghub-lite && brew install opencsgs/csghub-lite/csghub-lite` |
 | tar.gz | macOS / Linux | GitHub Releases |
 | zip | Windows | GitHub Releases |
 | deb | Debian / Ubuntu | GitHub Releases |
 | rpm | RHEL / CentOS / Fedora | GitHub Releases |
 | 源码编译 | 全平台 | `make build` |
 
-## 构建
-
-### 本地构建
+## 本地构建
 
 ```bash
 # 构建当前平台
@@ -25,133 +23,93 @@ make build
 # 构建全平台
 make build-all
 
-# 二进制文件输出到 bin/ 目录
-ls bin/
-csghub-lite                   # 当前平台
-csghub-lite-darwin-arm64      # macOS Apple Silicon
-csghub-lite-darwin-amd64      # macOS Intel
-csghub-lite-linux-amd64       # Linux x86_64
-csghub-lite-linux-arm64       # Linux ARM64
-csghub-lite-windows-amd64.exe # Windows
+# 打包发布产物
+make package
 ```
 
-`make build`、`make build-all` 与 `make package` 都会先构建 `web` 并同步到 `internal/server/static`，确保发布二进制内嵌 Web UI。
+`make build`、`make build-all` 与 `make package` 都会先构建 `web` 并同步到 `internal/server/static`，确保发布二进制内嵌 Web UI。`make package` 还会额外生成 `dist/checksums.txt`，供 Homebrew formula 和发布校验复用。
 
-### 版本号
+## 版本号
 
-版本号通过 `git tag` 管理，自动嵌入二进制文件：
+版本号通过 `git tag` 管理，并在构建时注入二进制：
 
 ```bash
 git tag v0.1.0
 git push origin v0.1.0
 ```
 
-本地开发时版本号为 `dev`。
-
-## GoReleaser 配置
-
-配置文件: `.goreleaser.yml`
-
-### 核心设置
-
-```yaml
-builds:
-  - id: csghub-lite
-    main: ./cmd/csghub-lite
-    env:
-      - CGO_ENABLED=0    # 纯 Go 编译，无 CGO 依赖
-    goos: [linux, darwin, windows]
-    goarch: [amd64, arm64]
-    ldflags:
-      - -s -w -X main.version={{.Version}}
-```
-
-### 包格式
-
-- **tar.gz**: Linux / macOS 默认
-- **zip**: Windows 默认
-- **deb / rpm**: 通过 NFPM 生成
-
-### Homebrew Tap
-
-GoReleaser 自动将 Homebrew formula 推送到 `opencsgs/homebrew-tap` 仓库。需要配置 `HOMEBREW_TAP_TOKEN` secret。
-
-## CI/CD
-
-通过 GitHub Actions 自动化，配置文件: `.github/workflows/ci.yml`
-
-### 触发条件
-
-- **Push / PR 到 main**: 运行测试
-- **Push tag `v*`**: 运行测试 + GoReleaser 发布
+未打 tag 的本地开发构建默认显示为 `dev`。
 
-### 发布流程
+## 推荐发布流程
 
 ```bash
 # 1. 确保测试通过
 make test
 
-# 2. 创建版本标签
+# 2. 创建发布 tag
 git tag v0.1.0
 
-# 3. 推送标签（触发 CI 自动发布）
-git push origin v0.1.0
-```
+# 3. 本地打包（会构建 web 并生成 dist/checksums.txt）
+make package
 
-CI 自动执行：
+# 4. 更新仓库内 Homebrew formula
+./scripts/update-homebrew-formula.sh --tag v0.1.0
 
-1. 运行所有测试
-2. GoReleaser 交叉编译所有平台
-3. 上传到 GitHub Releases
-4. 更新 Homebrew tap
-5. 生成 deb / rpm 包
+# 5. 上传 GitHub / GitLab release 资产
+./scripts/push.sh --skip-build --tag v0.1.0
+```
 
-### GitLab 同步（CSGHub / 国内安装源）
+说明：
 
-推送 `v*` 标签只会触发 **GitHub** 上的 GoReleaser 发布；**GitLab** 上的 Release 与 Generic Package 需要单独上传，否则 `install.sh` 在国内（CN）从 GitLab 拉取时会缺包。
+- `scripts/push.sh` 会将本地 `dist/` 下的发布包上传到 GitHub Release 和 GitLab Generic Package/Release。
+- GitLab 上传会自动从 `local/secrets.env` 读取 `GITLAB_TOKEN`（如果环境变量未设置）。
+- 如果你希望仓库中的 `Formula/csghub-lite.rb` 始终指向“最新正式版”，请在发布完成后提交该文件的更新。
 
-**推荐（自动化）**：在 GitHub 仓库 **Settings → Secrets and variables → Actions** 中新增 `GITLAB_TOKEN`（GitLab 个人访问令牌，`api` 权限）。发布工作流在 GoReleaser 成功后会调用 `scripts/push.sh`，将五个平台压缩包同步到 `git-devops.opencsg.com` 上与本项目 `scripts/push.sh` 一致的 Generic Package 路径。未配置该 secret 时此步骤跳过，行为与以前一致。
+## GitLab 补发
 
-**手动补发某个版本**（例如已发 GitHub 但未发 GitLab）：
+如果某个版本已经发到了 GitHub，但 GitLab 资产缺失，可以先把 release 文件拉回本地再补发：
 
 ```bash
-# 从 GitHub Release 拉取 GoReleaser 产物到 dist/
 gh release download v0.5.10 --repo OpenCSGs/csghub-lite -D dist/
-
-# 文件名改为与 install.sh / push.sh 一致（OS-ARCH 用连字符）
 ./scripts/rename-dist-for-gitlab.sh 0.5.10
-
-export GITLAB_TOKEN="glpat-..."   # 或写入 local/secrets.env 后由 push.sh 自动加载
 ./scripts/push.sh --skip-github --skip-build --skip-gitlab-git --tag v0.5.10
 ```
 
-本地从零构建再上传时，检出对应 tag 后执行 `make package`，确认产物已内嵌最新 Web UI，然后执行 `scripts/push.sh --skip-github --skip-build --tag vX.Y.Z`（会包含向 GitLab 推送 tag，除非加 `--skip-gitlab-git`）。
+## 安装脚本
 
-### 本地测试发布
+主安装入口保持不变：
 
 ```bash
-# GoReleaser 本地快照（不实际发布）
-make release-snapshot
+curl -fsSL https://hub.opencsg.com/csghub-lite/install.sh | sh
+```
 
-# 输出到 dist/ 目录
-ls dist/
+`scripts/install.sh` 会自动检测 OS 和 CPU 架构，优先从 GitHub/GitLab release 资产下载最新版本，并在需要时安装或升级 `llama-server`。
+
+指定版本安装：
+
+```bash
+CSGHUB_LITE_VERSION=v0.1.0 curl -fsSL https://hub.opencsg.com/csghub-lite/install.sh | sh
 ```
 
-## 安装脚本
+## Homebrew Formula
+
+Homebrew 现在是 repo 内维护的额外入口，主要面向 macOS。主仓库本身充当自定义 tap，不依赖独立的 `homebrew-tap` 仓库，也不需要向 Homebrew 上传二进制文件。
 
-`scripts/install.sh` 提供一键安装：
+Linux 的正式安装文档仍以 `install.sh`、release 压缩包和 `deb/rpm` 为主。
 
-- 自动检测 OS 和 CPU 架构
-- 从 GitHub Releases 下载最新版本
-- 解压并安装到 `/usr/local/bin`
-- 检查 `llama-server` 是否可用
+- Formula 文件位于 `Formula/csghub-lite.rb`
+- 更新脚本位于 `scripts/update-homebrew-formula.sh`
+- 该脚本读取 `dist/checksums.txt`，将当前 release 的 URL 和 SHA256 写回 formula
 
-支持指定版本：
+用户先把主仓库 tap 进 Homebrew，再安装对应 formula：
 
 ```bash
-CSGHUB_LITE_VERSION=v0.1.0 curl -fsSL .../install.sh | sh
+brew tap opencsgs/csghub-lite https://github.com/OpenCSGs/csghub-lite
+brew install opencsgs/csghub-lite/csghub-lite
 ```
 
-## Homebrew Formula
+## GoReleaser 与 CI
 
-独立的 Homebrew formula 位于 `Formula/csghub-lite.rb`，主要用于本地测试。正式发布由 GoReleaser 自动推送到 `opencsgs/homebrew-tap`。
+- `.goreleaser.yml` 继续定义 archive、checksum、nfpm 和 GitHub release 相关配置
+- `make release-snapshot` 可在本地验证 GoReleaser 输出
+- GitHub Actions 仍会在 tag 上构建 release 产物，但仓库约定的正式发布方式仍然是本地打包后手动上传

scripts/install.sh

@@ -1,6 +1,6 @@
 #!/bin/sh
 # csghub-lite install script
-# Usage: curl -fsSL https://raw.githubusercontent.com/opencsgs/csghub-lite/main/scripts/install.sh | sh
+# Usage: curl -fsSL https://hub.opencsg.com/csghub-lite/install.sh | sh
 set -eu
 
 REPO="${REPO:-OpenCSGs/csghub-lite}"

scripts/push.sh

@@ -90,6 +90,9 @@ done
 f="dist/${BINARY_NAME}_${VERSION}_windows-amd64.zip"
 [ -f "$f" ] || die "Asset not found: $f"
 ASSETS="$ASSETS $f"
+f="dist/checksums.txt"
+[ -f "$f" ] || die "Asset not found: $f"
+ASSETS="$ASSETS $f"
 
 info "Assets:${ASSETS}"