feat(frontend): support external downloads

feat: add SproutWorkCollect apps
重构后端技术栈和一些小修改
2026-03-13 17:19:01 +08:00 · 2026-03-13 17:14:37 +08:00 · 2026-03-13 17:06:09 +08:00
65 changed files with 2519 additions and 624 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,47 @@
+# Dependencies / build outputs
+node_modules/
+vendor/
+dist/
+build/
+works/

+# Env / secrets (do not commit real credentials)
+.env
+.env.*
+!.env.example
+!.env.sample
+*.pem
+*.key
+*.p12
+*.pfx
+*.crt
+*.cer
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyd
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+
+# Logs
+*.log
+debug-logs/
+
+# OS / editor
+.DS_Store
+Thumbs.db
+
+# Local runtime data
+data/
+
+# Project-specific (legacy paths)
 SmyWorkCollect-Frontend/build/
 SmyWorkCollect-Frontend/node_modules/
 SmyWorkCollect-Backend/__pycache__/
-SmyWorkCollect-Backend/works/
+SmyWorkCollect-Backend/works/
+
+# Project-specific (SproutWorkCollect)
+SproutWorkCollect-Backend-Python/config/settings.json
--- a/49
+++ b/49
@@ -1,49 +0,0 @@
-# ====== Frontend build stage ======
-FROM node:18-alpine AS fe-builder
-WORKDIR /fe
-COPY SmyWorkCollect-Frontend/package*.json ./
-# 使用 npm install 以避免对锁文件严格校验导致构建失败
-RUN npm install
-COPY SmyWorkCollect-Frontend/ .
-# 确保不带 REACT_APP_API_URL，生产默认使用相对路径 /api
-RUN npm run build
-
-# ====== Final runtime (Python + Nginx + Supervisor) ======
-FROM python:3.11-slim
-
-ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1
-
-# 安装系统依赖: nginx, supervisor, curl
-RUN apt-get update \
-    && apt-get install -y --no-install-recommends nginx supervisor curl \
-    && rm -rf /var/lib/apt/lists/*
-
-# 创建目录结构
-WORKDIR /app
-RUN mkdir -p /app/backend \
-    /app/SmyWorkCollect-Frontend/build \
-    /app/SmyWorkCollect-Frontend/config \
-    /run/nginx \
-    /var/log/supervisor
-
-# 复制后端依赖并安装（包含 gunicorn）
-COPY SmyWorkCollect-Backend/requirements.txt /app/backend/requirements.txt
-RUN pip install --no-cache-dir -r /app/backend/requirements.txt \
-    && pip install --no-cache-dir gunicorn
-
-# 复制后端代码
-COPY SmyWorkCollect-Backend/ /app/backend/
-
-# 复制前端构建产物到预期目录（与后端中的路径逻辑兼容）
-COPY --from=fe-builder /fe/build /app/SmyWorkCollect-Frontend/build
-
-# 复制 Nginx 与 Supervisor 配置
-COPY nginx.conf /etc/nginx/conf.d/default.conf
-COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
-
-# 暴露对外端口 8383（Nginx 监听此端口）
-EXPOSE 8383
-
-# 运行 supervisor 同时管理 nginx 与 gunicorn（Flask）
-CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]
--- a/README-Docker.md
+++ b/README-Docker.md
@@ -1,217 +0,0 @@
-# 树萌芽の作品集 - Docker 部署指南
-
-## 📦 快速部署
-
-### 前置要求
- Docker 20.10+
- Docker Compose 2.0+
- 至少 2GB 可用内存
- 至少 10GB 可用磁盘空间
-
-### 一键部署
-
-```bash
-# 1. 克隆或下载项目到本地
-
-# 2. 进入项目目录
-cd 树萌芽の作品集
-
-# 3. 构建并启动服务
-docker-compose up -d --build
-```
-
-### 访问应用
-部署成功后，通过浏览器访问: **http://localhost:8383**
-
-## 📂 持久化目录说明
-
-所有数据都持久化存储在 `/shumengya/docker/smyworkcollect/data/` 目录下:
-
-```
-/shumengya/docker/smyworkcollect/data/
-├── works/          # 作品数据(图片、视频、文件等)
-├── config/         # 网站配置文件
-└── logs/           # 应用/访问日志(可选)
-```
-
-### Windows 环境
-如果在 Windows 上部署,建议修改 `docker-compose.yml` 中的路径为:
-```yaml
-volumes:
-  - C:/shumengya/docker/smyworkcollect/data/works:/app/backend/works
-  - C:/shumengya/docker/smyworkcollect/data/config:/app/SmyWorkCollect-Frontend/config
-  - C:/shumengya/docker/smyworkcollect/data/logs:/var/log/nginx
-```
-
-### Linux/Mac 环境
-确保创建目录并设置正确权限:
-```bash
-sudo mkdir -p /shumengya/docker/smyworkcollect/data/{works,config,logs}
-sudo chown -R 1000:1000 /shumengya/docker/smyworkcollect/data/
-```
-
-## 🔧 常用命令
-
-### 启动服务
-```bash
-docker-compose up -d
-```
-
-### 停止服务
-```bash
-docker-compose down
-```
-
-### 查看日志
-```bash
-# 查看所有服务日志
-docker-compose logs -f
-
-# 只查看后端日志
-docker-compose logs -f backend
-
-# 只查看前端日志
-docker-compose logs -f frontend
-```
-
-### 重启服务
-```bash
-docker-compose restart
-```
-
-### 重新构建并启动
-```bash
-docker-compose up -d --build
-```
-
-### 查看服务状态
-```bash
-docker-compose ps
-```
-
-### 进入容器
-```bash
-# 进入单容器
-docker exec -it smywork-app sh
-```
-
-## 🔐 管理员配置
-
-管理员 Token: `shumengya520`
-
-访问管理面板: http://localhost:8383/#/admin?token=shumengya520
-
-## 🎨 自定义配置
-
-### 修改端口
-编辑 `docker-compose.yml` 文件中的端口映射:
-```yaml
-ports:
-  - "你的端口:80"  # 例如: "8080:80"
-```
-
-### 修改管理员密码
-编辑 `SmyWorkCollect-Backend/app.py`:
-```python
-ADMIN_TOKEN = "你的新密码"
-```
-然后重新构建:
-```bash
-docker-compose up -d --build backend
-```
-
-### 修改网站配置
-编辑持久化目录中的配置文件:
-```bash
-/shumengya/docker/smyworkcollect/data/config/settings.json
-```
-
-## 📊 资源限制(可选)
-
-在 `docker-compose.yml` 中添加资源限制:
-```yaml
-services:
-  backend:
-    deploy:
-      resources:
-        limits:
-          cpus: '1.0'
-          memory: 1G
-        reservations:
-          cpus: '0.5'
-          memory: 512M
-```
-
-## 🔄 更新应用
-
-```bash
-# 1. 停止服务
-docker-compose down
-
-# 2. 拉取最新代码
-git pull
-
-# 3. 重新构建并启动
-docker-compose up -d --build
-```
-
-## 🛠️ 故障排查
-
-### 服务无法启动
-```bash
-# 查看详细日志
-docker-compose logs
-
-# 检查端口是否被占用
-netstat -ano | findstr 8383  # Windows
-lsof -i :8383                # Linux/Mac
-```
-
-### 权限问题
-```bash
-# Linux/Mac 下设置正确权限
-sudo chown -R 1000:1000 /shumengya/docker/smyworkcollect/data/
-```
-
-### 清理并重新部署
-```bash
-# 停止并删除所有容器
-docker-compose down
-
-# 删除旧镜像（可选，镜像名以目录为准）
-docker images | findstr smywork
-
-# 重新构建
-docker-compose up -d --build
-```
-
-## 📝 备份与恢复
-
-### 备份数据
-```bash
-# 备份作品数据
-tar -czf smywork-backup-$(date +%Y%m%d).tar.gz /shumengya/docker/smyworkcollect/data/
-```
-
-### 恢复数据
-```bash
-# 解压备份
-tar -xzf smywork-backup-20231125.tar.gz -C /
-```
-
-## 🌐 生产环境建议
-
-1. **使用反向代理** (Nginx/Traefik) 并配置 HTTPS
-2. **定期备份** 持久化数据
-3. **监控日志** 并设置告警
-4. **资源限制** 防止资源耗尽
-5. **安全加固** 修改默认管理员密码
-
-## 📞 支持
-
- 作者: 树萌芽
- 邮箱: 3205788256@qq.com
-
---
-
-**祝部署顺利! 🎉**
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # 🌱 树萌芽の作品集

 <div align="center">
-  <img src="frontend/public/assets/logo.png" alt="Logo" width="120" height="120">
+  <img src="SmyWorkCollect-Frontend/public/assets/logo.png" alt="Logo" width="120" height="120">
  
  [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  [![React](https://img.shields.io/badge/React-18.2.0-61dafb.svg)](https://reactjs.org/)
@@ -59,23 +59,42 @@

 1. **后端设置**
   ```bash
-   cd backend
+   cd SmyWorkCollect-Backend
   pip install -r requirements.txt
   python app.py
   ```

 2. **前端设置**（新开终端）
   ```bash
-   cd frontend
+   cd SmyWorkCollect-Frontend
   npm install
   npm start
   ```

+#### 方式三：部署（后端 Docker + 前端静态）
+
+1. **后端 API（Docker）**
+   ```bash
+   cd SmyWorkCollect-Backend
+   docker compose up -d --build
+   ```
+   - 默认对外端口：`5000`（可用 `SPROUTWORKCOLLECT_PORT` 覆盖）
+   - 默认持久化目录：`/shumengya/docker/sproutworkcollect/data/`（可用 `SPROUTWORKCOLLECT_DATA_PATH` 覆盖）
+
+2. **前端（构建为静态网页）**
+   ```bash
+   cd SmyWorkCollect-Frontend
+   npm ci
+   npm run build
+   ```
+   - 构建产物输出到 `SmyWorkCollect-Frontend/build/`
+   - 默认后端地址：`https://work.api.shumengya.top/api`（构建时可用 `REACT_APP_API_URL` 覆盖）
+
 ### 🌐 访问地址

 - **前端页面**: http://localhost:3000
 - **后端API**: http://localhost:5000
- **管理员界面**: http://localhost:3000/admin?token=shumengya520
+- **管理员界面**: http://localhost:3000/admin?token=<ADMIN_TOKEN>

 ### 📁 项目结构

@@ -128,7 +147,7 @@

 2. **按照上面的快速开始指南操作**

-3. **使用token访问管理员面板**: `shumengya520`
+3. **使用 token 访问管理员面板**: 先设置环境变量 `ADMIN_TOKEN`（或 `SPROUTWORKCOLLECT_ADMIN_TOKEN`），再访问 `/admin?token=<ADMIN_TOKEN>`

 ### 📄 许可证

@@ -176,8 +195,8 @@
 #### 访问管理员界面

 1. 确保后端和前端服务都已启动
-2. 访问: http://localhost:3000/admin?token=shumengya520
-3. 管理员token: `shumengya520`
+2. 访问: http://localhost:3000/admin?token=<ADMIN_TOKEN>
+3. 管理员 token：环境变量 `ADMIN_TOKEN`（或 `SPROUTWORKCOLLECT_ADMIN_TOKEN`）

 #### 主要功能

--- a/SmyWorkCollect-Frontend/.env.backup
+++ b/SmyWorkCollect-Frontend/.env.backup
@@ -1 +0,0 @@
-REACT_APP_API_URL=https://work.api.shumengya.top/api
--- a/SmyWorkCollect-Frontend/.env.local
+++ b/SmyWorkCollect-Frontend/.env.local
@@ -1,4 +0,0 @@
-REACT_APP_API_URL=/api
-# 保持开发环境通过 package.json 的 proxy 转发到后端
-DANGEROUSLY_DISABLE_HOST_CHECK=true
-WDS_SOCKET_HOST=localhost
--- a/SmyWorkCollect-Frontend/config/settings.json
+++ b/SmyWorkCollect-Frontend/config/settings.json
@@ -1,13 +0,0 @@
-{
-  "网站名字": "✨ 树萌芽の作品集 ✨",
-  "网站描述": "🎨 展示个人制作的一些小创意和小项目，欢迎交流讨论 💬",
-  "站长": "👨‍💻 by-树萌芽",
-  "联系邮箱": "3205788256@qq.com",
-  "主题颜色": "#81c784",
-  "每页作品数量": 6,
-  "启用搜索": true,
-  "启用分类": true,
-  "备案号": "📄 蜀ICP备2025151694号",
-  "网站页尾": "🌱 树萌芽の作品集 | Copyright © 2025-2025 smy ✨",
-  "网站logo": "assets/logo.png"
-}
--- a/SmyWorkCollect-Frontend/nginx.conf
+++ b/SmyWorkCollect-Frontend/nginx.conf
@@ -1,33 +0,0 @@
-server {
-    listen 80;
-    server_name localhost;
-    
-    # 前端静态文件
-    location / {
-        root /usr/share/nginx/html;
-        index index.html;
-        try_files $uri $uri/ /index.html;
-    }
-    
-    # 代理后端 API 请求
-    location /api/ {
-        proxy_pass http://backend:5000;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        
-        # 大文件上传配置
-        client_max_body_size 5000M;
-        proxy_connect_timeout 600;
-        proxy_send_timeout 600;
-        proxy_read_timeout 600;
-        send_timeout 600;
-    }
-    
-    # 错误页面
-    error_page 500 502 503 504 /50x.html;
-    location = /50x.html {
-        root /usr/share/nginx/html;
-    }
-}
--- a/SmyWorkCollect-Frontend/public/assets/logo.png
+++ b/SmyWorkCollect-Frontend/public/assets/logo.png
--- a/SmyWorkCollect-Frontend/public/assets/logo.svg
+++ b/SmyWorkCollect-Frontend/public/assets/logo.svg
@@ -1,26 +0,0 @@
-<svg width="120" height="60" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="logoGradient" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" style="stop-color:#81c784;stop-opacity:1" />
-      <stop offset="100%" style="stop-color:#66bb6a;stop-opacity:1" />
-    </linearGradient>
-  </defs>
-  
-  <!-- 背景圆角矩形 -->
-  <rect x="0" y="0" width="120" height="60" rx="10" ry="10" fill="url(#logoGradient)"/>
-  
-  <!-- 树的主干 -->
-  <rect x="55" y="35" width="10" height="20" fill="#4a4a4a"/>
-  
-  <!-- 树叶/树冠 -->
-  <circle cx="45" cy="25" r="12" fill="#2e7d32"/>
-  <circle cx="60" cy="20" r="15" fill="#388e3c"/>
-  <circle cx="75" cy="25" r="12" fill="#2e7d32"/>
-  
-  <!-- 萌芽 -->
-  <circle cx="35" cy="30" r="4" fill="#a5d6a7"/>
-  <circle cx="85" cy="28" r="4" fill="#a5d6a7"/>
-  
-  <!-- 文字 -->
-  <text x="60" y="52" text-anchor="middle" font-family="Arial, sans-serif" font-size="8" fill="white" font-weight="bold">树萌芽</text>
-</svg>
--- a/SmyWorkCollect-Frontend/src/components/LoadingSpinner.js
+++ b/SmyWorkCollect-Frontend/src/components/LoadingSpinner.js
@@ -1,41 +0,0 @@
-import React from 'react';
-import styled, { keyframes } from 'styled-components';
-
-const spin = keyframes`
-  0% { transform: rotate(0deg); }
-  100% { transform: rotate(360deg); }
-`;
-
-const SpinnerContainer = styled.div`
-  display: flex;
-  justify-content: center;
-  align-items: center;
-  padding: 40px;
-  min-height: 200px;
-`;
-
-const Spinner = styled.div`
-  width: 40px;
-  height: 40px;
-  border: 4px solid #e8f5e8;
-  border-top: 4px solid #81c784;
-  border-radius: 50%;
-  animation: ${spin} 1s linear infinite;
-`;
-
-const LoadingText = styled.p`
-  margin-left: 15px;
-  color: #666;
-  font-size: 16px;
-`;
-
-const LoadingSpinner = ({ text = '加载中...' }) => {
-  return (
-    <SpinnerContainer>
-      <Spinner />
-      <LoadingText>{text}</LoadingText>
-    </SpinnerContainer>
-  );
-};
-
-export default LoadingSpinner;
--- a/SproutWorkCollect-Backend-Golang/.dockerignore
+++ b/SproutWorkCollect-Backend-Golang/.dockerignore
@@ -0,0 +1,4 @@
+data/
+*.tmp
+.git
+*.md
--- a/SproutWorkCollect-Backend-Golang/Dockerfile
+++ b/SproutWorkCollect-Backend-Golang/Dockerfile
@@ -0,0 +1,40 @@
+# ─── Build Stage ──────────────────────────────────────────────────────────────
+FROM golang:1.21-alpine AS builder
+
+WORKDIR /build
+
+# Allow go to fetch modules even without a pre-generated go.sum
+ENV GOFLAGS=-mod=mod
+ENV GONOSUMDB=*
+
+COPY go.mod ./
+RUN go mod download
+
+COPY . .
+
+RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
+    go build -ldflags="-w -s" -o sproutworkcollect-backend .
+
+# ─── Runtime Stage ────────────────────────────────────────────────────────────
+FROM alpine:3.19
+
+RUN apk add --no-cache ca-certificates tzdata wget && \
+    cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
+    echo "Asia/Shanghai" > /etc/timezone
+
+WORKDIR /app
+
+COPY --from=builder /build/sproutworkcollect-backend .
+
+# Default data directories; override by mounting volumes at runtime
+RUN mkdir -p /data/works /data/config
+
+EXPOSE 5000
+
+ENV SPROUTWORKCOLLECT_DATA_DIR=/data
+ENV PORT=5000
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=15s --retries=3 \
+    CMD wget -qO- http://localhost:5000/api/settings || exit 1
+
+CMD ["./sproutworkcollect-backend"]
--- a/SproutWorkCollect-Backend-Golang/docker-compose.yml
+++ b/SproutWorkCollect-Backend-Golang/docker-compose.yml
@@ -0,0 +1,29 @@
+version: '3.8'
+
+services:
+  sproutworkcollect-api:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: sproutworkcollect-backend-go
+    restart: unless-stopped
+    ports:
+      - "${SPROUTWORKCOLLECT_PORT:-5000}:5000"
+    environment:
+      - PORT=5000
+      - SPROUTWORKCOLLECT_DATA_DIR=/data
+      # Override the default admin token (strongly recommended in production):
+      # - ADMIN_TOKEN=your_secure_token_here
+      # Enable verbose Gin logging (set to 1 for debugging):
+      # - GIN_DEBUG=0
+    volumes:
+      # 默认挂载项目目录下的 data/，部署到服务器时设置 SPROUTWORKCOLLECT_DATA_PATH 覆盖
+      # 例如：export SPROUTWORKCOLLECT_DATA_PATH=/shumengya/docker/sproutworkcollect/data
+      - "${SPROUTWORKCOLLECT_DATA_PATH:-./data}/works:/data/works"
+      - "${SPROUTWORKCOLLECT_DATA_PATH:-./data}/config:/data/config"
+    healthcheck:
+      test: ["CMD", "wget", "-qO-", "http://localhost:5000/api/settings"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 15s
--- a/SproutWorkCollect-Backend-Golang/go.mod
+++ b/SproutWorkCollect-Backend-Golang/go.mod
@@ -0,0 +1,37 @@
+module sproutworkcollect-backend
+
+go 1.21
+
+require (
+	github.com/gin-contrib/cors v1.5.0
+	github.com/gin-gonic/gin v1.9.1
+)
+
+require (
+	github.com/bytedance/sonic v1.10.1 // indirect
+	github.com/chenzhuoyu/base64x v0.0.0-20230717121745-296ad89f973d // indirect
+	github.com/chenzhuoyu/iasm v0.9.0 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.2 // indirect
+	github.com/gin-contrib/sse v0.1.0 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-playground/validator/v10 v10.15.5 // indirect
+	github.com/goccy/go-json v0.10.2 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.5 // indirect
+	github.com/kr/text v0.2.0 // indirect
+	github.com/leodido/go-urn v1.2.4 // indirect
+	github.com/mattn/go-isatty v0.0.19 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/pelletier/go-toml/v2 v2.1.0 // indirect
+	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
+	github.com/ugorji/go/codec v1.2.11 // indirect
+	golang.org/x/arch v0.5.0 // indirect
+	golang.org/x/crypto v0.14.0 // indirect
+	golang.org/x/net v0.16.0 // indirect
+	golang.org/x/sys v0.13.0 // indirect
+	golang.org/x/text v0.13.0 // indirect
+	google.golang.org/protobuf v1.31.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)
--- a/SproutWorkCollect-Backend-Golang/go.sum
+++ b/SproutWorkCollect-Backend-Golang/go.sum
@@ -0,0 +1,102 @@
+github.com/bytedance/sonic v1.5.0/go.mod h1:ED5hyg4y6t3/9Ku1R6dU/4KyJ48DZ4jPhfY1O2AihPM=
+github.com/bytedance/sonic v1.10.0-rc/go.mod h1:ElCzW+ufi8qKqNW0FY314xriJhyJhuoJ3gFZdAHF7NM=
+github.com/bytedance/sonic v1.10.1 h1:7a1wuFXL1cMy7a3f7/VFcEtriuXQnUBhtoVfOZiaysc=
+github.com/bytedance/sonic v1.10.1/go.mod h1:iZcSUejdk5aukTND/Eu/ivjQuEL0Cu9/rf50Hi0u/g4=
+github.com/chenzhuoyu/base64x v0.0.0-20211019084208-fb5309c8db06/go.mod h1:DH46F32mSOjUmXrMHnKwZdA8wcEefY7UVqBKYGjpdQY=
+github.com/chenzhuoyu/base64x v0.0.0-20221115062448-fe3a3abad311/go.mod h1:b583jCggY9gE99b6G5LEC39OIiVsWj+R97kbl5odCEk=
+github.com/chenzhuoyu/base64x v0.0.0-20230717121745-296ad89f973d h1:77cEq6EriyTZ0g/qfRdp61a3Uu/AWrgIq2s0ClJV1g0=
+github.com/chenzhuoyu/base64x v0.0.0-20230717121745-296ad89f973d/go.mod h1:8EPpVsBuRksnlj1mLy4AWzRNQYxauNi62uWcE3to6eA=
+github.com/chenzhuoyu/iasm v0.9.0 h1:9fhXjVzq5hUy2gkhhgHl95zG2cEAhw9OSGs8toWWAwo=
+github.com/chenzhuoyu/iasm v0.9.0/go.mod h1:Xjy2NpN3h7aUqeqM+woSuuvxmIe6+DDsiNLIrkAmYog=
+github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/gabriel-vasile/mimetype v1.4.2 h1:w5qFW6JKBz9Y393Y4q372O9A7cUSequkh1Q7OhCmWKU=
+github.com/gabriel-vasile/mimetype v1.4.2/go.mod h1:zApsH/mKG4w07erKIaJPFiX0Tsq9BFQgN3qGY5GnNgA=
+github.com/gin-contrib/cors v1.5.0 h1:DgGKV7DDoOn36DFkNtbHrjoRiT5ExCe+PC9/xp7aKvk=
+github.com/gin-contrib/cors v1.5.0/go.mod h1:TvU7MAZ3EwrPLI2ztzTt3tqgvBCq+wn8WpZmfADjupI=
+github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
+github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
+github.com/gin-gonic/gin v1.9.1 h1:4idEAncQnU5cB7BeOkPtxjfCSye0AAm1R0RVIqJ+Jmg=
+github.com/gin-gonic/gin v1.9.1/go.mod h1:hPrL7YrpYKXt5YId3A/Tnip5kqbEAP+KLuI3SUcPTeU=
+github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
+github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
+github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
+github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
+github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
+github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
+github.com/go-playground/validator/v10 v10.15.5 h1:LEBecTWb/1j5TNY1YYG2RcOUN3R7NLylN+x8TTueE24=
+github.com/go-playground/validator/v10 v10.15.5/go.mod h1:9iXMNT7sEkjXb0I+enO7QXmzG6QCsPWY4zveKFVRSyU=
+github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
+github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
+github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
+github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU=
+github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
+github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
+github.com/klauspost/cpuid/v2 v2.2.5 h1:0E5MSMDEoAulmXNFquVs//DdoomxaoTY1kUhbc/qbZg=
+github.com/klauspost/cpuid/v2 v2.2.5/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
+github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
+github.com/kr/pretty v0.3.0 h1:WgNl7dwNpEZ6jJ9k1snq4pZsg7DOEN8hP9Xw0Tsjwk0=
+github.com/kr/pretty v0.3.0/go.mod h1:640gp4NfQd8pI5XOwp5fnNeVWj67G7CFk/SaSQn7NBk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/leodido/go-urn v1.2.4 h1:XlAE/cm/ms7TE/VMVoduSpNBoyc2dOxHs5MZSwAN63Q=
+github.com/leodido/go-urn v1.2.4/go.mod h1:7ZrI8mTSeBSHl/UaRyKQW1qZeMgak41ANeCNaVckg+4=
+github.com/mattn/go-isatty v0.0.19 h1:JITubQf0MOLdlGRuRq+jtsDlekdYPia9ZFsB8h/APPA=
+github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
+github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
+github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
+github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/pelletier/go-toml/v2 v2.1.0 h1:FnwAJ4oYMvbT/34k9zzHuZNrhlz48GB3/s6at6/MHO4=
+github.com/pelletier/go-toml/v2 v2.1.0/go.mod h1:tJU2Z3ZkXwnxa4DPO899bsyIoywizdUvyaeZurnPPDc=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.8.0 h1:FCbCCtXNOY3UtUuHUYaghJg4y7Fd14rXifAYUAtL9R8=
+github.com/rogpeppe/go-internal v1.8.0/go.mod h1:WmiCO8CzOY8rg0OYDC4/i/2WRWAB6poM+XZ2dLUbcbE=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
+github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
+github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
+github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcUk=
+github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
+github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
+github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
+github.com/ugorji/go/codec v1.2.11 h1:BMaWp1Bb6fHwEtbplGBGJ498wD+LKlNSl25MjdZY4dU=
+github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
+golang.org/x/arch v0.5.0 h1:jpGode6huXQxcskEIpOCvrU+tzo81b6+oFLUYXWtH/Y=
+golang.org/x/arch v0.5.0/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
+golang.org/x/crypto v0.14.0 h1:wBqGXzWJW6m1XrIKlAH0Hs1JJ7+9KBwnIO8v66Q9cHc=
+golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4=
+golang.org/x/net v0.16.0 h1:7eBu7KsSvFDtSXUIDbh3aqlK4DPsZ1rByC8PFfBThos=
+golang.org/x/net v0.16.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE=
+golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.13.0 h1:Af8nKPmuFypiUBjVoU9V20FiaFXOcuZI21p0ycVYYGE=
+golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/text v0.13.0 h1:ablQoSUd0tRdKxZewP80B+BaqeKJuVhuRxj/dkrun3k=
+golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
+golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
+google.golang.org/protobuf v1.31.0 h1:g0LDEJHgrBl9N9r17Ru3sqWhkIx2NB67okBHPwC7hs8=
+google.golang.org/protobuf v1.31.0/go.mod h1:HV8QOd/L58Z+nl8r43ehVNZIU/HEI6OcFqwMG9pJV4I=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
+rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=
--- a/SproutWorkCollect-Backend-Golang/internal/config/config.go
+++ b/SproutWorkCollect-Backend-Golang/internal/config/config.go
@@ -0,0 +1,79 @@
+package config
+
+import (
+	"os"
+	"path/filepath"
+	"strconv"
+)
+
+// Config holds all runtime configuration resolved from environment variables.
+type Config struct {
+	Port       int
+	AdminToken string
+	WorksDir   string
+	ConfigDir  string
+	Debug      bool
+}
+
+// Load reads environment variables and returns a fully-populated Config.
+//
+// Directory resolution priority:
+//  1. SPROUTWORKCOLLECT_WORKS_DIR / SPROUTWORKCOLLECT_CONFIG_DIR  (per-dir override)
+//  2. SPROUTWORKCOLLECT_DATA_DIR / DATA_DIR  (data root, works/ and config/ appended)
+//  3. ./data/works and ./data/config  (relative to current working directory)
+func Load() *Config {
+	cfg := &Config{
+		Port:       5000,
+		// Do not commit real admin tokens; override via ADMIN_TOKEN / SPROUTWORKCOLLECT_ADMIN_TOKEN.
+		AdminToken: "change-me",
+	}
+
+	if v := os.Getenv("PORT"); v != "" {
+		if p, err := strconv.Atoi(v); err == nil {
+			cfg.Port = p
+		}
+	}
+
+	if v := firstEnv("SPROUTWORKCOLLECT_ADMIN_TOKEN", "ADMIN_TOKEN"); v != "" {
+		cfg.AdminToken = v
+	}
+
+	dbg := os.Getenv("GIN_DEBUG")
+	cfg.Debug = dbg == "1" || dbg == "true"
+
+	dataDir := firstEnv("SPROUTWORKCOLLECT_DATA_DIR", "DATA_DIR")
+
+	worksDir := firstEnv("SPROUTWORKCOLLECT_WORKS_DIR", "WORKS_DIR")
+	if worksDir == "" {
+		if dataDir != "" {
+			worksDir = filepath.Join(dataDir, "works")
+		} else {
+			wd, _ := os.Getwd()
+			worksDir = filepath.Join(wd, "data", "works")
+		}
+	}
+
+	configDir := firstEnv("SPROUTWORKCOLLECT_CONFIG_DIR", "CONFIG_DIR")
+	if configDir == "" {
+		if dataDir != "" {
+			configDir = filepath.Join(dataDir, "config")
+		} else {
+			wd, _ := os.Getwd()
+			configDir = filepath.Join(wd, "data", "config")
+		}
+	}
+
+	cfg.WorksDir = filepath.Clean(worksDir)
+	cfg.ConfigDir = filepath.Clean(configDir)
+
+	return cfg
+}
+
+func firstEnv(keys ...string) string {
+	for _, k := range keys {
+		if v := os.Getenv(k); v != "" {
+			return v
+		}
+	}
+	return ""
+}
--- a/SproutWorkCollect-Backend-Golang/internal/handler/admin.go
+++ b/SproutWorkCollect-Backend-Golang/internal/handler/admin.go
@@ -0,0 +1,317 @@
+package handler
+
+import (
+	"fmt"
+	"net/http"
+	"os"
+	"path/filepath"
+	"strings"
+	"time"
+
+	"github.com/gin-gonic/gin"
+
+	"sproutworkcollect-backend/internal/model"
+	"sproutworkcollect-backend/internal/service"
+)
+
+const maxUploadBytes = 5000 << 20 // 5 000 MB
+
+// AdminHandler handles admin-only API endpoints (protected by AdminAuth middleware).
+type AdminHandler struct {
+	workSvc *service.WorkService
+}
+
+// NewAdminHandler wires up an AdminHandler.
+func NewAdminHandler(workSvc *service.WorkService) *AdminHandler {
+	return &AdminHandler{workSvc: workSvc}
+}
+
+// GetWorks handles GET /api/admin/works
+func (h *AdminHandler) GetWorks(c *gin.Context) {
+	works, err := h.workSvc.LoadAllWorks()
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": err.Error()})
+		return
+	}
+	responses := make([]*model.WorkResponse, len(works))
+	for i, w := range works {
+		responses[i] = h.workSvc.BuildResponse(w)
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "data": responses, "total": len(responses)})
+}
+
+// CreateWork handles POST /api/admin/works
+func (h *AdminHandler) CreateWork(c *gin.Context) {
+	var data model.WorkConfig
+	if err := c.ShouldBindJSON(&data); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "请求数据格式错误"})
+		return
+	}
+	if data.WorkID == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "作品ID不能为空"})
+		return
+	}
+
+	ts := time.Now().Format("2006-01-02T15:04:05.000000")
+	data.UploadTime = ts
+	data.UpdateTime = ts
+	data.UpdateCount = 0
+	data.Downloads = 0
+	data.Views = 0
+	data.Likes = 0
+	data.Normalize()
+
+	if err := h.workSvc.CreateWork(&data); err != nil {
+		status := http.StatusInternalServerError
+		if strings.Contains(err.Error(), "已存在") {
+			status = http.StatusConflict
+		}
+		c.JSON(status, gin.H{"success": false, "message": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "message": "创建成功", "work_id": data.WorkID})
+}
+
+// UpdateWork handles PUT /api/admin/works/:work_id
+func (h *AdminHandler) UpdateWork(c *gin.Context) {
+	workID := c.Param("work_id")
+	var data model.WorkConfig
+	if err := c.ShouldBindJSON(&data); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "请求数据格式错误"})
+		return
+	}
+	if err := h.workSvc.UpdateWork(workID, &data); err != nil {
+		status := http.StatusInternalServerError
+		if strings.Contains(err.Error(), "不存在") {
+			status = http.StatusNotFound
+		}
+		c.JSON(status, gin.H{"success": false, "message": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "message": "更新成功"})
+}
+
+// DeleteWork handles DELETE /api/admin/works/:work_id
+func (h *AdminHandler) DeleteWork(c *gin.Context) {
+	if err := h.workSvc.DeleteWork(c.Param("work_id")); err != nil {
+		c.JSON(http.StatusNotFound, gin.H{"success": false, "message": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "message": "删除成功"})
+}
+
+// UploadFile handles POST /api/admin/upload/:work_id/:file_type
+// file_type: "image" | "video" | "platform"
+// For "platform", the form field "platform" must specify the target platform name.
+func (h *AdminHandler) UploadFile(c *gin.Context) {
+	workID := c.Param("work_id")
+	fileType := c.Param("file_type")
+
+	if !h.workSvc.WorkExists(workID) {
+		c.JSON(http.StatusNotFound, gin.H{"success": false, "message": "作品不存在"})
+		return
+	}
+
+	fh, err := c.FormFile("file")
+	if err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "没有文件"})
+		return
+	}
+	if fh.Size > maxUploadBytes {
+		c.JSON(http.StatusRequestEntityTooLarge, gin.H{
+			"success": false,
+			"message": fmt.Sprintf("文件太大，最大支持 %dMB，当前 %dMB",
+				maxUploadBytes>>20, fh.Size>>20),
+		})
+		return
+	}
+
+	originalName := fh.Filename
+	safeName := service.SafeFilename(originalName)
+	ext := strings.ToLower(filepath.Ext(safeName))
+
+	allowed := map[string]bool{
+		".png": true, ".jpg": true, ".jpeg": true, ".gif": true,
+		".mp4": true, ".avi": true, ".mov": true,
+		".zip": true, ".rar": true, ".apk": true, ".exe": true, ".dmg": true,
+	}
+	if !allowed[ext] {
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "不支持的文件格式"})
+		return
+	}
+
+	// Determine destination directory and resolve a unique filename.
+	// ModifyWork (called later) re-checks uniqueness under a write lock to avoid races.
+	work, err := h.workSvc.LoadWork(workID)
+	if err != nil {
+		c.JSON(http.StatusNotFound, gin.H{"success": false, "message": "作品配置不存在"})
+		return
+	}
+
+	var saveDir string
+	var platform string
+
+	switch fileType {
+	case "image":
+		saveDir = filepath.Join(h.workSvc.WorksDir(), workID, "image")
+	case "video":
+		saveDir = filepath.Join(h.workSvc.WorksDir(), workID, "video")
+	case "platform":
+		platform = c.PostForm("platform")
+		if platform == "" {
+			c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "平台参数缺失"})
+			return
+		}
+		saveDir = filepath.Join(h.workSvc.WorksDir(), workID, "platform", platform)
+	default:
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "不支持的文件类型"})
+		return
+	}
+
+	if err := os.MkdirAll(saveDir, 0755); err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": "创建目录失败"})
+		return
+	}
+
+	// Pre-compute unique filename based on current state.
+	// The authoritative assignment happens inside ModifyWork below.
+	var previewName string
+	switch fileType {
+	case "image":
+		previewName = service.UniqueFilename(safeName, work.Screenshots)
+	case "video":
+		previewName = service.UniqueFilename(safeName, work.VideoFiles)
+	case "platform":
+		previewName = service.UniqueFilename(safeName, work.FileNames[platform])
+	}
+
+	destPath := filepath.Join(saveDir, previewName)
+	if err := c.SaveUploadedFile(fh, destPath); err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{
+			"success": false,
+			"message": fmt.Sprintf("保存文件失败: %v", err),
+		})
+		return
+	}
+
+	// Atomically update the work config under a write lock.
+	var finalName string
+	modErr := h.workSvc.ModifyWork(workID, func(w *model.WorkConfig) {
+		// Re-derive the unique name inside the lock to handle concurrent uploads.
+		switch fileType {
+		case "image":
+			finalName = service.UniqueFilename(safeName, w.Screenshots)
+		case "video":
+			finalName = service.UniqueFilename(safeName, w.VideoFiles)
+		case "platform":
+			finalName = service.UniqueFilename(safeName, w.FileNames[platform])
+		}
+
+		// Rename the file on disk if the finalName differs from the pre-computed one.
+		if finalName != previewName {
+			newDest := filepath.Join(saveDir, finalName)
+			_ = os.Rename(destPath, newDest)
+		}
+
+		if w.OriginalNames == nil {
+			w.OriginalNames = make(map[string]string)
+		}
+		w.OriginalNames[finalName] = originalName
+
+		switch fileType {
+		case "image":
+			if !service.ContainsString(w.Screenshots, finalName) {
+				w.Screenshots = append(w.Screenshots, finalName)
+			}
+			if w.Cover == "" {
+				w.Cover = finalName
+			}
+		case "video":
+			if !service.ContainsString(w.VideoFiles, finalName) {
+				w.VideoFiles = append(w.VideoFiles, finalName)
+			}
+		case "platform":
+			if w.FileNames == nil {
+				w.FileNames = make(map[string][]string)
+			}
+			if !service.ContainsString(w.FileNames[platform], finalName) {
+				w.FileNames[platform] = append(w.FileNames[platform], finalName)
+			}
+		}
+	})
+
+	if modErr != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": "更新配置失败"})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"success":   true,
+		"message":   "上传成功",
+		"filename":  finalName,
+		"file_size": fh.Size,
+	})
+}
+
+// DeleteFile handles DELETE /api/admin/delete-file/:work_id/:file_type/:filename
+func (h *AdminHandler) DeleteFile(c *gin.Context) {
+	workID := c.Param("work_id")
+	fileType := c.Param("file_type")
+	filename := c.Param("filename")
+
+	if _, err := h.workSvc.LoadWork(workID); err != nil {
+		c.JSON(http.StatusNotFound, gin.H{"success": false, "message": "作品不存在"})
+		return
+	}
+
+	platform := c.Query("platform")
+
+	var filePath string
+	switch fileType {
+	case "image":
+		filePath = filepath.Join(h.workSvc.WorksDir(), workID, "image", filename)
+	case "video":
+		filePath = filepath.Join(h.workSvc.WorksDir(), workID, "video", filename)
+	case "platform":
+		if platform == "" {
+			c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "平台参数缺失"})
+			return
+		}
+		filePath = filepath.Join(h.workSvc.WorksDir(), workID, "platform", platform, filename)
+	default:
+		c.JSON(http.StatusBadRequest, gin.H{"success": false, "message": "不支持的文件类型"})
+		return
+	}
+
+	_ = os.Remove(filePath)
+
+	modErr := h.workSvc.ModifyWork(workID, func(w *model.WorkConfig) {
+		if w.OriginalNames != nil {
+			delete(w.OriginalNames, filename)
+		}
+		switch fileType {
+		case "image":
+			w.Screenshots = service.RemoveString(w.Screenshots, filename)
+			if w.Cover == filename {
+				if len(w.Screenshots) > 0 {
+					w.Cover = w.Screenshots[0]
+				} else {
+					w.Cover = ""
+				}
+			}
+		case "video":
+			w.VideoFiles = service.RemoveString(w.VideoFiles, filename)
+		case "platform":
+			if w.FileNames != nil {
+				w.FileNames[platform] = service.RemoveString(w.FileNames[platform], filename)
+			}
+		}
+	})
+
+	if modErr != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": "更新配置失败"})
+		return
+	}
+
+	c.JSON(http.StatusOK, gin.H{"success": true, "message": "删除成功"})
+}
--- a/SproutWorkCollect-Backend-Golang/internal/handler/media.go
+++ b/SproutWorkCollect-Backend-Golang/internal/handler/media.go
@@ -0,0 +1,72 @@
+package handler
+
+import (
+	"net/http"
+	"os"
+	"path/filepath"
+
+	"github.com/gin-gonic/gin"
+
+	"sproutworkcollect-backend/internal/service"
+)
+
+// MediaHandler serves static media files (images, videos, and downloadable assets).
+type MediaHandler struct {
+	workSvc     *service.WorkService
+	rateLimiter *service.RateLimiter
+}
+
+// NewMediaHandler wires up a MediaHandler with its dependencies.
+func NewMediaHandler(workSvc *service.WorkService, rateLimiter *service.RateLimiter) *MediaHandler {
+	return &MediaHandler{workSvc: workSvc, rateLimiter: rateLimiter}
+}
+
+// ServeImage handles GET /api/image/:work_id/:filename
+func (h *MediaHandler) ServeImage(c *gin.Context) {
+	imgPath := filepath.Join(
+		h.workSvc.WorksDir(),
+		c.Param("work_id"),
+		"image",
+		c.Param("filename"),
+	)
+	if _, err := os.Stat(imgPath); os.IsNotExist(err) {
+		c.JSON(http.StatusNotFound, gin.H{"error": "图片不存在"})
+		return
+	}
+	c.File(imgPath)
+}
+
+// ServeVideo handles GET /api/video/:work_id/:filename
+func (h *MediaHandler) ServeVideo(c *gin.Context) {
+	videoPath := filepath.Join(
+		h.workSvc.WorksDir(),
+		c.Param("work_id"),
+		"video",
+		c.Param("filename"),
+	)
+	if _, err := os.Stat(videoPath); os.IsNotExist(err) {
+		c.JSON(http.StatusNotFound, gin.H{"error": "视频不存在"})
+		return
+	}
+	c.File(videoPath)
+}
+
+// DownloadFile handles GET /api/download/:work_id/:platform/:filename
+func (h *MediaHandler) DownloadFile(c *gin.Context) {
+	workID := c.Param("work_id")
+	platform := c.Param("platform")
+	filename := c.Param("filename")
+
+	filePath := filepath.Join(h.workSvc.WorksDir(), workID, "platform", platform, filename)
+	if _, err := os.Stat(filePath); os.IsNotExist(err) {
+		c.JSON(http.StatusNotFound, gin.H{"error": "文件不存在"})
+		return
+	}
+
+	fp := service.Fingerprint(c.ClientIP(), c.GetHeader("User-Agent"))
+	if h.rateLimiter.CanPerform(fp, "download", workID) {
+		_ = h.workSvc.UpdateStats(workID, "download")
+	}
+
+	c.FileAttachment(filePath, filename)
+}
--- a/SproutWorkCollect-Backend-Golang/internal/handler/public.go
+++ b/SproutWorkCollect-Backend-Golang/internal/handler/public.go
@@ -0,0 +1,145 @@
+package handler
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+
+	"sproutworkcollect-backend/internal/service"
+)
+
+// PublicHandler handles all publicly accessible API endpoints.
+type PublicHandler struct {
+	workSvc     *service.WorkService
+	settingsSvc *service.SettingsService
+	rateLimiter *service.RateLimiter
+}
+
+// NewPublicHandler wires up a PublicHandler with its dependencies.
+func NewPublicHandler(
+	workSvc *service.WorkService,
+	settingsSvc *service.SettingsService,
+	rateLimiter *service.RateLimiter,
+) *PublicHandler {
+	return &PublicHandler{
+		workSvc:     workSvc,
+		settingsSvc: settingsSvc,
+		rateLimiter: rateLimiter,
+	}
+}
+
+// GetSettings handles GET /api/settings
+func (h *PublicHandler) GetSettings(c *gin.Context) {
+	settings, err := h.settingsSvc.Load()
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, settings)
+}
+
+// GetWorks handles GET /api/works
+func (h *PublicHandler) GetWorks(c *gin.Context) {
+	works, err := h.workSvc.LoadAllWorks()
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": err.Error()})
+		return
+	}
+
+	responses := make([]any, len(works))
+	for i, w := range works {
+		responses[i] = h.workSvc.BuildResponse(w)
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"success": true,
+		"data":    responses,
+		"total":   len(responses),
+	})
+}
+
+// GetWorkDetail handles GET /api/works/:work_id
+func (h *PublicHandler) GetWorkDetail(c *gin.Context) {
+	workID := c.Param("work_id")
+
+	work, err := h.workSvc.LoadWork(workID)
+	if err != nil {
+		c.JSON(http.StatusNotFound, gin.H{"success": false, "message": "作品不存在"})
+		return
+	}
+
+	fp := service.Fingerprint(c.ClientIP(), c.GetHeader("User-Agent"))
+	if h.rateLimiter.CanPerform(fp, "view", workID) {
+		_ = h.workSvc.UpdateStats(workID, "view")
+		// Reload to return the updated view count.
+		if fresh, err2 := h.workSvc.LoadWork(workID); err2 == nil {
+			work = fresh
+		}
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"success": true,
+		"data":    h.workSvc.BuildResponse(work),
+	})
+}
+
+// SearchWorks handles GET /api/search?q=...&category=...
+func (h *PublicHandler) SearchWorks(c *gin.Context) {
+	works, err := h.workSvc.SearchWorks(c.Query("q"), c.Query("category"))
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": err.Error()})
+		return
+	}
+
+	responses := make([]any, len(works))
+	for i, w := range works {
+		responses[i] = h.workSvc.BuildResponse(w)
+	}
+
+	c.JSON(http.StatusOK, gin.H{
+		"success": true,
+		"data":    responses,
+		"total":   len(responses),
+	})
+}
+
+// GetCategories handles GET /api/categories
+func (h *PublicHandler) GetCategories(c *gin.Context) {
+	cats, err := h.workSvc.AllCategories()
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"success": true, "data": cats})
+}
+
+// LikeWork handles POST /api/like/:work_id
+func (h *PublicHandler) LikeWork(c *gin.Context) {
+	workID := c.Param("work_id")
+
+	if _, err := h.workSvc.LoadWork(workID); err != nil {
+		c.JSON(http.StatusNotFound, gin.H{"success": false, "message": "作品不存在"})
+		return
+	}
+
+	fp := service.Fingerprint(c.ClientIP(), c.GetHeader("User-Agent"))
+	if !h.rateLimiter.CanPerform(fp, "like", workID) {
+		c.JSON(http.StatusTooManyRequests, gin.H{
+			"success": false,
+			"message": "操作太频繁，请稍后再试",
+		})
+		return
+	}
+
+	if err := h.workSvc.UpdateStats(workID, "like"); err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"success": false, "message": "点赞失败"})
+		return
+	}
+
+	work, _ := h.workSvc.LoadWork(workID)
+	c.JSON(http.StatusOK, gin.H{
+		"success": true,
+		"message": "点赞成功",
+		"likes":   work.Likes,
+	})
+}
--- a/SproutWorkCollect-Backend-Golang/internal/middleware/auth.go
+++ b/SproutWorkCollect-Backend-Golang/internal/middleware/auth.go
@@ -0,0 +1,27 @@
+package middleware
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+)
+
+// AdminAuth returns a Gin middleware that validates the admin token.
+// The token may be supplied via the `token` query parameter or the
+// `Authorization` request header.
+func AdminAuth(token string) gin.HandlerFunc {
+	return func(c *gin.Context) {
+		t := c.Query("token")
+		if t == "" {
+			t = c.GetHeader("Authorization")
+		}
+		if t != token {
+			c.AbortWithStatusJSON(http.StatusForbidden, gin.H{
+				"success": false,
+				"message": "权限不足",
+			})
+			return
+		}
+		c.Next()
+	}
+}
--- a/SproutWorkCollect-Backend-Golang/internal/model/settings.go
+++ b/SproutWorkCollect-Backend-Golang/internal/model/settings.go
@@ -0,0 +1,16 @@
+package model
+
+// Settings represents the site-wide configuration stored in config/settings.json.
+type Settings struct {
+	SiteName       string `json:"网站名字"`
+	SiteDesc       string `json:"网站描述"`
+	Author         string `json:"站长"`
+	ContactEmail   string `json:"联系邮箱"`
+	ThemeColor     string `json:"主题颜色"`
+	PageSize       int    `json:"每页作品数量"`
+	EnableSearch   bool   `json:"启用搜索"`
+	EnableCategory bool   `json:"启用分类"`
+	Icp            string `json:"备案号"`
+	Footer         string `json:"网站页尾"`
+	Logo           string `json:"网站logo"`
+}
--- a/SproutWorkCollect-Backend-Golang/internal/model/work.go
+++ b/SproutWorkCollect-Backend-Golang/internal/model/work.go
@@ -0,0 +1,75 @@
+package model
+
+// WorkConfig is the data persisted in each work's work_config.json.
+// JSON field names are kept in Chinese to maintain backward compatibility
+// with data files written by the original Python backend.
+type WorkConfig struct {
+	WorkID        string              `json:"作品ID"`
+	WorkName      string              `json:"作品作品"`
+	WorkDesc      string              `json:"作品描述"`
+	Author        string              `json:"作者"`
+	Version       string              `json:"作品版本号"`
+	Category      string              `json:"作品分类"`
+	Tags          []string            `json:"作品标签"`
+	UploadTime    string              `json:"上传时间"`
+	UpdateTime    string              `json:"更新时间"`
+	Platforms     []string            `json:"支持平台"`
+	FileNames     map[string][]string `json:"文件名称"`
+	// 外部下载：每个平台可以配置多个外链下载（带别名）。
+	ExternalDownloads map[string][]ExternalDownload `json:"外部下载,omitempty"`
+	Screenshots   []string            `json:"作品截图"`
+	VideoFiles    []string            `json:"作品视频"`
+	Cover         string              `json:"作品封面"`
+	Downloads     int                 `json:"作品下载量"`
+	Views         int                 `json:"作品浏览量"`
+	Likes         int                 `json:"作品点赞量"`
+	UpdateCount   int                 `json:"作品更新次数"`
+	OriginalNames map[string]string   `json:"原始文件名,omitempty"`
+}
+
+type ExternalDownload struct {
+	Alias string `json:"别名"`
+	URL   string `json:"链接"`
+}
+
+// Normalize replaces nil slices/maps with empty equivalents so JSON
+// serialization produces [] / {} instead of null, matching Python behaviour.
+func (w *WorkConfig) Normalize() {
+	if w.Tags == nil {
+		w.Tags = []string{}
+	}
+	if w.Platforms == nil {
+		w.Platforms = []string{}
+	}
+	if w.FileNames == nil {
+		w.FileNames = map[string][]string{}
+	}
+	if w.ExternalDownloads == nil {
+		w.ExternalDownloads = map[string][]ExternalDownload{}
+	}
+	if w.Screenshots == nil {
+		w.Screenshots = []string{}
+	}
+	if w.VideoFiles == nil {
+		w.VideoFiles = []string{}
+	}
+}
+
+// WorkResponse is a WorkConfig with dynamically computed link fields appended.
+// These link fields are NEVER stored in work_config.json; they are built on
+// the fly at response time.
+type WorkResponse struct {
+	WorkConfig
+	// 下载链接 is always present (empty map when there are no download files).
+	DownloadLinks map[string][]string `json:"下载链接"`
+	// 下载资源：统一返回“本地下载 + 外部下载”，前端可直接按别名渲染按钮/链接。
+	DownloadResources map[string][]DownloadResource `json:"下载资源"`
+	ImageLinks    []string            `json:"图片链接,omitempty"`
+	VideoLinks    []string            `json:"视频链接,omitempty"`
+}
+
+type DownloadResource struct {
+	Type  string `json:"类型"` // local | external
+	Alias string `json:"别名"`
+	URL   string `json:"链接"`
+}
--- a/SproutWorkCollect-Backend-Golang/internal/router/router.go
+++ b/SproutWorkCollect-Backend-Golang/internal/router/router.go
@@ -0,0 +1,81 @@
+package router
+
+import (
+	"time"
+
+	"github.com/gin-contrib/cors"
+	"github.com/gin-gonic/gin"
+
+	"sproutworkcollect-backend/internal/config"
+	"sproutworkcollect-backend/internal/handler"
+	"sproutworkcollect-backend/internal/middleware"
+	"sproutworkcollect-backend/internal/service"
+)
+
+// Setup creates and configures the Gin engine: middleware, services, handlers, and routes.
+func Setup(cfg *config.Config) *gin.Engine {
+	if !cfg.Debug {
+		gin.SetMode(gin.ReleaseMode)
+	}
+
+	r := gin.Default()
+
+	// Allow files up to 32 MB to stay in memory; larger ones spill to temp disk files.
+	// This keeps RAM usage bounded even for gigabyte-scale uploads.
+	r.MaxMultipartMemory = 32 << 20
+
+	// 允许所有来源，并显式放开 Authorization 头，解决跨域访问后台接口时的预检失败问题。
+	corsCfg := cors.Config{
+		AllowOrigins: []string{"*"},
+		AllowMethods: []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},
+		AllowHeaders: []string{
+			"Origin",
+			"Content-Type",
+			"Accept",
+			"Authorization",
+			"X-Requested-With",
+		},
+		ExposeHeaders:    []string{"Content-Length"},
+		AllowCredentials: false,
+		MaxAge:           12 * time.Hour,
+	}
+	r.Use(cors.New(corsCfg))
+
+	// ─── Services ─────────────────────────────────────────────────────────────
+	workSvc := service.NewWorkService(cfg)
+	settingsSvc := service.NewSettingsService(cfg)
+	rateLimiter := service.NewRateLimiter()
+
+	// ─── Handlers ─────────────────────────────────────────────────────────────
+	pub := handler.NewPublicHandler(workSvc, settingsSvc, rateLimiter)
+	media := handler.NewMediaHandler(workSvc, rateLimiter)
+	admin := handler.NewAdminHandler(workSvc)
+
+	// ─── Public routes ────────────────────────────────────────────────────────
+	api := r.Group("/api")
+	{
+		api.GET("/settings", pub.GetSettings)
+		api.GET("/works", pub.GetWorks)
+		api.GET("/works/:work_id", pub.GetWorkDetail)
+		api.GET("/search", pub.SearchWorks)
+		api.GET("/categories", pub.GetCategories)
+		api.POST("/like/:work_id", pub.LikeWork)
+
+		api.GET("/image/:work_id/:filename", media.ServeImage)
+		api.GET("/video/:work_id/:filename", media.ServeVideo)
+		api.GET("/download/:work_id/:platform/:filename", media.DownloadFile)
+	}
+
+	// ─── Admin routes (token-protected) ──────────────────────────────────────
+	adm := api.Group("/admin", middleware.AdminAuth(cfg.AdminToken))
+	{
+		adm.GET("/works", admin.GetWorks)
+		adm.POST("/works", admin.CreateWork)
+		adm.PUT("/works/:work_id", admin.UpdateWork)
+		adm.DELETE("/works/:work_id", admin.DeleteWork)
+		adm.POST("/upload/:work_id/:file_type", admin.UploadFile)
+		adm.DELETE("/delete-file/:work_id/:file_type/:filename", admin.DeleteFile)
+	}
+
+	return r
+}
--- a/SproutWorkCollect-Backend-Golang/internal/service/ratelimit.go
+++ b/SproutWorkCollect-Backend-Golang/internal/service/ratelimit.go
@@ -0,0 +1,64 @@
+package service
+
+import (
+	"crypto/md5"
+	"fmt"
+	"sync"
+	"time"
+)
+
+// rateLimits defines minimum seconds between the same action by the same user on the same work.
+var rateLimits = map[string]int64{
+	"view":     60,
+	"download": 300,
+	"like":     3600,
+}
+
+// RateLimiter provides per-user, per-action, per-work rate limiting backed by an in-memory store.
+// The store is never persisted; it resets on service restart (same behaviour as the Python version).
+type RateLimiter struct {
+	mu sync.Mutex
+	// fingerprint → actionType → workID → last unix timestamp
+	actions map[string]map[string]map[string]int64
+}
+
+// NewRateLimiter allocates a new empty RateLimiter.
+func NewRateLimiter() *RateLimiter {
+	return &RateLimiter{
+		actions: make(map[string]map[string]map[string]int64),
+	}
+}
+
+// CanPerform returns true and records the timestamp if the rate limit window has elapsed.
+// Returns false if the action is too frequent.
+func (rl *RateLimiter) CanPerform(fingerprint, actionType, workID string) bool {
+	rl.mu.Lock()
+	defer rl.mu.Unlock()
+
+	limit, ok := rateLimits[actionType]
+	if !ok {
+		return true
+	}
+
+	now := time.Now().Unix()
+
+	if rl.actions[fingerprint] == nil {
+		rl.actions[fingerprint] = make(map[string]map[string]int64)
+	}
+	if rl.actions[fingerprint][actionType] == nil {
+		rl.actions[fingerprint][actionType] = make(map[string]int64)
+	}
+
+	last := rl.actions[fingerprint][actionType][workID]
+	if now-last >= limit {
+		rl.actions[fingerprint][actionType][workID] = now
+		return true
+	}
+	return false
+}
+
+// Fingerprint creates an MD5 hex string from IP and User-Agent for rate-limit keying.
+func Fingerprint(ip, userAgent string) string {
+	h := md5.Sum([]byte(ip + ":" + userAgent))
+	return fmt.Sprintf("%x", h)
+}
--- a/SproutWorkCollect-Backend-Golang/internal/service/settings_service.go
+++ b/SproutWorkCollect-Backend-Golang/internal/service/settings_service.go
@@ -0,0 +1,53 @@
+package service
+
+import (
+	"encoding/json"
+	"os"
+	"path/filepath"
+
+	"sproutworkcollect-backend/internal/config"
+	"sproutworkcollect-backend/internal/model"
+)
+
+var defaultSettings = model.Settings{
+	SiteName:       "✨ 萌芽作品集 ✨",
+	SiteDesc:       "🎨 展示个人制作的一些小创意和小项目，欢迎交流讨论 💬",
+	Author:         "👨‍💻 by-树萌芽",
+	ContactEmail:   "3205788256@qq.com",
+	ThemeColor:     "#81c784",
+	PageSize:       6,
+	EnableSearch:   true,
+	EnableCategory: true,
+	Icp:            "📄 蜀ICP备2025151694号",
+	Footer:         "✨ 萌芽作品集 ✨ | Copyright © 2025-2025 smy ",
+	Logo:           "assets/logo.png",
+}
+
+// SettingsService manages the site-wide settings file.
+type SettingsService struct {
+	cfg *config.Config
+}
+
+// NewSettingsService creates a SettingsService with the given config.
+func NewSettingsService(cfg *config.Config) *SettingsService {
+	return &SettingsService{cfg: cfg}
+}
+
+// Load reads settings.json, returning built-in defaults when the file is absent or malformed.
+func (s *SettingsService) Load() (*model.Settings, error) {
+	path := filepath.Join(s.cfg.ConfigDir, "settings.json")
+	data, err := os.ReadFile(path)
+	if err != nil {
+		if os.IsNotExist(err) {
+			d := defaultSettings
+			return &d, nil
+		}
+		return nil, err
+	}
+	var settings model.Settings
+	if err := json.Unmarshal(data, &settings); err != nil {
+		d := defaultSettings
+		return &d, nil
+	}
+	return &settings, nil
+}
--- a/SproutWorkCollect-Backend-Golang/internal/service/work_service.go
+++ b/SproutWorkCollect-Backend-Golang/internal/service/work_service.go
@@ -0,0 +1,420 @@
+package service
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+	"path/filepath"
+	"sort"
+	"strings"
+	"sync"
+	"time"
+	"unicode"
+
+	"sproutworkcollect-backend/internal/config"
+	"sproutworkcollect-backend/internal/model"
+)
+
+// WorkService manages all work data operations with concurrent-safe file I/O.
+type WorkService struct {
+	cfg *config.Config
+	mu  sync.RWMutex
+}
+
+// NewWorkService creates a WorkService with the given config.
+func NewWorkService(cfg *config.Config) *WorkService {
+	return &WorkService{cfg: cfg}
+}
+
+// WorksDir returns the configured works root directory.
+func (s *WorkService) WorksDir() string { return s.cfg.WorksDir }
+
+// WorkExists reports whether a work directory is present on disk.
+func (s *WorkService) WorkExists(workID string) bool {
+	_, err := os.Stat(filepath.Join(s.cfg.WorksDir, workID))
+	return err == nil
+}
+
+// ─── Read operations ──────────────────────────────────────────────────────────
+
+// LoadWork loads and returns a single work config from disk (read-locked).
+func (s *WorkService) LoadWork(workID string) (*model.WorkConfig, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+	return s.loadWork(workID)
+}
+
+// loadWork is the internal (unlocked) loader; callers must hold at least an RLock.
+func (s *WorkService) loadWork(workID string) (*model.WorkConfig, error) {
+	path := filepath.Join(s.cfg.WorksDir, workID, "work_config.json")
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return nil, err
+	}
+	var work model.WorkConfig
+	if err := json.Unmarshal(data, &work); err != nil {
+		return nil, err
+	}
+	work.Normalize()
+	return &work, nil
+}
+
+// LoadAllWorks loads every work and returns them sorted by UpdateTime descending.
+func (s *WorkService) LoadAllWorks() ([]*model.WorkConfig, error) {
+	s.mu.RLock()
+	defer s.mu.RUnlock()
+
+	entries, err := os.ReadDir(s.cfg.WorksDir)
+	if err != nil {
+		if os.IsNotExist(err) {
+			return []*model.WorkConfig{}, nil
+		}
+		return nil, err
+	}
+
+	var works []*model.WorkConfig
+	for _, e := range entries {
+		if !e.IsDir() {
+			continue
+		}
+		w, err := s.loadWork(e.Name())
+		if err != nil {
+			continue // skip broken configs
+		}
+		works = append(works, w)
+	}
+
+	sort.Slice(works, func(i, j int) bool {
+		return works[i].UpdateTime > works[j].UpdateTime
+	})
+	return works, nil
+}
+
+// SearchWorks filters all works by keyword (name / desc / tags) and/or category.
+func (s *WorkService) SearchWorks(query, category string) ([]*model.WorkConfig, error) {
+	all, err := s.LoadAllWorks()
+	if err != nil {
+		return nil, err
+	}
+
+	q := strings.ToLower(query)
+	var result []*model.WorkConfig
+	for _, w := range all {
+		if q != "" {
+			matched := strings.Contains(strings.ToLower(w.WorkName), q) ||
+				strings.Contains(strings.ToLower(w.WorkDesc), q)
+			if !matched {
+				for _, tag := range w.Tags {
+					if strings.Contains(strings.ToLower(tag), q) {
+						matched = true
+						break
+					}
+				}
+			}
+			if !matched {
+				continue
+			}
+		}
+		if category != "" && w.Category != category {
+			continue
+		}
+		result = append(result, w)
+	}
+	return result, nil
+}
+
+// AllCategories returns a deduplicated list of all work categories.
+func (s *WorkService) AllCategories() ([]string, error) {
+	all, err := s.LoadAllWorks()
+	if err != nil {
+		return nil, err
+	}
+	seen := make(map[string]struct{})
+	var cats []string
+	for _, w := range all {
+		if w.Category != "" {
+			if _, ok := seen[w.Category]; !ok {
+				seen[w.Category] = struct{}{}
+				cats = append(cats, w.Category)
+			}
+		}
+	}
+	if cats == nil {
+		cats = []string{}
+	}
+	return cats, nil
+}
+
+// BuildResponse attaches dynamically computed link fields to a work for API responses.
+// These fields are never written back to disk.
+func (s *WorkService) BuildResponse(w *model.WorkConfig) *model.WorkResponse {
+	resp := &model.WorkResponse{
+		WorkConfig:         *w,
+		DownloadLinks:      make(map[string][]string),
+		DownloadResources:  make(map[string][]model.DownloadResource),
+	}
+
+	for _, platform := range w.Platforms {
+		if files, ok := w.FileNames[platform]; ok && len(files) > 0 {
+			links := make([]string, len(files))
+			for i, f := range files {
+				rel := fmt.Sprintf("/api/download/%s/%s/%s", w.WorkID, platform, f)
+				links[i] = rel
+				resp.DownloadResources[platform] = append(resp.DownloadResources[platform], model.DownloadResource{
+					Type:  "local",
+					Alias: f,
+					URL:   rel,
+				})
+			}
+			resp.DownloadLinks[platform] = links
+		}
+
+		// 外部下载链接（带别名）
+		if extList, ok := w.ExternalDownloads[platform]; ok && len(extList) > 0 {
+			for _, item := range extList {
+				if strings.TrimSpace(item.URL) == "" {
+					continue
+				}
+				alias := strings.TrimSpace(item.Alias)
+				if alias == "" {
+					alias = "外部下载"
+				}
+				resp.DownloadResources[platform] = append(resp.DownloadResources[platform], model.DownloadResource{
+					Type:  "external",
+					Alias: alias,
+					URL:   strings.TrimSpace(item.URL),
+				})
+			}
+		}
+	}
+
+	if len(w.Screenshots) > 0 {
+		resp.ImageLinks = make([]string, len(w.Screenshots))
+		for i, img := range w.Screenshots {
+			resp.ImageLinks[i] = fmt.Sprintf("/api/image/%s/%s", w.WorkID, img)
+		}
+	}
+
+	if len(w.VideoFiles) > 0 {
+		resp.VideoLinks = make([]string, len(w.VideoFiles))
+		for i, vid := range w.VideoFiles {
+			resp.VideoLinks[i] = fmt.Sprintf("/api/video/%s/%s", w.WorkID, vid)
+		}
+	}
+
+	return resp
+}
+
+// ─── Write operations ─────────────────────────────────────────────────────────
+
+// SaveWork atomically persists a work config (write-locked).
+// It writes to a .tmp file first, then renames to guarantee atomicity.
+func (s *WorkService) SaveWork(work *model.WorkConfig) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+	return s.saveWork(work)
+}
+
+// saveWork is the internal (unlocked) writer; callers must hold the write lock.
+func (s *WorkService) saveWork(work *model.WorkConfig) error {
+	configPath := filepath.Join(s.cfg.WorksDir, work.WorkID, "work_config.json")
+	data, err := json.MarshalIndent(work, "", "  ")
+	if err != nil {
+		return fmt.Errorf("序列化配置失败: %w", err)
+	}
+	tmp := configPath + ".tmp"
+	if err := os.WriteFile(tmp, data, 0644); err != nil {
+		return fmt.Errorf("写入临时文件失败: %w", err)
+	}
+	if err := os.Rename(tmp, configPath); err != nil {
+		_ = os.Remove(tmp)
+		return fmt.Errorf("原子写入失败: %w", err)
+	}
+	return nil
+}
+
+// ModifyWork loads a work under a write lock, applies fn, then saves the result.
+// Using this helper avoids the load–modify–save TOCTOU race for concurrent requests.
+func (s *WorkService) ModifyWork(workID string, fn func(*model.WorkConfig)) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+
+	work, err := s.loadWork(workID)
+	if err != nil {
+		return err
+	}
+	fn(work)
+	work.UpdateTime = now()
+	return s.saveWork(work)
+}
+
+// UpdateStats increments a statistical counter ("view" | "download" | "like").
+func (s *WorkService) UpdateStats(workID, statType string) error {
+	return s.ModifyWork(workID, func(w *model.WorkConfig) {
+		switch statType {
+		case "view":
+			w.Views++
+		case "download":
+			w.Downloads++
+		case "like":
+			w.Likes++
+		}
+	})
+}
+
+// CreateWork initialises a new work directory tree and writes the first config.
+func (s *WorkService) CreateWork(work *model.WorkConfig) error {
+	workDir := filepath.Join(s.cfg.WorksDir, work.WorkID)
+	if _, err := os.Stat(workDir); err == nil {
+		return fmt.Errorf("作品ID已存在")
+	}
+
+	dirs := []string{
+		workDir,
+		filepath.Join(workDir, "image"),
+		filepath.Join(workDir, "video"),
+		filepath.Join(workDir, "platform"),
+	}
+	for _, p := range work.Platforms {
+		dirs = append(dirs, filepath.Join(workDir, "platform", p))
+	}
+	for _, d := range dirs {
+		if err := os.MkdirAll(d, 0755); err != nil {
+			return fmt.Errorf("创建目录失败 %s: %w", d, err)
+		}
+	}
+	return s.SaveWork(work)
+}
+
+// UpdateWork merges incoming data into the existing config, preserving statistics
+// when the caller does not provide them (zero values).
+func (s *WorkService) UpdateWork(workID string, incoming *model.WorkConfig) error {
+	s.mu.Lock()
+	defer s.mu.Unlock()
+
+	existing, err := s.loadWork(workID)
+	if err != nil {
+		return fmt.Errorf("作品不存在: %w", err)
+	}
+
+	// 兼容旧前端：如果某些字段未带上，则保留旧值，避免被清空。
+	if incoming.FileNames == nil {
+		incoming.FileNames = existing.FileNames
+	}
+	if incoming.ExternalDownloads == nil {
+		incoming.ExternalDownloads = existing.ExternalDownloads
+	}
+	if incoming.Screenshots == nil {
+		incoming.Screenshots = existing.Screenshots
+	}
+	if incoming.VideoFiles == nil {
+		incoming.VideoFiles = existing.VideoFiles
+	}
+	if incoming.Cover == "" {
+		incoming.Cover = existing.Cover
+	}
+	if incoming.OriginalNames == nil {
+		incoming.OriginalNames = existing.OriginalNames
+	}
+
+	if incoming.Downloads == 0 {
+		incoming.Downloads = existing.Downloads
+	}
+	if incoming.Views == 0 {
+		incoming.Views = existing.Views
+	}
+	if incoming.Likes == 0 {
+		incoming.Likes = existing.Likes
+	}
+	if incoming.UploadTime == "" {
+		incoming.UploadTime = existing.UploadTime
+	}
+
+	incoming.WorkID = workID
+	incoming.UpdateTime = now()
+	incoming.UpdateCount = existing.UpdateCount + 1
+	incoming.Normalize()
+
+	return s.saveWork(incoming)
+}
+
+// DeleteWork removes the entire work directory.
+func (s *WorkService) DeleteWork(workID string) error {
+	workDir := filepath.Join(s.cfg.WorksDir, workID)
+	if _, err := os.Stat(workDir); os.IsNotExist(err) {
+		return fmt.Errorf("作品不存在")
+	}
+	return os.RemoveAll(workDir)
+}
+
+// ─── Utility helpers ──────────────────────────────────────────────────────────
+
+// SafeFilename sanitises a filename while preserving CJK (Chinese) characters.
+func SafeFilename(filename string) string {
+	if filename == "" {
+		return "unnamed_file"
+	}
+	var sb strings.Builder
+	for _, r := range filename {
+		switch {
+		case r >= 0x4E00 && r <= 0x9FFF: // CJK Unified Ideographs
+			sb.WriteRune(r)
+		case unicode.IsLetter(r) || unicode.IsDigit(r):
+			sb.WriteRune(r)
+		case r == '-' || r == '_' || r == '.' || r == ' ':
+			sb.WriteRune(r)
+		}
+	}
+	safe := strings.ReplaceAll(sb.String(), " ", "_")
+	safe = strings.Trim(safe, "._")
+	if safe == "" {
+		return "unnamed_file"
+	}
+	return safe
+}
+
+// UniqueFilename returns a filename that does not appear in existing.
+// If base already conflicts, it appends _1, _2, … until unique.
+func UniqueFilename(base string, existing []string) string {
+	set := make(map[string]bool, len(existing))
+	for _, f := range existing {
+		set[f] = true
+	}
+	if !set[base] {
+		return base
+	}
+	ext := filepath.Ext(base)
+	stem := strings.TrimSuffix(base, ext)
+	for i := 1; ; i++ {
+		name := fmt.Sprintf("%s_%d%s", stem, i, ext)
+		if !set[name] {
+			return name
+		}
+	}
+}
+
+// ContainsString reports whether slice s contains value v.
+func ContainsString(s []string, v string) bool {
+	for _, item := range s {
+		if item == v {
+			return true
+		}
+	}
+	return false
+}
+
+// RemoveString returns a copy of s with the first occurrence of v removed.
+func RemoveString(s []string, v string) []string {
+	out := make([]string, 0, len(s))
+	for _, item := range s {
+		if item != v {
+			out = append(out, item)
+		}
+	}
+	return out
+}
+
+// now returns the current local time in Python-compatible ISO8601 format.
+func now() string {
+	return time.Now().Format("2006-01-02T15:04:05.000000")
+}
--- a/SproutWorkCollect-Backend-Golang/main.go
+++ b/SproutWorkCollect-Backend-Golang/main.go
@@ -0,0 +1,24 @@
+package main
+
+import (
+	"fmt"
+	"log"
+
+	"sproutworkcollect-backend/internal/config"
+	"sproutworkcollect-backend/internal/router"
+)
+
+func main() {
+	cfg := config.Load()
+
+	r := router.Setup(cfg)
+
+	addr := fmt.Sprintf("0.0.0.0:%d", cfg.Port)
+	log.Printf("[SproutWorkCollect] 服务启动 → http://%s", addr)
+	log.Printf("[SproutWorkCollect] WorksDir  : %s", cfg.WorksDir)
+	log.Printf("[SproutWorkCollect] ConfigDir : %s", cfg.ConfigDir)
+
+	if err := r.Run(addr); err != nil {
+		log.Fatalf("服务启动失败: %v", err)
+	}
+}
--- a/SproutWorkCollect-Backend-Python/.dockerignore
+++ b/SproutWorkCollect-Backend-Python/.dockerignore
--- a/SproutWorkCollect-Backend-Python/Dockerfile
+++ b/SproutWorkCollect-Backend-Python/Dockerfile
@@ -3,6 +3,8 @@ FROM python:3.11-slim

 WORKDIR /app/backend

+ENV PYTHONUNBUFFERED=1
+
 # 安装系统依赖
 RUN apt-get update && apt-get install -y \
    gcc \
@@ -17,6 +19,9 @@ RUN pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua
 # 复制后端代码
 COPY . .

+# 默认数据目录（可在运行时通过挂载覆盖）
+RUN mkdir -p /data/works /data/config
+
 # 暴露端口
 EXPOSE 5000

--- a/SproutWorkCollect-Backend-Python/app.py
+++ b/SproutWorkCollect-Backend-Python/app.py
@@ -34,14 +34,39 @@ app.config['MAX_FORM_PARTS'] = 1000

 # 获取项目根目录
 BASE_DIR = os.path.dirname(os.path.abspath(__file__))
-# works 目录已移动到后端目录下
-WORKS_DIR = os.path.join(BASE_DIR, 'works')
-# config 目录已移动到前端目录下
-FRONTEND_DIR = os.path.abspath(os.path.join(BASE_DIR, '..', 'SmyWorkCollect-Frontend'))
-CONFIG_DIR = os.path.join(FRONTEND_DIR, 'config')

-# 管理员token
-ADMIN_TOKEN = "shumengya520"
+def _normalize_dir_path(path):
+    if not path:
+        return None
+
+    expanded = os.path.expandvars(os.path.expanduser(path))
+    return os.path.abspath(expanded)
+
+# 数据目录（用于 Docker 持久化）。
+# 推荐在容器内设置 SPROUTWORKCOLLECT_DATA_DIR=/data，并挂载宿主机目录到 /data
+DATA_DIR = _normalize_dir_path(
+    os.environ.get('SPROUTWORKCOLLECT_DATA_DIR') or os.environ.get('DATA_DIR')
+)
+
+DEFAULT_WORKS_DIR = os.path.join(DATA_DIR, 'works') if DATA_DIR else os.path.join(BASE_DIR, 'works')
+DEFAULT_CONFIG_DIR = os.path.join(DATA_DIR, 'config') if DATA_DIR else os.path.join(BASE_DIR, 'config')
+
+# works/config 目录（可分别覆盖）
+WORKS_DIR = (
+    _normalize_dir_path(os.environ.get('SPROUTWORKCOLLECT_WORKS_DIR') or os.environ.get('WORKS_DIR'))
+    or DEFAULT_WORKS_DIR
+)
+CONFIG_DIR = (
+    _normalize_dir_path(os.environ.get('SPROUTWORKCOLLECT_CONFIG_DIR') or os.environ.get('CONFIG_DIR'))
+    or DEFAULT_CONFIG_DIR
+)
+
+# 管理员 token（不要硬编码到仓库中；请通过环境变量配置）
+ADMIN_TOKEN = (
+    os.environ.get('SPROUTWORKCOLLECT_ADMIN_TOKEN')
+    or os.environ.get('ADMIN_TOKEN')
+    or ''
+).strip()

 # 允许的文件扩展名
 ALLOWED_EXTENSIONS = {'png', 'jpg', 'jpeg', 'gif', 'mp4', 'avi', 'mov', 'zip', 'rar', 'apk', 'exe', 'dmg'}
@@ -184,14 +209,17 @@ def load_settings():
            return json.load(f)
    except FileNotFoundError:
        return {
-            "网站名字": "树萌芽の作品集",
-            "网站描述": "展示我的创意作品和项目",
-            "站长": "树萌芽",
+            "网站名字": "✨ 树萌芽の作品集 ✨",
+            "网站描述": "🎨 展示个人制作的一些小创意和小项目，欢迎交流讨论 💬",
+            "站长": "👨‍💻 by-树萌芽",
            "联系邮箱": "3205788256@qq.com",
            "主题颜色": "#81c784",
-            "每页作品数量": 12,
+            "每页作品数量": 6,
            "启用搜索": True,
-            "启用分类": True
+            "启用分类": True,
+            "备案号": "📄 蜀ICP备2025151694号",
+            "网站页尾": "🌱 树萌芽の作品集 | Copyright © 2025-2025 smy ✨",
+            "网站logo": "assets/logo.png"
        }

 #加载单个作品配置
@@ -805,4 +833,6 @@ def admin_delete_file(work_id, file_type, filename):
        return jsonify({'success': False, 'message': f'删除失败: {str(e)}'}), 500

 if __name__ == '__main__':
-    app.run(debug=True, host='0.0.0.0', port=5000)
+    port = int(os.environ.get('PORT', '5000'))
+    debug = os.environ.get('FLASK_DEBUG', '').lower() in {'1', 'true', 'yes'}
+    app.run(debug=debug, host='0.0.0.0', port=port)
--- a/SproutWorkCollect-Backend-Python/docker-compose.yml
+++ b/SproutWorkCollect-Backend-Python/docker-compose.yml
@@ -0,0 +1,24 @@
+version: '3.8'
+
+services:
+  sproutworkcollect-api:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: sproutworkcollect-backend
+    restart: unless-stopped
+    ports:
+      - "${SPROUTWORKCOLLECT_PORT:-5000}:5000"
+    environment:
+      - PORT=5000
+      - SPROUTWORKCOLLECT_DATA_DIR=/data
+    volumes:
+      # 默认后端持久化路径：/shumengya/docker/sproutworkcollect/data/
+      - "${SPROUTWORKCOLLECT_DATA_PATH:-/shumengya/docker/sproutworkcollect/data}/works:/data/works"
+      - "${SPROUTWORKCOLLECT_DATA_PATH:-/shumengya/docker/sproutworkcollect/data}/config:/data/config"
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:5000/api/settings').read()"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
--- a/SproutWorkCollect-Backend-Python/requirements.txt
+++ b/SproutWorkCollect-Backend-Python/requirements.txt
--- a/SproutWorkCollect-Backend-Python/后端返回接口.json
+++ b/SproutWorkCollect-Backend-Python/后端返回接口.json
--- a/SproutWorkCollect-Frontend/Dockerfile
+++ b/SproutWorkCollect-Frontend/Dockerfile
--- a/SproutWorkCollect-Frontend/package-lock.json
+++ b/SproutWorkCollect-Frontend/package-lock.json
@@ -79,7 +79,6 @@
      "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.28.3.tgz",
      "integrity": "sha512-yDBHV9kQNcr2/sUr9jghVyz9C3Y5G2zUM2H2lo+9mKv4sFgbA8s8Z9t8D1jiTkGoO/NoIfKMyKWr4s6CN23ZwQ==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@ampproject/remapping": "^2.2.0",
        "@babel/code-frame": "^7.27.1",
@@ -729,7 +728,6 @@
      "resolved": "https://registry.npmjs.org/@babel/plugin-syntax-flow/-/plugin-syntax-flow-7.27.1.tgz",
      "integrity": "sha512-p9OkPbZ5G7UT1MofwYFigGebnrzGJacoBSQM0/6bi/PUMVE+qlWDD/OalvQKbwgQzU6dl0xAv6r4X7Jme0RYxA==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@babel/helper-plugin-utils": "^7.27.1"
      },
@@ -1613,7 +1611,6 @@
      "resolved": "https://registry.npmjs.org/@babel/plugin-transform-react-jsx/-/plugin-transform-react-jsx-7.27.1.tgz",
      "integrity": "sha512-2KH4LWGSrJIkVf5tSiBFYuXDAoWRq2MMwgivCf+93dd0GQi8RXLjKA/0EvRnVV5G0hrHczsquXuD01L8s6dmBw==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@babel/helper-annotate-as-pure": "^7.27.1",
        "@babel/helper-module-imports": "^7.27.1",
@@ -4587,7 +4584,8 @@
      "version": "15.7.15",
      "resolved": "https://registry.npmjs.org/@types/prop-types/-/prop-types-15.7.15.tgz",
      "integrity": "sha512-F6bEyamV9jKGAFBEmlQnesRPGOQqS2+Uwi0Em15xenOxHaf2hv6L8YCVn3rPdPJOiJfPiCnLIRyvwVaqMY3MIw==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
    },
    "node_modules/@types/q": {
      "version": "1.5.8",
@@ -4746,7 +4744,6 @@
      "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-5.62.0.tgz",
      "integrity": "sha512-TiZzBSJja/LbhNPvk6yc0JrX9XqhQ0hdh6M2svYfsHGejaKFIAGd9MQ+ERIMzLGlN/kZoYIgdxFV0PuljTKXag==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@eslint-community/regexpp": "^4.4.0",
        "@typescript-eslint/scope-manager": "5.62.0",
@@ -4800,7 +4797,6 @@
      "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-5.62.0.tgz",
      "integrity": "sha512-VlJEV0fOQ7BExOsHYAGrgbEiZoi8D+Bl2+f6V2RrXerRSylnp+ZBHmPvaIa8cz0Ajx7WO7Z5RqfgYg7ED1nRhA==",
      "license": "BSD-2-Clause",
-      "peer": true,
      "dependencies": {
        "@typescript-eslint/scope-manager": "5.62.0",
        "@typescript-eslint/types": "5.62.0",
@@ -5170,7 +5166,6 @@
      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
      "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
      "license": "MIT",
-      "peer": true,
      "bin": {
        "acorn": "bin/acorn"
      },
@@ -5269,7 +5264,6 @@
      "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
      "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "fast-deep-equal": "^3.1.1",
        "fast-json-stable-stringify": "^2.0.0",
@@ -6272,7 +6266,6 @@
        }
      ],
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "baseline-browser-mapping": "^2.8.25",
        "caniuse-lite": "^1.0.30001754",
@@ -7340,7 +7333,8 @@
      "version": "3.1.3",
      "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.3.tgz",
      "integrity": "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
    },
    "node_modules/damerau-levenshtein": {
      "version": "1.0.8",
@@ -8190,7 +8184,6 @@
      "integrity": "sha512-ypowyDxpVSYpkXr9WPv2PAZCtNip1Mv5KTW0SCurXv/9iOpcrH9PaqUElksqEB6pChqHGDRCFTyrZlGhnLNGiA==",
      "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@eslint-community/eslint-utils": "^4.2.0",
        "@eslint-community/regexpp": "^4.6.1",
@@ -11015,7 +11008,6 @@
      "resolved": "https://registry.npmjs.org/jest/-/jest-27.5.1.tgz",
      "integrity": "sha512-Yn0mADZB89zTtjkPJEXwrac3LHudkQMR+Paqa8uxJHCBr9agxztUifWCyiYrjhMPBoUVBjyny0I7XH6ozDr7QQ==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@jest/core": "^27.5.1",
        "import-local": "^3.0.2",
@@ -13664,7 +13656,6 @@
      "resolved": "https://registry.npmjs.org/jiti/-/jiti-1.21.7.tgz",
      "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
      "license": "MIT",
-      "peer": true,
      "bin": {
        "jiti": "bin/jiti.js"
      }
@@ -15055,7 +15046,6 @@
        }
      ],
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "nanoid": "^3.3.11",
        "picocolors": "^1.1.1",
@@ -16190,7 +16180,6 @@
      "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-6.1.2.tgz",
      "integrity": "sha512-Q8qQfPiZ+THO/3ZrOrO0cJJKfpYCagtMUkXbnEfmgUjwXg6z/WBeOyS9APBBPCTSiDV+s4SwQGu8yFsiMRIudg==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "cssesc": "^3.0.0",
        "util-deprecate": "^1.0.2"
@@ -16562,7 +16551,6 @@
      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "loose-envify": "^1.1.0"
      },
@@ -16713,7 +16701,6 @@
      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
      "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "loose-envify": "^1.1.0",
        "scheduler": "^0.23.2"
@@ -16732,14 +16719,14 @@
      "version": "19.1.1",
      "resolved": "https://registry.npmjs.org/react-is/-/react-is-19.1.1.tgz",
      "integrity": "sha512-tr41fA15Vn8p4X9ntI+yCyeGSf1TlYaY5vlTZfQmeLBrFo3psOPX6HhTDnFNL9uj3EhP0KAQ80cugCl4b4BERA==",
-      "license": "MIT"
+      "license": "MIT",
+      "peer": true
    },
    "node_modules/react-refresh": {
      "version": "0.11.0",
      "resolved": "https://registry.npmjs.org/react-refresh/-/react-refresh-0.11.0.tgz",
      "integrity": "sha512-F27qZr8uUqwhWZboondsPx8tnC3Ct3SxZA3V5WyEvujRyyNv0VYPhoBg1gZ8/MV5tubQp76Trw8lTv9hzRBa+A==",
      "license": "MIT",
-      "peer": true,
      "engines": {
        "node": ">=0.10.0"
      }
@@ -17230,7 +17217,6 @@
      "resolved": "https://registry.npmjs.org/rollup/-/rollup-2.79.2.tgz",
      "integrity": "sha512-fS6iqSPZDs3dr/y7Od6y5nha8dW1YnbgtsyotCVvoFGKbERG++CVRFv1meyGDE1SNItQA8BrnCw7ScdAhRJ3XQ==",
      "license": "MIT",
-      "peer": true,
      "bin": {
        "rollup": "dist/bin/rollup"
      },
@@ -17476,7 +17462,6 @@
      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
      "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "fast-deep-equal": "^3.1.3",
        "fast-uri": "^3.0.1",
@@ -18398,7 +18383,6 @@
      "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-5.3.11.tgz",
      "integrity": "sha512-uuzIIfnVkagcVHv9nE0VPlHPSCmXIUGKfJ42LNjxCCTDTL5sgnJ8Z7GZBq0EnLYGln77tPpEpExt2+qa+cZqSw==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@babel/helper-module-imports": "^7.0.0",
        "@babel/traverse": "^7.4.5",
@@ -19250,9 +19234,9 @@
      }
    },
    "node_modules/typescript": {
-      "version": "5.9.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
-      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "version": "4.9.5",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-4.9.5.tgz",
+      "integrity": "sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==",
      "license": "Apache-2.0",
      "peer": true,
      "bin": {
@@ -19260,7 +19244,7 @@
        "tsserver": "bin/tsserver"
      },
      "engines": {
-        "node": ">=14.17"
+        "node": ">=4.2.0"
      }
    },
    "node_modules/unbox-primitive": {
@@ -19575,7 +19559,6 @@
      "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.103.0.tgz",
      "integrity": "sha512-HU1JOuV1OavsZ+mfigY0j8d1TgQgbZ6M+J75zDkpEAwYeXjWSqrGJtgnPblJjd/mAyTNQ7ygw0MiKOn6etz8yw==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "@types/eslint-scope": "^3.7.7",
        "@types/estree": "^1.0.8",
@@ -20059,7 +20042,6 @@
      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
      "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
      "license": "MIT",
-      "peer": true,
      "dependencies": {
        "fast-deep-equal": "^3.1.3",
        "fast-uri": "^3.0.1",
--- a/SproutWorkCollect-Frontend/package.json
+++ b/SproutWorkCollect-Frontend/package.json
--- a/SproutWorkCollect-Frontend/public/.htaccess
+++ b/SproutWorkCollect-Frontend/public/.htaccess
--- a/SproutWorkCollect-Frontend/public/_redirects
+++ b/SproutWorkCollect-Frontend/public/_redirects
--- a/SproutWorkCollect-Frontend/public/assets/favicon.ico
+++ b/SproutWorkCollect-Frontend/public/assets/favicon.ico
--- a/SproutWorkCollect-Frontend/public/assets/logo.png
+++ b/SproutWorkCollect-Frontend/public/assets/logo.png
--- a/SproutWorkCollect-Frontend/public/index.html
+++ b/SproutWorkCollect-Frontend/public/index.html
@@ -2,7 +2,9 @@
 <html lang="zh-CN">
  <head>
    <meta charset="utf-8" />
-    <link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
+    <link rel="icon" type="image/png" href="%PUBLIC_URL%/assets/icon.png" />
+    <link rel="apple-touch-icon" href="%PUBLIC_URL%/assets/icon.png" />
+    <link rel="manifest" href="%PUBLIC_URL%/manifest.webmanifest" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="theme-color" content="#81c784" />
    <meta name="description" content="树萌芽の作品集 - 展示我的创意作品和项目" />
--- a/SproutWorkCollect-Frontend/public/manifest.webmanifest
+++ b/SproutWorkCollect-Frontend/public/manifest.webmanifest
@@ -0,0 +1,27 @@
+{
+  "name": "萌芽作品集",
+  "short_name": "萌芽作品集",
+  "lang": "zh-CN",
+  "start_url": ".",
+  "scope": ".",
+  "display": "standalone",
+  "orientation": "any",
+  "background_color": "#e8f5e9",
+  "theme_color": "#81c784",
+  "description": "展示个人制作的一些小创意和小项目，支持安装到桌面使用。",
+  "icons": [
+    {
+      "src": "/assets/icon.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any"
+    },
+    {
+      "src": "/assets/icon.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}
+
--- a/SproutWorkCollect-Frontend/src/App.js
+++ b/SproutWorkCollect-Frontend/src/App.js
@@ -11,20 +11,24 @@ import LoadingSpinner from './components/LoadingSpinner';
 import Footer from './components/Footer';
 import Pagination from './components/Pagination';
 import { getWorks, getSettings, getCategories, searchWorks } from './services/api';
+import { BACKGROUND_CONFIG, pickBackgroundImage } from './config/background';

 const AppContainer = styled.div`
  min-height: 100vh;
-  background: linear-gradient(
-    135deg,
-    rgba(232, 245, 232, 0.4) 0%,
-    rgba(200, 230, 201, 0.4) 20%,
-    rgba(165, 214, 167, 0.4) 40%,
-    rgba(255, 255, 224, 0.3) 60%,
-    rgba(255, 255, 200, 0.3) 80%,
-    rgba(240, 255, 240, 0.4) 100%
-  );
-  background-size: 400% 400%;
-  animation: gentleShift 25s ease infinite;
+  background: ${({ $backgroundUrl }) =>
+    $backgroundUrl
+      ? `url(${$backgroundUrl}) center/cover no-repeat fixed`
+      : `linear-gradient(
+          135deg,
+          rgba(232, 245, 232, 0.4) 0%,
+          rgba(200, 230, 201, 0.4) 20%,
+          rgba(165, 214, 167, 0.4) 40%,
+          rgba(255, 255, 224, 0.3) 60%,
+          rgba(255, 255, 200, 0.3) 80%,
+          rgba(240, 255, 240, 0.4) 100%
+        )`};
+  background-size: ${({ $backgroundUrl }) => ($backgroundUrl ? 'cover' : '400% 400%')};
+  animation: ${({ $backgroundUrl }) => ($backgroundUrl ? 'none' : 'gentleShift 25s ease infinite')};
  position: relative;
  
  &:before {
@@ -34,8 +38,9 @@ const AppContainer = styled.div`
    left: 0;
    width: 100%;
    height: 100%;
-    background: rgba(255, 255, 255, 0.3);
-    backdrop-filter: blur(1px);
+    background: ${({ $blurOverlayOpacity }) =>
+      `rgba(255, 255, 255, ${$blurOverlayOpacity})`};
+    backdrop-filter: ${({ $blurAmount }) => `blur(${$blurAmount})`};
    pointer-events: none;
    z-index: -1;
  }
@@ -54,7 +59,7 @@ const AppContainer = styled.div`
 `;

 const MainContent = styled.main`
-  max-width: 1200px;
+  max-width: 1440px;
  margin: 0 auto;
  padding: 20px;
  
@@ -65,9 +70,13 @@ const MainContent = styled.main`

 const WorksGrid = styled.div`
  display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
+  grid-template-columns: repeat(4, 1fr);
  gap: 20px;
  margin-top: 20px;
+
+  @media (max-width: 1024px) {
+    grid-template-columns: repeat(2, 1fr);
+  }
  
  @media (max-width: 768px) {
    grid-template-columns: 1fr;
@@ -105,8 +114,8 @@ const HomePage = ({ settings }) => {
  const [selectedCategory, setSelectedCategory] = useState('');
  const [currentPage, setCurrentPage] = useState(1);
  
-  // 从设置中获取每页作品数量，默认为9
-  const itemsPerPage = settings['每页作品数量'] || 9;
+  // 从设置中获取每页作品数量，默认12（三行四列）
+  const itemsPerPage = settings['每页作品数量'] || 12;

  useEffect(() => {
    loadInitialData();
@@ -214,11 +223,29 @@ const HomePage = ({ settings }) => {

 function App() {
  const [settings, setSettings] = useState({});
+  const [backgroundUrl, setBackgroundUrl] = useState(null);
+  const [blurConfig] = useState(BACKGROUND_CONFIG.blur || { enabled: true, amount: '6px', overlayOpacity: 0.35 });

  useEffect(() => {
    loadSettings();
  }, []);

+  // 将后端 settings.json 中的「网站名字」同步到浏览器标签页标题
+  useEffect(() => {
+    if (settings['网站名字']) {
+      document.title = settings['网站名字'];
+    }
+  }, [settings]);
+
+  // 页面初始化时，根据设备类型随机选择一张背景图
+  useEffect(() => {
+    const isMobile = window.innerWidth <= 768;
+    const url = pickBackgroundImage(isMobile);
+    if (url) {
+      setBackgroundUrl(url);
+    }
+  }, []);
+
  const loadSettings = async () => {
    try {
      const settingsData = await getSettings();
@@ -230,7 +257,11 @@ function App() {

  return (
    <Router>
-      <AppContainer>
+      <AppContainer
+        $backgroundUrl={backgroundUrl}
+        $blurAmount={blurConfig.enabled ? blurConfig.amount : '0px'}
+        $blurOverlayOpacity={blurConfig.enabled ? blurConfig.overlayOpacity : 0}
+      >
        <Header settings={settings} />
        <Routes>
          <Route path="/" element={<HomePage settings={settings} />} />
--- a/SproutWorkCollect-Frontend/src/components/AdminPanel.js
+++ b/SproutWorkCollect-Frontend/src/components/AdminPanel.js
@@ -3,7 +3,7 @@ import { useSearchParams, useNavigate } from 'react-router-dom';
 import styled from 'styled-components';
 import LoadingSpinner from './LoadingSpinner';
 import WorkEditor from './WorkEditor';
-import { setAdminToken, adminGetWorks, adminDeleteWork } from '../services/adminApi';
+import { setAdminToken, adminGetWorks, adminDeleteWork, getAdminToken } from '../services/adminApi';

 const AdminContainer = styled.div`
  max-width: 1200px;
@@ -180,13 +180,20 @@ const AdminPanel = () => {
  const [editingWork, setEditingWork] = useState(null);

  useEffect(() => {
-    const token = searchParams.get('token');
-    if (token !== 'shumengya520') {
+    const urlToken = searchParams.get('token');
+    const currentToken = getAdminToken();
+
+    // 如果没有 URL token 且也没有之前设置的 token，则认为未授权，返回首页
+    if (!urlToken && !currentToken) {
      navigate('/');
      return;
    }
-    
-    setAdminToken(token);
+
+    // URL 上有 token 时，更新全局 admin token
+    if (urlToken && urlToken !== currentToken) {
+      setAdminToken(urlToken);
+    }
+
    loadWorks();
  }, [searchParams, navigate]);

--- a/SproutWorkCollect-Frontend/src/components/CategoryFilter.js
+++ b/SproutWorkCollect-Frontend/src/components/CategoryFilter.js
@@ -1,5 +1,8 @@
 import React from 'react';
 import styled from 'styled-components';
+import { getGlassOpacity } from '../config/background';
+
+const glassOpacity = getGlassOpacity();

 const FilterContainer = styled.div`
  display: flex;
@@ -28,7 +31,7 @@ const FilterSelect = styled.select`
  border: 2px solid #e0e0e0;
  border-radius: 8px;
  font-size: 14px;
-  background: white;
+  background: rgba(255, 255, 255, ${glassOpacity});
  color: #333;
  outline: none;
  cursor: pointer;
--- a/SproutWorkCollect-Frontend/src/components/Footer.js
+++ b/SproutWorkCollect-Frontend/src/components/Footer.js
@@ -1,8 +1,13 @@
 import React from 'react';
 import styled from 'styled-components';
+import { getGlassOpacity } from '../config/background';
+
+const glassOpacity = getGlassOpacity();

 const FooterContainer = styled.footer`
-  background: linear-gradient(135deg, #66bb6a 0%, #81c784 30%, #a5d6a7 70%, #c8e6c9 100%);
+  /* 底部整体背景完全透明，仅保留内部内容样式 */
+  background: transparent;
+  background-color: transparent;
  color: #1b5e20;
  padding: 35px 0 25px;
  margin-top: 50px;
