Merge branch 'Anionex:main' into main

Author: ShellMonster

.env.example

@@ -7,15 +7,19 @@ AI_PROVIDER_FORMAT=gemini
 GOOGLE_API_KEY=your-api-key-here
 # 代理示例: https://aihubmix.com/gemini
 GOOGLE_API_BASE=https://generativelanguage.googleapis.com
+# GenAI (Gemini) 超时时间（秒），默认300秒
+GENAI_TIMEOUT=300.0
+# GenAI (Gemini) 最大重试次数（应用层实现），默认2次
+GENAI_MAX_RETRIES=2
 
 # OpenAI 格式配置（当 AI_PROVIDER_FORMAT=openai 时使用）
 OPENAI_API_KEY=your-api-key-here
 # 代理示例: https://aihubmix.com/v1
 OPENAI_API_BASE=https://api.openai.com/v1
-# 超时时间，默认60s
-OPENAI_TIMEOUT=60.0
-# 最多重试次数，默认3次
-OPENAI_MAX_RETRIES=3
+# 超时时间（秒），默认300秒
+OPENAI_TIMEOUT=300.0
+# 最多重试次数，减少重试避免累积超时，默认2次
+OPENAI_MAX_RETRIES=2
 
 # AI 模型配置
 TEXT_MODEL=gemini-3-flash-preview
@@ -42,6 +46,9 @@ MINERU_API_BASE=https://mineru.net
 # 图片识别模型配置（用于为解析文件中的图片生成描述）
 IMAGE_CAPTION_MODEL=gemini-3-flash-preview
 
+# 可编辑导出服务配置
+BAIDU_OCR_API_KEY=you-baidu-api-key
+
 # 输出语言配置
 # 可选值: 'zh' (中文), 'ja' (日本語), 'en' (English), 'auto' (自动)
 OUTPUT_LANGUAGE=zh

.githooks/pre-commit

@@ -0,0 +1,60 @@
+#!/bin/bash
+# Pre-commit hook: 自动翻译README.md到README_EN.md
+# 只有在README.md被修改时才会触发
+
+set -e
+
+# 检查README.md是否在本次提交中被修改
+if git diff --cached --name-only | grep -q "^README\.md$"; then
+    echo "检测到README.md变更，正在自动翻译到README_EN.md..."
+    
+    # 检查是否在项目根目录
+    if [ ! -f "README.md" ]; then
+        echo "错误: 未找到README.md"
+        exit 1
+    fi
+    
+    # 检查.env文件
+    if [ ! -f ".env" ]; then
+        echo "警告: 未找到.env文件，跳过翻译"
+        echo "如需自动翻译，请确保.env文件包含必要的API密钥配置"
+        exit 0
+    fi
+    
+    # 加载环境变量
+    set -a
+    source .env 2>/dev/null || true
+    set +a
+    
+    # 检查必要的环境变量
+    if [ -z "$GOOGLE_API_KEY" ]; then
+        echo "警告: GOOGLE_API_KEY未设置，跳过翻译"
+        echo "如需自动翻译，请在.env文件中设置GOOGLE_API_KEY"
+        exit 0
+    fi
+    
+    # 检查uv是否可用
+    if ! command -v uv &> /dev/null; then
+        echo "警告: uv未安装，跳过翻译"
+        exit 0
+    fi
+    
+    # 运行翻译脚本
+    echo "开始翻译..."
+    if uv run python scripts/translate_readme.py; then
+        echo "✅ 翻译成功！"
+        
+        # 将翻译后的README_EN.md添加到本次提交
+        git add README_EN.md
+        echo "README_EN.md已自动添加到本次提交"
+    else
+        echo "❌ 翻译失败，但不阻止提交"
+        echo "你可以稍后手动运行: ./scripts/test_translation.sh"
+        # 不阻止提交，允许继续
+        exit 0
+    fi
+else
+    # README.md未修改，无需翻译
+    exit 0
+fi
+

.github/workflows/ci-test.yml

@@ -2,6 +2,7 @@ name: Full Test Suite
 
 # Full tests run in these cases:
 # 1. Push to main/develop branch (direct push, not from PR merge)
+#    - 仅当代码文件变更时触发（排除 *.md 文件）
 # 2. PR labeled with ready-for-test
 # 3. Manual trigger (workflow_dispatch)
 #
@@ -10,6 +11,8 @@ name: Full Test Suite
 on:
   push:
     branches: [ main, develop ]
+    paths-ignore:
+      - '**/*.md'
   pull_request:
     types: [labeled]
     branches: [ main, develop ]
@@ -294,21 +297,45 @@ jobs:
           # Now uv is available in PATH
           uv sync --extra test
       
-      - name: Run Backend API Integration tests (requires running service)
+      # NOTE: API Full Flow test is commented out because UI E2E test covers the same flow
+      # UI E2E test is more comprehensive as it tests:
+      # - Frontend UI interactions
+      # - Template selection modal
+      # - Single card retry functionality
+      # - Complete user experience
+      # 
+      # If you need quick API validation without AI, use test_quick_api_flow_no_ai instead
+      # - name: Run Backend API Integration tests (requires running service)
+      #   if: steps.check_e2e.outputs.skip != 'true' && env.GOOGLE_API_KEY != '' && env.GOOGLE_API_KEY != 'mock-api-key-for-testing'
+      #   run: |
+      #     # Source cargo env to access uv
+      #     . "$HOME/.cargo/env"
+      #     
+      #     # Run API integration tests that require real running backend service
+      #     echo "Running Backend API integration tests with real service (Gemini format)"
+      #     cd backend
+      #     uv run pytest tests/integration/test_api_full_flow.py::TestAPIFullFlow::test_api_full_flow_create_to_export -v -m "integration and requires_service"
+      #   env:
+      #     # Ensure API key is not logged
+      #     GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
+      #     SKIP_SERVICE_TESTS: false
+      #   timeout-minutes: 15
+      #   continue-on-error: false
+      
+      - name: Run Quick API test (no AI, fast validation)
         if: steps.check_e2e.outputs.skip != 'true' && env.GOOGLE_API_KEY != '' && env.GOOGLE_API_KEY != 'mock-api-key-for-testing'
         run: |
           # Source cargo env to access uv
           . "$HOME/.cargo/env"
           
