update rule

Author: ganisback

.cursor/rules/manual-local-release.mdc

@@ -0,0 +1,17 @@
+---
+description: Publish releases from local builds instead of GitHub Actions
+alwaysApply: true
+---
+
+# Manual Local Release
+
+- Do not rely on GitHub Actions tag workflows to publish releases for this repository.
+- Preferred release flow: push code and tag first, build release archives locally, then upload artifacts directly.
+- Build release packages from the target tag in a clean checkout or temporary worktree with `make package`.
+- Always build the web UI before packaging so release binaries embed `internal/server/static` instead of falling back to a missing local `web/dist`.
+- Publish GitHub releases manually with `gh release create` or `gh release upload` after local packaging.
+- Publish GitLab release assets manually or via `scripts/push.sh` with `--skip-build` after local packaging is complete.
+- Keep release notes concise: use 1-3 bullets that describe the actual user-visible fixes or changes in this version.
+- Follow repository network rules during release work:
+  - GitLab and other internal services: direct connection, no proxy
+  - GitHub and other external services: `source ~/.myshrc` before upload commands

Makefile

@@ -15,19 +15,20 @@ build: build-web
 
 build-all: build-darwin-arm64 build-darwin-amd64 build-linux-amd64 build-linux-arm64 build-windows-amd64
 
-build-darwin-arm64:
+# Cross-platform binaries must embed the built web UI too.
+build-darwin-arm64: build-web
 	GOOS=darwin GOARCH=arm64 go build $(LDFLAGS) -o bin/$(BINARY_NAME)-$(VERSION)-darwin-arm64 ./cmd/csghub-lite
 
-build-darwin-amd64:
+build-darwin-amd64: build-web
 	GOOS=darwin GOARCH=amd64 go build $(LDFLAGS) -o bin/$(BINARY_NAME)-$(VERSION)-darwin-amd64 ./cmd/csghub-lite
 
-build-linux-amd64:
+build-linux-amd64: build-web
 	GOOS=linux GOARCH=amd64 go build $(LDFLAGS) -o bin/$(BINARY_NAME)-$(VERSION)-linux-amd64 ./cmd/csghub-lite
 
-build-linux-arm64:
+build-linux-arm64: build-web
 	GOOS=linux GOARCH=arm64 go build $(LDFLAGS) -o bin/$(BINARY_NAME)-$(VERSION)-linux-arm64 ./cmd/csghub-lite
 
-build-windows-amd64:
+build-windows-amd64: build-web
 	GOOS=windows GOARCH=amd64 go build $(LDFLAGS) -o bin/$(BINARY_NAME)-$(VERSION)-windows-amd64.exe ./cmd/csghub-lite
 
 clean-dist:
@@ -68,7 +69,7 @@ test-cover:
 lint:
 	golangci-lint run ./...
 
-release-snapshot:
+release-snapshot: build-web
 	goreleaser release --snapshot --clean
 
 clean:

docs/guides/packaging.md

@@ -35,6 +35,8 @@ csghub-lite-linux-arm64       # Linux ARM64
 csghub-lite-windows-amd64.exe # Windows
 ```
 
+`make build`、`make build-all` 与 `make package` 都会先构建 `web` 并同步到 `internal/server/static`，确保发布二进制内嵌 Web UI。
+
 ### 版本号
 
 版本号通过 `git tag` 管理，自动嵌入二进制文件：
@@ -123,7 +125,7 @@ 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`，然后 `scripts/push.sh --skip-github --skip-build --tag vX.Y.Z`（会包含向 GitLab 推送 tag，除非加 `--skip-gitlab-git`）。
+本地从零构建再上传时，检出对应 tag 后执行 `make package`，确认产物已内嵌最新 Web UI，然后执行 `scripts/push.sh --skip-github --skip-build --tag vX.Y.Z`（会包含向 GitLab 推送 tag，除非加 `--skip-gitlab-git`）。
 
 ### 本地测试发布