26.9：版本号统一 + CI 精简 + 前端产物重建

- 全项目版本号统一：v3.x 迭代号（26.9/26.9/26.9/26.9 及裸 v2/v3）→ 26.9，
  覆盖 Go 注释 / 文档 / openapi.yaml / README×4 / 前端源码（80+ 处）
- v31_test.go 更名 custom_code_test.go；TestV2AccessorDefaults → TestKVAccessorDefaults
- docs/api/00-overview.md 更新日志合并为单条 26.9 条目（修复错位拼接）
- .goreleaser.yaml 头部注释与实际一致（Pro 2.18.1 / GITEA_TOKEN / semver tag 要求）
- CI：release-image.yml → ci.yml，仅保留 vet+test 门禁；
  镜像发布移交 GoReleaser Pro（原 build-push 的 tag 校验与 26.9 版本方案冲突，历史 9 次失败）
- 前端重建：server/web/dist 与 web-embed 同步（docs 文案嵌入更新）

.goreleaser.yaml

@@ -1,13 +1,22 @@
-# 文件快传 GoReleaser 配置（OSS v2.14.1+）
+# 文件快传 GoReleaser 配置（Pro 2.18.1，二进制在 ~/Code/Releaser/goreleaser）
 #
 # 用法：
-#   goreleaser release --snapshot --clean    # 本地试跑，产出 ./dist
-#   goreleaser release --clean               # 正式发布（需 git tag + 远端可写）
+#   goreleaser release --snapshot --clean --skip=publish   # 本地试跑，产出 ./dist
+#   goreleaser release --clean                             # 正式发布（需 semver tag）
 #
-# 注入凭据的环境变量（不入库）：
-#   GORELEASER_GITEA_TOKEN    Gitea Personal Access Token（uploads + release）
-#   GORELEASER_ACR_USER       ACR 用户名
-#   GORELEASER_ACR_PASS       ACR 密码
+# tag 必须是语义化版本（goreleaser 强制），如 v26.9.0（→ 版本 26.9.0），
+# 并与 server/cmd/server/main.go 的 APP_VERSION 保持一致。
+#
+# 发布所需环境变量（不入库）：
+#   GITEA_TOKEN                 Gitea Personal Access Token（release + 资产上传）
+#   BUILDX_CONFIG=/tmp/buildx-config   可选：buildx 状态目录重定向（受限环境）
+#   DOCKER_CONFIG=/tmp/docker-config   可选：docker 配置重定向（manifest 需写 ~/.docker 时）
+#   ACR 登录：docker login registry.cn-hangzhou.aliyuncs.com（镜像推送用本机 docker 凭证）
+#
+# 产物：
+#   - 归档：linux/darwin/windows × amd64/arm64（tar.gz + zip）→ Gitea Release
+#   - 镜像：registry.cn-hangzhou.aliyuncs.com/skymirror/fileshare:{版本}-amd64/-arm64
+#           + 多架构 manifest {版本} 与 latest → 阿里云 ACR
 
 version: 2
 
@@ -156,7 +165,7 @@ docker_manifests:
       - 'registry.cn-hangzhou.aliyuncs.com/skymirror/fileshare:{{ .Version }}-amd64'
       - 'registry.cn-hangzhou.aliyuncs.com/skymirror/fileshare:{{ .Version }}-arm64'
 
-# Gitea 服务器（v2.14 OSS：gitea_urls 在顶层为对象；token 走 GORELEASER_TOKEN env）
+# Gitea 服务器（token 走 GITEA_TOKEN env）
 gitea_urls:
   api: https://git.skymirror.top/api/v1