bump version to 1.8.1

fix: 封面设计 720p 预览与导出
- loadBackground 居中改用 canvas.width/height，适配动态分辨率 - renderCover 修改 Canvas 内部尺寸后重设 CSS 预览尺寸，避免 overflow:hidden 裁剪内容 - 恢复 CoverDesign.tsx exportPng() 无参调用，匹配 hook 签名
2026-06-06 12:34:40 +08:00 · 2026-06-05 18:47:42 +08:00 · 2026-06-05 17:43:28 +08:00 · 2026-06-05 17:26:30 +08:00 · 2026-06-05 11:30:52 +08:00 · 2026-06-05 11:17:40 +08:00
284 changed files with 16323 additions and 4612 deletions
@@ -10,19 +10,23 @@ on:
        description: '版本号 (例如 1.5.16)'
        required: true
        type: string
-      environment:
-        description: '构建环境'
+      platform:
+        description: '构建平台'
        required: true
        type: choice
        options:
-          - test
-          - prod
-        default: test
+          - all
+          - macos
+          - windows
+        default: all

 jobs:
  build-macos:
    name: Build macOS (Universal)
+    if: ${{ github.event_name == 'push' || inputs.platform == 'all' || inputs.platform == 'macos' }}
    runs-on: macos-latest
+    permissions:
+      contents: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4
@@ -37,10 +41,25 @@ jobs:
        with:
          targets: x86_64-apple-darwin,aarch64-apple-darwin

+      - name: Cache Rust dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            tauri-app/src-tauri/target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('tauri-app/src-tauri/Cargo.lock') }}
+
+      - name: Cache Node dependencies
+        uses: actions/cache@v4
+        with:
+          path: tauri-app/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('tauri-app/package-lock.json') }}
+
      - name: Download sidecar binaries
        run: |
          mkdir -p tauri-app/src-tauri/binaries
-          gh release download v0.0.0-sidecar --repo fun0/meijiaka-zy --pattern "sidecar-binaries.tar.gz" --dir /tmp
+          gh release download v0.0.0-sidecar --repo ${{ github.repository }} --pattern "sidecar-binaries.tar.gz" --dir /tmp
          tar xzf /tmp/sidecar-binaries.tar.gz -C tauri-app/src-tauri/binaries/
          chmod +x tauri-app/src-tauri/binaries/ffmpeg-* tauri-app/src-tauri/binaries/ffprobe-*
          # Create universal binary for macOS universal-apple-darwin target
@@ -62,11 +81,22 @@ jobs:
        working-directory: tauri-app
        run: npm ci

+      - name: Update version
+        run: |
+          if [ -n "${{ inputs.version }}" ]; then
+            VERSION="${{ inputs.version }}"
+          else
+            VERSION="${GITHUB_REF_NAME#v}"
+          fi
+          perl -pi -e "s/\"version\"\s*:\s*\"[^\"]*\"/\"version\": \"$VERSION\"/" tauri-app/src-tauri/tauri.conf.json
+          perl -pi -e "s/^version = \"[^\"]*\"/version = \"$VERSION\"/" tauri-app/src-tauri/Cargo.toml
+          echo "Version updated to: $VERSION"
+
      - name: Build macOS Universal
        working-directory: tauri-app
        run: npm run tauri -- build --target universal-apple-darwin
        env:
-          VITE_API_BASE_URL: ${{ inputs.environment == 'prod' && 'https://tapi.meijiaka.cn/api/v1' || 'https://dev.tapi.meijiaka.cn/api/v1' }}
+          VITE_API_BASE_URL: https://dev.tapi.meijiaka.cn/api/v1
          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}

@@ -76,11 +106,25 @@ jobs:
          name: macos-universal
          path: |
            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
-            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app
+            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz
+            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz.sig
+          retention-days: 3
+
+      - name: Upload to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          files: |
+            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
+            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz
+            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz.sig

  build-windows:
    name: Build Windows (x64)
+    if: ${{ github.event_name == 'push' || inputs.platform == 'all' || inputs.platform == 'windows' }}
    runs-on: windows-latest
+    permissions:
+      contents: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4
@@ -95,12 +139,28 @@ jobs:
        with:
          targets: x86_64-pc-windows-msvc

+      - name: Cache Rust dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            tauri-app/src-tauri/target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('tauri-app/src-tauri/Cargo.lock') }}
+
+      - name: Cache Node dependencies
+        uses: actions/cache@v4
+        with:
+          path: tauri-app/node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('tauri-app/package-lock.json') }}
+
      - name: Download sidecar binaries
        shell: pwsh
        run: |
          New-Item -ItemType Directory -Force -Path tauri-app/src-tauri/binaries
-          gh release download v0.0.0-sidecar --repo fun0/meijiaka-zy --pattern "sidecar-binaries.tar.gz" --dir $env:TEMP
+          gh release download v0.0.0-sidecar --repo ${{ github.repository }} --pattern "sidecar-binaries.tar.gz" --dir $env:TEMP
          tar xzf "$env:TEMP\sidecar-binaries.tar.gz" -C tauri-app/src-tauri/binaries/
+          Get-ChildItem tauri-app/src-tauri/binaries/
        env:
          GH_TOKEN: ${{ github.token }}

@@ -108,12 +168,24 @@ jobs:
        working-directory: tauri-app
        run: npm ci

+      - name: Update version
+        shell: pwsh
+        run: |
+          $version = if ("${{ inputs.version }}") { "${{ inputs.version }}" } else { $env:GITHUB_REF_NAME -replace '^v', '' }
+          $content = Get-Content tauri-app/src-tauri/tauri.conf.json -Raw
+          $content = $content -replace '"version"\s*:\s*"[^"]*"', "`"version`": `"$version`""
+          Set-Content tauri-app/src-tauri/tauri.conf.json -Value $content
+          $cargo = Get-Content tauri-app/src-tauri/Cargo.toml -Raw
+          $cargo = $cargo -replace '^version = "[^"]*"', "version = `"$version`""
+          Set-Content tauri-app/src-tauri/Cargo.toml -Value $cargo
+          Write-Host "Version updated to: $version"
+
      - name: Build Windows x64
        working-directory: tauri-app
        shell: pwsh
        run: npm run tauri -- build --target x86_64-pc-windows-msvc
        env:
-          VITE_API_BASE_URL: ${{ inputs.environment == 'prod' && 'https://tapi.meijiaka.cn/api/v1' || 'https://dev.tapi.meijiaka.cn/api/v1' }}
+          VITE_API_BASE_URL: https://dev.tapi.meijiaka.cn/api/v1
          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}

@@ -123,3 +195,16 @@ jobs:
          name: windows-x64
          path: |
            tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe
+            tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe.sig
+            tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*-setup.exe
+          retention-days: 3
+
+      - name: Upload to GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          files: |
+            tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe
+            tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe.sig
+            tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*-setup.exe
+
@@ -12,6 +12,8 @@ __pycache__/
 # IDE
 .vscode/
 .idea/
+.cursor/
+.claude/

 # Logs
 *.log
@@ -22,5 +24,12 @@ __pycache__/
 test_kick.sh
 .playwright-mcp/
 *.seed_materials_cache.json
+.qiniu_pythonsdk_hostscache.json
 tauri-app/src-tauri/binaries/*
 .tauri-signing-key
+*.key
+*test*.key*
+.atomcode/
+mixkit_bgm/
+*.exe
+*.exe.sig
@@ -80,8 +80,9 @@ build-frontend-macos:
    paths:
      # DMG 安装包 (推荐用户下载)
      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
-      # .app bundle (供进一步分发或公证使用)
-      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app
+      # Updater 专用包 + 签名
+      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz
+      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz.sig
    expire_in: "${ARTIFACT_EXPIRE_DAYS} days"
  timeout: 45 minutes
  retry:
@@ -114,8 +115,11 @@ build-frontend-windows:
  artifacts:
    name: "meijiaka-windows-${CI_COMMIT_REF_NAME}-${CI_COMMIT_SHORT_SHA}"
    paths:
-      # NSIS 安装包 (推荐用户下载)
+      # Updater 专用包 + 签名
      - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe
+      - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe.sig
+      # NSIS 安装包 (推荐用户下载)
+      - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*-setup.exe
      # MSI 安装包 (企业部署场景)
      - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/msi/*.msi
    expire_in: "${ARTIFACT_EXPIRE_DAYS} days"
@@ -9,7 +9,7 @@
 **美家卡智影**是一款面向桌面端的 AI 视频创作应用，采用"Python 后端 API + Tauri 桌面前端"的混合架构。

 - **产品标识**: `cn.meijiaka.ai-video` / `cn.meijiaka.ai-zy`
- **版本**: `1.5.18`
+- **版本**: `1.8.1`
 - **核心功能**: AI 脚本生成、AI 配音合成（TTS）、声音复刻、视频生成（Vidu）、视频字幕生成、压制成片（FFmpeg）、项目本地持久化

 ### 技术栈总览
@@ -1,245 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## 项目概述
-
-**美家卡智影** - AI 视频创作桌面应用，采用 Python FastAPI 后端 + Tauri (Rust + React) 前端的混合架构。
-
-**核心功能**: AI 脚本生成、TTS 语音合成、声音克隆、对口型 (Vidu)、字幕生成、视频合成、项目本地持久化
-
-## 项目结构
-
-```
-.
-├── python-api/          # Python 后端 API (FastAPI)
-├── tauri-app/           # Tauri 桌面前端 (Rust + React 19)
-├── docs/                # 架构文档
-└── AGENTS.md            # AI Agent 专用详细文档
-```
-
-### 后端 (python-api/)
-
-```
-python-api/
-├── app/
-│   ├── api/v1/          # API 路由 (按领域拆分: auth, script, voice, vidu, caption, tasks, upload, materials, system)
-│   ├── core/            # 核心工具 (配置、异常、Redis、健康检查)
-│   ├── db/              # 数据库配置 (SQLAlchemy 2.0 async)
-│   ├── models/          # ORM 模型 (BaseModel: UUID 主键 + 时间戳)
-│   ├── schemas/         # Pydantic Schema (请求/响应校验)
-│   ├── services/        # 业务逻辑层
-│   ├── scheduler/       # Async Engine 异步任务调度
-│   ├── ai/              # AI 模型封装 (providers, adapters, gateways)
-│   └── platform_gateway.py  # 第三方平台统一调用网关
-├── config/              # 运行时配置 (platform-config.yaml, materials.json)
-├── alembic/             # 数据库迁移
-└── Makefile             # 开发命令
-```
-
-### 前端 (tauri-app/)
-
-```
-tauri-app/
-├── src/
-│   ├── api/
-│   │   ├── client.ts    # 智能路由客户端 (HTTP/IPC 自动选择, camelCase ↔ snake_case)
-│   │   ├── modules/     # 按领域拆分的 API 模块
-│   │   └── generated/   # OpenAPI 生成类型
-│   ├── components/      # 可复用组件 (PascalCase 文件夹)
-│   ├── pages/           # 页面组件 (PascalCase 文件夹)
-│   ├── store/           # Zustand 状态管理
-│   ├── hooks/           # 自定义 Hooks
-│   └── styles/          # CSS 变量与全局样式
-├── src-tauri/src/
-│   ├── commands/        # Tauri IPC 命令 (按领域拆分)
-│   ├── storage/         # 本地存储引擎
-│   ├── ffmpeg_cmd.rs    # FFmpeg 命令封装
-│   └── lib.rs           # Tauri Builder、Command 定义
-└── package.json
-```
-
-## 混合通信架构
-
-1. **纯数据 API** (脚本、TTS、字幕、视频生成、任务查询等) → 前端通过 **HTTP 直连 Python 后端**
-   - 使用 `tauri-app/src/api/client.ts` 的 `client.get/post/put/delete`
-   - 异步任务统一走 `POST /tasks/{task_type}` + 轮询 `/tasks/{task_id}`
-
-2. **本地系统能力** (FFmpeg 合成、文件系统、项目持久化) → 走 **Tauri IPC → Rust 层**
-   - 使用 `invoke()` 调用 `src-tauri/src/commands/` 中的 `#[tauri::command]`
-   - 命令参数用 `snake_case`，前端用 `camelCase`，通过 `#[serde(rename_all = "camelCase")]` 转换
-
-**新增纯数据 API 时**: 只需在 `tauri-app/src/api/modules/` 使用 `client` 调用，无需修改 Rust 代码。
-
-**新增本地能力时**: 在 `src-tauri/src/commands/` 添加 `#[tauri::command]`，并在 `lib.rs` 的 `invoke_handler` 中注册。
-
-## 常用命令
-
-### 后端 (cd python-api)
-
-```bash
-# 安装依赖
-make dev
-
-# 启动服务 (需两个终端)
-make run              # FastAPI 开发服务器 (8000)
-make scheduler        # Async Engine 调度器
-
-# 代码质量
-make lint             # ruff + mypy
-make format           # black + ruff --fix
-make lint-semantic    # 语义层禁词检查 (防止供应商术语泄漏)
-make ci               # format-check + lint + lint-semantic + test + security
-
-# 测试
-make test             # pytest
-make test-cov         # 覆盖率报告
-
-# 安全扫描
-make security         # bandit + pip-audit
-
-# Docker
-make docker-run       # 启动 api + scheduler (共享外部 db/redis)
-make docker-rebuild   # 强制重建
-make docker-logs      # 查看日志
-
-# 数据库迁移
-alembic revision --autogenerate -m "描述"
-alembic upgrade head
-```
-
-### 前端 (cd tauri-app)
-
-```bash
-# 开发
-npm run dev           # Vite 前端服务器 (1420)
-npm run tauri dev     # Tauri 完整开发模式
-
-# 构建
-npm run build         # tsc + vite build
-npm run tauri build   # Tauri 打包
-
-# 测试
-npm run test          # Vitest
-npm run test:ui       # Vitest UI
-npm run test:coverage # 覆盖率
-
-# 代码质量
-npm run lint          # ESLint
-npm run lint:fix      # ESLint --fix
-npm run format        # Prettier
-npm run stylelint     # Stylelint
-
-# API 类型生成
-npm run gen:api       # 从 openapi.json 生成 TypeScript 类型
-```
-
-## 代码规范
-
-### 命名约定
- **组件/页面文件夹**: PascalCase (`VideoCreation/`, `ErrorBoundary/`)
- **Store/Hooks/API 文件**: camelCase (`authStore.ts`, `useProjectData.ts`)
- **Python 模块/函数**: snake_case (`script_handler.py`, `get_settings()`)
- **Python 类**: PascalCase (`AsyncEngine`, `BaseModel`)
- **常量**: UPPER_SNAKE_CASE (`PYTHON_API_BASE_URL`)
-
-### 注释语言
- **统一使用中文注释**
- 关键架构决策需用多行注释说明
-
-### Python 代码质量
- **格式化**: black (line-length: 100)
- **检查**: ruff (E, F, I, N, W, UP, B, C4, SIM)
- **类型检查**: mypy (新代码 `app.schemas.*`, `app.crud.*`, `app.scheduler.handlers.*` 严格模式)
- **依赖管理**: uv (`requirements.lock` 必须与 `pyproject.toml` 同步)
- **安全**: bandit + pip-audit
-
-### TypeScript 配置
- `strict: true` 已开启
- `jsx: "react-jsx"`，无需手动引入 React
- 路径别名 `@/` → `./src`
-
-### 语义层防护 (Makefile `lint-semantic`)
- API 层禁止 `element_id` 作为字段名 (应使用 `provider_element_id`)
- Scheduler 层统一使用 `task` 命名 (`TaskRegistry`, `task_id`, `task:` Redis key 前缀)，禁止混用 `job`
-
-## 关键架构组件
-
-### Async Engine (异步任务调度)
- **位置**: `python-api/app/scheduler/`
- **核心组件**:
-  - `AsyncEngine`: 主调度器，驱动 Tick 循环
-  - `TaskRegistry`: Redis 任务注册表 (running/pending/finished)
-  - `SlotManager`: 并发槽位管理 (按 task_type 限制并发数)
-  - `handlers/`: 各领域处理器 (`script`, `tts`, `subtitle`, `video`)
- **启动**: `make scheduler` 或 `python -m app.scheduler.main`
- **Tick 间隔**: 5 秒 (可配置)
-
-### Platform Gateway (第三方平台统一调用)
- **位置**: `python-api/app/platform_gateway.py`
- **功能**: 统一调用所有第三方平台 (Vidu、火山方舟、火山字幕)
- **方法**:
-  - `call_sync()`: 同步调用
-  - `submit_task()`: 异步任务提交
-  - `query_task()`: 任务状态查询
-  - `handle_webhook()`: 回调处理 (含签名验证 + nonce 防重放)
-
-### Model Router (AI 模型路由)
- **位置**: `python-api/app/ai/model_router.py`
- **功能**: 从 YAML 配置文件加载平台/模型配置，支持模型自动选择
- **配置文件**: `python-api/config/platform-config.yaml`
-
-### 状态管理 (前端)
- **Zustand + Immer**: 不可变更新
- **projectStore**: 自定义 `persist` 存储，通过 Tauri IPC 持久化到本地文件系统 (`app_config_dir/current_project.json`)
- **其他 Store**: 使用 `localStorage` 持久化
-
-## 环境变量 (后端)
-
-关键配置见 `python-api/.env.example`:
-
-| 变量 | 说明 |
-|------|------|
-| `DATABASE_URL` | PostgreSQL 连接字符串 |
-| `REDIS_HOST` / `REDIS_PORT` / `REDIS_DB` | Redis 连接信息 |
-| `SECRET_KEY` | JWT 签名密钥 (生产环境必须设置) |
-| `CORS_ORIGINS` | 允许的跨域来源 |
-| `VOLCENGINE_API_KEY` | 火山方舟 API Key |
-| `VIDU_API_KEY` | Vidu API Key |
-| `QINIU_ACCESS_KEY` / `QINIU_SECRET_KEY` | 七牛云存储密钥 |
-| `APP_BASE_URL` | 应用公网地址 (第三方回调用) |
-
-## 部署
-
-### 测试环境 (GitLab CI)
- 触发条件: master 分支
- 流程: 拉取代码 → 构建 api + scheduler → 启动服务 → 健康检查 (`/health`)
- 清理: 删除 7 天前的旧镜像
-
-### 生产环境
-```bash
-cd python-api
-docker compose -f docker-compose.prod.yml up -d --build
-```
-
-## 数据库
-
- **ORM**: SQLAlchemy 2.0 (asyncpg 驱动)
- **迁移**: Alembic
- **基础模型**: `app.models.base.BaseModel` (UUID 主键、`created_at`、`updated_at`)
-
-## 安全注意事项
-
- JWT `SECRET_KEY` 生产环境必须设置强随机字符串
- 依赖安全: `aiohttp>=3.13.4` 和 `orjson>=3.11.0` 为强制最低版本
- 输入验证: 所有 API 入参通过 Pydantic Schema 校验
- 数据库: 使用参数化查询 (SQLAlchemy ORM)
-
-## 开发注意事项
-
-1. 修改 `pyproject.toml` 后必须运行 `make update-lock` 更新 `requirements.lock`
-2. 新增组件遵循 PascalCase 文件夹约定
-3. 语义层禁词检查 (`make lint-semantic`) 必须通过
-4. Tauri 配置变更后需重新 `tauri dev`
-5. `projectStore` 的 `partialize` 字段决定哪些状态被保存到本地文件
-6. 前端测试在 `src/__tests__/setup.ts` 中已全局 mock localStorage 和 Tauri API
@@ -1 +1 @@
-1.5.18
+1.8.1
@@ -1,181 +0,0 @@
-# Alembic 迁移诊断报告
-
-## 迁移历史概览
-
-```
-<base>
-  ↓
-509aa8b53d81  initial_schema（创建 6 张初始表）
-  ↓
-ccf61ff6f4bb  remove_frozen_and_refunded（删除 3 个废弃字段）
-  ↓
-95eb1a1c0af9  add_duration_to_point_transaction（duration 字段）
-  ↓
-8aa48b89a07d  add_category_to_point_transaction（category 字段）
-  ↓
-69274ce979a5  add_broll_material_tables（⚠️ 问题脚本，593 行）
-  ↓
-e02c96e264d9  add_cover_backgrounds_table（封面背景表）
-  ↓
-d0a7c5a375c6  add_app_update_tables（更新系统表）
-  ↓
-7a412121e69a  rename_mjk_to_mjk_broll（broll 表重命名） ← head
-```
-
-依赖链：**线性，无 branch/merge**，head 为 `7a412121e69a`。
-
---
-
-## 🔴 严重问题
-
-### 1. 69274ce979a5 脚本职责混乱、极其臃肿
-
-**脚本名**：`add_broll_material_tables`
-
-**实际内容**：
- 创建 3 张新表（`mjk_categories`/`mjk_tags`/`mjk_materials`）：约 60 行
- 给已有 6 张表的所有字段加 `comment`：约 530 行
-
-**问题**：
- 脚本体积膨胀到 **593 行**，90% 内容和脚本名称无关
- 新环境执行迁移时，会触发几十个 `ALTER COLUMN` 操作，耗时显著增加
- 脚本难以维护，任何已有表字段的 comment 调整都需要修改这个脚本
- "加 comment" 和 "创建新表" 是完全独立的操作，不应该混在一起
-
-**正确做法**（ hindsight ）：
- 脚本 A：创建 broll 表（~60 行）
- 脚本 B：给已有字段补 comment（~530 行）
- 或在 `initial_schema` 中直接带上 comment，避免后续回头补
-
---
-
-### 2. "创建 → 加 comment → 重命名" 链式低效
-
-| 步骤 | 迁移脚本 | 操作 |
-|------|---------|------|
-| 1 | 509aa8b53d81 | 创建 `mjk_categories`（无 comment） |
-| 2 | 69274ce979a5 | 给 `mjk_categories` 字段加 comment |
-| 3 | 7a412121e69a | 重命名 `mjk_categories` → `mjk_broll_categories` |
-
-**问题**：同一张表经历了"创建 → 补 comment → 重命名"三次操作。正确的做法是在创建时就用最终表名并带上 comment。
-
---
-
-## 🟡 中等问题
-
-### 3. downgrade 顺序错误
-
-**d0a7c5a375c6**（更新系统表）：
-
-```python
-# 当前（逻辑顺序错误）
-op.drop_table("release_packages")      # 1. 先删子表
-op.drop_index("ix_app_releases_version", table_name="app_releases")  # 2. 再删索引
-op.drop_table("app_releases")          # 3. 最后删父表
-```
-
-虽然 `drop_table` 会级联删除索引不会报错，但正确的逻辑顺序应该是：
-```python
-op.drop_table("release_packages")
-op.drop_index("ix_app_releases_version", table_name="app_releases")
-op.drop_table("app_releases")
-```
-
-> 注：当前顺序实际不会导致错误，只是不够规范。
-
-### 4. 表名前缀不一致
-
-| 表 | 前缀 | 一致性 |
-|----|------|--------|
-| `mjk_users` | `mjk_` | ✅ |
-| `mjk_point_transactions` | `mjk_` | ✅ |
-| `mjk_broll_categories` | `mjk_` | ✅ |
-| `mjk_cover_backgrounds` | `mjk_` | ✅ |
-| `app_releases` | `app_` | ❌ 缺少 `mjk_` 前缀 |
-| `release_packages` | 无前缀 | ❌ 缺少 `mjk_` 前缀 |
-
-### 5. 时间戳与顺序不一致
-
- `d0a7c5a375c6` Create Date：`2026-05-11 09:30:00`
- `e02c96e264d9` Create Date：`2026-05-11 20:00:00`
-
-依赖链：`e02c96e264d9 → d0a7c5a375c6`，但时间戳显示 `e02c96e264d9` 比 `d0a7c5a375c6` 晚（20:00 vs 09:30）。
-
-不影响功能，只是记录不规范。
-
---
-
-## 🟢 正常部分
-
-### 模型与迁移一致性 ✅
-
-| 模型 | 表名 | 字段 | 状态 |
-|------|------|------|------|
-| `UserPoint` | `mjk_user_points` | 无 `frozen`/`total_refunded` | ✅ 与 `ccf61ff6f4bb` 一致 |
-| `PointBatch` | `mjk_point_batches` | 无 `frozen` | ✅ 与 `ccf61ff6f4bb` 一致 |
-| `PointTransaction` | `mjk_point_transactions` | 有 `duration` + `category` | ✅ 与 `95eb1a1c0af9`/`8aa48b89a07d` 一致 |
-| `BrollCategory` | `mjk_broll_categories` | - | ✅ 与 `7a412121e69a` 重命名后一致 |
-| `BrollMaterial` | `mjk_broll_materials` | - | ✅ 与 `7a412121e69a` 重命名后一致 |
-| `BrollTag` | `mjk_broll_tags` | - | ✅ 与 `7a412121e69a` 重命名后一致 |
-| `CoverBackground` | `mjk_cover_backgrounds` | - | ✅ 与 `e02c96e264d9` 一致 |
-| `AppRelease`/`ReleasePackage` | `app_releases`/`release_packages` | - | ✅ 与 `d0a7c5a375c6` 一致 |
-
-### env.py 模型导入 ✅
-
-导入了全部 12 个模型类，无遗漏。
-
---
-
-## 修复建议
-
-### 方案 A：维持现状（推荐，已投产）
-
-**理由**：
- 生产环境数据库已有数据，不能直接修改或删除已有迁移脚本
- 当前迁移链虽然"丑"，但功能正确，执行无误
-
-**行动**：
- 保留现有迁移，以后的新迁移保持**单一职责**（一个脚本只做一件事）
- 不再在迁移脚本里大量添加 `comment`（初始 schema 没带的就保持原样）
-
-### 方案 B：Squash 迁移（适合新环境 / 大版本重构时）
-
-将所有历史迁移合并为一张干净的 `initial_schema`：
-
-```bash
-# 1. 备份当前 alembic 目录
-mv alembic/versions alembic/versions_backup
-
-# 2. 在空数据库上生成一张完整的初始迁移
-alembic revision --autogenerate -m "squash: initial schema"
-
-# 3. 验证新迁移包含所有表和字段
-# 4. 删除备份
-rm -rf alembic/versions_backup
-```
-
-**风险**：
- 生产环境已有 `alembic_version` 记录，不能直接切换
- 需要协调所有环境（开发/测试/生产）同时切换
-
-### 方案 C：拆分 69274ce979a5（仅做记录，不建议执行）
-
-将 `69274ce979a5` 拆分为两个脚本：
-1. `create_broll_tables`：创建 `mjk_broll_categories`/`mjk_broll_materials`/`mjk_broll_tags`
-2. `add_column_comments`：给已有字段加 comment
-
-**不可行原因**：已有迁移的 revision ID 已写入数据库 `alembic_version` 表，拆分会导致已执行环境的历史记录和脚本不匹配。
-
---
-
-## 结论
-
-| 问题 | 严重程度 | 是否可修复 | 建议 |
-|------|---------|-----------|------|
-| 69274ce979a5 职责混乱 | 🔴 高 | ❌ 已投产，不动 | 以后新迁移保持单一职责 |
-| 创建→comment→重命名链 | 🔴 高 | ❌ 已投产，不动 | 以后在创建时直接用最终表名 |
-| downgrade 顺序 | 🟡 中 | ⚠️ 不建议改 | 当前不会报错，保持现状 |
-| 表名前缀不一致 | 🟡 中 | ❌ 已投产，不动 | 接受现状 |
-| 时间戳不一致 | 🟢 低 | ❌ 无影响 | 忽略 |
-
-**最终建议**：维持现状，不修改已有迁移脚本。以后新迁移遵循"单一职责原则"。
@@ -71,7 +71,7 @@ INSERT INTO app_releases (version, release_date, notes, mandatory) VALUES
 ('0.2.0', '2026-04-20 10:00:00', '新增：批量导出功能\n优化：性能提升 30%', FALSE);
 ```

-#### 2.1.2 release_packages - 平台包信息
+#### 2.1.2 mjk_app_release_packages - 平台包信息

 | 字段 | 类型 | 说明 | 约束 |
 |------|------|------|------|
@@ -97,7 +97,7 @@ INSERT INTO app_releases (version, release_date, notes, mandatory) VALUES

 **示例数据**:
 ```sql
-INSERT INTO release_packages (release_id, platform, architecture, filename, file_url, file_size, file_hash) VALUES
+INSERT INTO mjk_app_release_packages (release_id, platform, architecture, filename, file_url, file_size, file_hash) VALUES
 (2, 'darwin', 'x86_64', 'meijiaka_0.1.1_darwin_x86_64.dmg',
 'https://cdn.meijiaka.com/releases/meijiaka_0.1.1_darwin_x86_64.dmg',
 102400000, 'sha256:abc123...'),
