feat: Establish WebUI build process, update frontend assets, and add CI workflow.

.github/PULL_REQUEST_TEMPLATE.md

@@ -17,4 +17,8 @@
 
 #### 📝 补充信息 | Additional Information
 
-<!-- Add any other context about the Pull Request here. -->
+<!-- Add any other context about the Pull Request here. -->
+
+---
+
+> 💡 **提示**：如果修改了 `webui/` 目录下的文件，PR 合并后 CI 会自动构建并提交产物，无需手动构建。

.github/workflows/build-webui.yml

@@ -0,0 +1,76 @@
+# 自动构建 WebUI 并提交构建产物
+# 触发条件：webui 目录下的文件变更
+
+name: Build WebUI
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'webui/**'
+      - '.github/workflows/build-webui.yml'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'webui/**'
+  # 允许手动触发
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    
+    # 只在主仓库运行，避免 fork 仓库运行
+    if: github.repository == 'CJackHwang/ds2api'
+    
+    permissions:
+      contents: write
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: webui/package-lock.json
+      
+      - name: Install dependencies
+        working-directory: webui
+        run: npm ci
+      
+      - name: Build WebUI
+        working-directory: webui
+        run: npm run build
+      
+      - name: Check for changes
+        id: check_changes
+        run: |
+          git add static/admin
+          if git diff --staged --quiet; then
+            echo "changed=false" >> $GITHUB_OUTPUT
+          else
+            echo "changed=true" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Commit and push changes
+        if: steps.check_changes.outputs.changed == 'true' && github.event_name == 'push'
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git commit -m "chore: auto-build WebUI [skip ci]"
+          git push
+      
+      - name: Upload build artifacts (for PR review)
+        if: github.event_name == 'pull_request'
+        uses: actions/upload-artifact@v4
+        with:
+          name: webui-build
+          path: static/admin
+          retention-days: 7

.gitignore

@@ -55,7 +55,8 @@ webui/node_modules/
 webui/dist/
 .npm
 .pnpm-store/
-package-lock.json
+# 保留 webui/package-lock.json 用于 CI 缓存
+# package-lock.json  # 如果有根目录的可以忽略
 yarn.lock
 pnpm-lock.yaml
 

CONTRIBUTING.md

@@ -0,0 +1,90 @@
+# 贡献指南
+
+感谢你对 DS2API 的贡献！
+
+## 开发环境设置
+
+### 后端
+
+```bash
+# 1. 克隆仓库
+git clone https://github.com/CJackHwang/ds2api.git
+cd ds2api
+
+# 2. 创建虚拟环境（推荐）
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+
+# 3. 安装依赖
+pip install -r requirements.txt
+
+# 4. 配置
+cp config.example.json config.json
+# 编辑 config.json
+
+# 5. 启动
+python dev.py
+```
+
+### 前端 (WebUI)
+
+```bash
+cd webui
+npm install
+npm run dev
+```
+
+## 代码规范
+
+- **Python**: 遵循 PEP 8，使用 4 空格缩进
+- **JavaScript/React**: 使用 4 空格缩进，使用函数组件
+- **提交信息**: 使用语义化提交格式（如 `feat:`, `fix:`, `docs:`）
+
+## 提交 PR
+
+1. Fork 本仓库
+2. 创建功能分支 (`git checkout -b feature/xxx`)
+3. 提交更改 (`git commit -m 'feat: 添加xxx功能'`)
+4. 推送分支 (`git push origin feature/xxx`)
+5. 创建 Pull Request
+
+## WebUI 构建
+
+> **重要**: 修改 `webui/` 目录后 **无需手动构建**！
+
+当 PR 合并到 `main` 分支后，GitHub Actions 会自动：
+1. 构建 WebUI
+2. 提交构建产物到 `static/admin/`
+
+如果需要本地构建（测试用）：
+```bash
+./scripts/build-webui.sh
+```
+
+## 项目结构
+
+```
+ds2api/
+├── app.py              # FastAPI 应用入口
+├── dev.py              # 开发服务器
+├── core/               # 核心模块
+│   ├── auth.py         # 账号认证与轮询
+│   ├── config.py       # 配置管理
+│   ├── deepseek.py     # DeepSeek API 调用
+│   ├── models.py       # 模型定义
+│   ├── pow.py          # PoW 计算
+│   └── sse_parser.py   # SSE 解析
+├── routes/             # API 路由
+│   ├── openai.py       # OpenAI 兼容接口
+│   ├── claude.py       # Claude 兼容接口
+│   ├── home.py         # 首页路由
+│   └── admin/          # 管理接口
+├── webui/              # React WebUI 源码
+├── static/admin/       # WebUI 构建产物（自动生成）
+└── scripts/            # 辅助脚本
+```
+
+## 问题反馈
+
+- 使用 [GitHub Issues](https://github.com/CJackHwang/ds2api/issues) 报告问题
+- 提供详细的复现步骤和日志信息

DEPLOY.md

@@ -125,6 +125,27 @@ npm run dev
 
 WebUI 开发服务器会启动在 `http://localhost:5173`，并自动代理 API 请求到后端 `http://localhost:5001`。
 
+### WebUI 构建
+
+WebUI 构建产物位于 `static/admin/` 目录。
+
+**自动构建（推荐）**：
+- 当 `webui/` 目录下的文件变更并推送到 `main` 分支时，GitHub Actions 会自动构建并提交产物
+- PR 合并时会自动触发构建
+
+**手动构建**：
+```bash
+# 方式1：使用脚本
+./scripts/build-webui.sh
+
+# 方式2：直接执行
+cd webui
+npm install
+npm run build
+```
+
+> **贡献者注意**：修改 WebUI 后无需手动构建，CI 会自动处理。
+
 ---
 
 ## 生产环境部署

scripts/build-webui.sh

@@ -0,0 +1,22 @@
+#!/bin/bash
+# WebUI 构建脚本
+# 用法: ./scripts/build-webui.sh
+
+set -e
+
+echo "🔨 Building WebUI..."
+
+cd "$(dirname "$0")/../webui"
+
+# 检查 node_modules
+if [ ! -d "node_modules" ]; then
+    echo "📦 Installing dependencies..."
+    npm install
+fi
+
+# 构建
+echo "🏗️  Running build..."
+npm run build
+
+echo "✅ WebUI built successfully!"
+echo "📁 Output: static/admin/"

static/admin/index.html

@@ -32,8 +32,8 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@100..900&display=swap" rel="stylesheet">
-  <script type="module" crossorigin src="/admin/assets/index-Da8PBvaf.js"></script>
-  <link rel="stylesheet" crossorigin href="/admin/assets/index-BzdNSWuo.css">
+  <script type="module" crossorigin src="/admin/assets/index-C7aw1GYL.js"></script>
+  <link rel="stylesheet" crossorigin href="/admin/assets/index-D9_KYhGM.css">
 </head>
 
 <body>