一些系统优化

.env.example

@@ -18,6 +18,22 @@ CHATGPT2API_REGISTRATION_ENABLED=false
 # 检查更新访问 DockerHub / Release API 的代理；未设置时复用 CHATGPT2API_PROXY
 # CHATGPT2API_UPDATE_PROXY_URL=http://127.0.0.1:7890
 
+# ============================================
+# 服务器源码 Docker 构建资源控制（仅 sh deploy/docker-build-limited.sh 使用）
+# ============================================
+
+# 需要在服务器从源码构建镜像时，推荐用脚本创建受限 BuildKit builder 后再构建。
+# 直接运行脚本时会按服务器资源自动选择默认值，资源充足时默认使用 2 核和更高内存。
+# 如需手动覆盖，可取消下面注释。
+# BUILD_CPUS=2
+# BUILD_MEMORY=4g
+# BUILD_MEMORY_SWAP=4g
+# BUILDKIT_MAX_PARALLELISM=2
+# BUILD_GOMAXPROCS=2
+# BUILD_GOMEMLIMIT=2GiB
+# BUILD_NODE_OPTIONS=--max-old-space-size=1024
+# CHATGPT2API_LOCAL_IMAGE=chatgpt2api:local
+
 # 限流账号检查间隔，单位：分钟
 CHATGPT2API_REFRESH_ACCOUNT_INTERVAL_MINUTE=5
 
@@ -33,6 +49,9 @@ CHATGPT2API_USER_DEFAULT_RPM_LIMIT=0
 # 服务端缓存图片保留天数
 CHATGPT2API_IMAGE_RETENTION_DAYS=30
 
+# 图片库总容量上限，单位 MB；0 表示不按容量自动清理
+CHATGPT2API_IMAGE_STORAGE_LIMIT_MB=0
+
 # 业务日志保留天数；设置页的日志数据治理会按该值清理历史日志
 CHATGPT2API_LOG_RETENTION_DAYS=7
 
@@ -74,12 +93,12 @@ CHATGPT2API_AUTO_REMOVE_RATE_LIMITED_ACCOUNTS=false
 # 存储后端配置
 # ============================================
 
-# 存储后端类型（可选值: json, sqlite, postgres）
+# 存储后端类型（可选值: sqlite, postgres, mysql）
 # 默认: sqlite
 STORAGE_BACKEND=sqlite
 
 # ============================================
-# 数据库配置（当 STORAGE_BACKEND=sqlite/postgres 时使用）
+# 数据库配置
 # ============================================
 
 # PostgreSQL 示例

.github/workflows/ci.yml

@@ -4,11 +4,15 @@ on:
   push:
     branches:
       - main
+      - dev
   pull_request:
 
 permissions:
   contents: read
 
+env:
+  BUN_VERSION: 1.3.13
+
 jobs:
   test:
     runs-on: ubuntu-latest
@@ -17,7 +21,10 @@ jobs:
 
       - uses: oven-sh/setup-bun@v2
         with:
-          bun-version: latest
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Clear Bun cache
+        run: bun pm cache rm || true
 
       - name: Install dependencies
         working-directory: web
@@ -27,6 +34,13 @@ jobs:
         working-directory: web
         run: bun run build
 
+      - name: Upload frontend artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: web-dist
+          path: internal/web/dist/
+          retention-days: 1
+
       - uses: actions/setup-go@v6
         with:
           go-version-file: go.mod
@@ -35,5 +49,73 @@ jobs:
       - name: Verify Go version
         run: go version | grep -q 'go1.26.2'
 
+      - name: Configure git for Go modules
+        run: git config --global url."https://${{ secrets.GITHUB_TOKEN }}@github.com/".insteadOf "https://github.com/"
+
       - name: Test backend
         run: go test ./...
+
+      - name: Validate Docker deployment files
+        run: |
+          test -f deploy/Dockerfile
+          test -f deploy/Dockerfile.dev
+          test -f deploy/Dockerfile.release
+          test -f deploy/Dockerfile.dockerignore
+          test -f deploy/Dockerfile.dev.dockerignore
+          test -f deploy/docker-compose.yml
+          sh -n deploy/docker-build-limited.sh
+          test ! -e .dockerignore
+          test ! -e Dockerfile
+          test ! -e Dockerfile.goreleaser
+          test ! -e docker-compose.yml
+          test ! -e docker-compose.build.yml
+          test ! -e docker-compose.local.yml
+          test ! -e .goreleaser.simple.yaml
+          CHATGPT2API_ENV_FILE="$PWD/.env.example" \
+          CHATGPT2API_DATA_DIR="$PWD/data" \
+          docker compose -f deploy/docker-compose.yml config >/dev/null
+
+  build-docker-dev:
+    needs: [test]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Download frontend artifact
+        uses: actions/download-artifact@v8
+        with:
+          name: web-dist
+          path: internal/web/dist/
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Docker meta
+        id: meta
+        run: |
+          OWNER_LOWER=$(echo '${{ github.repository_owner }}' | tr '[:upper:]' '[:lower:]')
+          echo "tags=ghcr.io/${OWNER_LOWER}/${{ github.event.repository.name }}:dev" >> "$GITHUB_OUTPUT"
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: deploy/Dockerfile.dev
+          platforms: linux/amd64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          build-args: |
+            VERSION=dev
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/release.yml

@@ -10,19 +10,14 @@ on:
         description: "Tag to release, for example v1.0.0"
         required: true
         type: string
-      simple_release:
-        description: "Only publish linux/amd64 GHCR image"
-        required: false
-        type: boolean
-        default: false
 
 permissions:
   contents: write
   packages: write
 
 env:
-  SIMPLE_RELEASE: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.simple_release || 'false' }}
   DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
+  BUN_VERSION: 1.3.13
 
 jobs:
   build-frontend:
@@ -45,7 +40,10 @@ jobs:
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2
         with:
-          bun-version: latest
+          bun-version: ${{ env.BUN_VERSION }}
+
+      - name: Clear Bun cache
+        run: bun pm cache rm || true
 
       - name: Install dependencies
         working-directory: web
@@ -87,6 +85,9 @@ jobs:
       - name: Verify Go version
         run: go version | grep -q 'go1.26.2'
 
+      - name: Configure git for Go modules
+        run: git config --global url."https://${{ secrets.GITHUB_TOKEN }}@github.com/".insteadOf "https://github.com/"
+
       - name: Set up QEMU
         uses: docker/setup-qemu-action@v3
 
@@ -129,7 +130,7 @@ jobs:
         uses: goreleaser/goreleaser-action@v7
         with:
           version: "~> v2"
-          args: release --clean --skip=validate ${{ env.SIMPLE_RELEASE == 'true' && '--config=.goreleaser.simple.yaml' || '' }}
+          args: release --clean --skip=validate
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           TAG_MESSAGE: ${{ steps.meta.outputs.body }}

.gitignore

@@ -4,9 +4,14 @@ dist/
 web_dist
 chatgpt2api.exe
 .omx/
+.codex/
 venv/
 .venv/
 __pycache__/
+docs/*
+!docs/image-generation-api.md
+!docs/user-quota-allocation-requirements.md
+!jshook/docs/
 
 .idea
 node_modules/