@@ -129,7 +129,7 @@ INSERT INTO release_packages (release_id, platform, architecture, filename, file
 CREATE INDEX idx_releases_release_date ON app_releases(release_date DESC);

 -- 平台包复合索引
-CREATE INDEX idx_packages_platform_arch ON release_packages(platform, architecture);
+CREATE INDEX idx_packages_platform_arch ON mjk_app_release_packages(platform, architecture);

 -- 下载统计
 CREATE INDEX idx_downloads_release_id ON update_downloads(release_id);
@@ -151,7 +151,7 @@ CREATE TABLE IF NOT EXISTS app_releases (
 );

 -- 创建平台包信息表
-CREATE TABLE IF NOT EXISTS release_packages (
+CREATE TABLE IF NOT EXISTS mjk_app_release_packages (
    id SERIAL PRIMARY KEY,
    release_id INTEGER NOT NULL REFERENCES app_releases(id) ON DELETE CASCADE,
    platform VARCHAR(20) NOT NULL,
@@ -177,8 +177,8 @@ CREATE TABLE IF NOT EXISTS update_downloads (
 -- 创建索引
 CREATE INDEX IF NOT EXISTS idx_releases_version ON app_releases(version);
 CREATE INDEX IF NOT EXISTS idx_releases_release_date ON app_releases(release_date DESC);
-CREATE INDEX IF NOT EXISTS idx_packages_platform_arch ON release_packages(platform, architecture);
-CREATE INDEX IF NOT EXISTS idx_packages_release_id ON release_packages(release_id);
+CREATE INDEX IF NOT EXISTS idx_packages_platform_arch ON mjk_app_release_packages(platform, architecture);
+CREATE INDEX IF NOT EXISTS idx_packages_release_id ON mjk_app_release_packages(release_id);
 CREATE INDEX IF NOT EXISTS idx_downloads_release_id ON update_downloads(release_id);
 CREATE INDEX IF NOT EXISTS idx_downloads_download_at ON update_downloads(download_at);

@@ -240,7 +240,7 @@ class AppRelease(Base):

 class ReleasePackage(Base):
    """平台包信息"""
-    __tablename__ = "release_packages"
+    __tablename__ = "mjk_app_release_packages"
    
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    release_id: Mapped[int] = mapped_column(
@@ -0,0 +1,227 @@
+# DMG 背景图设计规范
+
+> 本规范与美家卡智影桌面应用视觉体系保持一致。
+
+---
+
+## 一、画布规格
+
+| 项目 | 规格 |
+|------|------|
+| 尺寸 | **660 × 400 px** |
+| 格式 | PNG（不透明） |
+| 分辨率 | 72 DPI |
+| 色彩模式 | sRGB |
+
+---
+
+## 二、视觉风格
+
+### 2.1 设计语言
+
+与主应用保持一致：
+- **卡片式布局** — 圆角卡片承载信息
+- **轻微阴影** — 营造层级感
+- **绿色主色调** — 品牌识别色 `#36b26a`
+- **圆角设计** — 大圆角（12px）为主，小圆角（8px）为辅
+- **毛玻璃质感** — 侧边栏/浮层使用半透明模糊效果
+
+### 2.2 色彩规范（引用应用 CSS 变量）
+
+| 用途 | 色值 | CSS 变量 |
+|------|------|----------|
+| 背景底色 | `#f9fafb` | `--bg-main` |
+| 卡片背景 | `#ffffff` | `--bg-card` |
+| 品牌主色 | `#36b26a` | `--primary` |
+| 品牌辅色 | `#18a08a` | `--secondary` |
+| 文字主色 | `#111827` | `--text-primary` |
+| 文字次色 | `#6b7280` | `--text-secondary` |
+| 文字三级 | `#9ca3af` | `--text-tertiary` |
+| 边框颜色 | `#e5e7eb` | `--border-color` |
+| 成功/提示 | `#10b981` | `--success` |
+| 警告 | `#f59e0b` | `--warning` |
+| 错误 | `#ef4444` | `--error` |
+| 信息 | `#3b82f6` | `--info` |
+
+### 2.3 字体规范
+
+- **字体家族**：`'Inter', -apple-system, BlinkMacSystemFont, 'PingFang SC', sans-serif`
+- **字重**：标题 600（SemiBold），正文 400（Regular）
+
+| 层级 | 字号 | 字重 | 用途 |
+|------|------|------|------|
+| 品牌标题 | 28 px | 600 | 顶部 "美家卡智影" |
+| 引导文字 | 15 px | 500 | 拖拽指引 |
+| 提示标题 | 14 px | 600 | 卡片内小标题 |
+| 提示正文 | 13 px | 400 | 卡片内说明文字 |
+| 版本号 | 11 px | 400 | 底部版本信息 |
+
+### 2.4 阴影规范
+
+| 用途 | 阴影值 |
+|------|--------|
+| 卡片阴影 | `0 1px 3px rgb(0 0 0 / 5%)` |
+| 浮层阴影 | `0 4px 12px rgb(0 0 0 / 6%)` |
+| 强调阴影 | `0 4px 12px rgb(54 178 106 / 30%)` |
+
+### 2.5 圆角规范
+
+| 用途 | 圆角 |
+|------|------|
+| 大卡片 | 12 px (`--radius-lg`) |
+| 小元素 | 8 px (`--radius-md`) |
+| 按钮/标签 | 6 px (`--radius-sm`) |
+
+---
+
+## 三、布局规范
+
+### 3.1 安全区域
+
+Tauri 会在背景图上**自动叠加**以下元素，背景图需为其预留空间：
+
+| 元素 | 尺寸（约） | 位置（660×400 画布） |
+|------|-----------|---------------------|
+| `.app` 图标 | 100 × 100 px | 左侧中心 (180, 170) |
+| `Applications` 文件夹 | 100 × 100 px | 右侧中心 (480, 170) |
+
+> ⚠️ 左右两侧 120～140 px 宽度区域避免放置重要信息，留给系统图标。
+
+### 3.2 信息层级（从上至下）
+
+```
+┌─────────────────────────────────────────┐
+│                                         │
+│         [品牌 Logo + 应用名称]            │  ← 顶部居中
+│                                         │
+│                                         │
+│    [.app]          [Applications]       │  ← 系统图标区域
+│     图标              文件夹             │
+│                                         │
+│         ← 拖拽箭头 / 视觉引导线 →         │  ← 中部
+│                                         │
+│    ┌─────────────────────────────┐      │
+│    │   [提示图标] 首次安装提示     │      │  ← 提示卡片
+│    │   说明文字...                  │      │
+│    └─────────────────────────────┘      │
+│                                         │
+│              v1.5.18                    │  ← 底部版本号
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 四、内容规范
+
+### 4.1 顶部品牌区
+
+**内容：**
+- 应用 Logo（绿色 M 图标，约 48×48 px）
+- 应用名称："美家卡智影"
+
+**样式：**
+- Logo 与文字水平排列，间距 12 px
+- 文字颜色：`#111827` (`--text-primary`)
+- 文字字号：28 px，字重 600
+- 整体居中于顶部，距上边距约 40 px
+
+### 4.2 中部拖拽区
+
+**内容：**
+- 拖拽箭头或虚线引导线：从 `.app` 图标指向 `Applications` 文件夹
+- 引导文字："将应用拖拽到 Applications 文件夹"
+
+**样式：**
+- 箭头颜色：`#36b26a` (`--primary`) 或 `#9ca3af` (`--text-tertiary`)
+- 引导文字颜色：`#6b7280` (`--text-secondary`)
+- 引导文字字号：15 px，字重 500
+
+### 4.3 底部提示卡片（核心区域）
+
+由于应用未注册 Apple 开发者账号，macOS Gatekeeper 会拦截首次打开。必须通过醒目的提示卡片告知用户解决方法。
+
+**卡片样式：**
+- 背景：`#ffffff` (`--bg-card`)
+- 边框：1 px solid `#e5e7eb` (`--border-color`)
+- 圆角：12 px (`--radius-lg`)
+- 阴影：`0 1px 3px rgb(0 0 0 / 5%)` (`--shadow-card`)
+- 内边距：左右 24 px，上下 16 px
+- 最大宽度：约 440 px，水平居中
+
+**卡片内容：**
+
+```
+[绿色圆点图标] 首次安装提示
+─────────────────────────────────
+由于未注册 Apple 开发者，首次打开时请：
+
+方法 1：右键点击应用图标 → 选择「打开」
+方法 2：系统设置 → 隐私与安全性 → 仍要打开
+```
+
+**文字样式：**
+- 提示标题：14 px，600，颜色 `#36b26a` (`--primary`)
+- 说明正文：13 px，400，颜色 `#6b7280` (`--text-secondary`)
+- 行高：1.6
+
+**提示图标：**
+- 使用绿色圆点（8 px）或 Info 图标（16 px）
+- 颜色：`#36b26a` (`--primary`)
+
+### 4.4 底部版本号（可选）
+
+**内容：** "v1.5.18"
+
+**样式：**
+- 字号：11 px (`--font-xs`)
+- 颜色：`#9ca3af` (`--text-tertiary`)
+- 位置：底部居中，距下边距约 16 px
+
+---
+
+## 五、设计禁忌
+
+| ❌ 禁止 | ✅ 推荐 |
+|---------|---------|
+| 使用鲜艳刺眼的背景色（大红、亮黄） | 使用浅灰 `#f9fafb` 或纯白 `#fff` |
+| 文字过小（< 11 px）导致可读性差 | 最小字号 11 px，正文 13 px |
+| 左右两侧放置重要信息（被系统图标遮挡） | 左右两侧 120 px 留白 |
+| 使用纯黑 `#000` 文字 | 使用深灰 `#111827` |
+| 阴影过重（如 0 10px 30px） | 使用轻微阴影 `0 4px 12px rgb(0 0 0 / 6%)` |
+| 圆角过小（2-4 px）或直角 | 使用 8-12 px 大圆角 |
+| 使用多种字体混排 | 统一使用 Inter / PingFang SC |
+
+---
+
+## 六、交付物
+
+| 文件 | 说明 |
+|------|------|
+| `dmg-background.png` | 660 × 400 px，72 DPI，sRGB，PNG 格式 |
+| `dmg-background@2x.png` | 1320 × 800 px（Retina 屏高清版本，可选） |
+| 源文件 | PSD / Sketch / Figma 源文件 |
+
+**放置路径：** `tauri-app/src-tauri/dmg-background.png`
+
+---
+
+## 七、参考案例
+
+### 7.1 飞书 (Lark)
+- 浅灰背景 `#f5f5f7`
+- 中央大 Logo
+- 两侧图标 + 拖拽箭头
+- 底部小字提示
+
+### 7.2 微信
+- 纯白背景
+- 简洁的拖拽指引
+- 无 Gatekeeper 提示（已签名）
+
+### 7.3 推荐风格
+参考 **Apple 官方设计风格** + **应用自身绿色品牌色**：
+- 背景：`#f9fafb`
+- 卡片：纯白 + 浅灰边框 + 轻微阴影
+- 强调：绿色 `#36b26a`
+- 整体简洁、专业、无多余装饰
@@ -0,0 +1,756 @@
+# 前端系统兼容性审查报告 v2（业务场景驱动）
+
+> 审查范围：`tauri-app/src` 全部源码 + `tauri-app/src-tauri/src` Rust 层命令
+> 审查方法：按用户真实使用路径和数据流转分析，非通用技术罗列
+> 审查日期：2026-05-21
+> 当前版本：v1.6.0
+
+---
+
+## 一、综述
+
+本次审查以**用户真实操作流程**为主线，从数据持久化、媒体处理、第三方服务、版本升级、跨设备迁移五个业务维度展开，共发现 **14 项与业务直接相关的兼容性问题**。
+
+**核心结论**：
+1. **BGM 云端化改造存在链路缺口**：前端存储了 URL，但混音时直接传给 FFmpeg，未做本地缓存，网络波动或 URL 过期会导致合成失败或产生"无声成片"。
+2. **积分消费存在 TOCTOU 竞态**：预检通过→合成完成→扣费失败之间有时间窗口，可能导致用户白嫖或重复扣费。
+3. **项目数据完全不可迁移**：所有本地路径为绝对路径，无导出/导入功能，换设备后项目报废。
+4. **磁盘满等大文件场景缺乏保护**：合成成果可能直接丢失，大视频上传/下载全量读内存。
+5. **多处"静默失败"**：保存项目、分段配音、BGM 混音等关键环节出错时不提示用户，导致用户以为成功实际数据残缺。
+
+---
+
+## 二、🔴 严重问题（影响功能、数据或资金）
+
+### 1. BGM 云端化后混音链路断裂——"无声成片"与合成失败
+
+**业务场景**：
+1. 用户在 BGM 弹窗中选择一首云端 BGM（七牛云 URL）
+2. 保存项目（`bgmMusicPath` 写入 `meta.json`，值为 `https://media.liche.cn/.../xxx.mp3`）
+3. 几天后点击「合成视频」，FFmpeg 混音时直接拉取该 URL
+4. 网络波动或 URL 签名过期 → FFmpeg HTTP 输入超时 → 混音失败
+
+**实际代码路径**：
+```typescript
+// VideoCompose.tsx:265-276
+if (bgmMusicPath) {
+  const mixRes = await invoke('mix_bgm_to_video', {
+    args: {
+      videoPath: result,
+      bgmPath: bgmFullPath,   // <-- 这里是七牛云 URL，不是本地路径
+      outputPath: result,
+      bgmVolume: (bgmVolume ?? 0.25),
+    },
+  });
+  if (mixRes.code !== 200) {
+    console.warn('BGM 混合失败，使用无 BGM 版本:', mixRes.message);
+  }
+}
+```
+
+```rust
+// ffmpeg_cmd.rs:509-546
+pub async fn mix_bgm_to_video(...) {
+    let safe_video = validate_safe_path(video_path)?;  // 只校验视频路径
+    let safe_bgm = bgm_path.to_string();                // <-- 直接透传 URL，无校验
+    run_ffmpeg(app, vec!["-i", safe_video, "-i", safe_bgm, ...])
+}
+```
+
+**用户实际看到**：
+- 界面提示「压制成片完成」✅
+- 播放视频发现**没有背景音乐** ❌
+- 用户以为是自己操作问题，反复合成浪费积分和时间
+
+**影响评估**：
+- 功能完整性受损：选了 BGM 却出无声视频
+- 积分浪费：每次合成消耗积分，但产出不符合预期
+- 用户信任度下降：无法解释为什么有时有 BGM 有时没有
+
+**修复建议**：
+在 `VideoCompose.tsx` `handleStart` 中，混音前确保 BGM 为本地文件：
+```typescript
+let finalBgmPath = bgmMusicPath;
+if (bgmMusicPath?.startsWith('http')) {
+  // 下载到本地缓存目录
+  const cacheDir = await invoke<string>('get_bgm_cache_dir');
+  const cachedPath = `${cacheDir}/bgm_${bgmMusicId}.mp3`;
+  const exists = await invoke<boolean>('file_exists', { path: cachedPath });
+  if (!exists) {
+    useProgressStore.getState().update('正在下载背景音乐...');
+    await videoComposeApi.downloadFile({ url: bgmMusicPath, outputPath: cachedPath });
+  }
+  finalBgmPath = cachedPath;
+}
+// 然后传给 mix_bgm_to_video
+```
+
+Rust 侧 `mix_bgm_to_video` 应恢复 `validate_safe_path` 校验，拒绝 URL：
+```rust
+let safe_bgm = validate_safe_path(bgm_path)?;  // 强制要求本地路径
+```
+
+---
+
+### 2. 积分消费 TOCTOU 竞态——合成完成扣费失败导致"白嫖"或需重来
+
+**业务场景**：
+1. 用户点击「合成视频」，预检余额充足（如 50 积分，需扣 5 分）
+2. 视频合成耗时 3-5 分钟
+3. 期间用户在手机端或其他场景消费了积分，余额降至 3 分
+4. 合成完成后调用 `consumePoints`，返回 402 "积分不足"
+5. 前端回滚 `finalVideoPath` 状态，但**不删除已生成的视频文件**
+
+**实际代码**：
+```typescript
+// VideoCompose.tsx:287-309
+const composePoints = usePointStore.getState().getRule('compose')?.points || 5;
+try {
+  await pointsApi.consumePoints({
+    points: composePoints,
+    sourceType: 'compose',
+    sourceId: `compose_${useAuthStore.getState().user?.id || 'unknown'}_${Date.now()}`,
+    description: '压制成片',
+  });
+} catch (err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  setResultPath('');
+  setFinalVideoPath(undefined);   // 回滚前端状态
+  setExportedAt(undefined);
+  // ❌ 没有删除 products/ 目录下已生成的视频文件
+  if (msg.includes('402') || msg.includes('积分不足')) {
+    setShowPointsModal(true);
+    return;
+  }
+}
+```
+
+**用户实际看到**：
+- 提示「积分不足」弹出充值弹窗
+- 但 `~/Library/Application Support/cn.meijiaka.ai-zy/projects/xxx/products/` 下已经有一份完整的 `.mp4`
+- 用户可以通过 Finder 直接找到并播放该文件，**实际已白嫖成功**
+- 或者用户充值后再次点击合成，重复消耗时间
+
+**影响评估**：
+- 资金损失风险：用户可在不扣积分的情况下拿到成品
+- 用户体验差：明明看到"合成完成"的进度条走到 100%，最后说积分不够
+- 运营数据失真：成品文件存在但系统无消费记录
+
+**修复建议（方案二选一）**：
+
+**方案 A：积分预占/冻结机制（推荐）**
+后端新增 "预占积分" API，合成前预占 5 积分，合成完成后确认扣费，失败则释放。消除时间窗口。
+
+**方案 B：扣费前置 + 失败清理**
+若无法改后端，至少做到失败时清理文件：
+```typescript
+} catch (err) {
+  // 回滚状态
+  setResultPath('');
+  setFinalVideoPath(undefined);
+  // 清理已生成的文件
+  if (outputPath) {
+    await invoke('delete_project_file', { projectId, filePath: outputPath })
+      .catch(() => {});  // 清理失败不阻断错误提示
+  }
+  // ... 原有错误处理
+}
+```
+
+---
+
+### 3. 项目数据绝对路径依赖——换设备后项目完全报废
+
+**业务场景**：
+1. 用户 Mac A 上创建项目，生成视频，一切正常
+2. 用户将 `~/Library/Application Support/cn.meijiaka.ai-zy/projects/` 文件夹复制到 Mac B（或 Time Machine 恢复）
+3. 在 Mac B 上打开应用，项目列表显示正常
+4. 点击项目进入编辑，视频预览空白、配音无法播放、封面无法加载
+
+**根本原因**：
+`meta.json` 和 `segments.json` 中所有本地文件路径均为**绝对路径**：
+```json
+{
+  "avatarMaterialPath": "/Users/alice/Library/Application Support/cn.meijiaka.ai-zy/projects/proj_xxx/assets/voice.mp3",
+  "burnedVideoPath": "/Users/alice/Library/Application Support/.../burned_xxx.mp4",
+  "coverPath": "/Users/alice/Library/Application Support/.../cover.png"
+}
+```
+
+Mac B 上用户名为 `bob`，上述路径全部指向不存在的目录。
+
+**当前代码无修复机制**：
+- `loadMeta` 直接返回磁盘数据，无路径校验或重映射
+- `getLocalFileUrl` 调用 Rust `validate_media_path`，校验通过后会返回 `asset://` URL，但文件不存在时直接抛错
+- `useLocalVideo` 抛错后显示空白，无降级提示
+
+**用户实际看到**：
+- 项目标题、主题等文字信息正常
+- 视频预览区域空白或转圈
+- 配音试听按钮点击无反应
+- 用户以为数据损坏，恐慌
+
+**影响评估**：
+- 用户换机/重装系统后所有本地项目无法继续编辑
+- 与「桌面端本地持久化」的核心卖点相矛盾
+- Time Machine 备份恢复后项目数据"假死"
+
+**修复建议**：
+
+**短期（最小改动）**：加载项目时检测路径有效性，无效时给出明确提示：
+```typescript
+// initProjectStore 中
+const validatedMeta = await validateProjectPaths(meta);
+if (validatedMeta.brokenPaths.length > 0) {
+  toast.warn(`项目 ${validatedMeta.brokenPaths.join(', ')} 关联的文件已丢失，可能因迁移设备或清理磁盘导致`);
+}
+```
+
+**长期**：
+1. 持久化时存储**相对路径**（相对于项目目录）
+2. 加载时解析为绝对路径：
+```typescript
+function resolveProjectPath(projectId: string, relativePath: string): string {
+  return `${APP_LOCAL_DATA_DIR}/projects/${projectId}/${relativePath}`;
+}
+```
+3. 新增「项目包导出/导入」功能：将 `meta.json` + `segments.json` + `assets/` + `videos/` 打包为 `.zip`
+
+---
+
+### 4. 磁盘空间不足时合成成果直接丢失
+
+**业务场景**：
+1. 用户 Mac 剩余空间 2GB
+2. 合成一个 1.5GB 的视频，临时文件 + 输出文件刚好占满磁盘
+3. FFmpeg 合成成功，但 `std::fs::copy` 移动最终文件时因磁盘满失败
+4. 临时文件被清理，用户一无所获
+
+**实际代码**：
+```rust
+// video_processing.rs:93
+std::fs::rename(&final_output, output_path)
+    .or_else(|_| {
+        std::fs::copy(&final_output, output_path)
+            .and_then(|_| std::fs::remove_file(&final_output))
+    })
+```
+
+`rename` 跨卷时失败，`copy` 在磁盘满时失败，临时文件在 `Drop` 或后续清理中被删除。
+
+**用户实际看到**：
+- 进度条走到 100%，显示「正在保存...」
+- 突然报错「移动最终视频失败」
+- 数分钟的等待 + 积分消耗，结果什么都没有
+
+**影响评估**：
+- 极端挫败感：用户最高预期时刻（"马上完成了"）直接失败
+- 积分和时间双重浪费
+
+**修复建议**：
+1. 合成前检查磁盘空间：
+```rust
+// 在 handleStart 调用前
+let required_space = estimate_output_size(video_paths) * 2;  // 输出 + 临时文件
+let available = fs2::available_space(&output_parent)?;
+if available < required_space {
+    return Err("磁盘空间不足，需要至少 {} GB 可用空间".into());
+}
+```
+2. `copy` 失败时保留临时文件，给用户手动恢复的机会：
+```rust
+if let Err(e) = std::fs::copy(&final_output, output_path) {
+    return Err(format!("保存失败（磁盘可能已满）。临时文件保留在: {}，错误: {}",
+        final_output.display(), e));
+}
+```
+
+---
+
+### 5. 大文件上传/下载全量读内存——低配机器 OOM
+
+**业务场景**：
+1. 用户生成了一段 10 分钟 1080p 视频，文件大小 500MB
+2. 点击「上传」或系统自动上传到七牛云/后端
+3. Rust 侧 `std::fs::read(local_path)` 将 500MB 全量读入内存
+4. 再复制到 reqwest multipart body，峰值内存占用 >1GB
+5. 8GB 内存的 MacBook Air 可能触发系统 OOM，应用被杀死
+
+**实际代码**：
+```rust
+// Rust 侧 upload_video_file / upload_audio_file
+let file_bytes = match std::fs::read(local_path) { ... };
+let form = reqwest::multipart::Form::new()
+    .part("file", reqwest::multipart::Part::bytes(file_bytes) ...);
+```
+
+```rust
+// Rust 侧 download_file
+let client = reqwest::Client::new();  // 默认无超时
+let bytes = match response.bytes().await { ... };  // 全量入内存
+std::fs::write(&safe_output, &bytes);
+```
+
+**用户实际看到**：
+- 上传/下载大文件时应用突然消失（被系统杀死）
+- 或进度条卡住很久，没有任何反馈
+- 重启后需要重新开始整个流程
+
+**影响评估**：
+- 长视频用户（核心目标用户群）完全无法使用
+- 应用稳定性差，低配置设备体验极差
+
+**修复建议**：
+
+上传改用流式：
+```rust
+use tokio::fs::File;
+use tokio::io::AsyncReadExt;
+
+let file = File::open(local_path).await?;
+let stream = tokio_util::codec::FramedRead::new(file, tokio_util::codec::BytesCodec::new());
+let body = reqwest::Body::wrap_stream(stream);
+let part = reqwest::multipart::Part::stream(body)
+    .file_name(filename)
+    .mime_str("video/mp4")?;
+```
+
+下载改用边下边写 + 超时：
+```rust
+let client = reqwest::Client::builder()
+    .timeout(std::time::Duration::from_secs(300))
+    .connect_timeout(std::time::Duration::from_secs(30))
+    .build()?;
+
+let mut response = client.get(url).send().await?;
+let mut file = tokio::fs::File::create(&safe_output).await?;
+while let Some(chunk) = response.chunk().await? {
+    tokio::io::copy(&mut chunk.as_ref(), &mut file).await?;
+}
+```
+
+---
+
+## 三、🟡 中等问题（影响体验或存在数据风险）
+
+### 6. 保存项目失败用户完全不知情——数据丢失风险
+
+**业务场景**：
+1. 用户在 CoverDesign 页面调整标题，触发自动保存
+2. 磁盘已满（或文件被其他程序锁定）
+3. `saveMetaToLocalFile` 抛出 IO 错误
+4. 错误被 `.catch` 捕获后只 `console.error`，**没有任何 UI 提示**
+5. 用户继续编辑，关闭应用
+6. 重新打开后发现之前的修改全部丢失
+
+**实际代码**：
+```typescript
+// localStorage.ts 中的 safeInvoke 错误处理
+try {
+  const result = await invoke<T>(cmd, args);
+  return result;
+} catch (error) {
+  console.error(`Tauri IPC 调用失败 [${cmd}]:`, error);
+  throw error;  // 抛给上层
+}
+
+// saveMetaToLocalFile 调用链
+metaSavePromise = metaSavePromise.then(task).catch(err => {
+  console.error('保存项目元数据失败:', err);
+  throw err;  // 继续抛出，但无人处理
+});
+```
+
+**用户实际看到**：
+- 没有任何错误提示
+- 下次打开项目时数据回到旧状态
+- 用户以为是应用 bug，不信任自动保存功能
+
+**修复建议**：
+在 `saveMetaToLocalFile` 的 catch 中增加用户可见提示：
+```typescript
+metaSavePromise = metaSavePromise.then(task).catch(err => {
+  console.error('保存项目元数据失败:', err);
+  const message = err instanceof Error ? err.message : String(err);
+  if (message.includes('磁盘') || message.includes('space') || message.includes('No space')) {
+    toast.error('项目保存失败：磁盘空间不足，请清理后重试');
+  } else {
+    toast.error('项目保存失败，请检查文件权限或重启应用');
+  }
+  throw err;
+});
+```
+
+---
+
+### 7. 配音分段失败静默继续——"部分缺失"的配音
+
+**业务场景**：
+1. 用户生成 10 段配音，每段对应一个分镜
+2. 第 3 段 `extractAudioSegment` 或 `uploadAudioFile` 失败（网络抖动、文件被占用）
+3. 错误被 catch 后只 `console.error`，循环继续
+4. 最终提示「配音合成完成」
+5. 用户导出视频后发现第 3 分镜没有声音
+
+**实际代码**：
+```typescript
+// VoiceSynthesis.tsx:243-245（近似逻辑）
+for (const segment of segments) {
+  try {
+    await extractAudioSegment(...);
+    await uploadAudioFile(...);
+  } catch (err) {
+    console.error('分段处理失败:', err);  // ❌ 静默吞掉
+    // 循环继续...
+  }
+}
+toast.success('配音合成完成');
+```
+
+**用户实际看到**：
+- 提示「配音合成完成」✅
+- 导出视频后发现部分片段无声 ❌
+- 无法定位是哪一段出了问题
+
+**修复建议**：
+```typescript
+const failedSegments: string[] = [];
+for (const segment of segments) {
+  try {
+    await extractAudioSegment(...);
+    await uploadAudioFile(...);
+  } catch (err) {
+    console.error('分段处理失败:', err);
+    failedSegments.push(segment.id);
+    // 继续处理其他段，但记录失败
+  }
+}
+if (failedSegments.length > 0) {
+  toast.warn(`配音合成部分完成，第 ${failedSegments.join(', ')} 段处理失败，请检查网络后重试`);
+} else {
+  toast.success('配音合成完成');
+}
+```
+
+---
+
+### 8. 轮询任务状态遇到网络闪断直接失败——长任务前功尽弃
+
+**业务场景**：
+1. 用户提交 Vidu 视频生成任务，进入轮询等待
+2. 轮询 3 分钟后，用户 WiFi 短暂断开 5 秒
+3. `getTaskStatus` 抛出网络错误
+4. `while` 循环无内部 try-catch，整个函数抛出异常
+5. 前端提示「视频生成失败」
+6. 实际上后端任务仍在执行，用户需重新提交并再次等待
+
+**实际代码**：
+```typescript
+// useVideoGeneration.ts / ScriptCreation.tsx 等处的轮询逻辑
+while (status === 'pending' || status === 'running') {
+  await new Promise(resolve => setTimeout(resolve, pollInterval));
+  const resp = await taskApi.getTaskStatus(taskId);  // ❌ 无 try-catch
+  status = resp.status;
+}
+```
+
+**用户实际看到**：
+- 等待数分钟后突然报错「失败」
+- 重新提交后又需等待同样长的时间
+- 后端实际上可能已经完成了任务，但前端放弃了
+
+**修复建议**：
+```typescript
+let consecutiveErrors = 0;
+const MAX_CONSECUTIVE_ERRORS = 3;
+
+while (status === 'pending' || status === 'running') {
+  await new Promise(resolve => setTimeout(resolve, pollInterval));
+  try {
+    const resp = await taskApi.getTaskStatus(taskId);
+    status = resp.status;
+    consecutiveErrors = 0;
+  } catch (err) {
+    consecutiveErrors++;
+    console.warn(`轮询失败 (${consecutiveErrors}/${MAX_CONSECUTIVE_ERRORS}):`, err);
+    if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
+      throw new Error('网络异常，视频状态获取失败，请稍后重试');
+    }
+    // 继续轮询，给用户一个恢复的机会
+  }
+}
+```
+
+---
+
+### 9. 余额获取失败 = 误判为余额不足——有积分却被阻止
+
+**业务场景**：
+1. 用户打开应用，网络较差
+2. `fetchBalance` 调用失败（`console.error` 后静默）
+3. `balance` 保持默认值 `0`
+4. 用户点击「合成视频」
+5. 预检：`currentBalance < requiredPoints` → `0 < 5` → **阻止**
+6. 用户明明有积分，却无法使用
+
+**实际代码**：
+```typescript
+// pointStore.ts
+fetchBalance: async () => {
+  try {
+    const data = await pointsApi.getBalance();
+    set({ balance: data.balance, rules: data.rules });
+  } catch (e) {
+    console.error('获取积分余额失败:', e);  // ❌ 静默失败
+    // balance 保持旧值或 0
+  }
+},
+```
+
+**用户实际看到**：
+- 点击合成按钮后弹出「积分不足」充值弹窗
+- 用户去「我的」页面查看，发现余额显示为 0 或旧值
+- 刷新页面后余额恢复正常
+
+**修复建议**：
+```typescript
+fetchBalance: async () => {
+  try {
+    const data = await pointsApi.getBalance();
+    set({ balance: data.balance, rules: data.rules, balanceError: null });
+  } catch (e) {
+    console.error('获取积分余额失败:', e);
+    set({ balanceError: '获取余额失败，请检查网络' });
+    // balance 保持旧值，不要变成 0
+  }
+},
+
+// 预检时
+if (balanceError) {
+  // 无法确认余额，允许操作但提示风险
+  toast.warn('余额获取失败，将尝试扣费，若余额不足会提示充值');
+  return true;
+}
+```
+
+---
+
+### 10. 多应用实例并发修改导致数据覆盖
+
+**业务场景**：
+1. 用户双击应用图标，意外打开两个窗口（或命令行启动第二个实例）
+2. 实例 A 在 CoverDesign 修改标题为「现代简约风」
+3. 实例 B 在 ScriptCreation 修改主题为「奶油风」
+4. 两个实例同时点击保存
+5. 实例 A 的保存覆盖了实例 B 的修改（或反之）
+
+**根因分析**：
+`saveMetaToLocalFile` 使用 Read-Modify-Write 模式：
+1. 读 `meta.json`
+2. 内存合并
+3. 写 `meta.json`（带文件锁，保证单写）
+
+但文件锁只保护"写"操作，两个实例可以同时读取同一个文件，然后各自基于旧版本修改并写入，导致后写入的覆盖前者。
+
+**用户实际看到**：
+- 在一个窗口里明明保存了修改
+- 切到另一个窗口再切回来，发现修改消失了
+- 用户以为是应用不稳定
+
+**修复建议**：
+1. **应用层单实例锁**：启动时检查是否已有实例在运行
+```rust
+// main.rs
+let single = single_instance::SingleInstance::new("cn.meijiaka.ai-zy").unwrap();
+if !single.is_single() {
+    // 已有实例，唤起旧实例窗口并退出
+    return;
+}
+```
+2. **或文件锁扩展为读写锁**：读取时也加共享锁，防止并发读-改-写
+
+---
+
+### 11. BGM 预览硬编码开发者路径——正式包无法预览系统 BGM
+
+**业务场景**：
+1. 用户安装正式版应用
+2. 进入 BGM 选择弹窗
+3. 点击任意系统 BGM 的试听按钮
+4. 无声音，或报错
+
+**实际代码**：
+```typescript
+// VideoCompose.tsx:113
+const audioSrc = item.url || (item.filePath ? `/Users/0fun/work/meijiaka-zy/mixkit_bgm/${item.filePath}` : '');
+```
+
+当 `item.url` 为空且 `item.filePath` 存在时，构造的路径是开发者本机绝对路径 `/Users/0fun/...`，正式包用户机器上不存在此目录。
+
+**影响评估**：
+- 虽然云端化后 `item.url` 应始终有值，但如果 API 返回异常或旧数据残留，会回退到硬编码路径
+- 开发环境测试时「正常」的功能，正式包上直接失效
+
+**修复建议**：
+直接移除硬编码回退，若 `item.url` 为空则禁用试听：
+```typescript
+const audioSrc = item.url;
+if (!audioSrc) {
+  toast.warn('该音乐暂无可用的试听链接');
+  return;
+}
+```
+
+---
+
+### 12. 封面 Fabric.js 跨域加载失败无用户提示
+
+**业务场景**：
+1. 用户选择一张网络图片作为封面背景
+2. 该图片服务器未配置 CORS 头
+3. `image.crossOrigin = 'anonymous'` 加载失败
+4. `useCoverFabric.ts` 中 catch 静默吞掉错误
+5. Canvas 上背景为空白，用户不知道为什么
+
+**实际代码**：
+```typescript
+// useCoverFabric.ts:192-196
+const image = new Image();
+image.crossOrigin = 'anonymous';
+image.onload = () => resolve(image);
+image.onerror = (e) => reject(e);
+image.src = imagePath;
+// ...
+} catch {
+  // no-op: 背景图加载失败已在内部处理
+}
+```
+
+**用户实际看到**：
+- 选了背景图，但 Canvas 预览为纯色背景
+- 不知道是因为图片跨域、链接失效还是其他原因
+
+**修复建议**：
+在 catch 中区分错误类型并提示：
+```typescript
+} catch (err) {
+  console.error('封面背景加载失败:', err);
+  if (imagePath.startsWith('http')) {
+    toast.error('封面图片加载失败，可能是跨域限制或链接失效，请尝试本地上传');
+  } else {
+    toast.error('封面图片加载失败，文件可能已被移动或删除');
+  }
+}
+```
+
+---
+
+## 四、🟢 低风险/建议（5 项）
+
+### 13. 自动更新后无数据迁移逻辑
+
+**业务场景**：
+1. v1.6.0 用户自动更新到 v1.7.0
+2. v1.7.0 新增了某个必填字段（如 `videoCodec`）
+3. 旧项目加载后该字段为 `undefined`
+4. 如果新功能直接读取此字段不做防御，可能崩溃
+
+**现状**：
+- `migrateMeta` 只处理了 `v0 → v1`（添加 `version` 字段）
+- 注释预留了 `v1 → v2` 的扩展点，但无实际实现
+- Tauri updater 安装后只是重启应用，不触发任何数据迁移
+
+**建议**：
+在应用启动时（`bootstrap` 或 `App.tsx` useEffect）增加一次性的全局迁移检查：
+```typescript
+async function runGlobalMigrations() {
+  const appVersion = await getVersion();
+  const lastMigratedVersion = localStorage.getItem('last_migrated_version');
+  if (lastMigratedVersion === appVersion) return;
+  
+  // 遍历所有本地项目，执行迁移
+  const projects = await localProjectApi.listProjects();
+  for (const project of projects) {
+    const meta = await localProjectApi.loadMeta(project.id);
+    if (meta) {
+      const migrated = migrateMeta(meta);  // 扩展此函数
+      await localProjectApi.saveMeta(project.id, migrated);
+    }
+  }
+  
+  localStorage.setItem('last_migrated_version', appVersion);
+}
+```
+
+---
+
+### 14. 旧字段删除无运行时降级处理
+
+**现状**：
+Git 历史中有多个字段被删除/重命名：
+- `subtitlePreset` → `captionPreset`
+- `dubbingVoiceId` → `selectedVoiceId`
+- `selectedHumanId` / `selectedElementId` 被移除
+- `caption` → `mainTitle`（CoverDesign 中有 fallback）
+
+**当前行为**：
+旧项目加载后，旧字段保留在 `meta.json` 中但被忽略，对应功能降级为默认状态。对用户来说，打开旧项目后发现某些设置"复位"了，但不明白为什么。
+
+**建议**：
+在 `migrateMeta` 中增加字段映射：
+```typescript
+function migrateMeta(raw: Record<string, unknown>): Partial<ProjectMeta> {
+  // v0 → v1
+  if ((raw.version as number) < 1) {
+    raw.version = 1;
+  }
+  
+  // 字段重命名映射
+  if (raw.subtitlePreset && !raw.captionPreset) {
+    raw.captionPreset = raw.subtitlePreset;
+    delete raw.subtitlePreset;
+  }
+  if (raw.dubbingVoiceId && !raw.selectedVoiceId) {
+    raw.selectedVoiceId = raw.dubbingVoiceId;
+    delete raw.dubbingVoiceId;
+  }
+  
+  return raw as Partial<ProjectMeta>;
+}
+```
+
+---
+
+## 五、按业务维度汇总
+
+| 业务维度 | 问题编号 | 核心风险 | 用户感知 |
+|----------|----------|----------|----------|
+| **BGM/音频** | 1, 11 | 合成无声、预览失效 | "为什么选了音乐却没有声音" |
+| **积分/资金** | 2, 9 | 白嫖可能、误判余额不足 | "明明有积分却说不让用" |
+| **数据持久化** | 3, 6, 10, 13, 14 | 换机报废、保存失败无感知、多实例覆盖 | "修改保存后怎么没了" |
+| **视频合成** | 4, 5, 7, 8 | 磁盘满丢失、OOM、分段缺失、长任务闪断 | "等了5分钟结果什么都没有" |
+| **封面/视觉** | 12 | 跨域图片加载失败无提示 | "选了图片但封面是空的" |
+
+---
+
+## 六、修复优先级（按业务影响排序）
+
+### P0（立即修复，影响核心功能或资金）
+1. **#1 BGM 混音链路缺口**：混音前下载 URL 到本地缓存
+2. **#2 积分 TOCTOU**：扣费失败时清理已生成文件，或推动后端预占机制
+3. **#5 大文件 OOM**：上传/下载改用流式传输
+
+### P1（本轮迭代修复，影响体验）
+4. **#4 磁盘满保护**：合成前检查空间，`copy` 失败保留临时文件
+5. **#6 保存失败无提示**：`saveMetaToLocalFile` 错误 toast 提示
+6. **#7 分段配音失败静默**：记录失败段并提示用户
+7. **#8 轮询闪断**：增加网络错误容忍和重试
+8. **#9 余额误判**：余额获取失败时不阻断用户
+
+### P2（后续排期，架构改进）
+9. **#3 项目跨设备迁移**：路径相对化 + 导出/导入功能
+10. **#10 多实例并发**：应用层单实例锁
+11. **#11 BGM 预览硬编码**：移除开发者路径
+12. **#12 封面跨域提示**：增加错误提示
+13. **#13 自动更新迁移**：全局迁移框架
+14. **#14 旧字段映射**：`migrateMeta` 扩展
@@ -0,0 +1,676 @@
+# 前端系统兼容性审查报告
+
+> 审查范围：`tauri-app/src` 全部源码 + `tauri-app/src-tauri/src` Rust 层命令
+> 审查维度：跨平台（macOS/Windows）、Tauri API、媒体/音频、CSS、网络、文件系统
+> 审查日期：2026-05-21
+
+---
+
+## 一、综述
+
+本次审查共发现 **28 项兼容性问题**，其中：
+
+| 级别 | 数量 | 说明 |
+|------|------|------|
+| 🔴 严重 | 6 | 可能导致功能失效、安全漏洞或数据损坏 |
+| 🟡 中等 | 11 | 潜在风险，特定场景下会触发问题 |
+| 🟢 低风险 | 11 | 建议优化，影响较小或仅存在于边缘场景 |
+
+**关键结论**：
+1. **Windows 路径处理是最大隐患**：多处 Rust 代码对 Windows 路径的反斜杠、大小写、UNC 前缀处理不完善，可能导致 FFmpeg 调用失败或安全检查被绕过。
+2. **前端内存泄漏已确认 1 处**：`CoverDesign.tsx` 的 `URL.createObjectURL` 未释放。
+3. **Asset Protocol 过度授权**：`tauri.conf.json` 中 `"scope": "/**"` 允许 WebView 读取整个文件系统。
+4. **CSS/Web API 兼容性良好**：项目运行在 Tauri 封装的 WebView（Edge/WebKit）中，现代 CSS 特性和 Web API 支持度较高，未发现严重兼容性问题。
+
+---
+
+## 二、🔴 严重问题（6 项）
+
+### 1. `URL.createObjectURL` 内存泄漏 — 背景图上传
+
+**位置**：`tauri-app/src/pages/VideoCreation/CoverDesign.tsx:181`
+
+```typescript
+const url = URL.createObjectURL(file);
+setConfig(prev => ({ ...prev, backgroundImage: url }));
+```
+
+**问题**：本地上传背景图时创建 Blob URL，但**从未调用 `URL.revokeObjectURL(url)`**。用户多次上传不同背景图时，旧的 Blob URL 会一直占用内存，直到页面刷新。
+
+**影响**：内存泄漏，长时间使用后可能导致应用卡顿或崩溃。
+
+**修复建议**：
+```typescript
+const prevUrl = config.backgroundImage;
+const url = URL.createObjectURL(file);
+setConfig(prev => ({ ...prev, backgroundImage: url }));
+// 释放旧的 Blob URL
+if (prevUrl?.startsWith('blob:')) {
+  URL.revokeObjectURL(prevUrl);
+}
+// 组件卸载时也要清理
+useEffect(() => {
+  return () => {
+    if (config.backgroundImage?.startsWith('blob:')) {
+      URL.revokeObjectURL(config.backgroundImage);
+    }
+  };
+}, []);
+```
+
+---
+
+### 2. Windows 敏感路径检查大小写不敏感问题
+
+**位置**：`tauri-app/src-tauri/src/commands/file.rs:47`
+
+```rust
+let windows_denied = vec![
+    r"c:\windows\",
+    r"c:\program files\",
+    r"c:\program files (x86)\",
+    r"c:\users\all users\",
+];
+```
+
+**问题**：Windows 文件系统（NTFS）是**大小写保留但大小写不敏感**的。用户传入 `C:\Windows\` 或 `C:\WINDOWS\` 会**完全绕过**上述安全检查。
+
+**影响**：攻击者可通过大小写变体访问系统敏感目录。
+
+**修复建议**：
+```rust
+let path_lower = path.to_lowercase();
+let windows_denied = vec![
+    r"c:\windows\",
+    r"c:\program files\",
+    r"c:\program files (x86)\",
+    r"c:\users\all users\",
+];
+for denied in &windows_denied {
+    if path_lower.starts_with(denied) {
+        return Err(...);
+    }
+}
+```
+
+---
+
+### 3. Asset Protocol 范围过度授权
+
+**位置**：`tauri-app/src-tauri/tauri.conf.json`
+
+```json
+"assetProtocol": {
+  "enable": true,
+  "scope": ["$APPLOCALDATA/**", "$APPDATA/**", "$APPCONFIG/**", "/**"]
+}
+```
+
+**问题**：`/**` 允许 WebView 通过 `asset://` 协议读取**整个文件系统的任何文件**。这意味着前端 JavaScript 可以构造 URL 访问用户的任何本地文件（如 `asset:///etc/passwd` 或 `asset://C:/Users/xxx/Documents/`）。
+
+**影响**：严重安全漏洞。即使需要配合路径遍历，也极大扩大了攻击面。
+
+**修复建议**：移除 `/**`，仅保留应用数据目录：
+```json
+"assetProtocol": {
+  "enable": true,
+  "scope": ["$APPLOCALDATA/**", "$APPDATA/**", "$APPCONFIG/**"]
+}
+```
+
+> 注：如果确有需要访问用户选择的文件，应通过 Tauri Dialog API 让用户主动选择，而非开放全局文件系统。
+
+---
+
+### 4. `escape_ffmpeg_path` 不支持 Windows 路径格式
+
+**位置**：`tauri-app/src-tauri/src/ffmpeg_cmd.rs:23`
+
+```rust
+fn escape_ffmpeg_path(path: &str) -> String {
+    path.replace("'", "'\\''")
+}
+```
+
+**问题**：该函数仅转义单引号，但**不处理 Windows 反斜杠 `\` 和盘符冒号 `:`**。在 FFmpeg 的 `ass='{}':fontsdir='{}'` filter 语法或 concat demuxer 的 `file 'path'` 格式中，Windows 路径如 `C:\Users\name\video.mp4` 中的反斜杠可能被 FFmpeg 解析为转义序列。
+
+**影响**：Windows 用户在字幕压制、字体加载、视频合成时，FFmpeg 可能因路径解析错误而失败。
+
+**修复建议**：
+```rust
+fn escape_ffmpeg_path(path: &str) -> String {
+    // 1. 统一使用正斜杠（FFmpeg 支持跨平台路径分隔符）
+    let normalized = path.replace('\\', "/");
+    // 2. 转义单引号（用于 FFmpeg filter 语法中的引号包裹）
+    normalized.replace("'", "'\\''")
+}
+```
+
+> 注意：Windows 上 `C:/Users/...` 这种正斜杠路径 FFmpeg 完全支持，这是最简单的跨平台方案。
+
+---
+
+### 5. `canonicalize()` 在 Windows 上返回 UNC 路径导致下游问题
+
+**位置**：多处使用 `std::fs::canonicalize`
+
+- `tauri-app/src-tauri/src/commands/product.rs:198,258,345`
+- `tauri-app/src-tauri/src/commands/project.rs:124,140`
+- `tauri-app/src-tauri/src/ffmpeg_cmd.rs:46,792`
+
+**问题**：在 Windows 上，`std::fs::canonicalize()` 返回 UNC 路径格式 `\\?\C:\Users\...`。这种路径格式：
+1. **FFmpeg 某些版本不支持**，可能导致命令执行失败
+2. **与 `starts_with` 比较时行为异常**，如果比较路径不是 UNC 格式
+3. **序列化到 JSON 传给前端时**，前端可能无法正确理解这种路径
+
+**影响**：Windows 上的文件校验、路径比较、FFmpeg 调用可能全部受影响。
+
+**修复建议**：封装一个跨平台的 `normalize_path` 函数，替代 `canonicalize`：
+```rust
+use std::path::{Path, PathBuf};
+
+fn normalize_path(path: &Path) -> PathBuf {
+    // 使用 dunce::simplified() 消除 UNC 前缀，同时保持路径有效性
+    dunce::simplified(path).to_path_buf()
+}
+```
+
+> 需要添加 `dune` crate 依赖，这是 Rust 社区处理 UNC 路径的标准方案。
+
+---
+
+### 6. `atob()` 解析 JWT 存在 base64url 兼容性问题
+
+**位置**：`tauri-app/src/api/client.ts:116`
+
+```typescript
+const payload = JSON.parse(atob(token.split('.')[1]));
+```
+
+**问题**：JWT 使用 **base64url** 编码（将 `+` → `-`，`/` → `_`，去掉 padding `=`），而 `atob()` 是标准 **base64** 解码器。如果 JWT payload 中包含 `-`、`_` 或需要 padding 的字符，`atob()` 会抛出 `DOMException`。
+
+**当前影响有限**：因为 `exp` 字段通常是纯数字时间戳，但理论上如果用户 ID 或其他 claim 包含这些字符就会失败。
+
+**修复建议**：
+```typescript
+function base64UrlDecode(str: string): string {
+  // base64url → base64
+  let padding = '';
+  const padLen = 4 - (str.length % 4);
+  if (padLen !== 4) {
+    padding = '='.repeat(padLen);
+  }
+  const base64 = str.replace(/-/g, '+').replace(/_/g, '/') + padding;
+  return atob(base64);
+}
+
+// 使用
+const payload = JSON.parse(base64UrlDecode(token.split('.')[1]));
+```
+
+---
+
+## 三、🟡 中等问题（11 项）
+
+### 7. `crossOrigin = 'anonymous'` 跨域图片污染 Canvas
+
+**位置**：
+- `tauri-app/src/hooks/useCoverFabric.ts:192,235`
+
+```typescript
+image.crossOrigin = 'anonymous';
+image.src = imagePath;
+```
+
+**问题**：当加载远程 HTTP(S) 图片时，如果服务器未配置 `Access-Control-Allow-Origin` 响应头，Canvas 会被**污染（tainted）**。被污染的 Canvas 调用 `toDataURL()` 会抛出 `SecurityError: The canvas has been tainted by cross-origin data`。
+
+当前代码用 try-catch 静默吞掉了错误，用户会看到空白封面，但不知道原因。
+
+**修复建议**：捕获错误并向用户提示：
+```typescript
+try {
+  // ...加载图片...
+} catch (err) {
+  console.error('封面图片加载失败:', err);
+  toast.error('封面图片加载失败，可能是跨域限制或图片链接失效');
+}
+```
+
+---
+
+### 8. `requestAnimationFrame` + Video 字幕同步在后台标签页节流
+
+**位置**：`tauri-app/src/hooks/useCanvasSubtitleRenderer.ts:158-168`
+
+```typescript
+const onFrame = () => {
+  drawFrame();
+  if (!video.paused) {
+    rafRef.current = requestAnimationFrame(onFrame);
+  }
+};
+```
+
+**问题**：当应用窗口不在前台或标签页在后台时，浏览器会**节流 `requestAnimationFrame`**（通常降到 1fps 或完全暂停）。这会导致 Canvas 字幕与视频画面不同步。
+
+**影响**：用户切出应用再切回时，字幕可能短暂错位。
+
+**修复建议**：使用 `video.requestVideoFrameCallback()`（如果支持）作为更精确的同步机制，或在 `visibilitychange` 事件触发时强制重绘：
+```typescript
+useEffect(() => {
+  const onVisibilityChange = () => {
+    if (!document.hidden) drawFrame();
+  };
+  document.addEventListener('visibilitychange', onVisibilityChange);
+  return () => document.removeEventListener('visibilitychange', onVisibilityChange);
+}, [drawFrame]);
+```
+
+---
+
+### 9. `video` 控制条高度硬编码导致字幕定位偏移
+
+**位置**：`tauri-app/src/hooks/useCanvasSubtitleRenderer.ts:86`
+
+```typescript
+const VIDEO_CONTROLS_HEIGHT = 40;
+```
+
+**问题**：`<video controls>` 的控制条高度在不同浏览器/OS 上不同（macOS Safari 约 30px，Windows 约 40-50px，全屏模式约 0px）。硬编码 40px 会导致字幕在预览时的垂直位置与压制输出不完全一致。
+
+**修复建议**：在视频元数据加载后动态计算：
+```typescript
+const video = videoRef.current;
+if (video) {
+  const rect = video.getBoundingClientRect();
+  const videoRect = video.videoWidth / video.videoHeight;
+  // 实际视频画面高度 = 容器宽度 / 宽高比
+  const actualVideoHeight = rect.width / videoRect;
+  const controlsHeight = rect.height - actualVideoHeight;
+}
+```
+
+---
+
+### 10. `audio.duration` 可能返回 `NaN`/`Infinity` 未处理
+
+**位置**：
+- `tauri-app/src/pages/VideoCreation/VoiceSynthesis.tsx:360-367`
+- `tauri-app/src/pages/VideoGeneration/hooks/useVideoGeneration.ts:371-378`
+- `tauri-app/src/pages/ContentManagement/VoiceMaterialLibrary.tsx:163-178`
+
+```typescript
+audio.onloadedmetadata = () => {
+  clearTimeout(timeoutId);
+  resolve(audio.duration);
+};
+```
+
+**问题**：如果音频文件损坏、格式不支持或元数据缺失，`audio.duration` 可能返回 `NaN` 或 `Infinity`。直接 resolve 这个值会导致下游计算错误。
+
+**修复建议**：
+```typescript
+audio.onloadedmetadata = () => {
+  clearTimeout(timeoutId);
+  if (!isFinite(audio.duration) || audio.duration <= 0) {
+    reject(new Error('音频时长无效，文件可能损坏或格式不支持'));
+  } else {
+    resolve(audio.duration);
+  }
+};
+```
+
+---
+
+### 11. `rename` 在 Windows 上目标已存在时失败
+
+**位置**：
+- `tauri-app/src-tauri/src/video_processing.rs:93`
+- `tauri-app/src-tauri/src/commands/video_compose.rs:222`
+
+**问题**：`std::fs::rename()` 在 Windows 上**如果目标文件已存在会直接失败**（Unix 是原子替换）。代码虽然有 copy 回退，但逻辑可能留下残留文件。
+
+**影响**：Windows 上如果输出路径已存在（如用户重复合成），操作可能失败或留下临时文件。
+
+**修复建议**：在 `rename` 前先删除目标文件（如果存在）：
+```rust
+if output_path.exists() {
+    std::fs::remove_file(&output_path)?;
+}
+std::fs::rename(&temp_output, &output_path)?;
+```
+
+---
+
+### 12. `to_str().unwrap()` 在非 UTF-8 路径上会 panic
+
+**位置**：`tauri-app/src-tauri/src/commands/video_compose.rs:80`
+
+```rust
+concat_videos_copy(&app, list_path.to_str().unwrap(), ...)
+```
+
+**问题**：Windows 允许非 UTF-8 编码的文件路径（历史 OEM code page 文件）。`to_str()` 返回 `None`，`unwrap()` 会**直接 panic**。
+
+**影响**：极少数 Windows 用户（使用中文 Windows 95/XP 时代遗留文件系统编码）可能导致应用崩溃。
+
+**修复建议**：使用 `to_string_lossy()` 或 `as_os_str()` 传递路径：
+```rust
+// 如果需要传给 FFmpeg，使用 to_string_lossy()
+let path_str = list_path.to_string_lossy();
+```
+
+---
+
+### 13. `get_fonts_dir` 开发模式路径探测在 Windows 上可能失效
+
+**位置**：`tauri-app/src-tauri/src/ffmpeg_cmd.rs:298-328`
+
+```rust
+cwd.join("fonts"),
+parent.join("src-tauri/fonts"),
+grandparent.join("tauri-app/src-tauri/fonts"),
+```
+
+**问题**：开发模式下的字体目录探测使用 `/` 路径拼接。虽然 `PathBuf::join` 会处理分隔符，但如果开发时的**当前工作目录**与预期不同（如从 IDE 以不同路径启动），探测会失败。
+
+**影响**：开发环境下 Windows 开发者可能遇到字体加载失败。
+
+**修复建议**：添加环境变量覆盖或更健壮的探测逻辑：
+```rust
+// 优先从环境变量读取
+if let Ok(font_dir) = std::env::var("MEIJIAKA_FONTS_DIR") {
+    let p = PathBuf::from(font_dir);
+    if p.exists() { return Some(p); }
+}
+```
+
+---
+
+### 14. `concat` demuxer 列表中的 Windows 反斜杠问题
+
+**位置**：`tauri-app/src-tauri/src/commands/video_compose.rs:65`
+
+```rust
+format!("file '{}'\n", ffmpeg_cmd::escape_ffmpeg_path(path))
+```
+
+**问题**：FFmpeg concat demuxer 的列表文件格式中，`file 'path'` 语法在 Windows 上如果路径包含反斜杠，反斜杠可能被 FFmpeg 解释为转义字符。
+
+**影响**：与问题 #4 类似，Windows 路径导致 FFmpeg 解析错误。
+
+**修复建议**：在写入 concat 列表前统一将路径中的 `\` 替换为 `/`：
+```rust
+let normalized = path.replace('\\', "/");
+format!("file '{}'\n", normalized)
+```
+
+---
+
+### 15. `load_app_config` 失败时无降级配置
+
+**位置**：`tauri-app/src/main.tsx:10-16`
+
+```typescript
+try {
+  const config = await loadAppConfig();
+  appEnvironment = config.environment;
+} catch {
+  // 加载失败时默认为生产模式
+}
+```
+
+**问题**：如果 `load_app_config`（Tauri IPC 调用）失败，应用降级为生产模式。这是合理的，但**生产模式会禁用右键菜单和 F12 DevTools**。开发者在调试时如果 IPC 调用失败，会突然失去所有调试能力，且不知道原因。
+
+**修复建议**：在降级时输出警告日志：
+```typescript
+} catch (e) {
+  console.warn('[bootstrap] 加载应用配置失败，降级为生产模式:', e);
+  appEnvironment = 'production';
+}
+```
+
+---
+
+### 16. `window.location.reload()` 在 Tauri 中行为不确定
+
+**位置**：`tauri-app/src/pages/Settings/Settings.tsx:178`
+
+```typescript
+setTimeout(() => { window.location.reload(); }, 500);
+```
+
+**问题**：Tauri 应用中的 `window.location.reload()` 行为与浏览器不同。在某些 Tauri 版本中可能导致：
+- 白屏而非正常刷新
+- WebView 进程崩溃
+- 状态丢失但窗口不重新加载
+
+**修复建议**：使用 Tauri 的 `relaunch()` 命令重启整个应用，或重新挂载 React 根组件：
+```typescript
+import { relaunch } from '@tauri-apps/plugin-process';
+// 重启应用
+await relaunch();
+```
+
+---
+
+### 17. `Math.random()` 用于缓存清除参数（安全性）
+
+**位置**：`tauri-app/src/api/client.ts:334`
+
+```typescript
+const cacheBuster = `_t=${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+```
+
+**问题**：`Math.random()` 不是加密安全的随机数生成器。虽然这里只是用于缓存清除，但如果未来用于其他安全相关场景会有风险。
+
+**修复建议**：使用 `crypto.randomUUID()` 或 `crypto.getRandomValues()`：
+```typescript
+const cacheBuster = `_t=${Date.now()}_${crypto.randomUUID().slice(0, 8)}`;
+```
+
+---
+
+## 四、🟢 低风险/建议（11 项）
+
+### 18. `backdrop-filter` 无标准前缀回退
+
+**位置**：`tauri-app/src/pages/VideoCreation/CoverDesign.css:444-445`
+
+```css
+backdrop-filter: blur(6px);
+-webkit-backdrop-filter: blur(6px);
+```
+
+**评估**：当前代码同时有标准和 WebKit 前缀版本，在 Tauri WebView（Edge/WebKit）中支持良好。Firefox 不支持，但项目不面向 Firefox。**无需修复**。
+
+---
+
+### 19. `::-webkit-scrollbar` 在 Firefox 中无效
+
+**位置**：多处（`global.css`、`CoverDesign.css` 等）
+
+**评估**：项目运行在 Tauri WebView 中（基于系统浏览器引擎），不是 Firefox。在 Windows 上基于 WebView2（Edge），macOS 上基于 WKWebView（Safari），均支持 WebKit 滚动条样式。**无需修复**。
+
+---
+
+### 20. `aspect-ratio` 在旧版 Safari 中可能不支持
+
+**位置**：多处使用 `aspect-ratio: 9 / 16`
+
+**评估**：macOS 12+ 的 Safari 支持 `aspect-ratio`。如果目标用户可能使用较旧的 macOS 版本，可能需要 `padding-top: 177.77%` 回退。但鉴于这是 Tauri 桌面应用，可以控制最低系统版本。**建议确认 `tauri.conf.json` 中 `macOS.minimumSystemVersion` 是否要求 12.0+**。
+
+---
+
+### 21. `requestIdleCallback` 缺失回退不完整
+
+**位置**：`tauri-app/src/main.tsx:75-79`
+
+```typescript
+if ('requestIdleCallback' in window) {
+  requestIdleCallback(showWindow, { timeout: 500 });
+} else {
+  setTimeout(showWindow, 100);
+}
+```
+
+**评估**：Tauri WebView2（Edge）和 WKWebView（Safari）均支持 `requestIdleCallback`。回退逻辑也已实现。**无需修复**。
+
+---
+
+### 22. `navigator.userAgent` 已被冻结
+
+**位置**：
+- `tauri-app/src/store/authStore.ts:254`
+- `tauri-app/src/api/client.ts:259`
+
+**评估**：虽然现代浏览器正在限制 `navigator.userAgent`，但 Tauri WebView 不受此限制。且当前用法仅为日志和登录信息上报，不影响功能。**无需修复**。
+
+---
+
+### 23. `document.fonts.check()` 参数格式兼容性
+
+**位置**：`tauri-app/src/utils/canvasSubtitleDrawer.ts:209`
+
+```typescript
+if (document.fonts.check(`bold 16px ${fontName}`)) {
+```
+
+**评估**：`document.fonts.check()` 的参数格式在不同浏览器中实现有细微差异，但 Tauri WebView2/WKWebView 均支持此用法。**风险极低**。
+
+---
+
+### 24. `Date.now()` 连续调用可能冲突
+
+**位置**：多处使用 `Date.now()` 生成文件名
+
+**评估**：仅在极快速连续调用时（<1ms）可能冲突。当前场景下不太可能。**风险极低**。
+
+---
+
+### 25. `autoPlay` 视频可能被浏览器阻止
+
+**位置**：多处 `<video autoPlay>`
+
+**评估**：桌面应用中的 WebView 通常不受浏览器自动播放策略限制。但如果用户操作系统设置了辅助功能限制，仍可能被阻止。**建议添加 `muted` 属性作为后备**（如果需要自动播放且带声音）。
+
+---
+
+### 26. `file.path` 是非标准 Chromium 属性
+
+**位置**：`tauri-app/src/pages/VideoCreation/CoverDesign.tsx:178`
+
+```typescript
+const path = (file as any).path || (file as any).webkitRelativePath || '';
+```
+
+**评估**：`File.path` 是 Chromium 的私有属性，在标准浏览器（Firefox）中不存在。但由于项目运行在 Tauri（Chromium/WebView2）中，这**当前是可行的**。但如果未来需要支持 Web 端部署，需要改用 Tauri Dialog API 获取路径。**建议添加注释说明此依赖**。
+
+---
+
+### 27. `storage/engine.rs` 无 Windows 文件权限设置
+
+**位置**：`tauri-app/src-tauri/src/storage/engine.rs:161`
+
+```rust
+#[cfg(unix)]
+fn set_restrictive_permissions(path: &Path) -> Result<()> {
+    use std::os::unix::fs::PermissionsExt;
+    let mut perms = std::fs::metadata(path)?.permissions();
+    perms.set_mode(0o600);
+    std::fs::set_permissions(path, perms)?;
+    Ok(())
+}
+```
+
+**评估**：Unix 上设置了 0o600 权限，Windows 上跳过。Windows 上文件默认对用户可读可写，其他用户也可读（取决于 ACL）。虽然这不是严重安全问题（应用数据存储在用户目录），但**建议在 Windows 上设置等效的 ACL 限制**。
+
+**修复建议**：
+```rust
+#[cfg(windows)]
+fn set_restrictive_permissions(path: &Path) -> Result<()> {
+    // 使用 windows  crate 或 fs_extra 设置 ACL
+    // 简化为仅当前用户可读写
+    // 这是可选优化，优先级低
+    Ok(())
+}
+```
+
+---
+
+### 28. `Slider.css` 和 `CoverDesign.css` 中 `appearance` 重复声明
+
+**位置**：
+- `tauri-app/src/components/Slider/Slider.css:32-33`
+- `tauri-app/src/pages/VideoCreation/CoverDesign.css:79-80`
+
+```css
+appearance: none;
+appearance: none;
+```
+
+**评估**：纯代码质量问题，不影响兼容性。**建议移除重复行**。
+
+---
+
+## 五、按维度汇总表
+
+| 维度 | 严重 | 中等 | 低风险 | 主要文件 |
+|------|------|------|--------|----------|
+| **内存/资源管理** | 1 (#1) | 1 (#10) | 1 (#24) | CoverDesign.tsx, VoiceSynthesis.tsx |
+| **Windows 路径** | 2 (#4, #5) | 3 (#11, #12, #14) | 1 (#27) | ffmpeg_cmd.rs, file.rs, product.rs |
+| **安全检查** | 2 (#2, #3) | 0 | 0 | file.rs, tauri.conf.json |
+| **Canvas/媒体** | 0 | 3 (#7, #8, #9) | 2 (#20, #25) | useCoverFabric.ts, useCanvasSubtitleRenderer.ts |
+| **网络/API** | 1 (#6) | 1 (#17) | 2 (#22, #23) | client.ts |
+| **Tauri 原生** | 0 | 1 (#16) | 1 (#26) | Settings.tsx, CoverDesign.tsx |
+| **CSS** | 0 | 0 | 3 (#18, #19, #28) | CoverDesign.css, global.css |
+| **启动/配置** | 0 | 1 (#15) | 1 (#21) | main.tsx |
+| **字体加载** | 0 | 1 (#13) | 0 | ffmpeg_cmd.rs |
+
+---
+
+## 六、修复优先级建议
+
+### 立即修复（影响功能/安全）
+
+1. **#3 Asset Protocol 过度授权** — 安全漏洞，一行配置修改
+2. **#2 Windows 敏感路径大小写** — 安全检查被绕过
+3. **#1 URL.createObjectURL 泄漏** — 内存泄漏，用户可见
+4. **#4 escape_ffmpeg_path Windows 支持** — Windows 功能失效
+5. **#5 canonicalize() UNC 路径** — Windows 文件操作异常
+
+### 本轮迭代修复（影响体验）
+
+6. **#6 atob() base64url 兼容性** — Token 解析潜在失败
+7. **#7 crossOrigin 图片污染提示** — 用户友好性
+8. **#8 RAF 后台节流** — 字幕同步
+9. **#10 audio.duration NaN 处理** — 音频处理健壮性
+10. **#9 控制条高度硬编码** — 预览准确性
+11. **#11 Windows rename 已存在** — 文件操作健壮性
+
+### 后续排期（优化/边缘场景）
+
+12-28. 其余低风险项
+
+---
+
+## 七、特别说明：Tauri 环境 vs 浏览器环境的兼容性差异
+
+本项目同时支持两种运行模式：
+
+| 特性 | Tauri 桌面模式 | 浏览器模式（开发调试用） |
+|------|---------------|------------------------|
+| `invoke()` | ✅ Tauri IPC | ❌ 会 catch 失败 |
+| `convertFileSrc()` | ✅ `asset://` | ❌ 会 catch 失败 |
+| `localStorage` | ✅ 可用 | ✅ 可用 |
+| File 系统 API | ✅ Tauri 插件 | ❌ 不可用 |
+| `__TAURI_INTERNALS__` | ✅ 存在 | ❌ 不存在 |
+
+**当前代码对浏览器模式有降级处理**（`isTauri()` 检查 + catch 错误），这是好的实践。但以下功能在浏览器模式下完全不可用，需要评估是否影响开发调试：
+
+- 本地视频预览（依赖 `asset://` + FFmpeg 转码）
+- 文件保存/导出（依赖 Tauri Dialog）
+- 项目本地持久化（依赖 Tauri IPC）
+- 自动更新（依赖 Tauri Updater）
+
+**建议**：在 `README` 或开发文档中明确列出浏览器模式的功能限制，避免开发者困惑。
@@ -0,0 +1,336 @@
+# Mixkit 免版权音乐清单（装修行业口播短视频）
+
+> 来源: Mixkit.co（免版税、无需署名、可商用）
+> 下载时间: 2026-05-23
+> 总计: 129 首 / 616 MB
+
+---
+
+## 分类说明
+
+| 分类 | 适用场景 | 数量 |
+|------|----------|------|
+| **知识科普** | 装修避坑、材料选择、流程科普 | 66 首 |
+| **案例展示** | 完工验收、前后对比、实景展示 | 49 首 |
+| **促销活动** | 开业促销、团购活动、限时优惠 | 49 首 |
+| **家居生活** | 软装搭配、生活 vlog、温馨家庭 | 54 首 |
+| **智能家居** | 全屋智能、现代设计、灯光系统 | 48 首 |
+
+---
+
+## 一、知识科普（专业可信，不抢戏）
+
+| ID | 音乐名 | 艺术家 |
+|----|--------|--------|
+| 22 | Piano Reflections | Ahjay Stelino |
+| 105 | See Line Funk | Alejandro Magaña |
+| 113 | House Fest | Alejandro Magaña (A. M.) |
+| 114 | Kodama Night Town | Alejandro Magaña (A. M.) |
+| 1167 | Close Up | Michael Ramir C. |
+| 124 | Techno Fest Vibes | Alejandro Magaña (A. M.) |
+| 127 | Valley Sunset | Alejandro Magaña (A. M.) |
+| 132 | Hazy After Hours | Alejandro Magaña (A. M.) |
+| 134 | Deep Techno Ambience | Alejandro Magaña (A. M.) |
+| 138 | Forest Treasure | Alejandro Magaña (A. M.) |
+| 139 | Spirit in the Woods | Alejandro Magaña (A. M.) |
+| 147 | Spirit in the Woods 2 | Alejandro Magaña (A. M.) |
+| 160 | Minimal Emotion | Alejandro Magaña (A. M.) |
+| 162 | Minimal Techno 01 | Alejandro Magaña (A. M.) |
+| 168 | Staring at the Night Sky | Alejandro Magaña (A. M.) |
+| 169 | Zanarkand Forest | Alejandro Magaña (A. M.) |
+| 175 | Digital Clouds | Alejandro Magaña (A. M.) |
+| 184 | Vastness | Andrew Ev |
+| 251 | Ambient | Arulo |
+| 292 | Relax Beat | Arulo |
+| 324 | Smooth Meditation | Arulo |
+| 340 | Nap Time | Arulo |
+| 371 | Cat Walk | Arulo |
+| 416 | Young Trizzy | Arulo |
+| 441 | Meditation | Arulo |
+| 443 | Serene View | Arulo |
+| 470 | Golden Storm | Diego Nava |
+| 471 | Rising Forest | Diego Nava |
+| 480 | Curiosity | Diego Nava |
+| 493 | Beautiful Dream | Diego Nava |
+| 568 | Focus on Yourself | Eugenio Mininni |
+| 584 | Rest Now | Eugenio Mininni |
+| 593 | Opalescent | Eugenio Mininni |
+| 594 | River Flow | Eugenio Mininni |
+| 616 | What it Takes | Eugenio Mininni |
+| 617 | Wind Leaves | Eugenio Mininni |
+| 620 | B.O.R.N | Eugenio Mininni |
+| 623 | Deep Urban | Eugenio Mininni |
+| 628 | Summer Dream | Eugenio Mininni |
+| 629 | Skeeomaver Sound | Eugenio Mininni |
+| 633 | Xanthos | Eugenio Mininni |
+| 652 | Soul Jazz | Francisco Alvear |
+| 664 | Pop One | Francisco Alvear |
+| 695 | Pop 05 | Grigoriy Nuzhny |
+| 700 | Pop 03 | Grigoriy Nuzhny |
+| 713 | Classical 6 | Jonny S. |
+| 720 | New Bass 01 | Lily J |
+| 726 | Uplifting Bass | Lily J |
+| 729 | Pop Track 03 | Lily J |
+| 738 | Hip Hop 02 | Lily J |
+| 744 | House 02 | Lily J |
+| 749 | Relaxation 05 | Lily J |
+| 759 | Romantic 05 | Lily J |
+| 770 | Autofahren | Mauro Urbina |
+| 779 | Oh | Michael Ramir C. |
+| 801 | Happy Home | Michael Ramir C. |
+| 802 | Here Comes The Train | Michael Ramir C. |
+| 804 | I Love You Grandma | Michael Ramir C. |
+| 813 | Magical moment | Michael Ramir C. |
+| 816 | Please | Michael Ramir C. |
+| 821 | At the Playhouse | Michael Ramir C. |
+| 832 | I'm Going Home | Michael Ramir C. |
+| 834 | It's Love | Michael Ramir C. |
+| 837 | Life is a Dream | Michael Ramir C. |
+| 839 | Tears of Joy | Michael Ramir C. |
+| 840 | That's the Way of Life | Michael Ramir C. |
+| 847 | It's April | Michael Ramir C. |
+| 852 | Music and Life | Michael Ramir C. |
+| 856 | Salty and Sweet | Michael Ramir C. |
+| 872 | Gimme that Groove! | Michael Ramir C. |
+| 897 | A Very Happy Christmas | Michael Ramir C. |
+| 953 | Feel Alive | Michael Ramir C. |
+| 963 | Just Keep Walking | Michael Ramir C. |
+| 970 | Night Sky Hip Hop | Michael Ramir C. |
+| 993 | Finding Myself | Michael Ramir C. |
+| 1000 | I Can Hear Your Heartbeat | Michael Ramir C. |
+| 1001 | I Do! | Michael Ramir C. |
+| 1052 | Baby Yohan | Michael Ramir C. |
+| 1081 | We'll Be Okay | Michael Ramir C. |
+| 1140 | Funkee Monkeee | Michael Ramir C. |
+| 1183 | Karma | Michael Ramir C. |
+| 1210 | Can't Get You Off My Mind | Michael Ramir C. |
+
+## 二、案例展示（有成就感、积极）
+
+| ID | 音乐名 | 艺术家 |
+|----|--------|--------|
+| 3 | Dance with Me | Ahjay Stelino |
+| 4 | Delightful | Ahjay Stelino |
+| 5 | Feeling Happy | Ahjay Stelino |
+| 8 | Jumping Around | Ahjay Stelino |
+| 11 | Just Kidding | Ahjay Stelino |
+| 12 | Playground Fun | Ahjay Stelino |
+| 13 | Summer Fun | Ahjay Stelino |
+| 31 | Dreaming Big | Ahjay Stelino |
+| 32 | Driving Ambition | Ahjay Stelino |
+| 34 | Raising Me Higher | Ahjay Stelino |
+| 91 | Summer's Here | Ahjay Stelino |
+| 288 | One More Dance | Arulo |
+| 339 | Villa Penthouse | Arulo |
+| 350 | Follow Me Home | Arulo |
+| 528 | You Got Jazz | Diego Nava |
+| 529 | Walking in the Park | Diego Nava |
+| 532 | A Happy Child | Diego Nava |
+| 621 | BRIDGE No 98 | Eugenio Mininni |
+| 684 | Classical vibes 4 | Grigoriy Nuzhny |
+| 801 | Happy Home | Michael Ramir C. |
+| 823 | Be Happy 2 | Michael Ramir C. |
+| 839 | Tears of Joy | Michael Ramir C. |
+| 872 | Gimme that Groove! | Michael Ramir C. |
+| 897 | A Very Happy Christmas | Michael Ramir C. |
+| 953 | Feel Alive | Michael Ramir C. |
+| 1000 | I Can Hear Your Heartbeat | Michael Ramir C. |
+| 1001 | I Do! | Michael Ramir C. |
+| 1052 | Baby Yohan | Michael Ramir C. |
+| 1140 | Funkee Monkeee | Michael Ramir C. |
+| 1183 | Karma | Michael Ramir C. |
+| 1210 | Can't Get You Off My Mind | Michael Ramir C. |
+
+## 三、促销活动（轻快、有能量）
+
+同案例展示分类，推荐节奏更欢快的:
+- 3.mp3, 4.mp3, 5.mp3, 8.mp3, 11.mp3, 12.mp3, 13.mp3, 31.mp3, 32.mp3, 34.mp3, 91.mp3
+- 288.mp3, 339.mp3, 350.mp3, 528.mp3, 529.mp3, 532.mp3, 621.mp3
+- 801.mp3, 823.mp3, 839.mp3, 872.mp3, 897.mp3, 953.mp3
+- 1000.mp3, 1001.mp3, 1052.mp3, 1140.mp3, 1183.mp3, 1210.mp3
+
+## 四、家居生活（温馨、治愈）
+
+| ID | 音乐名 | 艺术家 |
+|----|--------|--------|
+| 22 | Piano Reflections | Ahjay Stelino |
+| 127 | Valley Sunset | Alejandro Magaña (A. M.) |
+| 138 | Forest Treasure | Alejandro Magaña (A. M.) |
+| 139 | Spirit in the Woods | Alejandro Magaña (A. M.) |
+| 147 | Spirit in the Woods 2 | Alejandro Magaña (A. M.) |
+| 168 | Staring at the Night Sky | Alejandro Magaña (A. M.) |
+| 169 | Zanarkand Forest | Alejandro Magaña (A. M.) |
+| 199 | Loner | Arulo |
+| 250 | Island Beat | Arulo |
+| 282 | Sweet September | Arulo |
+| 292 | Relax Beat | Arulo |
+| 322 | Life's a Movie | Arulo |
+| 324 | Smooth Meditation | Arulo |
+| 340 | Nap Time | Arulo |
+| 345 | Nature Meditation | Arulo |
+| 350 | Follow Me Home | Arulo |
+| 416 | Young Trizzy | Arulo |
+| 441 | Meditation | Arulo |
+| 442 | Nature Yoga | Arulo |
+| 443 | Serene View | Arulo |
+| 444 | Yoga Song | Arulo |
+| 493 | Beautiful Dream | Diego Nava |
+| 528 | You Got Jazz | Diego Nava |
+| 529 | Walking in the Park | Diego Nava |
+| 532 | A Happy Child | Diego Nava |
+| 568 | Focus on Yourself | Eugenio Mininni |
+| 584 | Rest Now | Eugenio Mininni |
+| 593 | Opalescent | Eugenio Mininni |
+| 594 | River Flow | Eugenio Mininni |
+| 617 | Wind Leaves | Eugenio Mininni |
+| 620 | B.O.R.N | Eugenio Mininni |
+| 623 | Deep Urban | Eugenio Mininni |
+| 628 | Summer Dream | Eugenio Mininni |
+| 629 | Skeeomaver Sound | Eugenio Mininni |
+| 633 | Xanthos | Eugenio Mininni |
+| 652 | Soul Jazz | Francisco Alvear |
+| 664 | Pop One | Francisco Alvear |
+| 695 | Pop 05 | Grigoriy Nuzhny |
+| 700 | Pop 03 | Grigoriy Nuzhny |
+| 713 | Classical 6 | Jonny S. |
+| 720 | New Bass 01 | Lily J |
+| 726 | Uplifting Bass | Lily J |
+| 729 | Pop Track 03 | Lily J |
+| 738 | Hip Hop 02 | Lily J |
+| 744 | House 02 | Lily J |
+| 749 | Relaxation 05 | Lily J |
+| 759 | Romantic 05 | Lily J |
+| 770 | Autofahren | Mauro Urbina |
+| 779 | Oh | Michael Ramir C. |
+| 801 | Happy Home | Michael Ramir C. |
+| 802 | Here Comes The Train | Michael Ramir C. |
+| 804 | I Love You Grandma | Michael Ramir C. |
+| 813 | Magical moment | Michael Ramir C. |
+| 816 | Please | Michael Ramir C. |
+| 821 | At the Playhouse | Michael Ramir C. |
+| 832 | I'm Going Home | Michael Ramir C. |
+| 834 | It's Love | Michael Ramir C. |
+| 837 | Life is a Dream | Michael Ramir C. |
+| 839 | Tears of Joy | Michael Ramir C. |
+| 840 | That's the Way of Life | Michael Ramir C. |
+| 847 | It's April | Michael Ramir C. |
+| 852 | Music and Life | Michael Ramir C. |
+| 856 | Salty and Sweet | Michael Ramir C. |
+| 872 | Gimme that Groove! | Michael Ramir C. |
+| 897 | A Very Happy Christmas | Michael Ramir C. |
+| 953 | Feel Alive | Michael Ramir C. |
+| 963 | Just Keep Walking | Michael Ramir C. |
+| 970 | Night Sky Hip Hop | Michael Ramir C. |
+| 993 | Finding Myself | Michael Ramir C. |
+| 1000 | I Can Hear Your Heartbeat | Michael Ramir C. |
+| 1001 | I Do! | Michael Ramir C. |
+| 1052 | Baby Yohan | Michael Ramir C. |
+| 1081 | We'll Be Okay | Michael Ramir C. |
+| 1140 | Funkee Monkeee | Michael Ramir C. |
+| 1167 | Close Up | Michael Ramir C. |
+| 1183 | Karma | Michael Ramir C. |
+| 1210 | Can't Get You Off My Mind | Michael Ramir C. |
+
+## 五、智能家居（科技感、高级感）
+
+| ID | 音乐名 | 艺术家 |
+|----|--------|--------|
+| 105 | See Line Funk | Alejandro Magaña |
+| 113 | House Fest | Alejandro Magaña (A. M.) |
+| 114 | Kodama Night Town | Alejandro Magaña (A. M.) |
+| 122 | Slow Rain | Alejandro Magaña (A. M.) |
+| 124 | Techno Fest Vibes | Alejandro Magaña (A. M.) |
+| 130 | Tech House vibes | Alejandro Magaña (A. M.) |
+| 132 | Hazy After Hours | Alejandro Magaña (A. M.) |
+| 134 | Deep Techno Ambience | Alejandro Magaña (A. M.) |
+| 136 | Infected Mushroom Vibes | Alejandro Magaña (A. M.) |
+| 137 | Goa Trance Mantra | Alejandro Magaña (A. M.) |
+| 140 | Cyberpunk City | Alejandro Magaña (A. M.) |
+| 157 | Infected Vibes | Alejandro Magaña (A. M.) |
+| 160 | Minimal Emotion | Alejandro Magaña (A. M.) |
+| 162 | Minimal Techno 01 | Alejandro Magaña (A. M.) |
+| 166 | Trance Party | Alejandro Magaña (A. M.) |
+| 173 | Better Times are Coming | Alejandro Magaña (A. M.) |
+| 175 | Digital Clouds | Alejandro Magaña (A. M.) |
+| 180 | Gear | Andrew Ev |
+| 181 | Pop | Andrew Ev |
+| 184 | Vastness | Andrew Ev |
+| 199 | Loner | Arulo |
+| 251 | Ambient | Arulo |
+| 292 | Relax Beat | Arulo |
+| 324 | Smooth Meditation | Arulo |
+| 340 | Nap Time | Arulo |
+| 371 | Cat Walk | Arulo |
+| 416 | Young Trizzy | Arulo |
+| 441 | Meditation | Arulo |
+| 442 | Nature Yoga | Arulo |
+| 443 | Serene View | Arulo |
+| 444 | Yoga Song | Arulo |
+| 464 | Sci-Fi Score | Arulo |
+| 470 | Golden Storm | Diego Nava |
+| 471 | Rising Forest | Diego Nava |
+| 480 | Curiosity | Diego Nava |
+| 517 | Jungle Voices | Diego Nava |
+| 568 | Focus on Yourself | Eugenio Mininni |
+| 584 | Rest Now | Eugenio Mininni |
+| 593 | Opalescent | Eugenio Mininni |
+| 594 | River Flow | Eugenio Mininni |
+| 609 | Moon Walk | Eugenio Mininni |
+| 616 | What it Takes | Eugenio Mininni |
+| 617 | Wind Leaves | Eugenio Mininni |
+| 620 | B.O.R.N | Eugenio Mininni |
+| 623 | Deep Urban | Eugenio Mininni |
+| 628 | Summer Dream | Eugenio Mininni |
+| 629 | Skeeomaver Sound | Eugenio Mininni |
+| 633 | Xanthos | Eugenio Mininni |
+| 652 | Soul Jazz | Francisco Alvear |
+| 664 | Pop One | Francisco Alvear |
+| 695 | Pop 05 | Grigoriy Nuzhny |
+| 700 | Pop 03 | Grigoriy Nuzhny |
+| 713 | Classical 6 | Jonny S. |
+| 720 | New Bass 01 | Lily J |
+| 726 | Uplifting Bass | Lily J |
+| 729 | Pop Track 03 | Lily J |
+| 738 | Hip Hop 02 | Lily J |
+| 744 | House 02 | Lily J |
+| 749 | Relaxation 05 | Lily J |
+| 759 | Romantic 05 | Lily J |
+| 770 | Autofahren | Mauro Urbina |
+| 779 | Oh | Michael Ramir C. |
+| 801 | Happy Home | Michael Ramir C. |
+| 802 | Here Comes The Train | Michael Ramir C. |
+| 804 | I Love You Grandma | Michael Ramir C. |
+| 813 | Magical moment | Michael Ramir C. |
+| 816 | Please | Michael Ramir C. |
+| 821 | At the Playhouse | Michael Ramir C. |
+| 832 | I'm Going Home | Michael Ramir C. |
+| 834 | It's Love | Michael Ramir C. |
+| 837 | Life is a Dream | Michael Ramir C. |
+| 839 | Tears of Joy | Michael Ramir C. |
+| 840 | That's the Way of Life | Michael Ramir C. |
+| 847 | It's April | Michael Ramir C. |
+| 852 | Music and Life | Michael Ramir C. |
+| 856 | Salty and Sweet | Michael Ramir C. |
+| 872 | Gimme that Groove! | Michael Ramir C. |
+| 897 | A Very Happy Christmas | Michael Ramir C. |
+| 953 | Feel Alive | Michael Ramir C. |
+| 963 | Just Keep Walking | Michael Ramir C. |
+| 970 | Night Sky Hip Hop | Michael Ramir C. |
+| 993 | Finding Myself | Michael Ramir C. |
+| 1000 | I Can Hear Your Heartbeat | Michael Ramir C. |
+| 1001 | I Do! | Michael Ramir C. |
+| 1052 | Baby Yohan | Michael Ramir C. |
+| 1081 | We'll Be Okay | Michael Ramir C. |
+| 1140 | Funkee Monkeee | Michael Ramir C. |
+| 1167 | Close Up | Michael Ramir C. |
+| 1183 | Karma | Michael Ramir C. |
+| 1210 | Can't Get You Off My Mind | Michael Ramir C. |
+
+---
+
+## 使用说明
+
+1. 所有音乐文件在 `mixkit_bgm/` 目录下，文件名为 `{ID}.mp3`
+2. 运营人员可试听挑选，将选中的音乐上传到七牛云 CDN
+3. 上传后通过 `POST /api/v1/update/releases` 或直接写 SQL 入库
+4. 分类字段建议: `knowledge` | `showcase` | `promotion` | `lifestyle` | `tech`
@@ -1,260 +0,0 @@
-# 项目名词统一梳理报告
-
-> 本文档梳理了美家卡智影项目中所有核心功能在用户界面和开发代码中的命名现状，识别出不一致问题，并提出统一标准方案。
-
---
-
-## 一、核心功能总览（10个业务域）
-
-| # | source_type | 用户界面名称 | 开发层关键命名 | 计费模式 |
-|---|-------------|-------------|---------------|---------|
-| 1 | `script` | 脚本生成 | `ScriptCreation.tsx`, `scriptApi` | 固定 5 |
-| 2 | `polish` | 文案润色 | `scriptApi.polish`, `polish_content` | 固定 1 |
-| 3 | `title` | 标题生成 | `scriptApi.generateTitle`, `generate_title` | 固定 1 |
-| 4 | `tts` | 音频合成 / 配音 | `VoiceDubbing.tsx`, `synthesizeTTS`, `voice.ts` | 按秒计费 |
-| 5 | `voice_clone` | 声音复刻 / 声音克隆 | `VoiceMaterialLibrary.tsx`, `voice.ts` 声音克隆 API | 固定 200 |
-| 6 | `video` | 视频生成 / 对口型 | `VideoGeneration.tsx`, `vidu.ts`, `lipSync` | 按秒计费 |
-| 7 | `caption` | 字幕生成 | `createTask('subtitle', ...)` | 免费 |
-| 8 | `subtitle_burn` | 字幕烧录 | `SubtitleBurning.tsx`, `subtitle_burn` | 固定 2 |
-| 9 | `cover_design` | 封面设计 / 封面制作 / 封面生成 | `CoverDesign.tsx`, `cover_design` | 固定 2 |
-| 10 | `compose` | 压制成片 / 视频合成 | `VideoComposite.tsx`, `videoComposite.ts`, `videoCompose.ts`, `video_processing.rs`, `video_compose.rs` | 固定 5 |
-
---
-
-## 二、问题分类
-
-### A类：后端分类映射错误（数据层污染）
-
-文件：`python-api/app/services/point_service.py` 中的 `_CATEGORY_MAP`
-
-| source_type | 当前映射 | 正确映射 | 影响 |
-|-------------|---------|---------|------|
-| `polish` | "脚本生成" ❌ | "文案润色" | 用户流水显示错误分类 |
-| `title` | "脚本生成" ❌ | "标题生成" | 用户流水显示错误分类 |
-| `voice_clone` | "音频合成" ❌ | "声音复刻" | 用户流水显示错误分类 |
-
-> **严重程度：高**。这会导致积分明细中用户无法区分自己到底消费了什么服务。
-
---
-
-### B类：同一功能多词混用（用户层混乱）
-
-#### B1. TTS / 音频合成 / 配音
-
-| 位置 | 用词 |
-|------|------|
-| 步骤标签（Step 2） | **音频合成** |
-| 页面文件名 | `VoiceDubbing.tsx` |
-| 页面注释 | "语音**配音**页面" |
-| 进度弹窗 | "生成**配音**"、"**配音**已就绪" |
-| 按钮文案 | "生成**配音**" |
-| 字段标签 | "**配音**文案" |
-| 错误提示 | "请返回第二步重新生成**配音**" |
-| TermsModal | "AI **配音**（TTS）" |
-| API 模块注释 | "TTS 合成" |
-| 积分明细（UsageDetail）筛选 | "**音频合成**" |
-
-**问题**：步骤标签用"音频合成"，但页面内全部用"配音"。用户从步骤导航点进来，看到的内容全是"配音"，会产生"这是同一个功能吗？"的困惑。
-
-#### B2. 封面设计 / 封面制作 / 封面生成
-
-| 位置 | 用词 |
-|------|------|
-| 步骤标签（Step 5） | **封面制作** |
-| 页面文件名 | `CoverDesign.tsx` |
-| 页面注释 | "**封面制作**页面" |
-| 进度弹窗 | "**封面生成**"、"**封面生成**完成" |
-| 积分 description | "**封面设计**" |
-| 按钮文案 | "立即生成封面图" |
-| 预览区标题 | "**封面**预览" |
-
-**问题**："制作"、"设计"、"生成"三个词混用。
-
-#### B3. 声音复刻 / 声音克隆
-
-| 位置 | 用词 |
-|------|------|
-| 侧边栏 Sidebar | **声音克隆** |
-| 积分明细 UsageDetail | **声音复刻** |
-| API 模块注释（`voice.ts`） | "**声音克隆** API" |
-| 页面标题（`VoiceMaterialLibrary.tsx`） | "**声音克隆**" |
-
-**问题**：同一功能两个不同的中文名称。
-
-#### B4. 视频生成 / 对口型
-
-| 位置 | 用词 |
-|------|------|
-| 步骤标签（Step 3） | **视频生成** |
-| 积分明细 | **视频生成** |
-| 技术实现注释/日志 | "**对口型**任务"、"**对口型**视频"、"**对口型**处理中..." |
-| 错误提示 | "**对口型**任务失败"、"**对口型**任务超时" |
-| 字段名 | `lipSyncTaskId`, `lipSyncVideoPath` |
-
-**问题**：技术实现术语"对口型"泄露到用户可见文案中。
-
---
-
-### C类：开发命名与业务命名不匹配
-
-| 业务名称 | 开发命名现状 | 问题 |
-|---------|-------------|------|
-| 压制成片 | `compose` (source_type) / `composite` (API 模块名) / `videoComposite.ts` / `videoCompose.ts` / `video_processing.rs` / `video_compose.rs` / `VideoComposite.tsx` | **同一业务 5 种不同命名**，开发人员无法一眼看出这些代码对应同一个功能 |
-| 音频合成 | `tts` (source_type) / `VoiceDubbing.tsx` (页面) / `synthesizeTTS` (函数) / `voice.ts` (API 模块) | 页面文件名 `VoiceDubbing` 与步骤名"音频合成"语义不匹配 |
-| 文案润色 | `polish` (source_type/API) / `polish_content` (service) | 基本对应，但"polish"在代码中同时指"画面描述润色"和"配音文案润色" |
-
---
-
-### D类：术语在注释/文案中的不统一
-
- `ScriptCreation.tsx` 中：`voiceover` 字段的注释混用"配音文案"、"画外音"
- `VideoGeneration.tsx` 中：用户错误提示混用"返回第二步重新生成配音"和"回到第2步重新生成音频"
- `voice.ts` 中：API 模块标题为"TTS 合成、批量合成、声音克隆"，但对应的功能页面叫"音频合成"
-
---
-
-## 三、统一标准方案
-
-### 3.1 用户层统一名称（用户可见的所有文案）
-
-| source_type | 统一名称 | 子类型/说明 |
-|-------------|---------|------------|
-| `script` | **脚本生成** | — |
-| `polish` | **文案润色** | 含画面描述润色、配音文案润色 |
-| `title` | **标题生成** | 封面主/副标题 |
-| `tts` | **配音合成** | 步骤标签、页面标题、按钮、进度统一用此 |
-| `voice_clone` | **声音复刻** | 统一用"复刻"，不用"克隆" |
-| `video` | **视频生成** | 技术实现是对口型，但用户界面禁止出现"对口型" |
-| `caption` | **字幕生成** | 从视频提取字幕文本 |
-| `subtitle_burn` | **字幕烧录** | 将字幕文件烧录到视频画面中 |
-| `cover_design` | **封面设计** | 统一用"设计"，不用"制作/生成" |
-| `compose` | **压制成片** | FFmpeg 拼接输出最终成品视频 |
-
-**说明**：
- **配音合成**：选择这个词是因为它比"音频合成"更贴近用户理解（"我给视频配个音"），又比单独的"配音"更像一个功能名称。步骤标签从"音频合成"改为"配音合成"。
- **声音复刻**："复刻"比"克隆"更符合国内 AI 产品用语习惯（如剪映用"声音克隆"，但通义/讯飞多用"声音复刻"）。考虑到积分明细已用"复刻"，统一到此。
- **封面设计**：文件名已经是 `CoverDesign`，积分 description 也是"封面设计"，步骤标签从"封面制作"改为此，形成统一。
- **视频生成**：技术实现是 Vidu 对口型，但所有用户文案（含错误提示、进度提示）统一用"视频生成"。
-
-### 3.2 开发层统一命名
-
-#### source_type（数据库/API 层，已较规范，保持不变）
-
-```
-script / polish / title / tts / voice_clone / video / caption / subtitle_burn / cover_design / compose
-```
-
-#### 前端文件/模块命名
-
-| 业务 | 当前文件名 | 建议文件名 | 理由 |
-|------|----------|----------|------|
-| 脚本生成 | `ScriptCreation.tsx` | ✅ 保持不变 | 语义清晰 |
-| 文案润色 | 无独立页面（在 ScriptCreation 内） | — | — |
-| 标题生成 | 无独立页面（在 CoverDesign/SubtitleBurning 内调用） | — | — |
-| 配音合成 | `VoiceDubbing.tsx` | `VoiceSynthesis.tsx` | `VoiceDubbing` 侧重"配音"动作，不够功能化；`Synthesis` 与 `synthesizeTTS` 对应 |
-| 声音复刻 | `VoiceMaterialLibrary.tsx` | ✅ 保持不变 | 页面本身是素材库，其中包含声音复刻功能，可以接受 |
-| 视频生成 | `VideoGeneration.tsx` | ✅ 保持不变 | 语义清晰 |
-| 字幕生成 | 无独立页面（在 VoiceDubbing 内调用） | — | — |
-| 字幕烧录 | `SubtitleBurning.tsx` | ✅ 保持不变 | 语义清晰 |
-| 封面设计 | `CoverDesign.tsx` | ✅ 保持不变 | 语义清晰 |
-| 压制成片 | `VideoComposite.tsx` | `VideoCompose.tsx` | 与 source_type `compose` 一致。注意当前已有 `videoCompose.ts`（上传模块），需先厘清两者边界 |
-
-> ⚠️ **关于 `videoCompose.ts` vs `videoComposite.ts`**：
-> - `videoCompose.ts`：提供 `uploadVideoFile`（上传本地视频到后端→七牛云），文件注释写"压制成片 IPC 模块"，实际做的是上传，命名混乱。
-> - `videoComposite.ts`：提供 `compositeApi.synthesis`（调用 Rust 压制成片），命名与业务对应。
-> **建议**：`videoCompose.ts` 改名为 `videoUpload.ts`（或合并到七牛上传模块），`VideoComposite.tsx` 改名为 `VideoCompose.tsx`。
-
-#### 后端文件/模块命名
-
-| 业务 | 当前命名 | 建议 | 理由 |
-|------|---------|------|------|
-| 压制成片 | `video_compose.rs` + `video_processing.rs` | ✅ 保持两个文件，但统一对外 command 名 | `video_processing.rs` 是业务逻辑层，`video_compose.rs` 是 command 层，分层合理。只需统一 Rust command 名和响应消息 |
-
---
-
-## 四、具体修改清单
-
-### 必改（数据层错误）
-
-1. **`python-api/app/services/point_service.py`**
-   - `_CATEGORY_MAP["polish"]` → "文案润色"
-   - `_CATEGORY_MAP["title"]` → "标题生成"
-   - `_CATEGORY_MAP["voice_clone"]` → "声音复刻"
-
-2. **`python-api/app/api/v1/script.py`**（如果 description 硬编码了错误分类）
-   - `description="【文案润色】"` ✅ 已正确
-   - `title` 端点消费记录需要确认 description 格式
-
-### 用户文案统一
-
-3. **Step 标签（`tauri-app/src/pages/VideoCreation/index.tsx`）**
-   - Step 2: "音频合成" → "配音合成"
-   - Step 5: "封面制作" → "封面设计"
-
-4. **配音合成页面（`tauri-app/src/pages/VideoCreation/VoiceDubbing.tsx`）**
-   - 页面注释："语音配音页面" → "配音合成页面"
-   - 进度：`show('生成配音')` → `show('配音合成')`
-   - 进度：`update('正在生成配音...')` → `update('正在合成配音...')`
-   - 成功：`success('配音已就绪')` → `success('配音合成完成')`
-   - 按钮：`生成配音` → `合成配音`
-   - 右侧标题：`配音文案` → `配音文本`
-   - 字段标签：`配音` → `配音文本`
-   - 错误提示中所有"配音"保持不动（"重新生成配音"是动作描述，不需要改）
-
-5. **封面设计页面（`tauri-app/src/pages/VideoCreation/CoverDesign.tsx`）**
-   - 进度：`show('封面生成')` → `show('封面设计')`
-   - 成功：`success('封面生成完成')` → `success('封面设计完成')`
-   - 错误：`封面生成失败` → `封面设计失败`
-   - 按钮：`立即生成封面图` → `立即设计封面`
-   - 积分 description：`封面设计` ✅ 已正确
-
-6. **声音复刻（`tauri-app/src/components/Layout/Sidebar.tsx` + `tauri-app/src/pages/ContentManagement/VoiceMaterialLibrary.tsx` + `tauri-app/src/api/modules/voice.ts`）**
-   - Sidebar: "声音克隆" → "声音复刻"
-   - `voice.ts` 注释："声音克隆" → "声音复刻"
-   - `VoiceMaterialLibrary.tsx` 标题和文案
-
-7. **视频生成页面（`tauri-app/src/pages/VideoCreation/VideoGeneration.tsx`）**
-   - 所有用户可见的"对口型"改为"视频生成"：
-     - 进度：`show('视频生成')` ✅ 已正确
-     - 进度：`update('正在提交对口型任务...')` → `update('正在提交视频生成任务...')`
-     - 进度：`update('正在等待对口型处理...')` → `update('正在等待视频处理...')`
-     - 进度：`update('对口型处理中...')` → `update('视频处理中...')`
-     - 进度：`update('正在下载对口型视频...')` → `update('正在下载生成视频...')`
-     - 错误：`对口型任务失败` → `视频生成失败`
-     - 错误：`对口型任务超时` → `视频生成超时`
-   - 日志/注释中的"对口型"可以保留（开发层）
-
-8. **压制成片页面（`tauri-app/src/pages/VideoCreation/VideoComposite.tsx`）**
-   - 镜头列表中的`配音`标签 → `配音文本`
-
-9. **TermsModal（`tauri-app/src/components/Modal/TermsModal.tsx`）**
-   - "AI 配音（TTS）" → "AI 配音合成（TTS）"
-   - "声音复刻" ✅ 已正确
-
-10. **积分明细（`tauri-app/src/pages/Profile/UsageDetail.tsx`）**
-    - `voice_clone` 筛选标签："声音复刻" ✅ 已正确
-    - `tts` 筛选标签："音频合成" → "配音合成"
-    - `cover_design` 筛选标签："封面设计" ✅ 已正确
-
-11. **我的作品（`tauri-app/src/pages/ContentManagement/MyWorks.tsx`）**
-    - 空状态文案 ✅ 已改为"压制成片"
-
-### 开发层整理（建议项，不影响用户）
-
-12. **`tauri-app/src/api/modules/videoCompose.ts`**
-    - 文件注释写"压制成片 IPC 模块"，实际做的是上传视频。建议改名或修正注释。
-
-13. **`tauri-app/src/pages/VideoCreation/VideoComposite.tsx`**
-    - 建议未来改名为 `VideoCompose.tsx`，与 source_type `compose` 一致。
-
---
-
-## 五、确认清单
-
-请确认以下决策：
-
-1. **Step 2 标签**："音频合成" → "配音合成"（还是保持"音频合成"？）
-2. **Step 5 标签**："封面制作" → "封面设计"（是否接受？）
-3. **声音功能**：统一为"声音复刻"（放弃"声音克隆"）？
-4. **视频生成**：所有用户文案中的"对口型"全部替换为"视频生成"？
-5. **文件改名**：`VoiceDubbing.tsx` → `VoiceSynthesis.tsx`、`VideoComposite.tsx` → `VideoCompose.tsx` 是否执行？
@@ -170,4 +170,4 @@ Tauri updater 插件已内置跨平台安装逻辑，前端代码无需区分平
 | `tauri-app/src-tauri/tauri.conf.json` | updater 配置：公钥 + endpoint URL |
 | `python-api/scripts/publish_release.py` | 发版脚本（扫描 .sig → 上传七牛云 → 写数据库） |
 | `python-api/app/api/v1/update.py` | 后端更新检查 API |
-| `python-api/app/models/update.py` | 数据库模型（`app_releases` / `release_packages`） |
+| `python-api/app/models/update.py` | 数据库模型（`mjk_app_releases` / `mjk_app_release_packages`） |
@@ -0,0 +1,183 @@
+# 用户数据隔离改造方案
+
+## 背景
+
+当前所有本地数据存储在全局路径下，切换账号后 A 用户的数据对 B 用户可见。涉及隐私（音色素材）和商业数据（项目文件），需要按 `user_id` 隔离。
+
+## 目标
+
+- 按登录用户的 `user_id` 隔离本地数据
+- 未登录时使用匿名沙盒或禁止写入
+- 兼容旧数据，首次启动自动迁移
+
+## 改动范围
+
+### 1. Rust 层 — 路径改造（`src/storage/paths.rs`）
+
+新增用户隔离根目录，用户相关数据全部迁移：
+
+```
+{app_local_data_dir}/
+  users/
+    {user_id}/
+      voices.json           ← 音色素材库
+      cover_avatars.json    ← 封面头像库
+      projects/             ← 项目目录
+      config.json           ← 用户级配置（可选）
+  bgm_cache/                ← 全局共享（缓存无隐私问题）
+  config.json               ← 全局配置（窗口状态、偏好设置等）
+  temp/                     ← 临时文件（定时清理）
+```
+
+**需要修改的函数：**
+
+| 当前路径 | 改造后 |
+|---|---|
+| `{data}/voices.json` | `{data}/users/{user_id}/voices.json` |
+| `{data}/cover_avatars.json` | `{data}/users/{user_id}/cover_avatars.json` |
+| `{data}/cover_avatars/` | `{data}/users/{user_id}/cover_avatars/` |
+| `{data}/projects/` | `{data}/users/{user_id}/projects/` |
+| `{data}/config.json` | 保持全局（或拆分为全局+用户级） |
+| `{data}/bgm_cache/` | 保持全局 |
+| `{config}/auth.json` | 保持全局（只存当前登录态） |
+
+**新增：**
+- `get_current_user_id() -> Option<String>`：从全局状态或调用方获取当前 user_id
+- `get_user_data_dir(user_id: &str)`：返回用户隔离目录
+
+### 2. Rust 层 — 存储命令改造
+
+**受影响的命令文件：**
+- `src/commands/voice.rs` — load/save/delete voice materials
+- `src/commands/project.rs` — 项目 CRUD
+- `src/commands/avatar.rs` — 封面头像
+- `src/commands/config.rs` — 配置（决定全局 or 用户级）
+
+**改造方式：**
+
+方式 A（推荐）：命令函数签名增加 `user_id: String` 参数
+```rust
+#[tauri::command]
+pub async fn load_voice_materials(user_id: String) -> ApiResponse<Vec<VoiceMaterial>> {
+    let path = get_user_voices_json_path(&user_id)?;
+    // ...
+}
+```
+
+方式 B：命令内部从 AppHandle 全局状态读取当前 user_id
+```rust
+let user_id = app.state::<CurrentUser>().id.clone();
+```
+
+**推荐方式 A**，前端调用时传入 `user.id`，减少 Rust 层对全局状态的依赖，更明确。
+
+### 3. 前端 — AuthStore 改造（`src/store/authStore.ts`）
+
+**新增：**
+- 登录成功后，写入一个全局标记 `CURRENT_USER_ID = user.id`
+- 登出/被踢时，清除该标记
+- 所有调用 Rust 存储命令的地方，带上 `userId` 参数
+
+**受影响的 Store：**
+- `voiceStore.ts` — `loadVoiceMaterials()`、`addVoiceMaterial()` 等需要传 `userId`
+- `projectStore.ts` — 项目操作需要传 `userId`
+- `avatarStore.ts` — 封面头像操作需要传 `userId`
+
+### 4. 前端 — API 调用改造
+
+所有 `invoke('xxx', { ... })` 调用用户相关命令时，增加 `userId`：
+
+```typescript
+// 改造前
+await invoke('load_voice_materials')
+
+// 改造后
+const userId = useAuthStore.getState().user?.id;
+await invoke('load_voice_materials', { userId })
+```
+
+### 5. 数据迁移策略
+
+**检测时机：** 应用启动时，`init_app_data_dir` 之后
+
+**迁移逻辑（Rust）：**
+```rust
+pub fn migrate_legacy_data(data_dir: &Path) -> Result<(), StorageError> {
+    // 1. 检查是否存在旧数据（全局 voices.json / projects / cover_avatars.json）
+    let legacy_voices = data_dir.join("voices.json");
+    if !legacy_voices.exists() {
+        return Ok(()); // 无旧数据，跳过
+    }
+
+    // 2. 读取 auth.json 获取当前登录的 user_id
+    let auth_path = get_auth_state_path(app)?;
+    let auth: Option<AuthState> = read_json(&auth_path)?;
+    let user_id = match auth.and_then(|a| a.user).map(|u| u.id) {
+        Some(id) => id,
+        None => {
+            // 未登录但有旧数据：移到 anonymous/ 目录，提示用户登录后迁移
+            return move_to_anonymous(data_dir);
+        }
+    };
+
+    // 3. 创建用户目录并迁移
+    let user_dir = data_dir.join("users").join(&user_id);
+    ensure_dir(&user_dir)?;
+
+    // 迁移 voices.json
+    if legacy_voices.exists() {
+        fs::rename(&legacy_voices, user_dir.join("voices.json"))?;
+    }
+
+    // 迁移 cover_avatars.json + cover_avatars/
+    let legacy_avatars = data_dir.join("cover_avatars.json");
+    if legacy_avatars.exists() {
+        fs::rename(&legacy_avatars, user_dir.join("cover_avatars.json"))?;
+    }
+    let legacy_avatars_dir = data_dir.join("cover_avatars");
+    if legacy_avatars_dir.exists() {
+        fs::rename(&legacy_avatars_dir, user_dir.join("cover_avatars"))?;
+    }
+
+    // 迁移 projects/
+    let legacy_projects = data_dir.join("projects");
+    if legacy_projects.exists() {
+        fs::rename(&legacy_projects, user_dir.join("projects"))?;
+    }
+
+    // 4. 写迁移标记，避免重复迁移
+    let flag = data_dir.join(".migration_v1_done");
+    fs::write(&flag, "done")?;
+
+    Ok(())
+}
+```
+
+**迁移顺序：**
+1. 启动应用
+2. 初始化 `app_local_data_dir`
+3. 检测 `.migration_v1_done` 标记，不存在则执行迁移
+4. 迁移完成后继续正常启动
+
+## 工作量评估
+
+| 模块 | 文件数 | 预估工作量 |
+|---|---|---|
+| paths.rs 改造 | 1 | 2h |
+| Rust 存储命令加 user_id 参数 | ~8 个文件 | 4h |
+| lib.rs 注册新签名 | 1 | 0.5h |
+| 前端 Store 改造 | ~4 个文件 | 3h |
+| 数据迁移逻辑 | 1 个新文件 | 3h |
+| 测试验证 | — | 2h |
+| **总计** | | **~14.5h** |
+
+## 风险点
+
+1. **多设备登录同一账号**：数据只在本地隔离，不同设备间数据不互通。如果需要跨设备同步，需要后端支持。
+2. **匿名数据**：未登录时产生的数据（理论上目前不存在，因为功能都需要登录），需要决定是禁止未登录操作还是存到 `anonymous/` 目录。
+3. **回滚**：迁移是单向的（移动文件），回滚需要手动恢复。建议迁移前做备份副本而非直接 move。
+
+## 建议实施时机
+
+- **v1.8.0** 或 **v1.9.0** 版本中实施
+- 最好在素材库数据量还不大的早期做，迁移成本低
@@ -0,0 +1,259 @@
+# 用户数据隔离方案评审报告
+
+## 结论
+
+**方案大方向正确，但存在 3 个关键设计缺陷必须修正**，修正后可用。
+
+---
+
+## 关键缺陷
+
+### ❌ 缺陷 1：前端传 userId 到 Rust 命令 — 安全漏洞
+
+**方案原文：**
+> 方式 A（推荐）：命令函数签名增加 `user_id: String` 参数
+> 前端调用时传入 `user.id`
+
+**问题：** Tauri `#[tauri::command]` 的参数由前端传入，前端可以伪造任意 `userId`。
+
+```typescript
+// 恶意前端代码：A 用户传入 B 的 userId，即可读取 B 的本地数据
+await invoke('load_voice_materials', { userId: 'B的userId' })
+```
+
+**这完全破坏了隔离的安全性。**
+
+**修正方案（推荐方式 B）：**
+
+Rust 命令从已认证的 `auth.json` 中读取当前 `user.id`，不接收前端传来的 `userId`：
+
+```rust
+use tauri::State;
+
+// 全局状态存储当前用户
+pub struct CurrentUser {
+    pub id: std::sync::Mutex<Option<String>>,
+}
+
+#[tauri::command]
+pub async fn load_voice_materials(
+    app: tauri::AppHandle,
+) -> ApiResponse<Vec<VoiceMaterial>> {
+    // 从 auth.json 读取已认证的 user.id
+    let auth: Option<AuthState> = crate::storage::auth::load_auth_state(&app)?;
+    let user_id = match auth.and_then(|a| a.user).map(|u| u.id) {
+        Some(id) => id,
+        None => return ApiResponse::err(401, "未登录"),
+    };
+    
+    let path = get_user_voices_json_path(&user_id)?;
+    // ...
+}
+```
+
+或更简洁：在 `lib.rs` 的 `setup` 中读取 `auth.json`，将 `user_id` 存入 `ManagedState`，所有命令通过 `app.state::<CurrentUser>()` 获取。
+
+**前端完全不需要传 `userId`，Rust 层自治。**
+
+---
+
+### ❌ 缺陷 2：迁移用 `fs::rename`（move）— 不可逆且易崩溃
+
+**方案原文：**
+```rust
+fs::rename(&legacy_voices, user_dir.join("voices.json"))?;
+```
+
+**问题：**
+- `rename` 是原子操作，但**多个文件的迁移不是原子的**
+- 如果迁移 `voices.json` 后、迁移 `projects/` 前进程崩溃，会留下半迁移状态
+- 不可逆，回滚困难
+
+**修正方案：**
+
+```rust
+pub fn migrate_legacy_data(data_dir: &Path, app: &AppHandle) -> Result<(), StorageError> {
+    // 1. 检查迁移标记
+    let flag = data_dir.join(".migration_v1_done");
+    if flag.exists() { return Ok(()); }
+
+    // 2. 检查是否有旧数据
+    let legacy_items = vec![
+        ("voices.json", false),
+        ("cover_avatars.json", false),
+        ("cover_avatars/", true),
+        ("projects/", true),
+    ];
+    let has_legacy = legacy_items.iter().any(|(name, _)| data_dir.join(name).exists());
+    if !has_legacy {
+        // 无旧数据，直接写标记跳过
+        fs::write(&flag, "none")?;
+        return Ok(());
+    }
+
+    // 3. 获取当前登录用户
+    let auth: Option<AuthState> = crate::storage::auth::load_auth_state(app)?;
+    let user_id = match auth.and_then(|a| a.user).map(|u| u.id) {
+        Some(id) => id,
+        None => {
+            // 未登录但有旧数据：复制到 anonymous/，登录后再手动迁移
+            let anon_dir = data_dir.join("anonymous");
+            ensure_dir(&anon_dir)?;
+            for (name, is_dir) in &legacy_items {
+                let src = data_dir.join(name);
+                if src.exists() {
+                    let dest = anon_dir.join(name);
+                    if *is_dir {
+                        copy_dir_all(&src, &dest)?;
+                    } else {
+                        fs::copy(&src, &dest)?;
+                    }
+                }
+            }
+            fs::write(&flag, "anonymous")?;
+            return Ok(());
+        }
+    };
+
+    // 4. 创建用户目录，用 copy 而非 move
+    let user_dir = data_dir.join("users").join(&user_id);
+    ensure_dir(&user_dir)?;
+
+    for (name, is_dir) in &legacy_items {
+        let src = data_dir.join(name);
+        let dest = user_dir.join(name);
+        if src.exists() {
+            if *is_dir {
+                copy_dir_all(&src, &dest)?;
+            } else {
+                fs::copy(&src, &dest)?;
+            }
+        }
+    }
+
+    // 5. copy 成功后，再写标记，然后延迟清理旧数据
+    fs::write(&flag, user_id)?;
+    
+    // 可选：启动后台线程，延迟 7 天后删除旧数据
+    // 给用户一个回滚窗口
+
+    Ok(())
+}
+```
+
+---
+
+### ⚠️ 缺陷 3：缺少切换用户时的热切换设计
+
+**当前问题：**
+- 切换账号后，前端 Zustand store 中仍残留上一个用户的数据
+- 需要页面刷新或重启应用才能加载新用户的数据
+
+**修正方案：**
+
+在 `authStore.logout()` 和 `authStore.login()` 中增加**数据刷新契约**：
+
+```typescript
+// authStore.ts
+logout: async () => {
+  // ... 原有逻辑 ...
+  
+  // 新增：清空所有用户相关的内存状态
+  useVoiceStore.getState().reset();
+  useProjectStore.getState().reset();
+  useAvatarStore.getState().reset();
+  
+  // 通知 Rust 层清空缓存
+  await invoke('switch_user', { userId: null });
+},
+
+login: async (phone, code) => {
+  // ... 原有登录逻辑 ...
+  
+  // 新增：通知 Rust 层切换数据目录
+  await invoke('switch_user', { userId: data.user.id });
+  
+  // 重新加载当前用户的数据
+  await useVoiceStore.getState().loadMaterials();
+  await useProjectStore.getState().loadProjects();
+},
+```
+
+Rust 层 `switch_user` 命令：
+```rust
+#[tauri::command]
+pub async fn switch_user(
+    app: tauri::AppHandle,
+    user_id: Option<String>,
+) -> Result<(), String> {
+    // 更新 ManagedState 中的当前 user_id
+    let state = app.state::<CurrentUser>();
+    let mut guard = state.id.lock().map_err(|e| e.to_string())?;
+    *guard = user_id;
+    Ok(())
+}
+```
+
+---
+
+## 次要问题
+
+### ⚠️ `sanitize_id` 对 user_id 的兼容性
+
+当前 `sanitize_id` 只允许 `a-zA-Z0-9_-`。测试确认：
+- UUID 格式（`550e8400-e29b-41d4-a716-446655440000`）：✅ 通过
+- 邮箱格式（`user@example.com`）：❌ 失败
+- 含点号（`user.name`）：❌ 失败
+
+**建议：** 确认后端 `user.id` 的格式。如果是 UUID，无需改动；如果是邮箱或其他格式，需要对 `user_id` 单独做路径净化（如用 `sanitize_filename` 或直接 base64/urlencode）。
+
+### ⚠️ `temp/` 目录也应隔离
+
+当前 `extract_audio_from_video` 写到 `app_local_data_dir/temp/`，如果多用户并发操作会冲突。建议：
+```
+{app_local_data_dir}/temp/{user_id}/
+```
+
+### ⚠️ 全局 `config.json` 的拆分
+
+当前 `config.json` 存的是 API 地址和环境配置（`production`/`debug`），属于设备级配置，保持全局合理。
+
+但如果以后增加用户偏好（主题、音量、快捷键），需要拆分为：
+- `config.json` — 设备级（全局）
+- `users/{user_id}/preferences.json` — 用户级
+
+---
+
+## 与主流规范对比
+
+| 应用 | 隔离方式 | 说明 |
+|---|---|---|
+| **微信/QQ 桌面端** | ✅ 按账号隔离目录 | 每个账号独立数据目录，切换账号需重启 |
+| **Discord/Slack** | ❌ 不隔离 | 完全云端，本地只有缓存 |
+| **VS Code** | ⚠️ 按 workspace | 不严格按用户，但 settings.json 可放用户目录 |
+| **Figma** | ❌ 不隔离 | 完全云端 |
+| **Adobe Creative Cloud** | ✅ 按账号隔离 | 登录后数据按 Creative Cloud 账号隔离 |
+
+**本项目定位：** 本地创作工具，数据以本地为主，且支持多设备登录（手机号+验证码）。
+
+**结论：** 按 `user_id` 隔离是**合理且必要的**，尤其在涉及**声音复刻素材**这种高敏感隐私数据时。
+
+---
+
+## 修正后的工作量
+
+| 模块 | 修正后工作量 | 说明 |
+|---|---|---|
+| `paths.rs` 改造 | 2h | 加 `users/{user_id}/` 前缀 |
+| `ManagedState` + `switch_user` | 2h | 新增当前用户状态管理 |
+| Rust 命令读 auth.json 获取 user_id | 4h | 替代前端传参方案 |
+| 前端 Store 增加 `reset()` + 登录后重载 | 2h | 热切换体验 |
+| 数据迁移（copy + 标记） | 3h | 安全迁移 |
+| 测试验证 | 2h | |
+| **总计** | **~15h** | 比原方案多 0.5h（主要在 State 管理） |
+
+---
+
+## 建议实施时机
+
+**v1.8.0** 实施，趁数据量小、迁移成本低时做。
@@ -0,0 +1,192 @@
+# Windows 11 开发环境搭建指南
+
+> 适用场景：全新重装系统后的 Windows 11，国内网络环境。
+
+---
+
+## 前置说明
+
+- **WebView2**：Windows 11 自带，无需安装。
+- **WSL2**：Windows 11 默认支持，Docker Desktop 会自动启用。
+- **全程使用 cmd + 官网 .exe 安装包**，不依赖 PowerShell 脚本。
+
+---
+
+## 一、基础工具安装（图形界面，双击下一步）
+
+按顺序安装，装完一个再装下一个。
+
+### 1. Git
+
+- 下载：https://git-scm.com/download/win
+- 安装：全默认，一路 Next。
+
+### 2. Node.js 22 LTS
+
+- 下载：https://nodejs.org/
+- 安装：勾选 **"Automatically install necessary tools"**（会自动装 Python 2.7 等构建工具）。
+
+### 3. Visual Studio Build Tools 2022
+
+- 下载：https://aka.ms/vs/17/release/vs_BuildTools.exe
+- 安装：只勾选 **"使用 C++ 的桌面开发"**（约 8GB），其他全取消。
+
+### 4. Rust
+
+- 下载：https://rustup.rs/ → 点击 `rustup-init.exe (64-bit)`
+- 安装：选 **1) Proceed with default installation**（默认 MSVC 工具链）。
+
+---
+
+## 二、国内镜像配置（cmd 执行）
+
+打开 **cmd（Win+R → cmd）**，逐行执行：
+
+```cmd
+:: ========== npm 镜像 ==========
+npm config set registry https://registry.npmmirror.com
+
+:: ========== Rust 镜像 ==========
+mkdir "%USERPROFILE%\.cargo" 2>nul
+
+echo [source.crates-io] > "%USERPROFILE%\.cargo\config.toml"
+echo replace-with = 'ustc' >> "%USERPROFILE%\.cargo\config.toml"
+echo [source.ustc] >> "%USERPROFILE%\.cargo\config.toml"
+echo registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/" >> "%USERPROFILE%\.cargo\config.toml"
+
+setx RUSTUP_UPDATE_ROOT https://mirrors.ustc.edu.cn/rust-static/rustup
+setx RUSTUP_DIST_SERVER https://mirrors.ustc.edu.cn/rust-static
+
+:: ========== Python 镜像（预留，方案 B 用到） ==========
+pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
+pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
+
+echo 镜像配置完成，请关闭并重新打开 cmd
+```
+
+**执行完后，关闭 cmd，重新打开**，再执行验证：
+
+```cmd
+npm config get registry
+cargo --version
+```
+
+---
+
+## 三、方案 A：只跑前端（连测试环境后端）
+
+### 1. 拉代码
+
+```cmd
+git clone <你的仓库地址>
+cd meijiaka-zy\tauri-app
+```
+
+### 2. 装依赖
+
+```cmd
+npm ci
+```
+
+### 3. 启动
+
+```cmd
+npm run tauri dev
+```
+
+前端默认连接 `https://dev.tapi.meijiaka.cn/api/v1`，无需本地后端。
+
+---
+
+## 四、方案 B：前后端都本地跑
+
+在方案 A 基础上继续。
+
+### 1. Python 3.13
+
+- 下载：https://www.python.org/ftp/python/3.13.0/python-3.13.0-amd64.exe
+- 安装：**务必勾选 "Add python.exe to PATH"**，然后 Install Now。
+
+### 2. 安装 uv
+
+```cmd
+pip install uv
+```
+
+### 3. Docker Desktop
+
+- 下载：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe
+- 安装：默认，装完**重启电脑**。
+- 重启后打开 Docker Desktop，等左下角状态变绿。
+
+### 4. 后端启动
+
+```cmd
+cd meijiaka-zy\python-api
+
+:: 安装依赖
+uv pip install -e ".[dev]"
+
+:: 复制环境变量
+copy .env.example .env
+
+:: 启动数据库
+docker compose -f docker-compose.test.yml up -d db redis
+
+:: 数据库迁移
+alembic upgrade head
+
+:: 启动 API（终端 1）
+make run
+:: 或：uvicorn app.main:app --reload --port 8000
+```
+
+如果需要异步调度器（脚本/TTS/字幕生成等），另开终端：
+
+```cmd
+cd meijiaka-zy\python-api
+make scheduler
+:: 或：python -m app.scheduler.main
+```
+
+### 5. 前端启动（连本地后端）
+
+```cmd
+cd meijiaka-zy\tauri-app
+npm run tauri dev
+```
+
+前端 Vite 开发服务器会代理 API 请求到 `localhost:8000`。如果代理异常，检查 `tauri-app/src/api/client.ts` 中的 `PYTHON_API_BASE_URL`。
+
+---
+
+## 五、验证清单
+
+全部装完后，在 cmd 里执行：
+
+```cmd
+git --version
+node -v
+npm -v
+rustc --version
+cargo --version
+python --version
+uv --version
+docker --version
+```
+
+每个都要有版本号输出。
+
+---
+
+## 六、常见问题
+
+| 现象 | 原因 | 解决 |
+|------|------|------|
+| `npm ci` 卡住 | 镜像没配好 | 检查 `npm config get registry` 是否为 `registry.npmmirror.com` |
+| `cargo build` 卡住 | Rust 镜像没生效 | 关闭 cmd 重新打开，或检查 `%USERPROFILE%\.cargo\config.toml` |
+| Tauri 编译报错 `link.exe not found` | VS Build Tools 没装 C++ 桌面开发 | 重装，确保勾选了该工作负载 |
+| `tauri dev` 白屏 | 前端代理地址错误 | 检查 `client.ts` 里的 base URL |
+| Docker 启动失败 | WSL2 未启用 | 控制面板 → 程序和功能 → 启用 Windows 功能 → 勾选 **适用于 Linux 的 Windows 子系统** |
+| `python` 命令找不到 | 安装时没勾选 Add to PATH | 重装 Python，务必勾选 |
+| `alembic` 命令找不到 | 没在虚拟环境里 | 确保在 `python-api` 目录下执行，`uv pip install` 已经装了 |
@@ -4,7 +4,7 @@

 # === 基础配置 ===
 APP_NAME=美家卡智影 API
-APP_VERSION=1.5.18
+APP_VERSION=1.8.1
 # ⚠️ 生产环境必须设为 false
 DEBUG=true
 ENV=development
@@ -36,7 +36,7 @@ ALGORITHM=HS256
 # === CORS 配置 ===
 # 本地开发: 允许 localhost
 # 测试/生产服: 填写实际域名，如 https://app.yourdomain.com
-CORS_ORIGINS=http://localhost:1420,http://127.0.0.1:1420,http://localhost:8080
+CORS_ORIGINS=http://localhost:1420,http://127.0.0.1:1420,http://localhost:8080,tauri://localhost,http://tauri.localhost,https://tauri.localhost

 # === AI 平台配置 ===

@@ -47,6 +47,9 @@ VOLCENGINE_API_KEY=your-volcengine-api-key
 VOLCENGINE_CAPTION_APPID=your-caption-appid
 VOLCENGINE_CAPTION_TOKEN=your-caption-token

+# 火山 MediaKit
+VOLCENGINE_MEDIAKIT_TOKEN=your-mediakit-token
+
 # Vidu（TTS、声音复刻、对口型）
 VIDU_API_KEY=your-vidu-api-key

@@ -71,7 +74,9 @@ SMS_APP_ID=your-sms-app-id
 SMS_SECRET_KEY=your-16-24-32-byte-aes-key
 SMS_BASE_URL=https://bjksmtn.b2m.cn/inter/sendSingleSMS
 # SMS_EXTENDED_CODE=    # 扩展码（选填）
+# 免验证码登录白名单（逗号分隔），名单内的手机号登录时跳过验证码校验
+# SMS_CODE_WHITELIST=13800138000,13900139000

 # === 日志配置 ===
 # 生产环境建议 INFO
-LOG_LEVEL=DEBUG
+LOG_LEVEL=ERROR
@@ -1 +0,0 @@
-3.13
@@ -1 +1 @@
-{"http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:media-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1778077071}, "http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:img-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1776433218}}
+{"http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:media-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1780541956}, "http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:img-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1776433218}}
@@ -46,4 +46,4 @@ COPY pyproject.toml .

 EXPOSE 8000

-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--no-access-log"]
@@ -20,17 +20,18 @@ load_dotenv()

 # 导入模型
 from app.db.session import Base
+from app.models.bgm_music import BgmMusic  # noqa
 from app.models.broll_category import BrollCategory  # noqa
 from app.models.broll_material import BrollMaterial  # noqa
 from app.models.broll_tag import BrollTag  # noqa
+from app.models.cover_background import CoverBackground  # noqa
 from app.models.point_batch import PointBatch  # noqa
 from app.models.point_recharge_order import PointRechargeOrder  # noqa
 from app.models.point_transaction import PointTransaction  # noqa
+from app.models.update import AppRelease, ReleasePackage  # noqa
 from app.models.user import User  # noqa
 from app.models.user_device import UserDevice  # noqa
 from app.models.user_point import UserPoint  # noqa
-from app.models.cover_background import CoverBackground  # noqa
-from app.models.update import AppRelease, ReleasePackage  # noqa

 # this is the Alembic Config object
 config = context.config
@@ -0,0 +1,28 @@
+"""add_url_to_bgm_music
+
+Revision ID: 100366516fbd
+Revises: 7172a476e5b2
+Create Date: 2026-05-24 15:24:11.076162
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '100366516fbd'
+down_revision: Union[str, Sequence[str], None] = '7172a476e5b2'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.add_column('mjk_bgm_musics', sa.Column('url', sa.String(length=1024), nullable=True, comment='七牛云 URL'))
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_column('mjk_bgm_musics', 'url')
@@ -0,0 +1,41 @@
+"""make_bgm_music_url_non_nullable
+
+Revision ID: 7149f61a2f9c
+Revises: 7172a476e5b2
+Create Date: 2026-05-21 10:45:00.000000
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '7149f61a2f9c'
+down_revision: Union[str, Sequence[str], None] = '100366516fbd'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # BGM 云端化改造后，url 字段为必填（七牛云 CDN 地址）
+    op.alter_column(
+        'mjk_bgm_musics',
+        'url',
+        existing_type=sa.String(length=1024),
+        nullable=False,
+        comment='七牛云 URL',
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.alter_column(
+        'mjk_bgm_musics',
+        'url',
+        existing_type=sa.String(length=1024),
+        nullable=True,
+        comment='七牛云 URL',
+    )
@@ -0,0 +1,46 @@
+"""add_bgm_music_table
+
+Revision ID: 7172a476e5b2
+Revises: d8f4912d7a52
+Create Date: 2026-05-23 13:56:46.013156
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '7172a476e5b2'
+down_revision: Union[str, Sequence[str], None] = 'd8f4912d7a52'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('mjk_bgm_musics',
+    sa.Column('title', sa.String(length=255), nullable=False, comment='音乐名称'),
+    sa.Column('artist', sa.String(length=255), nullable=True, comment='艺术家'),
+    sa.Column('category', sa.String(length=32), nullable=False, comment='场景分类'),
+    sa.Column('file_path', sa.String(length=512), nullable=False, comment='相对文件路径'),
+    sa.Column('duration', sa.Float(), nullable=True, comment='时长（秒）'),
+    sa.Column('status', sa.String(length=16), nullable=False, comment='状态: active/inactive'),
+    sa.Column('sort_order', sa.Integer(), nullable=False, comment='排序权重'),
+    sa.Column('id', sa.BigInteger(), autoincrement=True, nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), nullable=False),
+    sa.PrimaryKeyConstraint('id')
+    )
+    op.create_index(op.f('ix_mjk_bgm_musics_category'), 'mjk_bgm_musics', ['category'], unique=False)
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_index(op.f('ix_mjk_bgm_musics_category'), table_name='mjk_bgm_musics')
+    op.drop_table('mjk_bgm_musics')
+    # ### end Alembic commands ###
@@ -0,0 +1,41 @@
+"""add filename to release_package unique constraint
+
+Revision ID: 7d855b38fe83
+Revises: 8d901bc90e67
+Create Date: 2026-05-26 22:55:00.000000
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+
+
+# revision identifiers, used by Alembic.
+revision: str = '7d855b38fe83'
+down_revision: Union[str, Sequence[str], None] = '8d901bc90e67'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # 删除旧约束（release_id + platform + architecture）
+    op.drop_constraint('uix_app_pkg_platform_arch', 'mjk_app_release_packages', type_='unique')
+    # 创建新约束（release_id + platform + architecture + filename）
+    op.create_unique_constraint(
+        'uix_app_pkg_platform_arch_filename',
+        'mjk_app_release_packages',
+        ['release_id', 'platform', 'architecture', 'filename']
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # 删除新约束
+    op.drop_constraint('uix_app_pkg_platform_arch_filename', 'mjk_app_release_packages', type_='unique')
+    # 恢复旧约束
+    op.create_unique_constraint(
+        'uix_app_pkg_platform_arch',
+        'mjk_app_release_packages',
+        ['release_id', 'platform', 'architecture']
+    )
@@ -0,0 +1,29 @@
+"""rename mjk_release_packages to mjk_app_release_packages
+
+Revision ID: 8d901bc90e67
+Revises: 7149f61a2f9c
+Create Date: 2026-05-26 10:05:16.921079
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+
+
+# revision identifiers, used by Alembic.
+revision: str = '8d901bc90e67'
+down_revision: Union[str, Sequence[str], None] = '7149f61a2f9c'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.execute("ALTER TABLE IF EXISTS mjk_release_packages RENAME TO mjk_app_release_packages")
+    op.execute("ALTER INDEX IF EXISTS uix_pkg_platform_arch RENAME TO uix_app_pkg_platform_arch")
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.execute("ALTER INDEX IF EXISTS uix_app_pkg_platform_arch RENAME TO uix_pkg_platform_arch")
+    op.execute("ALTER TABLE IF EXISTS mjk_app_release_packages RENAME TO mjk_release_packages")
@@ -0,0 +1,48 @@
+"""rename_old_table_prefix_for_update_tables
+
+Revision ID: d8f4912d7a52
+Revises: c3a0e1c71ce6
+Create Date: 2026-05-20 18:02:45.186600
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'd8f4912d7a52'
+down_revision: Union[str, Sequence[str], None] = 'c3a0e1c71ce6'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # 将旧环境（cbd4068 前）创建的 app_releases / release_packages 重命名为 mjk_ 前缀
+    # 使用 IF EXISTS 兼容：新环境已在 initial_schema 中创建了正确前缀的表名
+    op.execute(
+        "ALTER TABLE IF EXISTS app_releases RENAME TO mjk_app_releases"
+    )
+    op.execute(
+        "ALTER INDEX IF EXISTS ix_app_releases_version "
+        "RENAME TO ix_mjk_app_releases_version"
+    )
+    op.execute(
+        "ALTER TABLE IF EXISTS release_packages RENAME TO mjk_release_packages"
+    )
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.execute(
+        "ALTER TABLE IF EXISTS mjk_app_releases RENAME TO app_releases"
+    )
+    op.execute(
+        "ALTER INDEX IF EXISTS ix_mjk_app_releases_version "
+        "RENAME TO ix_app_releases_version"
+    )
+    op.execute(
+        "ALTER TABLE IF EXISTS mjk_release_packages RENAME TO release_packages"
+    )
@@ -20,3 +20,4 @@ class Method:
    CAPTION = "caption"
    AUTO_ALIGN = "auto_align"
    VIDEO_GENERATE = "video_generate"
+    REMOVE_BACKGROUND = "remove_background"
@@ -218,24 +218,35 @@ class ViduAdapter(PlatformAdapter, SyncCapable, TaskCapable, CallbackCapable):
        callback_url: str | None = None,
    ) -> bool:
        """验证 Vidu 回调 HMAC-SHA256 签名"""
-        signature = headers.get("X-HMAC-SIGNATURE")
-        algorithm = headers.get("X-HMAC-ALGORITHM")
-        access_key = headers.get("X-HMAC-ACCESS-KEY")
-        signed_headers_str = headers.get("X-HMAC-SIGNED-HEADERS")
-        date = headers.get("Date")
+        import logging
+        logger = logging.getLogger(__name__)
+
+        # HTTP 头大小写不敏感：建立小写 key 的查找表
+        headers_lower = {k.lower(): v for k, v in headers.items()}
+
+        signature = headers_lower.get("x-hmac-signature")
+        algorithm = headers_lower.get("x-hmac-algorithm")
+        access_key = headers_lower.get("x-hmac-access-key")
+        signed_headers_str = headers_lower.get("x-hmac-signed-headers")
+        date = headers_lower.get("date")

        if not all([signature, algorithm, access_key, signed_headers_str, date]):
+            logger.warning(f"[Vidu] 签名验证失败: 缺少必要头, headers={list(headers.keys())}")
            return False
        if algorithm != "hmac-sha256":
+            logger.warning(f"[Vidu] 签名验证失败: 不支持的算法 {algorithm}")
            return False
        if access_key != "vidu":
+            logger.warning(f"[Vidu] 签名验证失败: access_key 不匹配 {access_key}")
            return False

        header_names = [h.strip() for h in signed_headers_str.split(";") if h.strip()]
        header_values: dict[str, str] = {}
        for name in header_names:
-            value = headers.get(name)
+            # 签名头名也可能大小写不一致，统一用小写查找
+            value = headers_lower.get(name.lower())
            if value is None:
+                logger.warning(f"[Vidu] 签名验证失败: 缺少签名头 {name}")
                return False
            header_values[name] = value

@@ -258,7 +269,15 @@ class ViduAdapter(PlatformAdapter, SyncCapable, TaskCapable, CallbackCapable):
            hmac.new(secret.encode("utf-8"), signing_string.encode("utf-8"), hashlib.sha256).digest()
        ).decode("utf-8")

-        return hmac.compare_digest(signature, expected)
+        if not hmac.compare_digest(signature, expected):
+            logger.warning(
+                f"[Vidu] 签名验证失败: callback_url={callback_url}, "
+                f"signing_string={repr(signing_string)}, "
+                f"expected={expected[:20]}..., received={signature[:20]}..."
+            )
+            return False
+
+        return True

    async def verify_nonce(
        self,
@@ -289,5 +308,5 @@ class ViduAdapter(PlatformAdapter, SyncCapable, TaskCapable, CallbackCapable):
        return TaskStatus(
            state=self.normalize_state(state),
            result={"video_url": video_url, "creations": creations, "task_id": task_id} if video_url else {"task_id": task_id},
-            error_message=data.get("err_code") or data.get("message") if state == "failed" else None,
+            error_message=(data.get("err_code") or data.get("message")) if state == "failed" else None,
        )
@@ -0,0 +1,95 @@
+"""
+火山引擎 MediaKit Adapter
+==========================
+
+实现 PlatformAdapter + SyncCapable。
+直接接入 VolcengineMediakitProvider，提供标准 Protocol 接口。
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from app.ai.adapters.base import AdapterResponse, PlatformAdapter, SyncCapable
+from app.ai.adapters.constants import Method
+from app.ai.providers.volcengine_mediakit_provider import VolcengineMediakitProvider
+from app.core.exceptions import PlatformError, PlatformErrorType
+
+logger = logging.getLogger(__name__)
+
+
+class VolcengineMediakitAdapter(PlatformAdapter, SyncCapable):
+    """火山引擎 MediaKit 平台标准 Adapter"""
+
+    platform_id = "volcengine_mediakit"
+
+    def __init__(self, provider: VolcengineMediakitProvider):
+        self.provider = provider
+
+    # ── PlatformAdapter ──
+
+    async def health(self) -> AdapterResponse:
+        try:
+            # 用无效 URL 测试连通性（400 说明网络通且认证通过）
+            await self.provider.remove_background(
+                image_url="https://example.com/health-check.jpg",
+                scene="general",
+            )
+            return AdapterResponse(success=True)
+        except PlatformError as e:
+            if e.error_type in (
+                PlatformErrorType.AUTH_FAILED,
+                PlatformErrorType.BAD_REQUEST,
+            ):
+                return AdapterResponse(success=True)
+            return AdapterResponse(
+                success=False,
+                error_message=str(e),
+                retryable=e.retryable,
+            )
+        except Exception as e:
+            return AdapterResponse(
+                success=False,
+                error_message=str(e),
+                retryable=False,
+            )
+
+    async def close(self) -> None:
+        await self.provider.close()
+
+    # ── SyncCapable ──
+
+    async def call(self, method: str, payload: dict[str, Any]) -> AdapterResponse:
+        try:
+            if method == Method.REMOVE_BACKGROUND:
+                result = await self.provider.remove_background(
+                    image_url=payload["image_url"],
+                    scene=payload.get("scene", "general"),
+                    need_contour=payload.get("need_contour", False),
+                    contour_color=payload.get("contour_color", "#FFFFFF"),
+                    contour_size=payload.get("contour_size", 10),
+                    need_crop_background=payload.get("need_crop_background", False),
+                )
+                data = result.get("data", {})
+                return AdapterResponse(
+                    success=True,
+                    data={"image_url": data.get("image_url")},
+                )
+
+            else:
+                return AdapterResponse(
+                    success=False,
+                    error_message=f"不支持的方法: {method}",
+                    retryable=False,
+                )
+
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise PlatformError(
+                f"MediaKit {method} 调用失败: {e}",
+                platform="volcengine_mediakit",
+                retryable=False,
+                error_type=PlatformErrorType.UNKNOWN,
+            ) from e
@@ -11,8 +11,11 @@ Prompt 模板系统
    # 获取分类列表
    categories = list_categories()

-    # 加载 System Prompt（大类+小类，随机取一个）
-    system = load_system_prompt("bk", "ht")
+    # 扫描某分类下的所有提示词文件
+    files = list_prompt_files("bk")
+
+    # 加载指定文件的 System Prompt
+    system = load_prompt_file("bk", "水电改造避坑——水电改造的4个坑.txt")

    # 加载并渲染 User Prompt
    user = load_script_user_prompt(
@@ -24,7 +27,9 @@ from .loader import (
    PolishPromptBuilder,
    ScriptPromptBuilder,
    list_categories,
+    list_prompt_files,
    load_prompt,
+    load_prompt_file,
    load_script_user_prompt,
    load_system_prompt,
    render_template,
@@ -36,6 +41,8 @@ __all__ = [
    "load_system_prompt",
    "load_script_user_prompt",
    "list_categories",
+    "list_prompt_files",
+    "load_prompt_file",
    "ScriptPromptBuilder",
    "PolishPromptBuilder",
 ]
@@ -77,18 +77,13 @@ def list_categories() -> list[dict]:
    """
    返回所有分类结构

-    以 system/_meta.json 为准，只返回配置中定义的分类。
-    count 动态扫描对应目录统计。
+    以 system/_meta.json 为准，只返回配置中定义的大类。

    Returns:
        [
          {
            "code": "bk",
-            "name": "装修避坑",
-            "subcategories": [
-              {"code": "ht", "name": "装修合同避坑", "count": 2},
-              ...
-            ]
+            "name": "装修避坑"
          },
          ...
        ]
@@ -99,64 +94,84 @@ def list_categories() -> list[dict]:
    for cat_meta in meta.get("categories", []):
        cat_code = cat_meta["code"]
        cat_name = cat_meta.get("name", cat_code)
-        cat_dir = SYSTEM_PROMPTS_DIR / cat_code
-
-        subcategories = []
-        for sub_meta in cat_meta.get("subcategories", []):
-            sub_code = sub_meta["code"]
-            sub_name = sub_meta.get("name", sub_code)
-            sub_dir = cat_dir / sub_code
-
-            # 统计提示词文件数量
-            count = 0
-            if sub_dir.exists():
-                count = len([
-                    f for f in sub_dir.iterdir()
-                    if f.is_file() and f.suffix == ".txt"
-                ])
-
-            subcategories.append({
-                "code": sub_code,
-                "name": sub_name,
-                "count": count,
-            })
-
        categories.append({
            "code": cat_code,
            "name": cat_name,
-            "subcategories": subcategories,
        })

    return categories


-def load_system_prompt(category: str, subcategory: str) -> str:
+def list_prompt_files(category: str) -> list[dict]:
    """
-    根据大类+小类随机加载一个 System Prompt
+    扫描指定分类目录下的所有提示词文件
+
+    文件名格式: 文案——描述.txt
+    解析为 label + desc 返回给前端展示。

    Args:
        category: 大类代码，如 "bk"
-        subcategory: 小类代码，如 "ht"

    Returns:
-        随机选中的提示词内容，未找到返回空字符串
+        [
+          {
+            "filename": "水电改造避坑——水电改造的4个坑.txt",
+            "label": "水电改造避坑",
+            "desc": "水电改造的4个坑"
+          },
+          ...
+        ]
    """
-    sub_dir = SYSTEM_PROMPTS_DIR / category / subcategory
-    if not sub_dir.exists():
+    cat_dir = SYSTEM_PROMPTS_DIR / category
+    if not cat_dir.exists():
+        return []
+
+    files = []
+    for f in sorted(cat_dir.iterdir()):
+        if f.is_file() and f.suffix == ".txt":
+            name = f.stem  # 不含 .txt
+            if "——" in name:
+                label, desc = name.split("——", 1)
+            else:
+                label = name
+                desc = ""
+            files.append({
+                "filename": f.name,
+                "label": label.strip(),
+                "desc": desc.strip(),
+            })
+
+    return files
+
+
+def load_prompt_file(category: str, filename: str) -> str:
+    """
+    加载指定分类下的指定提示词文件
+
+    Args:
+        category: 大类代码，如 "bk"
+        filename: 文件名，如 "水电改造避坑——水电改造的4个坑.txt"
+
+    Returns:
+        提示词内容，文件不存在返回空字符串
+    """
+    file_path = SYSTEM_PROMPTS_DIR / category / filename
+    if file_path.exists():
+        return file_path.read_text(encoding="utf-8")
+    return ""
+
+
+def load_system_prompt(category: str, subcategory: str) -> str:
+    """
+    【已废弃】根据大类+小类随机加载一个 System Prompt
+
+    保留兼容旧调用，实际行为改为从平铺文件中随机加载。
+    """
+    files = list_prompt_files(category)
+    if not files:
        return ""
-
-    # 收集所有提示词文件
-    prompt_files = [
-        f for f in sub_dir.iterdir()
-        if f.is_file() and f.suffix == ".txt"
-    ]
-
-    if not prompt_files:
-        return ""
-
-    # 随机取一个提示词模板（非安全场景）
-    chosen = random.choice(prompt_files)  # nosec: B311
-    return chosen.read_text(encoding="utf-8")
+    chosen = random.choice(files)  # nosec: B311
+    return load_prompt_file(category, chosen["filename"])



@@ -2,20 +2,7 @@
  "categories": [
    {
      "code": "bk",
-      "name": "装修避坑",
-      "subcategories": [
-        { "code": "ht", "name": "装修合同" },
-        { "code": "lc", "name": "装修流程" },
-        { "code": "bj", "name": "装修报价" },
-        { "code": "qw", "name": "全屋定制" },
-        { "code": "sd", "name": "水电改造" },
-        { "code": "wt", "name": "常见问题" },
-        { "code": "wg", "name": "瓦工铺贴" },
-        { "code": "yg", "name": "油工进场" },
-        { "code": "cl", "name": "装修材料" },
-        { "code": "jg", "name": "装修监工" },
-        { "code": "sq", "name": "装修省钱" }
-      ]
+      "name": "装修避坑"
    }
  ]
 }
@@ -1,257 +0,0 @@
-你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
-【核心定位与脚本类型】
-（一）核心定位
-精准锁定：准备装修、不懂各品类主材怎么选品牌、怕选错质量差被坑的装修业主，围绕装修 12 大类主材靠谱品牌推荐创作，每次生成随机打乱 12 条品类顺序重新编排，保留原意不变。
-（二）脚本类型
-装修口播短视频脚本，无多余开篇引入，直接进入正文主材品牌推荐，正文干货 + 结尾资料领取引导，无多余内容、无重复冗余。
-【平台适配】
-竖屏 9:16 拍摄
-【核心强制规则】
-无开头范式，去掉所有铺垫引入话术，直接切入各主材品牌推荐正文。
-中间核心（12 大类主材品牌文案可微调口语化，保持原意不变，每次自动随机打乱重新编排顺序）：
-电线优选：熊猫、远东、德力西三大靠谱品牌。
-防水选材认准：德高、雨虹、科顺主流大品牌。
-家装水管优先选：金牛、伟星、日丰口碑款。
-开关面板推荐：公牛、施耐德、西门子放心选。
-腻子粉首选：立邦、美巢、德高环保大品牌。
-家装水泥认准：海螺、红石、中联品质有保障。
-厨卫五金优选：汉斯格雅、科勒、九牧一线品牌。
-木地板推荐：圣象、大自然、生活家主流大牌。
-石膏板选材：龙牌、泰山、可耐福家装常用款。
-瓷砖胶认准：德高、大禹、神工粘结更牢固。
-乳胶漆优选：立邦、多乐士、三棵树环保净味。
-玻璃胶选用：瓦克、西卡、百得防霉耐用款。
-（备注：完整保留每类主材对应的三个品牌，仅微调句式适配口播；每次生成自动随机打乱 12 个品类排序，不改变品牌名单和推荐原意）
-中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
-排序逻辑：内置 12 大类装修主材固定推荐品牌，每次生成脚本自动随机打乱重新排序，不固定原有顺序，避免内容同质化，适合日常短视频日更。
-文案调整要求：仅做口语化精简优化，把直白问句改成顺口口播表述，不替换、不删减任何品牌，保持每类主材三个推荐品牌完整不变，原意丝毫不改。
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 170-190 字，按每秒 4 个字计算，对应时长 42.5-47.5s，内容精炼、节奏紧凑，适配短平快知识口播。
-内容适配性：打乱顺序后语句依然衔接自然，每条独立清晰，直接给到可照搬的主材品牌清单，解决业主选材纠结、怕踩坑的核心痛点，实用性拉满。
-结尾范式：完整保留原文结尾引导原话，仅可轻微优化口语流畅度，不改动评论区扣关键词、领取材料推荐清单的核心引流逻辑。
-【开篇 & 语言要求】
-无开篇铺垫，直接切入主材品牌推荐干货；全程短句口语化、接地气，直白罗列品牌，简单好记、业主可直接收藏对照选材。
-可微调句式语序，严禁替换、删减任意主材品牌，不改变推荐逻辑和原意，语句简短利落，适配短时长口播节奏。
-【内置固定原文案】
-电线买谁家？熊猫、远东、德力西。
-防水买谁家？德高、雨虹、科顺。
-水管买谁家？金牛、伟星、日丰。
-开关买谁家？公牛、施耐德、西门子。
-腻子粉买谁家？立邦、美巢、德高。
-水泥买谁家？海螺、红石、中联。
-五金买谁家？汉斯格雅、科勒、九牧。
-木地板买谁家？圣象、大自然、生活家。
-石膏板买谁家？龙牌、泰山、可耐福。
-瓷砖胶买谁家？德高、大禹、神工。
-乳胶漆买谁家？立邦、多乐士、三棵树。
-玻璃胶买谁家？瓦克、西卡、百得。
-记不住的，我这里有材料推荐清单，评论区扣材料，直接拿走。
-【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
-卧室原始状态-翻新基础
-厨卫原始状态-翻新基础
-客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
-全屋地板铺设施工-主材安装
-全屋开关面板安装-主材安装
-卫浴洁具进场安装-主材安装
-厨卫集成吊顶安装-主材安装
-室内房门安装固定-主材安装
-橱柜柜体现场组装-主材安装
-灯具筒灯射灯安装-主材安装
-衣柜移门五金安装-主材安装
-全屋五金调试-收尾细节
-成品瑕疵修补-收尾细节
-柜体门缝调整-收尾细节
-门窗缝隙密封处理-收尾细节
-全屋基础开荒保洁-美缝开荒
-地面残留胶迹清理-美缝开荒
-撕美缝胶-美缝开荒
-玻璃胶收边打胶细节-美缝开荒
-瓷砖缝隙清理清灰-美缝开荒
-美缝扩缝-美缝开荒
-美缝施工-美缝开荒
-美缝检查-美缝开荒
-门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
-全屋定制柜体打底-柜体木作
-木作封边贴皮-柜体木作
-环保板材现场堆放-柜体木作
-阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
-吸睛画面-恶搞开篇
-工地恶搞-恶搞开篇
-搞笑涂料施工-恶搞开篇
-暴力拆除-恶搞开篇
-炫技-恶搞开篇
-贴砖恶搞-恶搞开篇
-墙体掉落-施工翻车镜
-墙面开裂-施工翻车镜
-墙面空鼓-施工翻车镜
-水管错位-施工翻车镜
-电线乱接-施工翻车镜
-防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
-柜体开合顺畅度检查-全屋验收
-踢脚线安装验收-软装进场
-验收合格签字确认-全屋验收
-窗帘轨道窗帘安装-软装进场
-【分镜固定结构规则】
-开篇的分镜为： 一段人物出镜 
-其他都是空镜补充
-“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
-每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 170-190 字，按每秒 4 个字计算，对应时长 42.5-47.5s，内容精炼、节奏紧凑，适配短平快知识口播。
-type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库选匹配标题。
-“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
-“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
-【输出格式要求】
-输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
-一、分镜内容
-id: 按顺序递增（1、2、3…）
-type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
-voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
-duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数）
-【示例】
-[
-{
-"id": 1,
-"type": "empty_shot",
-"scene": "新建墙体垂直找平 - 新建砌筑",
-"voiceover": "砌墙完工之后，一定要停工静置等待 5 天。",
-"duration": "4.25s"
-}
-]
@@ -1,264 +0,0 @@
-你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
-【核心定位与脚本类型】
-（一）核心定位
-精准锁定：新房装修选购家电、主材、辅材，不懂品牌怎么选、怕踩杂牌坑、想直接抄作业的装修业主，围绕 15 大类家装好物优质品牌推荐创作，每次生成随机打乱 15 个品类顺序重新编排，保留原意不变。
-（二）脚本类型
-装修口播短视频脚本，无多余开篇引入，直接进入正文品牌推荐，正文干货罗列 + 结尾资料领取引导，无多余内容、无重复冗余。
-【平台适配】
-竖屏 9:16 拍摄
-【核心强制规则】
-无开头范式，去掉所有铺垫引入话术，直接切入各类家电主材品牌推荐正文。
-中间核心（15 大类家装品牌文案可微调口语化，保持原意不变，每次自动随机打乱重新编排顺序）：
-家用冰箱优选：卡萨帝、海尔、美的三大主流大牌。
-电视选购认准：TCL、海信、索尼画质口碑款。
-淋浴花洒推荐：九牧、恒洁、箭牌卫浴一线品牌。
-家装电线首选：远东、宝胜、熊猫国标品质线缆。
-烟机灶具认准：方太、老板、华帝厨房专业品牌。
-环保乳胶漆选：立邦、三棵树、多乐士家装常用款。
-开关插座优选：施耐德、公牛、西门子安全耐用。
-全屋瓷砖推荐：东鹏、冠珠、马可波罗口碑大品牌。
-家装水管认准：日丰、伟星、保利防爆耐用管材。
-环保板材挑选：万华、兔宝宝、艾格高端环保基材。
-家装防水优选：东方雨虹、立邦、德高家装防水标杆。
-集成吊顶选：奥普、法狮龙、友邦厨卫专用品牌。
-木地板认准：大自然、圣象、世友实木复合主流款。
-腻子粉优选：立邦、美巢、圣戈班环保耐潮产品。
-厨卫地漏选：潜水艇、箭牌、九牧防臭排水好物。
-（备注：完整保留每类对应的三个推荐品牌，仅微调句式适配口播语感；每次生成自动随机打乱 15 个品类排序，不替换品牌、不改变推荐原意）
-中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
-排序逻辑：内置 15 大类装修家电、主材、辅材固定品牌清单，每次生成脚本自动随机打乱重新排序，不固定原有顺序，规避内容重复，适合短视频日常更新。
-文案调整要求：仅做口语化精简优化，把问句改成顺口口播表述，不删减、不替换任何一个品牌名称，完整保留每品类三大推荐品牌，原意丝毫不变。
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 220-240 字，按每秒 4 个字核算，对应时长 55-60s，内容精炼紧凑、节奏适中，适配短平快知识口播。
-内容适配性：打乱顺序后语句衔接自然，逐条清晰罗列，业主可直接对照抄作业选品牌，解决选材纠结、怕踩坑、不会分辨好坏的核心痛点，实用性极强。
-结尾范式：完整保留原文结尾引导原话，仅轻微优化口语流畅度，不改动新房装修人群定位、评论区扣关键词领取装修避坑手册的核心引流逻辑。
-【开篇 & 语言要求】
-无开篇铺垫，直接切入品牌推荐干货；全程短句大白话、接地气，直白罗列靠谱品牌，简单好记、装修可直接照搬参考。
-可微调句式语序，严禁改动、删减、替换任意品类及对应品牌，不改变推荐逻辑与原意，语句简短利落，适配中短时长口播节奏。
-【内置固定原文案】
-冰箱买谁家？卡萨帝、海尔、美的。
-电视买谁家？TCL、海信、索尼。
-花洒哪家好？九牧、恒洁、箭牌。
-电线买谁家？远东、宝胜、熊猫。
-烟机哪家好？方太、老板、华帝。
-乳胶漆买谁家？立邦、三棵树、多乐士。
-开关插座买谁家？施耐德、公牛、西门子。
-瓷砖哪家好？东鹏、冠珠、马可波罗。
-水管买谁家？日丰、伟星、保利。
-板材选谁家？万华、兔宝宝、艾格。
-防水买谁家？东方雨虹、立邦、德高。
-吊顶选谁家？奥普、法狮龙、友邦。
-地板哪家好？大自然、圣象、世友。
-腻子粉哪家好？立邦、美巢、圣戈邦。
-地漏谁家好？潜水艇、箭牌、九牧。
-准备新房装修的朋友，我整理一份装修避坑手册供你参考，评论区回避坑，直接拿。
-【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
-卧室原始状态-翻新基础
-厨卫原始状态-翻新基础
-客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
-全屋地板铺设施工-主材安装
-全屋开关面板安装-主材安装
-卫浴洁具进场安装-主材安装
-厨卫集成吊顶安装-主材安装
-室内房门安装固定-主材安装
-橱柜柜体现场组装-主材安装
-灯具筒灯射灯安装-主材安装
-衣柜移门五金安装-主材安装
-全屋五金调试-收尾细节
-成品瑕疵修补-收尾细节
-柜体门缝调整-收尾细节
-门窗缝隙密封处理-收尾细节
-全屋基础开荒保洁-美缝开荒
-地面残留胶迹清理-美缝开荒
-撕美缝胶-美缝开荒
-玻璃胶收边打胶细节-美缝开荒
-瓷砖缝隙清理清灰-美缝开荒
-美缝扩缝-美缝开荒
-美缝施工-美缝开荒
-美缝检查-美缝开荒
-门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
-全屋定制柜体打底-柜体木作
-木作封边贴皮-柜体木作
-环保板材现场堆放-柜体木作
-阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
-吸睛画面-恶搞开篇
-工地恶搞-恶搞开篇
-搞笑涂料施工-恶搞开篇
-暴力拆除-恶搞开篇
-炫技-恶搞开篇
-贴砖恶搞-恶搞开篇
-墙体掉落-施工翻车镜
-墙面开裂-施工翻车镜
-墙面空鼓-施工翻车镜
-水管错位-施工翻车镜
-电线乱接-施工翻车镜
-防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
-柜体开合顺畅度检查-全屋验收
-踢脚线安装验收-软装进场
-验收合格签字确认-全屋验收
-窗帘轨道窗帘安装-软装进场
-【分镜固定结构规则】
-开篇的分镜为： 一段人物出镜 
-其他都是空镜补充
-“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
-每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 220-240 字，按每秒 4 个字核算，对应时长 55-60s，内容精炼紧凑、节奏适中，适配短平快知识口播。
-type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库选匹配标题。
-“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
-“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
-【输出格式要求】
-输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
-一、分镜内容
-id: 按顺序递增（1、2、3…）
-type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
-voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
-duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数）
-【示例】
-[
-{
-"id": 1,
-"type": "empty_shot",
-"scene": "新建墙体垂直找平 - 新建砌筑",
-"voiceover": "砌墙完工之后，一定要停工静置等待 5 天。",
-"duration": "4.25s"
-}
-]
-
@@ -1,270 +0,0 @@
-你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
-【核心定位与脚本类型】
-（一）核心定位
-精准锁定：准备新房装修、不懂水电改造套路、容易被网红颜值工艺忽悠、只看表面好看多花冤枉钱，后期入住返工留遗憾的业主，严格从10 个水电改造大坑中随机抽取 4 个进行避坑要点创作。
-（二）脚本类型
-装修水电避坑口播短视频脚本，结构固定：范式化定制开头 + 随机 4 个水电避坑干货 + 保留原文结尾引导，无多余内容，无重复，无冗余。
-【平台适配】
-竖屏 9:16 拍摄
-【核心强制规则】
-开头范式
-以 **“新房装修做水电改造，谁要是只追求网红大弧弯、横平竖直的表面颜值，只顾好看不考虑实用，千万别盲目跟风照搬。看着工艺漂亮上档次，其实全是装修公司收割你的面子工程，多花钱还不实用。下面这 4 个水电改造大坑一定要提前避开，看懂少花几万冤枉钱！”** 为固定核心句式，沿用原文 “水电好看都是面子工程、宰客套路” 的核心原意，用警示性语气点出颜值陷阱、多花冤枉钱的痛点，引出下文 4 个坑点，不照搬原文完整长开头，只保留核心立意适配范式结构。
-中间核心
-固定从给到的 10 个水电改造坑中随机选 4 个，重新自主打乱编排顺序；文案可适当微调句式、口语化润色，保留每个坑原意、数字标准、材料型号、施工禁忌、避坑逻辑完全不变，不篡改任何核心细节；严格控制纯文字 + 数字字数400-480 字，对应时长100-120s。
-（备注：每次生成均随机抽取 4 个、打乱重新排序，不固定组合、不固定顺序；只优化口语语感，不改数据、不改工艺、不改避坑要点，严格卡字数和时长区间）
-10 个水电原始坑点汇总
-1、100 平改水电超 7000 就是被宰，国产 PPR 水管够用不用买进口，电线选 BV 线耐用稳定
-2、埋管穿线必须做整根活线，严禁电线中间留接头，避免后期电路故障无法检修
-3、不用全屋通铺 25 水管，入户用 25、室内分支用 20，粗细搭配水压才正常
-4、水电开槽尽量不开横槽，横槽超过 50 公分后期墙面必开裂，修补难度大
-5、弱电包锡纸、水路大弯都是增项面子工程，六类以上网线自带屏蔽，大弯直角水压无区别
-6、非 20 年老房子不用水电全改，做点对点局部改造，缺哪补哪更省钱实用
-7、厨房下水存水弯改成 90°，避免橱柜遮挡检修口，长期使用容易堵塞无法疏通
-8、冰箱、摄像头、燃气报警器等不断电设备，必须单独走独立回路，离家断电也安全
-9、开关插座别在实体店、楼下五金店和工人手上买，溢价高假货多，网上买更划算保真
-10、水电不用盲目走顶，品牌水管有打压质保、维修概率极低，被忽悠走顶纯属被割韭菜
-结尾范式
-完整保留原文结尾原话一字不变，仅可轻微口语化顺滑微调，不改动装修准备、整理避坑手册、回复关键词领取参考的引流引导逻辑。
-【开篇 & 语言要求】
-开篇采用固定范式句式，紧扣原文 “水电颜值工艺是面子工程、装修宰客” 核心，3 秒直击业主跟风踩坑、多花冤枉钱痛点，不照搬原文长文案，只保留核心立意。
-全程沿用原文接地气吐槽大白话，内行视角讲干货，直白易懂不生硬说教，贴合装修业主共情口吻。
-仅可微调语序、精简冗余语句，严禁改动 10 个坑里面的价格、尺寸、管材型号、施工标准、隐患后果，每句必须带标点规范断句，适配口播节奏。
-【内置固定原文案】
-改水电就是你装修被宰的第一刀，干得越漂亮，这一刀就扎得越深。什么好看的大弧弯，横平竖直，看起来是好看，但其实大多数都是面子工程，除了让你多花钱，实际用处一点都没有。水电改造真正重要的 10 个细节你要记住了，就不可能踩坑，全是干货。建议你点赞收藏慢慢看。
-首先，100 平的房子改水电，如果超过 7000 块，你就是被宰了。记住，水管只要是 PPR 管，无论是保利、伟星、日丰哪个国产牌子，都可以，让你买进口的都是看你好骗。电线你就选 BV 线，导电性能稳定，耐用几十年。
-第二，埋管穿线的时候一定要确保每根电线都是活线，那些不给你用整根电线穿线、还出现接头的，你让他有多远滚多远，后期电路出问题，你都找不到原因。
-第三，现在的装修公司都建议你水管用 25 的，说水压大，入住以后你发现水压没有明显的变化。真正的做法是，入户门到室内用 25 的，其他的水管用 20 的就行了。水管从粗到细，水压才能变大，你都换成 25 的根本没有必要。
-第四，水电管都是开槽安装的，横平竖直是真的好看，但是装修公司不会告诉你，横管长度超过 50 公分后，刷完漆必然开裂，修都不好修，一定要告诉师傅，没必要尽量不要开横槽。
-第五，弱电锡纸的包裹、水路大弯工艺等，这些都是容易增项的。现在超过六类的网线基本上都是自带屏蔽功能，包锡纸也是个样子工程，根本没必要。还有大弯水管和直角水管，真的没有水压大小的区别。
-第六，如果你不是 20 年前的老房子，水电没必要全改，去做点对点改造，哪里不够就加哪里，这样省钱还不影响使用。
-第七，厨房的下水存水弯必须改成 90°，不然贴完瓷砖、装好橱柜，原始检修口几乎和橱柜底板挨着，根本打不开。时间一长，垃圾冲也冲不动、扣也扣不着，很容易堵塞。
-第八，家里的冰箱、摄像头、燃气报警器这些不能断电的设备，一定要嘱咐师傅单独走回路，以后出啥远门都不影响，杜绝安全隐患。
-第九，开关插座完全没有必要去实体店买，尤其楼下那些小五金店，很多都是假货，成本可能只有五六块钱一个，却卖到三四十块钱一个，你说这有良心吗？网上购买不仅价格实惠，而且更容易买到正品。如果装修工人给你带的开关插座，我劝你不要用，因为这些成本可能只有两三块钱一个。
-第十，水电走地好，如果师傅跟你说水电走顶好维修、还不会抬高地面，那他就是逮着你割韭菜了。现在品牌的水管完工后都会上门打压测试，维修概率极低。而且，你要是有了质保，后期真出问题，赔的都够你再买一套房子。
-如果你也准备新房装修，我整理了一份装修避坑手册，回个手册发你参考。
-【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
-卧室原始状态-翻新基础
-厨卫原始状态-翻新基础
-客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
-全屋地板铺设施工-主材安装
-全屋开关面板安装-主材安装
-卫浴洁具进场安装-主材安装
-厨卫集成吊顶安装-主材安装
-室内房门安装固定-主材安装
-橱柜柜体现场组装-主材安装
-灯具筒灯射灯安装-主材安装
-衣柜移门五金安装-主材安装
-全屋五金调试-收尾细节
-成品瑕疵修补-收尾细节
-柜体门缝调整-收尾细节
-门窗缝隙密封处理-收尾细节
-全屋基础开荒保洁-美缝开荒
-地面残留胶迹清理-美缝开荒
-撕美缝胶-美缝开荒
-玻璃胶收边打胶细节-美缝开荒
-瓷砖缝隙清理清灰-美缝开荒
-美缝扩缝-美缝开荒
-美缝施工-美缝开荒
-美缝检查-美缝开荒
-门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
-全屋定制柜体打底-柜体木作
-木作封边贴皮-柜体木作
-环保板材现场堆放-柜体木作
-阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
-吸睛画面-恶搞开篇
-工地恶搞-恶搞开篇
-搞笑涂料施工-恶搞开篇
-暴力拆除-恶搞开篇
-炫技-恶搞开篇
-贴砖恶搞-恶搞开篇
-墙体掉落-施工翻车镜
-墙面开裂-施工翻车镜
-墙面空鼓-施工翻车镜
-水管错位-施工翻车镜
-电线乱接-施工翻车镜
-防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
-柜体开合顺畅度检查-全屋验收
-踢脚线安装验收-软装进场
-验收合格签字确认-全屋验收
-窗帘轨道窗帘安装-软装进场
-【分镜固定结构规则】
-开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，贴近水电改造、施工翻车、装修套路主题，优先选工地恶搞、墙面空鼓、毛坯全景等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜。
-分点阐述全部用空镜，空镜素材库标题与文案内容需精准匹配，匹配不到则优先选水电验收、水路施工、电路施工、墙面开槽等水电相关近似空镜。
-结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜。
-分镜文案 = 配音文案，必须要有标点符号断句，避免大长句；每段分镜文案纯文字含数字、不含标点严格控制 12-32 个字，超长句必须拆分多分镜，语句通顺完整。
-全篇文案硬性约束：纯文字 + 数字扣除标点严控400-480 字、总时长锁定100-120s，不得偏离区间。
-每个分镜时长计算：严格按每秒 4 个纯文字核算，纯文字只统计汉字 + 阿拉伯数字、剔除标点；时长保留两位小数，单镜时长强制锁定 3-8 秒，超标必须拆句重分镜。
-type 定义：segment = 人物出镜；empty_shot = 从上方内置素材库选匹配标题。
-人物出镜画面允许语句语意顺延到下一分镜；空镜必须贴合当前配音文案水电避坑主题。
-每次创作自动从 10 个水电坑随机选 4 个、重新打乱排序，不固定组合、不固定顺序。
-禁止篡改原文 10 个水电坑的价格、尺寸、材料、施工工艺、避坑核心逻辑。
-【输出格式要求】
-输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
-一、分镜内容
-id: 按顺序递增（1、2、3…）
-type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
-voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合装修业主水电避坑痛点）
-duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数）
-【示例】
-[
-{
-"id": 1,
-"type": "empty_shot",
-"scene": "贴砖恶搞 - 恶搞开篇",
-"voiceover": "瓦工进场只盯海棠角，后期必踩大坑，7 个细节记牢",
-"duration": "5.25s"
-},
-{
-"id": 2,
-"type": "segment",
-"scene": "人物出镜",
-"voiceover": "瓦工一来先交代这 7 个细节，师傅绝对不敢糊弄你",
-"duration": "5.25s"
-},
-{
-"id": 3,
-"type": "empty_shot",
-"scene": "墙砖定位-瓷砖铺贴",
-"voiceover": "先说好瓷砖排版，别让瓦工做，商家免费排更精准",
-"duration": "5.00s"
-}
-]
@@ -0,0 +1,86 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修避坑口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【普通人装修，就算再有钱，这6样东西，也不能买贵的
+】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：从下面给出的9组装修避坑对比中，**每次随机抽取6组**
+4. 格式要求：每组单独成行，格式严格为"X不要买贵的，Y要买贵的"，必须拆分两行
+5. 随机要求：6组的顺序必须完全随机打乱，每次生成的组合不能重复
+6. 禁止添加任何额外内容（包括标题、序号、解释、空行等）
+
+以下是全部9组避坑对比库：
+床不要买贵的，床垫要买贵的
+灯具不要买贵的，开关插座要买贵的
+木门不要买贵的，门锁要买贵的
+乳胶漆不要买贵的，腻子粉要买贵的
+电视机不要买贵的，投影仪要买贵的
+水槽不要买贵的，水龙头要买贵的
+瓷砖不要买贵的，木地板要买贵的
+前置过滤器不要买贵的，全屋角阀要买贵的
+窗帘不要买贵的，滑轨要买贵的
+【语言要求】
+全程口语化大白话，通俗易懂、接地气，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
+【内置完整素材库标题】
+床不要买贵的
+床垫要买贵的
+灯具不要买贵的
+开关插座要买贵的
+木门不要买贵的
+门锁要买贵的
+乳胶漆不要买贵的
+腻子粉要买贵的
+电视机不要买贵的
+投影仪要买贵的
+水槽不要买贵的
+水龙头要买贵的
+瓷砖不要买贵的
+木地板要买贵的
+前置过滤器不要买贵的
+全屋角阀要买贵的
+窗帘不要买贵的
+滑轨要买贵的
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “普通人装修，就算再有钱，这6样东西，也不能买贵的。”,
+“duration”: “5.25s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “床不要买贵的”,
+“voiceover”: “床不要买贵的”,
+“duration”: “1.50s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “床垫要买贵的”,
+“voiceover”: “床垫要买贵的”,
+“duration”: “1.50s”
+}
+]
@@ -229,7 +229,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数）
 【示例】
@@ -27,28 +27,13 @@
 要是还有不懂的、近期准备新房装修的朋友，我整理了一份装修避坑手册供你参考，评论区抠避坑，拿去用。
 【内置完整素材库标题】
 合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
 厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
 毛坯全屋广角全景-毛坯基础
 阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
 装修合同核对-现场交底
 卧室原始状态-翻新基础
 厨卫原始状态-翻新基础
 客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
 设计师入户-量房勘测
 全屋地板铺设施工-主材安装
 全屋开关面板安装-主材安装
@@ -71,126 +56,10 @@
 美缝施工-美缝开荒
 美缝检查-美缝开荒
 门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
 全屋定制柜体打底-柜体木作
 木作封边贴皮-柜体木作
 环保板材现场堆放-柜体木作
 阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
 吸睛画面-恶搞开篇
 工地恶搞-恶搞开篇
 搞笑涂料施工-恶搞开篇
@@ -203,7 +72,6 @@
 水管错位-施工翻车镜
 电线乱接-施工翻车镜
 防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
 柜体开合顺畅度检查-全屋验收
 踢脚线安装验收-软装进场
 验收合格签字确认-全屋验收
@@ -224,7 +92,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】
@@ -232,7 +232,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -240,7 +240,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },
@@ -0,0 +1,98 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修流程口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【新房装修全流程】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：严格按照下面的装修流程顺序，可适当调整表述，保持简洁明了
+
+以下是装修顺序：
+第一步、砸墙
+第二步、封窗
+第三步、改水电
+第四步、包隔音棉
+第五步、刷防水
+第六步、闭水试验
+第七步、铺地砖
+第八步、美缝
+第九步、铺地膜
+第十步、吊顶
+第十一步、刮腻子
+第十二步、刷漆
+第十三步、全屋定制
+第十四步、装烟机灶具
+第十五步、装门
+第十六步、装踢脚线
+第十七步、装灯
+第十八步、卫浴
+第十九步、保洁
+第二十步、装窗帘
+第二十一步、软装进场
+
+【语言要求】
+全程简洁化口语，尽量字少的同时表达准确意思，适配口播传播节奏
+【内置完整素材库标题】
+墙体拆除-墙体拆除
+封窗施工
+水电完工全屋环视-水电验收
+管道隔音棉加装-包管找平
+墙面地面防水涂料涂刷-防水施工
+厨卫闭水试验蓄水-防水施工
+铺地砖-瓷砖铺贴
+美缝施工-美缝开荒
+地面地砖地膜保护-成品保护
+石膏板固定-吊顶造型
+全屋批刮第一遍腻子-墙面基层
+墙面纯色面漆涂刷-面漆涂刷
+全屋定制柜体打底-柜体木作
+装烟机灶具
+室内房门安装固定-主材安装
+踢脚线安装验收-软装进场
+灯具筒灯射灯安装-主材安装
+卫浴洁具进场安装-主材安装
+全屋基础开荒保洁-美缝开荒
+窗帘轨道窗帘安装-软装进场
+家具进场摆放就位-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “新房装修全流程”,
+“duration”: “1.75s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “墙体拆除-墙体拆除”,
+“voiceover”: “第一步、砸墙。”,
+“duration”: “1.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “封窗施工”,
+“voiceover”: “第二步、封窗”,
+“duration”: “1.25s”
+}
+]
@@ -241,7 +241,7 @@ type 定义：segment = 人物出镜；empty_shot = 从上方内置素材库选
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合装修业主水电避坑痛点）
 duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数）
 【示例】
@@ -263,7 +263,7 @@ duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字
 {
 "id": 3,
 "type": "empty_shot",
-"scene": "墙砖定位-瓷砖铺贴",
+"scene": "瓷砖铺贴 - 瓷砖铺贴",
 "voiceover": "先说好瓷砖排版，别让瓦工做，商家免费排更精准",
 "duration": "5.00s"
 }
@@ -226,7 +226,7 @@ type 为 segment = 人物出镜；type=empty_shot = 从下方内置素材库选
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】
@@ -229,7 +229,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment” 或 “empty_shot”
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题
 voiceover: “配音文案”
 duration: “分镜时长”
 【示例】
@@ -251,7 +251,7 @@ duration: “分镜时长”
 {
 "id": 3,
 "type": "empty_shot",
-"scene": "墙固施工-墙面基层",
+"scene": "墙面基层 - 墙面基层",
 "voiceover": "第一，原始墙面刷高渗透墙固，自费也能防开裂反碱。",
 "duration": "5.25s"
 }
@@ -240,7 +240,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -248,7 +248,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },
@@ -231,7 +231,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】
@@ -230,7 +230,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “瓷砖铺完别着急复工，这 5 件事做早了全是坑” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -231,7 +231,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -3,12 +3,12 @@
 （一）核心定位
 精准锁定：硬装刚完工、不懂软装进场前后收尾细节、着急搬家具入住容易遗留隐患，后期发霉反味、墙面破损难修补的装修业主，围绕硬装结束必做 7 个收尾关键要点创作，按原意逻辑编排，可适度口语微调保留原意。
 （二）脚本类型
-装修口播短视频脚本，结构固定：开头硬装收尾痛点引入 + 7 个收尾避坑干货 + 结尾避坑手册引导，无多余内容，无重复，无冗余。
+装修口播短视频脚本，结构固定：开头硬装收尾痛点引入 + 6 个收尾避坑干货 + 结尾避坑手册引导，无多余内容，无重复，无冗余。
 【平台适配】
 竖屏 9:16 拍摄
 【核心强制规则】
-开头范式：完整保留原文开头核心原意，仅轻微口语化微调，用警示现实视角点出硬装刚完工别急着进软装，忽略 7 个收尾细节入住容易留隐患、生活闹心吵架的痛点，引出下文 7 个必做收尾关键点。
-中间核心（硬装完工 7 个收尾避坑要点，文案适当调整修改，意思保持原意，保留原有先后逻辑，不随机打乱，可口语顺滑润色）：
+开头范式：完整保留原文开头核心原意，仅轻微口语化微调，用警示现实视角点出硬装刚完工别急着进软装，忽略 7 个收尾细节入住容易留隐患、生活闹心吵架的痛点，引出下文 6 个必做收尾关键点。
+中间核心（硬装完工 6 个收尾避坑要点，文案适当调整修改，意思保持原意，保留原有先后逻辑，不随机打乱，可口语顺滑润色）：
 瓷砖除蜡：亮光砖、柔光砖在家具进场前，一定要用瓷砖除蜡剂全屋拖洗一遍，避免表层蜡质残留，入住后地面发蒙有水雾感，看着别扭难打理。
 柜体防护：餐边柜、橱柜吊柜底部贴静电防水膜，阻隔水汽熏坏柜体；橱柜内部铺贴铝箔纸，提升防潮效果，日常清洁打理更省心。
 地漏整改：逐一检查全屋地漏是否存在断层，有断层及时加装加长地漏芯，防止渗水进入砂浆层，避免后期反味、墙面起皮发霉等遗留隐患。
@@ -20,14 +20,14 @@
 排序逻辑：严格按原文 6 大收尾要点顺序排列，不打乱结构，贴合硬装完工到软装进场的真实施工流程，层层递进符合业主装修收尾认知逻辑。
 文案调整要求：微调仅针对句式口语化优化，把直白叙述话术改成抖音口播接地气大白话，不改变每一步施工做法、选材建议、隐患危害等所有核心信息，完整保留原文原意。
 字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 440-480 字，按每秒 4 个纯文字计算，对应时长 110-120s，讲解收尾细节细致不啰嗦，节奏适中，适配短视频完播率。
-内容适配性：7 个收尾要点衔接自然，每一条独立适配空镜分镜，直击业主硬装完工急于入住、忽略隐蔽收尾细节，后期返工闹心的核心痛点，每一条都讲清做法、原因和避坑作用，实用性极强。
+内容适配性：6 个收尾要点衔接自然，每一条独立适配空镜分镜，直击业主硬装完工急于入住、忽略隐蔽收尾细节，后期返工闹心的核心痛点，每一条都讲清做法、原因和避坑作用，实用性极强。
 结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修全流程避坑手册、评论区扣关键词引导的核心逻辑。
 【开篇 & 语言要求】
 开篇沿用原文警示吐槽语气，3 秒抓眼球，点破硬装刚结束着急搬软装、忽略收尾细节入住就留隐患闹矛盾的真实痛点，瞬间引发装修完工业主共鸣。
 全程口语化大白话，通俗易懂、接地气，站业主立场拆解装修收尾细节，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
 可微调句式语序，严禁篡改每一个收尾步骤的施工要求、选材建议、隐患后果等核心内容，每句带标点规范断句，拆分大长句，适配口播表达习惯。
 【内置固定原文案】
-装修千万别硬装刚结束就急着把沙发、床这些软装搬进去。先把下面这 7 个收尾的活安排明白，要不然等你人入住进去以后，两口子天天吵架。
+装修千万别硬装刚结束就急着把沙发、床这些软装搬进去。先把下面这 6 个收尾的活安排明白，要不然等你人入住进去以后，两口子天天吵架。
 第一，不管你家是亮光砖还是柔光砖，趁家具还没进场，赶紧网购一瓶瓷砖除蜡剂，把地面彻底拖一遍。不然等你住进去，地面怎么都像蒙了一层水雾，看着就闹心。
 第二，餐边柜和橱柜吊柜底部建议贴一层静电防水膜，防止水蒸气慢慢把咱家的吊柜熏坏了。再有就是橱柜里边贴上铝箔纸，它防潮性会更好，而且更好打理卫生。
 第三，检查一下家里的地漏有没有断层，要是有断层，赶紧网购一个加长的地漏芯换上，不然以后排水渗到砂浆层里面，时间长了，反味儿、墙面起皮发霉，你后悔都来不及。
@@ -36,30 +36,9 @@
 第六，乳胶漆施工后记得留一些未兑水的原漆，装在密封瓶里保存，后期安装门、柜体时难免磕碰，方便随时修补。
 记不住的，我都整理在这份装修全流程避坑手册里了。评论扣避坑，拿好少踩坑。
 【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
 卧室原始状态-翻新基础
 厨卫原始状态-翻新基础
 客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
 全屋地板铺设施工-主材安装
 全屋开关面板安装-主材安装
 卫浴洁具进场安装-主材安装
@@ -70,9 +49,6 @@
 衣柜移门五金安装-主材安装
 全屋五金调试-收尾细节
 成品瑕疵修补-收尾细节
-柜体门缝调整-收尾细节
-门窗缝隙密封处理-收尾细节
-全屋基础开荒保洁-美缝开荒
 地面残留胶迹清理-美缝开荒
 撕美缝胶-美缝开荒
 玻璃胶收边打胶细节-美缝开荒
@@ -80,30 +56,6 @@
 美缝扩缝-美缝开荒
 美缝施工-美缝开荒
 美缝检查-美缝开荒
-门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
 中央空调风口预留-吊顶造型
 双眼皮吊顶封板施工-吊顶造型
 吊顶完工展示-吊顶造型
@@ -121,8 +73,6 @@
 木作封边贴皮-柜体木作
 环保板材现场堆放-柜体木作
 阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
 强弱电间距查验-水电验收
 水电完工全屋环视-水电验收
 水管打压测试操作-水电验收
@@ -141,30 +91,12 @@
 水管铺设-水路施工
 热水器管路预留对接-水路施工
 阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
 全屋墙面铲除大白-墙面基层
 全屋批刮第一遍腻子-墙面基层
 墙固施工-墙面基层
 墙面裂缝挂网防裂-墙面基层
 墙面阴阳角找直处理-墙面基层
 腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
 乳胶漆修补-面漆涂刷
 乳胶漆效果展示-面漆涂刷
 乳胶漆调配-面漆涂刷
@@ -173,10 +105,6 @@
 背景墙艺术漆施工-面漆涂刷
 门窗边角精细刷涂-面漆涂刷
 顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
 下水口瓷砖铺贴-瓷砖铺贴
 厨卫墙地通缝铺贴-瓷砖铺贴
 地砖干铺施工工艺-瓷砖铺贴
@@ -193,14 +121,6 @@
 贴墙砖-瓷砖铺贴
 铺地砖-瓷砖铺贴
 铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
 吸睛画面-恶搞开篇
 工地恶搞-恶搞开篇
 搞笑涂料施工-恶搞开篇
@@ -213,11 +133,7 @@
 水管错位-施工翻车镜
 电线乱接-施工翻车镜
 防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
-柜体开合顺畅度检查-全屋验收
 踢脚线安装验收-软装进场
-验收合格签字确认-全屋验收
-窗帘轨道窗帘安装-软装进场
 【分镜固定结构规则】
 开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近硬装收尾、软装进场、装修细节避坑主题，优先选工地恶搞、墙面空鼓、硬装完工全屋全景等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
 分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选美缝开荒、成品保护、收尾细节、瓷砖铺贴等贴合硬装收尾避坑主题的空镜）
@@ -232,7 +148,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 “5.25s”）
 【示例】
@@ -232,7 +232,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -240,7 +240,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },
@@ -231,7 +231,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -239,7 +239,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },
@@ -231,7 +231,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】
@@ -233,7 +233,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -0,0 +1,160 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修避坑口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【装修避坑】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：从下面给出的34组装修避坑对比中，**每次随机抽取10组**
+4. 格式要求：每组单独成行，格式严格为"不要X，要Y"，必须拆分两行
+5. 随机要求：10组的顺序必须完全随机打乱，每次生成的组合不能重复
+6. 禁止添加任何额外内容（包括标题、序号、解释、空行等）
+
+以下是全部34组避坑对比库：
+不要双开门冰箱，要十字开门冰箱
+不要直吸式马桶，要虹吸式马桶
+不要路由器，要全屋WiFi
+不要贵妃椅沙发，要直排沙发
+不要集成灶，要分体灶
+不要榻榻米，要普通床
+不要普通门锁，要智能门锁
+不要瓷砖上墙，要乳胶漆
+不要筒灯，要射灯
+不要深色地砖，要浅色地砖
+不要小双槽，要大单槽
+不要过门石，要全屋通铺
+不要反弹器，要免拉手
+不要无主灯，要双眼皮
+不要复杂背景墙，要简单背景墙
+不要拼色窗帘，要纯色窗帘
+不要正五孔插座，要斜五孔插座
+不要悬空马桶，要落地马桶
+不要回型吊顶，要双眼皮吊顶
+不要复杂吊灯，要吸顶灯
+不要插座外露，要隐藏式插座
+不要开放式收纳柜，要封闭式收纳柜
+不要一体式卫生间，要干湿分离卫生间
+不要造型柜门，要平板柜门
+不要直排下水，要墙排下水
+不要隐形衣架，要普通衣架
+不要双包套，要单包套
+不要阳角条，要海棠角
+不要悬浮电视柜，要落地电视柜
+不要高光衣柜门，要肤感衣柜门
+不要推拉门，要打通阳台
+不要猫眼，要一体门
+不要洗烘一体，要洗烘套装
+不要罗马杠，要窗帘盒
+【语言要求】
+全程口语化大白话，通俗易懂、接地气，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
+【内置完整素材库标题】
+不要双开门冰箱
+要十字开门冰箱
+不要直吸式马桶
+要虹吸式马桶
+不要路由器
+要全屋WiFi
+不要贵妃椅沙发
+要直排沙发
+不要集成灶
+要分体灶
+不要榻榻米
+要普通床
+不要普通门锁
+要智能门锁
+不要瓷砖上墙
+要乳胶漆
+不要筒灯
+要射灯
+不要深色地砖
+要浅色地砖
+不要小双槽
+要大单槽
+不要过门石
+要全屋通铺
+不要反弹器
+要免拉手
+不要无主灯
+要双眼皮
+不要复杂背景墙
+要简单背景墙
+不要拼色窗帘
+要纯色窗帘
+不要正五孔插座
+要斜五孔插座
+不要悬空马桶
+要落地马桶
+不要回型吊顶
+要双眼皮吊顶
+不要复杂吊灯
+要吸顶灯
+不要插座外露
+要隐藏式插座
+不要开放式收纳柜
+要封闭式收纳柜
+不要一体式卫生间
+要干湿分离卫生间
+不要造型柜门
+要平板柜门
+不要直排下水
+要墙排下水
+不要隐形衣架
+要普通衣架
+不要双包套
+要单包套
+不要阳角条
+要海棠角
+不要悬浮电视柜
+要落地电视柜
+不要高光衣柜门
+要肤感衣柜门
+不要推拉门
+要打通阳台
+不要猫眼
+要一体门
+不要洗烘一体
+要洗烘套装
+不要罗马杠
+要窗帘盒
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “装修避坑”,
+“duration”: “1s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “不要小双槽”,
+“voiceover”: “不要小双槽”,
+“duration”: “1.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “要大单槽”,
+“voiceover”: “要大单槽”,
+“duration”: “1s”
+}
+]
@@ -260,7 +260,7 @@ type 定义：segment = 人物出镜；empty_shot = 从上方内置素材库选
 一、分镜内容
 id: 按顺序递增（1、2、3…），不得重复、不得跳跃，严格按自然顺序编号
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充），严格对应定义，不得写错
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写；空镜必须从内置素材库中选择，不得自行创作场景）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主；空镜必须从内置素材库中选择，不得自行创作场景）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合装修业主咨询避坑痛点，保留原文问题原意）
 duration: “分镜时长”（格式如 “5s”“5.25s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数，核算精准，不出现偏差）
 【示例】
@@ -236,7 +236,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -244,7 +244,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },
@@ -223,7 +223,7 @@ type规则：segment=人物出镜，empty_shot=选上方素材库标题。
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】
@@ -230,7 +230,7 @@ type 定义：segment = 人物出镜；empty_shot = 从上方素材库选匹配
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数）
 【示例】
@@ -0,0 +1,121 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修避坑口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【装修材料怎么选】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：从下面给出的21组装修材料选择中，**每次随机抽取12组**
+4. 格式要求：每组单独成行，格式严格为"XXX选哪家，A、B、C"，必须拆分两行
+5. 随机要求：12组的顺序必须完全随机打乱，每次生成的组合不能重复
+6. 禁止添加任何额外内容（包括标题序号解释空行等）
+
+以下是全部21组装修材料选择库：
+冰箱买谁家？海尔、美的、卡萨帝。
+电视买谁家？索尼、海信、TCL。
+花洒哪家好？九牧、恒洁、箭牌。
+电线买谁家？远东、宝胜、熊猫。
+烟机哪家好？方太、老板、华帝。
+乳胶漆买谁家？立邦、三棵树、多乐士。
+开关插座买谁家？公牛、施耐德、西门子。
+瓷砖哪家好？东鹏、冠珠、马可波罗。
+水管买谁家？日丰、伟星、保利。
+板材选谁家？万华、爱格、兔宝宝。
+防水买谁家？立邦、德高、东方雨虹
+吊顶选谁家？奥普、友邦、法狮龙。
+地板哪家好？圣象、世友、大自然。
+腻子粉哪家好？立邦、美巢、圣戈邦。
+地漏谁家好？九牧、箭牌、潜水艇。
+家装水管谁家好？金牛、伟星、日丰
+家装水泥谁家好？海螺、红狮、中联
+厨卫五金谁家好？科勒、九牧、汉斯格雅
+石膏板谁家好？龙牌、泰山、可耐福
+瓷砖胶谁家好？德高、西卡、马贝
+玻璃胶谁家好？瓦克、西卡、百得
+【语言要求】
+全程口语化大白话，通俗易懂接地气，条理清晰干货满满，不生硬说教，适配口播传播节奏
+【内置完整素材库标题】
+冰箱买谁家
+海尔美的卡萨帝
+电视买谁家
+索尼海信TCL
+花洒哪家好
+九牧恒洁箭牌
+电线买谁家
+远东宝胜熊猫
+烟机哪家好
+方太老板华帝
+乳胶漆买谁家
+立邦三棵树多乐士
+开关插座买谁家
+公牛施耐德西门子
+瓷砖哪家好
+东鹏冠珠马可波罗
+水管买谁家
+日丰伟星保利
+板材选谁家
+万华爱格兔宝宝
+防水买谁家
+立邦德高东方雨虹
+吊顶选谁家
+奥普友邦法狮龙
+地板哪家好
+圣象世友大自然
+腻子粉哪家好
+立邦美巢圣戈邦
+地漏谁家好
+九牧箭牌潜水艇
+家装水管谁家好
+金牛伟星日丰
+家装水泥谁家好
+海螺红狮中联
+厨卫五金谁家好
+科勒九牧汉斯格雅
+石膏板谁家好
+龙牌泰山可耐福
+瓷砖胶谁家好
+德高西卡马贝
+玻璃胶谁家好
+瓦克西卡百得
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “装修材料怎么选”,
+“duration”: “1.75s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “冰箱买谁家”,
+“voiceover”: “冰箱买谁家？”,
+“duration”: “1.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “卡萨帝海尔美的”,
+“voiceover”: “卡萨帝、海尔、美的”,
+“duration”: “1.75s”
+}
+]
@@ -252,7 +252,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】
@@ -260,7 +260,7 @@ duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },
@@ -251,7 +251,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 “5.25s”）
 【示例】
@@ -128,10 +128,11 @@ class ViduProvider:

        logger.info(f"[Vidu TTS] 请求参数: text_length={len(text)}")

-        logger.info(f"[Vidu LipSync] 提交请求: url={url}, body={body}")
+        logger.info(f"[Vidu TTS] 提交请求: url={url}, body={body}")

        try:
-            resp = await self.client.post(url, json=body)
+            # 文本较长时同步合成可能耗时较久，超时时间放宽到 120 秒
+            resp = await self.client.post(url, json=body, timeout=httpx.Timeout(120.0, connect=5.0))
            data = resp.json()
            if resp.status_code != 200 or data.get("state") == "failed":
                msg = data.get("err_code") or data.get("message") or f"HTTP {resp.status_code}"
@@ -177,7 +178,8 @@ class ViduProvider:
            body["payload"] = payload

        try:
-            resp = await self.client.post(url, json=body)
+            # 声音复刻处理音频可能耗时较久，超时时间放宽到 120 秒
+            resp = await self.client.post(url, json=body, timeout=httpx.Timeout(120.0, connect=5.0))
            data = resp.json()
            if resp.status_code != 200 or data.get("state") == "failed":
                msg = data.get("err_code") or data.get("message") or f"HTTP {resp.status_code}"
@@ -0,0 +1,174 @@
+"""
+火山引擎 MediaKit Provider
+===========================
+
+直接封装火山引擎 MediaKit HTTP API：
+- 图像背景移除（/api/v1/tools/remove-image-background/sync）
+
+使用 httpx.AsyncClient，支持外部注入（由 lifespan 管理生命周期）。
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+import httpx
+
+from app.config import get_settings
+from app.core.exceptions import PlatformError, PlatformErrorType
+
+logger = logging.getLogger(__name__)
+
+
+def _map_mediakit_error(status: int, message: str, code: int | None = None) -> PlatformError:
+    """把 MediaKit 错误映射为标准 PlatformError"""
+    error_mapping = {
+        400: (PlatformErrorType.BAD_REQUEST, False),
+        401: (PlatformErrorType.AUTH_FAILED, False),
+        403: (PlatformErrorType.AUTH_FAILED, False),
+        429: (PlatformErrorType.RATE_LIMIT, True),
+        500: (PlatformErrorType.SERVER_ERROR, True),
+        502: (PlatformErrorType.SERVER_ERROR, True),
+        503: (PlatformErrorType.SERVER_ERROR, True),
+    }
+    error_type, retryable = error_mapping.get(status, (PlatformErrorType.UNKNOWN, False))
+    return PlatformError(
+        message, platform="volcengine_mediakit",
+        retryable=retryable, error_type=error_type,
+        status_code=status,
+    )
+
+
+class VolcengineMediakitProvider:
+    """火山引擎 MediaKit Provider
+
+    直接调用 MediaKit HTTP API，不做业务层处理。
+    """
+
+    BASE_URL = "https://mediakit.cn-beijing.volces.com"
+    REMOVE_BG_PATH = "/api/v1/tools/remove-image-background/sync"
+    DEFAULT_TIMEOUT = 60.0
+
+    def __init__(
+        self,
+        token: str | None = None,
+        client: httpx.AsyncClient | None = None,
+    ):
+        settings = get_settings()
+        self.token = token or settings.VOLCENGINE_MEDIAKIT_TOKEN or ""
+
+        if not self.token:
+            raise PlatformError(
+                "VOLCENGINE_MEDIAKIT_TOKEN 未配置",
+                platform="volcengine_mediakit",
+                retryable=False,
+                error_type=PlatformErrorType.BAD_REQUEST,
+            )
+
+        if client is not None:
+            self.client = client
+            self._owns_client = False
+        else:
+            self.client = httpx.AsyncClient(timeout=self.DEFAULT_TIMEOUT)
+            self._owns_client = True
+
+    def _get_headers(self) -> dict:
+        return {
+            "Authorization": f"Bearer; {self.token}",
+            "Content-Type": "application/json",
+        }
+
+    async def close(self) -> None:
+        """关闭 HTTP 客户端"""
+        if self._owns_client and self.client and not self.client.is_closed:
+            await self.client.aclose()
+
+    async def remove_background(
+        self,
+        image_url: str,
+        scene: str = "general",
+        need_contour: bool = False,
+        contour_color: str = "#FFFFFF",
+        contour_size: int = 10,
+        need_crop_background: bool = False,
+    ) -> dict[str, Any]:
+        """同步抠图，返回原始 JSON
+
+        Args:
+            image_url: 原始图片 URL
+            scene: 场景类型
+            need_contour: 是否为主体生成描边（仅 human/product 场景生效）
+            contour_color: 描边颜色，十六进制 RGB 格式
+            contour_size: 描边宽度（px），范围 [1, 100]
+            need_crop_background: 是否裁剪透明背景到刚好包裹主体
+
+        Returns:
+            {"code": 0, "message": "Success", "data": {"image_url": "https://..."}}
+        """
+        payload: dict[str, Any] = {"image_url": image_url, "scene": scene}
+        if need_contour:
+            payload["need_contour"] = True
+            payload["contour_color"] = contour_color
+            payload["contour_size"] = max(1, min(100, contour_size))
+        if need_crop_background:
+            payload["need_crop_background"] = True
+
+        try:
+            response = await self.client.post(
+                f"{self.BASE_URL}{self.REMOVE_BG_PATH}",
+                json=payload,
+                headers=self._get_headers(),
+            )
+            response.raise_for_status()
+            data = response.json()
+
+            # 火山引擎 MediaKit 有两种响应格式：
+            # 格式1: {"code": 0, "message": "...", "data": {...}}
+            # 格式2: {"success": true, "result": {...}, "expires_at": ...}
+            code = data.get("code")
+            if code is not None:
+                # 格式1
+                if code != 0:
+                    logger.warning(
+                        f"[MediaKit] 抠图业务失败: code={code}, "
+                        f"message={data.get('message', 'N/A')}, "
+                        f"raw_response={data}, image_url={image_url[:80]}..."
+                    )
+                    raise _map_mediakit_error(
+                        response.status_code,
+                        data.get("message", f"抠图失败: code={code}"),
+                        code=code,
+                    )
+                return data
+            else:
+                # 格式2
+                if not data.get("success", False):
+                    logger.warning(
+                        f"[MediaKit] 抠图业务失败: success=false, "
+                        f"raw_response={data}, image_url={image_url[:80]}..."
+                    )
+                    raise _map_mediakit_error(
+                        response.status_code,
+                        "抠图失败: 平台返回失败状态",
+                    )
+                # 将格式2标准化为格式1，方便上层统一处理
+                return {
+                    "code": 0,
+                    "message": "Success",
+                    "data": data.get("result", {}),
+                }
+
+        except PlatformError:
+            raise
+        except httpx.HTTPStatusError as e:
+            raise _map_mediakit_error(
+                e.response.status_code, f"HTTP错误: {e.response.status_code}"
+            ) from e
+        except (httpx.NetworkError, httpx.TimeoutException) as e:
+            raise PlatformError(
+                f"MediaKit 网络错误: {e}", platform="volcengine_mediakit",
+                retryable=True, error_type=PlatformErrorType.TIMEOUT,
+            ) from e
+        except Exception as e:
+            raise _map_mediakit_error(500, f"抠图失败: {str(e)}") from e
@@ -0,0 +1,43 @@
+"""
+背景音乐 API
+===========
+
+提供装修行业场景化 BGM 列表查询。
+"""
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.api.deps import get_db
+from app.crud.bgm_music import bgm_music
+from app.schemas.bgm_music import BgmMusicItem, BgmMusicListResponse
+from app.schemas.common import ApiResponse
+
+router = APIRouter()
+
+
+@router.get("/bgm-musics", response_model=ApiResponse[BgmMusicListResponse])
+async def list_bgm_musics(
+    category: str | None = Query(None, description="场景分类筛选"),
+    db: AsyncSession = Depends(get_db),
+) -> ApiResponse[BgmMusicListResponse]:
+    """
+    获取背景音乐列表
+
+    按场景分类返回可用的背景音乐列表。
+    分类说明：
+    - knowledge: 知识科普（极简、低频）
+    - showcase: 案例展示（积极、有成就感）
+    - promotion: 促销活动（轻快、有能量）
+    - lifestyle: 家居生活（温馨、治愈）
+    - tech: 智能家居（科技感、高级感）
+    """
+    items = await bgm_music.get_active_by_category(db, category=category)
+    return ApiResponse(
+        code=200,
+        message="success",
+        data=BgmMusicListResponse(
+            items=[BgmMusicItem.model_validate(item) for item in items],
+            total=len(items),
+        ),
+    )
@@ -0,0 +1,262 @@
+"""
+图片处理 API
+============
+
+提供图片上传（七牛云）和 AI 抠图（火山引擎 MediaKit）功能。
+"""
+
+import io
+import logging
+import time
+import uuid
+from pathlib import Path
+
+import httpx
+from fastapi import APIRouter, Depends, File, HTTPException, Request, UploadFile
+from pydantic import BaseModel, Field
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.api.deps import get_current_user, get_db
+from app.config import get_settings
+from app.models.user import User
+from app.schemas.common import ApiResponse, success_response
+from app.services import point_service as ps
+from app.services.qiniu_service import get_qiniu_service
+from app.services.volcengine_mediakit_service import VolcengineMediakitService
+from app.utils.file_validation import check_upload_file
+
+router = APIRouter(tags=["Image"])
+
+logger = logging.getLogger(__name__)
+settings = get_settings()
+
+
+# ── Dependencies ──
+
+async def get_mediakit_service(request: Request) -> VolcengineMediakitService:
+    """FastAPI Depends：从 app.state 获取全局 VolcengineMediakitService 实例。"""
+    service = getattr(request.app.state, "volcengine_mediakit_service", None)
+    if service is None:
+        raise HTTPException(
+            status_code=503,
+            detail="MediaKit 服务未初始化，请检查配置",
+        )
+    return service
+
+
+# ── Schemas ──
+
+class ImageUploadResponse(BaseModel):
+    """图片上传响应"""
+
+    url: str = Field(..., description="七牛云图片 URL")
+    key: str = Field(..., description="七牛云文件 key")
+    size: int = Field(..., description="文件大小（字节）")
+
+
+class RemoveBackgroundResponse(BaseModel):
+    """抠图响应"""
+
+    url: str = Field(..., description="抠图结果图片 URL")
+
+
+class RemoveBackgroundRequest(BaseModel):
+    """抠图请求"""
+
+    image_url: str = Field(..., description="原始图片 URL")
+    scene: str = Field(default="human", description="场景类型：general（通用）、human（人物，默认白色描边）或 product（商品）")
+
+
+# ── Endpoints ──
+
+@router.post("/upload/image", response_model=ApiResponse[ImageUploadResponse])
+async def upload_image(
+    file: UploadFile = File(..., description="图片文件"),
+    current_user: User = Depends(get_current_user),
+) -> ApiResponse[ImageUploadResponse]:
+    """
+    上传图片到七牛云
+
+    支持格式：jpg, jpeg, png, gif, webp
+    返回七牛云永久访问 URL。
+    """
+    try:
+        allowed_types = {
+            "image/jpeg",
+            "image/jpg",
+            "image/png",
+            "image/gif",
+            "image/webp",
+        }
+        content_type = file.content_type or ""
+
+        # 如果 content_type 为空，尝试从文件名推断
+        if not content_type:
+            ext = Path(file.filename or "").suffix.lower()
+            ext_to_mime = {
+                ".jpg": "image/jpeg",
+                ".jpeg": "image/jpeg",
+                ".png": "image/png",
+                ".gif": "image/gif",
+                ".webp": "image/webp",
+            }
+            content_type = ext_to_mime.get(ext, "")
+
+        if content_type not in allowed_types:
+            raise HTTPException(
+                status_code=400,
+                detail=f"不支持的图片格式: {content_type}，请上传 jpg/png/gif/webp 图片",
+            )
+
+        # 读取文件内容
+        content = await file.read()
+        if not content:
+            raise HTTPException(status_code=400, detail="文件内容为空")
+
+        # 校验大小和魔数
+        check_upload_file(
+            content,
+            settings.UPLOAD_MAX_IMAGE_SIZE,
+            content_type,
+            "图片",
+        )
+
+        # 生成唯一文件名
+        ext = Path(file.filename or "image.jpg").suffix or ".jpg"
+        unique_name = f"{uuid.uuid4().hex[:16]}{ext}"
+
+        # 上传到七牛云
+        qiniu = get_qiniu_service()
+        bucket, domain = qiniu._get_bucket_and_domain("image")
+        file_key = qiniu.generate_key("image", unique_name)
+        stream = io.BytesIO(content)
+        result = await qiniu.upload_stream_async(
+            stream=stream,
+            key=file_key,
+            mime_type=content_type or "image/jpeg",
+            bucket=bucket,
+            domain=domain,
+        )
+
+        url = result.get("url")
+        returned_key = result.get("key")
+
+        if not url:
+            raise HTTPException(status_code=500, detail="上传到七牛云失败：未返回 URL")
+
+        logger.info(f"[Upload] 图片上传成功: {url[:80]}..., size={len(content)}")
+
+        return success_response(
+            data=ImageUploadResponse(
+                url=url,
+                key=returned_key or file_key,
+                size=len(content),
+            )
+        )
+
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"[Upload] 图片上传失败: {e}")
+        raise HTTPException(status_code=500, detail=f"上传失败: {e}")
+
+
+@router.post("/image/remove-background", response_model=ApiResponse[RemoveBackgroundResponse])
+async def remove_background(
+    req: RemoveBackgroundRequest,
+    current_user: User = Depends(get_current_user),
+    mediakit_service: VolcengineMediakitService = Depends(get_mediakit_service),
+    db: AsyncSession = Depends(get_db),
+) -> ApiResponse[RemoveBackgroundResponse]:
+    """
+    AI 抠图（火山引擎 MediaKit）
+
+    移除图片背景，返回透明背景图片 URL。
+    每次调用消耗 10 积分。
+    """
+    # 前置积分检查
+    required_points = ps._calculate_cost("cover_avatar")
+    check = await ps.check_balance(db, current_user.id, required_points)
+    if not check["sufficient"]:
+        raise HTTPException(
+            status_code=402,
+            detail=f"积分不足，需要 {required_points} 积分，当前余额 {check['balance']}",
+        )
+
+    try:
+        logger.info(
+            f"[RemoveBackground] 开始抠图: image_url={req.image_url[:80]}..., scene={req.scene}"
+        )
+        result = await mediakit_service.remove_background(
+            image_url=req.image_url,
+            scene=req.scene,
+        )
+
+        if not result.image_url:
+            logger.error(
+                f"[RemoveBackground] 抠图返回空 URL: raw={result.raw}"
+            )
+            raise HTTPException(status_code=500, detail="抠图失败：未返回结果图片 URL")
+
+        logger.info(f"[RemoveBackground] 抠图成功: {result.image_url[:80]}...")
+
+        # 下载抠图结果并转存到七牛云（避免前端 CORS 问题）
+        try:
+            async with httpx.AsyncClient(timeout=60.0) as client:
+                img_resp = await client.get(result.image_url, follow_redirects=True)
+                img_resp.raise_for_status()
+                img_content = img_resp.content
+
+            if not img_content:
+                raise HTTPException(status_code=500, detail="抠图结果下载失败：内容为空")
+
+            # 上传到七牛云 image bucket
+            qiniu = get_qiniu_service()
+            bucket, domain = qiniu._get_bucket_and_domain("image")
+            unique_name = f"{uuid.uuid4().hex[:16]}.png"
+            file_key = qiniu.generate_key("image", unique_name)
+            stream = io.BytesIO(img_content)
+            upload_result = await qiniu.upload_stream_async(
+                stream=stream,
+                key=file_key,
+                mime_type="image/png",
+                bucket=bucket,
+                domain=domain,
+            )
+
+            qiniu_url = upload_result.get("url")
+            if not qiniu_url:
+                raise HTTPException(status_code=500, detail="抠图结果转存到七牛云失败")
+
+            logger.info(f"[RemoveBackground] 结果已转存七牛云: {qiniu_url[:80]}...")
+
+            # 后置扣费（服务已调用成功）
+            await ps.consume(
+                db,
+                user_id=current_user.id,
+                points=required_points,
+                source_type="cover_avatar",
+                source_id=f"cover_avatar_{current_user.id}_{int(time.time() * 1000)}",
+                description="【封面形象抠图】",
+            )
+            await db.commit()
+
+            return success_response(
+                data=RemoveBackgroundResponse(url=qiniu_url),
+                message="抠图成功",
+            )
+        except HTTPException:
+            raise
+        except Exception as e:
+            logger.error(f"[RemoveBackground] 结果转存失败: {e}")
+            raise HTTPException(status_code=500, detail=f"抠图结果转存失败: {e}")
+
+    except HTTPException:
+        raise
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(
+            f"[RemoveBackground] 抠图失败: image_url={req.image_url[:80]}..., error={e}"
+        )
+        raise HTTPException(status_code=500, detail=f"抠图失败: {e}")
@@ -7,9 +7,11 @@ from fastapi import APIRouter

 from app.api.v1 import (
    auth,
+    bgm_music,
    caption,
    cover_background,
    events,
+    image,
    materials,
    points,
    script,
@@ -59,5 +61,11 @@ api_router.include_router(cover_background.router, tags=["Cover Background"])
 # 积分系统模块
 api_router.include_router(points.router, tags=["Points"])

+# 图片处理模块（上传 + 抠图）
+api_router.include_router(image.router, tags=["Image"])
+
+# 背景音乐模块
+api_router.include_router(bgm_music.router, tags=["BGM Music"])
+
 # 应用更新模块
 api_router.include_router(update.router, prefix="/update", tags=["Update"])
@@ -14,10 +14,11 @@ import time
 from fastapi import APIRouter, Depends, HTTPException
 from sqlalchemy.ext.asyncio import AsyncSession

+from app.ai.model_router import get_model_router
+from app.ai.prompts import list_categories, list_prompt_files, load_prompt, render_template
 from app.api.deps import get_current_user
 from app.db.session import get_db
-from app.ai.model_router import get_model_router
-from app.ai.prompts import list_categories, load_prompt, render_template
+from app.models.user import User
 from app.schemas.common import ApiResponse, success_response
 from app.schemas.script import (
    CategoryItem,
@@ -25,9 +26,8 @@ from app.schemas.script import (
    GenerateTitleResponse,
    PolishRequest,
 )
-from app.services.script_service import get_script_service
 from app.services import point_service as ps
-from app.models.user import User
+from app.services.script_service import get_script_service

 router = APIRouter()
 logger = logging.getLogger(__name__)
@@ -38,9 +38,11 @@ async def get_categories():
    """
    获取提示词分类列表

-    返回所有大类和小类结构，供前端选择。
+    返回所有大类及其下的提示词文件列表，供前端选择。
    """
    categories = list_categories()
+    for cat in categories:
+        cat["files"] = list_prompt_files(cat["code"])
    return success_response(
        data=categories,
        message="获取分类列表成功",
@@ -36,7 +36,7 @@ class ScriptParams(BaseModel):
    """脚本生成参数"""

    category: str = Field(..., min_length=1, description="大类代码")
-    subcategory: str = Field(..., min_length=1, description="小类代码")
+    filename: str = Field(..., min_length=1, description="提示词文件名")


    @field_validator("category")
@@ -46,11 +46,11 @@ class ScriptParams(BaseModel):
            raise ValueError("category 不能为空")
        return v.strip()

-    @field_validator("subcategory")
+    @field_validator("filename")
    @classmethod
-    def validate_subcategory(cls, v: str) -> str:
+    def validate_filename(cls, v: str) -> str:
        if not v or not v.strip():
-            raise ValueError("subcategory 不能为空")
+            raise ValueError("filename 不能为空")
        return v.strip()


@@ -174,7 +174,7 @@ async def create_task(
            required_points = ps._calculate_cost("script")
            validated_params = {
                "category": script_validated.category,
-                "subcategory": script_validated.subcategory,
+                "filename": script_validated.filename,
            }

        elif task_type == "subtitle":
@@ -7,7 +7,7 @@

 from datetime import UTC, datetime

-from fastapi import APIRouter, Depends, HTTPException, Query, status
+from fastapi import APIRouter, Depends, HTTPException, Query, Response, status
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession

@@ -44,25 +44,30 @@ async def check_update(
    latest: AppRelease | None = result.scalar_one_or_none()

    if not latest:
-        raise HTTPException(status_code=status.HTTP_204_NO_CONTENT)
+        return Response(status_code=status.HTTP_204_NO_CONTENT)

    # 已是最新版本（或更高）
    if latest.version == version:
-        raise HTTPException(status_code=status.HTTP_204_NO_CONTENT)
+        return Response(status_code=status.HTTP_204_NO_CONTENT)

-    # 查询对应平台的包
+    # 查询对应平台的包（优先返回 updater 用的包：有 signature 的 .app.tar.gz / .exe）
    result = await db.execute(
        select(ReleasePackage).where(
            ReleasePackage.release_id == latest.id,
            ReleasePackage.platform == target,
            ReleasePackage.architecture == arch,
+        ).order_by(
+            # 有 signature 的排前面（updater 包），空 signature 的排后面（dmg 安装包）
+            ReleasePackage.signature.desc()
        )
    )
-    pkg: ReleasePackage | None = result.scalar_one_or_none()
+    pkgs = result.scalars().all()
+    # 取第一个：优先有 signature 的 updater 包；如果没有则取任意一个
+    pkg: ReleasePackage | None = pkgs[0] if pkgs else None

    if not pkg:
        # 该平台无包，返回 204（避免报错阻断用户）
-        raise HTTPException(status_code=status.HTTP_204_NO_CONTENT)
+        return Response(status_code=status.HTTP_204_NO_CONTENT)

    # 构建 Tauri 格式的响应
    platform_key = f"{target}-{arch}"
@@ -18,6 +18,7 @@ from app.config import get_settings
 from app.models.user import User
 from app.schemas.common import ApiResponse, success_response
 from app.services.qiniu_service import get_qiniu_service
+from app.utils.file_validation import check_upload_file

 router = APIRouter(prefix="/upload", tags=["Upload"])

@@ -25,101 +26,6 @@ logger = logging.getLogger(__name__)
 settings = get_settings()


-def _validate_file_magic(content: bytes, expected_content_type: str) -> bool:
-    """通过文件头魔数校验文件真实类型，防止 MIME 伪造攻击。"""
-    if len(content) < 12:
-        return False
-
-    # 拒绝常见危险文件头
-    dangerous_signatures = [
-        (b"MZ", "Windows 可执行文件"),           # .exe, .dll
-        (b"#!", "Shell 脚本"),                    # bash, python, etc
-        (b"PK\x03\x04", "ZIP 压缩包"),            # .zip, .jar, .docx
-        (b"<?xml", "XML 文件"),
-        (b"<html", "HTML 文件"),
-        (b"<!DO", "HTML 文档"),
-        (b"%PDF", "PDF 文件"),
-    ]
-    for sig, _ in dangerous_signatures:
-        if content.startswith(sig):
-            return False
-    if b"<script" in content[:512].lower():
-        return False
-
-    main_type = expected_content_type.split("/")[0]
-
-    # 图片校验
-    if main_type == "image":
-        if content.startswith(b"\xff\xd8\xff"):
-            return expected_content_type in ("image/jpeg", "image/jpg")
-        if content.startswith(b"\x89PNG\r\n\x1a\n"):
-            return expected_content_type == "image/png"
-        if content.startswith(b"GIF89a") or content.startswith(b"GIF87a"):
-            return expected_content_type == "image/gif"
-        if content.startswith(b"RIFF") and content[8:12] == b"WEBP":
-            return expected_content_type == "image/webp"
-        return False
-
-    # 视频校验
-    if main_type == "video":
-        # MP4 / MOV / M4V 等 ISO Base Media File Format
-        if content[4:8] == b"ftyp":
-            brand = content[8:12]
-            if brand in (b"qt  ", b"qtw "):
-                return expected_content_type in ("video/quicktime",)
-            # mp4, isom, avc1, mp41, mp42 等
-            return expected_content_type in (
-                "video/mp4",
-                "video/quicktime",
-            )
-        if content.startswith(b"RIFF") and content[8:12] == b"AVI ":
-            return expected_content_type == "video/x-msvideo"
-        if content.startswith(b"\x1aE\xdf\xa3"):
-            return expected_content_type == "video/webm"
-        return False
-
-    # 音频校验
-    if main_type == "audio":
-        if content[:3] == b"ID3" or content[:2] in (
-            b"\xff\xfb",
-            b"\xff\xf3",
-            b"\xff\xf2",
-        ):
-            return expected_content_type in ("audio/mpeg", "audio/mp3")
-        if content.startswith(b"RIFF") and content[8:12] == b"WAVE":
-            return expected_content_type in ("audio/wav", "audio/x-wav")
-        if content.startswith(b"fLaC"):
-            return expected_content_type == "audio/flac"
-        if content.startswith(b"OggS"):
-            return expected_content_type == "audio/ogg"
-        # AAC / M4A（也是 ftyp 格式）
-        if content[4:8] == b"ftyp":
-            brand = content[8:12]
-            if brand in (b"M4A ", b"m4a ", b"mp42", b"isom", b"M4P "):
-                return expected_content_type in (
-                    "audio/mp4",
-                    "audio/aac",
-                    "audio/m4a",
-                )
-        return False
-
-    return False
-
-
-def _check_upload_file(content: bytes, max_size: int, content_type: str, type_label: str) -> None:
-    """统一校验文件大小和魔数，失败时直接抛 HTTPException。"""
-    if len(content) > max_size:
-        max_mb = max_size // 1024 // 1024
-        raise HTTPException(
-            status_code=413,
-            detail=f"{type_label}文件大小不能超过 {max_mb}MB",
-        )
-    if not _validate_file_magic(content, content_type):
-        raise HTTPException(
-            status_code=400,
-            detail=f"{type_label}文件内容与实际格式不符，可能存在安全风险",
-        )
-

 class UploadResponse(BaseModel):
    """上传响应"""
@@ -173,7 +79,7 @@ async def upload_video(
            raise HTTPException(status_code=400, detail="文件内容为空")

        # 校验大小和魔数
-        _check_upload_file(
+        check_upload_file(
            content,
            settings.UPLOAD_MAX_VIDEO_SIZE,
            content_type,
@@ -269,7 +175,7 @@ async def upload_audio(
            raise HTTPException(status_code=400, detail="文件内容为空")

        # 校验大小和魔数
-        _check_upload_file(
+        check_upload_file(
            content,
            settings.UPLOAD_MAX_AUDIO_SIZE,
            content_type,
@@ -43,7 +43,11 @@ async def vidu_callback(request: Request):
    body_bytes = await request.body()
    headers_dict = dict(request.headers)

-    logger.info(f"[Vidu] 收到回调: url={request.url}, body={body_bytes.decode('utf-8', errors='replace')[:500]}")
+    # 使用 APP_BASE_URL 构建 callback_url，确保与提交任务时传给 Vidu 的一致
+    #（Nginx 反向代理可能导致 request.url 的 scheme 为 http，与 Vidu 签名时的 https 不一致）
+    app_base_url = get_settings().app_base_url
+    callback_url = f"{app_base_url}/api/v1/vidu/callback" if app_base_url else str(request.url)
+    logger.info(f"[Vidu] 收到回调: request_url={request.url}, callback_url={callback_url}, body={body_bytes.decode('utf-8', errors='replace')[:500]}")

    try:
        task_status = await gateway.handle_webhook(
@@ -51,7 +55,7 @@ async def vidu_callback(request: Request):
            headers=headers_dict,
            body=body_bytes,
            secret=get_settings().VIDU_API_KEY,
-            callback_url=str(request.url),
+            callback_url=callback_url,
        )
    except PlatformError as e:
        logger.warning(f"[Vidu] 回调验证失败: {e}")
@@ -171,28 +171,37 @@ def _normalize_voice_id(name: str | None) -> str:
    将用户输入的名称规范化为 Vidu 合法的 voice_id。

    Vidu 要求：8~256 字符，首字符必须是字母。
+    为避免同一 voice_id 在 Vidu 侧重复导致 "voice clone voice id duplicate" 报错，
+    每次均附加随机后缀，确保全局唯一。
    """
+    # 固定后缀：下划线 + 6 位十六进制随机字符（7 字符）
+    suffix = f"_{uuid.uuid4().hex[:6]}"
+    suffix_len = len(suffix)
+
    if not name:
-        return f"vidu_{uuid.uuid4().hex[:8]}"
+        base = f"vidu_{uuid.uuid4().hex[:8]}"
+    else:
+        # 只保留字母、数字、下划线
+        base = re.sub(r"[^a-zA-Z0-9_]", "", name)

-    # 只保留字母、数字、下划线
-    cleaned = re.sub(r"[^a-zA-Z0-9_]", "", name)
+        # 确保首字符是字母
+        if base and not base[0].isalpha():
+            base = "v" + base
+        elif not base:
+            base = "voice"

-    # 确保首字符是字母
-    if cleaned and not cleaned[0].isalpha():
-        cleaned = "v" + cleaned
-    elif not cleaned:
-        cleaned = "voice"
+    # 预留后缀长度，总长度不超过 256
+    max_base_len = 256 - suffix_len
+    if len(base) > max_base_len:
+        base = base[:max_base_len]

-    # 长度不足 8，补足随机字符
-    if len(cleaned) < 8:
-        cleaned = cleaned + uuid.uuid4().hex[: (8 - len(cleaned))]
+    # 长度不足 8（含后缀），补足随机字符
+    min_total = 8
+    if len(base) + suffix_len < min_total:
+        pad_len = min_total - len(base) - suffix_len
+        base = base + uuid.uuid4().hex[:pad_len]

-    # 长度超过 256，截断
-    if len(cleaned) > 256:
-        cleaned = cleaned[:256]
-
-    return cleaned
+    return base + suffix


@router.post("/clone/submit", response_model=ApiResponse[VoiceCloneTaskResponse])
@@ -24,7 +24,7 @@ class Settings(BaseSettings):

    # 应用基础配置
    APP_NAME: str = Field(default="美家卡智影 API", description="应用名称")
-    APP_VERSION: str = Field(default="1.5.18", description="应用版本")
+    APP_VERSION: str = Field(default="1.8.1", description="应用版本")
    DEBUG: bool = Field(default=False, description="调试模式")
    ENV: Literal["development", "staging", "production"] = Field(
        default="development", description="运行环境"
@@ -88,7 +88,7 @@ class Settings(BaseSettings):

    # CORS 配置
    CORS_ORIGINS: str = Field(
-        default="http://localhost:1420,http://127.0.0.1:1420,http://localhost:8080,http://127.0.0.1:8080,tauri://localhost",
+        default="http://localhost:1420,http://127.0.0.1:1420,http://localhost:8080,http://127.0.0.1:8080,tauri://localhost,http://tauri.localhost,https://tauri.localhost",
        description="允许的跨域来源（逗号分隔）",
    )

@@ -106,6 +106,9 @@ class Settings(BaseSettings):
    VOLCENGINE_CAPTION_APPID: str | None = Field(default=None, description="火山字幕 AppID")
    VOLCENGINE_CAPTION_TOKEN: str | None = Field(default=None, description="火山字幕 Token")

+    # 火山引擎 MediaKit 服务（背景移除等多媒体处理）
+    VOLCENGINE_MEDIAKIT_TOKEN: str | None = Field(default=None, description="火山引擎 MediaKit Token")
+
    # Vidu 密钥（base_url 已从 Settings 移除，改用 config/platform-config.yaml 配置）
    VIDU_API_KEY: str | None = Field(default=None, description="Vidu API Key")

@@ -134,6 +137,10 @@ class Settings(BaseSettings):
    SMS_EXTENDED_CODE: str | None = Field(
        default=None, description="B2M 短信平台扩展码（选填）"
    )
+    SMS_CODE_WHITELIST: str = Field(
+        default="",
+        description="免验证码登录白名单（逗号分隔的手机号，如 13800138000,13900139000）",
+    )



@@ -175,6 +182,17 @@ class Settings(BaseSettings):
        """是否使用 Redis"""
        return bool(self.REDIS_HOST)

+    @property
+    def sms_code_whitelist_set(self) -> set[str]:
+        """免验证码登录白名单（去重、去空格）"""
+        if not self.SMS_CODE_WHITELIST:
+            return set()
+        return {
+            mobile.strip()
+            for mobile in self.SMS_CODE_WHITELIST.split(",")
+            if mobile.strip()
+        }
+

@lru_cache
 def get_settings() -> Settings:
@@ -10,6 +10,7 @@ CRUD 模块
    user_obj = await user.get(db, id="xxx")
 """

+from app.crud.bgm_music import bgm_music
 from app.crud.broll_category import broll_category
 from app.crud.broll_material import broll_material
 from app.crud.cover_background import cover_background
@@ -17,6 +18,7 @@ from app.crud.user import user

 __all__ = [
    "user",
+    "bgm_music",
    "broll_category",
    "broll_material",
    "cover_background",
@@ -0,0 +1,37 @@
+"""
+背景音乐 CRUD
+============
+"""
+
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.crud.base import CRUDBase
+from app.models.bgm_music import BgmMusic
+
+
+class BgmMusicCRUD(CRUDBase[BgmMusic]):
+    """背景音乐数据访问"""
+
+    def __init__(self) -> None:
+        super().__init__(BgmMusic)
+
+    async def get_active_by_category(
+        self, db: AsyncSession, *, category: str | None = None
+    ) -> list[BgmMusic]:
+        """
+        获取指定分类下状态为 active 的音乐列表
+
+        Args:
+            category: 场景分类，None 表示获取全部
+        """
+        query = select(BgmMusic).where(BgmMusic.status == "active")
+        if category:
+            query = query.where(BgmMusic.category == category)
+        query = query.order_by(BgmMusic.sort_order.asc(), BgmMusic.id.asc())
+        result = await db.execute(query)
+        return list(result.scalars().all())
+
+
+# 导出实例
+bgm_music = BgmMusicCRUD()
@@ -44,6 +44,44 @@ class BrollCategoryCRUD(CRUDBase[BrollCategory]):
        )
        return list(result.scalars().all())

+    async def get_children_by_parent_id(
+        self, db: AsyncSession, *, parent_id: int, level: int
+    ) -> list[BrollCategory]:
+        """根据父分类 ID 和层级获取启用的子分类"""
+        result = await db.execute(
+            select(BrollCategory).where(
+                BrollCategory.parent_id == parent_id,
+                BrollCategory.level == level,
+                BrollCategory.status == "active",
+            )
+        )
+        return list(result.scalars().all())
+
+    async def get_by_name_like_and_level(
+        self, db: AsyncSession, *, name: str, level: int
+    ) -> BrollCategory | None:
+        """根据名称模糊匹配和层级获取启用的分类（LIKE %name%）"""
+        result = await db.execute(
+            select(BrollCategory).where(
+                BrollCategory.name.like(f"%{name}%"),
+                BrollCategory.level == level,
+                BrollCategory.status == "active",
+            )
+        )
+        return result.scalar_one_or_none()
+
+    async def get_by_level(
+        self, db: AsyncSession, *, level: int
+    ) -> list[BrollCategory]:
+        """根据层级获取所有启用的分类"""
+        result = await db.execute(
+            select(BrollCategory).where(
+                BrollCategory.level == level,
+                BrollCategory.status == "active",
+            )
+        )
+        return list(result.scalars().all())
+

 # 导出实例
 broll_category = BrollCategoryCRUD()
@@ -66,6 +66,10 @@ async def lifespan(app: FastAPI):
            timeout=httpx.Timeout(60.0, connect=5.0),
            limits=httpx.Limits(max_connections=10, max_keepalive_connections=10),
        ),
+        "volcengine_mediakit": httpx.AsyncClient(
+            timeout=httpx.Timeout(60.0, connect=5.0),
+            limits=httpx.Limits(max_connections=10, max_keepalive_connections=10),
+        ),
        "default": httpx.AsyncClient(
            timeout=httpx.Timeout(30.0, connect=5.0),
            limits=httpx.Limits(max_connections=50, max_keepalive_connections=20),
@@ -90,6 +94,18 @@ async def lifespan(app: FastAPI):
        logger.warning(f"Volcengine Caption Provider 初始化跳过: {e}")
        app.state.volcengine_caption_provider = None

+    # 火山 Mediakit Provider
+    from app.ai.providers.volcengine_mediakit_provider import VolcengineMediakitProvider
+
+    try:
+        app.state.volcengine_mediakit_provider = VolcengineMediakitProvider(
+            client=app.state.http_clients["volcengine_mediakit"]
+        )
+        logger.info("Volcengine Mediakit Provider initialized")
+    except Exception as e:
+        logger.warning(f"Volcengine Mediakit Provider 初始化跳过: {e}")
+        app.state.volcengine_mediakit_provider = None
+
    # 火山方舟 Provider（可选，需要 API Key）
    try:
        from app.ai.providers.volcengine_provider import VolcengineProvider
@@ -104,6 +120,7 @@ async def lifespan(app: FastAPI):
    from app.ai.adapters.vidu_adapter import ViduAdapter
    from app.ai.adapters.volcengine_ark_adapter import VolcengineArkAdapter
    from app.ai.adapters.volcengine_caption_adapter import VolcengineCaptionAdapter
+    from app.ai.adapters.volcengine_mediakit_adapter import VolcengineMediakitAdapter
    from app.platform_gateway import PlatformGateway

    app.state.vidu_adapter = ViduAdapter(app.state.vidu_provider)
@@ -122,6 +139,15 @@ async def lifespan(app: FastAPI):
        )
        logger.info("VolcengineCaptionAdapter initialized")

+    if app.state.volcengine_mediakit_provider:
+        app.state.volcengine_mediakit_adapter = VolcengineMediakitAdapter(
+            app.state.volcengine_mediakit_provider
+        )
+        app.state.platform_gateway.register(
+            "volcengine_mediakit", app.state.volcengine_mediakit_adapter
+        )
+        logger.info("VolcengineMediakitAdapter initialized")
+
    if app.state.volcengine_provider:
        app.state.volcengine_ark_adapter = VolcengineArkAdapter(
            app.state.volcengine_provider
@@ -145,6 +171,7 @@ async def lifespan(app: FastAPI):
    # 初始化 Service（传入 Gateway）
    from app.services.vidu_service import ViduService
    from app.services.volcengine_caption_service import VolcengineCaptionService
+    from app.services.volcengine_mediakit_service import VolcengineMediakitService

    app.state.vidu_service = ViduService(app.state.platform_gateway)
    logger.info("Vidu Service initialized")
@@ -157,6 +184,14 @@ async def lifespan(app: FastAPI):
    else:
        app.state.volcengine_caption_service = None

+    if app.state.volcengine_mediakit_provider:
+        app.state.volcengine_mediakit_service = VolcengineMediakitService(
+            app.state.platform_gateway
+        )
+        logger.info("Volcengine Mediakit Service initialized")
+    else:
+        app.state.volcengine_mediakit_service = None
+
    # LLM Gateway（可选，向后兼容）
    if app.state.volcengine_provider:
        from app.ai.gateways.llm_gateway import LLMGateway
@@ -326,9 +361,9 @@ def main():
        workers=settings.WORKERS if not settings.DEBUG else 1,
        reload=settings.DEBUG,
        log_level=settings.LOG_LEVEL.lower(),
+        access_log=False,
    )


 if __name__ == "__main__":
    main()
-# test
@@ -7,6 +7,7 @@
 """

 from app.models.base import BaseModel, BaseModelBigInt
+from app.models.bgm_music import BgmMusic
 from app.models.broll_category import BrollCategory
 from app.models.broll_material import BrollMaterial
 from app.models.broll_tag import BrollTag
@@ -21,6 +22,7 @@ from app.models.user_point import UserPoint
 __all__ = [
    "BaseModel",
    "BaseModelBigInt",
+    "BgmMusic",
    "User",
    "UserDevice",
    "UserPoint",
@@ -0,0 +1,50 @@
+"""
+背景音乐模型
+==========
+
+装修行业场景化 BGM 库，按知识科普/案例展示/促销活动/家居生活/智能家居
+五个场景分类管理。
+"""
+
+from sqlalchemy import Float, Integer, String
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.models.base import BaseModelBigInt
+
+
+class BgmMusic(BaseModelBigInt):
+    """
+    背景音乐表
+
+    Attributes:
+        title: 音乐名称
+        artist: 艺术家
+        category: 场景分类 (knowledge/showcase/promotion/lifestyle/tech)
+        file_path: 相对文件路径（如 knowledge/3_Dance_with_Me.mp3）
+        duration: 时长（秒）
+        status: 状态 (active/inactive)
+        sort_order: 排序权重（越小越靠前）
+    """
+
+    __tablename__ = "mjk_bgm_musics"
+
+    title: Mapped[str] = mapped_column(String(255), nullable=False, comment="音乐名称")
+    artist: Mapped[str] = mapped_column(String(255), nullable=True, comment="艺术家")
+    category: Mapped[str] = mapped_column(
+        String(32), nullable=False, index=True, comment="场景分类"
+    )
+    file_path: Mapped[str] = mapped_column(
+        String(512), nullable=False, comment="相对文件路径"
+    )
+    url: Mapped[str] = mapped_column(
+        String(1024), nullable=False, comment="七牛云 URL"
+    )
+    duration: Mapped[float] = mapped_column(
+        Float, nullable=True, comment="时长（秒）"
+    )
+    status: Mapped[str] = mapped_column(
+        String(16), default="active", nullable=False, comment="状态: active/inactive"
+    )
+    sort_order: Mapped[int] = mapped_column(
+        Integer, default=0, nullable=False, comment="排序权重"
+    )
@@ -38,7 +38,7 @@ class AppRelease(Base):
 class ReleasePackage(Base):
    """平台安装包信息"""

-    __tablename__ = "mjk_release_packages"
+    __tablename__ = "mjk_app_release_packages"

    id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
    release_id: Mapped[int] = mapped_column(
@@ -60,5 +60,5 @@ class ReleasePackage(Base):
    release: Mapped["AppRelease"] = relationship("AppRelease", back_populates="packages")

    __table_args__ = (
-        UniqueConstraint("release_id", "platform", "architecture", name="uix_pkg_platform_arch"),
+        UniqueConstraint("release_id", "platform", "architecture", "filename", name="uix_app_pkg_platform_arch_filename"),
    )
@@ -22,18 +22,21 @@ from app.services.script_service import ScriptService
 logger = logging.getLogger(__name__)


-def _get_category_name(category: str, subcategory: str) -> str:
-    """从 _meta.json 查找分类中文名称，组合为 title"""
+def _get_category_name(category: str, filename: str) -> str:
+    """从文件名解析文案作为 title"""
    meta = _load_system_meta()
+    cat_name = category
    for cat in meta.get("categories", []):
        if cat.get("code") == category:
            cat_name = cat.get("name", category)
-            for sub in cat.get("subcategories", []):
-                if sub.get("code") == subcategory:
-                    sub_name = sub.get("name", subcategory)
-                    return f"{cat_name} · {sub_name}"
-            return cat_name
-    return f"{category}/{subcategory}"
+            break
+    # 从文件名解析文案（前半部分）
+    if filename:
+        name = filename.replace(".txt", "")
+        if "——" in name:
+            label = name.split("——", 1)[0]
+            return f"{cat_name} · {label}"
+    return cat_name

 SLOT_KEY = "script:slots"

@@ -93,7 +96,7 @@ class ScriptHandler(AsyncHandler):
        changes: list[StateChange] = []
        params = task.params or {}
        category = params.get("category", "")
-        subcategory = params.get("subcategory", "")
+        filename = params.get("filename", "")

        await registry.update(
            task.task_id,
@@ -114,13 +117,13 @@ class ScriptHandler(AsyncHandler):
            service = self._get_service()
            shots = await service.generate_script(
                category=category,
-                subcategory=subcategory,
+                filename=filename,
            )

            # 计算分镜真实总时长
            total_duration = sum(s.duration for s in shots if s.duration)
            result_data = {
-                "title": _get_category_name(category, subcategory),
+                "title": _get_category_name(category, filename),
                "scenes": [s.model_dump() for s in shots],
                "total_duration": total_duration,
                "shot_count": len(shots),
@@ -0,0 +1,29 @@
+"""
+背景音乐 Schema
+==============
+"""
+
+from pydantic import BaseModel, Field
+
+
+class BgmMusicItem(BaseModel):
+    """背景音乐项"""
+
+    id: int = Field(description="音乐ID")
+    title: str = Field(description="音乐名称")
+    artist: str | None = Field(default=None, description="艺术家")
+    category: str = Field(description="场景分类")
+    file_path: str = Field(description="相对文件路径")
+    url: str = Field(description="七牛云 URL")
+    duration: float | None = Field(default=None, description="时长（秒）")
+    sort_order: int = Field(default=0, description="排序权重")
+
+    class Config:
+        from_attributes = True
+
+
+class BgmMusicListResponse(BaseModel):
+    """背景音乐列表响应"""
+
+    items: list[BgmMusicItem] = Field(description="音乐列表")
+    total: int = Field(description="总数")
@@ -3,7 +3,6 @@
 ===============
 """

-from typing import Any

 from pydantic import BaseModel, ConfigDict, Field

@@ -12,12 +11,12 @@ from app.schemas.segment import Segment
 ScriptShot = Segment


-class SubcategoryItem(BaseModel):
-    """小类项"""
+class PromptFileItem(BaseModel):
+    """提示词文件项"""

-    code: str = Field(..., description="小类代码")
-    name: str = Field(..., description="小类名称")
-    count: int = Field(..., description="提示词文件数量")
+    filename: str = Field(..., description="文件名")
+    label: str = Field(..., description="文案（文件名前半部分）")
+    desc: str = Field(..., description="描述（文件名后半部分）")


 class CategoryItem(BaseModel):
@@ -25,14 +24,14 @@ class CategoryItem(BaseModel):

    code: str = Field(..., description="大类代码")
    name: str = Field(..., description="大类名称")
-    subcategories: list[SubcategoryItem] = Field(..., description="小类列表")
+    files: list[PromptFileItem] = Field(default_factory=list, description="提示词文件列表")


 class GenerateScriptRequest(BaseModel):
    """生成脚本请求"""

    category: str = Field(..., description="大类代码，如 bk")
-    subcategory: str = Field(..., description="小类代码，如 ht")
+    filename: str = Field(..., description="提示词文件名，如 水电改造避坑——水电改造的4个坑.txt")
    duration: int = Field(default=45, ge=30, le=180, description="视频时长（秒）")
    script_type: str = Field(default="干货型", description="脚本类型")
    model: str | None = Field(None, description="指定模型（可选）")
@@ -18,6 +18,7 @@ from typing import Any
 import httpx
 from sqlalchemy.ext.asyncio import AsyncSession

+from app.config import get_settings
 from app.core.redis_client import get_redis_client
 from app.core.security import (
    create_access_token,
@@ -188,8 +189,9 @@ async def login_with_sms(
    5. 创建/覆盖设备记录
    6. 签发双 Token
    """
-    # 1. 校验验证码
-    if not await verify_sms_code(mobile, code):
+    # 1. 校验验证码（白名单内的手机号跳过校验）
+    settings = get_settings()
+    if mobile not in settings.sms_code_whitelist_set and not await verify_sms_code(mobile, code):
        raise ValueError("验证码错误或已过期")

    # 2. 查询用户（不再自动注册）
@@ -15,6 +15,7 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from app.core.exceptions import ValidationException
 from app.core.redis_client import get_redis_client
 from app.crud import broll_category, broll_material
+from app.models.broll_category import BrollCategory

 logger = logging.getLogger(__name__)

@@ -25,7 +26,12 @@ _USED_MATERIALS_TTL = 7 * 24 * 3600
 def _normalize_scene(scene: str) -> str:
    """标准化场景描述，用于匹配三级分类 name"""
    # 去除所有 Unicode 空白字符（空格、全角空格、换行、tab 等）
-    return re.sub(r"\s+", "", scene)
+    cleaned = re.sub(r"\s+", "", scene)
+    # 去除常见中文标点符号（逗号、句号、感叹号、问号、顿号、分号、冒号、引号、括号等）
+    cleaned = re.sub(r"[，。！？、；：""''（）【】《》]+", "", cleaned)
+    # 去除零宽字符（零宽空格、零宽非连接符、零宽连接符、零宽非断空格等）
+    cleaned = re.sub(r"[\u200b-\u200f\ufeff]+", "", cleaned)
+    return cleaned


 def _weighted_choice(materials: list) -> object:  # noqa: ANN001
@@ -48,7 +54,7 @@ def _weighted_choice(materials: list) -> object:  # noqa: ANN001

    r = random.uniform(0, total_weight)
    cumulative = 0.0
-    for m, w in zip(materials, weights):
+    for m, w in zip(materials, weights, strict=True):
        cumulative += w
        if r <= cumulative:
            return m
@@ -57,6 +63,64 @@ def _weighted_choice(materials: list) -> object:  # noqa: ANN001
    return materials[-1]


+async def _try_fallback_to_parent(
+    db: AsyncSession,
+    normalized_scene: str,
+) -> BrollCategory | None:
+    """
+    三级分类匹配失败时，回退到上级（level=2）分类随机选取子分类。
+
+    解析逻辑：
+    - 若 scene 含 '-'，取后半部分作为 parent_name（如 '电路施工-电路施工' -> '电路施工'）
+    - 若不含 '-'，直接以整个 scene 作为 parent_name
+
+    匹配策略（逐级降级）：
+    1. 精确匹配 level=2 分类 name
+    2. 模糊匹配（LIKE %parent_name%），兼容 "电路施工" → "电路施工镜"
+    3. 去掉常见后缀（镜、阶段等）再精确匹配
+
+    返回：
+        随机选中的一个 level=3 子分类，或 None
+    """
+    if "-" in normalized_scene:
+        parent_name = normalized_scene.rsplit("-", 1)[-1]
+    else:
+        parent_name = normalized_scene
+
+    # 1. 精确匹配
+    parent = await broll_category.get_by_name_and_level(
+        db, name=parent_name, level=2
+    )
+
+    # 2. 模糊匹配（兼容 "电路施工" → "电路施工镜"）
+    if parent is None:
+        parent = await broll_category.get_by_name_like_and_level(
+            db, name=parent_name, level=2
+        )
+
+    # 3. 去掉常见后缀再试
+    if parent is None:
+        for suffix in ("镜", "阶段"):
+            if not parent_name.endswith(suffix):
+                candidate = parent_name + suffix
+                parent = await broll_category.get_by_name_and_level(
+                    db, name=candidate, level=2
+                )
+                if parent:
+                    break
+
+    if parent is None:
+        return None
+
+    children = await broll_category.get_children_by_parent_id(
+        db, parent_id=parent.id, level=3
+    )
+    if not children:
+        return None
+
+    return random.choice(children)
+
+
 async def match_material(
    db: AsyncSession,
    scene: str,
@@ -68,11 +132,13 @@ async def match_material(

    匹配策略：
    1. 标准化 scene，精确匹配三级分类（level=3）的 name。
-    2. 查询该分类下状态为 active、时长 >= required_duration 的素材。
-    3. 若提供 project_id，从 Redis 获取该项目已使用的 URL 并排除。
-    4. 优先从未使用候选中加权随机选择；若未用候选为空，
+    2. 若精确匹配失败，尝试将 "A-B" 倒序为 "B-A" 再匹配。
+    3. 若仍失败，回退到上级（level=2）分类，随机选取一个子分类。
+    4. 查询该分类下状态为 active、时长 >= required_duration 的素材。
+    5. 若提供 project_id，从 Redis 获取该项目已使用的 URL 并排除。
+    6. 优先从未使用候选中加权随机选择；若未用候选为空，
       fallback 到全部候选（允许复用，保证合成连续性）。
-    5. 原子递增 usage_count，并将选中的 URL 写入 Redis Set（7 天 TTL）。
+    7. 原子递增 usage_count，并将选中的 URL 写入 Redis Set（7 天 TTL）。

    Args:
        db: 数据库 Session
@@ -94,11 +160,21 @@ async def match_material(

    normalized = _normalize_scene(scene)

-    # 1. 查找三级分类（精确匹配 + 顺序颠倒兜底）
+    # 1. 查找三级分类（精确匹配 -> 全量内存匹配兜底 -> 顺序颠倒 -> 上级回退）
    category = await broll_category.get_by_name_and_level(
        db, name=normalized, level=3
    )
-    # 若精确匹配失败，尝试将 "A-B" 倒序为 "B-A" 再匹配
+    # 精确匹配失败时，全量查询后在内存标准化匹配（兼容数据库 name 含不可见字符）
+    if category is None:
+        all_categories = await broll_category.get_by_level(db, level=3)
+        for c in all_categories:
+            if _normalize_scene(c.name) == normalized:
+                category = c
+                logger.info(
+                    f"素材分类全量内存匹配命中: '{normalized}' -> '{c.name}'"
+                )
+                break
+    # 若仍失败，尝试将 "A-B" 倒序为 "B-A" 再匹配
    if category is None:
        parts = normalized.rsplit("-", 1)
        if len(parts) == 2:
@@ -110,17 +186,35 @@ async def match_material(
                logger.info(
                    f"素材分类顺序颠倒兜底命中: '{normalized}' -> '{reversed_name}'"
                )
+    # 若仍失败，回退到上级分类随机选取
    if category is None:
-        logger.debug(f"未找到分类: {normalized}")
+        category = await _try_fallback_to_parent(db, normalized)
+        if category:
+            logger.info(
+                f"素材回退到上级分类命中: '{normalized}' -> '{category.name}'"
+            )
+    if category is None:
+        logger.warning(f"素材匹配失败: 未找到分类 '{normalized}' (原始 scene: '{scene}')")
        return None

-    # 2. 查询候选素材
-    materials = await broll_material.get_active_by_category_and_duration(
-        db, category_id=category.id, min_duration=required_duration
+    # 2. 查询该分类下所有 active 素材（先不过滤时长，用于日志诊断）
+    all_materials = await broll_material.get_active_by_categories(
+        db, category_ids=[category.id]
    )
+    if not all_materials:
+        logger.warning(f"素材匹配失败: 分类 '{normalized}' 下无任何可用素材")
+        return None
+
+    # 按时长过滤（优先严格匹配，失败时逐步放宽到 70% 兜底）
+    materials = [m for m in all_materials if m.duration >= required_duration]
    if not materials:
-        logger.debug(
-            f"分类 {normalized} 无足够时长的素材 (需 >= {required_duration}s)"
+        materials = [m for m in all_materials if m.duration >= required_duration * 0.7]
+    if not materials:
+        materials = all_materials
+    if not materials:
+        max_duration = max(m.duration for m in all_materials)
+        logger.warning(
+            f"素材匹配失败: 分类 '{normalized}' 无足够时长的素材 (需 >= {required_duration}s, 最大可用: {max_duration}s)"
        )
        return None

@@ -187,37 +281,52 @@ async def batch_match(
    normalized_scenes = [_normalize_scene(s["scene"]) for s in scenes]
    unique_names = list(set(normalized_scenes))

-    # 2. 批量查询分类（1 次 DB）—— 同时查询原始名和倒序名
-    reversed_names: list[str] = []
-    name_to_reversed: dict[str, str] = {}
-    for name in unique_names:
-        parts = name.rsplit("-", 1)
-        if len(parts) == 2:
-            rev = f"{parts[1]}-{parts[0]}"
-            reversed_names.append(rev)
-            name_to_reversed[name] = rev
-
-    all_query_names = unique_names + reversed_names
+    # 2. 批量查询分类：优先精确查询，失败时全量内存匹配兜底
    categories = await broll_category.get_by_names_and_level(
-        db, names=all_query_names, level=3
+        db, names=unique_names, level=3
    )
    category_map: dict[str, object] = {}
    for c in categories:
-        category_map[c.name] = c
+        category_map[_normalize_scene(c.name)] = c
+
+    # 收集未命中的 name，准备全量兜底
+    unmatched_by_exact = [name for name in unique_names if name not in category_map]
+    if unmatched_by_exact:
+        all_categories = await broll_category.get_by_level(db, level=3)
+        for c in all_categories:
+            normalized_db_name = _normalize_scene(c.name)
+            if normalized_db_name not in category_map:
+                category_map[normalized_db_name] = c
+
+    # 构建原始 scene -> category 的映射
+    reversed_map: dict[str, str] = {}
+    for name in unique_names:
+        parts = name.rsplit("-", 1)
+        if len(parts) == 2:
+            reversed_map[name] = f"{parts[1]}-{parts[0]}"

-    # 构建原始 scene -> category 的映射（优先精确匹配，fallback 倒序匹配）
    scene_to_category: dict[str, object] = {}
    for name in unique_names:
        if name in category_map:
            scene_to_category[name] = category_map[name]
-        elif name in name_to_reversed and name_to_reversed[name] in category_map:
-            rev = name_to_reversed[name]
+        elif name in reversed_map and reversed_map[name] in category_map:
+            rev = reversed_map[name]
            scene_to_category[name] = category_map[rev]
            logger.info(
                f"批量匹配顺序颠倒兜底命中: '{name}' -> '{rev}'"
            )

-    # 3. 收集所有需要的 category_id
+    # 3. 未匹配的 scene 回退到上级分类随机选取
+    unmatched = [name for name in unique_names if name not in scene_to_category]
+    for name in unmatched:
+        fallback_cat = await _try_fallback_to_parent(db, name)
+        if fallback_cat:
+            scene_to_category[name] = fallback_cat
+            logger.info(
+                f"批量匹配回退到上级分类命中: '{name}' -> '{fallback_cat.name}'"
+            )
+
+    # 4. 收集所有需要的 category_id
    needed_category_ids = [
        scene_to_category[name].id
        for name in unique_names
@@ -253,13 +362,25 @@ async def batch_match(

        category = scene_to_category.get(scene_name)
        if category is None:
+            original_scene = scenes[idx]["scene"]
+            logger.warning(
+                f"批量素材匹配失败: 未找到分类 '{scene_name}' (原始 scene: '{original_scene}')"
+            )
            results.append(None)
            continue

        materials = materials_by_category.get(category.id, [])
-        # 按时长过滤
+        # 按时长过滤（优先严格匹配，失败时逐步放宽到 70% 兜底）
        candidates = [m for m in materials if m.duration >= required_duration]
        if not candidates:
+            candidates = [m for m in materials if m.duration >= required_duration * 0.7]
+        if not candidates:
+            candidates = materials
+        if not candidates:
+            max_duration = max((m.duration for m in materials), default=0)
+            logger.warning(
+                f"批量素材匹配失败: 分类 '{scene_name}' -> '{category.name}' 无足够时长的素材 (需 >= {required_duration}s, 最大可用: {max_duration}s)"
+            )
            results.append(None)
            continue

@@ -164,7 +164,7 @@ def _estimate_max_cost(source_type: str, param: dict | None = None) -> int:
 # ── 余额查询 ──────────────────────────────────────────

 async def get_user_balance(db: AsyncSession, user_id: UUID | str) -> dict:
-    """获取用户积分余额快照"""
+    """获取用户积分余额快照（实时计算，排除已过期批次）。"""
    result = await db.execute(
        select(UserPoint).where(UserPoint.user_id == user_id)
    )
@@ -178,8 +178,21 @@ async def get_user_balance(db: AsyncSession, user_id: UUID | str) -> dict:
            "total_expired": 0,
        }

+    # 实时计算可用余额（排除已过期批次），避免 expire_batches 延迟时数据不一致
+    from sqlalchemy import func as _func
+
+    available_result = await db.execute(
+        select(_func.coalesce(_func.sum(PointBatch.remaining), 0))
+        .where(
+            PointBatch.user_id == user_id,
+            PointBatch.remaining > 0,
+            PointBatch.expired_at > _now(),
+        )
+    )
+    available_balance = available_result.scalar() or 0
+
    return {
-        "balance": up.balance,
+        "balance": available_balance,
        "total_recharged": up.total_recharged,
        "total_consumed": up.total_consumed,
        "total_expired": up.total_expired,
@@ -316,6 +329,7 @@ _CATEGORY_MAP: dict[str, str] = {
    "compose": "压制成片",
    "subtitle_burn": "字幕烧录",
    "cover_design": "封面设计",
+    "cover_avatar": "封面形象",
    "wxpay": "充值",
    "compensation": "充值",
    "invite": "充值",
@@ -387,9 +401,10 @@ async def consume(
        db.add(up)
        await db.flush()

-    # 3. 余额检查（在同一事务内，避免竞态）
-    if not allow_negative and up.balance < points:
-        raise ValueError(f"积分不足，当前余额 {up.balance}，需要 {points} 积分")
+    # 3. 余额检查：用实时可用余额（未过期批次 remaining 总和），避免 expire_batches 延迟导致超扣
+    available = sum(b.remaining for b in batches)
+    if not allow_negative and available < points:
+        raise ValueError(f"积分不足，当前可用余额 {available}，需要 {points} 积分")

    remaining_to_deduct = points
    for batch in batches:
@@ -9,7 +9,7 @@ import time
 from pathlib import Path

 from app.ai.model_router import get_model_router
-from app.ai.prompts import load_script_user_prompt, load_system_prompt
+from app.ai.prompts import load_prompt_file, load_script_user_prompt
 from app.schemas.script import ScriptShot
 from app.services.ai_response_utils import (
    safe_parse_ai_json_response,
@@ -38,7 +38,7 @@ class ScriptService:
    async def generate_script(
        self,
        category: str,
-        subcategory: str,
+        filename: str,
        model: str | None = None,
    ) -> list[ScriptShot]:
        """
@@ -46,7 +46,7 @@ class ScriptService:

        Args:
            category: 大类代码，如 "bk"
-            subcategory: 小类代码，如 "ht"
+            filename: 提示词文件名，如 "水电改造避坑——水电改造的4个坑.txt"
            model: 指定模型

        Returns:
@@ -56,13 +56,13 @@ class ScriptService:
        model_router = await get_model_router()

        # 加载 Prompt
-        system_prompt = load_system_prompt(category, subcategory)
+        system_prompt = load_prompt_file(category, filename)
        if not system_prompt:
-            raise ValueError(f"未找到提示词: category={category}, subcategory={subcategory}")
+            raise ValueError(f"未找到提示词: category={category}, filename={filename}")

        # 用户提示词
        user_prompt = load_script_user_prompt(
-            topic=f"{category}/{subcategory}",
+            topic=f"{category}/{filename}",
        )

        # 调用 AI 生成
@@ -0,0 +1,89 @@
+"""
+火山引擎 MediaKit Service
+=========================
+
+通过 PlatformGateway 调用 MediaKit 第三方 API，自身负责：
+- 参数校验
+- 结果提取与格式化
+"""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass, field
+from typing import Any
+
+from app.ai.adapters.constants import Method
+from app.platform_gateway import PlatformGateway
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class RemoveBackgroundResult:
+    """抠图结果"""
+
+    image_url: str = ""
+    raw: dict[str, Any] = field(default_factory=dict)
+
+
+class VolcengineMediakitService:
+    """火山引擎 MediaKit 服务封装"""
+
+    # 支持的场景
+    SUPPORTED_SCENES = {"general", "human", "product"}
+
+    def __init__(self, gateway: PlatformGateway):
+        self.gateway = gateway
+
+    async def remove_background(
+        self,
+        image_url: str,
+        scene: str = "human",
+    ) -> RemoveBackgroundResult:
+        """同步抠图
+
+        Args:
+            image_url: 原始图片 URL
+            scene: 场景类型，"general"（通用）、"human"（人物）或 "product"（商品）
+
+        Returns:
+            RemoveBackgroundResult: 包含抠图结果图片 URL
+
+        Raises:
+            ValueError: 参数校验失败
+            PlatformError: 平台调用失败
+        """
+        if not image_url:
+            raise ValueError("image_url 不能为空")
+
+        if scene not in self.SUPPORTED_SCENES:
+            raise ValueError(f"不支持的场景: {scene}，可选: {self.SUPPORTED_SCENES}")
+
+        # 人物/商品场景默认启用白色描边 + 裁剪背景
+        enable_contour = scene in ("human", "product")
+        payload = {
+            "image_url": image_url,
+            "scene": scene,
+            "need_contour": enable_contour,
+            "contour_color": "#FFFFFF",
+            "contour_size": 20,
+            "need_crop_background": enable_contour,
+        }
+
+        response = await self.gateway.call_sync(
+            platform="volcengine_mediakit",
+            method=Method.REMOVE_BACKGROUND,
+            payload=payload,
+        )
+
+        if not response.success:
+            raise RuntimeError(
+                response.error_message or "抠图失败"
+            )
+
+        result_image_url = (response.data or {}).get("image_url", "")
+        return RemoveBackgroundResult(
+            image_url=result_image_url,
+            raw=response.data or {},
+        )
@@ -0,0 +1,105 @@
+"""
+文件校验工具
+==========
+
+提供文件头魔数校验和上传文件统一校验功能，
+防止 MIME 伪造攻击和危险文件上传。
+"""
+
+from fastapi import HTTPException
+
+
+def validate_file_magic(content: bytes, expected_content_type: str) -> bool:
+    """通过文件头魔数校验文件真实类型，防止 MIME 伪造攻击。"""
+    if len(content) < 12:
+        return False
+
+    # 拒绝常见危险文件头
+    dangerous_signatures = [
+        (b"MZ", "Windows 可执行文件"),           # .exe, .dll
+        (b"#!", "Shell 脚本"),                    # bash, python, etc
+        (b"PK\x03\x04", "ZIP 压缩包"),            # .zip, .jar, .docx
+        (b"<?xml", "XML 文件"),
+        (b"<html", "HTML 文件"),
+        (b"<!DO", "HTML 文档"),
+        (b"%PDF", "PDF 文件"),
+    ]
+    for sig, _ in dangerous_signatures:
+        if content.startswith(sig):
+            return False
+    if b"<script" in content[:512].lower():
+        return False
+
+    main_type = expected_content_type.split("/")[0]
+
+    # 图片校验
+    if main_type == "image":
+        if content.startswith(b"\xff\xd8\xff"):
+            return expected_content_type in ("image/jpeg", "image/jpg")
+        if content.startswith(b"\x89PNG\r\n\x1a\n"):
+            return expected_content_type == "image/png"
+        if content.startswith(b"GIF89a") or content.startswith(b"GIF87a"):
+            return expected_content_type == "image/gif"
+        if content.startswith(b"RIFF") and content[8:12] == b"WEBP":
+            return expected_content_type == "image/webp"
+        return False
+
+    # 视频校验
+    if main_type == "video":
+        # MP4 / MOV / M4V 等 ISO Base Media File Format
+        if content[4:8] == b"ftyp":
+            brand = content[8:12]
+            if brand in (b"qt  ", b"qtw "):
+                return expected_content_type in ("video/quicktime",)
+            # mp4, isom, avc1, mp41, mp42 等
+            return expected_content_type in (
+                "video/mp4",
+                "video/quicktime",
+            )
+        if content.startswith(b"RIFF") and content[8:12] == b"AVI ":
+            return expected_content_type == "video/x-msvideo"
+        if content.startswith(b"\x1aE\xdf\xa3"):
+            return expected_content_type == "video/webm"
+        return False
+
+    # 音频校验
+    if main_type == "audio":
+        if content[:3] == b"ID3" or content[:2] in (
+            b"\xff\xfb",
+            b"\xff\xf3",
+            b"\xff\xf2",
+        ):
+            return expected_content_type in ("audio/mpeg", "audio/mp3")
+        if content.startswith(b"RIFF") and content[8:12] == b"WAVE":
+            return expected_content_type in ("audio/wav", "audio/x-wav")
+        if content.startswith(b"fLaC"):
+            return expected_content_type == "audio/flac"
+        if content.startswith(b"OggS"):
+            return expected_content_type == "audio/ogg"
+        # AAC / M4A（也是 ftyp 格式）
+        if content[4:8] == b"ftyp":
+            brand = content[8:12]
+            if brand in (b"M4A ", b"m4a ", b"mp42", b"isom", b"M4P "):
+                return expected_content_type in (
+                    "audio/mp4",
+                    "audio/aac",
+                    "audio/m4a",
+                )
+        return False
+
+    return False
+
+
+def check_upload_file(content: bytes, max_size: int, content_type: str, type_label: str) -> None:
+    """统一校验文件大小和魔数，失败时直接抛 HTTPException。"""
+    if len(content) > max_size:
+        max_mb = max_size // 1024 // 1024
+        raise HTTPException(
+            status_code=413,
+            detail=f"{type_label}文件大小不能超过 {max_mb}MB",
+        )
+    if not validate_file_magic(content, content_type):
+        raise HTTPException(
+            status_code=400,
+            detail=f"{type_label}文件内容与实际格式不符，可能存在安全风险",
+        )
@@ -87,6 +87,23 @@ platforms:
          qps: 5
          burst: 10

+  # ── 火山引擎媒体处理（MediaKit）──
+  volcengine_mediakit:
+    name: "火山引擎媒体处理"
+    provider: "volcengine_mediakit"
+    base_url: "https://mediakit.cn-beijing.volces.com"
+    rate_limit:
+      qps: 5
+      burst: 10
+    models: []
+    methods:
+      remove_background:
+        timeout: 120
+        max_connections: 10
+        rate_limit:
+          qps: 5
+          burst: 10
+
 # ── 任务默认模型映射 ──
 # 当调用方未指定模型时，按任务类型选择默认模型
 task_defaults:
@@ -24,10 +24,13 @@ fixed_costs:
  voice_clone: 200

  # 字幕烧录：将生成的字幕文件烧录到视频中（FFmpeg 合成）
-  subtitle_burn: 2
+  subtitle_burn: 5

  # 封面设计：根据视频内容自动生成封面图
-  cover_design: 2
+  cover_design: 5
+
+  # 封面形象：上传人物照片 AI 抠图生成透明背景形象
+  cover_avatar: 10

  # 压制成片：将多个素材片段合并为最终视频（FFmpeg 拼接）
  compose: 5
@@ -52,11 +55,11 @@ duration_based_costs:
      # 计算依据：中文正常朗读语速约 200~250 字/分钟，取 240 字/分钟：
      #   60秒 ÷ 240字 = 0.25 秒/字
      # 注意：此为经验值，未经过 Vidu TTS 实测校准。实际时长受标点停顿、
-      #       数字/英文混合、TTS 角色风格等因素影响，误差约 ±20%。
+      # 数字/英文混合、TTS 角色风格等因素影响，误差约 ±20%。
      # TODO: 收集实测数据后校准此值。
      seconds_per_char: 0.25

-  # ── 视频生成（对口型）──
+  # ── 视频生成 ──
  # 计费公式：max(min_points, ceil(实际视频秒数) × multiplier)
  # 说明：秒数先向上取整为整数，再乘以 multiplier。不足 1 秒按 1 秒计算。
  # 示例：4.5秒视频 → ceil(4.5) × 1 = 5 积分；0.8秒 → ceil(0.8) × 1 = 1 积分
@@ -66,8 +69,7 @@ duration_based_costs:

    # 预估参数（执行业务前检查余额时使用）
    estimation:
-      # 是否直接使用输入素材秒数作为预估上限。
-      # 视频生成时长 = 输入音频/素材时长，因此用 input_seconds 预估最准确。
+      # 视频生成时长 = 输入音频时长，因此用 input_seconds 预估最准确。
      # 调用方需传入 input_seconds 参数。
      use_input_seconds: true

@@ -77,10 +79,10 @@ duration_based_costs:
 # 支持积分赠送：points 为实际到账积分数，amount_rmb 为支付金额（分）。
 # label 为空时不显示标签角标。
 recharge_options:
-  - { price: 10000,  points: 2000,   label: "",      validity_days: 180 }
+  - { price: 10000,  points: 2000,   label: "",      validity_days: 90 }
  - { price: 50000,  points: 11000,  label: "热销",  validity_days: 180 }
-  - { price: 100000, points: 23000,  label: "推荐",  validity_days: 365 }
-  - { price: 500000, points: 125000, label: "超值",  validity_days: 0 }
+  - { price: 100000, points: 22500,  label: "推荐",  validity_days: 180 }
+  - { price: 500000, points: 120000, label: "超值",  validity_days: 365 }


 # ── 免费业务（不扣积分）───────────────────────────────
@@ -15,6 +15,7 @@ echo "========================================"
 PROJECT_DIR="/opt/meijiaka-zy"
 GIT_REPO="http://git2.haodian.cn/xiaoyu/meijiaka-zy.git"
 API_PORT=8081
+COMPOSE_FILE="docker-compose.test.yml"

 # 1. 检查 Docker
 echo "[1/7] 检查 Docker 环境..."
@@ -34,7 +35,8 @@ docker compose version || echo "docker-compose 版本: $(docker-compose --versio
 echo "[2/7] 更新代码..."
 if [ -d "$PROJECT_DIR/.git" ]; then
    cd "$PROJECT_DIR"
-    git pull origin master
+    git fetch origin master
+    git reset --hard origin/master
 else
    git clone "$GIT_REPO" "$PROJECT_DIR"
    cd "$PROJECT_DIR"
@@ -83,12 +85,12 @@ echo "✅ 环境变量检查通过"

 # 5. 构建镜像
 echo "[5/7] 构建 Docker 镜像..."
-docker compose -f docker-compose.test.yml build --no-cache
+docker compose -f "$COMPOSE_FILE" build --pull

 # 6. 启动服务
 echo "[6/7] 启动服务..."
-docker compose -f docker-compose.test.yml down 2>/dev/null || true
-docker compose -f docker-compose.test.yml up -d
+docker compose -f "$COMPOSE_FILE" down 2>/dev/null || true
+docker compose -f "$COMPOSE_FILE" up -d

 # 7. 等待并验证
 echo "[7/7] 等待服务启动..."
@@ -98,6 +100,10 @@ MAX_RETRY=12
 RETRY=0
 while [ $RETRY -lt $MAX_RETRY ]; do
    if curl -s http://localhost:$API_PORT/health | grep -q "healthy"; then
+        # 验证 scheduler 容器也在运行
+        if ! docker ps --filter "name=meijiaka-zy-scheduler" --filter "status=running" -q | grep -q .; then
+            echo "⚠️  API 已就绪，但 scheduler 容器未运行，请检查日志"
+        fi
        echo ""
        echo "========================================"
        echo "  ✅ 测试服部署成功！"
@@ -114,8 +120,8 @@ while [ $RETRY -lt $MAX_RETRY ]; do
        echo ""
        echo "  常用命令:"
        echo "    cd $PROJECT_DIR/python-api"
-        echo "    docker compose -f docker-compose.test.yml logs -f"
-        echo "    docker compose -f docker-compose.test.yml restart api"
+        echo "    docker compose -f $COMPOSE_FILE logs -f"
+        echo "    docker compose -f $COMPOSE_FILE restart api"
        echo "========================================"
        exit 0
    fi
@@ -31,7 +31,7 @@ services:
      - ~/Documents/Meijiaka-zy:/root/Documents/Meijiaka-zy
    ports:
      - "8081:8000"
-    command: uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
+    command: uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload --no-access-log
    networks:
      - meijiaka-network

@@ -34,7 +34,7 @@ services:
    volumes:
      # 仅持久化日志到宿主机，其他数据走对象存储
      - /opt/meijiaka-zy/logs:/root/Documents/Meijiaka-zy/logs
-    command: alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000
+    command: alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000 --no-access-log
    ports:
      - "8000:8000"
    restart: unless-stopped
@@ -68,7 +68,7 @@ services:
      redis:
        condition: service_healthy
    command: >
-      sh -c "alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000"
+      sh -c "alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000 --no-access-log"
    networks:
      - meijiaka-zy
    restart: unless-stopped
@@ -1,6 +1,6 @@
 [project]
 name = "meijiaka-ai-api"
-version = "1.5.18"
+version = "1.8.1"
 description = "美家卡智影 - AI 视频创作后端 API"
 authors = [{ name = "Meijiaka Team" }]
 readme = "README.md"
@@ -61,6 +61,9 @@ dependencies = [

    # 音频时长探测（TTS 扣费用）
    "mutagen~=1.47.0",
+
+    # 图像处理（智能抠图合成封面）
+    "Pillow>=11.0.0",
 ]

 [project.optional-dependencies]
@@ -0,0 +1,136 @@
+#!/usr/bin/env python3
+"""
+导入 Mixkit BGM 音频文件到数据库并上传七牛云
+扫描 mixkit_bgm/ 目录下的分类文件夹，读取音频元数据并插入 mjk_bgm_musics 表
+同时上传音频到七牛云视频/音频 bucket，保存 URL。
+"""
+
+import asyncio
+import os
+import sys
+from pathlib import Path
+
+# 将项目根目录加入 Python 路径
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root))
+
+# 加载环境变量
+from dotenv import load_dotenv
+
+load_dotenv()
+
+from mutagen.mp3 import MP3
+from sqlalchemy import select
+from app.db.session import AsyncSessionLocal
+from app.models.bgm_music import BgmMusic
+from app.services.qiniu_service import get_qiniu_service
+
+BGM_BASE_DIR = Path("/Users/0fun/work/meijiaka-zy/mixkit_bgm")
+
+
+def parse_title(filename: str) -> str:
+    """从文件名解析标题，如 '105_See_Line_Funk.mp3' -> 'See Line Funk'"""
+    # 去掉扩展名
+    name = filename.rsplit(".", 1)[0]
+    # 去掉开头的编号前缀（如 105_）
+    parts = name.split("_", 1)
+    if len(parts) > 1 and parts[0].isdigit():
+        title_part = parts[1]
+    else:
+        title_part = name
+    # 将下划线替换为空格
+    return title_part.replace("_", " ")
+
+
+def get_duration(filepath: Path) -> float | None:
+    """获取音频文件时长（秒）"""
+    try:
+        audio = MP3(str(filepath))
+        return audio.info.length
+    except Exception as e:
+        print(f"  无法读取时长: {filepath.name} ({e})")
+        return None
+
+
+async def import_bgm():
+    """扫描目录并导入数据库，同时上传七牛云"""
+    if not BGM_BASE_DIR.exists():
+        print(f"错误: BGM 目录不存在: {BGM_BASE_DIR}")
+        return
+
+    categories = [d.name for d in BGM_BASE_DIR.iterdir() if d.is_dir()]
+    print(f"发现分类: {categories}")
+
+    # 初始化七牛云服务
+    try:
+        qiniu = get_qiniu_service()
+        print("七牛云服务初始化成功")
+    except ValueError as e:
+        print(f"七牛云配置错误: {e}")
+        return
+
+    async with AsyncSessionLocal() as session:
+        # 清空现有数据（可选）
+        result = await session.execute(select(BgmMusic))
+        existing = result.scalars().all()
+        if existing:
+            print(f"数据库中已有 {len(existing)} 条 BGM 记录，将删除后重新导入")
+            for row in existing:
+                await session.delete(row)
+            await session.commit()
+
+        total = 0
+        upload_ok = 0
+        upload_fail = 0
+        for category in sorted(categories):
+            cat_dir = BGM_BASE_DIR / category
+            files = sorted([f for f in cat_dir.iterdir() if f.suffix.lower() in (".mp3", ".wav", ".m4a")])
+            print(f"\n分类 [{category}]: {len(files)} 首")
+
+            for idx, filepath in enumerate(files):
+                title = parse_title(filepath.name)
+                relative_path = f"{category}/{filepath.name}"
+                duration = get_duration(filepath)
+
+                # 上传七牛云
+                qiniu_key = f"meijiaka-zy/bgm/{relative_path}"
+                url = None
+                try:
+                    upload_result = qiniu.upload_file(
+                        local_path=str(filepath),
+                        key=qiniu_key,
+                        file_type="audio",
+                        check_duplicate=True,
+                    )
+                    url = upload_result.get("url")
+                    if upload_result.get("isDuplicate"):
+                        print(f"  + {title} (复用已有文件)")
+                    else:
+                        print(f"  + {title} (上传成功)")
+                    upload_ok += 1
+                except Exception as e:
+                    print(f"  ! {title} (上传失败: {e})")
+                    upload_fail += 1
+                    # 上传失败也继续入库，只是 url 为空
+
+                bgm = BgmMusic(
+                    title=title,
+                    artist=None,
+                    category=category,
+                    file_path=relative_path,
+                    url=url,
+                    duration=duration,
+                    status="active",
+                    sort_order=idx,
+                )
+                session.add(bgm)
+                total += 1
+
+        await session.commit()
+        print(f"\n导入完成，共 {total} 首")
+        print(f"  上传成功: {upload_ok} 首")
+        print(f"  上传失败: {upload_fail} 首")
+
+
+if __name__ == "__main__":
+    asyncio.run(import_bgm())
--- a/Show More
+++ b/Show More
@@ -1 +1 @@
 .5.18
 .8.1