--- a/SproutWorkCollect-Frontend/src/components/Header.js
+++ b/SproutWorkCollect-Frontend/src/components/Header.js
@@ -1,9 +1,14 @@
-import React from 'react';
+import React, { useRef } from 'react';
 import styled from 'styled-components';
+import { getGlassOpacity } from '../config/background';
+import { setAdminToken, adminGetWorks } from '../services/adminApi';
+
+const glassOpacity = getGlassOpacity();

 const HeaderContainer = styled.header`
-  /* 头部容器背景渐变：从中绿色到浅绿色的4层渐变 */
-  background: linear-gradient(135deg,rgb(204, 252, 207) 0%,rgb(132, 206, 134) 30%,rgb(157, 216, 159) 70%,rgb(109, 177, 109) 100%);
+  /* 顶部整体背景完全透明，仅保留内部内容样式 */
+  background: transparent;
+  background-color: transparent;
  color: #1b5e20; /* 深绿色文字 */
  padding: 25px 0; /* 上下内边距 */
  box-shadow: 0 8px 32px rgba(27, 94, 32, 0.15); /* 深绿色阴影效果 */
@@ -102,6 +107,7 @@ const Logo = styled.img`
  border-radius: 12px; /* 圆角效果 */
  transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1); /* 平滑过渡动画 */
  filter: drop-shadow(0 2px 8px rgba(46, 93, 49, 0.15)); /* 投影效果 */
