自动更新依赖并发布版本

2026-08-11 14:14:44 +08:00
parent 4230e10751
commit b4c7ad7f65
3 changed files with 142 additions and 5 deletions
@@ -2,3 +2,23 @@

 * pb协议文件生成命令
 `protoc --proto_path=pkg/websocket/codec/protobuf/protocol --go_out=pkg/websocket/codec/protobuf/protocol --go_opt=paths=source_relative base.proto`
+
+## 自动更新依赖并发布版本
+
+仓库包含 `.gitea/workflows/dependency-release.yml`。启用 Gitea Actions 后，它会在每周日 03:17 UTC（北京时间 11:17）运行，也可以在 Actions 页面手动运行：
+
+1. 使用 `go get -u ./...` 和 `go mod tidy` 更新依赖。
+2. 执行 `go test ./...`，测试失败时不会提交或发布。
+3. 有依赖变更时提交 `go.mod`、`go.sum`，创建下一个 `vMAJOR.MINOR.PATCH` 补丁版本标签，并创建 Gitea Release。
+
+### 树莓派上的 Runner 配置
+
+在树莓派上安装并注册 Gitea `act_runner`，注册标签中包含 `self-hosted`，并确保 Runner 环境有 Git、Go、Node.js、`curl`。工作流使用 `runs-on: self-hosted`，因此不会依赖 GitHub-hosted Runner。
+
+在仓库的 **Settings -> Secrets -> Actions** 中新增：
+
+- `GITEA_TOKEN`：一个能读写仓库内容、创建标签和 Release 的 Gitea Personal Access Token。
+
+如果默认分支启用了保护规则，还需要允许该 Token 所属账号直接推送。
+
+首次使用时建议先在仓库中手动创建一个 `v0.1.0` 以后的 SemVer 标签；如果没有任何 `vMAJOR.MINOR.PATCH` 标签，工作流会从 `v0.1.0` 开始。