-          # Run API integration tests that require real running backend service
-          echo "Running Backend API integration tests with real service (Gemini format)"
+          # Run quick API test that only validates endpoints (no AI generation)
+          echo "Running quick Backend API test (no AI generation, fast feedback)"
           cd backend
-          uv run pytest tests/integration/test_api_full_flow.py -v -m "integration and requires_service"
+          uv run pytest tests/integration/test_api_full_flow.py::TestAPIFullFlow::test_quick_api_flow_no_ai -v -m "requires_service"
         env:
-          # Ensure API key is not logged
           GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
           SKIP_SERVICE_TESTS: false
-        timeout-minutes: 15
+        timeout-minutes: 5
         continue-on-error: false
 
       - name: Run Frontend UI E2E tests

.github/workflows/docker-publish.yml

@@ -0,0 +1,110 @@
+name: Build and Push to Docker Hub
+
+# 在测试通过后自动构建并推送镜像到 Docker Hub
+
+# 触发条件：
+# 1. CI workflow (Full Test Suite) 成功完成后（主要触发方式）
+# 2. 手动触发（workflow_dispatch）
+on:
+  workflow_run:
+    workflows: ["Full Test Suite"]
+    types:
+      - completed
+    branches:
+      - main
+  workflow_dispatch:  # 允许手动触发
+
+# Cancel old builds on the same branch
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-and-push:
+    name: Build and Push Docker Images
+    runs-on: ubuntu-latest
+    # 如果是 workflow_run 触发，只在前一个 workflow 成功时运行
+    # 手动触发时总是运行
+    if: |
+      github.event_name == 'workflow_dispatch' ||
+      (github.event_name == 'workflow_run' && github.event.workflow_run.conclusion == 'success')
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          # 如果是 workflow_run 触发，使用原始 workflow 的 commit SHA
+          ref: ${{ github.event.workflow_run.head_sha || github.sha }}
+          fetch-depth: 0
+      
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+      
+      - name: Extract metadata for backend
+        id: meta-backend
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ secrets.DOCKERHUB_USERNAME }}/banana-slides-backend
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha
+            type=raw,value=latest,enable={{is_default_branch}}
+      
+      - name: Extract metadata for frontend
+        id: meta-frontend
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ secrets.DOCKERHUB_USERNAME }}/banana-slides-frontend
+          tags: |
+            type=ref,event=branch
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha
+            type=raw,value=latest,enable={{is_default_branch}}
+      
+      - name: Build and push backend image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./backend/Dockerfile
+          push: true
+          tags: ${{ steps.meta-backend.outputs.tags }}
+          labels: ${{ steps.meta-backend.outputs.labels }}
+          cache-from: type=registry,ref=${{ secrets.DOCKERHUB_USERNAME }}/banana-slides-backend:buildcache
+          cache-to: type=registry,ref=${{ secrets.DOCKERHUB_USERNAME }}/banana-slides-backend:buildcache,mode=max
+          build-args: |
+            DOCKER_REGISTRY=${{ secrets.DOCKER_REGISTRY }}
+            GHCR_REGISTRY=${{ secrets.GHCR_REGISTRY || 'ghcr.io/' }}
+            APT_MIRROR=${{ secrets.APT_MIRROR }}
+            PYPI_INDEX_URL=${{ secrets.PYPI_INDEX_URL }}
+      
+      - name: Build and push frontend image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: ./frontend/Dockerfile
+          push: true
+          tags: ${{ steps.meta-frontend.outputs.tags }}
+          labels: ${{ steps.meta-frontend.outputs.labels }}
+          cache-from: type=registry,ref=${{ secrets.DOCKERHUB_USERNAME }}/banana-slides-frontend:buildcache
+          cache-to: type=registry,ref=${{ secrets.DOCKERHUB_USERNAME }}/banana-slides-frontend:buildcache,mode=max
+          build-args: |
+            DOCKER_BUILDKIT=1
+            VITE_API_BASE_URL=${{ secrets.VITE_API_BASE_URL }}
+            DOCKER_REGISTRY=${{ secrets.DOCKER_REGISTRY }}
+            NPM_REGISTRY=${{ secrets.NPM_REGISTRY }}
+      
+      - name: Image digest
+        run: |
+          echo "Backend image: ${{ steps.meta-backend.outputs.tags }}"
+          echo "Frontend image: ${{ steps.meta-frontend.outputs.tags }}"
+          echo "✅ Images pushed to Docker Hub successfully!"
+

.gitignore

@@ -34,11 +34,14 @@
 
 # 忽略临时文档，但保留项目文档
 *.md
-!README*.md
-!docs/**/*.md
+!README.md
+# !docs/**/*.md
 !.github/**/*.md
 *.pyc
 .env
+
+# GCP 服务账户文件（包含敏感私钥）
+gcp-service-account.json
 *.ppt
 *.pptx
 generate-example.py
@@ -49,4 +52,6 @@ uploads/
 !assets/*
 
 # 镜像源配置脚本的备份文件
-*.orig
+*.orig
+# 本地备份目录（保存测试文件等）
+_local_backup/