+  cursor: pointer;
  
  /* Logo悬停效果：放大并轻微旋转 */
  &:hover {
@@ -200,37 +206,73 @@ const Author = styled.p`
  }
 `;

+const DEFAULT_LOGO = `${process.env.PUBLIC_URL || ''}/assets/logo.png`;
+const DEFAULT_FAVICON = `${process.env.PUBLIC_URL || ''}/assets/icon.png`;
+
 const Header = ({ settings }) => {
-  // 动态设置favicon
+  // 隐藏入口：点击 Logo 5 次后触发管理员口令输入
+  const logoClickCountRef = useRef(0);
+  const lastClickTimeRef = useRef(0);
+
+  // 动态设置 favicon：优先使用后端配置的网站 logo，否则使用前端默认 icon
  React.useEffect(() => {
-    if (settings.网站logo) {
-      const favicon = document.querySelector('link[rel="icon"]');
-      if (favicon) {
-        favicon.href = settings.网站logo;
-      } else {
-        // 如果没有favicon链接，创建一个
-        const newFavicon = document.createElement('link');
-        newFavicon.rel = 'icon';
-        newFavicon.href = settings.网站logo;
-        document.head.appendChild(newFavicon);
-      }
+    const iconHref = settings.网站logo || DEFAULT_FAVICON;
+    const existing = document.querySelector('link[rel="icon"]');
+    if (existing) {
+      existing.href = iconHref;
+    } else {
+      const link = document.createElement('link');
+      link.rel = 'icon';
+      link.href = iconHref;
+      document.head.appendChild(link);
    }
  }, [settings.网站logo]);

+  const handleLogoSecretClick = () => {
+    const now = Date.now();
+    const interval = now - lastClickTimeRef.current;
+
+    // 超过 2 秒则重新计数，避免误触
+    if (interval > 2000) {
+      logoClickCountRef.current = 0;
+    }
+
+    lastClickTimeRef.current = now;
+    logoClickCountRef.current += 1;
+
+    if (logoClickCountRef.current >= 5) {
+      logoClickCountRef.current = 0;
+      const tokenInput = window.prompt('请输入管理员口令进入后台：');
+      if (!tokenInput) return;
+
+      const token = tokenInput.trim();
+      setAdminToken(token);
+
+      // 简单校验：尝试拉取一次后台作品列表
+      adminGetWorks()
+        .then(() => {
+          window.location.hash = '#/admin';
+        })
+        .catch(() => {
+          // eslint-disable-next-line no-alert
+          alert('口令错误或无权限，请重试。');
+        });
+    }
+  };
+
  return (
    <HeaderContainer>
      <HeaderContent>
-        {settings.网站logo && (
-          <LogoContainer>
-            <Logo 
-              src={settings.网站logo} 
-              alt={settings.网站名字 || '树萌芽の作品集'}
-              onError={(e) => {
-                e.target.style.display = 'none';
-              }}
-            />
-          </LogoContainer>
-        )}
+        <LogoContainer>
+          <Logo 
+            src={settings.网站logo || DEFAULT_LOGO} 
+            alt={settings.网站名字 || '树萌芽の作品集'}
+            onClick={handleLogoSecretClick}
+            onError={(e) => {
+              e.target.style.display = 'none';
+            }}
+          />
+        </LogoContainer>
        <Title>{settings.网站名字 || '树萌芽の作品集'}</Title>
        <Description>{settings.网站描述 || '展示我的创意作品和项目'}</Description>
        <Author>{settings.站长 || '树萌芽'}</Author>
--- a/SproutWorkCollect-Frontend/src/components/LoadingSpinner.js
+++ b/SproutWorkCollect-Frontend/src/components/LoadingSpinner.js
@@ -0,0 +1,150 @@
+import React from 'react';
+import styled, { keyframes } from 'styled-components';
+
+// 背景柔和脉冲动画（亮度轻微变化）
+const bgPulse = keyframes`
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.96; }
+`;
+
+// Logo 轻微上下浮动
+const float = keyframes`
+  0%, 100% { transform: translateY(0); }
+  50% { transform: translateY(-8px); }
+`;
+
+// 扩散圆环动画
+const ringPulse = keyframes`
+  0% {
+    transform: scale(0.8);
+    opacity: 0.6;
+  }
+  70% {
+    transform: scale(1.4);
+    opacity: 0;
+  }
+  100% {
+    transform: scale(1.4);
+    opacity: 0;
+  }
+`;
+
+// 底部三个圆点缩放动画
+const dotPulse = keyframes`
+  0%, 80%, 100% { transform: scale(0.6); opacity: 0.4; }
+  40% { transform: scale(1); opacity: 1; }
+`;
+
+const SplashWrapper = styled.div`
+  position: fixed;
+  inset: 0;
+  z-index: 9999;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: radial-gradient(circle at top left, rgba(232, 245, 233, 0.9), rgba(200, 230, 201, 0.9)),
+              radial-gradient(circle at bottom right, rgba(255, 255, 224, 0.8), rgba(240, 255, 240, 0.9));
+  animation: ${bgPulse} 6s ease-in-out infinite;
+`;
+
+const SplashInner = styled.div`
+  position: relative;
+  text-align: center;
+  padding: 32px 40px 28px;
+  border-radius: 24px;
+  background: rgba(255, 255, 255, 0.28);
+  box-shadow:
+    0 18px 45px rgba(129, 199, 132, 0.35),
+    0 0 40px rgba(129, 199, 132, 0.25);
+  backdrop-filter: blur(12px);
+`;
+
+const LogoWrapper = styled.div`
+  position: relative;
+  width: 112px;
+  height: 112px;
+  margin: 0 auto 18px;
+  border-radius: 28px;
+  background: radial-gradient(circle at 30% 20%, #ffffff, #e8f5e9);
+  box-shadow:
+    0 10px 26px rgba(67, 160, 71, 0.35),
+    0 0 25px rgba(129, 199, 132, 0.45);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  animation: ${float} 3s ease-in-out infinite;
+  overflow: hidden;
+`;
+
+const LogoImage = styled.img`
+  width: 76px;
+  height: 76px;
+  border-radius: 22px;
+  object-fit: cover;
+`;
+
+const Ring = styled.div`
+  position: absolute;
+  inset: 0;
+  border-radius: 999px;
+  border: 2px solid rgba(129, 199, 132, 0.7);
+  animation: ${ringPulse} 2.6s ease-out infinite;
+  animation-delay: ${({ $delay }) => $delay || '0s'};
+`;
+
+const Title = styled.h2`
+  font-size: 1.5rem;
+  font-weight: 700;
+  color: #2e7d32;
+  margin-bottom: 6px;
+  letter-spacing: 0.06em;
+  text-shadow: 0 2px 6px rgba(76, 175, 80, 0.35);
+`;
+
+const Subtitle = styled.p`
+  font-size: 0.95rem;
+  color: #4caf50;
+  margin-bottom: 16px;
+`;
+
+const Dots = styled.div`
+  display: flex;
+  justify-content: center;
+  gap: 8px;
+  margin-top: 2px;
+`;
+
+const Dot = styled.span`
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: #66bb6a;
+  animation: ${dotPulse} 1.4s ease-in-out infinite;
+  animation-delay: ${({ $delay }) => $delay || '0s'};
+`;
+
+const LOGO_SRC = `${process.env.PUBLIC_URL || ''}/assets/icon.png`;
+
+const LoadingSpinner = ({ text = '加载中...' }) => {
+  return (
+    <SplashWrapper>
+      <SplashInner>
+        <LogoWrapper>
+          <Ring $delay="0s" />
+          <Ring $delay="0.5s" />
+          <Ring $delay="1s" />
+          <LogoImage src={LOGO_SRC} alt="萌芽作品集 Logo" />
+        </LogoWrapper>
+        <Title>✨ 萌芽作品集 ✨</Title>
+        <Subtitle>{text}</Subtitle>
+        <Dots>
+          <Dot $delay="0s" />
+          <Dot $delay="0.15s" />
+          <Dot $delay="0.3s" />
+        </Dots>
+      </SplashInner>
+    </SplashWrapper>
+  );
+};
+
+export default LoadingSpinner;
--- a/SproutWorkCollect-Frontend/src/components/Pagination.js
+++ b/SproutWorkCollect-Frontend/src/components/Pagination.js
--- a/SproutWorkCollect-Frontend/src/components/SearchBar.js
+++ b/SproutWorkCollect-Frontend/src/components/SearchBar.js
@@ -1,5 +1,8 @@
 import React, { useState } from 'react';
 import styled from 'styled-components';
+import { getGlassOpacity } from '../config/background';
+
+const glassOpacity = getGlassOpacity();

 const SearchContainer = styled.div`
  position: relative;
@@ -19,7 +22,7 @@ const SearchInput = styled.input`
  font-size: 16px;
  outline: none;
  transition: all 0.3s ease;
-  background: white;
+  background: rgba(255, 255, 255, ${glassOpacity});
  
  &:focus {
    border-color: #81c784;
--- a/SproutWorkCollect-Frontend/src/components/UploadProgressModal.js
+++ b/SproutWorkCollect-Frontend/src/components/UploadProgressModal.js
--- a/SproutWorkCollect-Frontend/src/components/WorkCard.js
+++ b/SproutWorkCollect-Frontend/src/components/WorkCard.js
@@ -1,20 +1,13 @@
 import React from 'react';
 import { useNavigate } from 'react-router-dom';
 import styled from 'styled-components';
+import { getApiOrigin } from '../config/apiBase';
+import { getGlassOpacity } from '../config/background';

-// 获取API基础URL
-const getApiBaseUrl = () => {
-  if (process.env.REACT_APP_API_URL) {
-    return process.env.REACT_APP_API_URL.replace('/api', '');
-  }
-  if (process.env.NODE_ENV === 'production') {
-    return '';
-  }
-  return 'http://localhost:5000';
-};
+const glassOpacity = getGlassOpacity();

 const Card = styled.div`
-  background: linear-gradient(145deg, rgba(255, 255, 255, 0.95), rgba(248, 255, 248, 0.95));
+  background: linear-gradient(145deg, rgba(255, 255, 255, ${0.7 + glassOpacity * 0.3}), rgba(248, 255, 248, ${0.7 + glassOpacity * 0.3}));
  border-radius: 15px;
  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
  overflow: hidden;
@@ -170,7 +163,7 @@ const WorkCard = ({ work }) => {
    if (work.作品封面 && work.图片链接) {
      const coverIndex = work.作品截图?.indexOf(work.作品封面);
      if (coverIndex >= 0 && work.图片链接[coverIndex]) {
-        return `${getApiBaseUrl()}${work.图片链接[coverIndex]}`;
+        return `${getApiOrigin()}${work.图片链接[coverIndex]}`;
      }
    }
    return null;
@@ -258,4 +251,4 @@ const WorkCard = ({ work }) => {
  );
 };

-export default WorkCard;
+export default WorkCard;
--- a/SproutWorkCollect-Frontend/src/components/WorkDetail.js
+++ b/SproutWorkCollect-Frontend/src/components/WorkDetail.js
@@ -3,17 +3,7 @@ import { useParams, useNavigate } from 'react-router-dom';
 import styled from 'styled-components';
 import LoadingSpinner from './LoadingSpinner';
 import { getWorkDetail, likeWork } from '../services/api';
-
-// 获取API基础URL
-const getApiBaseUrl = () => {
-  if (process.env.REACT_APP_API_URL) {
-    return process.env.REACT_APP_API_URL.replace('/api', '');
-  }
-  if (process.env.NODE_ENV === 'production') {
-    return '';
-  }
-  return 'http://localhost:5000';
-};
+import { getApiOrigin } from '../config/apiBase';

 const DetailContainer = styled.div`
  max-width: 1000px;
@@ -557,7 +547,7 @@ const WorkDetail = () => {
  // 打开图片模态框
  const handleImageClick = (imageUrl, index) => {
    setModalType('image');
-    setModalSrc(`${getApiBaseUrl()}${imageUrl}`);
+    setModalSrc(`${getApiOrigin()}${imageUrl}`);
    setModalTitle(`${work.作品作品} - 截图 ${index + 1}`);
    setModalOpen(true);
  };
@@ -565,7 +555,7 @@ const WorkDetail = () => {
  // 打开视频模态框
  const handleVideoClick = (videoUrl, index) => {
    setModalType('video');
-    setModalSrc(`${getApiBaseUrl()}${videoUrl}`);
+    setModalSrc(`${getApiOrigin()}${videoUrl}`);
    setModalTitle(`${work.作品作品} - 视频 ${index + 1}`);
    setModalOpen(true);
  };
@@ -772,7 +762,7 @@ const WorkDetail = () => {
                onClick={() => handleVideoClick(videoUrl, index)}
                style={{ cursor: 'pointer' }}
              >
-                <source src={`${getApiBaseUrl()}${videoUrl}`} type="video/mp4" />
+                <source src={`${getApiOrigin()}${videoUrl}`} type="video/mp4" />
                您的浏览器不支持视频播放
              </VideoPlayer>
            </VideoContainer>
@@ -780,28 +770,55 @@ const WorkDetail = () => {
        </ContentSection>
      )}

-      {work.下载链接 && Object.keys(work.下载链接).length > 0 && (
+      {(work.下载资源 && Object.keys(work.下载资源).length > 0) && (
        <ContentSection>
          <SectionTitle>📦 下载作品</SectionTitle>
          <DownloadSection>
-            {Object.entries(work.下载链接).map(([platform, links]) => (
+            {Object.entries(work.下载资源).map(([platform, resources]) => (
              <PlatformDownload key={platform}>
                <PlatformTitle>{platform}</PlatformTitle>
-                {links.map((link, index) => (
-                  <DownloadButton 
-                    key={index}
-                    href={`${getApiBaseUrl()}${link}`}
-                    download
-                  >
-                    📥 下载 {platform} 版本
-                  </DownloadButton>
-                ))}
+                {resources.map((res, index) => {
+                  const isExternal = res.类型 === 'external';
+                  const href = isExternal ? res.链接 : `${getApiOrigin()}${res.链接}`;
+                  return (
+                    <DownloadButton
+                      key={index}
+                      href={href}
+                      target={isExternal ? '_blank' : undefined}
+                      rel={isExternal ? 'noreferrer' : undefined}
+                      download={isExternal ? undefined : true}
+                    >
+                      📥 {res.别名 || `下载 ${platform} 版本`}
+                    </DownloadButton>
+                  );
+                })}
              </PlatformDownload>
            ))}
          </DownloadSection>
        </ContentSection>
      )}

+      {/* 兼容旧后端：仅返回“下载链接”时依旧可用 */}
+      {(!work.下载资源 || Object.keys(work.下载资源).length === 0) &&
+        work.下载链接 &&
+        Object.keys(work.下载链接).length > 0 && (
+          <ContentSection>
+            <SectionTitle>📦 下载作品</SectionTitle>
+            <DownloadSection>
+              {Object.entries(work.下载链接).map(([platform, links]) => (
+                <PlatformDownload key={platform}>
+                  <PlatformTitle>{platform}</PlatformTitle>
+                  {links.map((link, index) => (
+                    <DownloadButton key={index} href={`${getApiOrigin()}${link}`} download>
+                      📥 下载 {platform} 版本
+                    </DownloadButton>
+                  ))}
+                </PlatformDownload>
+              ))}
+            </DownloadSection>
+          </ContentSection>
+        )}
+
      {work.图片链接 && work.图片链接.length > 0 && (
        <ContentSection>
          <SectionTitle>🖼️ 作品截图</SectionTitle>
@@ -809,7 +826,7 @@ const WorkDetail = () => {
            {work.图片链接.map((imageUrl, index) => (
              <WorkImage
                key={index}
-                src={`${getApiBaseUrl()}${imageUrl}`}
+                src={`${getApiOrigin()}${imageUrl}`}
                alt={`${work.作品作品} 截图 ${index + 1}`}
                onClick={() => handleImageClick(imageUrl, index)}
                onError={(e) => {
--- a/SproutWorkCollect-Frontend/src/components/WorkEditor.js
+++ b/SproutWorkCollect-Frontend/src/components/WorkEditor.js
@@ -2,17 +2,7 @@ import React, { useState, useEffect } from 'react';
 import styled from 'styled-components';
 import { adminCreateWork, adminUpdateWork, adminUploadFile, adminDeleteFile } from '../services/adminApi';
 import UploadProgressModal from './UploadProgressModal';
-
-// 获取API基础URL
-const getApiBaseUrl = () => {
-  if (process.env.REACT_APP_API_URL) {
-    return process.env.REACT_APP_API_URL.replace('/api', '');
-  }
-  if (process.env.NODE_ENV === 'production') {
-    return '';
-  }
-  return 'http://localhost:5000';
-};
+import { getApiOrigin } from '../config/apiBase';

 const EditorContainer = styled.div`
  max-width: 1000px;
@@ -94,6 +84,29 @@ const Button = styled.button`
  }
 `;

+const SmallButton = styled.button`
+  background: ${props => {
+    if (props.variant === 'danger') return '#f44336';
+    if (props.variant === 'secondary') return '#757575';
+    return '#81c784';
+  }};
+  color: white;
+  border: none;
+  padding: 6px 12px;
+  border-radius: 6px;
+  cursor: pointer;
+  font-size: 12px;
+  transition: background 0.3s ease;
+
+  &:hover {
+    background: ${props => {
+      if (props.variant === 'danger') return '#d32f2f';
+      if (props.variant === 'secondary') return '#616161';
+      return '#66bb6a';
+    }};
+  }
+`;
+
 const FormSection = styled.div`
  background: white;
  border-radius: 15px;
@@ -369,6 +382,66 @@ const SuccessMessage = styled.div`
  margin-bottom: 20px;
 `;

+const ExternalLinksContainer = styled.div`
+  margin-top: 15px;
+  text-align: left;
+`;
+
+const ExternalLinkRow = styled.div`
+  display: grid;
+  grid-template-columns: 1fr 2fr auto;
+  gap: 10px;
+  align-items: center;
+  margin-top: 10px;
+
+  @media (max-width: 768px) {
+    grid-template-columns: 1fr;
+  }
+`;
+
+const ExternalLinksList = styled.div`
+  margin-top: 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+`;
+
+const ExternalLinkItem = styled.div`
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 10px 12px;
+  border: 1px solid #e0e0e0;
+  border-radius: 8px;
+  background: #fafafa;
+  gap: 10px;
+`;
+
+const ExternalLinkText = styled.div`
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  min-width: 0;
+`;
+
+const ExternalAlias = styled.div`
+  font-weight: 600;
+  color: #2e7d32;
+`;
+
+const ExternalUrl = styled.a`
+  color: #666;
+  font-size: 0.85rem;
+  text-decoration: none;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+
+  &:hover {
+    text-decoration: underline;
+  }
+`;
+


 const WorkEditor = ({ work, onClose }) => {
@@ -384,7 +457,8 @@ const WorkEditor = ({ work, onClose }) => {
    作品截图: [],
    作品视频: [],
    作品封面: '',
-    文件名称: {}
+    文件名称: {},
+    外部下载: {}
  });

  const [newTag, setNewTag] = useState('');
@@ -394,6 +468,7 @@ const WorkEditor = ({ work, onClose }) => {
  const [uploadItems, setUploadItems] = useState({});
  const [uploading, setUploading] = useState(false);
  const [showUploadModal, setShowUploadModal] = useState(false);
+  const [newExternalLinks, setNewExternalLinks] = useState({});

  const platforms = ['Windows', 'Android', 'Linux', 'iOS', 'macOS'];
  const categories = ['游戏', '工具', '应用', '网站', '其他'];
@@ -406,7 +481,8 @@ const WorkEditor = ({ work, onClose }) => {
        支持平台: work.支持平台 || [],
        作品截图: work.作品截图 || [],
        作品视频: work.作品视频 || [],
-        文件名称: work.文件名称 || {}
+        文件名称: work.文件名称 || {},
+        外部下载: work.外部下载 || {}
      });
    }
  }, [work]);
@@ -443,9 +519,53 @@ const WorkEditor = ({ work, onClose }) => {
      const newFileNames = { ...formData.文件名称 };
      delete newFileNames[platform];
      handleInputChange('文件名称', newFileNames);
+
+      // 移除该平台的外部下载
+      const newExternal = { ...(formData.外部下载 || {}) };
+      delete newExternal[platform];
+      handleInputChange('外部下载', newExternal);
    }
  };

+  const updateNewExternal = (platform, field, value) => {
+    setNewExternalLinks(prev => ({
+      ...prev,
+      [platform]: {
+        ...(prev[platform] || { 别名: '', 链接: '' }),
+        [field]: value,
+      }
+    }));
+  };
+
+  const handleAddExternalLink = (platform) => {
+    const draft = newExternalLinks[platform] || {};
+    const alias = (draft.别名 || '').trim();
+    const url = (draft.链接 || '').trim();
+    if (!url) {
+      setError('外部下载链接不能为空');
+      return;
+    }
+
+    const list = Array.isArray(formData.外部下载?.[platform]) ? formData.外部下载[platform] : [];
+    const next = { ...(formData.外部下载 || {}) };
+    next[platform] = [...list, { 别名: alias || '外部下载', 链接: url }];
+    handleInputChange('外部下载', next);
+
+    setNewExternalLinks(prev => ({
+      ...prev,
+      [platform]: { 别名: '', 链接: '' }
+    }));
+    setSuccess(`已添加 ${platform} 外部下载链接`);
+  };
+
+  const handleDeleteExternalLink = (platform, index) => {
+    const list = Array.isArray(formData.外部下载?.[platform]) ? formData.外部下载[platform] : [];
+    const next = { ...(formData.外部下载 || {}) };
+    next[platform] = list.filter((_, i) => i !== index);
+    handleInputChange('外部下载', next);
+    setSuccess(`已删除 ${platform} 外部下载链接`);
+  };
+
  const handleFileUpload = async (files, fileType, platform = null) => {
    if (!formData.作品ID) {
      setError('请先保存作品基本信息后再上传文件');
@@ -847,7 +967,7 @@ const WorkEditor = ({ work, onClose }) => {
                        ×
                      </FileDeleteButton>
                      <FilePreview
-                        src={`${getApiBaseUrl()}/api/image/${formData.作品ID}/${image}`}
+                        src={`${getApiOrigin()}/api/image/${formData.作品ID}/${image}`}
                        alt={image}
                        onError={(e) => {
                          e.target.style.display = 'none';
@@ -978,6 +1098,59 @@ const WorkEditor = ({ work, onClose }) => {
                  ))}
                </FileList>
              )}
+
+              {/* 外部下载链接（带别名） */}
+              <ExternalLinksContainer>
+                <h4 style={{ marginTop: '18px', marginBottom: '8px', color: '#2e7d32' }}>
+                  其他地址下载（外部链接）
+                </h4>
+                <p style={{ fontSize: '0.85rem', color: '#666', marginBottom: '8px' }}>
+                  可为 {platform} 配置多个外部下载地址（网盘/商店/直链等），并设置显示别名。
+                </p>
+
+                <ExternalLinkRow>
+                  <Input
+                    type="text"
+                    value={(newExternalLinks[platform]?.别名) || ''}
+                    onChange={(e) => updateNewExternal(platform, '别名', e.target.value)}
+                    placeholder="别名（例如：夸克网盘 / GitHub Releases）"
+                  />
+                  <Input
+                    type="url"
+                    value={(newExternalLinks[platform]?.链接) || ''}
+                    onChange={(e) => updateNewExternal(platform, '链接', e.target.value)}
+                    placeholder="外部下载链接（https://...）"
+                  />
+                  <Button
+                    onClick={() => handleAddExternalLink(platform)}
+                    disabled={loading || uploading}
+                    style={{ whiteSpace: 'nowrap' }}
+                  >
+                    + 添加
+                  </Button>
+                </ExternalLinkRow>
+
+                {Array.isArray(formData.外部下载?.[platform]) && formData.外部下载[platform].length > 0 && (
+                  <ExternalLinksList>
+                    {formData.外部下载[platform].map((item, idx) => (
+                      <ExternalLinkItem key={idx}>
+                        <ExternalLinkText>
+                          <ExternalAlias>{item.别名 || '外部下载'}</ExternalAlias>
+                          <ExternalUrl href={item.链接} target="_blank" rel="noreferrer">
+                            {item.链接}
+                          </ExternalUrl>
+                        </ExternalLinkText>
+                        <SmallButton
+                          variant="danger"
+                          onClick={() => handleDeleteExternalLink(platform, idx)}
+                        >
+                          删除
+                        </SmallButton>
+                      </ExternalLinkItem>
+                    ))}
+                  </ExternalLinksList>
+                )}
+              </ExternalLinksContainer>
            </FormSection>
          ))}
        </>
--- a/SproutWorkCollect-Frontend/src/config/apiBase.js
+++ b/SproutWorkCollect-Frontend/src/config/apiBase.js
@@ -0,0 +1,38 @@
+const DEFAULT_PROD_API_ORIGIN = 'https://work.api.shumengya.top';
+
+const stripTrailingSlashes = (value) => value.replace(/\/+$/, '');
+
+const stripApiSuffix = (value) => value.replace(/\/api\/?$/, '');
+
+const hasHttpProtocol = (value) => /^https?:\/\//i.test(value);
+
+export const getApiBaseUrl = () => {
+  const envUrl = process.env.REACT_APP_API_URL;
+  if (envUrl) {
+    const normalized = stripTrailingSlashes(envUrl);
+
+    // 避免生产环境错误使用相对路径（例如 /api），导致请求打到前端自身域名
+    if (normalized.startsWith('/')) {
+      if (process.env.NODE_ENV === 'production') {
+        // eslint-disable-next-line no-console
+        console.warn(
+          `[SproutWorkCollect] REACT_APP_API_URL=${normalized} 是相对路径，已忽略并回退到默认后端：${DEFAULT_PROD_API_ORIGIN}/api`,
+        );
+        return `${DEFAULT_PROD_API_ORIGIN}/api`;
+      }
+
+      return normalized.endsWith('/api') ? normalized : `${normalized}/api`;
+    }
+
+    const absolute = hasHttpProtocol(normalized) ? normalized : `https://${normalized}`;
+    return absolute.endsWith('/api') ? absolute : `${absolute}/api`;
+  }
+
+  if (process.env.NODE_ENV === 'production') {
+    return `${DEFAULT_PROD_API_ORIGIN}/api`;
+  }
+
+  return 'http://localhost:5000/api';
+};
+
+export const getApiOrigin = () => stripApiSuffix(getApiBaseUrl());
--- a/SproutWorkCollect-Frontend/src/config/background.js
+++ b/SproutWorkCollect-Frontend/src/config/background.js
@@ -0,0 +1,59 @@
+// 网站背景图配置（前端可配，不需要改代码）。
+// - 手机端用 mobileImages，电脑端用 desktopImages（按视口宽度 768px 区分）
+// - blur.enabled 控制是否启用高斯模糊遮罩
+// - blur.amount 是模糊强度，建议 4px～10px
+// - blur.overlayOpacity 是白色蒙层透明度，0~1，建议 0.2～0.5
+
+const mobileImages = [
+  'https://image.smyhub.com/file/手机壁纸/女生/1772108123232_VJ86r.jpg',
+  'https://image.smyhub.com/file/手机壁纸/女生/1772108022800_f945774e0a45f7a4afdc3da2b112025f.png',
+  'https://image.smyhub.com/file/手机壁纸/女生/1772108024006_3f9030ba77e355869115bc90fe019d53.png',
+  'https://image.smyhub.com/file/手机壁纸/女生/1772108030393_159bbf61f88b38475ee9144a2e8e4956.png',
+  'https://image.smyhub.com/file/手机壁纸/女生/1772108021977_8020902a0c8788538eee1cd06e784c6a.png',
+  'https://image.smyhub.com/file/手机壁纸/女生/1772108021881_44374ab6c1daa54e0204bca48ac382f2.png',
+];
+
+const desktopImages = [
+  'https://image.smyhub.com/file/电脑壁纸/女生/cuSpSkq4.webp',
+  'https://image.smyhub.com/file/电脑壁纸/女生/5CrdoShv.webp',
+  'https://image.smyhub.com/file/电脑壁纸/女生/xTsVkCli.webp',
+  'https://image.smyhub.com/file/电脑壁纸/女生/ItOJOHST.webp',
+  'https://image.smyhub.com/file/电脑壁纸/女生/cUDkKiOf.webp',
+  'https://image.smyhub.com/file/电脑壁纸/女生/c2HxMuGK.webp',
+  'https://image.smyhub.com/file/电脑壁纸/女生/L0nQHehz.webp',
+  'https://image.smyhub.com/file/电脑壁纸/女生/hj64Cqxn.webp',
+];
+
+// 内容区块（搜索框、分类块、内容卡片、顶栏和底栏）的半透明背景透明度，0=全透明 1=不透明，可自行修改
+window.SITE_GLASS_OPACITY = 0.3;
+
+export const getGlassOpacity = () => {
+  if (typeof window !== 'undefined' && typeof window.SITE_GLASS_OPACITY === 'number') {
+    return window.SITE_GLASS_OPACITY;
+  }
+  return 0.3;
+};
+
+export const BACKGROUND_CONFIG = {
+  mobileImages,
+  desktopImages,
+  blur: {
+    enabled: true,
+    amount: '6px',
+    overlayOpacity: 0.35,
+  },
+};
+
+export const pickBackgroundImage = (isMobile) => {
+  const list = isMobile ? BACKGROUND_CONFIG.mobileImages : BACKGROUND_CONFIG.desktopImages;
+  if (!Array.isArray(list) || list.length === 0) return null;
+  const index = Math.floor(Math.random() * list.length);
+  return list[index];
+};
+
+// 同时挂到 window 上，方便在控制台调试或以后用纯 script 标签引入时访问。
+if (typeof window !== 'undefined') {
+  window.SITE_MOBILE_BACKGROUND_IMAGES = mobileImages;
+  window.SITE_DESKTOP_BACKGROUND_IMAGES = desktopImages;
+  window.SITE_BACKGROUND_BLUR = BACKGROUND_CONFIG.blur;
+}
--- a/SproutWorkCollect-Frontend/src/index.js
+++ b/SproutWorkCollect-Frontend/src/index.js
@@ -1,10 +1,14 @@
 import React from 'react';
 import ReactDOM from 'react-dom/client';
 import App from './App';
+import { registerServiceWorker } from './serviceWorkerRegistration';

 const root = ReactDOM.createRoot(document.getElementById('root'));
 root.render(
  <React.StrictMode>
    <App />
  </React.StrictMode>
-);
+);
+
+// 注册自定义 Service Worker，使应用具备 PWA 能力
+registerServiceWorker();
--- a/SproutWorkCollect-Frontend/src/service-worker.js
+++ b/SproutWorkCollect-Frontend/src/service-worker.js
@@ -0,0 +1,60 @@
+/* eslint-disable no-restricted-globals */
+/* 简易 PWA Service Worker（兼容 CRA 的 Workbox 注入机制）：
+ * - 使用 Workbox 预缓存构建产物（precacheAndRoute(self.__WB_MANIFEST)）
+ * - 额外对首页等关键路径做手动预缓存
+ * - 对同源的 GET 请求走 cache-first 策略
+ */
+
+import { precacheAndRoute } from 'workbox-precaching';
+
+// 由 react-scripts 在构建时注入实际的资源清单
+precacheAndRoute(self.__WB_MANIFEST || []);
+
+const CACHE_NAME = 'sproutworkcollect-cache-v1';
+const PRECACHE_URLS = ['/', '/index.html'];
+
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => cache.addAll(PRECACHE_URLS)),
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((keys) =>
+      Promise.all(
+        keys.map((key) => {
+          if (key !== CACHE_NAME) {
+            return caches.delete(key);
+          }
+          return null;
+        }),
+      ),
+    ),
+  );
+  self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+  const { request } = event;
+
+  // 只对 GET 请求、同源请求做缓存处理，其它直接放行
+  if (request.method !== 'GET' || new URL(request.url).origin !== self.location.origin) {
+    return;
+  }
+
+  event.respondWith(
+    caches.match(request).then((cached) => {
+      if (cached) {
+        return cached;
+      }
+      return fetch(request).then((response) => {
+        const responseClone = response.clone();
+        caches.open(CACHE_NAME).then((cache) => cache.put(request, responseClone));
+        return response;
+      });
+    }),
+  );
+});
+
--- a/SproutWorkCollect-Frontend/src/serviceWorkerRegistration.js
+++ b/SproutWorkCollect-Frontend/src/serviceWorkerRegistration.js
@@ -0,0 +1,16 @@
+// 在浏览器加载完成后注册自定义 Service Worker，使应用成为 PWA。
+// 生产环境和开发环境都可以注册，方便本地调试。
+
+export function registerServiceWorker() {
+  if ('serviceWorker' in navigator) {
+    window.addEventListener('load', () => {
+      navigator.serviceWorker
+        .register('/service-worker.js')
+        .catch((error) => {
+          // eslint-disable-next-line no-console
+          console.error('[PWA] Service Worker 注册失败:', error);
+        });
+    });
+  }
+}
+
--- a/SproutWorkCollect-Frontend/src/services/adminApi.js
+++ b/SproutWorkCollect-Frontend/src/services/adminApi.js
@@ -1,23 +1,5 @@
 import axios from 'axios';
-
-// 配置API基础URL
-const getApiBaseUrl = () => {
-  // 如果设置了环境变量，优先使用
-  if (process.env.REACT_APP_API_URL) {
-    return process.env.REACT_APP_API_URL;
-  }
-  
-  // 生产环境使用相对路径（需要代理）或绝对路径
-  if (process.env.NODE_ENV === 'production') {
-    // 如果前后端部署在同一域名下，使用相对路径
-    return '/api';
-    // 如果后端部署在不同地址，请修改为后端的完整URL
-    // return 'http://your-backend-domain.com:5000/api';
-  }
-  
-  // 开发环境使用localhost
-  return 'http://localhost:5000/api';
-};
+import { getApiBaseUrl } from '../config/apiBase';

 const API_BASE_URL = getApiBaseUrl();

@@ -26,6 +8,28 @@ const adminApi = axios.create({
  timeout: 30000,
 });

+adminApi.interceptors.response.use(
+  (response) => {
+    const contentType = response?.headers?.['content-type'] || '';
+    if (typeof response.data === 'string') {
+      const trimmed = response.data.trim().toLowerCase();
+      const looksLikeHtml =
+        contentType.includes('text/html') ||
+        trimmed.startsWith('<!doctype') ||
+        trimmed.startsWith('<html');
+
+      if (looksLikeHtml) {
+        throw new Error(
+          `API 返回了 HTML（疑似请求打到了前端自身域名/SPA重写），请检查 Cloudflare Pages 环境变量 REACT_APP_API_URL。当前 baseURL: ${API_BASE_URL}`
+        );
+      }
+    }
+
+    return response;
+  },
+  (error) => Promise.reject(error)
+);
+
 // 管理员token
 let adminToken = null;

--- a/SproutWorkCollect-Frontend/src/services/api.js
+++ b/SproutWorkCollect-Frontend/src/services/api.js
@@ -1,23 +1,5 @@
 import axios from 'axios';
-
-// 配置API基础URL
-const getApiBaseUrl = () => {
-  // 如果设置了环境变量，优先使用
-  if (process.env.REACT_APP_API_URL) {
-    return process.env.REACT_APP_API_URL;
-  }
-  
-  // 生产环境使用相对路径（需要代理）或绝对路径
-  if (process.env.NODE_ENV === 'production') {
-    // 如果前后端部署在同一域名下，使用相对路径
-    return '/api';
-    // 如果后端部署在不同地址，请修改为后端的完整URL
-    // return 'http://your-backend-domain.com:5000/api';
-  }
-  
-  // 开发环境使用localhost
-  return 'http://localhost:5000/api';
-};
+import { getApiBaseUrl } from '../config/apiBase';

 const API_BASE_URL = getApiBaseUrl();

@@ -26,6 +8,28 @@ const api = axios.create({
  timeout: 10000,
 });

+api.interceptors.response.use(
+  (response) => {
+    const contentType = response?.headers?.['content-type'] || '';
+    if (typeof response.data === 'string') {
+      const trimmed = response.data.trim().toLowerCase();
+      const looksLikeHtml =
+        contentType.includes('text/html') ||
+        trimmed.startsWith('<!doctype') ||
+        trimmed.startsWith('<html');
+
+      if (looksLikeHtml) {
+        throw new Error(
+          `API 返回了 HTML（疑似请求打到了前端自身域名/SPA重写），请检查 Cloudflare Pages 环境变量 REACT_APP_API_URL。当前 baseURL: ${API_BASE_URL}`
+        );
+      }
+    }
+
+    return response;
+  },
+  (error) => Promise.reject(error)
+);
+
 // 获取网站设置
 export const getSettings = async () => {
  const response = await api.get('/settings');
--- a/SproutWorkCollect-Frontend/test/background.css
+++ b/SproutWorkCollect-Frontend/test/background.css
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,26 +0,0 @@
-version: '3.8'
-
-services:
-  smywork-app:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    container_name: smywork-app
-    restart: unless-stopped
-    ports:
-      - "8383:8383"
-    environment:
-      - FLASK_ENV=production
-      - PYTHONUNBUFFERED=1
-    volumes:
-      # 持久化数据目录（根据你的要求统一为 /shumengya/docker/smyworkcollect/data/）
-      - /shumengya/docker/smyworkcollect/data/works:/app/backend/works
-      - /shumengya/docker/smyworkcollect/data/config:/app/SmyWorkCollect-Frontend/config
-      # 可选：持久化 Nginx 日志
-      - /shumengya/docker/smyworkcollect/data/logs:/var/log/nginx
-    healthcheck:
-      test: ["CMD-SHELL", "curl -sSf http://localhost:8383 >/dev/null"]
-      interval: 30s
-      timeout: 10s
-      retries: 3
-      start_period: 40s
--- a/supervisord.conf
+++ b/supervisord.conf
@@ -1,20 +0,0 @@
-[supervisord]
-nodaemon=true
-logfile=/var/log/supervisor/supervisord.log
-pidfile=/var/run/supervisord.pid
-
-[program:gunicorn]
-command=gunicorn -w 2 -b 0.0.0.0:5000 app:app
-user=root
-directory=/app/backend
-autostart=true
-autorestart=true
-stdout_logfile=/var/log/supervisor/gunicorn.log
-stderr_logfile=/var/log/supervisor/gunicorn_err.log
-
-[program:nginx]
-command=/usr/sbin/nginx -g "daemon off;"
-autostart=true
-autorestart=true
-stdout_logfile=/var/log/supervisor/nginx.log
-stderr_logfile=/var/log/supervisor/nginx_err.log
Author	SHA1	Message	Date
shumengya	19d647c9e1	feat(frontend): support external downloads	2026-03-13 17:19:01 +08:00
shumengya	46afd3149f	feat: add SproutWorkCollect apps	2026-03-13 17:14:37 +08:00
树萌芽	189baa3d59	重构后端技术栈和一些小修改	2026-03-13 17:06:09 +08:00
				`@@ -1 +0,0 @@`
				`REACT_APP_API_URL=https://work.api.shumengya.top/api`