bump version to 1.6.7

- BGM 本地上传改用 Tauri open 对话框，修复 path 为空导致混音失效
- Rust 端放宽 BGM 路径验证（系统文件选择器选取的文件），加路径遍历防护
- BGM 混音失败时 toast 提示，不再静默忽略
- 我的作品页增加导出功能
- 封面形象卡片样式统一为 works-card 体系
- 关闭 uvicorn access log（Dockerfile + 3 个 compose）
- ESLint 全绿：关掉 prop-types/incompatible-library，修复 curly/exhaustive-deps/any/unused-vars
- .gitignore 排除 *.exe 构建产物

.cursor/rules/config-architecture.mdc

@@ -0,0 +1,43 @@
+# 配置架构规则
+
+description: 配置管理架构规范
+
+## 规则
+
+### 配置读取
+- 所有配置必须通过 `from app.config import get_settings` 读取
+- 禁止直接使用 `os.getenv()` 或 `os.environ.get()`
+- 禁止在服务层、API 层直接使用环境变量
+
+### 添加新配置
+1. 在 `app/config.py` 的 `Settings` 类中定义字段
+2. 使用 `Field(default=..., description="...")` 提供默认值和说明
+3. 敏感信息使用 `str | None = None` 类型
+4. 更新 `.env.example` 文档
+
+### 在服务中使用配置
+```python
+from app.config import get_settings
+
+def some_function():
+    settings = get_settings()
+    api_key = settings.SOME_API_KEY
+```
+
+### 禁止的写法
+```python
+import os
+
+# ❌ 禁止
+api_key = os.getenv("SOME_API_KEY")
+api_key = os.environ.get("SOME_API_KEY")
+```
+
+### 推荐的写法
+```python
+from app.config import get_settings
+
+# ✅ 正确
+settings = get_settings()
+api_key = settings.SOME_API_KEY
+```

.github/workflows/release.yml

@@ -0,0 +1,210 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: '版本号 (例如 1.5.16)'
+        required: true
+        type: string
+      platform:
+        description: '构建平台'
+        required: true
+        type: choice
+        options:
+          - 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
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        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 ${{ 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
+          # by combining aarch64 and x86_64 binaries with lipo
+          if [ -f tauri-app/src-tauri/binaries/ffmpeg-aarch64-apple-darwin ] && [ -f tauri-app/src-tauri/binaries/ffmpeg-x86_64-apple-darwin ]; then
+            lipo -create \
+              tauri-app/src-tauri/binaries/ffmpeg-aarch64-apple-darwin \
+              tauri-app/src-tauri/binaries/ffmpeg-x86_64-apple-darwin \
+              -output tauri-app/src-tauri/binaries/ffmpeg-universal-apple-darwin
+            lipo -create \
+              tauri-app/src-tauri/binaries/ffprobe-aarch64-apple-darwin \
+              tauri-app/src-tauri/binaries/ffprobe-x86_64-apple-darwin \
+              -output tauri-app/src-tauri/binaries/ffprobe-universal-apple-darwin
+          fi
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+      - name: Install dependencies
+        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: 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 }}
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          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.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
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        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 ${{ 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 }}
+
+      - name: Install dependencies
+        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: 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 }}
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          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
+

.gitignore

@@ -1,24 +1,35 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-lerna-debug.log*
-
-node_modules
-dist
-dist-ssr
-*.local
-
-# Editor directories and files
-.vscode/*
-!.vscode/extensions.json
-.idea
+# macOS
 .DS_Store
-*.suo
-*.ntvs*
-*.njsproj
-*.sln
-*.sw?
+
+# Node
+node_modules/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+
+# IDE
+.vscode/
+.idea/
+.cursor/
+.claude/
+
+# Logs
+*.log
+
+# Environment
+.env
+.env.local
+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

.gitlab-ci.yml

@@ -0,0 +1,129 @@
+# 美家卡智影 - GitLab CI/CD 配置
+# =======================================
+# 覆盖范围: 前端多平台构建 (macOS Universal + Windows x64)
+#
+# Runner 环境要求:
+#   - macOS runner (标签: macos, arm64):
+#       Apple Silicon Mac, 已安装:
+#         - Xcode Command Line Tools (15+)
+#         - Node.js 22+ (建议通过 nvm 管理)
+#         - Rust 1.94+ (通过 rustup)
+#         - GitLab Runner (shell executor)
+#   - Windows runner (标签: windows, x86_64):
+#       Windows 10/11 x64, 已安装:
+#         - Visual Studio 2022 Build Tools (含 C++ 桌面开发工具链)
+#         - Node.js 22+ (建议通过 nvm-windows 管理)
+#         - Rust 1.94+ (通过 rustup)
+#         - GitLab Runner (shell executor)
+#
+# 触发条件: master 分支推送 或 tag 推送
+# 产物保留: 30 天
+
+variables:
+  ARTIFACT_EXPIRE_DAYS: "30"
+
+stages:
+  - build-frontend
+
+# ==========================================
+# 通用模板: 前端构建
+# ==========================================
+.frontend_build:
+  stage: build-frontend
+  only:
+    - master
+    - tags
+  cache:
+    # Node 依赖缓存（基于 package-lock.json 变更）
+    - key:
+        files:
+          - tauri-app/package-lock.json
+      paths:
+        - tauri-app/node_modules/
+    # Rust 编译缓存（基于 Cargo.lock 变更）
+    - key:
+        files:
+          - tauri-app/src-tauri/Cargo.lock
+      paths:
+        - tauri-app/src-tauri/target/
+
+# ==========================================
+# Job: macOS Universal 构建 (ARM64 + Intel)
+# ==========================================
+# 说明:
+#   - 在 Apple Silicon Mac 上同时编译 ARM64 和 x86_64 两个架构
+#   - 使用 lipo 合并为 universal Mach-O 可执行文件
+#   - 产物为单一 .dmg，同时支持 M 系列和 Intel Mac
+build-frontend-macos:
+  extends: .frontend_build
+  tags:
+    - macos
+    - arm64
+  before_script:
+    # 激活 Rust 环境 (rustup 默认安装路径)
+    - source "$HOME/.cargo/env" 2>/dev/null || true
+    # 安装 Intel 目标平台（构建 universal binary 必需）
+    - rustup target add x86_64-apple-darwin
+    # 验证构建环境
+    - node --version
+    - npm --version
+    - cargo --version
+    - rustc --print host
+  script:
+    - cd tauri-app
+    - npm ci
+    # 构建 universal macOS 应用
+    # Tauri 会自动分别编译 aarch64 和 x86_64，再合并为 universal binary
+    - npm run tauri -- build --target universal-apple-darwin
+  artifacts:
+    name: "meijiaka-macos-${CI_COMMIT_REF_NAME}-${CI_COMMIT_SHORT_SHA}"
+    paths:
+      # DMG 安装包 (推荐用户下载)
+      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
+      # 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:
+    max: 1
+    when: runner_system_failure
+
+# ==========================================
+# Job: Windows x64 构建
+# ==========================================
+# 说明:
+#   - 产物包含 NSIS (.exe) 和 MSI 两种安装包格式
+#   - NSIS 已配置为简体中文安装界面
+#   - sidecar (ffmpeg/ffprobe) 会自动嵌入 .exe 同目录
+build-frontend-windows:
+  extends: .frontend_build
+  tags:
+    - windows
+    - x86_64
+  before_script:
+    # 验证构建环境
+    - rustc --version
+    - cargo --version
+    - node --version
+    - npm --version
+  script:
+    - cd tauri-app
+    - npm ci
+    # 构建 Windows x64 应用
+    - npm run tauri -- build --target x86_64-pc-windows-msvc
+  artifacts:
+    name: "meijiaka-windows-${CI_COMMIT_REF_NAME}-${CI_COMMIT_SHORT_SHA}"
+    paths:
+      # 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"
+  timeout: 45 minutes
+  retry:
+    max: 1
+    when: runner_system_failure

.python-version

@@ -0,0 +1 @@
+3.13

.vscode/extensions.json

@@ -1,3 +0,0 @@
-{
-  "recommendations": ["tauri-apps.tauri-vscode", "rust-lang.rust-analyzer"]
-}

AGENTS.md

@@ -0,0 +1,416 @@
+# AGENTS.md — 美家卡智影
+
+> 本文档面向 AI Coding Agent。项目主要使用中文进行注释和界面文案，文档亦以中文撰写。
+
+---
+
+## 项目概述
+
+**美家卡智影**是一款面向桌面端的 AI 视频创作应用，采用"Python 后端 API + Tauri 桌面前端"的混合架构。
+
+- **产品标识**: `cn.meijiaka.ai-video` / `cn.meijiaka.ai-zy`
+- **版本**: `1.6.7`
+- **核心功能**: AI 脚本生成、AI 配音合成（TTS）、声音复刻、视频生成（Vidu）、视频字幕生成、压制成片（FFmpeg）、项目本地持久化
+
+### 技术栈总览
+
+| 层级 | 技术 |
+|------|------|
+| 后端框架 | FastAPI (Python 3.13, 异步) |
+| 数据库 | PostgreSQL 15+ + SQLAlchemy 2.0 (asyncpg) |
+| 缓存/队列 | Redis 7.x |
+| 异步调度 | 自研 Async Engine（Slot Scheduler） |
+| 桌面壳 | Tauri v2 (Rust) |
+| 前端框架 | React 19 + TypeScript |
+| 前端构建 | Vite 7 |
+| 状态管理 | Zustand 5 + Immer 11 |
+| 路由 | `react-router-dom` |
+| 数据请求 | 自研智能路由客户端 + SWR |
+| 测试（后端） | pytest + pytest-asyncio |
+| 测试（前端） | Vitest 4 + jsdom + `@testing-library/react` |
+| 部署 | Docker + Docker Compose + Nginx |
+
+---
+
+## 仓库结构
+
+本仓库为 Monorepo，包含两个主要子项目：
+
+```
+.
+├── python-api/          # Python 后端 API
+├── tauri-app/           # Tauri 桌面前端
+├── docs/                # 项目文档（架构设计、API 对接指南等）
+├── scripts/             # 辅助脚本
+├── .gitlab-ci.yml       # GitLab CI/CD 配置
+└── AGENTS.md            # 本文档
+```
+
+### python-api/ 目录结构
+
+```
+python-api/
+├── app/                    # 主应用代码
+│   ├── api/v1/            # API 路由（按领域拆分：auth, script, voice, vidu, caption, tasks, upload, materials, system）
+│   ├── core/              # 核心工具（配置加载、安全、异常、Redis 客户端、健康检查）
+│   ├── db/                # 数据库配置与会话管理
+│   ├── models/            # SQLAlchemy ORM 模型（BaseModel 提供 UUID 主键 + 时间戳）
+│   ├── schemas/           # Pydantic Schema（请求/响应校验）
+│   ├── services/          # 业务逻辑层
+│   ├── scheduler/         # Async Engine 异步任务调度（Slot Manager + Task Registry + Handlers）
+│   ├── ai/                # AI 模型封装（providers: volcengine, vidu, generic_llm）
+│   ├── crud/              # 数据库 CRUD 封装
+│   ├── config.py          # Pydantic Settings 配置管理
+│   └── main.py            # FastAPI 应用入口（含 lifespan 管理）
+├── config/                # 运行时配置文件（platform-config.yaml, materials.json）
+├── alembic/               # 数据库迁移脚本
+├── nginx/                 # Nginx 反向代理配置（含 acme.sh SSL 证书脚本）
+├── Dockerfile             # 多阶段构建镜像（builder + production）
+├── docker-compose.prod.yml # 生产环境编排
+├── docker-compose.test.yml # 测试环境编排
+├── pyproject.toml         # Python 依赖与工具配置（black, ruff, mypy, pytest, bandit）
+├── requirements.lock      # 锁定依赖（uv pip compile 生成）
+├── uv.lock               # uv 锁定文件
+├── Makefile              # 常用开发命令
+└── .pre-commit-config.yaml # Git 钩子配置
+```
+
+### tauri-app/ 目录结构
+
+```
+tauri-app/
+├── src/                    # React 前端源码
+│   ├── api/               # API 客户端与模块
+│   │   ├── client.ts      # 智能路由客户端（HTTP / IPC 自动选择，camelCase ↔ snake_case 自动转换）
+│   │   ├── generated/     # OpenAPI 生成的 TypeScript 类型
+│   │   └── modules/       # 按领域拆分的 API 模块
+│   ├── components/        # 可复用组件（PascalCase 文件夹）
+│   ├── pages/             # 页面级组件（PascalCase 文件夹）
+│   ├── store/             # Zustand 状态管理（含 __tests__）
+│   ├── hooks/             # 自定义 React Hooks
+│   ├── utils/             # 工具函数
+│   ├── styles/            # CSS 变量与全局样式
+│   └── __tests__/setup.ts # Vitest 全局 setup（mock localStorage / Tauri API）
+├── src-tauri/             # Rust 后端源码
+│   ├── src/
+│   │   ├── main.rs        # 程序入口
+│   │   ├── lib.rs         # Tauri Builder、Command 定义、公共类型
+│   │   ├── ffmpeg_cmd.rs  # FFmpeg 命令封装
+│   │   ├── video_processing.rs # 压制成片业务逻辑
+│   │   ├── api_proxy.rs   # Python API 代理
+│   │   ├── auth.rs        # 认证命令
+│   │   ├── avatar_cache.rs # 头像缓存
+│   │   ├── storage/       # 本地存储引擎（项目、认证、配置、头像等）
+│   │   ├── commands/      # Tauri IPC 命令（按领域拆分）
+│   │   └── utils.rs       # 通用工具
+│   ├── Cargo.toml         # Rust 依赖
+│   ├── tauri.conf.json    # Tauri 应用配置（窗口、CSP、打包、sidecar）
+│   └── binaries/          # FFmpeg / ffprobe sidecar 二进制
+├── package.json           # Node 依赖与脚本
+├── vite.config.ts         # Vite 配置（端口 1420）
+├── vitest.config.ts       # 测试配置
+├── tsconfig.json          # TypeScript 主配置（strict: true）
+├── eslint.config.js       # ESLint 配置
+├── .prettierrc            # Prettier 配置
+└── .stylelintrc.json      # Stylelint 配置
+```
+
+---
+
+## 运行时架构
+
+采用**混合通信架构**：
+
+1. **纯数据 API**（脚本、TTS、字幕、视频生成、任务查询等）→ 前端通过 HTTP **直连 Python 后端**。
+   - 脚本/TTS/字幕/视频生成统一走异步任务调度（`POST /tasks/{task_type}` + 轮询 `/tasks/{task_id}`），由 Scheduler 独立进程消费。
+2. **需要本地系统能力**（FFmpeg 压制成片、文件系统读写、项目本地持久化、认证状态存储）→ 走 **Tauri IPC → Rust 层** 处理。
+
+> 新增纯数据 API 时，**无需修改 Rust 代码**，直接在 `tauri-app/src/api/modules/` 下使用 `client.post/get` 调用即可。只有涉及本地系统能力的 API 才需要在 Rust 层新增 `#[tauri::command]`。
+
+### 服务拓扑（生产/测试环境）
+
+```
+┌─────────────┐     HTTP      ┌─────────────────┐
+│   Tauri     │ ────────────▶ │  Nginx (SSL)    │
+│   桌面端     │               │  反向代理        │
+└─────────────┘               └────────┬────────┘
+       │                               │
+       │ IPC (Rust)                    │
+       ▼                               ▼
+┌─────────────┐              ┌─────────────────┐
+│ FFmpeg      │              │  FastAPI (8000) │
+│ Sidecar     │              │  - API 路由      │
+│ 本地文件系统 │              │  - 业务逻辑      │
+└─────────────┘              └────────┬────────┘
+                                      │
+                        ┌─────────────┼─────────────┐
+                        ▼             ▼             ▼
+                   ┌────────┐   ┌─────────┐   ┌──────────┐
+                   │PostgreSQL│   │ Redis   │   │ AI 服务商 │
+                   └────────┘   └─────────┘   └──────────┘
+                                      │
+                                      ▼
+                              ┌───────────────┐
+                              │ Async Engine  │
+                              │ Scheduler     │
+                              └───────────────┘
+```
+
+---
+
+## 构建与开发命令
+
+### 后端（python-api/）
+
+```bash
+cd python-api
+
+# 安装开发依赖（使用 uv）
+make dev
+
+# 启动开发服务器
+make run              # uvicorn --reload --port 8000
+
+# 启动异步调度器（另开终端）
+make scheduler        # python -m app.scheduler.main
+
+# 代码质量
+make lint             # ruff check + mypy
+make format           # black + ruff --fix
+make format-check     # 检查格式（不修改）
+make lint-semantic    # 语义层禁词检查（防止供应商术语泄漏）
+
+# 测试
+make test             # pytest -v
+make test-cov         # pytest + 覆盖率报告
+
+# 安全扫描
+make security         # bandit + pip-audit
+
+# CI 全量检查
+make ci               # format-check + lint + lint-semantic + test + security
+
+# Docker 操作
+make docker-run       # 启动 api + scheduler（共享外部 db/redis）
+make docker-rebuild   # 强制重建
+make docker-stop      # 停止（保留 db/redis）
+make docker-logs      # 查看日志
+
+# 数据库迁移
+alembic revision --autogenerate -m "描述"
+alembic upgrade head
+```
+
+### 前端（tauri-app/）
+
+```bash
+cd tauri-app
+
+# 前端开发服务器（Vite，端口 1420）
+npm run dev
+
+# 生产构建（tsc + vite build）
+npm run build
+
+# Tauri 开发（启动 Rust + 前端）
+npm run tauri dev
+
+# Tauri 生产打包
+npm run tauri build
+
+# 测试
+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 format:check  # Prettier --check
+npm run stylelint     # Stylelint
+npm run stylelint:fix # Stylelint --fix
+
+# OpenAPI 类型生成
+npm run gen:api       # 根据 openapi.json 生成 TypeScript 类型
+```
+
+---
+
+## 代码风格与约定
+
+### 命名规范
+
+| 类型 | 规范 | 示例 |
+|------|------|------|
+| 组件/页面文件夹 | PascalCase | `VideoCreation/`, `ErrorBoundary/` |
+| Store/Hooks/API 文件 | camelCase | `authStore.ts`, `useProjectData.ts` |
+| 类型/接口 | PascalCase | `ApiResponse<T>` |
+| Python 模块/函数 | snake_case | `script_handler.py`, `get_settings()` |
+| Python 类 | PascalCase | `AsyncEngine`, `BaseModel` |
+| 常量 | UPPER_SNAKE_CASE | `PYTHON_API_BASE_URL` |
+
+### 注释语言
+
+- 项目内**统一使用中文注释**。
+- 关键架构决策需在代码中以多行注释说明（参考 `python-api/app/scheduler/engine.py` 和 `tauri-app/src/api/client.ts` 顶部注释）。
+
+### Python 代码质量
+
+- **格式化**: black (line-length: 100)
+- **检查**: ruff (select: E, F, I, N, W, UP, B, C4, SIM)
+- **类型检查**: mypy（对 `app.schemas.*`, `app.crud.*`, `app.scheduler.handlers.*` 启用严格模式）
+- **安全扫描**: bandit + pip-audit
+- **依赖管理**: uv（`requirements.lock` 必须与实际依赖同步，pre-commit 会检查）
+
+### TypeScript 配置
+
+- `strict: true` 已开启。
+- `noUnusedLocals: true`、`noUnusedParameters: true` 已开启。
+- `jsx: "react-jsx"`，无需手动引入 `React`。
+- 路径别名 `@/` 映射到 `./src`。
+
+### 状态管理约定（前端）
+
+- 使用 **Zustand + Immer** 进行不可变更新。
+- `projectStore` 使用自定义 `persist` 存储，将项目数据通过 Tauri IPC 持久化到本地文件系统（`app_config_dir/current_project.json`），而不是 localStorage。
+- 其他 Store（如 `authStore`、`settingsStore`）使用 `localStorage` 做持久化。
+
+### API 开发流程
+
+1. **判断是否需要本地能力**（FFmpeg、文件系统、系统调用）。
+2. **不需要** → 直接在 `tauri-app/src/api/modules/` 使用 `client.get/post/put/delete` 调用 Python HTTP API。
+3. **需要** → 将 endpoint 加入 `tauri-app/src/api/client.ts` 的 IPC 处理逻辑，并在 `tauri-app/src-tauri/src/commands/` 或 `lib.rs` 中实现对应的 `#[tauri::command]` 处理器。
+
+### 语义层防护网（后端）
+
+Makefile 中 `lint-semantic` 目标会检查以下规则：
+- API 层禁止使用 `element_id` 作为字段/参数名（应使用 `provider_element_id`）。
+- Scheduler 层统一使用 `task` 命名（`TaskRegistry`、`task_id`、`task:` Redis key 前缀），禁止混用 `job`。
+
+---
+
+## 测试说明
+
+### 后端测试
+
+- **框架**: pytest + pytest-asyncio（asyncio_mode: auto）
+- **覆盖率**: pytest-cov
+- **当前状态**: 后端尚无正式的 `tests/` 目录，测试用例待补充。
+
+### 前端测试
+
+- **框架**: Vitest（globals: true，environment: `jsdom`）
+- **组件测试**: `@testing-library/react` + `@testing-library/jest-dom`
+- **文件位置**:
+  - 全局 setup: `src/__tests__/setup.ts`
+  - Store 测试: `src/store/__tests__/*.test.tsx`
+  - 组件/页面测试: 建议放在被测文件同目录或 `__tests__` 子目录中
+- **Mock 策略**: `setup.ts` 中已全局 mock `localStorage`、`@tauri-apps/api/core` 的 `invoke` 方法、`window.__TAURI_INTERNALS__`。每个测试后自动调用 `vi.clearAllMocks()`。
+
+---
+
+## 安全与部署
+
+### 后端安全
+
+- **JWT 认证**: `SECRET_KEY` 生产环境必须设置为强随机字符串（至少 32 位），否则应用启动时会抛出 `ValueError`。
+- **CORS**: 生产环境若包含 `localhost` 会触发 `RuntimeWarning`。
+- **依赖安全**: `aiohttp>=3.13.4` 和 `orjson>=3.11.0` 为强制最低版本（修复 CVE）。
+- **输入验证**: 所有 API 入参通过 Pydantic Schema 校验。
+- **数据库**: 使用参数化查询（SQLAlchemy ORM），无直接 SQL 拼接。
+
+### 前端安全
+
+- **CSP**: `tauri.conf.json` 中已配置 Content Security Policy。
+- **Asset Protocol**: 已启用，范围限定在 `$APPLOCALDATA/**`、`$APPDATA/**`、`$APPCONFIG/**`。
+
+### 部署流程
+
+#### 测试环境（GitLab CI）
+
+`.gitlab-ci.yml` 定义了 `deploy-backend` 任务：
+1. 在部署服务器拉取代码（`master` 分支触发）。
+2. 构建 api + scheduler 镜像（`docker-compose.test.yml`）。
+3. 启动服务，健康检查 `curl http://localhost:8081/health`。
+4. 清理 7 天前的旧镜像。
+
+#### 生产环境
+
+1. 从环境变量或密钥管理注入配置。
+2. `docker compose -f docker-compose.prod.yml up -d --build`
+3. 外部提供 PostgreSQL 和 Redis（云数据库或自建集群）。
+4. Nginx 反向代理 + acme.sh SSL 证书。
+
+### 外部二进制与 Sidecar
+
+- **FFmpeg / ffprobe** 作为 **sidecar** 打包到 Tauri 应用（`bundle.externalBin`）。
+- Rust 层通过 `tauri_plugin_shell` 的 `sidecar("ffmpeg")` 调用。
+- 合成过程中解析 FFmpeg stderr 中的 `time=` 字段，通过 Tauri Event 向前端发送进度。
+
+---
+
+## 环境变量（后端）
+
+关键配置项见 `python-api/.env.example`：
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `DATABASE_URL` | PostgreSQL 连接字符串 | `postgresql+asyncpg://postgres:postgres@localhost:5432/meijiaka_zy` |
+| `REDIS_HOST` / `REDIS_PORT` / `REDIS_DB` | Redis 连接信息 | `localhost:6379:0` |
+| `SECRET_KEY` | JWT 签名密钥 | 必须修改 |
+| `CORS_ORIGINS` | 允许的跨域来源 | `http://localhost:1420,...` |
+| `VOLCENGINE_API_KEY` | 火山方舟 API Key | - |
+| `VIDU_API_KEY` | Vidu API Key | - |
+| `QINIU_ACCESS_KEY` / `QINIU_SECRET_KEY` | 七牛云存储密钥 | - |
+| `APP_BASE_URL` | 应用公网地址（第三方回调用） | 按 ENV 自动推断 |
+
+### 配置变更策略
+
+> Python 的模块导入机制决定了**运行时热替换配置是反模式**，FastAPI/Pydantic 官方不推荐。测试与生产环境统一遵循以下策略：
+
+| 场景 | 做法 | 说明 |
+|------|------|------|
+| 数值/业务规则配置 | **代码常量** | 如 SMS 验证码位数、过期时间等，不走 `.env`，防止运维随意修改 |
+| 环境配置（密钥、URL 等） | **`.env` 文件** | 变更后统一走 Docker 滚动重启，**所有环境均不支持热重载** |
+| 更新方式 | **`docker compose up -d --build`** | 测试/生产完全一致：`docker-compose.test.yml` 与 `docker-compose.prod.yml` 保持相同的重启策略 |
+
+**注意**：`reload_settings()` 仅作为代码级工具保留（内部调试直接 import 调用），HTTP 接口已删除，测试与生产环境统一走 Docker 滚动重启更新配置。
+
+---
+
+## 数据库与迁移
+
+- **ORM**: SQLAlchemy 2.0（异步，asyncpg 驱动）
+- **迁移工具**: Alembic
+- **基础模型**: `app.models.base.BaseModel` 提供 UUID 主键、`created_at`、`updated_at`
+- **当前模型**: `User`（用户/设备认证）
+- **迁移注意**: Alembic 使用同步连接（psycopg2），会自动将 `+asyncpg` 替换掉。
+
+---
+
+## 异步任务调度（Async Engine）
+
+后端采用自研的**统一异步任务调度引擎**，核心概念：
+
+- **TaskRegistry**: 基于 Redis 的任务注册表，维护 running / pending / finished 状态。
+- **SlotManager**: 基于 Redis 的并发槽位管理，按 task_type 限制最大并发数，统一使用 `acquire_ctx` 上下文管理器。
+- **AsyncHandler**: 各领域的异步任务处理器（`script`/`tts`/`subtitle`/`video`）。
+- **Engine Tick**: 定时轮询所有 running 任务，批量查询状态、批量更新。
+
+调度器需单独启动：`make scheduler` 或 `python -m app.scheduler.main`。
+
+---
+
+## 给 Agent 的快速检查清单
+
+在修改代码前，建议确认以下事项：
+
+1. **新增 API 是否需要 Rust 层？** 不需要则只改前端 `src/api/modules/` 和后端 `app/api/v1/`。
+2. **修改 Store 后是否影响持久化？** `projectStore` 的 `partialize` 字段决定哪些状态会被保存到本地文件。
+3. **新增组件是否遵循 PascalCase 文件夹约定？**
+4. **后端代码是否触发语义层禁词？** 运行 `make lint-semantic`。
+5. **依赖变更后是否更新了 lock 文件？** 运行 `uv pip compile pyproject.toml -o requirements.lock`。
+6. **测试是否通过？** 前端运行 `npm run test`，后端运行 `make test`。
+7. **Tauri 配置变更后是否需要重新 `tauri dev`？** 是的，`tauri.conf.json` 或 `Cargo.toml` 变更后需重启 Tauri 进程。
+8. **修改 pyproject.toml 后 pre-commit 是否通过？** `requirements.lock` 必须与 pyproject.toml 同步。

VERSION

@@ -0,0 +1 @@
+1.6.7

docs/dmg-background-design-spec.md

@@ -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`
+- 整体简洁、专业、无多余装饰

docs/frontend-compatibility-audit-v2.md

@@ -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` 扩展

docs/frontend-compatibility-audit.md

@@ -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` 或开发文档中明确列出浏览器模式的功能限制，避免开发者困惑。

docs/github-actions-release.md

@@ -0,0 +1,153 @@
+# GitHub Actions 发版方案（免费双平台构建）
+
+> 利用 GitHub Actions 免费的 macOS + Windows runner，实现零成本的双平台自动构建。
+
+---
+
+## 一、方案优势
+
+| 对比项 | GitLab CI（原有） | GitHub Actions（新方案） |
+|--------|------------------|------------------------|
+| macOS runner | 需要自维护 Mac 物理机 | ✅ GitHub 免费提供（`macos-latest`） |
+| Windows runner | 需要自维护 Windows 物理机 | ✅ GitHub 免费提供（`windows-latest`） |
+| 并发构建 | 依赖 runner 在线状态 | ✅ 随时触发，并行执行 |
+| 产物保留 | 30 天（可配置） | 90 天（默认） |
+| 成本 | 维护 runner 硬件/电费 | ✅ 公有仓库完全免费 |
+
+---
+
+## 二、前置准备
+
+### 2.1 确认代码已推送到 GitHub
+
+GitHub Actions 只能构建 **GitHub 仓库**中的代码。如果你的代码只在 GitLab，需要：
+
+```bash
+# 在 GitHub 创建空仓库，然后添加远程地址
+git remote add github https://github.com/你的用户名/美家卡智影.git
+git push github master
+git push github --tags
+```
+
+### 2.2 配置 GitHub Secrets（只需做一次）
+
+进入 GitHub 仓库 → **Settings → Secrets and variables → Actions → New repository secret**
+
+| Secret 名称 | 值 | 说明 |
+|------------|-----|------|
+| `TAURI_SIGNING_PRIVATE_KEY` | `dW50cnVzdGVk...`（私钥完整内容） | Tauri updater 签名私钥 |
+| `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` | （留空，不创建） | 若私钥有密码则填，当前无密码 |
+
+> 私钥从 `tauri-app/.tauri-signing-key` 文件中复制全部内容。
+
+---
+
+## 三、触发构建的两种方式
+
+### 方式一：推送 Git tag（推荐，用于正式发版）
+
+```bash
+# 1. 更新版本号
+python scripts/bump-version.py 1.5.16
+
+# 2. 提交并推送
+git add -A
+git commit -m "release: v1.5.16"
+git push github master
+
+# 3. 推送 tag 自动触发 GitHub Actions
+git tag v1.5.16
+git push github v1.5.16
+```
+
+推送 tag 后，GitHub Actions 自动开始构建：
+- `build-macos`：在 `macos-latest` runner 上构建 Universal `.dmg`
+- `build-windows`：在 `windows-latest` runner 上构建 `.exe` + `.msi`
+
+### 方式二：手动触发（用于测试或紧急打包）
+
+进入 GitHub 仓库 → **Actions → Release → Run workflow**
+- 输入版本号（如 `1.5.16`）
+- 点击 **Run workflow**
+
+---
+
+## 四、获取构建产物
+
+构建完成后（约 10-20 分钟）：
+
+1. 进入 GitHub 仓库 → **Actions**
+2. 点击最新的 workflow run
+3. 页面底部 **Artifacts** 区域下载：
+   - `macos-universal` → 包含 `.dmg` 和 `.app`
+   - `windows-x64` → 包含 `.exe` 和 `.msi`
+
+---
+
+## 五、发布更新包（手动执行）
+
+下载产物后，解压到本地目录，执行发版脚本：
+
+```bash
+# 1. 创建产物目录结构
+mkdir -p bundle/macos
+mkdir -p bundle/dmg
+mkdir -p bundle/nsis
+mkdir -p bundle/msi
+
+# 2. 将下载的 artifact 解压并放入对应目录
+# macos-universal.zip → bundle/dmg/xxx.dmg, bundle/macos/xxx.app
+# windows-x64.zip → bundle/nsis/xxx.exe, bundle/msi/xxx.msi
+
+# 3. 执行发版脚本
+cd python-api
+python scripts/publish_release.py \
+  --version 1.5.16 \
+  --notes "修复视频导出崩溃\n优化启动速度" \
+  --bundle-dir ../bundle
+```
+
+---
+
+## 六、注意事项
+
+### 6.1 macOS 签名
+GitHub Actions 的 `macos-latest` runner **没有 Apple Developer 证书**，构建出的 `.app`/`.dmg` 与本地构建一样，是未签名的。用户在首次打开时仍需手动允许。
+
+**后续升级**：购买 Apple Developer Program 后，在 workflow 中添加：
+```yaml
+env:
+  APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
+  APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+  APPLE_ID: ${{ secrets.APPLE_ID }}
+  APPLE_PASSWORD: ${{ secrets.APPLE_PASSWORD }}
+  APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+```
+
+### 6.2 Windows 签名
+同理，未配置 `WINDOWS_CERTIFICATE` 时，`.exe` 会有 SmartScreen 提示。购买证书后配置 GitHub Secrets 即可自动签名。
+
+### 6.3 产物自动上传到 Release（可选进阶）
+
+如需让 GitHub 自动创建 Release 页面并上传产物，可在 workflow 末尾添加：
+
+```yaml
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            tauri-app/src-tauri/target/**/bundle/dmg/*.dmg
+            tauri-app/src-tauri/target/**/bundle/nsis/*.exe
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+---
+
+## 七、文件清单
+
+| 文件 | 作用 |
+|------|------|
+| `.github/workflows/release.yml` | GitHub Actions 工作流定义 |
+| `tauri-app/.tauri-signing-key` | 私钥源文件（本地保存） |
+| `tauri-app/src-tauri/tauri.key.pub` | 公钥（已提交 Git） |

docs/mixkit_bgm_catalog.md

@@ -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`

docs/point-consumption-plan.md

@@ -0,0 +1,232 @@
+# 积分消耗完善方案
+
+> 基于后端 `point_service.py` 三阶段模型（预扣 → 结算/退款）和前端现状调研。
+
+---
+
+## 一、现状总览
+
+### 后端（已具备）
+| 模块 | 状态 | 说明 |
+|------|------|------|
+| 模型层 | ✅ | `UserPoint` / `PointBatch` / `PointTransaction` / `PointRechargeOrder` 完整 |
+| 充值流程 | ✅ | 微信支付 Native 扫码 + 回调 + 补单 |
+| 预扣/结算/退款 | ✅ | `freeze_for_consumption` / `settle_consumption` / `refund_consumption` 已实现 |
+| 过期回收 | ⚠️ | `expire_batches()` 已实现，但**未接入定时任务** |
+| 定价常量 | ✅ | `POINTS_COST` 已定义（script=5, polish=1, title=1, voice_clone=200, tts/video 按秒计费） |
+
+### 前端（已具备）
+| 模块 | 状态 | 说明 |
+|------|------|------|
+| 余额展示 | ✅ | Profile 页显示可用积分 |
+| 充值弹窗 | ✅ | 6 档位微信支付，轮询状态 |
+| 流水查询 | ✅ | UsageDetail 页展示最近 50 条 |
+| 全局积分 Store | ❌ | 无 Zustand Store，各页面独立 `useState` |
+
+---
+
+## 二、核心问题清单
+
+### P0 — 阻塞业务使用
+
+**1. AI 服务 API 未集成积分消耗**
+- `script.py`（脚本生成）、`voice.py`（配音）、`vidu.py`（数字人）、`caption.py`（字幕）等**没有任何积分调用**
+- 用户可无限免费使用 AI 服务，积分系统形同虚设
+
+**2. 前端创作前无余额预检**
+- 脚本生成、压制成片等操作点击即触发，不检查余额
+- 后端返回 402 后前端没有统一拦截和充值引导
+
+### P1 — 影响体验和数据准确性
+
+**3. 结算逻辑多预扣边界问题**
+- `settle_consumption()` 查询批次条件是 `frozen > 0`，**没有按 `source_id` 关联**
+- 若用户同时有两个活跃预扣（如同时生成脚本+配音），结算时会互相影响
+
+**4. 积分预估**
+- `tts` 和 `video` 的积分依赖 `seconds` 参数，前端自行计算预估值
+- ~~`/points/cost` 预估接口已删除~~，各业务前端根据 `points-config.yaml` 规则独立计算
+
+**5. 过期回收未自动化**
+- `expire_batches()` 已完整实现，但没有任何定时任务/调度器调用
+- 180 天过期积分不会自动回收
+
+### P2 — 优化项
+
+**6. 前端无全局积分状态**
+- 余额存在 `Profile.tsx` 的局部 `useState`，Sidebar、创作页都无法实时感知
+- 充值成功后只有 Profile 页刷新，其他页面看不到最新余额
+
+**7. `/admin/recharge` 缺少管理员权限检查**
+- 任何人都可以调用管理员充值接口
+
+---
+
+## 三、完善方案
+
+### 3.1 后端 — 统一后置扣费（P0）
+
+**设计原则**：桌面端单用户操作，无并发超扣风险。所有业务统一走「预估上限检查 → 执行业务 → 出结果 → 直接扣费」。
+
+**为什么放弃预扣模式**：
+- 桌面端按钮有 loading 状态，天然防重复点击
+- 单用户单设备，不存在同时发起多个相同请求的场景
+- 预扣/结算/退款三阶段增加复杂度，却无实际收益
+
+**扣费策略：允许欠费，但执行前余额不得低于预估上限**
+
+```python
+async def generate_tts(request, db, current_user):
+    # 1. 计算预估上限（调用前就知道）
+    estimated_points = estimate_tts_cost(request.text)  # 按字数预估
+    
+    # 2. 检查余额是否 >= 预估上限
+    user_point = await get_user_point_for_update(db, current_user.id)
+    if user_point.balance < estimated_points:
+        raise HTTPException(status_code=402, detail=f"余额不足，预估需 {estimated_points} 积分")
+    
+    # 3. 执行业务（余额够预估上限就放行）
+    result = await _do_tts(...)
+    
+    # 4. 出结果后计算实际积分
+    actual_points = math.ceil(result.duration / 5)
+    
+    # 5. 直接扣费（允许欠费：actual_points 可能 > estimated_points）
+    await point_service.consume(
+        db, user_id=current_user.id,
+        points=actual_points, source_type="tts",
+        source_id=result.task_id,
+        description=f"TTS 配音 {result.duration} 秒"
+    )
+    
+    return result
+```
+
+**预估上限规则**：
+
+| 业务 | source_type | 计费规则 | 预估上限 | 说明 |
+|------|-------------|----------|----------|------|
+| 脚本生成 | `script` | `5` | `5` | 固定值，预估 = 实际 |
+| 润色 | `polish` | `1` | `1` | 固定值，预估 = 实际 |
+| 标题生成 | `title` | `1` | `1` | 固定值，预估 = 实际 |
+| 声音复刻 | `voice_clone` | `200` | `200` | 固定值，预估 = 实际 |
+| TTS 配音 | `tts` | `ceil(seconds / 5)` | `ceil(字数 × 0.3 / 5)` | 按字数保守预估 |
+| 视频生成 | `video` | `seconds * 5` | `输入素材秒数 * 5` 或 `300` | 无素材时用默认值 60 秒 |
+| 字幕生成 | `caption` | `ceil(seconds / 5)` | `输入视频秒数` | 输入视频时长已知 |
+| 压制成片 | `compose` | `seconds * 5` | `分镜总秒数 * 5` | 分镜 duration 前端已知 |
+
+**关键规则**：
+- 余额 >= 预估上限：放行执行业务，出结果后按实际扣费（可能欠费）
+- 余额 < 预估上限：直接返回 402，不执行业务
+- 固定积分业务：预估上限 = 实际积分，不欠费
+- 按秒计费业务：预估上限是保守估计，实际可能超出，差额形成欠费
+- **欠费用户不可继续使用**：下次发起任何业务前检查余额，若 `balance < 0`，直接返回 402 提示充值
+
+---
+
+### 3.2 后端 — 简化积分服务（P1）
+
+**现状**：`point_service.py` 中有 `freeze_for_consumption`、`settle_consumption`、`refund_consumption`、`expire_batches` 等多个方法。
+
+**简化**：统一后置扣费后，只需要保留：
+
+```python
+# 核心方法
+async def consume(db, user_id, points, source_type, source_id, description)
+async def recharge(db, user_id, points, source, description)  # 充值
+async def expire_batches(db)  # 定时过期回收
+```
+
+- `consume()`：直接扣减 `balance`，按 FIFO 扣减批次 `remaining`
+- 删除 `freeze` / `settle` / `refund` 三阶段相关方法
+- 删除 `UserPoint.frozen` 字段（不再需要冻结概念）
+- 删除 `PointBatch.frozen` 字段
+
+---
+
+### 3.3 后端 — 积分预估查询 API（P1）
+
+新增接口：
+
+```
+GET /points/cost?source_type=tts&seconds=12
+→ { "source_type": "tts", "param": {"seconds": 12}, "points": 3 }
+```
+
+前端在点击「生成」前调用，拿到所需积分后做余额校验。
+
+---
+
+### 3.4 后端 — 过期回收接入调度（P1）
+
+**方案**：在 Async Engine Scheduler 中增加一个定时 Job，每天执行一次 `expire_batches()`。
+
+或更简单：在 `app/scheduler/handlers/` 下新增 `point_handler.py`，注册为每日定时任务。
+
+---
+
+### 3.5 后端 — 管理员充值加权限（P2）
+
+在 `/admin/recharge` 增加管理员权限检查：
+- 方案 1：基于 JWT role 字段判断（需在 User 模型增加 `role`）
+- 方案 2：基于 IP 白名单（配置 `ADMIN_IPS`）
+
+---
+
+### 3.6 前端 — 全局积分 Store + 余额不足拦截（P0/P2）
+
+**新增 `pointStore.ts`**：
+
+```typescript
+interface PointState {
+  balance: PointBalance | null;
+  isLoading: boolean;
+  fetchBalance: () => Promise<void>;
+}
+```
+
+- 应用启动时自动拉取余额
+- 充值成功后自动刷新
+- Sidebar 显示当前可用积分
+
+**余额不足拦截**：
+
+后置扣费模式下，前端**不需要**在调用前预检余额（因为不知道实际要扣多少）。统一由后端拦截：
+
+```typescript
+// client.ts 全局错误拦截
+if (error.code === 402) {
+  toast.error(error.message); // "余额不足，本次需扣除 xxx 积分"
+  usePointStore.getState().setShowRechargeModal(true);
+}
+```
+
+**充值弹窗全局化**：
+- 把 `RechargeModal` 提升到 App.tsx 级别，通过全局状态控制开关
+- 任何页面余额不足时都可以一键唤起
+
+---
+
+## 四、实施优先级
+
+| 优先级 | 事项 | 涉及文件 | 预估工时 |
+|--------|------|----------|----------|
+| P0 | 简化 `point_service`（删除冻结相关方法） | `services/point_service.py` | 1h |
+| P0 | AI 服务统一集成后置扣费 | `api/v1/script.py`, `voice.py`, `vidu.py` 等 | 2h |
+| P0 | 前端全局积分 Store + 402 拦截 | `store/pointStore.ts` + `App.tsx` + `client.ts` | 2h |
+| P1 | 数据库迁移（删除 frozen 字段） | `models/user_point.py`, `models/point_batch.py` + alembic | 1h |
+| P1 | 过期回收接入调度 | `scheduler/handlers/point_handler.py` | 1h |
+| P2 | 侧边栏余额展示 | `Sidebar.tsx` | 0.5h |
+| P2 | 管理员充值加权限 | `api/v1/points.py` + `models/user.py` | 1h |
+
+**建议执行顺序**：P0 后端（简化服务 + 统一扣费） → P0 前端 → P1 数据库迁移 → P1 调度 → P2 优化
+
+---
+
+## 五、需要确认的问题
+
+1. **脚本生成固定 5 积分？** 不按场景数？
+2. **声音复刻 200 积分？**
+3. **视频/配音秒数从哪取？** Rust 层合成完成后 FFmpeg 可以取时长，是否已有现成方法？
+4. **是否需要免费额度/体验积分？** 新用户注册是否赠送一定积分？
+5. **用户 model 是否有 role 字段？** 用于管理员充值权限检查。

docs/qiniu-kodo-python-sdk-guide.md

@@ -0,0 +1,739 @@
+# 七牛云对象存储 (Kodo) Python SDK 开发规范
+
+## 概述
+
+本文档规范美家卡智影项目中使用七牛云对象存储 (Kodo) Python SDK 的开发标准，涵盖文件上传、下载、管理和 CDN 操作等核心功能。
+
+**SDK 版本**: v5.0.0+  
+**Python 版本**: 3.8+ (兼容 2.7 和 3.3+)  
+**官方文档**: https://developer.qiniu.com/kodo/1242/python
+
+---
+
+## 1. 安装与初始化
+
+### 1.1 安装 SDK
+
+```bash
+pip install qiniu
+```
+
+### 1.2 初始化配置
+
+```python
+from qiniu import Auth
+
+# 从环境变量读取密钥（推荐）
+import os
+access_key = os.getenv('QINIU_ACCESS_KEY')
+secret_key = os.getenv('QINIU_SECRET_KEY')
+
+# 构建鉴权对象
+q = Auth(access_key, secret_key)
+```
+
+**环境变量配置** (`.env` 文件):
+```bash
+QINIU_ACCESS_KEY=your-access-key
+QINIU_SECRET_KEY=your-secret-key
+QINIU_BUCKET_NAME=your-bucket-name
+QINIU_BUCKET_DOMAIN=your-domain.com
+```
+
+---
+
+## 2. 文件上传
+
+### 2.1 上传方式选择
+
+| 场景 | 推荐方式 | 说明 |
+|------|----------|------|
+| 小文件 (< 100MB) | 表单上传 (put_file) | 简单快速，一次请求完成 |
+| 大文件 (> 100MB) | 分片上传 v2 (put_file_v2) | 支持断点续传，适应弱网环境 |
+| 网络不稳定 | 分片上传 v2 | 自动重试，更可靠 |
+
+### 2.2 服务端生成上传 Token
+
+```python
+from qiniu import Auth
+
+def generate_upload_token(
+    bucket_name: str,
+    key: str = None,
+    expires: int = 3600,
+    policy: dict = None
+) -> str:
+    """
+    生成上传凭证
+    
+    Args:
+        bucket_name: 存储空间名称
+        key: 指定文件名（可选）
+        expires: Token 有效期（秒），默认 3600
+        policy: 上传策略配置（可选）
+    
+    Returns:
+        上传 Token 字符串
+    """
+    q = Auth(access_key, secret_key)
+    
+    # 自定义上传策略（可选）
+    if policy is None:
+        policy = {}
+    
+    token = q.upload_token(bucket_name, key, expires, policy)
+    return token
+```
+
+### 2.3 客户端直传（推荐）
+
+**服务端生成 Token，客户端直传到七牛云**:
+
+```python
+# 服务端 API
+from fastapi import APIRouter
+from pydantic import BaseModel
+
+router = APIRouter(prefix="/qiniu", tags=["Qiniu"])
+
+class UploadTokenRequest(BaseModel):
+    key: str           # 文件名
+    expires: int = 3600  # Token 有效期
+
+class UploadTokenResponse(BaseModel):
+    token: str
+    key: str
+    upload_url: str = "https://upload.qiniup.com"
+
+@router.post("/upload-token", response_model=UploadTokenResponse)
+async def get_upload_token(request: UploadTokenRequest):
+    """获取上传凭证，客户端直传"""
+    token = generate_upload_token(
+        bucket_name=os.getenv('QINIU_BUCKET_NAME'),
+        key=request.key,
+        expires=request.expires
+    )
+    return UploadTokenResponse(token=token, key=request.key)
+```
+
+### 2.4 服务端上传文件（保留场景）
+
+```python
+from qiniu import Auth, put_file_v2, etag
+import qiniu.config
+
+def upload_file(
+    local_file_path: str,
+    key: str,
+    bucket_name: str = None
+) -> dict:
+    """
+    服务端上传文件到七牛云
+    
+    Args:
+        local_file_path: 本地文件路径
+        key: 存储的文件名（如 "audios/voice.mp3"）
+        bucket_name: 存储空间名称
+    
+    Returns:
+        {"key": str, "hash": str, "url": str}
+    """
+    bucket_name = bucket_name or os.getenv('QINIU_BUCKET_NAME')
+    
+    # 生成上传 Token
+    token = q.upload_token(bucket_name, key, 3600)
+    
+    # 使用分片上传 v2（推荐）
+    ret, info = put_file_v2(
+        up_token=token,
+        key=key,
+        file_path=local_file_path,
+        version='v2'  # 指定分片上传 v2 版本
+    )
+    
+    if ret is None:
+        raise Exception(f"上传失败: {info}")
+    
+    # 验证文件完整性
+    assert ret['key'] == key
+    assert ret['hash'] == etag(local_file_path)
+    
+    # 构建访问 URL
+    domain = os.getenv('QINIU_BUCKET_DOMAIN')
+    url = f"https://{domain}/{key}"
+    
+    return {
+        "key": ret['key'],
+        "hash": ret['hash'],
+        "url": url
+    }
+```
+
+### 2.5 上传策略 (PutPolicy)
+
+常用策略配置：
+
+```python
+# 1. 限制文件大小 (10MB ~ 100MB)
+policy = {
+    "fsizeMin": 1024 * 1024 * 10,       # 最小 10MB
+    "fsizeLimit": 1024 * 1024 * 100,    # 最大 100MB
+    "mimeLimit": "audio/*;video/*"       # 限制文件类型
+}
+
+# 2. 上传后回调业务服务器
+policy = {
+    "callbackUrl": "https://your-api.com/callback",
+    "callbackBody": "key=$(key)&hash=$(etag)&fname=$(fname)&fsize=$(fsize)",
+    "callbackBodyType": "application/x-www-form-urlencoded"
+}
+
+# 3. 上传后转码（持久化处理）
+import base64
+fops = 'avthumb/mp4/s/640x360/vb/1.25m'
+saveas_key = base64.urlsafe_b64encode(f'{bucket_name}:output.mp4'.encode()).decode()
+
+policy = {
+    "persistentOps": f"{fops}|saveas/{saveas_key}",
+    "persistentPipeline": "transcoding",  # 队列名称
+    "persistentNotifyUrl": "https://your-api.com/pfop/callback"
+}
+```
+
+---
+
+## 3. 文件下载
+
+### 3.1 公有空间下载
+
+公有空间文件可直接访问：
+
+```python
+def get_public_url(key: str, domain: str = None) -> str:
+    """获取公有空间文件 URL"""
+    domain = domain or os.getenv('QINIU_BUCKET_DOMAIN')
+    return f"https://{domain}/{key}"
+```
+
+### 3.2 私有空间下载（临时 URL）
+
+```python
+import requests
+
+def get_private_url(key: str, expires: int = 3600) -> str:
+    """
+    生成私有空间文件的临时下载 URL
+    
+    Args:
+        key: 文件 Key
+        expires: 链接有效期（秒）
+    
+    Returns:
+        带签名的临时 URL
+    """
+    domain = os.getenv('QINIU_BUCKET_DOMAIN')
+    base_url = f"https://{domain}/{key}"
+    
+    # 生成私有下载链接
+    private_url = q.private_download_url(base_url, expires=expires)
+    return private_url
+
+# 使用示例
+def download_file(key: str, local_path: str):
+    """下载私有空间文件到本地"""
+    private_url = get_private_url(key, expires=3600)
+    
+    response = requests.get(private_url)
+    if response.status_code == 200:
+        with open(local_path, 'wb') as f:
+            f.write(response.content)
+        return True
+    return False
+```
+
+---
+
+## 4. 文件管理 (BucketManager)
+
+### 4.1 初始化管理器
+
+```python
+from qiniu import Auth, BucketManager
+
+q = Auth(access_key, secret_key)
+bucket = BucketManager(q)
+```
+
+### 4.2 获取文件信息
+
+```python
+def get_file_info(bucket_name: str, key: str) -> dict:
+    """
+    获取文件元信息
+    
+    Returns:
+        {
+            "fsize": 文件大小(字节),
+            "hash": 文件哈希,
+            "mimeType": MIME类型,
+            "putTime": 上传时间(100纳秒时间戳),
+            "type": 存储类型(0=标准,1=低频,2=归档,3=深度归档)
+        }
+    """
+    ret, info = bucket.stat(bucket_name, key)
+    if ret is None:
+        raise Exception(f"获取文件信息失败: {info}")
+    return ret
+```
+
+### 4.3 列举文件列表
+
+```python
+from typing import List, Optional
+
+def list_files(
+    bucket_name: str,
+    prefix: str = None,      # 前缀筛选
+    limit: int = 100,        # 每页数量
+    marker: str = None       # 分页标记
+) -> dict:
+    """
+    列举空间文件列表
+    
+    Returns:
+        {
+            "items": [{"key": ..., "fsize": ..., ...}],
+            "marker": "分页标记",
+            "commonPrefixes": ["公共前缀列表"]
+        }
+    """
+    ret, eof, info = bucket.list(
+        bucket_name,
+        prefix=prefix,
+        marker=marker,
+        limit=limit,
+        delimiter=None  # 不指定分隔符
+    )
+    
+    return {
+        "items": ret.get('items', []),
+        "marker": ret.get('marker'),
+        "eof": eof  # 是否已列举完
+    }
+
+# 遍历所有文件
+def list_all_files(bucket_name: str, prefix: str = None) -> List[dict]:
+    """遍历获取所有文件"""
+    files = []
+    marker = None
+    
+    while True:
+        result = list_files(bucket_name, prefix, limit=1000, marker=marker)
+        files.extend(result['items'])
+        
+        if result['eof'] or not result['marker']:
+            break
+        marker = result['marker']
+    
+    return files
+```
+
+### 4.4 删除文件
+
+```python
+def delete_file(bucket_name: str, key: str) -> bool:
+    """删除单个文件"""
+    ret, info = bucket.delete(bucket_name, key)
+    return ret == {}
+
+def delete_files_batch(bucket_name: str, keys: List[str]) -> dict:
+    """批量删除文件"""
+    from qiniu import build_batch_delete
+    
+    ops = build_batch_delete(bucket_name, keys)
+    ret, info = bucket.batch(ops)
+    return ret
+```
+
+### 4.5 复制和移动文件
+
+```python
+def copy_file(
+    src_bucket: str,
+    src_key: str,
+    dest_bucket: str,
+    dest_key: str,
+    force: bool = True
+) -> bool:
+    """复制文件"""
+    ret, info = bucket.copy(
+        src_bucket, src_key,
+        dest_bucket, dest_key,
+        force=force  # 强制覆盖
+    )
+    return ret is not None
+
+def move_file(
+    src_bucket: str,
+    src_key: str,
+    dest_bucket: str,
+    dest_key: str,
+    force: bool = True
+) -> bool:
+    """移动/重命名文件"""
+    ret, info = bucket.move(
+        src_bucket, src_key,
+        dest_bucket, dest_key,
+        force=force
+    )
+    return ret is not None
+```
+
+### 4.6 修改文件元信息
+
+```python
+def change_mime(bucket_name: str, key: str, mime_type: str):
+    """修改文件 MIME 类型"""
+    ret, info = bucket.change_mime(bucket_name, key, mime_type)
+    return ret is not None
+
+def change_type(bucket_name: str, key: str, file_type: int):
+    """
+    修改文件存储类型
+    
+    file_type:
+        0 = 标准存储
+        1 = 低频存储
+        2 = 归档存储
+        3 = 深度归档存储
+    """
+    ret, info = bucket.change_type(bucket_name, key, file_type)
+    return ret is not None
+```
+
+### 4.7 批量操作
+
+```python
+from qiniu import (
+    build_batch_stat,
+    build_batch_copy,
+    build_batch_move,
+    build_batch_rename,
+    build_batch_delete
+)
+
+def batch_stat(bucket_name: str, keys: List[str]) -> List[dict]:
+    """批量查询文件信息"""
+    ops = build_batch_stat(bucket_name, keys)
+    ret, info = bucket.batch(ops)
+    return ret
+
+def batch_rename(
+    bucket_name: str,
+    key_map: dict,  # {"old_key": "new_key", ...}
+    force: bool = True
+):
+    """批量重命名"""
+    ops = build_batch_rename(bucket_name, key_map, force=force)
+    ret, info = bucket.batch(ops)
+    return ret
+
+def batch_copy(
+    src_bucket: str,
+    key_map: dict,  # {"src_key": "dest_key", ...}
+    dest_bucket: str = None,
+    force: bool = True
+):
+    """批量复制"""
+    dest_bucket = dest_bucket or src_bucket
+    ops = build_batch_copy(src_bucket, key_map, dest_bucket, force=force)
+    ret, info = bucket.batch(ops)
+    return ret
+```
+
+### 4.8 抓取网络资源
+
+```python
+def fetch_remote_file(
+    remote_url: str,
+    key: str,
+    bucket_name: str = None
+) -> dict:
+    """
+    抓取远程文件到七牛云
+    
+    Args:
+        remote_url: 远程文件 URL
+        key: 保存的文件名
+        bucket_name: 目标空间
+    
+    Returns:
+        {"key": ..., "hash": ..., "fsize": ...}
+    """
+    bucket_name = bucket_name or os.getenv('QINIU_BUCKET_NAME')
+    ret, info = bucket.fetch(remote_url, bucket_name, key)
+    return ret
+```
+
+---
+
+## 5. CDN 操作
+
+### 5.1 初始化 CDN Manager
+
+```python
+from qiniu import CdnManager
+
+cdn_manager = CdnManager(q)
+```
+
+### 5.2 刷新 CDN 缓存
+
+```python
+def refresh_urls(urls: List[str]) -> dict:
+    """刷新指定 URL 的 CDN 缓存"""
+    ret, info = cdn_manager.refresh_urls(urls)
+    return ret
+
+def refresh_dirs(dirs: List[str]) -> dict:
+    """刷新整个目录的 CDN 缓存"""
+    ret, info = cdn_manager.refresh_dirs(dirs)
+    return ret
+```
+
+### 5.3 预取资源
+
+```python
+def prefetch_urls(urls: List[str]) -> dict:
+    """预取资源到 CDN 节点"""
+    ret, info = cdn_manager.prefetch_urls(urls)
+    return ret
+```
+
+### 5.4 获取 CDN 日志
+
+```python
+def get_cdn_log_list(domains: List[str], log_date: str) -> List[dict]:
+    """
+    获取 CDN 日志下载链接
+    
+    Args:
+        domains: 域名列表
+        log_date: 日期 (YYYY-MM-DD)
+    
+    Returns:
+        [{"name": ..., "url": ..., "size": ..., "mtime": ...}]
+    """
+    ret, info = cdn_manager.get_log_list_data(domains, log_date)
+    return ret.get('data', [])
+```
+
+---
+
+## 6. 项目集成方案
+
+### 6.1 服务端封装模块
+
+```python
+# app/services/qiniu_service.py
+"""
+七牛云对象存储服务封装
+"""
+
+import os
+from typing import List, Optional
+from qiniu import Auth, BucketManager, CdnManager, put_file_v2, etag
+
+class QiniuService:
+    """七牛云服务封装"""
+    
+    def __init__(self):
+        access_key = os.getenv('QINIU_ACCESS_KEY')
+        secret_key = os.getenv('QINIU_SECRET_KEY')
+        self.bucket_name = os.getenv('QINIU_BUCKET_NAME')
+        self.domain = os.getenv('QINIU_BUCKET_DOMAIN')
+        
+        self.auth = Auth(access_key, secret_key)
+        self.bucket = BucketManager(self.auth)
+        self.cdn = CdnManager(self.auth)
+    
+    def get_upload_token(self, key: str, expires: int = 3600, policy: dict = None) -> str:
+        """生成上传 Token"""
+        return self.auth.upload_token(self.bucket_name, key, expires, policy)
+    
+    def get_file_url(self, key: str, private: bool = False, expires: int = 3600) -> str:
+        """获取文件访问 URL"""
+        base_url = f"https://{self.domain}/{key}"
+        if private:
+            return self.auth.private_download_url(base_url, expires)
+        return base_url
+    
+    def upload_file(self, local_path: str, key: str) -> dict:
+        """服务端上传文件"""
+        token = self.get_upload_token(key)
+        ret, info = put_file_v2(token, key, local_path, version='v2')
+        
+        if ret is None:
+            raise Exception(f"上传失败: {info}")
+        
+        return {
+            "key": ret['key'],
+            "hash": ret['hash'],
+            "url": self.get_file_url(key)
+        }
+    
+    def delete_file(self, key: str) -> bool:
+        """删除文件"""
+        ret, info = self.bucket.delete(self.bucket_name, key)
+        return ret == {}
+    
+    def refresh_cdn(self, keys: List[str]) -> dict:
+        """刷新 CDN 缓存"""
+        urls = [self.get_file_url(key) for key in keys]
+        return self.cdn.refresh_urls(urls)
+
+# 全局单例
+_qiniu_service: Optional[QiniuService] = None
+
+def get_qiniu_service() -> QiniuService:
+    global _qiniu_service
+    if _qiniu_service is None:
+        _qiniu_service = QiniuService()
+    return _qiniu_service
+```
+
+### 6.2 FastAPI 路由集成
+
+```python
+# app/api/v1/qiniu.py
+
+from fastapi import APIRouter, UploadFile, File
+from app.services.qiniu_service import get_qiniu_service
+
+router = APIRouter(prefix="/qiniu", tags=["Qiniu"])
+
+@router.post("/upload-token")
+async def get_upload_token(key: str, expires: int = 3600):
+    """获取客户端直传 Token"""
+    service = get_qiniu_service()
+    token = service.get_upload_token(key, expires)
+    return {"token": token, "key": key}
+
+@router.post("/upload")
+async def upload_file(file: UploadFile = File(...), key: str = None):
+    """服务端上传文件（小文件场景）"""
+    import tempfile
+    import shutil
+    
+    service = get_qiniu_service()
+    
+    # 生成唯一文件名
+    if key is None:
+        import uuid
+        ext = file.filename.split('.')[-1] if '.' in file.filename else ''
+        key = f"uploads/{uuid.uuid4()}.{ext}" if ext else f"uploads/{uuid.uuid4()}"
+    
+    # 保存临时文件
+    with tempfile.NamedTemporaryFile(delete=False) as tmp:
+        shutil.copyfileobj(file.file, tmp)
+        tmp_path = tmp.name
+    
+    try:
+        result = service.upload_file(tmp_path, key)
+        return result
+    finally:
+        os.unlink(tmp_path)
+
+@router.delete("/files/{key:path}")
+async def delete_file(key: str):
+    """删除文件"""
+    service = get_qiniu_service()
+    success = service.delete_file(key)
+    return {"success": success}
+```
+
+---
+
+## 7. 最佳实践
+
+### 7.1 文件名规范
+
+```python
+def generate_key(file_type: str, user_id: str, filename: str) -> str:
+    """
+    生成规范的文件存储路径
+    
+    格式: {type}/{user_id}/{date}/{uuid}.{ext}
+    """
+    import uuid
+    from datetime import datetime
+    
+    ext = filename.split('.')[-1] if '.' in filename else 'bin'
+    date = datetime.now().strftime('%Y%m')
+    unique_id = str(uuid.uuid4())[:8]
+    
+    return f"{file_type}/{user_id}/{date}/{unique_id}.{ext}"
+
+# 使用示例
+key = generate_key("voices", "user_123", "my-voice.mp3")
+# 结果: voices/user_123/202501/a1b2c3d4.mp3
+```
+
+### 7.2 错误处理
+
+```python
+from qiniu import AuthError, HTTPError
+
+def handle_qiniu_error(func):
+    """七牛云操作错误处理装饰器"""
+    def wrapper(*args, **kwargs):
+        try:
+            return func(*args, **kwargs)
+        except AuthError as e:
+            raise Exception(f"认证失败: {e}")
+        except HTTPError as e:
+            raise Exception(f"请求失败: {e}")
+        except Exception as e:
+            raise Exception(f"操作失败: {e}")
+    return wrapper
+```
+
+### 7.3 安全配置
+
+1. **密钥管理**: 使用环境变量，禁止硬编码
+2. **Token 有效期**: 上传 Token 建议 1 小时，下载 Token 根据场景设置
+3. **上传策略**: 限制文件大小和 MIME 类型
+4. **私有空间**: 敏感文件使用私有空间 + 临时 URL
+
+---
+
+## 8. 常见问题
+
+### Q1: 上传失败，返回 401 错误？
+
+**A**: 检查 AccessKey 和 SecretKey 是否正确，以及 Token 是否过期。
+
+### Q2: 如何支持大文件上传？
+
+**A**: 使用分片上传 v2 (`put_file_v2`)，SDK 会自动处理分片和断点续传。
+
+### Q3: 文件上传后如何获取访问 URL？
+
+**A**: 公有空间直接拼接 `https://{domain}/{key}`，私有空间使用 `auth.private_download_url()` 生成临时 URL。
+
+### Q4: 如何刷新 CDN 缓存？
+
+**A**: 使用 `CdnManager.refresh_urls()` 或 `refresh_dirs()`，注意目录刷新有每日限额。
+
+### Q5: 上传回调不生效？
+
+**A**: 确保 callbackUrl 是公网可访问的 HTTPS 地址，且返回 Content-Type: application/json。
+
+---
+
+## 9. 参考资料
+
+- [七牛云 Python SDK 官方文档](https://developer.qiniu.com/kodo/1242/python)
+- [上传策略文档](https://developer.qiniu.com/kodo/1206/put-policy)
+- [表单上传 API](https://developer.qiniu.com/kodo/1272/api-overview)
+- [Python SDK GitHub](https://github.com/qiniu/python-sdk)

docs/release-guide.md

@@ -0,0 +1,173 @@
+# 应用发版操作手册
+
+> 本文档描述美家卡智影桌面应用的完整发版流程。
+> 采用 Tauri 官方 updater 插件 + FastAPI 动态更新 JSON + 七牛云存储方案。
+
+---
+
+## 前置条件
+
+### 1. 签名密钥（已生成，只需确认存在）
+
+```bash
+ls ~/.tauri/meijiaka.key ~/.tauri/meijiaka.key.pub
+```
+
+- 私钥 `~/.tauri/meijiaka.key`：构建时用于签名，**不要泄露**
+- 公钥内容：已写入 `tauri-app/src-tauri/tauri.conf.json` 的 `plugins.updater.pubkey`
+
+### 2. 七牛云环境变量（复用素材上传配置）
+
+```bash
+# python-api/.env
+QINIU_ACCESS_KEY=xxx
+QINIU_SECRET_KEY=xxx
+QINIU_VIDEO_BUCKET=media-liche
+QINIU_VIDEO_DOMAIN=media.liche.cn
+```
+
+### 3. 后端已部署
+
+```bash
+# 测试环境
+cd python-api
+docker compose -f docker-compose.test.yml up -d --build
+
+# 验证
+curl https://dev.tapi.meijiaka.cn/api/v1/system/health
+```
+
+> 数据库表会在 Docker 启动时自动创建（`alembic upgrade head` 已内置于容器启动命令），无需手动执行迁移。
+
+---
+
+## 发版流程
+
+### 步骤 1：修改版本号
+
+三个文件版本号必须完全一致：
+
+```bash
+cd tauri-app
+
+# 1. package.json
+npm version 1.6.0 --no-git-tag-version
+
+# 2. Cargo.toml
+# 手动修改：src-tauri/Cargo.toml → version = "1.6.0"
+
+# 3. tauri.conf.json
+# 手动修改：src-tauri/tauri.conf.json → "version": "1.6.0"
+```
+
+### 步骤 2：构建
+
+```bash
+cd tauri-app
+export TAURI_SIGNING_PRIVATE_KEY="$HOME/.tauri/meijiaka.key"
+npm run tauri build
+```
+
+构建产物（含签名文件）位于 `src-tauri/target/release/bundle/`：
+
+| 平台 | 安装包 | 签名文件 |
+|------|--------|----------|
+| macOS | `macos/*.app.tar.gz` | `.app.tar.gz.sig` |
+| Windows | `nsis/*-setup.exe` | `.exe.sig` |
+| Linux | `appimage/*.AppImage` | `.AppImage.sig` |
+
+> **注意**：不同平台的构建产物和签名文件是 Tauri 自动生成的。若只发 macOS 版本，只需上传 macOS 的包即可；Windows/Linux 用户不会收到更新提示。
+
+### 步骤 3：发布
+
+```bash
+cd python-api
+
+python scripts/publish_release.py \
+  --version 1.6.0 \
+  --notes "修复视频导出崩溃\n优化启动速度" \
+  --bundle-dir ../tauri-app/src-tauri/target/release/bundle
+```
+
+脚本执行逻辑：
+
+1. 扫描 `bundle/` 目录，匹配 `.sig` 文件和对应的安装包
+2. 上传安装包到七牛云 `media-liche` bucket 的 `releases/{version}/` 路径
+3. 读取 `.sig` 文件内容（Ed25519 签名）
+4. 调用后端 API `POST /api/v1/update/releases`，将版本信息写入数据库
+
+> 若后端在本地 Docker（端口 8081），加 `--api-url http://localhost:8081`
+
+---
+
+## 验证发版
+
+### API 验证
+
+```bash
+curl "https://dev.tapi.meijiaka.cn/api/v1/update/check?version=1.5.15&target=darwin&arch=aarch64"
+```
+
+正常返回示例：
+
+```json
+{
+  "version": "1.6.0",
+  "notes": "修复视频导出崩溃\n优化启动速度",
+  "pub_date": "2026-05-15T10:00:00+00:00",
+  "mandatory": false,
+  "platforms": {
+    "darwin-aarch64": {
+      "url": "https://media.liche.cn/releases/1.6.0/xxx.app.tar.gz",
+      "signature": "-----BEGIN SIGNATURE-----\nxxx\n-----END SIGNATURE-----"
+    }
+  }
+}
+```
+
+### 客户端验证
+
+1. 启动桌面应用，3 秒后自动检查更新
+2. 若当前版本低于数据库最新版本，弹出更新对话框
+3. 或在**设置 → 系统更新**中手动点击"检查更新"
+
+---
+
+## 回滚操作
+
+若发出去的版本有问题，删除版本记录即可：
+
+```bash
+# 测试/本地环境
+docker exec meijiaka-zy-api psql $DATABASE_URL \
+  -c "DELETE FROM app_releases WHERE version = '1.6.0';"
+
+# 或进入服务器直接执行
+psql $DATABASE_URL -c "DELETE FROM app_releases WHERE version = '1.6.0';"
+```
+
+用户下次检查更新时会自动拿到上一个版本。
+
+---
+
+## 跨平台说明
+
+| 平台 | 安装包格式 | 安装行为 | 是否需要重启 |
+|------|-----------|---------|------------|
+| macOS | `.app.tar.gz` | 解压替换 `.app` bundle | 是 |
+| Windows | `.exe` / `.msi` | 运行安装程序替换 | 是（安装程序强制退出应用）|
+| Linux | `.AppImage` | 替换可执行文件 | 是 |
+
+Tauri updater 插件已内置跨平台安装逻辑，前端代码无需区分平台。
+
+---
+
+## 文件清单
+
+| 文件 | 作用 |
+|------|------|
+| `~/.tauri/meijiaka.key` | 私钥（签名用，勿泄露） |
+| `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` | 数据库模型（`mjk_app_releases` / `mjk_app_release_packages`） |

docs/third-party-integration-architecture.md

@@ -0,0 +1,694 @@
+# 第三方平台接入架构设计方案（最终版）
+
+> 版本：v1.0 Final
+> 适用范围：`python-api/` 所有第三方服务接入层
+> 生效日期：2026-05-02
+
+---
+
+## 一、设计目标
+
+| 目标 | 验收标准 |
+|------|---------|
+| 新增平台接入成本 < 30 分钟 | 提供 Adapter 模板，复制粘贴后填充 4 个方法即可 |
+| 第三方故障不拖垮用户 | 单点故障时，用户 100ms 内收到明确错误，而非超时 30 秒 |
+| 多用户同时使用无冲突 | 5 个用户同时生成 TTS/脚本时，不触发第三方 429 限流 |
+| 任务状态可追踪 | 用户关闭应用后重开，能恢复进行中的视频生成/字幕任务 |
+| 未来换平台无感知 | 换 TTS 供应商时，前端接口、存储层、用户历史记录全部无感知 |
+
+---
+
+## 二、整体架构
+
+```
+┌──────────────────────────────────────────────┐
+│  Router（FastAPI）                            │
+│  - 校验输入、序列化输出                         │
+│  - 统一错误中间件                              │
+│  - 不处理重试、不限流、不直接调第三方            │
+│  - 回调入口：/webhooks/{platform}              │
+├──────────────────────────────────────────────┤
+│  Application Service                          │
+│  - ScriptService：编排脚本→TTS→视频生成          │
+│  - VideoService：编排字幕→合成                 │
+│  - 只操作领域对象，不感知平台差异                │
+├──────────────────────────────────────────────┤
+│  Gateway Layer                                │
+│  ┌─────────────────┐  ┌──────────────────┐   │
+│  │  LLM Gateway    │  │  Task Gateway    │   │
+│  │  - 模型路由      │  │  - 任务状态机     │   │
+│  │  - Fallback     │  │  - 轮询调度       │   │
+│  │  - 流式代理      │  │  - 回调处理       │   │
+│  └────────┬────────┘  └────────┬─────────┘   │
+│           │                    │              │
+│           └────────────────────┘              │
+│                    │                          │
+│           ┌────────▼────────┐                 │
+│           │  Shared Infra   │                 │
+│           │  - Token Bucket │                 │
+│           │  - CircuitBreaker│                │
+│           │  - stamina retry │                │
+│           │  - Structured Log│               │
+│           └────────┬────────┘                 │
+├────────────────────┼─────────────────────────┤
+│  Adapter Layer     │                         │
+│  - VolcengineArkAdapter                      │
+│  - OpenAIAdapter                              │
+│  - ViduAdapter                                │
+│  - VolcengineCaptionAdapter                   │
+│  - MockAdapter                                │
+│  每个 Adapter：Protocol 约定，无状态，可替换   │
+├──────────────────────────────────────────────┤
+│  Transport Layer                              │
+│  - httpx.AsyncClient（所有 Raw HTTP）         │
+│  - 官方 SDK（仅 LLM 层：AsyncArk/AsyncOpenAI）│
+│  - lifespan 显式创建、显式关闭                │
+└────────────────────────────────────────────────┘
+```
+
+---
+
+## 三、分层设计
+
+### 3.1 Adapter 层
+
+**职责**：纯翻译。把内部标准请求 ↔ 供应商特定请求，内部标准响应 ↔ 供应商特定响应。
+
+**不职责**：重试、限流、业务逻辑、状态管理。
+
+**Protocol 约定**：
+
+```python
+class LLMAdapter(Protocol):
+    platform_id: str
+    async def chat(self, messages, model, **params) -> AdapterResponse: ...
+    async def chat_stream(self, messages, model, **params): ...  # AsyncIterator
+    async def health(self) -> AdapterResponse: ...
+    async def close(self) -> None: ...
+
+class TaskAdapter(Protocol):
+    platform_id: str
+    async def submit(self, task_type, payload, callback_url) -> AdapterResponse: ...
+    async def query(self, platform_task_id) -> TaskStatus: ...
+    async def parse_callback(self, body) -> TaskStatus: ...
+    async def verify_signature(self, headers, body, secret) -> bool: ...
+    async def extract_nonce(self, headers) -> str | None: ...
+    async def health(self) -> AdapterResponse: ...
+    async def close(self) -> None: ...
+```
+
+**AdapterResponse 标准格式**：
+
+```python
+@dataclass(frozen=True)
+class AdapterResponse:
+    success: bool
+    data: dict | None = None
+    error_code: str | None = None
+    error_message: str | None = None
+    retryable: bool = False  # Gateway 据此决定是否重试
+```
+
+**TaskStatus 标准格式**：
+
+```python
+@dataclass(frozen=True)
+class TaskStatus:
+    task_id: str           # 供应商 task_id
+    state: str             # "pending" | "processing" | "completed" | "failed"
+    result: dict | None = None
+    error_message: str | None = None
+```
+
+**Client 统一**：
+- 所有 Raw HTTP 用 `httpx.AsyncClient`。
+- LLM 官方 SDK（AsyncArk、AsyncOpenAI）保留，但 lifespan shutdown 时显式 `close()`。
+- 每个 Adapter 独立 Client，独立连接池，互不干扰。
+
+---
+
+### 3.2 Gateway 层
+
+#### 3.2.1 LLM Gateway
+
+```python
+class LLMGateway:
+    def __init__(self, adapters: dict[str, LLMAdapter], runtime_config: GatewayRuntimeConfig):
+        self.adapters = adapters
+        self.config = runtime_config
+
+    async def chat(self, model_id, messages, **params) -> dict:
+        # 1. 路由到 Adapter
+        # 2. 主模型失败时 Fallback
+        # 3. 流式中途失败不再 Fallback
+```
+
+**Fallback 规则**：
+- 配置驱动，`runtime_config.ark_fallback_chain`
+- 流式中途失败 → 立即抛异常，不降级（避免内容混合）
+- 同步调用失败 → 按链降级，对用户透明
+
+#### 3.2.2 Task Gateway
+
+```python
+class TaskGateway:
+    def __init__(self, adapters, storage, runtime_config):
+        self.adapters = adapters
+        self.storage = storage          # Redis
+        self.config = runtime_config
+        self.circuit = CircuitBreaker()
+
+    async def submit(self, platform_id, task_type, payload, callback_url=None) -> str:
+        # 1. 限流检查
+        # 2. 熔断检查
+        # 3. Adapter.submit() → 获取 platform_task_id
+        # 4. 生成 internal_task_id (UUID)
+        # 5. Redis 存储映射
+        # 6. 返回 internal_task_id
+
+    async def query(self, internal_task_id) -> TaskStatus:
+        # 1. 查 Redis 映射
+        # 2. 非终态时穿透供应商查询（可选）
+        # 3. 更新 Redis
+
+    async def handle_webhook(self, platform, headers, body, query):
+        # 1. nonce 防重放检查
+        # 2. Adapter.verify_signature()
+        # 3. Adapter.parse_callback()
+        # 4. 更新任务状态
+```
+
+**内部 ID 隔离**：
+
+```python
+# Redis 存储结构
+task:{internal_task_id} -> {
+    "platform_id": "vidu",
+    "platform_task_id": "vidu_abc123",
+    "task_type": "lip_sync",
+    "state": "processing",
+    "submitted_at": "2026-05-02T12:00:00Z"
+}
+TTL: 3600 秒（1 小时）
+```
+
+**轮询调度器**（火山字幕示例）：
+
+```python
+async def poll_until_complete(self, internal_task_id, max_wait=120):
+    intervals = [0, 1, 2, 4, 8, 8, 10]  # 非阻塞阶段
+
+    for interval in intervals:
+        await asyncio.sleep(interval)
+        status = await self.query(internal_task_id)
+        if status.state == "completed":
+            return status
+        if status.state == "failed":
+            raise TaskError(status.error_message)
+
+    # 切换 blocking 阶段
+    while elapsed < max_wait:
+        status = await self._query_with_blocking(internal_task_id)
+        if status.state in ("completed", "failed"):
+            return status
+
+    raise TaskError("任务超时")
+```
+
+#### 3.2.3 Shared Infra
+
+**Token Bucket**（内存级，`aiolimiter`）：
+
+```python
+vidu_limiter = AsyncLimiter(max_rate=20, time_period=1.0)   # 20/s
+caption_limiter = AsyncLimiter(max_rate=2, time_period=1.0)  # 2/s
+ark_limiter = AsyncLimiter(max_rate=50, time_period=1.0)     # 50/s
+```
+
+**CircuitBreaker**：
+
+```python
+class CircuitBreaker:
+    failure_threshold: int = 5      # 连续失败 5 次熔断
+    recovery_timeout: float = 60.0  # 60 秒后探测恢复
+```
+
+**Retry Policy**（`stamina`）：
+
+```python
+with stamina.retry_context(
+    on=(httpx.NetworkError, httpx.TimeoutException),
+    attempts=3,
+    timeout=30.0,
+    wait_initial=1.0,
+    wait_max=10.0,
+):
+    await adapter.submit(...)
+```
+
+---
+
+### 3.3 Application Service 层
+
+**职责**：编排业务流程，不感知平台差异。
+
+```python
+class ScriptService:
+    async def generate_script(self, category, subcategory, duration):
+        # 调用 LLM Gateway，不关心底层是火山方舟还是 OpenAI
+        result = await llm_gateway.chat(
+            model_id="doubao-seed-2-0-pro",
+            messages=[...],
+            temperature=0.7,
+        )
+        return self._parse_shots(result.data["content"])
+
+class VideoService:
+    async def submit_lip_sync(self, video_url, audio_url):
+        # 调用 Task Gateway，不关心底层是 Vidu 还是 HeyGen
+        task_id = await task_gateway.submit(
+            platform_id="vidu",
+            task_type="lip_sync",
+            payload={"video_url": video_url, "audio_url": audio_url},
+            callback_url=f"{settings.app_base_url}/webhooks/vidu",
+        )
+        return task_id
+```
+
+---
+
+### 3.4 Router 层
+
+**职责**：HTTP 语义转换，参数校验，统一返回格式。
+
+**统一错误中间件**：
+
+```python
+@app.exception_handler(PlatformError)
+async def platform_error_handler(request, exc: PlatformError):
+    status = 502 if exc.retryable else 400
+    return JSONResponse(
+        status_code=status,
+        content={
+            "code": exc.status_code or 500,
+            "message": str(exc),
+            "data": None,
+            "detail": {
+                "platform": exc.platform,
+                "retryable": exc.retryable,
+            } if settings.DEBUG else None,
+        },
+    )
+```
+
+**回调入口**：
+
+```python
+@router.post("/webhooks/{platform}")
+async def universal_webhook(platform: str, request: Request):
+    raw_headers = dict(request.headers)
+    raw_body = await request.body()
+    query_params = dict(request.query_params)
+
+    await task_gateway.handle_webhook(
+        platform=platform,
+        headers=raw_headers,
+        body=raw_body,
+        query=query_params,
+        original_path=request.url.path,
+    )
+    return {"received": True}
+```
+
+---
+
+## 四、核心数据流
+
+### 4.1 TTS 语音合成（同步调用）
+
+```
+用户点击"生成配音"
+    ↓
+POST /voice/synthesize
+    ↓
+Router 校验参数
+    ↓
+ViduService.synthesize(text, voice_id...)
+    ↓
+LLM Gateway.call_sync(platform="vidu", method="tts", ...)
+    ↓
+Token Bucket 取令牌（rate=20/s）
+    ↓
+stamina 重试网络错误（最多3次）
+    ↓
+ViduAdapter.call(method="tts", ...)
+    ↓
+httpx.AsyncClient → Vidu API
+    ↓
+返回音频 URL
+```
+
+**异常路径**：
+- 网络错误 → stamina 重试 → 3 次失败后抛 PlatformError(retryable=True) → 502
+- Vidu 返回 400 → PlatformError(retryable=False) → 400
+- Vidu 返回 500 → PlatformError(retryable=True) → 502
+
+### 4.2 脚本生成 SSE（流式调用）
+
+```
+用户点击"生成脚本"
+    ↓
+POST /script/generate/stream
+    ↓
+ScriptService.generate_script_stream(...)
+    ↓
+LLM Gateway.chat_stream(model_id="doubao-seed-2-0-pro", ...)
+    ↓
+VolcengineArkAdapter.chat_stream(...)
+    ↓
+SSE 流式输出
+```
+
+**关键约束**：流式中途失败**不降级**。已输出内容保持不变，前端收到 error 事件后自行处理。
+
+### 4.3 视频生成任务提交（异步任务）
+
+```
+用户点击"生成视频"
+    ↓
+POST /vidu/lip-sync
+    ↓
+VideoService.submit_lip_sync(...)
+    ↓
+Task Gateway.submit(platform="vidu", task_type="lip_sync", ...)
+    ↓
+Token Bucket 取令牌（rate=5/s）
+    ↓
+CircuitBreaker 检查
+    ↓
+ViduAdapter.submit(method="lip_sync", ...)
+    ↓
+返回 platform_task_id
+    ↓
+生成 internal_task_id (UUID)
+    ↓
+Redis 存储映射
+    ↓
+返回 {task_id: internal_task_id}
+```
+
+### 4.4 字幕打轴（同步阻塞 + 后端内部轮询）
+
+当前前端调用 `POST /caption/ata/align`，后端同步阻塞等待结果（内部轮询最多 120 秒），直接返回打轴结果。
+
+```
+用户点击"生成字幕"
+    ↓
+POST /caption/ata/align
+    ↓
+CaptionService.auto_align_caption(...) 内部轮询
+    ↓
+直接返回 {utterances, duration}
+```
+
+> 注：`/caption/generate`、`/caption/submit` 等异步字幕接口已删除，当前仅保留 `/caption/ata/align` 同步打轴。
+
+### 4.5 回调处理（Vidu 视频生成完成）
+
+```
+Vidu 服务器 POST /webhooks/vidu
+    ↓
+Router 提取 headers / body / query
+    ↓
+Task Gateway.handle_webhook(...)
+    ↓
+1. ViduAdapter.extract_nonce(headers) → nonce
+   → Redis 查 nonce 是否已用
+   → 已用 → 401
+2. ViduAdapter.verify_signature(headers, body, secret)
+   → 失败 → 401
+3. Redis 标记 nonce 已用（TTL 300s）
+4. ViduAdapter.parse_callback(body) → TaskStatus
+5. Redis 更新任务状态
+```
+
+---
+
+## 五、并发控制
+
+### 5.1 三层隔离模型
+
+```
+┌─────────────────────────────────────────┐
+│  第一层：任务层（Slot Scheduler）         │
+│  控制"同时有多少个异步任务在执行"          │
+│  - 火山字幕：max 5                        │
+│  - 视频生成：按 Vidu 配额配置               │
+│  - 脚本生成：max 10                       │
+├─────────────────────────────────────────┤
+│  第二层：请求层（Gateway Token Bucket）  │
+│  控制"每秒向某平台发多少请求"              │
+│  - Vidu TTS：20/s                         │
+│  - Vidu 视频生成提交：5/s                   │
+│  - 火山方舟：50/s                         │
+│  - 火山字幕提交：2/s                      │
+├─────────────────────────────────────────┤
+│  第三层：连接层（HTTP Client Pool）      │
+│  控制"同时保持多少条 TCP 连接"            │
+│  - Vidu：max 20                           │
+│  - 火山字幕：max 10                       │
+│  - 火山方舟：SDK 内部管理                 │
+└─────────────────────────────────────────┘
+```
+
+### 5.2 流式连接单独计数
+
+```python
+# LLM Gateway 内
+active_streams: dict[str, int] = {}  # {platform: count}
+
+# 流式上限
+MAX_STREAMS = {
+    "volcengine_ark": 30,
+    "openai": 30,
+}
+```
+
+---
+
+## 六、错误处理
+
+### 6.1 异常类
+
+```python
+class PlatformError(Exception):
+    """第三方平台调用失败"""
+    def __init__(self, message, *, platform: str, retryable: bool = False, status_code: int | None = None):
+        super().__init__(message)
+        self.platform = platform
+        self.retryable = retryable
+        self.status_code = status_code
+
+class TaskError(Exception):
+    """任务生命周期错误"""
+    pass
+
+class LLMError(Exception):
+    """LLM 调用失败（含 Fallback 耗尽）"""
+    pass
+```
+
+### 6.2 HTTP 状态码映射
+
+| 场景 | PlatformError 属性 | HTTP 状态码 |
+|------|-------------------|------------|
+| 网络超时、DNS 失败、5xx | `retryable=True` | 502 Bad Gateway |
+| 供应商限流 429 | `retryable=True` | 429 Too Many Requests |
+| 认证失败 401/403 | `retryable=False` | 401 Unauthorized |
+| 参数错误 400 | `retryable=False` | 400 Bad Request |
+| 业务逻辑错误（state=failed） | `retryable=False` | 400 Bad Request |
+
+### 6.3 全局响应格式
+
+```json
+{
+    "code": 0,
+    "message": "成功",
+    "data": {}
+}
+```
+
+错误时：
+
+```json
+{
+    "code": 500,
+    "message": "Vidu TTS 服务暂不可用",
+    "data": null,
+    "detail": {
+        "platform": "vidu",
+        "retryable": true
+    }
+}
+```
+
+---
+
+## 七、配置规范
+
+### 7.1 嵌套配置模型
+
+```python
+class ViduConfig(BaseModel):
+    api_key: str = ""
+    base_url: str = "https://api.vidu.com"
+    max_connections: int = 20
+    timeout: float = 30.0
+
+class RuntimeConfig(BaseModel):
+    """运行时配置，支持热重载"""
+    vidu_qps: float = 20.0
+    vidu_burst: int = 30
+    ark_fallback_chain: list[str] = ["doubao-seed-2-0-lite"]
+    caption_poll_intervals: list[float] = [1.0, 1.0, 2.0, 2.0, 4.0, 4.0, 8.0, 8.0, 10.0]
+    circuit_failure_threshold: int = 5
+    circuit_recovery_timeout: float = 60.0
+
+class Settings(BaseSettings):
+    vidu: ViduConfig = Field(default_factory=ViduConfig)
+    volcengine_ark: VolcengineArkConfig = Field(default_factory=VolcengineArkConfig)
+    volcengine_caption: VolcengineCaptionConfig = Field(default_factory=VolcengineCaptionConfig)
+    openai: OpenAIConfig = Field(default_factory=OpenAIConfig)
+    runtime: RuntimeConfig = Field(default_factory=RuntimeConfig)
+
+    model_config = SettingsConfigDict(
+        env_nested_delimiter="__",
+    )
+```
+
+### 7.2 `.env` 示例
+
+```bash
+# === 启动配置（改后需重启）===
+VIDU__API_KEY=sk-xxx
+VIDU__BASE_URL=https://api.vidu.com
+VIDU__MAX_CONNECTIONS=20
+
+VOLCENGINE_ARK__API_KEY=ak-xxx
+VOLCENGINE_CAPTION__APPID=app-xxx
+VOLCENGINE_CAPTION__TOKEN=tk-xxx
+
+OPENAI__API_KEY=sk-xxx
+
+# === 运行时配置（改后可热载）===
+RUNTIME__VIDU__QPS=20
+RUNTIME__VIDU__BURST=30
+RUNTIME__ARK__FALLBACK_CHAIN=doubao-seed-2-0-lite,doubao-lite-32k
+RUNTIME__CAPTION__POLL_INTERVALS=1,1,2,2,4,4,8,8,10
+RUNTIME__CIRCUIT__FAILURE_THRESHOLD=5
+```
+
+### 7.3 热重载 API
+
+```python
+@router.post("/admin/runtime-config")
+async def reload_runtime_config(updates: dict):
+    gateway_registry.update_runtime_config(**updates)
+    return {"updated": list(updates.keys())}
+```
+
+---
+
+## 八、日志与可观测性
+
+### 8.1 结构化日志字段
+
+```python
+{
+    "event": "platform_call",
+    "platform": "vidu",
+    "method": "tts_sync",
+    "task_type": "tts",
+    "duration_ms": 1250,
+    "success": true,
+    "http_status": 200,
+    "retry_count": 0,
+}
+```
+
+### 8.2 脱敏规则
+
+| 级别 | 字段 | 生产环境处理 |
+|------|------|------------|
+| P1 | `api_key`, `authorization`, `x-hmac-signature` | `[REDACTED]` |
+| P2 | `audio_url`, `video_url`, `text` | URL 去签名参数 / 文案截断前 30 字 |
+| P3 | `platform_task_id`, `internal_task_id` | 前缀保留 8 字符 |
+| P4 | `duration_ms`, `http_status`, `retry_count` | 完整保留 |
+
+### 8.3 健康检查端点
+
+```python
+@router.get("/system/platform-health")
+async def platform_health():
+    results = {}
+    for pid, adapter in registry.adapters.items():
+        resp = await adapter.health()
+        results[pid] = {
+            "available": resp.success,
+            "error": resp.error_message,
+        }
+    return results
+```
+
+---
+
+## 九、迁移策略
+
+### 9.1 迁移原则
+
+- **新旧代码并行**：通过 flag 切换，可随时回滚
+- **逐个平台迁移**：Vidu → 火山字幕 → LLM
+- **前端无感知**：Router URL、请求体、响应体不变
+
+### 9.2 Flag 切换机制
+
+```python
+# Router 层
+USE_NEW_VIDU = settings.FEATURE_FLAGS.get("new_vidu_adapter", False)
+
+@router.post("/voice/synthesize")
+async def synthesize(request: TTSSynthesizeRequest):
+    if USE_NEW_VIDU:
+        service = get_vidu_service_v2()  # 新架构
+    else:
+        service = get_vidu_service()       # 旧代码
+    ...
+```
+
+### 9.3 迁移 Checklist
+
+| 步骤 | 动作 | 验证 |
+|------|------|------|
+| 1 | 新建 `ViduAdapterV2`，实现 Protocol | 单元测试通过 |
+| 2 | 注册到 Gateway，flag 关闭 | 不影响线上 |
+| 3 | 测试环境开启 flag，全量回归 | 所有 Vidu 接口正常 |
+| 4 | 生产灰度 10% → 50% → 100% | 监控 error rate |
+| 5 | 旧代码保留 1 周后删除 | 无回滚需求 |
+
+---
+
+## 十、附录：最终决策清单
+
+| # | 决策项 | 结论 |
+|---|--------|------|
+| 1 | 回调验签位置 | **C**：Router 提取纯数据 → Gateway 调度 → Adapter 验签 |
+| 2 | 任务结果保留 | 实时反映，Redis 映射 TTL = 1h |
+| 3 | 七牛云 | 不纳入新架构 |
+| 4 | SSE 断线 | 不支持续传 |
+| 5 | MockAdapter | 仅 `DEBUG=True` 时注册 |
+| 6 | 配置热重载 | **B**：限流参数 + Fallback 链可热载，Adapter 需重启 |
+| 7 | 日志脱敏 | 四级分级（P1/P2/P3/P4）+ 四档环境 + URL 智能剥离 |
+| 8 | 火山字幕轮询 | **B**：前 3 次非阻塞（0→1→3s）+ 后切换 `blocking=1` |
+| 9 | 迁移策略 | **C**：适配器层先行，flag 切换 |
+| 10 | API Key | 手动维护 |
+| 11 | 任务状态持久化 | **C**：Redis 开启 AOF 持久化 |

docs/third-party-integration-implementation-plan.md

@@ -0,0 +1,532 @@
+# 第三方平台接入架构标准化实施计划
+
+> 版本：v1.0
+> 依据：third-party-integration-architecture.md（架构设计最终版）
+> 目标：统一异常体系、Adapter 契约、HTTP Client 生命周期、异步任务状态机、配置分层
+> 生效日期：2026-05-03
+
+---
+
+## 一、总则
+
+### 1.1 实施原则
+
+- **标准优先**：以行业主流做法为准，不因"改动小"而妥协
+- **文档先行**：所有变更必须在此文档中登记，实施完成后逐项核对
+- **标准优先**：存量代码直接按标准改造，不做兼容包装层
+- **渐进验证**：每阶段完成后运行测试，确认无回归再进入下一阶段
+
+### 1.2 不适用本标准的例外
+
+- 七牛云存储（纯上传下载，不纳入 Adapter 体系）
+
+---
+
+## 二、五条铁律规范（实施标准）
+
+### 铁律 1：异常出口唯一
+
+**规范内容**：所有 `app/services/`、`app/ai/` 下的代码，对外抛出的异常必须是 `PlatformError`。Router 只 `except PlatformError` 和 `AppException`（业务错误）。
+
+**具体标准**：
+
+```python
+# app/core/exceptions.py —— 唯一的第三方异常类
+class PlatformErrorType:
+    RATE_LIMIT = "rate_limit"
+    AUTH_FAILED = "auth_failed"
+    TIMEOUT = "timeout"
+    SERVER_ERROR = "server_error"
+    BAD_REQUEST = "bad_request"
+    QUOTA_EXHAUSTED = "quota_exhausted"
+    NOT_FOUND = "not_found"
+    UNKNOWN = "unknown"
+
+class PlatformError(Exception):
+    def __init__(
+        self,
+        message: str,
+        *,
+        platform: str,
+        retryable: bool = False,
+        error_type: str = PlatformErrorType.UNKNOWN,
+        status_code: int | None = None,
+    ):
+        super().__init__(message)
+        self.platform = platform
+        self.retryable = retryable
+        self.error_type = error_type
+        self.status_code = status_code
+```
+
+**HTTP 状态码映射**（全局中间件）：
+
+| error_type | retryable | HTTP 状态码 |
+|-----------|-----------|------------|
+| rate_limit | True | 429 |
+| timeout | True | 504 |
+| server_error | True | 502 |
+| auth_failed | False | 401 |
+| bad_request | False | 400 |
+| quota_exhausted | False | 429（带 Retry-After） |
+| unknown | False | 400 |
+
+**禁止事项**：
+- [ ] `app/services/` 和 `app/ai/` 中禁止 `raise HTTPException`
+- [ ] `app/services/` 和 `app/ai/` 中禁止裸 `raise Exception(...)`
+- [ ] 各 Router 中禁止 `except Exception: raise HTTPException(500, ...)` 处理第三方错误
+
+---
+
+### 铁律 2：Adapter 最小契约
+
+**规范内容**：每个新平台必须实现 `PlatformAdapter`（`platform_id` + `health()` + `close()`）。按需实现 `SyncCapable`（同步调用）或 `TaskCapable`（异步任务）。
+
+**Protocol 定义**：
+
+```python
+# app/ai/adapters/base.py
+
+@runtime_checkable
+class PlatformAdapter(Protocol):
+    """所有 Adapter 的准入门槛"""
+    platform_id: str
+    async def health(self) -> AdapterResponse: ...
+    async def close(self) -> None: ...
+
+@runtime_checkable
+class SyncCapable(Protocol):
+    """同步调用能力（TTS、Chat、图片生成等）"""
+    async def call(self, method: str, payload: dict) -> AdapterResponse: ...
+
+@runtime_checkable
+class TaskCapable(Protocol):
+    """异步任务能力（视频生成、字幕、TTS 等）"""
+    async def submit(self, task_type: str, payload: dict, callback_url: str | None) -> AdapterResponse: ...
+    async def query(self, platform_job_id: str) -> TaskStatus: ...
+
+@runtime_checkable
+class CallbackCapable(Protocol):
+    """回调验签能力（可选）"""
+    async def verify_signature(self, headers: dict, body: bytes, secret: str) -> bool: ...
+    async def parse_callback(self, body: bytes) -> TaskStatus: ...
+```
+
+**统一返回值**：
+
+```python
+@dataclass(frozen=True)
+class AdapterResponse:
+    success: bool
+    data: dict | None = None
+    error_code: str | None = None
+    error_message: str | None = None
+    retryable: bool = False
+
+@dataclass(frozen=True)
+class TaskStatus:
+    state: str  # "pending" | "processing" | "completed" | "failed"
+    result: dict | None = None
+    error_message: str | None = None
+```
+
+**方法标识常量**：
+
+```python
+# app/ai/adapters/constants.py
+class Method:
+    TTS = "tts"
+    CHAT = "chat"
+    CHAT_STREAM = "chat_stream"
+    IMAGE_GENERATE = "image_generate"
+    LIP_SYNC = "lip_sync"
+    CAPTION = "caption"
+    AUTO_ALIGN = "auto_align"
+```
+
+**各平台对号入座**：
+
+| 平台 | 必须实现 | 当前状态 |
+|-----|---------|---------|
+| 火山方舟 | `PlatformAdapter + SyncCapable` | ❌ 缺失，需新建 `VolcengineArkAdapter` |
+| Vidu | `PlatformAdapter + SyncCapable + TaskCapable + CallbackCapable` | ❌ 缺失，需新建 `ViduAdapter` |
+| 火山字幕 | `PlatformAdapter + TaskCapable` | ❌ 缺失，需新建 `VolcengineCaptionAdapter` |
+
+**禁止事项**：
+- [ ] 新增平台不实现 `PlatformAdapter` 直接接入
+- [ ] Adapter 内部抛出的异常不是 `PlatformError`
+- [ ] `call()` 方法返回裸 `dict` 而不是 `AdapterResponse`
+
+---
+
+### 铁律 3：HTTP Client 统一关闭
+
+**规范内容**：所有对外 HTTP 连接（`httpx.AsyncClient` 或 SDK 内部）必须在 `lifespan` 中创建和销毁。禁止在方法内临时创建 `httpx.AsyncClient()`。
+
+**具体标准**：
+
+```python
+# lifespan 中的标准写法
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # 各平台独立 Client（故障隔离）
+    app.state.http_clients = {
+        "vidu": httpx.AsyncClient(timeout=30, limits=httpx.Limits(max_connections=20)),
+        "volcengine_caption": httpx.AsyncClient(timeout=60, limits=httpx.Limits(max_connections=10)),
+        "default": httpx.AsyncClient(timeout=30, limits=httpx.Limits(max_connections=50)),
+    }
+    
+    # SDK 客户端
+    app.state.ark_client = AsyncArk(api_key=..., timeout=1800)
+    
+    yield
+    
+    # 统一关闭
+    for client in app.state.http_clients.values():
+        await client.aclose()
+    
+    if hasattr(app.state, "ark_client") and not app.state.ark_client.is_closed():
+        await app.state.ark_client.close()
+```
+
+**迁移清单**：
+
+| 文件 | 当前 Client | 整改方式 |
+|-----|------------|---------|
+| `app/ai/providers/vidu_provider.py` | `aiohttp.ClientSession` | 迁移为 `httpx.AsyncClient`，由 lifespan 注入 |
+| `app/services/volcengine_caption_service.py` | `httpx.AsyncClient`（懒加载，永不关闭） | 改为 lifespan 注入，删除 `_get_client()` 懒加载 |
+| `app/api/v1/voice.py` | 临时 `httpx.AsyncClient()` | 改为 `app.state.http_clients["default"]` |
+
+**禁止事项**：
+- [ ] 禁止 import `aiohttp`（项目统一使用 `httpx`）
+- [ ] 禁止在方法/路由内 `httpx.AsyncClient()` 临时创建（下载大文件例外，需注释说明）
+- [ ] 禁止 Provider `__init__` 中创建 Client 而不在 lifespan 中关闭
+
+---
+
+### 铁律 4：异步任务状态唯一
+
+**规范内容**：所有"提交后等待"的任务，状态必须写入统一的状态机。第三方回调走统一入口 `/webhooks/{platform}`。
+
+> **注意**：本铁律涉及数据库设计，当前文档中 SQLAlchemy `Job` model 相关设计已挂起，待数据库方案确定后补充。本章只规定接口和状态机标准。
+
+**统一状态枚举**：
+
+```python
+class JobStatus(str, Enum):
+    PENDING = "pending"       # 已提交，等待调度
+    QUEUED = "queued"         # 已进入队列，等待槽位
+    RUNNING = "running"       # 正在执行
+    SUCCEEDED = "succeeded"   # 成功完成
+    FAILED = "failed"         # 失败
+    CANCELLED = "cancelled"   # 用户取消或超时取消
+```
+
+**统一任务 API**：
+
+```python
+# 提交任务
+POST /jobs
+Request: {platform: str, task_type: str, payload: dict, idempotency_key: str | None}
+Response: {job_id: UUID, status: "pending"}
+
+# 查询任务
+GET /jobs/{job_id}
+Response: {job_id, status, progress, message, result, error, created_at, updated_at}
+
+# 统一回调入口
+POST /webhooks/{platform}
+```
+
+**第三方状态映射**（Adapter 层负责）：
+
+| 第三方状态 | 内部状态 |
+|-----------|---------|
+| Vidu: `pending` / `processing` | `RUNNING` |
+| Vidu: `success` | `SUCCEEDED` |
+| Vidu: `failed` | `FAILED` |
+| 火山字幕: `code=2000` | `RUNNING` |
+| 火山字幕: `code=0` | `SUCCEEDED` |
+| 火山字幕: `code=1001/1002/1012` | `FAILED`（不可重试） |
+| 火山字幕: `code=1003`（超频） | `FAILED`（可重试） |
+
+**禁止事项**：
+- [ ] 禁止 Router/Service 私设 Redis key（如 `vidu:lipsync:xxx`）
+- [ ] 禁止在 Router 中直接处理回调验签（必须由 Adapter 处理）
+- [ ] 禁止各平台使用自己的状态字符串返回给前端
+
+---
+
+### 铁律 5：配置与密钥分离
+
+**规范内容**：非敏感配置走 `config/platform-config.yaml`，支持热重载。密钥走 `.env`，修改需重启。
+
+**文件结构**：
+
+```yaml
+# config/platform-config.yaml
+platforms:
+  <platform_id>:
+    provider: <provider_type>
+    base_url: <url>
+    models:  # 原 ai_models.yaml 内容合并至此
+      - id: <model_alias>
+        model_name: <实际模型ID>
+        capabilities: [<capability>]
+        default_params: <dict>
+    rate_limit:
+      qps: <float>
+      burst: <int>
+    methods:
+      <method>:
+        timeout: <int>
+        max_connections: <int>
+        rate_limit:
+          qps: <float>
+          burst: <int>
+
+runtime:
+  fallback_chains:
+    <capability>:
+      - <model_alias_1>
+      - <model_alias_2>
+  task_timeouts:
+    <task_type>: <seconds>
+  task_ttl:
+    <task_type>: <seconds>
+```
+
+**热重载实现**：
+
+```python
+class RuntimeConfig:
+    """运行时配置，轮询检查 mtime（10秒间隔）+ Admin API 手动触发"""
+    
+    async def get(self, key: str, default=None):
+        await self._reload_if_changed()
+        return self._config.get(key, default)
+    
+    async def force_reload(self) -> bool:
+        """Admin API 调用"""
+        ...
+```
+
+**Admin API**：
+
+```python
+@router.post("/admin/runtime-config/reload")
+async def reload_runtime_config():
+    success = await runtime_config.force_reload()
+    return {"reloaded": success, "version": runtime_config.version}
+
+@router.get("/admin/runtime-config")
+async def get_runtime_config():
+    return runtime_config.get_raw()
+```
+
+**迁移清单**：
+
+| `.env` 中的配置项 | 迁移目标 | 状态 |
+|------------------|---------|------|
+| `VIDU_BASE_URL` | `platforms.vidu.base_url` | 待迁移 |
+| `VOLCENGINE_BASE_URL` | `platforms.volcengine_ark.base_url` | 待迁移 |
+| `VOLC_SUBTITLE_MAX_CONCURRENT` | `platforms.volcengine_caption.methods.caption.max_connections` | 待迁移 |
+| `VOLC_SUBTITLE_TIMEOUT` | `runtime.task_timeouts.caption` | 待迁移 |
+
+**禁止事项**：
+- [ ] 禁止在 `.env` 中存放非敏感配置（URL、超时、限流）
+- [ ] 禁止代码中硬编码配置（如 `timeout=30`、`max_rate=20`）
+- [ ] 禁止 `Settings` 类超过 150 行（逐步瘦身）
+
+---
+
+## 三、分阶段实施计划
+
+### Phase 0：准备（0.5 天）
+
+| # | 任务 | 输出文件 | 检查方式 |
+|---|------|---------|---------|
+| 0.1 | 新建 `app/ai/adapters/` 目录结构 | `app/ai/adapters/__init__.py` | 目录存在 |
+| 0.2 | 新建 `app/platform_gateway.py` 骨架 | `app/platform_gateway.py` | 文件存在，类定义完整 |
+| 0.3 | 安装/确认 `importlinter` 可用 | `pyproject.toml` 依赖 | `pip show importlinter` |
+| 0.4 | 备份现有 `exceptions.py` | git stash / 分支 | 可回滚 |
+
+### Phase 1：异常体系（0.5 天）
+
+| # | 任务 | 输出文件 | 检查方式 |
+|---|------|---------|---------|
+| 1.1 | 重构 `PlatformError` + `PlatformErrorType` | `app/core/exceptions.py` | 类型定义完整，含所有字段 |
+| 1.2 | 保留 `AppException` 体系（业务错误） | `app/core/exceptions.py` | 原有类不删除 |
+| 1.3 | `main.py` 注册 `PlatformError` 全局中间件 | `app/main.py` | 启动无报错，异常测试返回正确 HTTP 码 |
+| 1.4 | `VolcengineArkAdapter._wrap_error()` 实现异常映射 | `app/ai/adapters/volcengine_ark.py` | 单元测试覆盖 |
+| 1.5 | `ViduAdapter._wrap_error()` 实现异常映射 | `app/ai/adapters/vidu.py` | 单元测试覆盖 |
+| 1.6 | `make lint-semantic` 增加异常规则 | `Makefile` | 提交时自动检查 |
+
+**验收标准**：
+- [ ] 任意第三方调用失败，Router 返回的 JSON 中 `detail.retryable` 正确
+- [ ] 网络超时返回 504，限流返回 429，认证失败返回 401
+- [ ] 业务错误（如参数校验失败）仍走 `AppException` → 400/422
+
+### Phase 2：Adapter Protocol + 配置合并（1 天）
+
+| # | 任务 | 输出文件 | 检查方式 |
+|---|------|---------|---------|
+| 2.1 | `PlatformAdapter` / `SyncCapable` / `TaskCapable` / `CallbackCapable` Protocol | `app/ai/adapters/base.py` | `isinstance` 校验通过 |
+| 2.2 | `AdapterResponse` / `TaskStatus` dataclass | `app/ai/adapters/base.py` | frozen=True，字段完整 |
+| 2.3 | `Method` 常量定义 | `app/ai/adapters/constants.py` | 覆盖所有现有方法 |
+| 2.4 | 合并 `ai_models.yaml` → `platform-config.yaml` | `config/platform-config.yaml` | 原有模型列表完整迁移 |
+| 2.5 | `RuntimeConfig` 热重载实现 | `app/core/runtime_config.py` | mtime 轮询 + force_reload 均工作 |
+| 2.6 | Admin API `/admin/runtime-config/*` | `app/api/v1/system.py` | GET/POST 返回正确 |
+| 2.7 | `Settings` 类清理非敏感配置 | `app/config.py` | 只保留密钥，行数 < 150 |
+
+**验收标准**：
+- [ ] 新增一个 MockAdapter 实现 Protocol，IDE 自动提示缺失方法
+- [ ] 修改 `runtime.yaml` 中的 qps，10 秒内新请求生效
+- [ ] Admin API 手动触发 reload，返回最新配置
+
+### Phase 3：HTTP Client 统一（1 天）
+
+| # | 任务 | 输出文件 | 检查方式 |
+|---|------|---------|---------|
+| 3.1 | `ViduProvider` 从 `aiohttp` 迁移到 `httpx` | `app/ai/providers/vidu_provider.py` | 功能测试通过 |
+| 3.2 | `VolcengineCaptionService` 删除懒加载，改为注入 Client | `app/services/volcengine_caption_service.py` | 功能测试通过 |
+| 3.3 | `voice.py` 中临时 `httpx.AsyncClient()` 改为共享 Client | `app/api/v1/voice.py` | 代码审查 |
+| 3.4 | lifespan 统一管理所有 Client 生命周期 | `app/main.py` | 启动/关闭无泄漏日志 |
+| 3.5 | `ViduAdapter.close()` / `VolcengineCaptionAdapter.close()` 实现 | 对应 Adapter 文件 | lifespan shutdown 时调用 |
+| 3.6 | `make lint` 增加 `aiohttp` import 禁止规则 | `pyproject.toml` 或 pre-commit | import aiohttp 报 error |
+
+**验收标准**：
+- [ ] `pip list | grep aiohttp` 无输出（或确认仅作为间接依赖）
+- [ ] `python -m app.main` 启动后，关闭时无 `unclosed client session` 警告
+- [ ] 所有 `AsyncClient` 创建都在 lifespan 中
+
+### Phase 4：Gateway 骨架 + Adapter 包装层（1 天）
+
+| # | 任务 | 输出文件 | 检查方式 |
+|---|------|---------|---------|
+| 4.1 | `PlatformGateway` 骨架（`call_sync` / `submit_task` / `query_task` / `handle_webhook`） | `app/platform_gateway.py` | 类方法签名完整 |
+| 4.2 | `VolcengineArkAdapter` 改造现有 Provider 实现 Protocol | `app/ai/adapters/volcengine_ark.py` | 单元测试通过 |
+| 4.3 | `ViduAdapter` 改造现有 Provider 实现 Protocol | `app/ai/adapters/vidu.py` | 单元测试通过 |
+| 4.4 | `VolcengineCaptionAdapter` 改造现有 Service 实现 Protocol | `app/ai/adapters/volcengine_caption.py` | 单元测试通过 |
+| 4.5 | `LLMGateway` 实现（模型选择、Fallback、流式路由） | `app/ai/gateways/llm_gateway.py` | 脚本生成功能测试通过 |
+| 4.6 | lifespan 中初始化所有 Adapter 并注册到 Gateway | `app/main.py` | 启动日志显示各平台初始化成功 |
+
+**验收标准**：
+- [ ] 新增一个 `MockAdapter` 实现 Protocol，5 分钟内完成注册并可用
+- [ ] `LLMGateway.chat()` 主模型失败时自动 Fallback 到备用模型
+- [ ] 健康检查 `/system/platform-health` 返回所有平台状态
+
+### Phase 5：异步任务统一（2 天，数据库方案确定后实施）
+
+| # | 任务 | 输出文件 | 检查方式 |
+|---|------|---------|---------|
+| 5.1 | SQLAlchemy `Job` model（独立设计） | `app/models/job.py` | Alembic 迁移成功 |
+| 5.2 | Pydantic `JobResponse` Schema | `app/schemas/job.py` | 覆盖所有字段 |
+| 5.3 | `JobRegistry` 改为先写数据库、再写 Redis | `app/scheduler/registry.py` | 数据库有数据 |
+| 5.4 | `JobStatus` 扩展为 6 种状态 | `app/schemas/enums.py` | 覆盖所有场景 |
+| 5.5 | `ViduHandler` 接入 Async Engine | `app/scheduler/handlers/vidu_handler.py` | 视频生成任务走 Engine |
+| 5.6 | `SubtitleHandler` 改为通过 Gateway 调用 | `app/scheduler/handlers/subtitle_handler.py` | 字幕任务走 Gateway |
+| 5.7 | 统一回调入口 `/webhooks/{platform}` | `app/api/v1/webhooks.py` | Vidu 回调正常 |
+| 5.8 | 删除 Router 中私设 Redis key 的代码 | `app/api/v1/vidu.py` | 无 `vidu:lipsync:` 字样 |
+| 5.9 | 统一任务 API `/jobs/{job_id}` | `app/api/v1/jobs.py` | GET 返回标准格式 |
+| 5.10 | 脚本生成从 SSE 改为异步任务 | `app/api/v1/script.py` / `app/services/script_service.py` | POST /jobs 提交，轮询 /jobs/{id} |
+| 5.11 | 删除 `/script/generate/stream` SSE 端点 | `app/api/v1/script.py` | 端点不存在 |
+
+**验收标准**：
+- [ ] Vidu 视频生成任务提交后，Redis 中只有 `job:{uuid}` 格式的 key
+- [ ] 应用重启后，从数据库恢复 running 任务继续执行
+- [ ] 前端轮询 `/jobs/{id}` 获取所有异步任务状态
+
+### Phase 6：清理与验证（0.5 天）
+
+| # | 任务 | 输出文件 | 检查方式 |
+|---|------|---------|---------|
+| 6.1 | `importlinter` 配置（禁止 Router 直接 import Provider） | `.importlinter` | CI 中运行通过 |
+| 6.2 | 删除废弃的 `ai_models.yaml`（确认合并完成后） | — | 文件不存在 |
+| 6.3 | 删除 `ViduService` / `VolcengineCaptionService` 中的重复异常处理 | 对应文件 | 代码审查 |
+| 6.4 | 全量回归测试（所有现有 API 调用一遍） | — | 测试脚本通过 |
+| 6.5 | 更新本文档，标记各阶段完成状态 | 本文档 | 所有 checkbox 打勾 |
+
+---
+
+## 四、检查清单汇总
+
+### 4.1 新增文件清单
+
+| 文件路径 | 说明 | 所属阶段 |
+|---------|------|---------|
+| `app/ai/adapters/__init__.py` | Adapter 包 | Phase 0 |
+| `app/ai/adapters/base.py` | Protocol + dataclass | Phase 2 |
+| `app/ai/adapters/constants.py` | Method 常量 | Phase 2 |
+| `app/ai/adapters/volcengine_ark.py` | 火山方舟 Adapter | Phase 4 |
+| `app/ai/adapters/vidu.py` | Vidu Adapter | Phase 4 |
+| `app/ai/adapters/volcengine_caption.py` | 火山字幕 Adapter | Phase 4 |
+| `app/ai/gateways/llm_gateway.py` | LLM 网关 | Phase 4 |
+| `app/platform_gateway.py` | 统一平台网关 | Phase 0/4 |
+| `app/core/runtime_config.py` | 运行时配置 + 热重载 | Phase 2 |
+| `config/platform-config.yaml` | 合并后的平台配置 | Phase 2 |
+| `app/models/job.py` | 异步任务数据库模型 | Phase 5 |
+| `app/api/v1/jobs.py` | 统一任务 API | Phase 5 |
+| `app/api/v1/webhooks.py` | 统一回调入口 | Phase 5 |
+| `app/scheduler/handlers/vidu_handler.py` | Vidu 任务处理器 | Phase 5 |
+| `.importlinter` | 架构约束配置 | Phase 6 |
+
+### 4.2 修改文件清单
+
+| 文件路径 | 修改内容 | 所属阶段 |
+|---------|---------|---------|
+| `app/core/exceptions.py` | 新增 `PlatformError` / `PlatformErrorType` | Phase 1 |
+| `app/main.py` | 注册异常中间件、lifespan Client 管理 | Phase 1/3/4 |
+| `app/config.py` | 清理非敏感配置，只保留密钥 | Phase 2 |
+| `app/ai/providers/vidu_provider.py` | aiohttp → httpx | Phase 3 |
+| `app/services/volcengine_caption_service.py` | 删除懒加载，改为注入 Client | Phase 3 |
+| `app/api/v1/voice.py` | 临时 Client → 共享 Client | Phase 3 |
+| `app/api/v1/script.py` | SSE → 异步任务 + 删除 stream 端点 | Phase 5 |
+| `app/services/script_service.py` | 删除 generate_script_stream | Phase 5 |
+| `app/api/v1/system.py` | 新增 Admin API | Phase 2 |
+| `app/scheduler/registry.py` | 先写数据库再写 Redis | Phase 5 |
+| `app/scheduler/handlers/subtitle_handler.py` | 通过 Gateway 调用 | Phase 5 |
+| `app/api/v1/vidu.py` | 删除私设 Redis key | Phase 5 |
+| `app/schemas/enums.py` | 扩展 `JobStatus` | Phase 5 |
+| `Makefile` / `pyproject.toml` | lint 规则 | Phase 1/3/6 |
+
+### 4.3 废弃文件清单
+
+| 文件路径 | 废弃原因 | 处理时间 |
+|---------|---------|---------|
+| `config/ai_models.yaml` | 合并到 `platform-config.yaml` | Phase 6 |
+
+---
+
+## 五、风险项与应对
+
+| 风险 | 影响 | 概率 | 应对 |
+|-----|------|------|------|
+| `aiohttp` 迁移到 `httpx` 导致 Vidu 某些边缘场景行为不一致 | 功能回归 | 中 | 迁移后全量测试 Vidu TTS/视频生成/声音复刻 |
+| `PlatformError` 未覆盖所有异常路径，仍有裸 Exception 漏出 | 前端收到 500 无法处理 | 低 | `make lint-semantic` 强制检查 + Code Review |
+| 配置热重载导致运行时行为突变 | 线上限流突然变更 | 低 | Admin API 加操作日志，变更前确认 |
+| Phase 5 数据库改造影响现有 Async Engine | 字幕/脚本任务异常 | 中 | 数据库方案评审后再实施，分步迁移 |
+| 前端轮询改造工作量超预期 | 延期 | 中 | 提前与前端同步接口变更，预留 2 天 |
+
+---
+
+## 六、验收标准（最终 Checklist）
+
+实施全部完成后，按以下清单逐项核对：
+
+- [ ] `PlatformError` 是 `app/services/` 和 `app/ai/` 中唯一的第三方异常类型
+- [ ] Router 中不存在 `except Exception: raise HTTPException(500)` 处理第三方错误
+- [ ] 新增 MockAdapter 实现 Protocol，30 分钟内完成注册并可用
+- [ ] `aiohttp` 不在项目直接依赖中（`pip show aiohttp` 不显示或仅为间接依赖）
+- [ ] 所有 `AsyncClient` 在 lifespan 中创建和销毁
+- [ ] 关闭应用时无 `unclosed client session` 警告
+- [ ] `config/platform-config.yaml` 存在且包含所有平台配置
+- [ ] 修改 `platform-config.yaml` 中的限流参数，10 秒内新请求生效
+- [ ] Admin API `/admin/runtime-config/reload` 手动触发重载成功
+- [ ] 健康检查 `/system/platform-health` 返回所有平台状态
+- [ ] `importlinter` CI 检查通过（Router 不直接 import Provider）
+- [ ] 全量 API 回归测试通过
+
+---
+
+> 本文档为实施的唯一依据。任何偏离文档的变更必须在此文档中登记并说明理由。

docs/unified-async-scheduler.md

@@ -0,0 +1,350 @@
+# 统一异步任务调度方案
+
+> **状态：已完成（2026-04-17）** — 本文档所述方案已全面实施，Celery 已完全移除，所有第三方异步任务现由 Async Engine Scheduler 统一调度。
+
+> 本文档用于替代原 Celery 在"提交→轮询→收尾"类第三方异步任务中的角色，解决视频生成、形象克隆等任务在队列中频繁出现的拥堵、死锁和状态不一致问题。
+
+---
+
+## 1. 背景与问题
+
+### 1.1 当前架构的缺陷
+
+目前项目使用 Celery Worker 处理所有第三方异步任务，包括：
+
+- **视频生成** (`video`)：提交 Kling 分镜 → 轮询状态 → 下载上传
+- **形象克隆** (`avatar_clone`)：提交音色 → 轮询 → 提交主体 → 轮询
+- **字幕对齐** (`subtitle`)
+- **图片生成** (`image`)
+
+这些任务都被放进 Celery 队列，由 Worker 并发消费。但 Kling 视频生成本质上是**"占用并发槽位并长时间等待"**的过程，当前设计存在三个结构性问题：
+
+1. **轮询任务风暴**：`poll_video_task` 用 Celery `retry(countdown=5)` 模拟轮询，一个 8 分钟的 Kling 任务会产生近百个 Celery Task，淹没队列调度器和 Redis Result Backend。
+2. **快慢任务混排**：下载上传（IO 密集型）和提交/轮询（轻量 HTTP）共用 `video` 队列，Worker 被长任务占满，新任务饿死。
+3. **状态死锁**：`download_upload_shot` 作为独立 Celery Task，一旦被 Worker 强制 Kill（如超时），shot 状态永远卡在 `downloading`，而轮询任务又不再处理它，导致整个任务假死。
+
+### 1.2 核心认知
+
+Kling 是一个有**严格并发上限**（20 槽位）的第三方异步执行池。我们需要的是一个 **Slot-Based Scheduler**（槽位调度器），而不是一个任务队列（Celery）。
+
+> **任务队列**擅长"把独立任务尽快分发出去"；
+> **槽位调度器**擅长"在有限资源下，周期性补货、轮询和收尾"。
+
+Kling 视频生成和形象克隆属于后者。
+
+---
+
+## 2. 架构总览
+
+```
+┌─────────────┐      HTTP      ┌──────────────────┐
+│  Tauri App  │ ◄────────────► │   FastAPI API    │
+│  (React)    │                │   (Gateway)      │
+└─────────────┘                └────────┬─────────┘
+                                        │
+                    ┌───────────────────┼───────────────────┐
+                    │                   │                   │
+                    ▼                   ▼                   ▼
+            ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+            │  PostgreSQL  │    │    Redis     │    │ Object Store │
+            │  (持久化/审计) │    │  (运行时状态) │    │  (七牛/本地)  │
+            └──────────────┘    └──────┬───────┘    └──────────────┘
+                                       │
+                              ┌────────┴────────┐
+                              │   Async Engine  │
+                              │  (Slot Scheduler)│
+                              │  python main.py │
+                              └────────┬────────┘
+                                       │
+                    ┌──────────────────┼──────────────────┐
+                    ▼                  ▼                  ▼
+            ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
+            │ Video Handler│    │Avatar Handler│    │Future Handler│
+            │  max_slots=18│    │  max_slots=2 │    │  (subtitle…) │
+            └─────────────┘    └─────────────┘    └─────────────┘
+```
+
+### 2.1 核心组件
+
+| 组件 | 职责 | 技术选型 |
+|------|------|----------|
+| **FastAPI API** | 接收前端请求、创建任务、写入状态、供前端轮询 | 现有 FastAPI |
+| **Redis** | 存储任务的**运行时状态**（running shots、当前 stage、slot 占用集合） | 现有 Redis |
+| **PostgreSQL** | 存储任务的**持久化记录**（创建时间、最终结果、成本统计、失败原因） | 现有 PostgreSQL |
+| **Async Engine** | 独立的调度进程，每 10 秒一次 **Tick**，驱动所有任务状态推进 | Python `asyncio` |
+| **Handler** | 插件化模块，每个第三方平台一个实现 | 面向接口的 Python 类 |
+
+---
+
+## 3. 核心机制
+
+### 3.1 统一状态机
+
+无论 video 还是 avatar_clone，所有第三方异步任务单元收敛到 **5 个统一状态**：
+
+```
+pending    →   submitted   →   succeed   →   completed
+   │                              │
+   └──────────────────────────────┘
+                           ↓
+                        failed
+```
+
+- **`pending`**：在队列里等待全局 slot 空闲
+- **`submitted`**：已占用 slot，已提交给 Kling，等待轮询结果
+- **`succeed`**：Kling 返回成功，Async Engine 立即触发下载/收尾（后台异步执行）
+- **`failed`**：Kling 返回失败或提交异常
+- **`completed`**：下载、上传、DB 写入全部完成
+
+对于 avatar_clone 这种**多阶段**任务，内部用 Sub-State 嵌套，但每个阶段仍遵循同一模式：
+
+```
+voice_pending → voice_submitted → voice_succeed
+                      ↓
+           element_pending → element_submitted → element_succeed → completed
+```
+
+### 3.2 Slot Manager（全局并发控制器）
+
+基于 **Redis SET + Lua 脚本** 实现严格的原子槽位管理：
+
+```python
+class SlotManager:
+    async def acquire(self, slot_key: str, slot_id: str, max_slots: int) -> bool:
+        """Lua 脚本原子执行：SADD -> SCARD -> 超限则 SREM"""
+        lua = """
+        local key = KEYS[1]
+        local slot_id = ARGV[1]
+        local max_slots = tonumber(ARGV[2])
+        redis.call('sadd', key, slot_id)
+        local count = redis.call('scard', key)
+        if count > max_slots then
+            redis.call('srem', key, slot_id)
+            return 0
+        end
+        redis.call('expire', key, 1800)
+        return 1
+        """
+        return await self.redis.eval(lua, 1, slot_key, slot_id, str(max_slots)) == 1
+
+    async def release(self, slot_key: str, slot_id: str) -> None:
+        await self.redis.srem(slot_key, slot_id)
+```
+
+当前配置：
+
+- **Video 槽位池**：`kling:video_slots`，上限 **18**
+- **Avatar 槽位池**：`kling:avatar_slots`，上限 **2**
+
+> **为什么 Lua 脚本？** 确保 `SADD + SCARD + 条件 SREM` 原子执行。即使未来启动第二个 Scheduler 实例做 HA，也不会出现并发超发。
+
+### 3.3 Async Engine Tick 循环
+
+Scheduler 是一个独立的 `asyncio` 进程，主循环如下：
+
+```python
+async def main():
+    engine = AsyncEngine()
+    while True:
+        tick_start = time.monotonic()
+
+        # 1. 加载所有 running 的任务
+        tasks = await engine.registry.get_running_tasks()
+
+        # 2. 按 Handler 分组，并行执行各自的 tick
+        changes = await asyncio.gather(*[
+            handler.tick(tasks_for_handler, engine.slots)
+            for handler in engine.handlers.values()
+        ])
+
+        # 3. 批量应用状态变更（Pipeline 写入 Redis）
+        await engine.registry.apply_changes(flatten(changes))
+
+        # 4. 对 completed/failed 的任务，持久化到 PostgreSQL
+        await engine.persist_finished_tasks()
+
+        # 5. 控制 Tick 间隔（固定 10 秒，执行过久时至少休息 2 秒）
+        elapsed = time.monotonic() - tick_start
+        await asyncio.sleep(max(10 - elapsed, 2))
+```
+
+### 3.4 Handler 插件化接口
+
+每个第三方平台实现一个 Handler：
+
+```python
+class AsyncHandler(ABC):
+    name: str           # e.g. "video"
+    slot_key: str       # e.g. "kling:video_slots"
+    max_slots: int      # e.g. 18
+
+    @abstractmethod
+    async def tick(self, tasks: list[Task], slots: SlotManager) -> list[StateChange]:
+        """每个 Tick 执行一次，返回需要更新的状态变更列表"""
+        pass
+```
+
+#### Video Handler 的 tick 逻辑
+
+1. **查**：遍历所有 `submitted` 的 shots，批量并行查询 Kling 状态
+2. **收**：
+   - `succeed` → `release_slot` + `asyncio.create_task(download_and_upload(shot))` + 状态改为 `completed`
+   - `failed` → `release_slot` + 状态改为 `failed`
+3. **补**：计算空闲槽位数，从 `pending` 队列 FIFO 取出新 shot 提交给 Kling，直到槽满
+4. **写**：更新 task 的聚合状态（completed/total/message）到 Redis
+
+#### Avatar Handler 的 tick 逻辑
+
+1. 检查当前 stage（如 `voice_submitted`），查询 Kling 状态
+2. 若 `voice_succeed` → 释放 slot，推进到 `element_pending`，并在同一 tick 内尝试申请 slot 提交主体创建
+3. 若 `element_succeed` → 释放 slot，状态改为 `completed`
+
+---
+
+## 4. API 层与数据流
+
+### 4.1 创建任务（不变）
+
+```python
+@router.post("/{task_type}", response_model=TaskCreateResponse)
+async def create_task(task_type: str, request: TaskCreateRequest):
+    task_id = generate_task_id()
+
+    # 1. 写入 PostgreSQL（持久化底单）
+    await db_task.create(task_id=task_id, type=task_type, user_id=...)
+
+    # 2. 写入 Redis（标记为 pending，供 Async Engine 消费）
+    await redis_task.create(task_id=task_id, type=task_type, status="pending", ...)
+
+    return TaskCreateResponse(task_id=task_id, status="pending")
+```
+
+### 4.2 查询状态（不变）
+
+```python
+@router.get("/{task_id}", response_model=TaskStatusResponse)
+async def get_task_status(task_id: str):
+    # 先读 Redis（热数据）
+    task = await redis_task.get(task_id)
+    if not task:
+        # fallback 到 PostgreSQL（已完成的归档数据）
+        task = await db_task.get(task_id)
+    return task
+```
+
+### 4.3 前端兼容性
+
+**前端 `useTask.ts` 的轮询逻辑完全不需要修改。** 这是渐进式迁移的关键——调度层的重构对上层透明。
+
+---
+
+## 5. 部署方案
+
+### 5.1 Docker Compose
+
+```yaml
+services:
+  api:
+    build:
+      context: ../python-api
+      dockerfile: Dockerfile
+    command: uvicorn app.main:app --host 0.0.0.0 --port 8000
+    # ...
+
+  scheduler:
+    build:
+      context: ../python-api
+      dockerfile: Dockerfile
+    container_name: meijiaka-scheduler
+    command: python -m app.scheduler.main
+    environment:
+      - REDIS_HOST=redis
+      - DATABASE_URL=postgresql+asyncpg://...
+    depends_on:
+      - redis
+      - db
+    restart: unless-stopped
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+```
+
+### 5.2 Celery 的处置
+
+- 立即下线 `worker-video`（不再消费 `video` 队列）
+- Phase 2 下线 `worker-avatar`（Avatar Handler 迁入 Async Engine 后）
+- 可选：暂时保留 Celery 跑 `subtitle`，待后续迁移
+- 最终目标：所有"提交→轮询"类任务都迁入 Async Engine，Celery 整体移除
+
+---
+
+## 6. 迁移路径
+
+| 阶段 | 时间 | 动作 | 风险 |
+|------|------|------|------|
+| **Phase 1** | 本周 | Async Engine 只接管 `video`（18 slots）；`avatar_clone` 仍由 Celery 运行 | 改动面最小，只验证 video 链路 |
+| **Phase 2** | 1-2 周后 | Async Engine 新增 `avatar_clone` Handler（2 slots）；彻底下线 Celery 的 `worker-video` 和 `worker-avatar` | 验证 avatar 链路，解决资源饿死 |
+| **Phase 3** | 未来 | `subtitle`、`image` 等陆续迁入 Async Engine；Celery 完全移除 | 统一所有第三方异步任务调度 |
+
+---
+
+## 7. 设计原则论证
+
+### 7.1 主流（Mainstream）
+
+- **Redis + PostgreSQL 双存储**：运行态在 Redis，持久态在 PostgreSQL。这是现代异步系统的事实标准，从 AWS Lambda 到 Vercel 再到国内云厂商均采用类似模式。
+- **Python asyncio 轻量调度器**：不引入 Kafka、RabbitMQ 或 Airflow 等重型框架，利用原生异步能力构建。Prefect、Dagster 的底层 Scheduler 也采用类似思想。
+- **Gateway + 独立 Scheduler 进程**：API 负责接入，Scheduler 负责推进，职责清晰。这是当前中小型 SaaS 的主流演进方向。
+
+### 7.2 合理（Reasonable）
+
+- **完全匹配项目定位**：项目定位是"轻量云账号 + 全本地业务数据"，不需要 Kubernetes 或复杂工作流引擎。Async Engine 只是一个额外的 Python 进程，资源占用 < 512MB。
+- **渐进式迁移，契约不变**：前端轮询逻辑、API URL、响应 Schema 均不变。改动仅集中在后端任务分发层，业务代码零侵入。
+- **资源隔离精确可控**：Video 18 slots + Avatar 2 slots = 20 slots，与 Kling 实际并发限制完全对齐。不会出现"形象克隆占满 Worker 导致视频饿死"的结构性问题。
+- **开发体验优先**：本地开发时，scheduler 可以和 api 一起 `docker-compose up`，也可以单独 `python -m app.scheduler.main` 调试。不需要 ngrok，不需要把开发环境搬到云端。
+- **幂等和可恢复**：每个 shot 的提交操作都是幂等的。Redis 记录了 `kling_task_id`，Scheduler 重启后从 Redis 恢复 running 任务，继续轮询，不会丢失状态。
+
+### 7.3 长期稳定（Long-term Stable）
+
+- **HA 预留，无单点故障**：`SlotManager` 基于 Redis Lua 脚本实现原子操作，天然支持多实例竞争。未来如需高可用，可启动第二个 Scheduler 实例，通过 Redis 分布式锁选举 Leader，实现秒级主备切换，无需重构。
+- **Handler 插件化扩展**：未来接入即梦、Runway、Pika 或新的 AI 服务，只需实现新的 `AsyncHandler` 子类，配置 `slot_key` 和 `max_slots`。核心调度逻辑永远不需要改动。
+- **数据一致性保障**：运行态在 Redis（崩溃恢复快），完成态在 PostgreSQL（数据不丢）。即使 Scheduler 挂掉 30 分钟，Kling 端的任务仍在运行，恢复后继续轮询即可。
+- **第三方接口变更的防御性**：Handler 内部对 Kling API 的调用有统一的超时控制、重试策略和异常兜底。如果 Kling 某个接口升级，只改对应 Handler，不影响其他模块。
+- **可观测性支撑长期运维**：通过 Prometheus 指标，可长期监控"视频生成成功率"、"平均生成耗时"、"槽位利用率"、"Kling API 延迟分布"，为后续扩容和成本优化提供数据支撑。
+
+---
+
+## 8. 关键文件位置（建议）
+
+```
+python-api/
+├── app/
+│   └── scheduler/
+│       ├── __init__.py
+│       ├── main.py              # Async Engine 入口（Tick 循环）
+│       ├── engine.py            # AsyncEngine 核心调度器
+│       ├── slot_manager.py      # 槽位管理器（Redis Lua）
+│       ├── registry.py          # 任务注册表（Redis 读写）
+│       ├── handlers/
+│       │   ├── __init__.py
+│       │   ├── base.py          # AsyncHandler 抽象基类
+│       │   ├── video_handler.py # Video 任务处理器
+│       │   └── avatar_handler.py # Avatar Clone 处理器
+│       └── models.py            # Scheduler 内部数据模型
+```
+
+---
+
+## 9. 结论
+
+当前 Celery 在"提交→轮询→收尾"类任务中的角色是**结构性错位**的。它带来的任务风暴、队列拥堵和状态死锁不是可以通过调参修复的，而是其模型与问题本质不匹配的结果。
+
+**统一异步调度方案**的核心决策：
+
+1. **用 Async Engine（Slot-Based Scheduler）替代 Celery 管理所有第三方异步任务**
+2. **Video 分配 18 槽，Avatar Clone 分配 2 槽，由唯一调度器全局管理**
+3. **API 层和前端轮询逻辑完全不变，实现渐进式迁移**
+4. **本地开发环境保持原样，无需引入 webhook 或云端部署**
+
+这是根治"任务队列生成视频总会出问题"的唯一长期方案。

docs/vidu-tts-api.md

@@ -0,0 +1,394 @@
+# Vidu TTS API 开发文档
+
+> 来源：https://platform.vidu.cn/docs/text-to-speech  
+> 更新时间：2026-04-21
+
+## 一、概述
+
+Vidu（生数科技）提供语音合成（TTS）和声音复刻能力，所有接口均为**同步接口**，直接返回结果，无需轮询。
+
+- **Base URL**: `https://api.vidu.cn`
+- **认证方式**: `Authorization: Token {your_api_key}`
+- **Content-Type**: `application/json`
+
+---
+
+## 二、语音合成 TTS
+
+### 端点
+
+```
+POST /ent/v2/audio-tts
+```
+
+### 请求头
+
+| 字段 | 值 | 描述 |
+|------|-----|------|
+| Content-Type | application/json | 数据交换格式 |
+| Authorization | Token {your_api_key} | API Key 认证 |
+
+### 请求体
+
+| 参数名称 | 类型 | 必填 | 描述 |
+|----------|------|------|------|
+| text | String | 是 | 待合成文本，**< 10000 字符**。支持 `<#x#>` 停顿标记，x 为停顿时长（秒），范围 [0.01, 99.99] |
+| voice_setting_voice_id | String | 是 | 音色 ID |
+| voice_setting_speed | Float | 否 | 语速，默认 1.0，范围 [0.5, 2] |
+| voice_setting_volume | Int | 否 | 音量，默认 0（正常音量），范围 [0, 10]，值越大音量越高 |
+| voice_setting_pitch | Int | 否 | 语调，默认 0（原音色），范围 [-12, 12] |
+| voice_setting_emotion | String | 否 | 情绪控制：`happy`/`sad`/`angry`/`fearful`/`disgusted`/`surprised`/`calm`。一般无需手动指定，模型自动匹配 |
+| pronunciation_dict_tone | list | 否 | 多音字发音定义，如 `["燕少飞/(yan4)(shao3)(fei1)"]` |
+| payload | String | 否 | 透传参数，最多 1048576 字符 |
+
+### 响应体
+
+```json
+{
+  "task_id": "your_task_id_here",
+  "state": "success",
+  "file_url": "https://...",
+  "credits": 10,
+  "payload": "",
+  "created_at": "2025-01-01T15:41:31.968916Z"
+}
+```
+
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| task_id | String | Vidu 生成的任务 ID |
+| state | String | `queueing` / `success` / `failed` |
+| file_url | String | 音频文件 URL |
+| credits | Int | 本次调用消耗的积分数 |
+| payload | String | 透传参数 |
+| created_at | String | 任务创建时间 |
+
+### Curl 示例
+
+```bash
+curl -X POST https://api.vidu.cn/ent/v2/audio-tts \
+  -H "Authorization: Token {your_api_key}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "text": "你好，欢迎使用vidu开放平台",
+    "voice_setting_voice_id": "female-tianmei"
+  }'
+```
+
+---
+
+## 三、声音复刻
+
+### 端点
+
+```
+POST /ent/v2/audio-clone
+```
+
+### 请求体
+
+| 参数名称 | 类型 | 必填 | 描述 |
+|----------|------|------|------|
+| audio_url | String | 是 | 原音频 URL（需可访问）。格式：mp3/m4a/wav；时长：10秒~5分钟；大小：≤20MB |
+| voice_id | String | 是 | 自定义声音 ID。长度 [8, 256]；首字符必须为英文字母；允许数字、字母、横线、下划线；末位不可为 `-`、`_`；不可与已有 ID 重复 |
+| prompt_audio_url | String | 否 | 音色复刻示例音频（< 8秒），可增强音色相似度和稳定性 |
+| prompt_text | String | 否 | 示例音频对应文本，需与音频内容一致，句末需有标点 |
+| text | String | 是 | 复刻试听文本，≤1000 字符。使用复刻后的音色朗读，返回试听音频 |
+| payload | String | 否 | 透传参数 |
+
+### 响应体
+
+```json
+{
+  "task_id": "your_task_id_here",
+  "state": "success",
+  "voice_id": "vidu01",
+  "demo_audio": "https://...",
+  "payload": "",
+  "created_at": "2025-01-01T15:41:31.968916Z"
+}
+```
+
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| task_id | String | 任务 ID |
+| state | String | `queueing` / `success` / `failed` |
+| voice_id | String | 用户自定义的 voice_id（任务失败时不返回）|
+| demo_audio | String | 试听音频链接（仅当请求传入 text 时返回）|
+| payload | String | 透传参数 |
+| created_at | String | 创建时间 |
+
+### Curl 示例
+
+```bash
+curl -X POST https://api.vidu.cn/ent/v2/audio-clone \
+  -H "Authorization: Token {your_api_key}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "audio_url": "your_audio_url",
+    "voice_id": "vidu01",
+    "text": "你好，欢迎使用vidu开放平台"
+  }'
+```
+
+---
+
+## 四、预设音色列表
+
+共 **16 个中文（普通话）**音色，分标准版和 Beta（精品）版。
+
+### 标准版
+
+| voice_id | 音色名称 |
+|----------|----------|
+| male-qn-qingse | 青涩青年音色 |
+| male-qn-jingying | 精英青年音色 |
+| male-qn-badao | 霸道青年音色 |
+| male-qn-daxuesheng | 青年大学生音色 |
+| female-shaonv | 少女音色 |
+| female-yujie | 御姐音色 |
+| female-chengshu | 成熟女性音色 |
+| female-tianmei | 甜美女性音色 |
+
+### Beta（精品）版
+
+| voice_id | 音色名称 |
+|----------|----------|
+| male-qn-qingse-jingpin | 青涩青年音色-beta |
+| male-qn-jingying-jingpin | 精英青年音色-beta |
+| male-qn-badao-jingpin | 霸道青年音色-beta |
+| male-qn-daxuesheng-jingpin | 青年大学生音色-beta |
+| female-shaonv-jingpin | 少女音色-beta |
+| female-yujie-jingpin | 御姐音色-beta |
+| female-chengshu-jingpin | 成熟女性音色-beta |
+| female-tianmei-jingpin | 甜美女性音色-beta |
+
+> 音色试听示例 URL 格式：`https://scene.vidu.zone/media-asset/{id}.mp3`（见飞书表格原始链接）
+
+---
+
+## 五、与 MiniMax 对比（接入参考）
+
+| 维度 | Vidu | MiniMax |
+|------|------|---------|
+| Base URL | `https://api.vidu.cn` | `https://api.minimaxi.com` |
+| 认证 | `Token {key}` | `Bearer {key}` |
+| TTS 端点 | `POST /ent/v2/audio-tts` | `POST /v1/t2a_v2` |
+| 同步/异步 | 同步 | 同步 + 异步 |
+| 文本上限 | 10000 字符 | 10000 字符（同步）|
+| 语速范围 | 0.5 ~ 2.0 (Float) | 需传 Int |
+| 音量范围 | 0 ~ 10 (Int，0=正常) | 需传 Int |
+| 语调范围 | -12 ~ 12 (Int) | 需传 Int |
+| 情绪控制 | 7 种情绪可选 | 不支持 |
+| 多音字 | 支持 `pronunciation_dict_tone` | 不支持 |
+| 声音复刻 | 同步，自定义 voice_id | 异步，系统分配 voice_id |
+| 复刻音频要求 | 10秒~5分钟，≤20MB | 约 10秒~5分钟 |
+| 预设音色 | 16 个中文 | 6 个中文 |
+| 响应音频字段 | `file_url` | `audio` |
+
+---
+
+## 六、视频生成（Lip Sync）
+
+### 端点
+
+```
+POST /ent/v2/lip-sync
+```
+
+**⚠️ 异步接口**，创建后返回 task_id，需要通过查询接口轮询或使用 callback_url 接收回调。
+
+### 请求体
+
+| 参数名称 | 类型 | 必填 | 描述 |
+|----------|------|------|------|
+| video_url | String | 是 | 原视频 URL（需可访问）。格式：mp4/mov/avi；时长：1~600秒（建议 10~120秒）；大小：≤5G；分辨率：360p~4096p；编码：H.264 |
+| audio_url | String | 否 | 音频文件 URL。格式：wav/mp3/wma/m4a/aac/ogg；时长：>1s 且 <600s；大小：≤100MB |
+| text | String | 否 | 文本内容，4~2000 字符。与 audio_url 同时有值时，以 audio_url 为准 |
+| speed | Float | 否 | 语速，默认 1.0，范围 [0.5, 2]。仅文字生成时生效 |
+| voice_id | String | 否 | 音色 ID。仅文字生成时生效 |
+| volume | Int | 否 | 音量，默认 0（正常音量），范围 [0, 10]。仅文字生成时生效 |
+| ref_photo_url | String | 否 | 人脸参考图 URL（jpg/jpeg/png/bmp/webp，192~4096px，≤10MB）。视频中有多张人脸时，用于指定视频生成目标人物 |
+| callback_url | String | 否 | 回调地址，任务状态变化时 POST 回调 |
+
+### 视频素材规范
+
+- 真人出镜（卡通人物需五官比例接近真人）
+- 人脸正对镜头，水平转动不超过 45°，俯仰不超过 15°
+- 人脸尽量不遮挡，面部光线稳定
+
+### 创建响应
+
+```json
+{
+  "task_id": "your_task_id_here",
+  "state": "created",
+  "payload": "",
+  "created_at": "2025-01-01T15:41:31.968916Z"
+}
+```
+
+### 查询任务状态
+
+```
+GET /ent/v2/tasks/{task_id}/creations
+```
+
+**响应体**：
+
+| 字段 | 类型 | 描述 |
+|------|------|------|
+| id | String | 任务 ID |
+| state | String | `created`/`queueing`/`processing`/`success`/`failed` |
+| err_code | String | 错误码 |
+| credits | Int | 消耗的积分数 |
+| payload | String | 透传参数 |
+| bgm | Bool | 是否使用 BGM |
+| off_peak | Bool | 是否使用错峰模式 |
+| creations | Array | 生成物结果列表 |
+| creations[].id | String | 生成物 ID |
+| creations[].url | String | 生成物 URL（24小时有效期） |
+| creations[].cover_url | String | 生成物封面 URL（24小时有效期） |
+| creations[].watermarked_url | String | 带水印的生成物 URL |
+
+### Curl 示例（音频驱动）
+
+```bash
+curl -X POST https://api.vidu.cn/ent/v2/lip-sync \
+  -H "Authorization: Token {your_api_key}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "video_url": "your_video_url",
+    "audio_url": "your_audio_url"
+  }'
+```
+
+### Curl 示例（文字驱动）
+
+```bash
+curl -X POST https://api.vidu.cn/ent/v2/lip-sync \
+  -H "Authorization: Token {your_api_key}" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "video_url": "your_video_url",
+    "text": "你好，欢迎使用vidu开放平台",
+    "voice_id": "female-tianmei",
+    "speed": 1.0
+  }'
+```
+
+---
+
+## 七、回调签名验证
+
+Vidu 在回调通知时会携带 **HMAC-SHA256** 签名，后端必须验证签名后才能信任回调内容，防止第三方伪造回调请求。
+
+### 7.1 签名生成公式
+
+```
+signature = base64(HMAC-SHA256(secret_key, signingString))
+```
+
+其中：
+- `secret_key`：创建任务时使用的 Token，即 `VIDU_API_KEY`
+- `signingString`：签名字符串，按以下格式构建
+
+### 7.2 签名字符串（signingString）
+
+```
+signingString = http_method + "\n"
+              + http_uri + "\n"
+              + canonical_query_string + "\n"
+              + access_key + "\n"
+              + Date + "\n"
+              + signed_headers_string
+```
+
+各参数说明：
+
+| 参数 | 说明 |
+|------|------|
+| `http_method` | HTTP 方法，必须全大写（如 `POST`） |
+| `http_uri` | 从 `callback_url` 解析出的 **path** 部分，必须以 `"/"` 开头 |
+| `canonical_query_string` | 从 `callback_url` 解析出的原始 **query** 部分（不含 `?`），无参数时为空字符串 |
+| `access_key` | 固定为 `"vidu"` |
+| `Date` | 请求头中的 `Date` 值，GMT 格式，如 `"Tue, 06 May 2025 12:09:42 GMT"` |
+| `signed_headers_string` | 按 `X-HMAC-SIGNED-HEADERS` 指定的顺序，拼接 `HeaderKey:HeaderValue\n` |
+
+> ⚠️ **注意**：字符串末尾有一个换行符；查询参数必须使用原始格式，不要包含 `"?"`。
+
+### 7.3 签名相关请求头
+
+Vidu 回调时会携带以下请求头：
+
+| Header | 说明 |
+|--------|------|
+| `Date` | GMT 格式时间，例如：`Tue, 06 May 2025 12:09:42 GMT` |
+| `x-request-nonce` | UUID 格式随机字符串，用于防止重放攻击 |
+| `X-HMAC-SIGNED-HEADERS` | 签名使用的头部字段列表，用分号分隔，如 `Date;x-request-nonce` |
+| `X-HMAC-SIGNATURE` | 最终计算出的 Base64 签名 |
+| `X-HMAC-ALGORITHM` | 签名算法，固定为 `hmac-sha256` |
+| `X-HMAC-ACCESS-KEY` | 访问密钥标识符，固定为 `vidu` |
+
+### 7.4 后端验证逻辑
+
+后端 `/vidu/callback` 接口在读取请求体之前，必须执行以下验证：
+
+1. **基础校验**：确认所有签名相关 Header 存在，且 `X-HMAC-ALGORITHM` 为 `hmac-sha256`、`X-HMAC-ACCESS-KEY` 为 `vidu`
+2. **防重放检查**：将 `x-request-nonce` 存入 Redis（TTL 5 分钟），若已存在则拒绝请求
+3. **构建 signingString**：从当前请求 URL 提取 `path` 和 `query`，按公式拼接签名字符串
+4. **计算期望签名**：使用 `VIDU_API_KEY` 作为 `secret_key`，计算 `HMAC-SHA256` 后进行 Base64 编码
+5. **安全比对**：使用 `hmac.compare_digest()` 进行常量时间比对，防止时序攻击
+
+验证失败时返回 **HTTP 401**，不处理请求体。
+
+### 7.5 示例：签名字符串生成
+
+假设 Vidu 发起回调：
+
+```http
+POST /api/v1/vidu/callback HTTP/1.1
+Host: 127.0.0.1:8081
+Date: Tue, 06 May 2025 12:09:42 GMT
+x-request-nonce: 123e4567-e89b-12d3-a456-426614174000
+X-HMAC-SIGNED-HEADERS: Date;x-request-nonce
+X-HMAC-SIGNATURE: xxxxxx
+X-HMAC-ALGORITHM: hmac-sha256
+X-HMAC-ACCESS-KEY: vidu
+```
+
+生成的 `signingString` 为：
+
+```
+POST
+/api/v1/vidu/callback
+
+vidu
+Tue, 06 May 2025 12:09:42 GMT
+Date:Tue, 06 May 2025 12:09:42 GMT
+x-request-nonce:123e4567-e89b-12d3-a456-426614174000
+```
+
+> 注意：
+> - `canonical_query_string` 为空（URL 无 query 参数），所以第四行是空行后的 `vidu`
+> - 每行以 `\n` 结尾，包括最后一行 `HeaderValue` 后面也有 `\n`
+
+### 7.6 代码实现位置
+
+签名验证逻辑封装在 `python-api/app/api/v1/vidu.py`：
+
+- `_build_vidu_signing_string()` — 构建签名字符串
+- `_verify_vidu_callback()` — 完整验证流程（签名 + 防重放）
+- `vidu_callback()` — 在读取请求体前调用 `_verify_vidu_callback()`，验证失败返回 401
+
+---
+
+## 八、接入建议
+
+1. **Vidu 优势**：情绪控制、多音字标注、16 个音色（含精品版）、同步复刻、视频生成
+2. **Vidu 劣势**：没有独立的"查询音色列表"API，音色通过飞书表格维护
+3. **接口类型差异**：
+   - TTS / 声音复刻：**同步接口**，直接返回结果
+   - 视频生成：**异步接口**，需轮询 `GET /tasks/{id}/creations` 或使用 callback
+4. **速度/音量/音调类型**：Vidu 的速度是 **Float**，音量和音调是 **Int**（和 MiniMax 不同，MiniMax 三者都要求 Int）
+5. **前端适配**：语速 slider 范围改为 0.5~2.0；音量改为 0~10；音调改为 -12~12

docs/volcengine-video-caption-api.md

@@ -0,0 +1,201 @@
+# 火山引擎音视频字幕 API 开发文档
+
+> 更新日期: 2026-04-09  
+> 官方文档: https://www.volcengine.com/docs/6561/80907
+
+---
+
+## 产品简介
+
+火山引擎音视频字幕服务提供两种能力：
+
+1. **音视频字幕生成** - 自动识别音频中的语音/歌词，生成带时间轴的字幕
+2. **自动字幕打轴** - 为已有字幕文本自动配上时间轴
+
+---
+
+## 基础信息
+
+| 项目 | 内容 |
+|------|------|
+| 基础 URL | `https://openspeech.bytedance.com/api/v1/vc` |
+| 鉴权 Header | `Authorization: Bearer; {token}` |
+| 文件限制 | ≤200MB, 支持 WAV/M4A/MP3/MP4/MOV/OGG |
+
+---
+
+## API 接口
+
+### 1. 音视频字幕生成
+
+#### 提交任务
+```http
+POST /submit?appid={appid}&language=zh-CN&use_punc=True
+Content-Type: application/json
+Authorization: Bearer; {token}
+
+{"url": "https://example.com/audio.mp3"}
+```
+
+**关键参数:**
+- `language` - 语言: `zh-CN`, `en-US`, `ja-JP`, `ko-KR`, `es-MX`, `ru-RU`, `fr-FR`, `yue`, `wuu`, `nan`, `ug`
+- `caption_type` - 识别类型: `auto`(默认), `speech`, `singing`
+- `use_punc` - 自动标点: `True`, `False`
+- `use_itn` - 数字转换: `True`(中文数字转阿拉伯数字)
+- `words_per_line` - 每行字数, 默认 46
+- `max_lines` - 每屏行数, 默认 1
+
+#### 查询结果
+```http
+GET /query?appid={appid}&id={task_id}&blocking=1
+Authorization: Bearer; {token}
+```
+
+**响应:**
+```json
+{
+    "code": 0,
+    "message": "Success",
+    "duration": 5.32,
+    "utterances": [
+        {
+            "text": "识别文本",
+            "start_time": 0,
+            "end_time": 3197,
+            "words": [
+                {"text": "单字", "start_time": 0, "end_time": 208}
+            ]
+        }
+    ]
+}
+```
+
+---
+
+### 2. 自动字幕打轴
+
+#### 提交任务
+```http
+POST /ata/submit?appid={appid}&caption_type=speech
+Content-Type: application/json
+Authorization: Bearer; {token}
+
+{
+    "url": "https://example.com/audio.mp3",
+    "audio_text": "这是要被打轴的字幕文本"
+}
+```
+
+**参数:**
+- `caption_type` - `speech`(说话) 或 `singing`(歌词)
+- `sta_punc_mode` - 标点模式: `1`(省略句末标点), `2`(空格代替), `3`(保留完整标点)
+
+#### 查询结果
+```http
+GET /ata/query?appid={appid}&id={task_id}&blocking=1
+Authorization: Bearer; {token}
+```
+
+---
+
+## 错误码
+
+| 码 | 含义 | 处理 |
+|----|------|------|
+| 0 | 成功 | - |
+| 2000 | 处理中 | 继续轮询 |
+| 1001 | 参数无效 | 检查必填参数 |
+| 1002 | 无权限 | 检查 token |
+| 1003 | 超频 | 降低调用频率 |
+| 1010 | 音频过长 | 缩短音频 |
+| 1011 | 音频过大 | 压缩音频(<200MB) |
+| 1012 | 格式无效 | 检查音频格式 |
+| 1013 | 音频静音 | 检查音频内容 |
+
+---
+
+## Python 代码示例
+
+```python
+import requests
+import time
+
+TOKEN = "your_token"
+APPID = "your_appid"
+BASE_URL = "https://openspeech.bytedance.com/api/v1/vc"
+
+def submit(audio_url, language="zh-CN", use_punc=True):
+    """提交字幕生成任务"""
+    resp = requests.post(
+        f"{BASE_URL}/submit",
+        params={"appid": APPID, "language": language, "use_punc": str(use_punc)},
+        json={"url": audio_url},
+        headers={"Authorization": f"Bearer; {TOKEN}"}
+    )
+    return resp.json()["id"]
+
+def query(task_id):
+    """查询任务结果"""
+    resp = requests.get(
+        f"{BASE_URL}/query",
+        params={"appid": APPID, "id": task_id, "blocking": "1"},
+        headers={"Authorization": f"Bearer; {TOKEN}"}
+    )
+    return resp.json()
+
+def generate_caption(audio_url, language="zh-CN"):
+    """完整流程: 提交->轮询->返回结果"""
+    task_id = submit(audio_url, language)
+    
+    for _ in range(60):  # 最多轮询60秒
+        result = query(task_id)
+        if result["code"] == 0:
+            return result["utterances"]
+        elif result["code"] != 2000:
+            raise Exception(f"Task failed: {result['message']}")
+        time.sleep(1)
+    
+    raise Exception("Timeout")
+
+def to_srt(utterances):
+    """转换为 SRT 字幕格式"""
+    def ms_to_time(ms):
+        h = ms // 3600000
+        m = (ms % 3600000) // 60000
+        s = (ms % 60000) // 1000
+        ms = ms % 1000
+        return f"{h:02d}:{m:02d}:{s:02d},{ms:03d}"
+    
+    lines = []
+    for i, u in enumerate(utterances, 1):
+        lines.append(f"{i}")
+        lines.append(f"{ms_to_time(u['start_time'])} --> {ms_to_time(u['end_time'])}")
+        lines.append(u['text'])
+        lines.append("")
+    return "\n".join(lines)
+
+# 使用示例
+if __name__ == "__main__":
+    utterances = generate_caption("https://example.com/audio.mp3")
+    srt_content = to_srt(utterances)
+    print(srt_content)
+```
+
+---
+
+## cURL 示例
+
+```bash
+# 1. 提交任务
+TASK_ID=$(curl -s -X POST \
+  -H "Authorization: Bearer; ${TOKEN}" \
+  -H "content-type: application/json" \
+  -d '{"url": "'${AUDIO_URL}'"}' \
+  "https://openspeech.bytedance.com/api/v1/vc/submit?appid=${APPID}&language=zh-CN" \
+  | jq -r '.id')
+
+# 2. 查询结果
+curl -s -X GET \
+  -H "Authorization: Bearer; ${TOKEN}" \
+  "https://openspeech.bytedance.com/api/v1/vc/query?appid=${APPID}&id=${TASK_ID}&blocking=1"
+```

docs/windows-dev-setup.md

@@ -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` 已经装了 |

package.json

@@ -1,27 +0,0 @@
-{
-  "name": "tauri-app",
-  "private": true,
-  "version": "0.1.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "preview": "vite preview",
-    "tauri": "tauri"
-  },
-  "dependencies": {
-    "@tauri-apps/api": "^2",
-    "@tauri-apps/plugin-opener": "^2",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "react-router-dom": "^7.13.1"
-  },
-  "devDependencies": {
-    "@tauri-apps/cli": "^2",
-    "@types/react": "^19.1.8",
-    "@types/react-dom": "^19.1.6",
-    "@vitejs/plugin-react": "^4.6.0",
-    "typescript": "~5.8.3",
-    "vite": "^7.0.4"
-  }
-}

public/tauri.svg

@@ -1,6 +0,0 @@
-<svg width="206" height="231" viewBox="0 0 206 231" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M143.143 84C143.143 96.1503 133.293 106 121.143 106C108.992 106 99.1426 96.1503 99.1426 84C99.1426 71.8497 108.992 62 121.143 62C133.293 62 143.143 71.8497 143.143 84Z" fill="#FFC131"/>
-<ellipse cx="84.1426" cy="147" rx="22" ry="22" transform="rotate(180 84.1426 147)" fill="#24C8DB"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M166.738 154.548C157.86 160.286 148.023 164.269 137.757 166.341C139.858 160.282 141 153.774 141 147C141 144.543 140.85 142.121 140.558 139.743C144.975 138.204 149.215 136.139 153.183 133.575C162.73 127.404 170.292 118.608 174.961 108.244C179.63 97.8797 181.207 86.3876 179.502 75.1487C177.798 63.9098 172.884 53.4021 165.352 44.8883C157.82 36.3744 147.99 30.2165 137.042 27.1546C126.095 24.0926 114.496 24.2568 103.64 27.6274C92.7839 30.998 83.1319 37.4317 75.8437 46.1553C74.9102 47.2727 74.0206 48.4216 73.176 49.5993C61.9292 50.8488 51.0363 54.0318 40.9629 58.9556C44.2417 48.4586 49.5653 38.6591 56.679 30.1442C67.0505 17.7298 80.7861 8.57426 96.2354 3.77762C111.685 -1.01901 128.19 -1.25267 143.769 3.10474C159.348 7.46215 173.337 16.2252 184.056 28.3411C194.775 40.457 201.767 55.4101 204.193 71.404C206.619 87.3978 204.374 103.752 197.73 118.501C191.086 133.25 180.324 145.767 166.738 154.548ZM41.9631 74.275L62.5557 76.8042C63.0459 72.813 63.9401 68.9018 65.2138 65.1274C57.0465 67.0016 49.2088 70.087 41.9631 74.275Z" fill="#FFC131"/>
-<path fill-rule="evenodd" clip-rule="evenodd" d="M38.4045 76.4519C47.3493 70.6709 57.2677 66.6712 67.6171 64.6132C65.2774 70.9669 64 77.8343 64 85.0001C64 87.1434 64.1143 89.26 64.3371 91.3442C60.0093 92.8732 55.8533 94.9092 51.9599 97.4256C42.4128 103.596 34.8505 112.392 30.1816 122.756C25.5126 133.12 23.9357 144.612 25.6403 155.851C27.3449 167.09 32.2584 177.598 39.7906 186.112C47.3227 194.626 57.153 200.784 68.1003 203.846C79.0476 206.907 90.6462 206.743 101.502 203.373C112.359 200.002 122.011 193.568 129.299 184.845C130.237 183.722 131.131 182.567 131.979 181.383C143.235 180.114 154.132 176.91 164.205 171.962C160.929 182.49 155.596 192.319 148.464 200.856C138.092 213.27 124.357 222.426 108.907 227.222C93.458 232.019 76.9524 232.253 61.3736 227.895C45.7948 223.538 31.8055 214.775 21.0867 202.659C10.3679 190.543 3.37557 175.59 0.949823 159.596C-1.47592 143.602 0.768139 127.248 7.41237 112.499C14.0566 97.7497 24.8183 85.2327 38.4045 76.4519ZM163.062 156.711L163.062 156.711C162.954 156.773 162.846 156.835 162.738 156.897C162.846 156.835 162.954 156.773 163.062 156.711Z" fill="#24C8DB"/>
-</svg>

public/vite.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

python-api/.dockerignore

@@ -0,0 +1,99 @@
+# =============================================================================
+# 美家卡智影 API - Docker 构建上下文排除列表
+# =============================================================================
+
+# --- Git ---
+.git/
+.gitignore
+.gitattributes
+
+# --- 环境变量（安全）---
+.env
+.env.*
+.env.local
+.env.example
+
+# --- Python 虚拟环境 ---
+venv/
+env/
+ENV/
+.venv/
+
+# --- Python 缓存 ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# --- 测试与覆盖率 ---
+tests/
+.coverage
+htmlcov/
+.tox/
+
+# --- IDE / 编辑器 ---
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# --- 本地数据库与缓存 ---
+*.db
+*.sqlite3
+meijiaka.db
+dump.rdb
+celerybeat-schedule
+.qiniu_pythonsdk_hostscache.json
+
+# --- 日志 ---
+*.log
+logs/
+
+# --- Docker 自身 ---
+Dockerfile
+docker-compose.yml
+docker-compose.*.yml
+.dockerignore
+
+# --- 部署脚本（仅本地使用）---
+deploy-test.sh
+scripts/upload_release.py
+
+# --- 文档 ---
+README.md
+
+# --- 临时/数据目录 ---
+data/
+local/
+temp/
+tmp/
+
+# --- 开发配置 ---
+.pre-commit-config.yaml
+.python-version
+uv.lock
+
+# --- Alembic 迁移版本（如不需要在容器内执行迁移可忽略）---
+# 注：若需在容器内运行 alembic upgrade，请注释掉下面这行
+# alembic/versions/

python-api/.env.example

@@ -0,0 +1,82 @@
+# 美家卡智影 API - 环境变量配置示例
+# ================================
+# 复制此文件为 .env 并填写实际值
+
+# === 基础配置 ===
+APP_NAME=美家卡智影 API
+APP_VERSION=1.6.7
+# ⚠️ 生产环境必须设为 false
+DEBUG=true
+ENV=development
+HOST=0.0.0.0
+PORT=8000
+
+# === 服务器地址 ===
+# 不配置时自动根据 ENV 推断：production→tapi.meijiaka.cn, staging→dev.tapi.meijiaka.cn
+# APP_BASE_URL=https://dev.tapi.meijiaka.cn
+
+# === 数据库配置 ===
+# 本地开发: localhost
+# Docker 部署: 容器名（如 db、meijiaka-db）
+DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/meijiaka_zy
+
+# === Redis 配置 ===
+# 本地开发: localhost
+# Docker 部署: 容器名（如 redis、meijiaka-redis）
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_DB=0
+# REDIS_PASSWORD=    # 如无密码请留空或注释
+
+# === JWT 安全配置 ===
+# 生产环境必须修改为强随机密钥（至少 32 位）
+SECRET_KEY=dev-secret-key-change-me
+ALGORITHM=HS256
+
+# === CORS 配置 ===
+# 本地开发: 允许 localhost
+# 测试/生产服: 填写实际域名，如 https://app.yourdomain.com
+CORS_ORIGINS=http://localhost:1420,http://127.0.0.1:1420,http://localhost:8080,tauri://localhost,http://tauri.localhost,https://tauri.localhost
+
+# === AI 平台配置 ===
+
+# 火山方舟
+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
+
+# === 七牛云存储（空镜图片上传）===
+QINIU_ACCESS_KEY=your-qiniu-access-key
+QINIU_SECRET_KEY=your-qiniu-secret-key
+QINIU_VIDEO_BUCKET=media-liche
+QINIU_VIDEO_DOMAIN=media.liche.cn
+QINIU_IMAGE_BUCKET=img-liche
+QINIU_IMAGE_DOMAIN=img.liche.cn
+
+# === 微信支付（APIv2）===
+# ⚠️ P0 必填 — 充值功能依赖以下 4 项，未配置则微信支付完全不可用
+WXPAY_MCHID=your-mchid
+WXPAY_APPID=your-wx-appid
+WXPAY_API_KEY=your-api-key
+WXPAY_NOTIFY_URL=https://your-domain.com/api/v1/points/recharge/notify
+
+# === B2M 短信平台 ===
+# ⚠️ P0 必填 — 未配置时 SMS 降级为仅打印日志（开发可用，测试/生产不可用）
+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=ERROR

python-api/.gitignore

@@ -0,0 +1,75 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+env/
+ENV/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Database
+*.db
+*.sqlite3
+
+# Logs
+*.log
+logs/
+
+# Test coverage
+htmlcov/
+.coverage
+.pytest_cache/
+.tox/
+
+# Alembic 迁移（保留脚本，忽略临时文件）
+alembic/versions/*.pyc
+
+# Celery
+celerybeat-schedule
+
+# Redis
+dump.rdb
+
+# Docker
+!.dockerignore
+
+# Local development
+local/
+temp/
+tmp/
+
+# Data files
+data/
+

python-api/.pre-commit-config.yaml

@@ -0,0 +1,53 @@
+# 美家卡智影 - Git 钩子配置
+# 安装: pre-commit install
+# 手动运行: pre-commit run --all-files
+
+repos:
+  # 代码格式化
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+        language_version: python3.13
+
+  # 代码检查
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+
+  # 类型检查（暂时禁用：326 个历史遗留类型错误待修复）
+  # - repo: https://github.com/pre-commit/mirrors-mypy
+  #   rev: v1.14.0
+  #   hooks:
+  #     - id: mypy
+  #       additional_dependencies: [types-PyYAML]
+
+  # 安全扫描
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.0
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml"]
+        additional_dependencies: ["bandit[toml]"]
+
+  # 依赖锁定文件同步检查
+  - repo: local
+    hooks:
+      - id: uv-lock-check
+        name: Check uv lock file is up-to-date
+        entry: bash -c 'uv pip compile pyproject.toml -o requirements.lock --locked'
+        language: system
+        files: ^(pyproject\.toml|requirements\.lock)$
+        pass_filenames: false
+
+  # 模型表名前缀一致性检查
+  - repo: local
+    hooks:
+      - id: table-prefix-check
+        name: Check model __tablename__ has mjk_ prefix
+        entry: python scripts/check_table_prefix.py
+        language: system
+        files: ^app/models/.*\.py$
+        pass_filenames: false

python-api/.qiniu_pythonsdk_hostscache.json

@@ -0,0 +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": 1779898302}, "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}}

python-api/Dockerfile

@@ -0,0 +1,49 @@
+# 美家卡智影 API - Docker 镜像
+# ===========================================
+# 配置 Docker 镜像加速后，基础镜像 python:3.13-slim 会自动走加速源
+
+FROM python:3.13-slim AS builder
+
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy \
+    UV_PYTHON_DOWNLOADS=never
+
+WORKDIR /app
+
+# 安装 uv（pip 走 PyPI，通常国内服务器能访问；如果也慢可换阿里源）
+RUN pip install --no-cache-dir -i https://mirrors.aliyun.com/pypi/simple/ uv
+
+# 先复制锁定文件，利用 Docker 缓存层
+COPY requirements.lock pyproject.toml ./
+
+# 创建虚拟环境并安装依赖
+RUN uv venv /opt/venv && \
+    uv pip sync --index-url https://mirrors.aliyun.com/pypi/simple/ --python /opt/venv/bin/python requirements.lock
+
+# 复制应用代码并安装
+COPY app/ ./app/
+RUN uv pip install --index-url https://mirrors.aliyun.com/pypi/simple/ --python /opt/venv/bin/python --no-deps -e .
+
+# ===== 生产镜像 =====
+FROM python:3.13-slim AS production
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PATH="/opt/venv/bin:$PATH"
+
+# 从 builder 复制虚拟环境
+COPY --from=builder /opt/venv /opt/venv
+
+WORKDIR /app
+
+# 复制应用代码和配置
+COPY app/ ./app/
+COPY config/ ./config/
+COPY scripts/ ./scripts/
+COPY alembic.ini .
+COPY alembic/ ./alembic/
+COPY pyproject.toml .
+
+EXPOSE 8000
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--no-access-log"]

python-api/Makefile

@@ -0,0 +1,144 @@
+# 美家卡智影 API - 常用命令
+# ==========================
+
+.PHONY: help install dev install-hooks update-lock lint format test security clean docker
+
+help: ## 显示帮助信息
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+# ========== 依赖管理 ==========
+
+install: ## 安装生产依赖（使用 lock 文件）
+	uv pip sync requirements.lock
+
+dev: ## 安装开发依赖（包含 dev extras）
+	uv pip install -e ".[dev]"
+	pre-commit install
+
+install-hooks: ## 安装 Git pre-commit 钩子
+	pre-commit install
+
+update-lock: ## 更新 requirements.lock（修改 pyproject.toml 后执行）
+	uv pip compile pyproject.toml -o requirements.lock --upgrade
+
+update-lock-no-upgrade: ## 重新生成 lock 文件（不升级版本）
+	uv pip compile pyproject.toml -o requirements.lock
+
+# ========== 代码质量 ==========
+
+lint: ## 运行代码检查 (ruff + mypy)
+	ruff check app/
+	mypy app/
+
+format: ## 格式化代码 (black + ruff)
+	black app/
+	ruff check --fix app/
+
+format-check: ## 检查代码格式（不修改）
+	black --check app/
+	ruff check app/
+
+# ========== 测试 ==========
+
+test: ## 运行测试
+	pytest -v
+
+test-cov: ## 运行测试并生成覆盖率报告
+	pytest --cov=app --cov-report=html --cov-report=term
+
+# ========== 安全扫描 ==========
+
+security: ## 运行安全扫描 (bandit + pip-audit)
+	@echo "🔍 运行 Bandit 安全扫描..."
+	bandit -r app/ -c pyproject.toml
+	@echo "🔍 运行依赖漏洞扫描..."
+	pip-audit
+
+# ========== 开发服务器 ==========
+
+run: ## 启动开发服务器
+	uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+
+scheduler: ## 启动 Async Engine Scheduler
+	python -m app.scheduler.main
+
+# ========== Docker ==========
+# ⚠️ 注意：db + redis 是共享基础设施（另一个项目管理），
+# 当前项目只管理 api + scheduler，禁止用 docker-compose down。
+
+docker: ## 构建 Docker 镜像
+	docker build -t meijiaka-api:latest .
+
+docker-run: ## 启动 api + scheduler（共享 db/redis，不动基础设施）
+	docker-compose -p meijiaka-zj up -d
+
+docker-rebuild: ## 强制重建 api + scheduler（代码更新后使用）
+	docker-compose -p meijiaka-zj up -d --build --force-recreate api scheduler
+
+docker-stop: ## 停止 api + scheduler（保留 db/redis）
+	docker-compose -p meijiaka-zj down
+
+docker-rm: ## 删除 api + scheduler 容器（保留 db/redis）
+	docker-compose -p meijiaka-zj rm -f
+
+docker-logs: ## 查看 Docker 日志
+	docker-compose logs -f
+
+docker-logs-api: ## 查看 api 日志
+	docker-compose logs -f api
+
+docker-logs-scheduler: ## 查看 scheduler 日志
+	docker-compose logs -f scheduler
+
+# ========== 清理 ==========
+
+clean: ## 清理缓存文件
+	find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete 2>/dev/null || true
+	find . -type d -name ".pytest_cache" -exec rm -rf {} + 2>/dev/null || true
+	find . -type d -name ".mypy_cache" -exec rm -rf {} + 2>/dev/null || true
+	rm -rf htmlcov/ .coverage 2>/dev/null || true
+
+# ========== 语义层防护网 ==========
+
+lint-semantic: ## 语义层禁词检查（防止供应商术语泄漏到业务层）
+	@echo "🔍 检查 Layer 3+ 是否泄漏供应商术语..."
+	@# API 层禁止 element_id 作为字段/参数名
+	@errs=$$(grep -rn 'element_id' app/api --include='*.py' \
+		| grep -v 'provider_element_id' \
+		| grep -v '__pycache__' \
+		| grep -v '#' \
+		| grep -v '".*element_id.*"' \
+		| grep -v "'.*element_id.*'"); \
+	if [ -n "$$errs" ]; then \
+		echo "$$errs"; \
+		echo "❌ API 层发现 element_id（应使用 provider_element_id 或 human_id）"; \
+		exit 1; \
+	fi
+	@# Scheduler 层禁止 task_id 作为内部变量/Redis key（读取 Provider 返回除外）
+	@errs=$$(grep -rn '\btask_id\b' app/scheduler --include='*.py' \
+		| grep -v 'job_id' \
+		| grep -v '__pycache__' \
+		| grep -v '\.get("task_id")' \
+		| grep -v 'result.get("task_id")' \
+		| grep -v 'task_type' \
+		| grep -v '"task_id"' \
+		| grep -v "'task_id'"); \
+	if [ -n "$$errs" ]; then \
+		echo "$$errs"; \
+		echo "❌ Scheduler 层发现 task_id（应使用 job_id）"; \
+		exit 1; \
+	fi
+	@# Scheduler 层 Redis key 必须使用 job: 而非 task:
+	@errs=$$(grep -rn 'redis.*task:' app/scheduler --include='*.py' \
+		| grep -v '__pycache__'); \
+	if [ -n "$$errs" ]; then \
+		echo "$$errs"; \
+		echo "❌ Scheduler Redis key 使用 task:（应使用 job:）"; \
+		exit 1; \
+	fi
+	@echo "✅ 语义层检查通过"
+
+# ========== CI 检查 ==========
+
+ci: format-check lint lint-semantic test security ## 运行所有 CI 检查

python-api/README.md

@@ -0,0 +1,187 @@
+# 美家卡智影 API
+
+美家卡智影后端服务 - 基于 FastAPI + Redis 的 AI 视频创作 API。
+
+## 技术栈
+
+| 组件 | 技术 | 版本 |
+|------|------|------|
+| Web 框架 | FastAPI | ^0.110.0 |
+| 数据库 | PostgreSQL | 15+ |
+| ORM | SQLAlchemy | 2.0+ (异步) |
+| 缓存/状态 | Redis | 7.x |
+| 异步调度 | Async Engine (Slot Scheduler) | Python asyncio |
+| 部署 | Docker + Docker Compose | - |
+
+## 快速开始
+
+### 1. 环境准备
+
+确保已安装：
+- Python 3.11+
+- Docker & Docker Compose（推荐）
+- 或本地 PostgreSQL + Redis
+
+### 2. 使用 Docker Compose 启动（推荐）
+
+```bash
+# 1. 克隆项目后进入目录
+cd python-api
+
+# 2. 复制环境变量配置
+cp .env.example .env
+
+# 3. 启动所有服务
+docker-compose up -d
+
+# 4. 查看日志
+docker-compose logs -f api
+
+# 5. 服务地址
+# API: http://localhost:8080
+# 文档: http://localhost:8080/docs
+```
+
+### 3. 本地开发
+
+```bash
+# 1. 创建虚拟环境
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+
+# 2. 安装依赖
+pip install -e ".[dev]"
+
+# 3. 配置环境变量
+cp .env.example .env
+# 编辑 .env，修改数据库连接等配置
+
+# 4. 启动 PostgreSQL 和 Redis（Docker）
+docker-compose up -d db redis
+
+# 5. 启动开发服务器
+uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+
+# 7. 启动 Async Engine Scheduler（另开终端）
+python -m app.scheduler.main
+```
+
+## 项目结构
+
+```
+python-api/
+├── app/                    # 主应用代码
+│   ├── api/v1/            # API 路由
+│   ├── core/              # 核心工具（安全、异常）
+│   ├── db/                # 数据库配置
+│   ├── models/            # SQLAlchemy 模型
+│   ├── schemas/           # Pydantic Schema
+│   ├── services/          # 业务逻辑
+│   ├── scheduler/         # Async Engine 异步任务调度
+│   ├── ai/                # AI 模型相关
+│   ├── utils/             # 工具函数
+│   ├── config.py          # 配置管理
+│   └── main.py            # FastAPI 入口
+├── docker-compose.yml     # Docker 编排
+├── Dockerfile             # Docker 镜像
+├── pyproject.toml         # 项目依赖
+└── README.md              # 本文档
+```
+
+## 数据模型
+
+### 核心实体
+
+- **User** - 用户/设备（设备 ID + JWT 认证）
+- **Project** - 视频创作项目
+- **ScriptSegment** - 脚本分镜
+- **MediaAsset** - 媒体元数据（音频/视频/封面）
+- **TaskQueue** - 异步任务队列
+
+## API 路由
+
+| 模块 | 接口 | 说明 |
+|------|------|------|
+| **auth** | `POST /auth/send-code` | 发送验证码 |
+| | `POST /auth/login` | 登录 |
+| | `POST /auth/refresh` | 刷新 Token |
+| | `POST /auth/logout` | 登出 |
+| | `GET /auth/me` | 获取用户信息 |
+| | `PATCH /auth/me` | 更新用户信息 |
+| **system** | `GET /system/version` | 版本信息 |
+| **events** | `GET /events` | SSE 事件流 |
+| **tasks** | `POST /tasks/{type}` | 创建异步任务 |
+| | `GET /tasks` | 任务列表 |
+| | `GET /tasks/{id}` | 任务状态 |
+| | `GET /tasks/{id}/result` | 任务结果 |
+| **script** | `GET /script/categories` | 脚本分类 |
+| | `POST /script/polish` | 文案润色 |
+| | `POST /script/generate-title` | 生成标题 |
+| **voice** | `GET /voice/voices` | 音色列表 |
+| | `POST /voice/synthesize` | TTS 合成 |
+| | `POST /voice/clone/submit` | 提交声音复刻 |
+| | `GET /voice/clone/query/{id}` | 查询复刻状态 |
+| **caption** | `POST /caption/ata/align` | 自动字幕打轴 |
+| **upload** | `POST /upload/video` | 上传视频 |
+| | `POST /upload/audio` | 上传音频 |
+| **vidu** | `POST /vidu/callback` | Vidu 回调 |
+| **materials** | `POST /materials/match` | 素材匹配 |
+| | `POST /materials/batch-match` | 批量素材匹配 |
+| **cover** | `GET /cover-backgrounds` | 封面背景图 |
+| **points** | `GET /points/balance` | 积分余额 |
+| | `GET /points/transactions` | 积分流水 |
+| | `POST /points/recharge` | 创建充值订单 |
+| | `POST /points/recharge/notify` | 微信支付回调 |
+| | `GET /points/recharge/query/{id}` | 查询充值订单 |
+| | `GET /points/recharge-options` | 充值档位 |
+| | `GET /points/chargeable-types` | 扣费业务类型 |
+| | `GET /points/rules` | 积分计费规则 |
+| | `POST /points/consume` | 消费积分 |
+
+## 环境变量
+
+见 `.env.example`，主要配置项：
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `DATABASE_URL` | PostgreSQL 连接字符串 | `postgresql+asyncpg://postgres:postgres@localhost:5432/meijiaka_zy` |
+| `REDIS_URL` | Redis 连接字符串 | `redis://localhost:6379/0` |
+| `SECRET_KEY` | JWT 签名密钥 | 必须修改 |
+| `OPENAI_API_KEY` | OpenAI API Key | - |
+| `CORS_ORIGINS` | 允许的跨域来源 | `http://localhost:1420` |
+
+## 开发规范
+
+### 代码风格
+
+```bash
+# 格式化
+black app/
+
+# 检查
+ruff check app/
+mypy app/
+
+# 测试
+pytest
+```
+
+### 提交规范
+
+- `feat:` 新功能
+- `fix:` 修复
+- `docs:` 文档
+- `refactor:` 重构
+- `test:` 测试
+
+## 与前端集成
+
+Tauri 前端默认连接 `http://127.0.0.1:8080/api/v1`。
+
+云端部署后：
+1. 修改前端 `src/api/client.ts` 中的 `PYTHON_API_BASE_URL`
+2. 更新 `tauri.conf.json` CSP 配置，添加云端域名到 `connect-src`
+
+## 许可
+
+MIT

python-api/alembic.ini

@@ -0,0 +1,150 @@
+# A generic, single database configuration.
+
+[alembic]
+# path to migration scripts.
+# this is typically a path given in POSIX (e.g. forward slashes)
+# format, relative to the token %(here)s which refers to the location of this
+# ini file
+script_location = %(here)s/alembic
+
+# template used to generate migration file names; The default value is %%(rev)s_%%(slug)s
+# Uncomment the line below if you want the files to be prepended with date and time
+# see https://alembic.sqlalchemy.org/en/latest/tutorial.html#editing-the-ini-file
+# for all available tokens
+# file_template = %%(year)d_%%(month).2d_%%(day).2d_%%(hour).2d%%(minute).2d-%%(rev)s_%%(slug)s
+# Or organize into date-based subdirectories (requires recursive_version_locations = true)
+# file_template = %%(year)d/%%(month).2d/%%(day).2d_%%(hour).2d%%(minute).2d_%%(second).2d_%%(rev)s_%%(slug)s
+
+# sys.path path, will be prepended to sys.path if present.
+# defaults to the current working directory.  for multiple paths, the path separator
+# is defined by "path_separator" below.
+prepend_sys_path = .
+
+
+# timezone to use when rendering the date within the migration file
+# as well as the filename.
+# If specified, requires the tzdata library which can be installed by adding
+# `alembic[tz]` to the pip requirements.
+# string value is passed to ZoneInfo()
+# leave blank for localtime
+# timezone =
+
+# max length of characters to apply to the "slug" field
+# truncate_slug_length = 40
+
+# set to 'true' to run the environment during
+# the 'revision' command, regardless of autogenerate
+# revision_environment = false
+
+# set to 'true' to allow .pyc and .pyo files without
+# a source .py file to be detected as revisions in the
+# versions/ directory
+# sourceless = false
+
+# version location specification; This defaults
+# to <script_location>/versions.  When using multiple version
+# directories, initial revisions must be specified with --version-path.
+# The path separator used here should be the separator specified by "path_separator"
+# below.
+# version_locations = %(here)s/bar:%(here)s/bat:%(here)s/alembic/versions
+
+# path_separator; This indicates what character is used to split lists of file
+# paths, including version_locations and prepend_sys_path within configparser
+# files such as alembic.ini.
+# The default rendered in new alembic.ini files is "os", which uses os.pathsep
+# to provide os-dependent path splitting.
+#
+# Note that in order to support legacy alembic.ini files, this default does NOT
+# take place if path_separator is not present in alembic.ini.  If this
+# option is omitted entirely, fallback logic is as follows:
+#
+# 1. Parsing of the version_locations option falls back to using the legacy
+#    "version_path_separator" key, which if absent then falls back to the legacy
+#    behavior of splitting on spaces and/or commas.
+# 2. Parsing of the prepend_sys_path option falls back to the legacy
+#    behavior of splitting on spaces, commas, or colons.
+#
+# Valid values for path_separator are:
+#
+# path_separator = :
+# path_separator = ;
+# path_separator = space
+# path_separator = newline
+#
+# Use os.pathsep. Default configuration used for new projects.
+path_separator = os
+
+# set to 'true' to search source files recursively
+# in each "version_locations" directory
+# new in Alembic version 1.10
+# recursive_version_locations = false
+
+# the output encoding used when revision files
+# are written from script.py.mako
+# output_encoding = utf-8
+
+# database URL.  This is consumed by the user-maintained env.py script only.
+# other means of configuring database URLs may be customized within the env.py
+# file.
+# 数据库 URL 从环境变量读取，在 env.py 中设置
+# sqlalchemy.url = postgresql://user:pass@localhost/dbname
+
+
+[post_write_hooks]
+# post_write_hooks defines scripts or Python functions that are run
+# on newly generated revision scripts.  See the documentation for further
+# detail and examples
+
+# format using "black" - use the console_scripts runner, against the "black" entrypoint
+# hooks = black
+# black.type = console_scripts
+# black.entrypoint = black
+# black.options = -l 79 REVISION_SCRIPT_FILENAME
+
+# lint with attempts to fix using "ruff" - use the module runner, against the "ruff" module
+# hooks = ruff
+# ruff.type = module
+# ruff.module = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Alternatively, use the exec runner to execute a binary found on your PATH
+# hooks = ruff
+# ruff.type = exec
+# ruff.executable = ruff
+# ruff.options = check --fix REVISION_SCRIPT_FILENAME
+
+# Logging configuration.  This is also consumed by the user-maintained
+# env.py script only.
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARNING
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARNING
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

python-api/alembic/README

@@ -0,0 +1 @@
+Generic single-database configuration.

python-api/alembic/env.py

@@ -0,0 +1,86 @@
+"""
+Alembic 环境配置 - PostgreSQL
+"""
+
+import os
+import sys
+from logging.config import fileConfig
+
+from sqlalchemy import engine_from_config, pool
+
+from alembic import context
+
+# 添加项目路径
+sys.path.insert(0, os.path.dirname(os.path.dirname(__file__)))
+
+# 加载环境变量
+from dotenv import load_dotenv
+
+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
+
+# this is the Alembic Config object
+config = context.config
+
+# 从环境变量读取数据库 URL
+database_url = os.getenv("DATABASE_URL")
+if database_url:
+    # 将 asyncpg 转换为 psycopg2 用于 alembic (同步)
+    sync_database_url = database_url.replace("+asyncpg", "")
+    config.set_main_option("sqlalchemy.url", sync_database_url)
+
+# 设置日志
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+# 模型元数据
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode."""
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    """Run migrations in 'online' mode."""
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata)
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

python-api/alembic/script.py.mako

@@ -0,0 +1,28 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    ${downgrades if downgrades else "pass"}

python-api/alembic/versions/100366516fbd_add_url_to_bgm_music.py

@@ -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')

python-api/alembic/versions/7149f61a2f9c_make_bgm_music_url_non_nullable.py

@@ -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',
+    )

python-api/alembic/versions/7172a476e5b2_add_bgm_music_table.py

@@ -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 ###

python-api/alembic/versions/7d855b38fe83_add_filename_to_release_package_unique_.py

@@ -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']
+    )

python-api/alembic/versions/8d901bc90e67_rename_mjk_release_packages_to_mjk_app_.py

@@ -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")

python-api/alembic/versions/c3a0e1c71ce6_initial_schema.py

@@ -0,0 +1,215 @@
+"""initial_schema
+
+Revision ID: c3a0e1c71ce6
+Revises: 
+Create Date: 2026-05-15 17:31:52.560351
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+from sqlalchemy.dialects import postgresql
+
+# revision identifiers, used by Alembic.
+revision: str = 'c3a0e1c71ce6'
+down_revision: Union[str, Sequence[str], None] = None
+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_app_releases',
+    sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+    sa.Column('version', sa.String(length=20), nullable=False),
+    sa.Column('release_date', sa.DateTime(timezone=True), nullable=False),
+    sa.Column('notes', sa.Text(), nullable=False),
+    sa.Column('mandatory', sa.Boolean(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.PrimaryKeyConstraint('id')
+    )
+    op.create_index(op.f('ix_mjk_app_releases_version'), 'mjk_app_releases', ['version'], unique=True)
+    op.create_table('mjk_broll_categories',
+    sa.Column('slug', sa.String(length=128), nullable=False, comment='分类标识符，URL友好格式'),
+    sa.Column('name', sa.String(length=256), nullable=False, comment='分类中文名称，三级分类直接对应 scene 标准化后的值'),
+    sa.Column('parent_id', sa.BigInteger(), nullable=True, comment='父分类ID，NULL 表示根分类（一级）'),
+    sa.Column('level', sa.BigInteger(), nullable=False, comment='层级：1=一级（大阶段），2=二级（工序），3=三级（场景）'),
+    sa.Column('sort_order', sa.BigInteger(), nullable=False, comment='排序权重，装修流程有先后顺序'),
+    sa.Column('status', sa.String(length=16), nullable=False, comment='状态：active（启用）/ disabled（停用）/ deleted（软删除）'),
+    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.ForeignKeyConstraint(['parent_id'], ['mjk_broll_categories.id'], ),
+    sa.PrimaryKeyConstraint('id'),
+    sa.UniqueConstraint('slug')
+    )
+    op.create_table('mjk_broll_tags',
+    sa.Column('name', sa.String(length=64), nullable=False, comment='标签名称，如 近景、白天、水管'),
+    sa.Column('category', sa.String(length=32), nullable=True, comment='标签维度：scene（场景）/ element（元素）/ style（风格）/ mood（情绪）/ time（时间）'),
+    sa.Column('sort_order', sa.Integer(), nullable=False, comment='排序权重'),
+    sa.Column('status', sa.String(length=16), nullable=False, comment='状态：active（启用）/ disabled（停用）'),
+    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'),
+    sa.UniqueConstraint('name')
+    )
+    op.create_table('mjk_cover_backgrounds',
+    sa.Column('script_code', sa.String(length=64), nullable=False, comment='关联脚本大类 code，如 bk（装修避坑）'),
+    sa.Column('title', sa.String(length=256), nullable=False, comment='背景图名称，运营识别用'),
+    sa.Column('url', sa.String(length=1024), nullable=False, comment='七牛云 CDN 图片地址'),
+    sa.Column('sort_order', sa.BigInteger(), nullable=False, comment='排序权重，数字越小越靠前'),
+    sa.Column('status', sa.String(length=16), nullable=False, comment='状态：active（启用）/ disabled（停用）/ deleted（软删除）'),
+    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_table('mjk_point_batches',
+    sa.Column('user_id', sa.UUID(), nullable=False, comment='用户 ID'),
+    sa.Column('amount', sa.Integer(), nullable=False, comment='初始积分'),
+    sa.Column('remaining', sa.Integer(), nullable=False, comment='剩余可用积分'),
+    sa.Column('expired_at', sa.DateTime(timezone=True), nullable=False, comment='过期时间（created_at + 180 天）'),
+    sa.Column('source', sa.String(length=32), nullable=False, comment='来源：wxpay / invite / gift / compensation'),
+    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_table('mjk_point_recharge_orders',
+    sa.Column('user_id', sa.UUID(), nullable=False, comment='用户 ID'),
+    sa.Column('points', sa.Integer(), nullable=False, comment='充值积分数'),
+    sa.Column('amount_rmb', sa.Integer(), nullable=False, comment='人民币金额（单位：分，如 500 = 5 元）'),
+    sa.Column('out_trade_no', sa.String(length=64), nullable=True, comment='商户订单号（传给微信的 out_trade_no）'),
+    sa.Column('prepay_id', sa.String(length=64), nullable=True, comment='微信预支付会话标识（统一下单返回）'),
+    sa.Column('wx_order_no', sa.String(length=64), nullable=True, comment='微信支付订单号（微信侧唯一标识）'),
+    sa.Column('openid', sa.String(length=64), nullable=True, comment='用户微信 OpenID（统一下单必需）'),
+    sa.Column('client_ip', sa.String(length=45), nullable=True, comment='用户下单时的 IP 地址'),
+    sa.Column('trade_type', sa.String(length=16), nullable=True, comment='交易类型：JSAPI / NATIVE / APP'),
+    sa.Column('status', sa.String(length=20), nullable=False, comment='订单状态：pending / paid / failed / closed'),
+    sa.Column('paid_at', sa.DateTime(timezone=True), nullable=True, comment='支付成功时间'),
+    sa.Column('closed_at', sa.DateTime(timezone=True), nullable=True, comment='订单关闭时间（超时未支付）'),
+    sa.Column('request_params', sa.Text(), nullable=True, comment='统一下单请求参数（JSON 格式，用于排查请求侧问题）'),
+    sa.Column('request_response', sa.Text(), nullable=True, comment='统一下单响应内容（JSON 格式，用于排查微信返回）'),
+    sa.Column('notify_raw', sa.Text(), nullable=True, comment='微信回调原始内容（XML/JSON，用于排查回调问题）'),
+    sa.Column('notify_verified', sa.Boolean(), nullable=False, comment='回调签名是否验证通过'),
+    sa.Column('query_result', sa.Text(), nullable=True, comment='主动查询订单结果（JSON 格式，用于二次确认）'),
+    sa.Column('error_code', sa.String(length=32), nullable=True, comment='错误码（微信返回或系统异常）'),
+    sa.Column('error_msg', sa.Text(), nullable=True, 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'),
+    sa.UniqueConstraint('out_trade_no')
+    )
+    op.create_table('mjk_point_transactions',
+    sa.Column('user_id', sa.UUID(), nullable=False, comment='用户 ID'),
+    sa.Column('type', sa.String(length=20), nullable=False, comment='变动类型：recharge / consume / expire / refund'),
+    sa.Column('amount', sa.Integer(), nullable=False, comment='变动数量（正数）'),
+    sa.Column('balance_before', sa.Integer(), nullable=False, comment='变动前总余额'),
+    sa.Column('balance_after', sa.Integer(), nullable=False, comment='变动后总余额'),
+    sa.Column('source_type', sa.String(length=32), nullable=True, comment='消费来源类型：script / polish / voice_clone / tts / video'),
+    sa.Column('source_id', sa.String(length=64), nullable=True, comment='关联的任务 ID 或订单 ID'),
+    sa.Column('batch_id', sa.BigInteger(), nullable=True, comment='关联的积分批次 ID（消费时记录从哪个批次扣）'),
+    sa.Column('duration', sa.Float(), nullable=True, comment='时长（秒），按秒计费业务记录'),
+    sa.Column('category', sa.String(length=32), nullable=True, comment='业务分类：脚本生成 / 配音合成 / 视频生成 / 压制成片 / 字幕烧录 / 封面设计 / 充值'),
+    sa.Column('description', sa.Text(), nullable=True, 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_table('mjk_user_devices',
+    sa.Column('user_id', sa.UUID(), nullable=False, comment='用户 ID（唯一约束，强制单设备登录）'),
+    sa.Column('device_id', sa.String(length=64), nullable=False, comment='设备唯一标识（前端生成）'),
+    sa.Column('device_name', sa.String(length=128), nullable=True, comment="设备名称（如 'MacBook Pro'）"),
+    sa.Column('os_info', sa.String(length=128), nullable=True, comment='操作系统信息'),
+    sa.Column('app_version', sa.String(length=32), nullable=True, comment='应用版本号'),
+    sa.Column('refresh_token_hash', sa.String(length=64), nullable=True, comment='Refresh Token SHA256 哈希（用于校验和撤销）'),
+    sa.Column('last_active_at', sa.DateTime(timezone=True), 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'),
+    sa.UniqueConstraint('user_id')
+    )
+    op.create_table('mjk_user_points',
+    sa.Column('user_id', sa.UUID(), nullable=False, comment='用户 ID'),
+    sa.Column('balance', sa.Integer(), nullable=False, comment='当前积分余额（允许欠费为负）'),
+    sa.Column('total_recharged', sa.Integer(), nullable=False, comment='累计充值积分'),
+    sa.Column('total_consumed', sa.Integer(), nullable=False, comment='累计消费积分'),
+    sa.Column('total_expired', 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'),
+    sa.UniqueConstraint('user_id')
+    )
+    op.create_table('mjk_users',
+    sa.Column('mobile', sa.String(length=20), nullable=False, comment='手机号，登录账号'),
+    sa.Column('password_hash', sa.String(length=255), nullable=True, comment='密码哈希（bcrypt），预留字段'),
+    sa.Column('status', sa.String(length=20), nullable=False, comment='账号状态'),
+    sa.Column('nickname', sa.String(length=64), nullable=True, comment='用户昵称'),
+    sa.Column('avatar_url', sa.Text(), nullable=True, comment='头像 URL'),
+    sa.Column('source', sa.String(length=32), nullable=False, comment='注册来源'),
+    sa.Column('invited_by', sa.String(length=36), nullable=True, comment='邀请人 user_id'),
+    sa.Column('last_login_at', sa.DateTime(timezone=True), nullable=True, comment='最后登录时间'),
+    sa.Column('last_login_ip', sa.String(length=45), nullable=True, comment='最后登录 IP（IPv6 最大 45 字符）'),
+    sa.Column('deleted_at', sa.DateTime(timezone=True), nullable=True, comment='注销时间（软删除标记）'),
+    sa.Column('extra', postgresql.JSONB(astext_type=sa.Text()), nullable=False, comment='冗余字段，备用'),
+    sa.Column('id', sa.UUID(), 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'),
+    sa.UniqueConstraint('mobile')
+    )
+    op.create_table('mjk_broll_materials',
+    sa.Column('category_id', sa.BigInteger(), nullable=False, comment='所属三级分类ID，关联 mjk_broll_categories'),
+    sa.Column('title', sa.String(length=256), nullable=False, comment='素材标题/文件名，运营后台识别用'),
+    sa.Column('url', sa.String(length=1024), nullable=False, comment='七牛云 CDN 访问地址，FFmpeg合成和前端播放直接使用'),
+    sa.Column('duration', sa.Float(), nullable=False, comment='视频时长（秒），FFmpeg probe 提取，入库时必须大于0'),
+    sa.Column('usage_count', sa.BigInteger(), nullable=False, comment='累计使用次数，驱动加权随机算法'),
+    sa.Column('status', sa.String(length=16), nullable=False, comment='状态：active（可用）/ disabled（下架）/ deleted（软删除）'),
+    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.ForeignKeyConstraint(['category_id'], ['mjk_broll_categories.id'], ),
+    sa.PrimaryKeyConstraint('id')
+    )
+    op.create_table('mjk_release_packages',
+    sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+    sa.Column('release_id', sa.Integer(), nullable=False),
+    sa.Column('platform', sa.String(length=20), nullable=False),
+    sa.Column('architecture', sa.String(length=20), nullable=False),
+    sa.Column('filename', sa.String(length=255), nullable=False),
+    sa.Column('file_url', sa.String(length=500), nullable=False),
+    sa.Column('file_size', sa.BigInteger(), nullable=False),
+    sa.Column('signature', sa.Text(), nullable=False),
+    sa.Column('download_count', sa.Integer(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.ForeignKeyConstraint(['release_id'], ['mjk_app_releases.id'], ondelete='CASCADE'),
+    sa.PrimaryKeyConstraint('id'),
+    sa.UniqueConstraint('release_id', 'platform', 'architecture', name='uix_pkg_platform_arch')
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_table('mjk_release_packages')
+    op.drop_table('mjk_broll_materials')
+    op.drop_table('mjk_users')
+    op.drop_table('mjk_user_points')
+    op.drop_table('mjk_user_devices')
+    op.drop_table('mjk_point_transactions')
+    op.drop_table('mjk_point_recharge_orders')
+    op.drop_table('mjk_point_batches')
+    op.drop_table('mjk_cover_backgrounds')
+    op.drop_table('mjk_broll_tags')
+    op.drop_table('mjk_broll_categories')
+    op.drop_index(op.f('ix_mjk_app_releases_version'), table_name='mjk_app_releases')
+    op.drop_table('mjk_app_releases')
+    # ### end Alembic commands ###

python-api/alembic/versions/d8f4912d7a52_rename_old_table_prefix_for_update_.py

@@ -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"
+    )

python-api/app/ai/adapters/base.py

@@ -0,0 +1,132 @@
+"""
+Adapter 基础定义
+===============
+
+所有第三方平台 Adapter 的统一契约。
+"""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass
+from typing import Any, Protocol, runtime_checkable
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass(frozen=True)
+class AdapterResponse:
+    """Adapter 统一响应格式"""
+
+    success: bool
+    data: dict[str, Any] | None = None
+    error_code: str | None = None
+    error_message: str | None = None
+    retryable: bool = False
+
+
+@dataclass(frozen=True)
+class TaskStatus:
+    """异步任务状态统一格式"""
+
+    state: str  # "pending" | "processing" | "completed" | "failed"
+    result: dict[str, Any] | None = None
+    error_message: str | None = None
+
+
+@runtime_checkable
+class PlatformAdapter(Protocol):
+    """所有 Adapter 的准入门槛
+
+    每个新平台必须实现 platform_id + health() + close()。
+    """
+
+    platform_id: str
+
+    async def health(self) -> AdapterResponse:
+        """健康检查，返回是否可用"""
+        ...
+
+    async def close(self) -> None:
+        """清理资源（关闭 HTTP Client、释放连接池）"""
+        ...
+
+
+@runtime_checkable
+class SyncCapable(Protocol):
+    """同步调用能力（TTS、Chat 等）"""
+
+    async def call(self, method: str, payload: dict[str, Any]) -> AdapterResponse:
+        """同步调用统一入口
+
+        Args:
+            method: 方法标识，如 "tts", "chat"
+            payload: 请求体字典
+
+        Returns:
+            AdapterResponse: 统一响应格式
+
+        各方法返回结构（docstring 约定）：
+        - "tts": data={"audio_url": str}
+        - "chat": data={"content": str, "usage": dict, "model": str}
+        """
+
+        ...
+
+
+@runtime_checkable
+class TaskCapable(Protocol):
+    """异步任务能力（视频生成、字幕、TTS 等）"""
+
+    async def submit(
+        self,
+        task_type: str,
+        payload: dict[str, Any],
+        callback_url: str | None = None,
+    ) -> AdapterResponse:
+        """提交任务，返回 platform_task_id"""
+        ...
+
+    async def query(self, platform_task_id: str) -> TaskStatus:
+        """查询任务状态"""
+        ...
+
+
+@runtime_checkable
+class CallbackCapable(Protocol):
+    """回调验签能力（可选，只有需要验签的平台才实现）"""
+
+    async def verify_signature(
+        self,
+        headers: dict[str, str],
+        body: bytes,
+        secret: str,
+        callback_url: str | None = None,
+    ) -> bool:
+        """验证回调签名
+
+        Args:
+            callback_url: 回调请求完整 URL（用于构建 signingString，部分平台需要）
+        """
+        ...
+
+    async def verify_nonce(
+        self,
+        headers: dict[str, str],
+        redis: Any,
+    ) -> bool:
+        """验证回调 nonce 防重放（可选实现）
+
+        Args:
+            headers: 回调请求头
+            redis: Redis 客户端（用于检查 nonce 是否已使用）
+
+        Returns:
+            True: nonce 有效（未使用）
+            False: nonce 已使用（可能为重放攻击）
+        """
+        ...
+
+    async def parse_callback(self, body: bytes) -> TaskStatus:
+        """解析回调体为统一任务状态"""
+        ...

python-api/app/ai/adapters/constants.py

@@ -0,0 +1,23 @@
+"""
+Adapter 方法常量
+===============
+
+统一的方法标识，避免字符串硬编码。
+"""
+
+
+class Method:
+    """同步/异步方法标识常量"""
+
+    # 同步方法
+    TTS = "tts"
+    CLONE_VOICE = "clone_voice"
+    CHAT = "chat"
+    EMBEDDING = "embedding"
+
+    # 异步任务方法
+    LIP_SYNC = "lip_sync"
+    CAPTION = "caption"
+    AUTO_ALIGN = "auto_align"
+    VIDEO_GENERATE = "video_generate"
+    REMOVE_BACKGROUND = "remove_background"

python-api/app/ai/adapters/vidu_adapter.py

@@ -0,0 +1,312 @@
+"""
+Vidu Adapter
+============
+
+实现 PlatformAdapter + SyncCapable + TaskCapable + CallbackCapable。
+直接接入 ViduProvider，提供标准 Protocol 接口。
+"""
+
+from __future__ import annotations
+
+import base64
+import hashlib
+import hmac
+import json
+import logging
+from typing import Any
+from urllib.parse import urlparse
+
+from app.ai.adapters.base import (
+    AdapterResponse,
+    CallbackCapable,
+    PlatformAdapter,
+    SyncCapable,
+    TaskCapable,
+    TaskStatus,
+)
+from app.ai.adapters.constants import Method
+from app.ai.providers.vidu_provider import ViduProvider
+from app.core.exceptions import PlatformError, PlatformErrorType
+
+logger = logging.getLogger(__name__)
+
+
+class ViduAdapter(PlatformAdapter, SyncCapable, TaskCapable, CallbackCapable):
+    """Vidu 平台标准 Adapter"""
+
+    platform_id = "vidu"
+
+    # Vidu 原生状态 ↔ 标准状态 映射表
+    _VIDU_TO_STANDARD = {
+        "created": "processing",
+        "queueing": "processing",
+        "pending": "processing",
+        "processing": "processing",
+        "success": "completed",
+        "failed": "failed",
+    }
+    _STANDARD_TO_VIDU = {
+        "completed": "success",
+        "processing": "processing",
+        "pending": "pending",
+        "failed": "failed",
+    }
+
+    def __init__(self, provider: ViduProvider):
+        self.provider = provider
+
+    @classmethod
+    def normalize_state(cls, vidu_state: str) -> str:
+        """Vidu 原生状态 → 标准状态（processing / completed / failed）"""
+        return cls._VIDU_TO_STANDARD.get(vidu_state, "failed")
+
+    @classmethod
+    def denormalize_state(cls, standard_state: str) -> str:
+        """标准状态 → Vidu 原生状态（success / processing / pending / failed）"""
+        return cls._STANDARD_TO_VIDU.get(standard_state, standard_state)
+
+    # ── PlatformAdapter ──
+
+    async def health(self) -> AdapterResponse:
+        try:
+            # Vidu 没有专门的健康检查接口，用查询一个空任务测试连通性
+            # 实际上会 404，但只要网络通就说明服务可用
+            await self.provider.query_task("health-check")
+            return AdapterResponse(success=True)
+        except PlatformError as e:
+            if e.error_type == PlatformErrorType.NOT_FOUND:
+                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) -> AdapterResponse:
+        try:
+            if method == Method.TTS:
+                result = await self.provider.tts_sync(
+                    text=payload["text"],
+                    voice_id=payload.get("voice_id", "tianxin_xiaoling"),
+                    speed=payload.get("speed", 1.0),
+                    volume=payload.get("volume", 0),
+                    pitch=payload.get("pitch", 0),
+                    emotion=payload.get("emotion"),
+                )
+                return AdapterResponse(
+                    success=True,
+                    data={"audio_url": result.get("file_url")},
+                )
+
+            elif method == Method.CLONE_VOICE:
+                result = await self.provider.clone_voice(
+                    audio_url=payload["audio_url"],
+                    voice_id=payload["voice_id"],
+                    text=payload.get("text"),
+                )
+                return AdapterResponse(
+                    success=True,
+                    data={
+                        "voice_id": result.get("voice_id"),
+                        "demo_audio": result.get("demo_audio"),
+                    },
+                )
+
+            else:
+                return AdapterResponse(
+                    success=False,
+                    error_message=f"不支持的方法: {method}",
+                    retryable=False,
+                )
+
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise PlatformError(
+                f"Vidu {method} 调用失败: {e}",
+                platform="vidu",
+                retryable=False,
+                error_type=PlatformErrorType.UNKNOWN,
+            ) from e
+
+    # ── TaskCapable ──
+
+    async def submit(
+        self,
+        task_type: str,
+        payload: dict,
+        callback_url: str | None = None,
+    ) -> AdapterResponse:
+        try:
+            if task_type == Method.LIP_SYNC:
+                result = await self.provider.lip_sync(
+                    video_url=payload["video_url"],
+                    audio_url=payload.get("audio_url"),
+                    text=payload.get("text"),
+                    voice_id=payload.get("voice_id"),
+                    speed=payload.get("speed", 1.0),
+                    volume=payload.get("volume", 0),
+                    ref_photo_url=payload.get("ref_photo_url"),
+                    callback_url=callback_url,
+                )
+                return AdapterResponse(
+                    success=True,
+                    data={"task_id": result.get("task_id")},
+                )
+
+            else:
+                return AdapterResponse(
+                    success=False,
+                    error_message=f"不支持的任务类型: {task_type}",
+                    retryable=False,
+                )
+
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise PlatformError(
+                f"Vidu {task_type} 提交失败: {e}",
+                platform="vidu",
+                retryable=False,
+                error_type=PlatformErrorType.UNKNOWN,
+            ) from e
+
+    async def query(self, platform_task_id: str) -> TaskStatus:
+        try:
+            result = await self.provider.query_task(platform_task_id)
+            state = result.get("state", "unknown")
+
+            creations = result.get("creations", [])
+            video_url = None
+            if state == "success" and creations:
+                video_url = creations[0].get("url")
+
+            return TaskStatus(
+                state=self.normalize_state(state),
+                result={"video_url": video_url, "creations": creations} if video_url else None,
+                error_message=result.get("message") if state == "failed" else None,
+            )
+
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise PlatformError(
+                f"Vidu 任务查询失败: {e}",
+                platform="vidu",
+                retryable=False,
+                error_type=PlatformErrorType.UNKNOWN,
+            ) from e
+
+    # ── CallbackCapable ──
+
+    async def verify_signature(
+        self,
+        headers: dict[str, str],
+        body: bytes,
+        secret: str,
+        callback_url: str | None = None,
+    ) -> bool:
+        """验证 Vidu 回调 HMAC-SHA256 签名"""
+        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_lower.get(name.lower())
+            if value is None:
+                logger.warning(f"[Vidu] 签名验证失败: 缺少签名头 {name}")
+                return False
+            header_values[name] = value
+
+        # 构建 signingString（使用 callback_url 动态解析 path/query）
+        parsed = urlparse(callback_url or "")
+        http_uri = parsed.path or "/"
+        canonical_query_string = parsed.query or ""
+
+        signing_string = (
+            f"POST\n"
+            f"{http_uri}\n"
+            f"{canonical_query_string}\n"
+            f"vidu\n"
+            f"{date}\n"
+        )
+        for name in header_names:
+            signing_string += f"{name}:{header_values[name]}\n"
+
+        expected = base64.b64encode(
+            hmac.new(secret.encode("utf-8"), signing_string.encode("utf-8"), hashlib.sha256).digest()
+        ).decode("utf-8")
+
+        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,
+        headers: dict[str, str],
+        redis: Any,
+    ) -> bool:
+        """验证 Vidu 回调 nonce 防重放"""
+        nonce = headers.get("x-request-nonce")
+        if not nonce:
+            return False
+        nonce_key = f"vidu:callback_nonce:{nonce}"
+        if await redis.exists(nonce_key):
+            return False
+        await redis.setex(nonce_key, 300, "1")
+        return True
+
+    async def parse_callback(self, body: bytes) -> TaskStatus:
+        """解析 Vidu 回调体"""
+        data = json.loads(body)
+        task_id = data.get("id") or data.get("task_id")
+        state = data.get("state")
+        creations = data.get("creations", [])
+
+        video_url = None
+        if state == "success" and creations:
+            video_url = creations[0].get("url")
+
+        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,
+        )

python-api/app/ai/adapters/volcengine_ark_adapter.py

@@ -0,0 +1,93 @@
+"""
+火山方舟 Adapter
+================
+
+实现 PlatformAdapter + SyncCapable。
+直接接入 VolcengineProvider，提供标准 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_provider import VolcengineProvider
+from app.core.exceptions import PlatformError, PlatformErrorType
+
+logger = logging.getLogger(__name__)
+
+
+class VolcengineArkAdapter(PlatformAdapter, SyncCapable):
+    """火山方舟 LLM 平台标准 Adapter"""
+
+    platform_id = "volcengine_ark"
+
+    def __init__(self, provider: VolcengineProvider):
+        self.provider = provider
+
+    # ── PlatformAdapter ──
+
+    async def health(self) -> AdapterResponse:
+        try:
+            health = await self.provider.health_check()
+            return AdapterResponse(
+                success=health.is_available,
+                data={"response_time_ms": health.response_time},
+            )
+        except Exception as e:
+            return AdapterResponse(
+                success=False,
+                error_message=str(e),
+                retryable=False,
+            )
+
+    async def close(self) -> None:
+        if hasattr(self.provider.client, "close"):
+            await self.provider.client.close()
+
+    # ── SyncCapable ──
+
+    async def call(self, method: str, payload: dict[str, Any]) -> AdapterResponse:
+        try:
+            if method == Method.CHAT:
+                result = await self.provider.generate(
+                    prompt=payload["prompt"],
+                    model=payload.get("model"),
+                    max_tokens=payload.get("max_tokens"),
+                    system_prompt=payload.get("system_prompt"),
+                    reasoning_effort=payload.get("reasoning_effort"),
+                )
+                return AdapterResponse(
+                    success=True,
+                    data={
+                        "content": result.content,
+                        "usage": result.usage,
+                        "model": result.model,
+                    },
+                )
+
+            elif method == Method.EMBEDDING:
+                result = await self.provider.create_embeddings(
+                    texts=payload["texts"],
+                    model=payload.get("model"),
+                )
+                return AdapterResponse(success=True, data=result)
+
+            else:
+                return AdapterResponse(
+                    success=False,
+                    error_message=f"不支持的方法: {method}",
+                    retryable=False,
+                )
+
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise PlatformError(
+                f"火山方舟 {method} 调用失败: {e}",
+                platform="volcengine_ark",
+                retryable=False,
+                error_type=PlatformErrorType.UNKNOWN,
+            ) from e

python-api/app/ai/adapters/volcengine_caption_adapter.py

@@ -0,0 +1,144 @@
+"""
+火山引擎字幕 Adapter
+====================
+
+实现 PlatformAdapter + TaskCapable。
+直接接入 VolcengineCaptionProvider，提供标准 Protocol 接口。
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from app.ai.adapters.base import AdapterResponse, PlatformAdapter, TaskCapable, TaskStatus
+from app.ai.adapters.constants import Method
+from app.ai.providers.volcengine_caption_provider import VolcengineCaptionProvider
+from app.core.exceptions import PlatformError, PlatformErrorType
+
+logger = logging.getLogger(__name__)
+
+
+class VolcengineCaptionAdapter(PlatformAdapter, TaskCapable):
+    """火山引擎字幕平台标准 Adapter"""
+
+    platform_id = "volcengine_caption"
+
+    def __init__(self, provider: VolcengineCaptionProvider):
+        self.provider = provider
+
+    # ── PlatformAdapter ──
+
+    async def health(self) -> AdapterResponse:
+        try:
+            # 火山字幕没有专门的健康检查，用提交一个无效任务测试连通性
+            # 401/403 说明网络通但认证问题，也算"可用"
+            await self.provider.submit_caption_task(audio_url="https://example.com/test.mp3")
+            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()
+
+    # ── TaskCapable ──
+
+    async def submit(
+        self,
+        task_type: str,
+        payload: dict[str, Any],
+        callback_url: str | None = None,
+    ) -> AdapterResponse:
+        try:
+            if task_type == Method.CAPTION:
+                result = await self.provider.submit_caption_task(
+                    audio_url=payload["audio_url"],
+                    language=payload.get("language", "zh-CN"),
+                    caption_type=payload.get("caption_type", "auto"),
+                    use_punc=payload.get("use_punc", True),
+                    use_itn=payload.get("use_itn", True),
+                    words_per_line=payload.get("words_per_line", 46),
+                    max_lines=payload.get("max_lines", 1),
+                )
+                return AdapterResponse(success=True, data={"task_id": result["id"]})
+
+            elif task_type == Method.AUTO_ALIGN:
+                result = await self.provider.submit_auto_align_task(
+                    audio_url=payload["audio_url"],
+                    audio_text=payload["audio_text"],
+                    caption_type=payload.get("caption_type", "speech"),
+                    sta_punc_mode=payload.get("sta_punc_mode", 3),
+                )
+                return AdapterResponse(success=True, data={"task_id": result["id"]})
+
+            else:
+                return AdapterResponse(
+                    success=False,
+                    error_message=f"不支持的任务类型: {task_type}",
+                    retryable=False,
+                )
+
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise PlatformError(
+                f"火山字幕 {task_type} 提交失败: {e}",
+                platform="volcengine_caption",
+                retryable=False,
+                error_type=PlatformErrorType.UNKNOWN,
+            ) from e
+
+    async def query(self, platform_task_id: str) -> TaskStatus:
+        """查询字幕任务状态（caption 类型）"""
+        try:
+            data = await self.provider.query_caption_task(platform_task_id, blocking=False)
+            return self._parse_status(data)
+        except Exception:
+            raise
+
+    async def query_auto_align(self, platform_task_id: str) -> TaskStatus:
+        """查询打轴任务状态（auto_align 类型）"""
+        try:
+            data = await self.provider.query_auto_align_task(platform_task_id, blocking=False)
+            return self._parse_status(data)
+        except Exception:
+            raise
+
+    def _parse_status(self, data: dict) -> TaskStatus:
+        """解析火山字幕原始响应为统一 TaskStatus"""
+        code = data.get("code", -1)
+        if code == 0:
+            utterances = data.get("utterances", [])
+            return TaskStatus(
+                state="completed",
+                result={
+                    "duration": data.get("duration", 0.0),
+                    "utterances": [
+                        {
+                            "text": u.get("text", ""),
+                            "start_time": u.get("start_time", 0) or u.get("startTime", 0),
+                            "end_time": u.get("end_time", 0) or u.get("endTime", 0),
+                        }
+                        for u in utterances
+                    ],
+                },
+            )
+        elif code == 2000:
+            return TaskStatus(state="processing")
+        else:
+            return TaskStatus(
+                state="failed",
+                error_message=data.get("message", f"未知错误: {code}"),
+            )

python-api/app/ai/adapters/volcengine_mediakit_adapter.py

@@ -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

python-api/app/ai/gateways/llm_gateway.py

@@ -0,0 +1,87 @@
+"""
+LLM 调用网关
+============
+
+职责：
+1. 按 task_type 选择模型
+2. Fallback 降级链
+3. 调用各平台 Adapter
+4. 流式/非流式统一封装
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from app.ai.adapters.base import SyncCapable
+from app.ai.adapters.constants import Method
+from app.core.exceptions import PlatformError
+
+logger = logging.getLogger(__name__)
+
+
+class LLMGateway:
+    """LLM 调用网关"""
+
+    def __init__(self, adapters: dict[str, SyncCapable], fallback_chains: dict[str, list[str]] | None = None):
+        self.adapters = adapters
+        self.fallback_chains = fallback_chains or {}
+
+    def _get_adapter(self, platform: str) -> SyncCapable:
+        adapter = self.adapters.get(platform)
+        if adapter is None:
+            raise ValueError(f"未注册的 LLM 平台: {platform}")
+        return adapter
+
+    async def chat(
+        self,
+        model_id: str,
+        prompt: str,
+        platform: str = "volcengine_ark",
+        **kwargs,
+    ) -> dict[str, Any]:
+        """同步聊天，带 Fallback
+
+        Args:
+            model_id: 模型别名（如 doubao-seed-2-0-pro）
+            prompt: 用户提示词
+            platform: 平台 ID
+            **kwargs: temperature, max_tokens, system_prompt 等
+        """
+        models_to_try = [model_id] + self.fallback_chains.get(model_id, [])
+
+        last_error = None
+        for mid in models_to_try:
+            adapter = self._get_adapter(platform)
+            try:
+                result = await adapter.call(Method.CHAT, {
+                    "prompt": prompt,
+                    "model": mid,
+                    **kwargs,
+                })
+                if result.success:
+                    if mid != model_id:
+                        logger.warning(f"[LLMGateway] 模型降级成功: {model_id} → {mid}")
+                    return result.data
+                else:
+                    last_error = PlatformError(
+                        result.error_message or f"模型 {mid} 调用失败",
+                        platform=platform,
+                        retryable=result.retryable,
+                    )
+            except PlatformError as e:
+                last_error = e
+                if not e.retryable:
+                    raise  # 不可重试的错误直接抛，不再 Fallback
+                logger.warning(f"[LLMGateway] 模型 {mid} 失败，尝试下一个: {e}")
+                continue
+
+        raise last_error or PlatformError(
+            f"所有模型均失败: {model_id}",
+            platform=platform,
+            retryable=False,
+        )
+
+
+

python-api/app/ai/model_router.py

@@ -0,0 +1,357 @@
+"""
+AI 模型路由 V2 - 基于文件配置
+=================================
+
+从 YAML 配置文件加载平台/模型配置。
+配置在启动时加载，运行时只读，不支持热重载。
+"""
+
+import asyncio
+import logging
+
+from app.ai.adapters.constants import Method
+from app.ai.providers.base import GenerationResult, ModelHealth, ProviderError
+from app.ai.providers.volcengine_provider import VolcengineProvider
+from app.core.config_loader import AIModelConfigLoader, get_config_loader
+from app.platform_gateway import PlatformGateway
+
+logger = logging.getLogger(__name__)
+
+
+class _PlatformInstance:
+    """平台实例包装器（保留兼容，内部转发到 PlatformGateway）"""
+
+    def __init__(self, config: dict, gateway: PlatformGateway | None = None):
+        self.config = config
+        self.gateway = gateway
+        self.provider_id = config.get("id", "")
+
+    async def generate(
+        self, model_name: str, prompt: str, **kwargs
+    ) -> GenerationResult:
+        """调用生成（通过 PlatformGateway）"""
+        if self.gateway:
+            result = await self.gateway.call_sync(
+                platform=self.provider_id,
+                method=Method.CHAT,
+                payload={
+                    "prompt": prompt,
+                    "model": model_name,
+                    **kwargs,
+                },
+            )
+            if not result.success:
+                raise ProviderError(
+                    result.error_message or f"{self.provider_id} 调用失败"
+                )
+            data = result.data or {}
+            return GenerationResult(
+                content=data.get("content", ""),
+                usage=data.get("usage"),
+                model=data.get("model", model_name),
+            )
+        # fallback: 直接通过 Provider（兼容旧初始化方式）
+        raise ProviderError("PlatformGateway 未初始化")
+
+    async def health_check(self, model_name: str | None = None) -> ModelHealth:
+        """健康检查（通过 PlatformGateway）"""
+        if self.gateway:
+            try:
+                result = await self.gateway.health_check_all()
+                adapter_result = result.get(self.provider_id)
+                if adapter_result:
+                    return ModelHealth(
+                        id=model_name or self.provider_id,
+                        name=self.provider_id,
+                        is_available=adapter_result.success,
+                        response_time=adapter_result.data.get("response_time_ms", 0) if adapter_result.data else 0,
+                        last_error=adapter_result.error_message,
+                    )
+            except Exception as e:
+                logger.warning(f"平台 {self.provider_id} 健康检查失败: {e}")
+        return ModelHealth(
+            id=model_name or self.provider_id,
+            name=self.provider_id,
+            is_available=False,
+            response_time=0,
+            last_error="PlatformGateway 未初始化",
+        )
+
+
+class ModelRouter:
+    """
+    模型路由 V2 - 基于文件配置
+
+    支持：
+    - 从 YAML 文件加载配置
+    - 多平台配置
+    - 每平台多模型
+    - 模型自动选择
+    """
+
+
+    def __init__(self):
+        self.platforms: dict[str, _PlatformInstance] = {}
+        self._config_loader: AIModelConfigLoader | None = None
+        self._initialized = False
+        self._gateway: PlatformGateway | None = None
+
+    async def initialize(self, db_session=None, gateway: PlatformGateway | None = None):
+        """初始化路由
+
+        Args:
+            db_session: 保留兼容性
+            gateway: PlatformGateway 实例，用于统一调用第三方平台
+        """
+        if self._initialized:
+            return
+
+        self._gateway = gateway
+
+        # 从文件配置加载
+        self._config_loader = get_config_loader()
+        self._load_from_config()
+
+        self._initialized = True
+        logger.info(f"ModelRouter 初始化完成: {len(self.platforms)} 平台")
+
+    def _load_from_config(self):
+        """从配置文件加载平台和模型"""
+        self.platforms = {}
+
+        # 加载平台
+        for platform in self._config_loader.get_all_platforms():
+            try:
+                self.platforms[platform.id] = _PlatformInstance(
+                    {
+                        "id": platform.id,
+                        "name": platform.name,
+                        "provider": platform.provider,
+                        "base_url": platform.base_url,
+                    },
+                    gateway=self._gateway,
+                )
+                logger.info(f"平台 {platform.id} 初始化成功")
+            except Exception as e:
+                logger.warning(f"平台 {platform.id} 初始化失败: {e}")
+
+        # 加载模型到 Provider（用于模型名称映射）
+        volcengine_models = []
+        for model in self._config_loader.get_enabled_models():
+            if model.platform_id == "volcengine":
+                volcengine_models.append(
+                    {
+                        "id": model.id,
+                        "model_name": model.model_name,
+                    }
+                )
+
+        if volcengine_models:
+            VolcengineProvider.load_models_from_config(volcengine_models)
+            logger.info(f"已加载 {len(volcengine_models)} 个火山方舟模型到 Provider")
+
+    def get_model_config(self, model_id: str) -> dict | None:
+        """获取模型配置"""
+        if self._config_loader:
+            model = self._config_loader.get_model(model_id)
+            if model:
+                return {
+                    "id": model.id,
+                    "platform_id": model.platform_id,
+                    "model_name": model.model_name,
+                    "display_name": model.display_name,
+                    "capabilities": model.capabilities,
+                    "default_params": model.default_params,
+                    "cost_per_1k_input": model.cost_per_1k_input,
+                    "cost_per_1k_output": model.cost_per_1k_output,
+                    "max_tokens_limit": model.max_tokens_limit,
+                }
+        return None
+
+    def list_models(
+        self, capability: str | None = None, platform_id: str | None = None
+    ) -> list[dict]:
+        """列出可用模型"""
+        models = []
+
+        if self._config_loader:
+            if capability:
+                config_models = self._config_loader.get_models_by_capability(capability)
+            elif platform_id:
+                config_models = self._config_loader.get_models_by_platform(platform_id)
+            else:
+                config_models = self._config_loader.get_enabled_models()
+
+            for model in config_models:
+                models.append(
+                    {
+                        "id": model.id,
+                        "platform_id": model.platform_id,
+                        "model_name": model.model_name,
+                        "display_name": model.display_name,
+                        "capabilities": model.capabilities,
+                        "default_params": model.default_params,
+                        "cost_per_1k_input": model.cost_per_1k_input,
+                        "cost_per_1k_output": model.cost_per_1k_output,
+                        "max_tokens_limit": model.max_tokens_limit,
+                    }
+                )
+
+        return models
+
+    def list_platforms(self) -> list[dict]:
+        """列出所有平台"""
+        if self._config_loader:
+            return [
+                {
+                    "id": p.id,
+                    "name": p.name,
+                    "provider": p.provider,
+                }
+                for p in self._config_loader.get_all_platforms()
+            ]
+        return []
+
+    def select_model_for_task(self, task_type: str) -> str | None:
+        """根据任务类型选择最佳模型"""
+        # 先检查任务默认配置
+        if self._config_loader:
+            default_model = self._config_loader.get_default_model_for_task(task_type)
+            if default_model:
+                model = self._config_loader.get_model(default_model)
+                if model and model.is_enabled:
+                    return default_model
+
+            # 按能力匹配
+            candidates = self._config_loader.get_models_by_capability(task_type)
+            if candidates:
+                return candidates[0].id
+
+        return None
+
+    async def generate(
+        self,
+        prompt: str,
+        model_id: str | None = None,
+        task_type: str | None = None,
+        **kwargs,
+    ) -> GenerationResult:
+        """
+        生成文本
+
+        Args:
+            prompt: 提示词
+            model_id: 指定模型 ID，None 则自动选择
+            task_type: 任务类型（用于自动选模型）
+        """
+        # 确定主模型
+        if model_id is None:
+            if task_type:
+                model_id = self.select_model_for_task(task_type)
+            if model_id is None:
+                models = (
+                    self._config_loader.get_enabled_models()
+                    if self._config_loader
+                    else []
+                )
+                if models:
+                    model_id = models[0].id
+                else:
+                    raise ProviderError("没有可用的模型")
+
+        model = self._config_loader.get_model(model_id) if self._config_loader else None
+        if not model:
+            raise ProviderError(f"模型不存在: {model_id}")
+
+        platform = self.platforms.get(model.platform_id)
+        if not platform:
+            raise ProviderError(f"平台不存在: {model.platform_id}")
+
+        params = {**model.default_params, **kwargs}
+
+        try:
+            return await platform.generate(
+                prompt=prompt, model_name=model.model_name, **params
+            )
+        except Exception as e:
+            raise ProviderError(f"模型 {model_id} 生成失败: {e}") from e
+
+    async def health_check(self, model_id: str | None = None) -> dict[str, ModelHealth]:
+        """检查模型健康状态"""
+        # 优先通过 PlatformGateway 统一健康检查
+        if self._gateway:
+            gateway_results = await self._gateway.health_check_all()
+            results = {}
+            if self._config_loader:
+                for model in self._config_loader.get_enabled_models():
+                    adapter_result = gateway_results.get(model.platform_id)
+                    if adapter_result:
+                        results[model.id] = ModelHealth(
+                            id=model.id,
+                            name=model.display_name,
+                            is_available=adapter_result.success,
+                            response_time=adapter_result.data.get("response_time_ms", 0) if adapter_result.data else 0,
+                            last_error=adapter_result.error_message,
+                        )
+                    else:
+                        results[model.id] = ModelHealth(
+                            id=model.id,
+                            name=model.display_name,
+                            is_available=False,
+                            response_time=0,
+                            last_error="平台未注册到 Gateway",
+                        )
+            return results
+
+        # fallback: 直接通过 PlatformInstance
+        results = {}
+        if model_id:
+            model = self._config_loader.get_model(model_id) if self._config_loader else None
+            if model:
+                platform = self.platforms.get(model.platform_id)
+                if platform:
+                    results[model_id] = await platform.health_check(model.model_name)
+        else:
+            if self._config_loader:
+                for model in self._config_loader.get_enabled_models():
+                    platform = self.platforms.get(model.platform_id)
+                    if platform:
+                        try:
+                            results[model.id] = await platform.health_check(model.model_name)
+                        except Exception as e:
+                            results[model.id] = ModelHealth(
+                                id=model.id,
+                                name=model.display_name,
+                                is_available=False,
+                                response_time=0,
+                                last_error=str(e),
+                            )
+        return results
+
+
+# 全局单例
+_model_router: ModelRouter | None = None
+_init_lock = asyncio.Lock()
+
+
+async def get_model_router(db_session=None, gateway: PlatformGateway | None = None) -> ModelRouter:
+    """获取 ModelRouter 单例（线程安全）
+
+    使用双重检查锁定模式确保并发安全。
+    若之前初始化失败（_initialized=False），下次调用会自动重试。
+    """
+    global _model_router
+    if _model_router is None or not getattr(_model_router, "_initialized", False):
+        async with _init_lock:
+            if _model_router is None:
+                _model_router = ModelRouter()
+            if not _model_router._initialized:
+                logger.info("Initializing ModelRouter singleton...")
+                await _model_router.initialize(db_session, gateway=gateway)
+                logger.info("ModelRouter singleton initialized")
+    elif gateway is not None and _model_router._gateway is None:
+        # 延迟绑定 Gateway（如果之前初始化时未传入）
+        _model_router._gateway = gateway
+        for platform_instance in _model_router.platforms.values():
+            platform_instance.gateway = gateway
+    return _model_router

python-api/app/ai/prompts/__init__.py

@@ -0,0 +1,41 @@
+"""
+Prompt 模板系统
+================
+
+家装行业 AI 视频脚本 Prompt 模板。
+所有 Prompt 存储在 txt 文件中，支持热更新。
+
+使用示例:
+    from app.ai.prompts import load_system_prompt, load_script_user_prompt, list_categories
+
+    # 获取分类列表
+    categories = list_categories()
+
+    # 加载 System Prompt（大类+小类，随机取一个）
+    system = load_system_prompt("bk", "ht")
+
+    # 加载并渲染 User Prompt
+    user = load_script_user_prompt(
+        topic="装修避坑",
+    )
+"""
+
+from .loader import (
+    PolishPromptBuilder,
+    ScriptPromptBuilder,
+    list_categories,
+    load_prompt,
+    load_script_user_prompt,
+    load_system_prompt,
+    render_template,
+)
+
+__all__ = [
+    "load_prompt",
+    "render_template",
+    "load_system_prompt",
+    "load_script_user_prompt",
+    "list_categories",
+    "ScriptPromptBuilder",
+    "PolishPromptBuilder",
+]

python-api/app/ai/prompts/cover/cover.txt

@@ -0,0 +1 @@
+根据标题"{caption}"生成一张适合短视频封面的竖屏图片，画面精美、视觉冲击力强的营销风格，主体人物自然融入场景。

python-api/app/ai/prompts/loader.py

@@ -0,0 +1,323 @@
+"""
+Prompt 简单加载器
+=================
+从文件加载 Prompt，支持热更新。
+
+目录结构约定：
+  system/
+  ├── <category>/               # 大类目录
+  │   ├── <subcategory>/        # 小类目录
+  │   │   ├── _meta.json        # 元数据 {"name": "显示名称"}
+  │   │   ├── 1.txt             # 提示词文件（随机取其一）
+  │   │   └── 2.txt
+  │   └── ...
+  └── ...
+"""
+
+import json
+import random
+from pathlib import Path
+from string import Template
+
+_PROMPTS_DIR = Path(__file__).parent
+
+
+def load_prompt(path: str) -> str:
+    """
+    加载 Prompt 文件
+
+    Args:
+        path: 相对路径，如 "script/system", "polish/scene"
+
+    Returns:
+        Prompt 内容，文件不存在返回空字符串
+    """
+    file_path = _PROMPTS_DIR / f"{path}.txt"
+    if file_path.exists():
+        return file_path.read_text(encoding="utf-8")
+    return ""
+
+
+def render_template(template: str, **kwargs) -> str:
+    """
+    安全渲染模板变量
+
+    Args:
+        template: 模板字符串
+        **kwargs: 变量值
+
+    Returns:
+        渲染后的字符串
+    """
+    try:
+        # 转义 $ 符号防止用户输入干扰
+        safe_kwargs = {k: str(v).replace("$", "$$") for k, v in kwargs.items()}
+        return Template(template).substitute(**safe_kwargs)
+    except KeyError as e:
+        raise ValueError(f"模板缺少变量: {e}")
+
+
+# ====================== 新分类体系：动态扫描 ======================
+
+SYSTEM_PROMPTS_DIR = _PROMPTS_DIR / "system"
+_SYSTEM_META_PATH = SYSTEM_PROMPTS_DIR / "_meta.json"
+
+
+def _load_system_meta() -> dict:
+    """读取 system/_meta.json"""
+    if _SYSTEM_META_PATH.exists():
+        try:
+            return json.loads(_SYSTEM_META_PATH.read_text(encoding="utf-8"))
+        except (json.JSONDecodeError, OSError):
+            pass
+    return {}
+
+
+def list_categories() -> list[dict]:
+    """
+    返回所有分类结构
+
+    以 system/_meta.json 为准，只返回配置中定义的分类。
+    count 动态扫描对应目录统计。
+
+    Returns:
+        [
+          {
+            "code": "bk",
+            "name": "装修避坑",
+            "subcategories": [
+              {"code": "ht", "name": "装修合同避坑", "count": 2},
+              ...
+            ]
+          },
+          ...
+        ]
+    """
+    meta = _load_system_meta()
+    categories = []
+
+    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:
+    """
+    根据大类+小类随机加载一个 System Prompt
+
+    Args:
+        category: 大类代码，如 "bk"
+        subcategory: 小类代码，如 "ht"
+
+    Returns:
+        随机选中的提示词内容，未找到返回空字符串
+    """
+    sub_dir = SYSTEM_PROMPTS_DIR / category / subcategory
+    if not sub_dir.exists():
+        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")
+
+
+
+def load_script_user_prompt(
+    topic: str,
+    extra_params: str | None = None,
+) -> str:
+    """
+    加载并渲染脚本生成 User Prompt
+
+    Args:
+        topic: 创作主题名称
+        extra_params: 额外参数（如风格、人设等），以换行分隔的字符串
+
+    Returns:
+        渲染后的用户提示词
+    """
+    template = load_prompt("user/script")
+    return render_template(
+        template,
+        topic=topic,
+        extra_params=extra_params or "",
+    )
+
+
+class ScriptPromptBuilder:
+    """
+    脚本 Prompt 构建器
+
+    用于构建家装行业短视频脚本的 System Prompt。
+    """
+
+    def build(
+        self,
+        duration: int = 30,
+        script_type: str = "干货型",
+        video_style: str = "口播",
+        industry: str = "家装",
+        tone: str | None = None,
+        custom_requirements: str | None = None,
+    ) -> str:
+        """
+        构建系统 Prompt
+
+        Args:
+            duration: 视频时长（秒）
+            script_type: 脚本类型（干货型、故事型等）
+            video_style: 视频风格（口播、剧情等）
+            industry: 行业（家装）
+            tone: 语气风格
+            custom_requirements: 自定义要求
+
+        Returns:
+            完整的 System Prompt
+        """
+        # 基础 System Prompt（已废弃的脚本 system.txt，这里留空）
+        base_prompt = ""
+
+        # 构建上下文信息
+        context_parts = [
+            f"行业：{industry}",
+            f"时长：{duration}秒",
+            f"类型：{script_type}",
+            f"风格：{video_style}",
+        ]
+
+        if tone:
+            context_parts.append(f"语气：{tone}")
+
+        context = "\n".join(context_parts)
+
+        # 构建完整 Prompt
+        full_prompt = f"""{base_prompt}
+
+【创作要求】
+{context}
+"""
+
+        if custom_requirements:
+            full_prompt += f"""
+【特殊要求】
+{custom_requirements}
+"""
+
+        # 添加输出格式要求
+        full_prompt += """
+【输出格式】
+请严格按照以下 JSON 数组格式返回，每个元素代表一个镜头：
+[
+  {
+    "id": 1,
+    "type": "segment",
+    "scene": "画面描述",
+    "voiceover": "配音文本",
+    "duration": "5s"
+  }
+]
+
+type 可以是：
+- "segment": 分镜（有画面+配音）
+- "empty_shot": 空镜（纯画面，voiceover 可为空）
+
+注意：
+1. 只返回 JSON 数组，不要有其他文字
+2. 确保 JSON 格式正确
+3. 总时长必须严格控制在要求范围内
+"""
+
+        return full_prompt
+
+
+class PolishPromptBuilder:
+    """
+    润色 Prompt 构建器
+
+    用于构建润色文案或画面描述的 Prompt。
+    """
+
+    POLISH_TYPES = {
+        "scene": "画面描述",
+        "voiceover": "配音文本",
+        "text": "文案内容",
+    }
+
+    def build(self, polish_type: str = "voiceover") -> str:
+        """
+        构建润色 Prompt
+
+        Args:
+            polish_type: 润色类型（scene/voiceover/text）
+
+        Returns:
+            System Prompt
+        """
+        if polish_type == "scene":
+            return self._build_scene_prompt()
+        else:
+            return self._build_voiceover_prompt()
+
+    def _build_scene_prompt(self) -> str:
+        """构建画面描述润色 Prompt"""
+        return """你是一位专业的视频画面描述优化师。你的任务是优化画面描述，使其更加生动、具体、有画面感。
+
+优化要求：
+1. 增加细节描写（光线、色彩、构图）
+2. 使用专业的影视语言
+3. 描述要具体可执行
+4. 保持简洁，不要过度渲染
+5. 适合 AI 视频生成模型理解
+
+请直接返回优化后的画面描述，不要添加解释。"""
+
+    def _build_voiceover_prompt(self) -> str:
+        """构建配音文本润色 Prompt"""
+        return """你是一位专业的短视频文案编辑。你的任务是优化口播文案，使其更加流畅、有吸引力。
+
+优化要求：
+1. 语言口语化，适合朗读
+2. 增加节奏感和停顿
+3. 保留核心信息点
+4. 适当使用修辞手法
+5. 控制字数，不要过长
+
+请直接返回优化后的文案，不要添加解释。"""

python-api/app/ai/prompts/polish/voiceover.txt

@@ -0,0 +1,12 @@
+你是一位短视频口播文案专家。请润色以下配音文本，使其更适合短视频口播：
+
+【原文】
+{content}
+
+【要求】
+- 口语化，像跟朋友聊天
+- 字数不能与原文差距超过10个字
+- 增加感染力
+- 不要有"综上所述"等书面语
+
+直接输出润色后的文案，不要添加任何说明：

python-api/app/ai/prompts/system/_meta.json

@@ -0,0 +1,21 @@
+{
+  "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": "装修省钱" }
+      ]
+    }
+  ]
+}

python-api/app/ai/prompts/system/bk/bj/半包谈价格5.8.txt

@@ -0,0 +1,265 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：选择半包装修、不懂怎么询价、容易被装修公司套路报价、不知道该重点问哪些问题的装修业主，围绕半包装修必问 10 大关键问题创作，按原文逻辑顺序排列，不随机抽取。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头询价痛点引入 + 半包 10 大必问问题干货 + 结尾资料领取引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：完整保留原文开头核心原意，仅轻微口语化微调，用扎心视角点出半包业主盲目询价容易被当成新手收割、多花冤枉钱的痛点，引出下文必问 10 个关键问题。
+中间核心（半包装修 10 大必问问题要点，文案适当调整修改，意思保持原意，按原文序号逻辑排列，不随机抽取）：
+拆改环节要问清：墙体拆除是否做切割施工，包含垃圾清运与否，旧门窗拆除能抵扣多少费用。
+水电环节逐项确认：水电是全改还是局部改造，电线水管品牌规格、壁厚、走顶走地工艺都要问清，布线方式与开关插座点位安装也要明确。
+瓷砖施工提前敲定：是否出具排版图纸，瓦工现场复尺落地，海棠角施工、全屋通铺是否额外收费。
+吊顶工艺核对细节：龙骨选用木龙骨还是轻钢龙骨，石膏板品牌、单层双层工艺，七字拐八字缝防裂工序是否标配。
+砌墙墙面基层问明白：墙固品牌与涂刷节点，挂网局部还是全屋、全屋挂网是否加价。
+辅材品牌提前锁定：腻子只选国产一线品牌，墙顶面只做顺平，柜子及边角局部找平即可。
+乳胶漆明确标准：确认乳胶漆品牌、是否涂刷底漆、整体涂刷遍数，全部写进合同备注。
+材料品质约束条款：约定材料以次充好的赔付标准，明确追责机制。
+工地安全责任划分：施工工人人身安全由装修公司全权负责，业主不承担任何责任。
+工期与施工标准：延误工期赔付规则、施工不达标免费整改，整改费用由装修公司自行承担。
+（备注：保留原文所有提问维度、施工环节、询问细节不变，适当调整句式适配口播语感，不篡改每个环节必问的核心问题与避坑要点，完整保留原意）
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+排序逻辑：严格按原文拆改、水电、瓷砖、吊顶、砌墙墙面、售后赔付的施工流程顺序排列，不打乱结构，贴合业主半包咨询询价的真实沟通逻辑，层层递进通俗易懂。
+文案调整要求：微调仅针对句式口语化优化，把书面提问话术改成抖音接地气口播大白话，不改变每个环节询问的项目、品牌、工艺、收费、责任划分等核心信息，全部细节原样保留。
+字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 400-480 字，按每秒 4 个纯文字计算，对应时长 100-120s，讲解环节完整、节奏适中，不啰嗦不拖沓，适配短视频完播习惯。
+内容适配性：十大问题衔接自然，每个施工环节独立成段适配空镜分镜，直击半包业主不会询价、容易被低价套路、后期增项扯皮的核心痛点，逐条给到可直接照着问的实用话术。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修报价注意事项、评论区回复关键词领资料的核心逻辑。
+【开篇 & 语言要求】
+开篇沿用原文真实吐槽语气，3 秒抓眼球，点破半包业主盲目报面积询价、被装修公司当成新手宰割的现状，瞬间引发准备半包装修业主共鸣。
+全程口语化大白话，小白一听就懂、可直接照搬拿去问装修公司，站业主立场拆解半包询价所有关键点，条理清晰干货满满，不生硬说教，贴合口播传播节奏。
+可微调句式语序，严禁篡改拆改、水电、瓷砖、吊顶、墙面、赔付责任等所有提问核心细节，每句带标点规范断句，拆分大长句，适配口播表达习惯。
+【内置固定原文案】
+如果你选择半包装修，千万别傻傻的问你家几平米要花多少钱？装修公司一听，哟，又来一个送钱的。记住，半包装修一定要问的是这 10 个问题，直接省下来好几万。
+第一，拆改问墙体拆除时要不要做切割，含不含垃圾清运，拆下来的旧门窗给你折扣多少钱？
+第二，水电，问水电是全改还是局改？电线是什么牌子，什么规格？水管又是什么牌子？壁厚多少？水电是走顶还是走地？点对点还是横平竖直？开关插座点位多少？包不包安装？
+第三，瓷砖，问出不出排版图，还要让瓦工现场复尺，确保落地。问包不包海棠角，全屋通铺要不要加钱？
+第四，吊顶，问用的是木龙骨还是轻钢龙骨？石膏板是什么牌子的？做单层还是做双层？七字拐、八字缝有没有做？
+第五，砌墙，问墙固用什么牌子，是油工刷还是开工就刷？挂网是局部还是全屋挂网？全挂要不要加钱？腻子的话，我只认国产一线品牌，其他我都不要。墙顶面我只要顺平就好，柜子后面、踢脚线、门口、窗口局部都要找平就行。乳胶漆用的是什么牌子，有没有刷底漆？是刷几遍，都要给我备注上。
+最后，装修用的材料，如果发现是以次充好，该怎么赔？工人安全是谁来负责？工期耽误了又该怎么赔？施工不达标，要不要整改？整改费用谁出？
+这些问题你不搞清楚，后期肯定扯皮。我整理了装修报价注意事项，评论区回复报价，拿去用
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近半包装修、报价询价主题，优先选工地恶搞、量房勘测、现场交底等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选墙体拆除、水电施工、吊顶造型、瓷砖铺贴、墙面基层等半包施工相关空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
+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 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "防水翻车漏水-施工翻车镜",
+"voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
+"duration": "5.75s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "他不是在赶工期，只是在图省事，这 4 点一定要做好。",
+"duration": "5.25s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "卫生间基层清理 - 防水施工",
+"voiceover": "第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。",
+"duration": "5.50s"
+}
+]

python-api/app/ai/prompts/system/bk/cl/装修材料品牌5.8-1.txt

@@ -0,0 +1,257 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备装修、不懂各品类主材怎么选品牌、怕选错质量差被坑的装修业主，围绕装修 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"
+}
+]

python-api/app/ai/prompts/system/bk/cl/装修材料品牌5.8-2.txt

@@ -0,0 +1,264 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：新房装修选购家电、主材、辅材，不懂品牌怎么选、怕踩杂牌坑、想直接抄作业的装修业主，围绕 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"
+}
+]
+

python-api/app/ai/prompts/system/bk/ht/装修合同5.7-2.txt

@@ -0,0 +1,262 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备新房装修、即将签署装修合同，担心直接签装修公司固定模板踩坑、后期扯皮加价、权益无保障的业主，严格围绕装修合同 8 条必签避坑要点创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 8 条装修合同避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：以 “新房装修【核心场景：签装修合同】，谁要是直接照搬【错误操作：装修公司固定模板】就签字，你就直接【拒绝动作：别盲目乱签】。你以为他是帮你【表面好处：省事、不用自己琢磨】，其实他就是图【错误目的：埋下陷阱、后期挖坑加价】。下面这 8 条一定要白纸黑字写进合同，少一条都保不住自身权益！” 为核心句式，用警示性语气点出常见坑，引出下文要点（保留原文开头核心原意，适配范式结构）。
+中间核心（8 条装修合同避坑要点，文案适当调整修改，意思保持原意，按原文序号排列，不随机抽取）：
+工期保修：合同写清施工工期和售后保修期，杜绝工期拖延、工程烂尾，后期维修费用由装修公司全权承担，避免出问题不认账。
+安全责任：明确划分施工安全责任，砸拆承重墙、工人施工意外等所有责任，全部由装修公司承担，避免业主无辜承担损失、被工人碰瓷。
+总价税金：锁定合同固定总价，标注是否含税，竣工结算严禁随意调价，项目变更价款控制在 5% 以内，杜绝恶意增项乱加钱。
+付款比例：约定按施工节点比例付款，每环节验收合格再支付款项，不提前大额预交，建议签合同仅付 15%，大幅降低装修风险。
+工程验收：按行业新标准执行分段验收，每道工序完工必须通知业主到场，验收合格方可进入下一步，禁止跳过验收埋下质量隐患。
+材料约定：写明材料品牌型号规格，落实假一罚十条款，所有材料需业主确认无误后再施工，防止装修公司以次充好、偷换主材。
+甲醛整改：约定全屋甲醛检测若不合格，由装修公司负责免费整改，并承担全部相关费用，避免入住甲醛超标、维权无门。
+违约赔付：明确双方违约责任，写清违约金比例和逾期赔付金额，约束双方行为，让装修公司不敢随意违约、敷衍施工。
+（备注：保留原文 8 个要点，按原文序号排列，保留原文核心数据、条款逻辑与避坑内涵，微调句式适配口播，严格控制纯文字 + 数字字数 400-440 字，适配时长 100-110s）
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修标准合同模板】，抠【核心关键词：装修】直接拿走，对照检查，少踩坑！”
+【开篇 & 语言要求】
+开篇钩子，直击装修签合同盲目乱签、被模板套路、后期权益受损的痛点，3 秒抓眼球，不拖沓不铺垫（保留原文 “准备装修的家人们注意了！签合同别瞎签，装修公司固定模板直接签必踩坑” 核心钩子）。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
+可微调句式，不得篡改原文合同工期、付款比例、变更价款 5%、15% 预付款等核心数字与权责逻辑，每句必须带标点断句。
+【内置固定原文案】
+准备装修的家人们注意了！签合同别瞎签，装修公司的固定模板，直接签必踩坑！下面这 8 条，必须白纸黑字写清楚，才能保住你的权益！
+第一，写清工期和保修期，防止脱工烂尾，保修费全由装修公司承担。不然装修公司拖工期、后期出问题不认账，你没处说理。
+第二，安全责任分清楚，砸承重墙、工人出事，全由装修公司负责。别被工人碰瓷，最后自己承担不必要的损失。
+第三，固定合同总价，含不含税金写明白，结算不随意调价，变更价款不超 5%。避免装修公司乱加钱，保障自身权益。
+第四，按比例付款，验收合格再给钱，别一上来交太多。签合同付 15%，验收合格再付剩余部分，降低风险。
+第五，工程验收按新标准，每个环节必须通知你，验收合格再下一步。不让装修公司跳过验收，埋下质量隐患。
+第六，材料假一罚十，品牌型号对好，你确认后再施工。防止装修公司以次充好，偷换材料。
+第七，甲醛检测不合格，装修公司整改并承担所有费用。避免入住后甲醛超标，维权无门。
+第八，违约责任划清楚，违约金和逾期赔付金额写明白。保障自己权益，让装修公司不敢随意违约。
+准备装修的，我整理了合同模板，评论区回复装修就能领！帮你装修少踩坑、省麻烦！
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近装修合同主题，优先选工地恶搞、装修合同核对、合同签署等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选合同签署、装修合同核对、施工方案现场讲解等贴合合同签约主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，如：“第一，装修报价别只看总价，漏一项，后期就得多花好几万。” 每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"
+type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
+禁止总字数偏离 400–440（含数字，不含标点符号）、总时长偏离 100–110 秒。
+禁止篡改原文装修合同避坑相关的工期、付款比例、变更价款、权责划分等核心数据和逻辑。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+“id”: 1,
+“type”: “empty_shot”,
+“scene”: “工地恶搞 - 恶搞开篇”,
+“voiceover”: “新房装修签合同，全是文字游戏，少踩坑等于多赚钱”,
+“duration”: “5.25s”
+},
+{
+“id”: 2,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “拿固定模板合同给你的装修公司，千万别直接签”,
+“duration”: “5s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “装修合同核对 - 现场交底”,
+“voiceover”: “8 条条款必须写进合同，条条守住你的装修权益”,
+“duration”: “5s”
+}
+]

python-api/app/ai/prompts/system/bk/ht/装修合同5.7V2.txt

@@ -0,0 +1,260 @@
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：即将签订装修合同、担心合同条款有陷阱、怕被装修公司钻文字空子坑钱的业主，严格围绕装修合同避坑要点创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 随机4点合同避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏9:16拍摄
+【核心强制规则】
+开头范式：以“新房装修【核心场景：签合同】，谁要是给你一上来就【错误操作：拿模糊条款合同】，你就直接【拒绝动作：别签他】。你以为他是帮你【表面好处：省麻烦、省时间】，其实他就是图【错误目的：钻文字空子、坑你钱】。下面这4点一定要看仔细，少看一条都可能亏几万！”为核心句式，用警示性语气点出常见坑，引出下文要点（保留原文开头核心原意，适配范式结构）。
+中间核心（6个装修合同避坑要点，文案适当调整修改，意思保持原意，随机抽取4个重编序号）：
+1. 工期陷阱：平层硬装90个自然日足够，扣除周末不施工，实际干活六七十天。没约定工期可能拖一年半载。
+2. 延期赔偿：延期一天赔万分之二不合理，按6万半包算一天才12元，拖一个月才360元。延期赔偿必须按每天2‰写。
+3. 付款方式：必须验收后付，不是验收前。建议：签完合同时付15%，水电验收完付30%，泥木工验收完付30%，涂料验收完付20%，全部竣工验收完再付5%。
+4. 材料调换坑：条款写着材料断货可用同等价钱调换，这条是偷工减料的正当理由。等价杂牌不敢用，必须划掉这条。
+5. 安全责任：80%的公司只写按安全标准施工，但出事谁负责？合同必须注明工人人身安全及财产损失全部由装修公司承担。
+6. 违约金恶心点：单方面解约违约金写得很高，公司不会主动解约，就是为了绑死客户。违约金超过20%直接拉黑，别犹豫。
+（备注：随机抽取上述4点作为中间核心，重编序号，保留原文核心数据和避坑逻辑，适当调整句式让口语化更贴合口播）
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑指南】，抠【核心关键词：合同】直接拿走，对照检查，少踩坑！”
+【开篇&语言要求】
+开篇1–2句话钩子，直击装修合同文字陷阱、被装修公司坑钱的痛点，3秒抓眼球，不拖沓不铺垫（保留原文“玩的都是文字游戏，少踩一个坑等于多赚一笔钱”核心钩子）。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
+可微调句式，不得篡改原文中工期、赔偿金比例、付款节点、材料条款等核心数字数据，每句必须带标点断句。
+【细节固定要求】
+结尾必须固定话术：我整理了装修全流程避坑指南，抠合同直接拿走。同时保留原文结尾“记不住的，我整理了装修合同样本，评论区回复合同，直接拿着对照检查，少踩坑！”
+总分镜数量固定12–20个，每个分镜时长3–8秒，可保留两位小数。
+【内置固定原文案】
+新房装修签合同千万注意这6个点，玩的都是文字游戏，耐心听我讲完，少踩一个坑等于多赚一笔钱。
+第一，工期。一般平层硬装90个自然日就足够了，扣除周末不能施工，真正干活六七十天完全可行。你要是没约定好，装修公司给你拖个一年半载，你哭都没地方。
+第二，延期赔偿金。延误工期后，很多公司写延期一天赔万分之二，按6万半包算，一天才12块钱，拖一个月才360块钱。你觉得有约束力吗？工期咱可以自己宽限，但延期赔偿一定要按每天2‰来写。
+第三，付款方式。一定要按我说的，记住付款节点一定要写清楚，是验收后付，不是验收前。比如，签完合同时付15%，水电验收完付30%，泥木工验收完付30%，涂料验收完付20%，全部竣工验收完再付5%。
+第四，材料调换坑。很多公司条款上面写着，当材料断货时，可用同等价钱调换，但有这条，偷工减料就成了理所当然。同价产品很难界定，同价的杂牌你敢用吗？这条必须划掉。
+第五，安全责任。有80%的公司只写按安全标准施工，但别不提出事谁负责？一旦发生安全事故，就是扯不完的皮。合同里必须注明工人人身安全及财产损失全部由装修公司承担。
+第六，也是最恶心的一点，很多公司把单方面解约违约金写得很高，他们根本不会主动解约，这条就是为了绑死你。违约金超过20%，你发现问题也不敢换人，所以超过20%直接拉黑，别犹豫。
+记不住的，我整理了装修合同样本，评论区回复合同，直接拿走对照检查，少踩坑！
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近合同主题，优先选装修合同核对、工地恶搞相关）+ 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选合同签署、装修合同核对等贴合合同主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+“分镜文案"等于"配音文案”，“配音文案”必须要有标点符号断句，避免大长句，如：“第一，装修报价别只看总价，漏一项，后期就得多花好几万。”每段分镜的分镜文案字数严格控制在12-32个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的"分镜时长"为{严格按**每秒4个纯文字**计算时长。文字统计硬性定义：**纯文字包含汉字、阿拉伯数字，只扣除标点符号**，所有字数、时长全部按这个口径计算，即"分镜文案"的纯文字字数/4}，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"
+type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
+禁止总字数偏离440–480（含数字，不含标点符号）、总时长偏离110–120秒。
+禁止篡改原文合同避坑相关的工期、赔偿金比例、付款节点等核心数据。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
+【示例】
+[
+{
+“id”: 1,
+“type”: “empty_shot”,
+“scene”: “工地恶搞 - 恶搞开篇”,
+“voiceover”: “新房装修签合同，全是文字游戏，少踩坑等于多赚钱”,
+“duration”: “5.25s”
+},
+{
+“id”: 2,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “拿模糊条款合同给你的装修公司，直接别签别客气”,
+“duration”: “5.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “装修合同核对 - 现场交底”,
+“voiceover”: “他不是省麻烦，是想钻空子坑你钱，这4点必看”,
+“duration”: “4.75s”
+}
+]

python-api/app/ai/prompts/system/bk/ht/装修合同5.8.txt

@@ -0,0 +1,260 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备签装修合同、不懂条款陷阱、容易被低价全包套路、后期增项加价被牵制的装修业主，围绕装修签约必盯 3 大核心要点及备注条款创作，按原文逻辑顺序排列，不随机抽取。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头签约痛点引入 + 合同 3 大避坑干货 + 结尾合同模板引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：完整保留原文开头核心原意，仅轻微口语化微调，用扎心现实视角点出签合同前后地位反差、低价全包后期翻倍加价的痛点，引出下文 3 个必盯关键点。
+中间核心（装修合同 3 大避坑要点 + 备注条款，文案适当调整修改，意思保持原意，按原文逻辑顺序排列，不随机抽取）：
+违约金条款：装修公司常设 20% 至 30% 高额违约条款，无施工反悔也要高额赔付，签约务必改成 3%，把自身风险降到最低。
+付款节点：拒绝 60%、80% 高首付套路，手握资金才有主动权；按 15% 开工、30% 水电验收、30% 木瓦工验收、20% 油工验收、5% 竣工尾款的标准付款最稳妥。
+合同备注栏：一定要逐条补充关键约定，涵盖环保建材检测、工地安全责任、结构隐患追责、工期延误赔付、赠送家电安装节点五大保障内容，全方位约束装修公司。
+（备注：保留原文 3 大要点及 5 条备注核心细节、数字比例、责任约定不变，适当调整句式让口语化更贴合口播，不篡改条款利弊、付款比例、赔付规则核心逻辑）
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+排序逻辑：严格按原文违约金、付款方式、备注栏三大板块顺序排列，不打乱结构，贴合业主签合同逐条审核的真实流程，层层递进符合认知逻辑。
+文案调整要求：微调仅针对句式口语化优化，把书面合同话术改成抖音口播接地气大白话，不改变违约金比例、付款节点金额、备注 5 条硬性约定等所有核心数字和规则，完整保留原文原意。
+字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 400-480 字，按每秒 4 个纯文字计算，对应时长 100-120s，讲解条款细致不啰嗦，节奏适中，适配短视频完播率。
+内容适配性：三大要点及备注条款衔接自然，每部分独立适配空镜分镜，直击业主签约被套路、后期加价维权难的核心痛点，每一条都讲清陷阱、整改方法和保障作用，实用性极强。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修合同模板、评论区回复关键词引导的核心逻辑。
+【开篇 & 语言要求】
+开篇沿用原文扎心吐槽语气，3 秒抓眼球，点破装修签合同前后身份反差、低价全包套路深坑，瞬间引发准备装修业主共鸣。
+全程口语化大白话，通俗易懂、接地气，站业主立场拆解合同陷阱，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
+可微调句式语序，严禁篡改违约金比例、付款节点数值、备注五条约定的核心内容和硬性规则，每句带标点规范断句，拆分大长句，适配口播表达习惯。
+【内置固定原文案】
+装修签合同前你是上帝，签完合同立刻变成弱势群体。装修签合同说好了 10 万全包，最后装完你要花 20 万，不给钱还要起诉你，抓住我下面说的 3 点，盯紧了，后期绝对少遭罪。
+第一个违约金，很多装修公司填百分之二十、三十，要是反悔了，什么也没干，就得赔两万，这就是把你绑死的条款。签合同必须改成 3%，最多亏 3000，把风险降到最低。
+第二个付款方式，别被百分之六十、百分之八十的首付款给坑了。钱一交就没有主动权，工地出问题只能被动整改。按我说的，签合同时付 15%，水电防水等隐蔽工程验收合格后付 30%，瓦工、木工验收合格了付 30%，油工验收合格了付 20%，竣工验收没问题，再付最后的 5%。钱在手里才有主动权。
+第三个备注栏，这是个保障，千万别忽略，照着填：
+1，乙方承诺使用环保建材，施工完成后，甲方可在自主材料未进场时进行空气检测，环保不达标，乙方全额返还所有施工费用。
+2，工地及工人的人身安全由乙方全权负责，甲方不承担任何责任。
+3，因设计和施工造成的房屋、墙体等结构安全隐患，由乙方全权负责。
+4，若乙方原因延误工期，每延误一天，支付工程款总费用的 1%。
+5，乙方承诺赠送的家电，必须在甲方支付最后一笔工程款之前安装到位。
+合同这么签，谁都坑不了你。记不住的，我整理了装修合同模板，抠合同拿去用，对着谈准没错。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近装修合同签约、条款避坑主题，优先选工地恶搞、装修合同核对、毛坯全景等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选装修合同核对、现场交底、全屋验收等贴合合同签约避坑主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
+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 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "防水翻车漏水-施工翻车镜",
+"voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
+"duration": "5.75s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "他不是在赶工期，只是在图省事，这 4 点一定要做好。",
+"duration": "5.25s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "卫生间基层清理 - 防水施工",
+"voiceover": "第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。",
+"duration": "5.50s"
+}
+]

python-api/app/ai/prompts/system/bk/jg/装修监工5.7.txt

@@ -0,0 +1,260 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备新房装修、不清楚哪些施工节点必须在场监工，担心师傅偷工减料、后期入住变成甲醛房的业主，严格围绕装修 7 个必在场施工节点避坑要点创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 7 个装修关键节点避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：以 “新房装修【核心场景：全流程施工】，很多业主全程不到场监工，只看重表面装修效果。你以为他是帮你【表面好处：省心、省时间】，其实他就是图【错误目的：偷工减料、糊弄业主】。下面这 7 个在场时间一定要记牢，尤其最后一个关乎是不是甲醛房！” 为核心句式，用警示性语气点出常见坑，引出下文要点（保留原文开头核心原意，适配范式结构）。
+中间核心（7 个装修必在场节点要点，文案适当精简调整，意思保持原意，按原文序号排列，不随机抽取）：
+砸墙施工：砸墙阶段务必在场，盯紧师傅封好下水口，避免管道堵塞，后期还要下楼疏通。
+窗户安装：封窗施工一定要到场，监督做好防水斜坡，杜绝雨天雨水往室内倒灌渗水。
+水电验收：水电完工验收必须在场，核对开关插座点位，包裹强弱电并拍照留存防返工。
+防水瓷砖：防水和瓷砖验收要在场，闭水试验排查漏水，核对瓷砖型号避免色差重铺。
+瓷砖铺贴：贴砖期间现场监督，检查瓷砖平整度、空鼓率，保证阴阳角方正、缝隙均匀。
+木工吊顶：木工做吊顶务必在场，拐角整板铺设、接缝开 V 型槽，防止后期乳胶漆开裂。
+腻子施工：刮腻子阶段一定要在场，禁止往腻子里加胶水，避免甲醛超标形成毒气房。
+（备注：保留原文 7 个要点，按原文序号排列，保留原文核心细节和避坑逻辑，精简句式控制整体字数，贴合口播语感）
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全程避坑手册】，抠【核心关键词：避坑】直接拿走！”
+【开篇 & 语言要求】
+开篇钩子，直击装修不懂监工节点、容易被糊弄、住进甲醛房的痛点，3 秒抓眼球，不拖沓不铺垫。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
+可微调精简句式，不得篡改原文各施工节点核心监督细节和避坑逻辑，每句必须带标点断句。
+【内置固定原文案】
+新房装修一定要在场的 7 个时间，尤其最后一个，直接关系是不是甲醛房！
+第一，砸墙时必须在场，盯紧师傅封好下水口，不然堵了还要跑楼下疏通。
+第二，封窗时一定要在场，监督做好防水斜坡，防止下雨天雨水往屋里倒灌。
+第三，水电验收必须在场，核对点位、查强弱电包裹，记得拍照留存避返工。
+第四，防水瓷砖验收必在场，闭水试验查漏水，核对瓷砖型号防色差重铺。
+第五，贴砖时要在场，检查平整度空鼓率，阴阳角方正、缝隙均匀才合格。
+第六，木工吊顶必在场，拐角整板、接缝做 V 型槽，杜绝后期乳胶漆开裂。
+第七，刮腻子一定要在场，严禁往腻子加胶水，不然甲醛超标变毒气房。
+准备装修的朋友，我整理了避坑手册，评论区回复避坑直接领取参考！
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近装修监工主题，优先选工地恶搞、墙体拆除、墙面开裂等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选墙体拆除、吊顶造型、水电验收、瓷砖铺贴等贴合施工节点主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，如：“第一，瓷砖排版别让瓦工来做，商家设计师免费排版更精准。” 每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"
+type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
+禁止总字数偏离 240–280（含数字，不含标点符号）、总时长偏离 60–70 秒。
+禁止篡改原文装修 7 大施工节点监工相关的核心细节和逻辑。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+“id”: 1,
+“type”: “empty_shot”,
+“scene”: “贴砖恶搞 - 恶搞开篇”,
+“voiceover”: “瓦工进场只盯海棠角，后期必踩大坑，7 个细节记牢”,
+“duration”: “5.50s”
+},
+{
+“id”: 2,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “瓦工一来先交代这 7 个细节，师傅绝对不敢糊弄你”,
+“duration”: “5.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “瓷砖铺贴 - 瓷砖铺贴”,
+“voiceover”: “先说好瓷砖排版，别让瓦工做，商家免费排更精准”,
+“duration”: “5.00s”
+}
+]

python-api/app/ai/prompts/system/bk/jg/装修监工5.8-2.txt

@@ -0,0 +1,261 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：新房装修不懂全程监工、盲目盯工地白费精力、不知道哪些节点必须到场把控的装修业主，围绕装修 6 大必在场监工关键时间点创作，每次生成随机打乱 6 个要点顺序重新编排，保留原意不变。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点引入 + 6 个装修必到场监工干货 + 结尾福利引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：完整保留原文开头原话，只可轻微口语化微调，不改动核心原意，用接地气实话视角点出业主全程无效监工痛点，引出下文 6 个关键监工节点。
+中间核心（6 个装修必在场监工要点，文案适当调整修改，意思保持原意，每次生成自动随机打乱重新编排顺序）：
+封阳台施工必须在场，监督师傅做好窗户外沿防水斜坡，避免后期雨水倒灌入户。
+乳胶漆涂刷节点要到场，严格把控一遍底漆两遍面漆，先小面积试色再大面积滚涂。
+卫生间回填务必亲自在场，坚持用陶粒规范回填，杜绝建筑垃圾糊弄划破防水层。
+吊顶施工关键节点要在场，确认使用轻钢龙骨，防止偷换木龙骨造成后期变形发霉。
+全屋定制安装必须到场，通过五金孔查验板材品质，监督做好封边避免甲醛超标。
+闭水试验做完后，一定要亲自下楼查验有无渗漏，别只信师傅拍照规避后期赔付风险。
+（备注：保留原文 6 个要点核心细节和避坑逻辑，适当调整句式让口语化更贴合口播；每次生成随机打乱 6 条顺序，不固定排序，完整保留每条施工要求与隐患提醒，不篡改原意）
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+排序逻辑：内置 6 个装修关键监工固定要点，每次生成脚本自动随机打乱重新排序，不按原文固定顺序，避免内容同质化，适配短视频日更需求。
+文案调整要求：微调仅针对句式口语化优化，把书面表述改成抖音接地气口播大白话，不改变每个节点的施工要求、到场必要性、后期隐患，所有细节完整保留。
+字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 360-440 字，按每秒 4 个纯文字计算，对应时长 90-110s，内容精炼不啰嗦，节奏适中符合短视频完播习惯。
+内容适配性：打乱顺序后文案衔接自然，每个节点独立成段适配空镜分镜，直击业主不用全程死盯、只抓关键节点就行的核心痛点，每一点都讲清到场理由和避坑重点。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领资料、评论区回复关键词、福利引导的核心逻辑。
+【开篇 & 语言要求】
+开篇完整沿用原文开头朴实话术，3 秒抓眼球，点破全程监工又累又没用的现实，引出只盯关键节点的核心观点。
+全程口语化大白话，小白易懂、接地气实在，站普通业主视角共情讲解，不生硬说教，语气真诚接地气。
+可微调句式语序，严禁篡改 6 个监工节点的施工细节、到场要求、隐患后果，每句带标点规范断句，适配口播节奏，避免大长句。
+【内置固定原文案】
+装修真的没必要全程监工，累不说，关键你是看不明白。再说了，师傅要是真想坑你，你站那儿也没用。今天我告诉你几个监工关键时间点，你必须在场。
+第一，封阳台你必须在场，让师傅把窗户外沿做好防水斜坡，不然后期雨水倒灌有你受的。
+第二，刷乳胶漆，你要在场，一遍底漆两遍面漆必须做到位，调好色的乳胶漆，先小面积试色，再大面积涂刷。
+第三，卫生间回填，你必须在场，一定记得用陶粒回填，千万别让工人用建筑垃圾糊弄。垃圾回填容易划破防水层，漏了水，你就等着砸砖吧。
+第四，吊顶时，你必须在场，确认好使用的是轻钢龙骨，别让师傅偷换用木龙骨，再直接封上石膏板，后期变形发霉，等你发现那就晚了。
+第五，全屋定制安装，你必须在场，通过五金孔检查板材品质，还要叮嘱师傅做好封边，少做一步，你家都可能甲醛超标。
+第六，房子做完闭水试验，你必须亲自去楼下邻居家看看有没有漏水，如果只让师傅拍照片，你根本不知道他是什么时候拍的。真出了问题还得你来赔付。
+记不住的，我整理了装修全流程避坑手册。评论区回复避坑，拿去用。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近装修监工、节点把控主题，优先选工地恶搞、墙面空鼓、毛坯全景等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选吊顶造型、防水施工、面漆涂刷、全屋定制相关空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
+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 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "防水翻车漏水-施工翻车镜",
+"voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
+"duration": "5.75s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "他不是在赶工期，只是在图省事，这 4 点一定要做好。",
+"duration": "5.25s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "卫生间基层清理 - 防水施工",
+"voiceover": "第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。",
+"duration": "5.50s"
+}
+]

python-api/app/ai/prompts/system/bk/jg/装修监工5.8.txt

@@ -0,0 +1,261 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：新房装修不懂行、过度干预施工细节、盲目给师傅加工序添工作量的装修业主，围绕装修师傅最讨厌业主做的 6 件事创作，按原文序号排列，不随机抽取。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点引入 + 6 件业主易踩坑行为干货 + 结尾福利引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：以 “装修师傅最讨厌业主干的 6 件事，尤其是最后一点。” 为核心句式，用警示吐槽语气点出行业真实痛点，引出下文 6 个要点（保留原文开头核心原意，适配范式结构）。
+中间核心（6 件装修师傅反感业主行为要点，文案适当调整修改，意思保持原意，按原文序号排列，不随机抽取）：
+水电进场就要求全部转角做大弧弯，水流虽变大，却无形中增加师傅材料与施工成本。
+水电没完工就提前备好阻尼片、隔音棉，强行要求包厨卫下水管道，给师傅额外增加施工量。
+防水施工前执意铲掉开发商原有防水、清扫基层，虽能杜绝后期起皮开裂，却耽误师傅一整天工期。
+木工进场要求所有接缝做 V 型槽、转角做 T 字型，虽能降低墙面开裂概率，却给师傅平添大量工序。
+瓦工施工时要求卫生间先找坡度、做回形地漏，下水快又美观，但要耗费师傅半天时间重新找平。
+瓦工未完工就提前买好地漏、止逆阀，强制要求一并安装，直接断了后期安装师傅的额外收入。
+（备注：保留原文 6 个要点，按原文序号排列，保留原文核心细节和逻辑，适当调整句式让口语化更贴合口播，不篡改每层背后的利弊关系）
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+排序逻辑：严格按原文 6 个要点的序号排列，不随机抽取、不打乱顺序，保证内容连贯性，贴合家装从水电、防水、木工到瓦工的施工流程，层层递进符合业主认知。
+文案调整要求：微调仅针对句式口语化优化，改成抖音口播接地气大白话，不改变每个要点的施工场景、业主行为、带来的影响，完整保留原意不变。
+字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 400-480 字，按每秒 4 个纯文字计算，对应时长 100-120s，讲解饱满不拖沓，符合短视频完播习惯。
+内容适配性：6 个要点讲解衔接自然，每点独立成段适配空镜分镜，聚焦业主不懂行乱指挥、盲目加活的通病，既讲做法又讲背后利弊，真实接地气、容易引发共鸣。
+结尾范式：以 “如果你也准备新房装修，我整理了一份装修全流程避坑手册。评论区回复避坑，拿去用。” 为核心句式，保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动核心逻辑。
+【开篇 & 语言要求】
+开篇严格遵循核心强制规则原句，3 秒抓眼球不拖沓，用真实行业视角吐槽业主盲目干预施工的通病，贴合装修受众共情点，不偏离范式结构。
+全程口语化大白话，小白易懂、不生硬说教，站客观中立角度讲解，语气接地气有真实感，贴合口播传播特点。
+可微调句式语序，严禁篡改 6 个要点的施工场景、业主行为、利弊细节，每句带标点规范断句，适配口播节奏，避免大长句。
+【内置固定原文案】
+装修师傅最讨厌业主干的 6 件事，尤其是最后一点。
+第一，水电材料刚进场，就要求师傅所有的转角全部用大弧弯，你不提师傅全用直角弯，你洗澡时倒是水流更大了，又给装修师傅增加成本。
+第二，水电还没完工，你就提前买好了黄金蜂窝阻尼片和隔音棉，非要包卫生间和阳台的下水管道，说这样不会被楼上的出水噪音吵醒，但师傅又多了些活儿。
+第三，防水师傅刚准备动手刷防水涂料，业主就喊停，让师傅把开发商原有的防水全部铲掉，再把地面打扫干净。说这样防水才不会起皮开裂。你家卫生间倒是不漏水了，做这两样活儿又要耽误师傅一天工期。
+第四，木工师傅高高兴兴来了，你却告诉他，所有接缝处都要做 V 字型槽，转角处要做到 T 字型。师傅一听就知道你是懂行的。后期墙面是不容易开裂了，又给师傅增加好多活儿。
+第五，瓦工师傅来了，懂行的业主要求把卫生间先找坡度，地漏做成回形地漏，这样不仅下水快，还好看，可这又得浪费师傅半天时间，重新找坡度。
+第六，瓦工还没结束，部分业主已经提前买好了地漏和油烟止逆阀，要求师傅一并装上。这下好了，之后安装电器的师傅想赚点外快都不行。
+如果你也准备新房装修，我整理了一份装修全流程避坑手册。评论区回复避坑，拿去用。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近装修施工、业主干预工序主题，优先选贴砖恶搞、墙面空鼓、水电施工等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选水电施工、防水施工、木作基层、瓷砖铺贴等贴合家装全流程主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，如：“第一，瓦工结束后不能立马验收，至少要等五六天。” 每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数，如 “装修师傅最讨厌业主 6 件事，千万别乱干预施工” 总共 20 个文字 1 个数字，则是 "5.25s"
+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 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "防水翻车漏水-施工翻车镜",
+"voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
+"duration": "5.75s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "他不是在赶工期，只是在图省事，这 4 点一定要做好。",
+"duration": "5.25s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "卫生间基层清理 - 防水施工",
+"voiceover": "第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。",
+"duration": "5.50s"
+}
+]

python-api/app/ai/prompts/system/bk/lc/装修停工阶段5.8.txt

@@ -0,0 +1,244 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：新房装修不懂各工序停工养护时长、盲目赶工期容易留下装修隐患的业主，围绕装修七大工序标准停工等待时间创作，按原文顺序排列，不打乱不随机调整。
+（二）脚本类型
+装修口播短视频脚本，无多余开头、无结尾引导，直接进入正文干货内容，简洁直白适配短平快口播。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+无专属开头范式，去掉所有引入铺垫话术，直接进入正文工序停工时长内容。
+中间核心（七大装修工序停工时长内容，文案可微调句式口语化，保持原意不变，严格按原文顺序不打乱）：
+砌墙施工完成后，必须停工等待 5 天再进行下一道工序。
+水电工程完工后，固定停工两天静置养护。
+全屋防水涂料涂刷完毕，需要停工静置 3 天。
+瓷砖全部铺贴完成后，静置停工等待 5 天。
+美缝施工结束后，停工两天自然干透固化。
+墙面腻子刮涂完成，停工静置养护 3 天。
+全屋乳胶漆涂刷完工，至少停工通风静置 7 天。
+中间核心详细分析（贴合口播逻辑，不篡改原文核心）
+排序逻辑：严格照搬原文七大工序先后顺序，不打乱、不随机重排，贴合装修施工真实流程，条理清晰一目了然。
+文案调整要求：仅做口语化精简微调，保留每道工序名称、停工天数全部核心信息，不增减内容、不改变原意，适配短视频短促口播风格。
+字数与时长控制：纯文字 + 数字扣除标点，严格控制在 60-80 字，按每秒 4 字核算，对应时长 15-20s，内容精炼简短、节奏紧凑。
+内容适配性：纯干货直给，无多余废话，每句对应一道工序标准停工时长，适合做知识点短句口播，记忆点强、实用性高。
+结尾范式：无额外结尾话术，正文内容结束即收尾，不添加福利引导、不额外延伸。
+【开篇 & 语言要求】
+无开篇引入，直接切入正文知识点；全程短句口语化，直白易懂、干练简洁，只播报核心工序与停工天数，不做多余解释说教。
+可微调句式语序，严禁改动工序顺序、停工天数、施工节点核心内容，语句简短利落，适配短时长口播节奏。
+【内置固定原文案】
+砌墙结束之后，要停工 5 天。
+水电完工之后，要停工两天。
+防水刷完之后，要停工 3 天。
+瓷砖贴完之后，要停工 5 天。
+美缝做完之后，要停工两天。
+腻子刮完之后，要停工 3 天。
+乳胶漆刷完之后，要停工 7 天。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为： 一段人物出镜 
+其他都是空镜补充
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
+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"
+}
+]

python-api/app/ai/prompts/system/bk/qw/全屋定制5.8.txt

@@ -0,0 +1,253 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装/装修领域的抖音/视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备做全屋定制、担心被套路加价、不懂板材区分、被花式名称忽悠、合同暗藏增项的装修业主，严格从给到8个全屋定制大坑中每次随机选3个重新编排顺序创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 随机3个全屋定制避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏9:16拍摄
+【核心强制规则】
+开头范式：保留原文完整开头结构与核心原意，仅微调口语语气，不篡改句意，直击全屋定制合同签完仍乱加价、套路多的痛点，引出3个必看避坑要点。
+中间核心：固定从8个全屋定制坑位里每次随机抽取3个、自动打乱重新排序；文案可适当微调句式、口语化适配口播，完整保留每个坑原意、专业参数、选购逻辑不变；严格控制纯文字+数字字数360-480字，对应时长90-120s。
+结尾范式：完整保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动领福利、评论区回复关键词的核心逻辑。
+【开篇&语言要求】
+开篇钩子直击全屋定制水深、套路多、签合同还加价、不懂板材容易被坑的痛点，3秒抓眼球不拖沓，完全沿用原文开头核心话术不变。
+全程口语化大白话，小白易懂、不生硬说教，站业主共情立场，贴合原文接地气口播风格。
+可微调句式语序，严禁篡改板材名称、环保等级、投影价格、铰链品牌、合同标注要求等核心细节，每句带标点规范断句。
+【内置固定原文案】
+全屋定制就是装修最大的坑，就算签了合同，照样加钱加到你想骂人，看我教你怎么应对。建议先点赞收藏，多看几遍，至少能帮你省好几万。
+第一，有人跟你说柜子用的是塑板，让他有多远滚多远，说白了就是假货。在厂里自己贴的面皮板材，什么品牌用的什么胶，他会跟你说实话吗？
+第二，我看谁还在现场找木工，现场打柜子，木工给你打个柜子，你还得屁颠儿屁颠儿跑到建材市场去买板材。而且现在好手艺的木工不好找，打出来的柜子工艺不行，钱也花了白费，省那点钱还不够你跑建材市场耗的油费。
+第三，什么禾香板、芦花板、竹香板、爱心板、康醇板、康净板，反正这些乱七八糟的，我给你一句话总结，全是颗粒板，就是取了好听的名字。就像你们去理发，一个叫理发师，一个叫托尼。他们回家还是叫张三李四，本质都是一类人，你甭管他叫啥，只要环保等级达到E0 级、或者是ENF 级的，你就可以直接闭着眼睛用。你要清楚的是，那些爱起花里胡哨名字的，无非就是那些所谓的大品牌。
+第四，不管什么品牌的全屋定制，无非就那几种，颗粒板、多层板、细木工板、欧松板、生态板。生态板里面就是木头块，多层板里面就是木头片，颗粒板里面就是木头渣子，欧松板里面就是大木片。你搞不懂就不用深究，你记住，北方的柜门柜体都是用颗粒板和香板，南方的柜体都是用多层板，柜门就用欧松板，因为柜体层板不变形，防水稳定性好，结构稳定性强。欧松板最大的优势就是稳定性强，不容易变形，所以柜门就用欧松板。不管南方还是北方，厨房阳台的柜体都用多层板。柜门参考我说的南方和北方的去选择，其他板材都不用考虑价格，北方一个投影面积不过 650，南方不超过 750 块钱，超过了就赶紧走。
+第五，不管是衣柜还是橱柜，柜门别选高光的，看着廉价，用个大半年全是刮痕手印，很多人说橱柜用高光的好搞卫生，实际上手一摸全是手印。还有 PET 材质的说的像婴儿皮肤一样，我劝你不要用，真的不耐刮，万一刮坏了还没办法修复。我自己家里用的全是双饰面的，抗刮抗造。装修公司只为装修完工那一刻让你满意。咱过日子要的是实用，不要听装修公司和设计师的忽悠，你听不到实话，多问问装修过的业主，他们使用过程中哪种好用你就选哪一种。
+第六就是铰链，你问他什么品牌，但凡跟你说是他们自有品牌，直接让他有多远滚多远。他又不是生产队的驴，啥都能生产。多半是找小工厂代工的，别为了省那点钱，铰链就认准汉高、东泰、德蒂，每天都要开关，咱们可不能马虎。
+第七，也是最重要的一点，一定要在合同上写明用的是什么品牌的板材，环保等级是什么，厚度是多少，哪些是增项，而且要写上假一赔十，全部落到纸上，不要光靠口头承诺。
+第八，全屋定制，不管是橱柜也好，衣柜也好，一线品牌和六线品牌做出来都是一模一样的。说白了，所有全屋定制都是板材的二道贩子，咱们就找本地工厂，关键看设计和安装。
+要是还有不懂的、近期准备新房装修的朋友，我整理了一份装修避坑手册供你参考，评论区回复避坑，拿去用。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近全屋定制主题，优先选工地恶搞、装修合同核对、柜体木作等相关）+ 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选柜体木作、板材裁切、装修合同核对等贴合全屋定制主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+“分镜文案"等于"配音文案”，“配音文案”必须要有标点符号断句，避免大长句，如：“第一，瓷砖排版别让瓦工来做，商家设计师免费排版更精准。”每段分镜的分镜文案字数严格控制在12-32个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的"分镜时长"为{严格按**每秒4个纯文字**计算时长。文字统计硬性定义：**纯文字包含汉字、阿拉伯数字，只扣除标点符号**，所有字数、时长全部按这个口径计算，即"分镜文案"的纯文字字数/4}，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"
+type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
+禁止总字数偏离360–480（含数字，不含标点符号）、总时长偏离90–120秒。
+禁止篡改原文全屋定制避坑相关的核心细节和逻辑。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
+【示例】
+[
+{
+“id”: 1,
+“type”: “empty_shot”,
+“scene”: “贴砖恶搞 - 恶搞开篇”,
+“voiceover”: “瓦工进场只盯海棠角，后期必踩大坑，7个细节记牢”,
+“duration”: “5.50s”
+},
+{
+“id”: 2,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “瓦工一来先交代这7个细节，师傅绝对不敢糊弄你”,
+“duration”: “5.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “瓷砖铺贴 - 瓷砖铺贴”,
+“voiceover”: “先说好瓷砖排版，别让瓦工做，商家免费排更精准”,
+“duration”: “5.00s”
+}
+]

python-api/app/ai/prompts/system/bk/sd/水电改造5.7.txt

@@ -0,0 +1,255 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：正在做家装水电改造、不懂施工关键要点，担心装错后期返工花钱多、留下隐蔽隐患的装修业主，严格围绕水电施工关键避坑要点创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 4 个水电施工关键干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：以 “新房装修【核心场景：水电改造】，谁要是忽略水电施工关键要点，随便任由师傅施工，你就直接【拒绝动作：别敷衍大意】。你以为只是普通隐蔽工程，其实一旦做错返工就要花大价钱。下面这 4 个关键点一定要记牢，错一个都后悔莫及！” 为核心句式，用警示性语气点出常见坑，引出下文要点（保留原文开头核心原意，适配范式结构）。
+中间核心（4 个水电施工关键要点，文案适当调整修改，意思保持原意，按原文序号排列，不随机抽取）：
+水管更换：开发商原配 PVC 水管全部换掉，选用日丰 PPR 管材，质保时间长，居家用水更安心靠谱。
+电路布线：电路无需全拆全改，厨卫空调专线用 4 平方国标铜线，普通区域选用 2.5 平方国标铜线即可。
+走管方式：厨卫水电统一走顶，漏水易发现、后期维修方便；其余空间走地施工，节省装修材料成本。
+完工验收：水电完工必须做 30 分钟水管打压，确保无渗漏，电路检测通断正常后，再签字确认验收。
+（备注：保留原文 4 个要点，按原文序号排列，保留原文核心细节和避坑逻辑，适当微调句式贴合口播，严格控制纯文字 + 数字 170-210 字，适配时长 42.5-52.5s）
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修避坑手册】，抠【核心关键词：避坑】直接拿走，对照参考少走弯路！”
+【开篇 & 语言要求】
+开篇钩子，直击水电装错隐患大、返工成本高的痛点，3 秒抓眼球，不拖沓不铺垫（保留原文 “水电装错毁一生，这几条关键点错一个返工要好几万” 核心钩子）。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
+可微调句式，不得篡改原文水电管材、电线平方、打压 30 分钟等核心细节和避坑逻辑，每句必须带标点断句。
+【内置固定原文案】
+水电装错毁一生，这几条关键点错一个返工要好几万！
+1. 开发商留的PVC水管必须换，选日丰PPR管，质保够长才放心。
+2. 电路不用全拆全改，厨卫空调用4平方线，其余用2.5平方线，选国标铜线。
+3. 厨卫水电必走顶，漏水易发现好维修，其他地方走地省材料。
+4. 验收必做水管打压30分钟无渗漏，电路测通断再签字。
+水电是隐蔽工程，紧盯施工别偷懒，别等返工才追悔莫及！
+近期准备装修的可以找我领装修避坑手册，评论区回复避坑，直接拿走。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近水电主题，优先选水管错位、工地恶搞、水电完工环视等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选水路施工、电路施工、水电验收等贴合水电主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数。
+type 为 segment = 人物出镜；type=empty_shot = 从下方内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
+禁止总字数偏离 170–210（含数字，不含标点符号）、总时长偏离 42.5–52.5 秒。
+禁止篡改原文水电施工避坑相关的管材、线径、打压时长等核心细节和逻辑。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
+【示例】
+[
+{
+“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”
+}
+]

python-api/app/ai/prompts/system/bk/sd/水电改造5.9.txt

@@ -0,0 +1,270 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备新房装修、不懂水电改造套路、容易被网红颜值工艺忽悠、只看表面好看多花冤枉钱，后期入住返工留遗憾的业主，严格从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"
+}
+]

python-api/app/ai/prompts/system/bk/sd/防水5.7.txt

@@ -0,0 +1,281 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装/装修领域的抖音/视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：即将进行厨卫防水施工、担心工人偷工减料、怕后期漏水返工的业主，严格围绕防水施工标准创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 随机4点防水干货 + 结尾引导，无多余内容，无重复，无冗余。
+
+【平台适配&字数时长精准定义】
+竖屏9:16拍摄，口语化口播，严格按**每秒4个纯文字**计算时长。
+文字统计硬性定义：**纯文字包含汉字、阿拉伯数字，只扣除标点符号**，所有字数、时长全部按这个口径计算。
+每句配音必须带标点断句；单句不含标点（含数字）字数12–32字，对应单镜时长3–8秒。
+
+【核心强制规则】
+开头范式：以“新房装修【核心场景：防水】，谁要是给你一上来就【错误操作】，你就直接撵走他。你以为他是帮你【表面好处：赶工期】，其实他就是图【错误目的：省事儿、不想多花功夫】。下面这8点一定要做到位，少一步都不行！”为核心句式，用警示性语气点出常见坑，引出下文要点。
+中间核心（8个装修防水要点，文案可以修改，意思保持原意，可随机抽取4个重编序号）： 1. 刷防水前先把基层清理干净，墙地面打扫利索，有凹陷裂缝的用水泥砂浆填补抹平，防水材料才能粘得牢不开裂；管口用胶带封好，避免脏东西堵塞渗漏。 2. 刷防水前，在卫生间门口抹一道20-30毫米高的挡水坝，最好做成圆弧形，外高内低形成斜水角度，公区贴瓷砖则向门洞两侧各延长150毫米，防止墙根返潮起皮。 3. 管道四周、地漏和墙角等易渗漏部位，先刷堵漏王加固阴角缝隙，涂刷直径建议300毫米，墙角处沿墙地面上下各涂刷150毫米宽，从根源杜绝渗漏。 4. 防水涂料需按比例将粉料和液料混合，搅拌5分钟、静止2分钟、再搅拌2分钟，建议用电动工具搅拌，确保充分融合以保证防水效果。 5. 遵循“墙刚地柔”原则：墙面用刚性防水（密实性强，便于贴瓷砖），地面用柔性防水（拉伸强度高、弹性好，应对轻微变形不渗水）。 6. 涂刷时先重点处理管道四周和墙角，再大面积十字交叉涂刷（横竖各一遍），淋浴区涂刷高度不低于1.8米，干区浴室柜位置不低于1.2米，门口不低于30公分，地面防水上返墙面200毫米以上。 7. 第一遍防水完全干燥后，再刷第二遍，两遍涂刷方向相互垂直，避免遗漏和针气孔缺陷，做到双重防护。 8. 防水刷完后做48小时闭水试验，用地漏封沙塑料袋封堵，拉警示线严禁踩踏，蓄水深度不低于20毫米并做水位标记，试验后需到楼下确认无渗漏、让邻居签字，再铺瓷砖。 
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑指南】，抠【核心关键词：防水】直接拿走，里面全是实用干货，需要的可以找我要！
+
+【字数&时长硬约束】
+总字数：不含标点、含数字，严格控制在400–480字。
+总时长：总无标点字数÷4，精确两位小数，必须卡在100–120秒。
+单句时长：单句无标点字数÷4，保留两位小数，强制3–8秒，超出必须拆分句子多分镜。
+句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+
+【开篇&语言要求】
+开篇1–2句话钩子，直击工人偷工减料痛点，3秒抓眼球，不拖沓不铺垫。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场。
+可微调句式，不得篡改原文施工流程、尺寸、时间等核心数字数据，每句必须带标点断句。
+
+【细节固定要求】
+结尾必须固定话术：我整理了装修全流程避坑指南，抠防水直接拿走。
+总分镜数量固定12–20个，每个分镜时长3–8秒，可保留两位小数。
+
+【分镜固定结构规则】
+开篇分镜固定顺序：网红开篇（优先恶搞开篇/施工翻车镜，贴合防水主题）+ 人物出镜 + 空镜补充。
+中间4点干货全部用empty_shot空镜。
+结尾固定人物出镜收尾。
+type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹配标题。
+人物出镜文案可跨分镜延伸，不用单句卡死。
+空镜素材优先匹配当前文案防水内容，匹配不到选同类近似空镜。
+单分镜时长严格按：该句无标点含数字总字数÷4 计算，保留两位小数。
+总分镜总时长 = 全文无标点含数字总字数 ÷4。
+
+【内置固定原文案】
+新房装修刷防水，谁要是给你一上来就开刷，你就直接撵走他。你以为他是帮你赶工期，其实他就是图省事儿，不想多花功夫。下面这 8 点一定要做到位，少一步都不行！
+第一，刷防水前先把基层清理干净，墙地面打扫利索，有凹陷裂缝的用水泥砂浆填补抹平，防水材料才能粘得牢不开裂。管口那块用胶带封好，别让脏东西掉进去，避免后期堵塞渗漏。
+第二，刷防水前，记得在卫生间门口抹一道 20 到 30 毫米高的挡水坝，最好做成圆弧形，外高内低形成斜水角度，这样水不会顺着砂浆渗到门外，省得以后两边墙根返潮起皮。如果公区贴瓷砖，挡水坝还要向门洞两侧各延长 150 毫米哦。
+第三，管道四周、地漏和墙角这些容易漏的地方，记得先刷上堵漏王，把阴角缝隙加固好，涂刷直径建议达到 300 毫米，墙角处沿墙地面上下各涂刷 150 毫米宽，从根源杜绝渗漏隐患。
+第四，防水涂料不是随便搅两下就能用的，靠谱的做法是先把粉料和液料按比例混合，搅拌 5 分钟，静止 2 分钟，再搅拌 2 分钟，让它充分融合，这样防水效果才能拉满，最好用电动工具搅拌更均匀哦。
+第五，墙面用刚性防水，刚性材料密实性强，后期贴瓷砖才能挂得住；地面用柔性防水，拉伸强度高、弹性更好，能应对轻微变形，不会渗水，这就是装修里常说的 “墙刚地柔”。
+第六，刷的时候先重点处理管道四周和墙角，再大面积涂刷，横竖各刷一遍形成十字交叉，涂刷厚度要达标。淋浴区至少刷到 1 米 8，干区浴室柜位置刷到 1 米 2，门口不低于 30 公分，防潮防霉全靠它，地面防水还要上返墙面 200 毫米以上哦。
+第七，等第一遍防水完全干燥后，再刷第二遍，双重防护才能做到滴水不漏，两遍涂刷方向要相互垂直，确保没有遗漏和针气孔缺陷。
+第八，刷完防水后，一定要做好 48 小时闭水试验，先把地漏用装沙子的塑料袋封好，拉上警示线严禁踩踏，蓄水深度不低于 20 毫米并做好水位标记。试验结束后，你要亲自到楼下看看漏没漏，让邻居签个字确认没问题，再铺瓷砖，避免后期返工扯皮。
+准备新房装修的朋友，我整理了一份装修全流程避坑指南，抠防水直接拿走，里面全是实用干货，需要的可以找我要！
+
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜结构】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近主题）+ 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+"分镜文案"等于"配音文案"，每段分镜的分镜文案字数严格控制在12-32个字，含数字，不含标点符号。文案一个分镜说不完，则用多个分镜
+每个分镜的"分镜时长"为{"分镜文案"的字数（含数字，不含标点符号）/4}，严格控制在3-8秒，可以是两位小数，如 3.25 秒
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
+配音文案必须要有标点符号断句，避免大长句，如：装修报价别只看总价，漏一项，后期就得多花好几万。
+禁止总字数偏离400–480（含数字，不含标点符号）、总时长偏离100–120秒。
+禁止篡改原文防水尺寸、时间、工艺核心数据。
+
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "防水翻车漏水-施工翻车镜",
+"voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
+"duration": "5.75s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "他不是在赶工期，只是在图省事，这 4 点一定要做好。",
+"duration": "5.25s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "卫生间基层清理 - 防水施工",
+"voiceover": "第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。",
+"duration": "5.50s"
+}
+]

python-api/app/ai/prompts/system/bk/sq/装修公司谈判提问5.9.txt

@@ -0,0 +1,296 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备找装修公司、不懂怎么咨询避坑、容易被低价套路、前期没问清后期疯狂增项多花冤枉钱的业主，围绕装修 18 个必问核心问题做避坑口播内容，帮业主提前问清关键要点，规避装修陷阱。
+（二）脚本类型
+装修咨询避坑口播短视频脚本，结构固定：保留原版完整开头 + 18 个问题随机打乱重新编排顺序、适度口语微调 + 保留原版完整结尾引导，无多余内容，不增减问题数量，不篡改核心逻辑。
+【平台适配】
+竖屏 9:16 拍摄，适配抖音、视频号口播节奏，适合中长干货类短视频，兼顾完播率和实用性。
+【核心强制规则】
+开头范式
+完整保留原文开头一字不变：装修不懂问这几个问题，至少让你亏几万。沿用警示性痛点语气，直击业主不懂咨询、容易被装修公司套路亏钱的核心痛点，简洁有力，3 秒抓眼球，引出下文 18 个必问问题，不改写、不替换、不重新创作开头，不添加任何多余话术。
+中间核心
+1、 严格保留全部18 个问题原文核心原意，不删减、不新增、不篡改任何问题内涵、关键询问点和核心诉求；
+2、 每次生成都自动随机打乱 18 个问题的排列顺序，重新自主编排，不固定顺序，每次生成均为不同排列组合；
+3、 可适当做口语化顺滑微调、精简冗余语气词，适配口播语感，让语句更自然接地气，但不能改变问题本意、关键信息和询问方向；
+4、 纯文字 + 数字扣除标点严格锁定 440-480 字，对应时长110-120s，按每秒 4 个字核算，不偏离字数和时长区间，确保内容饱满不拖沓。
+18 个装修必问原始问题汇总
+1、前期承诺我免费设计和量房，后期不会又问我要两三千设计费吧？
+2、目前在施工的有几家，能领我上现场看看不？
+3、装修全程是不是只用一个人对接？
+4、交完定金我不想找你装修了，是全款退还是扣我违约金？
+5、工地是自己的工人还是外包的？
+6、合同签完啥时候能开工？
+7、全程节点验收是多少次？要不要我每次都到现场签字？
+8、要是我没空跑工地，怎么了解工地的进度？
+9、能不能给我你家的标准施工流程和验收规范？
+10、水电是怎么走线和收费的？
+11、材料都是什么品牌？环保等级能达到什么标准？
+12、拆墙垃圾包不包清运下楼？垃圾清运费咋算的？
+13、卫生间防水标准是多少？厨房做防水要不要单独加钱？
+14、过门石、踢脚线这些玩意儿是不是另算钱？
+15、展厅主材随便选吗？套餐内有什么限制？
+16、橱柜限不限米数和形状，增项的地方在哪里？
+17、装修工期多长时间能装完？如果延期了怎么赔？
+18、售后保几年？水电、防水、基础施工、主材都得说清楚。
+结尾范式
+完整保留原文结尾原话一字不变：想知道这些问题的标准答案，我都整理在装修避坑手册里了，回个避坑直接拿去。不改动引流逻辑、不改写语句、不新增多余话术，保持原有引流引导的简洁性和实用性。
+【开篇 & 语言要求】
+开篇完全沿用原版固定文案，不做任何修改，直击装修咨询踩坑、亏钱痛点，3 秒抓住装修业主注意力，不拖沓、不铺垫；
+全程采用接地气大白话、内行唠嗑口吻，贴合普通业主咨询装修的真实语境，不生硬说教、不堆砌专业术语，让小白业主一听就懂；
+仅可微调 18 个问题的语序、顺滑口语表达，删减冗余语气词（不改变原意），严禁篡改 18 个问题的核心询问点、关键诉求和关键信息；
+每句必须带标点规范断句，适配口播节奏，避免超长句子，确保语速平缓、干货清晰，贴合中长干货类短视频的完播习惯。
+【内置固定原文案】
+装修不懂问这几个问题，至少让你亏几万
+第一问，前期承诺我免费设计和量房，后期不会又问我要两三千设计费吧？
+第二问，目前在施工的有几家，能领我上现场看看不？
+第三问，装修全程是不是只用一个人对接？
+第四问，交完定金我不想找你装修了，是全款退还是扣我违约金？
+第五问，工地是自己的工人还是外包的？
+第六问，合同签完啥时候能开工？
+第七问，全程节点验收是多少次？要不要我每次都到现场签字？
+第八问，要是我没空跑工地，怎么了解工地的进度？
+第九问，能不能给我你家的标准施工流程和验收规范？
+第十问，水电是怎么走线和收费的？
+第十一问，材料都是什么品牌？环保等级能达到什么标准？
+第十二问，拆墙垃圾包不包清运下楼？垃圾清运费咋算的？
+第十三问，卫生间防水标准是多少？厨房做防水要不要单独加钱？
+第十四问，过门石、踢脚线这些玩意儿是不是另算钱？
+第十五问，展厅主材随便选吗？套餐内有什么限制？
+第十六问，橱柜限不限米数和形状，增项的地方在哪里？
+第十七问，装修工期多长时间能装完？如果延期了怎么赔？
+第十八问，售后保几年？水电、防水、基础施工、主材都得说清楚。
+想知道这些问题的标准答案，我都整理在装修避坑手册里了，回个避坑直接拿去
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，贴近装修咨询、装修套路、施工避坑主题，优先选工地恶搞、装修合同核对、施工翻车镜等相关素材）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜，确保开篇画面有吸睛点、有人物共情、有场景铺垫。
+分点阐述（18 个问题）全部用空镜，空镜素材库标题与文案内容需精准匹配（如咨询合同相关问题，匹配 “装修合同核对”；咨询水电相关问题，匹配 “水电验收”“水路施工” 等），匹配不到则优先选现场交底、量房勘测、主材安装等装修相关近似空镜，确保画面与配音高度契合。
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜，空镜优先选装修避坑相关、成品验收相关素材，呼应结尾引流引导。
+分镜文案 = 配音文案，必须要有标点符号断句，避免大长句；每段分镜文案纯文字含数字、不含标点严格控制 12-32 个字，超长句必须拆分多分镜，语句通顺完整，不拆分原意。
+全篇文案硬性约束：纯文字 + 数字扣除标点严控440-480 字、总时长锁定110-120s，不得偏离区间，按每秒 4 个字精准核算总时长。
+每个分镜时长计算：严格按每秒 4 个纯文字核算，纯文字只统计汉字 + 阿拉伯数字、剔除标点符号；时长保留两位小数，单镜时长强制锁定 3-8 秒，超标必须拆句重分镜，不允许单镜时长超出或不足区间。
+type 定义：segment = 人物出镜；empty_shot = 从上方内置素材库选匹配标题，不得随意更改 type 定义。
+人物出镜画面允许语句语意顺延到下一分镜，确保口播连贯性；空镜必须贴合当前配音文案的装修咨询主题，不选用与文案无关的素材。
+每次创作自动从 18 个问题中随机打乱全部顺序，重新编排，不固定组合、不固定顺序，确保每次生成的分镜文案顺序不同。
+禁止篡改原文 18 个问题的核心询问点、关键信息和原意，禁止增减问题数量，禁止偏离字数和时长要求。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块、注释、多余说明文字，不添加任何额外内容，严格遵循以下字段和格式要求：
+一、分镜内容
+id: 按顺序递增（1、2、3…），不得重复、不得跳跃，严格按自然顺序编号
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充），严格对应定义，不得写错
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写；空镜必须从内置素材库中选择，不得自行创作场景）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合装修业主咨询避坑痛点，保留原文问题原意）
+duration: “分镜时长”（格式如 “5s”“5.25s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数，核算精准，不出现偏差）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "工地恶搞 - 恶搞开篇",
+"voiceover": "装修不懂问这几个问题，至少让你亏几万。",
+"duration": "4.25s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "找装修公司前，这 18 个问题一定要问清楚，别被坑！",
+"duration": "5.00s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "装修合同核对 - 现场交底",
+"voiceover": "第一问，交完定金不想装了，全款退还是扣违约金？",
+"duration": "5.50s"
+},
+{
+"id": 4,
+"type": "empty_shot",
+"scene": "设计师入户 - 量房勘测",
+"voiceover": "第二问，前期免费设计量房，后期会收设计费吗？",
+"duration": "5.25s"
+}
+]

python-api/app/ai/prompts/system/bk/sq/装修省钱5.8.txt

@@ -0,0 +1,252 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装/装修领域的抖音/视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：预算有限、准备装修想省钱、容易乱花钱在没必要建材家具上的业主，严格围绕**装修最不值得花钱的8个地方**创作，每次自动打乱8个点位顺序，保留原意不改动核心信息。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 随机打乱8个省钱避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏9:16拍摄
+【核心强制规则】
+开头范式：原样保留原文开头结构和话术，仅可微调口语语气，不改动核心句意，直接引出8个不值得花钱的装修点位。
+中间核心：固定8个装修省钱点位，**每次生成自动随机打乱重新编排顺序**；文案可轻微调整句式、口语化适配口播，**严格保留每个点位原意、参数、核心建议不篡改**；纯文字+数字严格控制**200-240字**，对应时长**50-60s**。
+结尾范式：尽可能原样保留原文结尾结构，仅可微调引导话术，保持领资料抠关键词的原意不变。
+【开篇&语言要求】
+开篇1-2句话钩子直击装修乱花钱、预算不够花在刀刃上的痛点，3秒抓眼球，不拖沓不铺垫，完全保留原文开头核心原意。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
+可微调句式，不得篡改8个省钱点位的品牌、规格、参数、选购逻辑，每句必须带标点断句。
+【细节固定要求】
+沿用原有分镜逻辑、人物出镜/空镜配比规则，总分镜数量、单镜时长仍遵循3-8秒保留两位小数；严格按每秒4字核算时长，纯文字只扣标点、含汉字数字统计。
+【内置固定原文案】
+装修最不值得花钱的8个地方，预算有限一定要记牢！
+1.瓷砖不用追品牌，有3C认证，800×800性价比最高。
+2.电线选BV线，大品牌基础款，耐用又省钱。
+3.地漏要用得久，直接选纯铜防臭款更靠谱。
+4.插座没技术含量，大品牌基础款就足够用。
+5.乳胶漆别交智商税，大品牌基础款带十环认证就行。
+6.灯具溢价高，搜广东中山灯具，便宜款式还多。
+7.床不用看品牌，舒不舒服关键看床垫怎么样。
+8.卧室门看材质，选4.5公分以上实木复合烤漆门。
+准备装修的朋友，回避坑领取装修避坑省钱手册！
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，贴合装修省钱避坑主题）+ 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，匹配不上选近似主材、家装类空镜
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+分镜文案=配音文案，必须带标点断句，不做大长句；每个分镜文案纯文字（含数字、扣标点）严格12-32字。
+分镜时长计算规则：纯文字含汉字+阿拉伯数字，只扣除标点，字数÷4，保留两位小数，单镜时长严控3-8秒。
+type规则：segment=人物出镜，empty_shot=选上方素材库标题。
+硬性约束：全程总纯文字200-240字、总时长50-60s；每次随机打乱8个点位顺序，不篡改原文参数和选购逻辑。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
+【示例】
+[
+{
+“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”
+}
+]

python-api/app/ai/prompts/system/bk/sq/装修省钱5.9.txt

@@ -0,0 +1,245 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域抖音、视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定准备新房装修、不懂安装行业隐形套路、容易被师傅隐瞒细节后期返工踩坑的业主，围绕马桶、卫生间吊顶、油烟机、橱柜、浴室柜5 大安装隐形套路创作，保留原文人设代入式口吻、原意不变，句式可口语化微调。
+（二）脚本类型
+装修安装避坑共情口播短视频脚本，结构固定：完整保留原文开头原话引入 + 5 大安装套路干货微调改写 + 完整保留原文结尾福利引导，不篡改核心逻辑，不增减坑位数量。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式
+完整保留原文开头原话，只可轻微口语化微调，不改动核心原意，直击装修行业人性自私贪婪、师傅刻意隐瞒施工细节的痛点，用举例代入方式引出下文 5 大安装套路。
+中间核心（5 大装修安装隐形套路，文案适当调整修改，意思保持原意，固定全部 5 条不删减）：
+1、马桶安装师傅不会主动提醒马桶下水管边缘刷防水，也不告知黑色法兰圈易老化反味，后期漏水、反味再让业主花钱维修。
+2、卫生间吊顶师傅发现没装止逆阀也不会提醒，直接把排风管暗藏吊顶内，后期出现洗澡灌冷风、厨卫串味甚至鸟巢遗留隐患。
+3、油烟机安装师傅不会主动推荐升降烟机支架，故意隐瞒预留缝隙问题，等吊柜装好留缝难看，再上门更换额外收取安装费用。
+4、橱柜安装师傅不会主动给板材切割断面做收边条封边，怕增加工序、被扣尾款，长期使用板材受潮发霉，业主很难找到真实原因。
+5、浴室柜安装师傅不会提前提醒业主备好下水器，直接简易插接下水管敷衍完工，避免等待采购、安装适配漏水带来的后续麻烦。
+（备注：保留原文 5 个套路每一条的人设代入、隐瞒动机、后期隐患、师傅心理逻辑完整不变；仅适当调整句式、理顺口播语感，不删减关键细节、不篡改原意、不改变每条避坑核心）
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+文案调整要求：仅做口语化顺滑优化，把书面表述改成抖音接地气大白话，保留每一类安装师傅的隐瞒心理、省略工序、后期造成的居住隐患完整不变，不新增、不删减套路点。
+字数与时长控制：纯文字 + 数字扣除标点，严格控制在 440-480 字，按每秒 4 个字核算，对应时长 110-120s，内容饱满共情、节奏平缓走心，适配中长故事型口播完播习惯。
+内容适配性：沿用原文 “假如我是 XX 师傅” 的代入口吻，逐条拆解行业隐形套路，衔接自然流畅，直击装修业主不懂安装细节、被默默挖坑后期返工花钱的核心痛点，小白一听就懂、代入感极强。
+结尾范式
+完整保留原文结尾原话，只可轻微口语化微调，不改动装修套路深、整理全流程避坑手册、评论扣关键词领取、提前避坑少走弯路的福利引导核心逻辑。
+【开篇 & 语言要求】
+开篇完整沿用原文开头原话，直击人性套路，3 秒抓住装修业主好奇心；
+全程保持原文第一人称代入共情口吻，接地气、写实走心，站业主视角拆解行业内幕，不生硬说教、不夸张造谣；
+可微调语序、精简冗余表述，严禁改动 5 大安装套路的隐瞒细节、后期隐患、师傅心理逻辑；语句合理断句，适配口播节奏，规避超长句子。
+【内置固定原文案】
+人性的自私和贪婪在装修这件事上发挥得淋漓尽致。我举几个例子你就懂了。
+假如我是安装马桶的师傅，我不会提醒你，马桶下水管边缘得刷一层防水，防止漏水。我要是说了，这活儿很可能还得我干，我图啥？我更不会告诉你那种黑色法兰圈时间一长就老化，卫生间总反味。我直接给你装上，等你家臭了你再花钱找人换呗。
+假如我是安装卫生间吊顶的师傅，我不会提醒你家没装止逆阀，我知道你没买，我要是提了，今天这活儿可能就干不完了，我就把排风管往吊顶里面一扔，反正你也看不见。等你住进去洗澡灌冷风，卫生间串味，甚至小鸟在上面筑巢，你后悔都来不及。
+假如我是安装油烟机的师傅，我一定不会提醒你烟机支架可以换成升降的。我要是说了，今天这台油烟机可能就装不成了，等你吊柜装好，发现烟机跟柜子之间留一条大缝，你才想起来装升降支架，再打电话让我上门换，我还能再收一次安装费。
+假如我是安装橱柜的师傅，我一定不会提，给你板材切割的断面要用收边条封上。我要是说了，活儿多了还得我干，搞不好还因为这点小事扣我尾款，我还是不说的好，等以后板材受潮发霉，你也想不到是因为没封边造成的。
+假如我是安装浴室柜的师傅，我一定不会提醒你提前买好下水器，我直接把下水管给你塞进去就完事。我要是说了，还得等你去买，买回来我还得帮你装，万一装不上或者漏水，又是一堆麻烦，何必呢？
+装修套路深，想省心不存在的。我整理了全流程避坑手册，抠手册直接拿走，提前了解，少走弯路。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（优先选恶搞开篇、施工翻车镜、毛坯全景等贴近装修安装套路、避坑主题）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜。
+分点阐述全部用空镜，空镜素材库标题与文案内容需精准匹配，匹配不到则选主材安装、柜体木作、厨卫相关近似空镜。
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜。
+分镜文案 = 配音文案，必须带标点断句，规避大长句；单条分镜纯文字（含数字、不含标点）严格控制 12-32 字，超长句强制拆分多镜，语句通顺完整。
+字数时长统一规范：全篇文案纯文字 + 数字扣除标点严控 440-480 字、时长 110-120s；单分镜严格按每秒 4 个纯文字计算，只统计汉字 + 数字、扣除标点，时长保留两位小数，单镜时长强制锁定 3-8 秒，超出必须拆句重分镜。
+type 定义：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"
+}
+]

python-api/app/ai/prompts/system/bk/sq/阳台避坑5.12.txt

@@ -0,0 +1,280 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装/装修领域的抖音/视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备装修阳台、容易被网红款式忽悠、盲目跟风装不实用设施，后期后悔返工、浪费钱的装修业主，围绕阳台装修14个坑，每次随机抽取5个重新编排顺序，创作避坑口播内容，贴合老装修人干货分享口吻。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头阳台装修避坑警示引入 + 随机5个阳台装修坑干货拆解 + 结尾避坑手册引导，无多余内容，无重复，无冗余，不增减坑点数量。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：
+完整保留原文开头核心原意，仅轻微口语化微调，用老装修人接地气的警示语气，点出“阳台装错东西谁装谁后悔”的核心痛点，结合20多年装修经验增强说服力，自然引出下文5个阳台装修坑，不篡改、不新增、不删减开头核心话术。
+中间核心（阳台装修5个避坑要点，从14个原始坑中随机抽取5个，重新编排顺序，文案适当调整修改，意思保持原意，可口语顺滑润色）：
+（备注：每次生成均从14个原始坑中随机抽取5个，自主打乱排列顺序，不固定组合、不固定顺序；保留每个坑的核心原意、避坑逻辑、推荐方案、隐患后果不变，适当调整句式让口语化更贴合口播，不篡改任何核心细节）
+14个阳台装修原始坑点汇总（供随机抽取，每次选5个）：
+1、阳台洗衣柜千万别装带搓衣板的，中看不中用，后期易积污垢难清理，推荐石英石台面加陶瓷盆，耐用抗造。
+2、千万别装窗台石，多为岗石（假石英石），易留刮痕，推荐直接用地砖铺贴，更耐磨、使用寿命更长。
+3、不推荐阳台做吊顶，费钱还压层高，铝扣板吊顶显小家子气，推荐刷乳胶漆，省钱又简洁。
+4、不推荐洗烘一体机，烘干功能鸡肋，烘出衣服皱巴巴，推荐独立洗衣机+独立烘干机，洗衣烘干更平整干净。
+5、千万别装大玻璃落地窗，价格贵、需额外加吊装费，玻璃笨重，推荐普通断桥铝窗户，便宜又安全。
+6、别装老式拖把池，难看又占地方，推荐做扫地机器人隐藏柜，搭配扫地机器人，省时省力；不推荐洗地机（电子拖把，需手动操作）。
+7、打死别装罗马帘，丑且漏光，推荐装窗帘盒+加厚铝合金静音轨道，美观上档次。
+8、阳台与客厅之间别装推拉门，想扩大空间可拆掉墙体打通阳台，地砖通铺，空间更敞亮、视线更好。
+9、不推荐大理石垭口套，又贵又难看，易磕碰有安全隐患；推荐实木垭口套（与踢脚线同材质同色），极简风可选铝合金垭口套。
+10、别在阳台装学习桌，阳光刺眼伤眼睛还浪费空间，推荐做家政柜，收纳扫帚、拖把等，干净利索、利用率高。
+11、别装隐藏式晾衣架，价格贵且实用性差（天天晒衣服藏不住），带消毒烘干功能的更是智商税；推荐普通自动升降晾衣架，便宜实用。
+12、不推荐普通推拉窗，隔音差、防寒效果不好，冬天易进冷风；推荐断桥铝平开窗，隔音好、密封严、不渗水。
+13、阳台纱窗别装金刚网，网眼密挡光线，推荐高透网纱窗，不影响视线，兼顾通风采光。
+14、别装网红吊椅/秋千，新鲜劲过了占地方、易损坏；推荐轻便可移动折叠椅+小边几，灵活不占地，适配休闲需求。
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+排序逻辑：每次生成自动从14个原始坑中随机抽取5个，重新自主编排顺序，不固定组合、不固定顺序，贴合老装修人唠嗑式分享节奏，不刻意追求逻辑递进，重点突出“实用、避坑、不浪费钱”的核心。
+文案调整要求：微调仅针对句式口语化优化，延续原文老装修人接地气、直白吐槽的口吻，把原文表述优化得更贴合抖音/视频号口播节奏，不改变每个坑的核心避坑点、推荐方案、隐患后果，完整保留原文原意和语气风格。
+字数与时长控制：纯文字 + 数字（扣除标点）严格控制在400-480字，按每秒4个纯文字计算，对应时长100-120s，每个坑讲解简洁不啰嗦、重点突出，节奏适中，适配短视频完播率，不偏离字数和时长区间。
+内容适配性：5个随机抽取的坑点衔接自然，每个坑独立适配空镜分镜，直击业主阳台装修跟风踩坑、浪费钱、后期后悔的核心痛点，每个坑都讲清坑点弊端、推荐方案，结合老装修人经验增强说服力，实用性极强。
+结尾范式：
+完整保留原文结尾核心结构和原意，仅可轻微优化口语流畅度，不改动“整理装修避坑手册、抠‘避坑’领取”的核心引流逻辑，不新增、不删减任何话术，保持结尾的简洁性和引导性。
+【开篇 & 语言要求】
+开篇沿用原文老装修人警示吐槽语气，3秒抓眼球，直接点破“阳台装错东西谁装谁后悔”的核心痛点，结合“20多年装修、经手几千套房子”的经验，增强说服力，瞬间引发准备装修阳台的业主共鸣，不拖沓、不铺垫。
+全程口语化大白话，通俗易懂、接地气，延续原文直白吐槽、不绕弯子的风格，站老装修人立场分享避坑干货，不生硬说教，适配抖音/视频号口播传播节奏，让小白业主一听就懂、愿意听完。
+可微调句式语序，优化口语流畅度，严禁篡改任何坑点的核心弊端、推荐方案、隐患后果等核心内容，每句带标点规范断句，拆分超长句子，适配口播表达习惯，避免大长句影响传播效果。
+【内置固定原文案】
+打死都别在阳台上装这几样东西，真的是谁装谁后悔。你别跟我杠，我干了 20 多年装修，经手几千套房子，听我说完你就明白了。
+第一，阳台洗衣柜千万别装带搓衣板的，那玩意儿就是个绣花枕头，中看不中用，看着挺光溜，过个一年半载全是污垢，擦都擦不干净。你就听我的，要装就装个石英石台面加陶瓷盆，不怕风吹日晒，用到你儿子娶媳妇儿都没问题。
+第二，千万别装窗台石，窗台石就是岗石做的，假的石英石，用不了多久全是刮痕。你想想是地砖耐磨还是岗石耐磨，你就听我的，直接用地砖贴上，耐磨，用的时间还长。
+第三，我最反感一上来就推荐阳台做吊顶的，费钱不说，还压层高。你在阳台做吊顶图啥？钱没地方花了？铝扣板吊顶那玩意儿就是小家子气，谈不上档次。你就听我的，阳台啥也别吊，刷个乳胶漆就完了，省下钱买肉吃。你问我石膏板吊顶能不能做，反正我家不做。
+第四，洗烘一体机，那烘干功能就跟闹着玩儿似的，烘出来衣服皱皱巴巴的，跟老太太裹脚布一样。要买烘干机，一定要买独立的烘干机和独立的洗衣机，这样才能把衣服洗得又干净又平整。
+第五，千万别装大玻璃落地窗，那玩意儿看着亮堂，玻璃越大就越重，价格自然贵，还得加吊装费。咱们普通老百姓老老实实做个普通断桥铝窗户，便宜，安全性还高。
+第六，别装老式拖把池，又难看又占地方。现在谁还用老式拖把？你做个扫地机器人的隐藏柜，买一个扫地机器人，不用你动手，你在家好好歇着。洗地机我劝你也别用，那玩意儿就是电子拖把，还得你人动手。
+第七，打死别装罗马帘，丑死了，还漏光。你就听我的，装个窗帘盒，里面加上加厚的铝合金静音轨道，窗帘一挂，美观上档次。
+第八，阳台推拉门，如果你想把客厅变大，别在阳台和客厅之间装那个推拉门了，拆掉墙体，打通阳台，地砖从客厅、餐厅直接铺到阳台，空间才显得敞亮大气，视线还好。
+第九，大理石垭口套又贵又难看。阳台是个活动区域，一不小心磕下缺一块，还有安全隐患。要包垭口套就用实木的，跟踢脚线同材质同颜色，整体美观；极简风可选铝合金的，也挺好看。
+第十，别在阳台装学习桌，阳台太阳光晒得跟探照灯似的，伤眼睛还浪费空间。你就听我的，把阳台做个家政柜，扫帚、拖把、吸尘器往里一塞，干净利索，空间利用率高。
+第十一，你可千万别听导购瞎吹，说什么在阳台装个隐藏式晾衣架，价格贵不说，等你住进去以后才会发现，天天要晒衣服根本藏不了。还带消毒烘干功能的更别买，妥妥的智商税，衣服拿到太阳下一晒，什么毒都消了。你就听我的，最实用的，有自动升降就行了，便宜又实用。
+第十二，普通推拉窗隔音差，防寒效果还不好，冬天冷风嗖嗖的往里钻，要做就一步到位，装断桥铝平开窗，隔音好、密封严，还不渗水。
+第十三，阳台纱窗，别装金刚网的，那网太密，光线都给你挡死了。你就听我的，装个高透网纱窗，不影响视线，通风采光两不误，这才是聪明人的选择。
+第十四，阳台装那种网红吊椅或者秋千的，新鲜劲儿一过，占地方不说，风吹日晒很容易坏。阳台空间宝贵，你要做休闲区，就整几个轻便可移动的折叠椅，或者小边几，想用搬出来，不用收起来，不占地方。
+如果你也准备新房装修，我整理了一份装修避坑手册。抠个避坑，拿去参考。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近阳台装修、装修避坑、施工套路主题，优先选工地恶搞、阳台原始结构空镜、硬装完工全屋全景等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选阳台储物柜基层制作、瓷砖铺贴、门窗缝隙密封处理、收尾细节等贴合阳台装修避坑主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
+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 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 “5.25s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “empty_shot”,
+“scene”: “防水翻车漏水”,
+“voiceover”: “新房装修刷防水，一上来就开刷的工人，直接撵走别客气！”,
+“duration”: “5.75s”
+},
+{
+“id”: 2,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “他不是在赶工期，只是在图省事，这 4 点一定要做好。”,
+“duration”: “5.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “卫生间基层清理 - 防水施工”,
+“voiceover”: “第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。”,
+“duration”: “5.50s”
+}
+]

python-api/app/ai/prompts/system/bk/wg/瓦工进场交代5.8.txt

@@ -0,0 +1,269 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：新房装修瓦工进场、不懂专业监工、只会送礼讨好师傅、想靠专业话术把控施工细节的装修业主，围绕瓦工施工 10 句必备监工话术创作，每次生成随机打乱 10 条话术顺序重新编排，保留原意不变。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点引入 + 随机打乱 10 条瓦工监工话术 + 结尾福利引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：完整保留原文开头原话，只可轻微口语化微调，不改动核心原意，用接地气吐槽语气点出业主无效监工痛点，引出下文 10 句监工话术。
+中间核心（瓦工施工 10 句监工重点话术，文案可适当微调句式、口语化优化，保留每条原意不变，每次生成自动随机打乱重新编排顺序）：
+入户瓷砖优先铺整块，全屋通铺，边角料藏在家具遮挡位置。
+有色差、破损瑕疵瓷砖不要铺贴，单独放置留作商家退换。
+卫生间地面做好排水坡度，地漏做最低点，管道铺贴无断层。
+卫生间下水管道先贴阻尼片、包隔音棉，再砌砖贴砖做好隔音。
+后期装铝合金踢脚线，提前把控墙面与瓷砖预留缝隙大小。
+卫生间做单包套，四周必须完整贴砖，避免后期额外增项花钱。
+墙面出水口做好密封处理，从源头杜绝后期墙面渗水隐患。
+瓷砖转角统一做海棠角，预留美缝空间，禁止加装阳角条。
+止逆阀位置铺贴整块瓷砖，按尺寸精准开孔并顺手安装到位。
+橱柜、浴室柜不装挡水条，严控墙面阴阳角垂直度标准。
+（备注：完整保留原文 10 条监工话术核心细节、施工要求不变，仅微调口语适配口播；每次生成随机打乱 10 条顺序，不固定排序，始终保留每条原意，不篡改施工工艺和细节要求）
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+排序逻辑：内置 10 条瓦工监工固定要点，每次生成脚本自动随机打乱重新排序，不按原文固定顺序，避免内容重复同质化，适配短视频日更需求。
+文案调整要求：仅做口语化句式微调，把书面表述改成接地气口播大白话，不改动任何施工细节、工艺要求、禁忌标准，完整保留 10 条话术核心原意。
+字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 440-480 字，按每秒 4 个纯文字计算，对应时长 110-120s，讲解饱满不拖沓，符合短视频用户完播习惯。
+内容适配性：打乱顺序后文案衔接自然，每条话术独立成点、逻辑通顺，贴合业主瓦工进场监工刚需，直击无效送礼不如专业话术管用的核心痛点，每一条都明确施工标准和避坑要点。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领资料、评论区回复关键词、福利引导的核心逻辑。
+【开篇 & 语言要求】
+开篇完整沿用原文开头句式和吐槽语气，3 秒抓眼球，直击业主花钱送礼无效监工的通病，引出专业监工话术。
+全程口语化大白话，接地气、通俗易懂，站装修业主视角共情讲解，不生硬说教。
+可微调句式语序，严禁篡改 10 条瓦工监工话术的施工细节、工艺标准、硬性要求，每句带标点规范断句，适配口播节奏，不拆改核心语义。
+【内置固定原文案】
+我发现 90% 的业主都在无效监工，又是买水又是买烟又是送吃的。妄想用真情来打动师傅，我只能说你太天真了。要想装修不踩坑，真不如交代这十句话管用。
+第一句，师傅，我想要入户进门就看到整块砖，然后全屋通铺，把边角料全塞在家具能挡住的地方。
+第二句，铺贴时遇到有色差、破损的砖请别往上贴，单独放一边。我要找商家退换处理。
+第三句，卫生间地面我要做坡度，确保地漏是最低点，这样下水才快。另外，地漏不能有断层。
+第四句，师傅，卫生间的下水管道先贴阻尼片再包隔音棉，然后再砌砖包管子，最后贴瓷砖。
+第五句，师傅，后期我要装铝合金踢脚线，墙和瓷砖的缝隙别留太大。
+第六句，师傅，我家卫生间要做单包套，一定要记得给我四周贴砖，不然后期做门又得多花钱。
+第七句，师傅出水口一定要帮我做下密封处理，省得以后渗水。
+第八句，师傅，所有的转角都要海棠角，后期我要做美缝，千万别给我做阳角条。
+第九句，师傅需要贴止逆阀的地方一定要帮我贴一块整砖。我的止逆阀也买回来，你按这个开孔以后，顺手帮我装上吧。
+第十句，师傅，我家橱柜和浴室柜不打算装挡水条，所以对墙面阴阳角的垂直度要求比较高，麻烦你上点心啊。
+准备新房装修的朋友，我整理了装修全流程避坑手册。评论区回复避坑，拿去用。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近瓦工铺贴、监工话术主题，优先选贴砖恶搞、瓷砖铺贴、墙面空鼓等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选瓷砖铺贴、瓷砖开孔、墙面基层、水电验收等贴合瓦工监工主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
+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 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "防水翻车漏水-施工翻车镜",
+"voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
+"duration": "5.75s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "他不是在赶工期，只是在图省事，这 4 点一定要做好。",
+"duration": "5.25s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "卫生间基层清理 - 防水施工",
+"voiceover": "第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。",
+"duration": "5.50s"
+}
+]

python-api/app/ai/prompts/system/bk/wg/瓦工铺贴5.7.txt

@@ -0,0 +1,260 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装/装修领域的抖音/视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：即将迎来瓦工进场、担心瓦工施工糊弄、后期瓷砖出现空鼓、开裂、脱落等问题的业主，严格围绕瓦工进场施工避坑要点创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 7个瓦工施工避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏9:16拍摄
+【核心强制规则】
+开头范式：以“新房装修【核心场景：瓦工进场】，谁要是满脑子只想着【错误操作：做海棠角、全屋通铺墙壁对缝】，你就直接【拒绝动作：别只盯着这些】。你以为他是帮你【表面好处：做美观、显工艺】，其实他就是图【错误目的：糊弄你、省事儿】。下面这7个细节一定要看仔细，少看一条都可能亏几万！”为核心句式，用警示性语气点出常见坑，引出下文要点（保留原文开头核心原意，适配范式结构）。
+中间核心（7个瓦工进场避坑要点，文案适当调整修改，意思保持原意，按原文序号排列，不随机抽取）：
+1. 瓷砖排版：瓷砖排版别让瓦工来做，买砖的时候让商家设计师免费给你排好版。瓦工手艺再好，也比不过电脑精准，进场时让师傅拿着图纸现场复核一遍，没问题再施工。
+2. 瓷砖筛选：交代师傅有色差和瑕疵的砖不能贴，一定要挑出来找商家换货，还要检查瓷砖背面有没有脱墨剂，这玩意儿会严重降低瓷砖粘性，导致瓷砖脱落，必须清理干净才能贴。
+3. 贴砖方向：贴砖时让师傅按砖背面的箭头方向来贴，不然贴完瓷砖表面光泽不一致，一块深一块浅，丑得没法看，后期想改都要砸砖返工。
+4. 抗裂处理：新旧墙体交接处、烟道位置，记得让师傅挂钢丝网，抹上抗裂砂浆再贴砖，不然季节交替热胀冷缩，这里的砖很容易空鼓、脱落。
+5. 瓷砖开孔：所有需要开孔的瓷砖，必须用专业开孔器来开，保证开孔规整，不然后期瓷砖很容易从开口处开裂，影响美观还存在安全隐患。
+6. 卫生间回填：卫生间千万不要用建筑垃圾回填，让师傅用陶粒回填，陶粒质轻还吸水，回填完再铺一层钢筋网，加水泥找平，才能保证后期地面不下沉。
+7. 后期保护：师傅贴完砖以后要及时清缝，后期美缝才不会崩瓷，还要用厚纸板把地砖盖好，做好成品保护，避免后期施工造成刮痕。
+（备注：保留原文7个要点，按原文序号排列，保留原文核心细节和避坑逻辑，适当调整句式让口语化更贴合口播）
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑手续】，抠【核心关键词：避坑】直接拿走！”
+【开篇&语言要求】
+开篇钩子，直击瓦工施工糊弄、后期瓷砖出问题的痛点，3秒抓眼球，不拖沓不铺垫。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
+可微调句式，不得篡改原文中瓦工施工的核心细节和避坑逻辑，每句必须带标点断句。
+【内置固定原文案】
+瓦工进场，如果你满脑子只有做海棠角，全屋通铺墙壁对缝，那你后面肯定要踩大坑。瓦工一来，你先交代好这7个细节，师傅听了就不敢糊弄你。
+第一，瓷砖不需要瓦工排版，买砖的时候让商家设计师免费给你排好版。瓦工手艺再好，也比不过电脑精准。进场时，让师傅拿着图纸现场复核一遍，没问题再施工。
+第二，交代师傅有色差和瑕疵的砖不能贴，一定要挑出来找商家换货，还要检查瓷砖背面有没有脱墨剂。这玩意儿会严重降低瓷砖的粘性，导致瓷砖往下掉。必须清理干净才能贴。
+第三，贴砖的时候，让师傅按砖背面的箭头方向来贴，不然贴完表面光泽不一样，一块儿深一块儿浅，丑的没法看。
+第四，新旧墙体交接处、烟道位置记得让师傅挂钢丝网，抹上抗裂砂浆再贴砖，不然季节交替，热胀冷缩，这里的砖很容易空鼓脱落。
+第五，所有需要开孔的瓷砖必须用专业开孔器来开，保证开孔规整，不然后期瓷砖很容易从开口处开裂。
+第六，卫生间千万不要用建筑垃圾回填，让师傅用陶粒回填，陶粒轻还吸水。回填完再铺一层钢筋网，加水泥找平，才能保证后期地面不下沉。
+第七，师傅贴完砖以后要及时清缝，后期美缝才不会崩瓷，还要用厚纸板把地砖盖好，做好保护，避免后期施工造成刮痕。
+准备新房装修的朋友，我整理了一份装修全流程避坑手续。抠避坑，直接拿去用。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近瓦工主题，优先选贴砖恶搞、墙面空鼓、瓷砖开裂等相关）+ 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选瓷砖铺贴、瓷砖开孔、陶粒回填等贴合瓦工主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有2段人物出镜
+“分镜文案"等于"配音文案”，“配音文案”必须要有标点符号断句，避免大长句，如：“第一，瓷砖排版别让瓦工来做，商家设计师免费排版更精准。”每段分镜的分镜文案字数严格控制在12-32个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的"分镜时长"为{严格按**每秒4个纯文字**计算时长。文字统计硬性定义：**纯文字包含汉字、阿拉伯数字，只扣除标点符号**，所有字数、时长全部按这个口径计算，即"分镜文案"的纯文字字数/4}，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"
+type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
+禁止总字数偏离400–480（含数字，不含标点符号）、总时长偏离100–120秒。
+禁止篡改原文瓦工避坑相关的核心细节和逻辑。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
+duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
+【示例】
+[
+{
+“id”: 1,
+“type”: “empty_shot”,
+“scene”: “贴砖恶搞 - 恶搞开篇”,
+“voiceover”: “瓦工进场只盯海棠角、通缝，后期必踩大坑”,
+“duration”: “4.25s”
+},
+{
+“id”: 2,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “先交代这7个细节，师傅绝对不敢糊弄你”,
+“duration”: “4.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “瓷砖铺贴 - 瓷砖铺贴”,
+“voiceover”: “第一，瓷砖排版别让瓦工做，商家设计师免费排更精准。”,
+“duration”: “5.50s”
+}
+]

python-api/app/ai/prompts/system/bk/wg/瓷砖铺贴停工5.8.txt

@@ -0,0 +1,259 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装/装修领域的抖音/视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：瓷砖刚铺贴完成、被装修公司催促赶工期、不懂停工注意事项、容易提前施工留下后期隐患的装修业主，围绕瓷砖铺贴后5件必停必等事项创作，按原文序号排列，不随机抽取。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 5个瓷砖铺贴停工避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏9:16拍摄
+【核心强制规则】
+开头范式：以“瓷砖铺完后必须要停工几天，哪怕是装修公司催，下面这5件事也别着急着干，不然后期出问题，责任全是你自己的。”为核心句式，用警示性语气点出常见坑，引出下文5个要点（保留原文开头核心原意，适配范式结构）。
+中间核心（5个瓷砖铺贴停工避坑要点，文案适当调整修改，意思保持原意，按原文序号排列，不随机抽取）：
+1.  瓦工验收：瓦工结束后不能立马验收。装修公司这时候拿个空鼓锤来，就是忽悠你不懂。你要是签字了，后期有问题就是你的责任了。这里一定要等水泥砂浆干透了，才能验出来是否空鼓，最起码要等五六天左右。
+2.  美缝施工：美缝不能在瓷砖刚铺完就做，要等一周左右，等缝隙里面的水迹干透了，检查有没有空鼓了再做美缝。不然后期出现了反碱脱落，后续维权麻烦不说，还得返工耗费时间金钱。
+3.  瓷砖养护：瓷砖铺完后千万不要洒水，你洒水养护的是下面的水泥砂浆，那活儿，瓦工铺的时候就应该把墙面地面打湿再贴，铺完了再打扫干净，盖好保护膜就可以了，别多此一举。
+4.  标识保留：墙面的水电标识贴不要撕，这是给后期安装师傅看的。你一撕，人家打孔打到水管电线，不仅维修麻烦，还可能造成安全隐患，得不偿失。
+5.  停工利用：停工这几天也别闲着。闲着你就可以让定制商家上门复尺，提前下单，定制周期差不多一个月，到时候你家油工结束了，这些东西正好能装，一点儿不耽误工期。
+（备注：保留原文5个要点，按原文序号排列，保留原文核心细节和避坑逻辑，适当调整句式让口语化更贴合口播，补充美缝反碱、水电标识撕毁的危害，贴合搜索参考内容）
+### 中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+1.  排序逻辑：严格按原文5个要点的序号排列，不随机抽取、不打乱顺序，保证内容连贯性，贴合业主瓷砖铺贴后停工的实际流程，从验收、施工、养护、标识到工期利用，层层递进，符合业主认知逻辑。
+2.  文案调整要求：微调仅针对句式口语化优化，比如将书面化表述改为抖音/视频号口播常用的接地气语气，补充轻微危害提示（结合美缝反碱脱落、水电标识撕毁的隐患），不改变每个坑的核心信息——如验收等待五六天、美缝等待一周、禁止洒水、保留水电标识、定制复尺周期一个月等核心时间节点和禁忌，所有细节完全保留，贴合原文原意。
+3.  字数与时长控制：纯文字+数字（扣除标点）严格控制在400-480字，按每秒4个纯文字计算，对应时长100-120s，既保证每个避坑点讲解透彻，补充必要危害提示，又不拖沓，符合短视频用户观看习惯，避免用户划走。
+4.  内容适配性：5个避坑要点讲解时需衔接自然，每个坑独立成段（分镜对应空镜），不重复、不冗余，重点突出“停工避坑”核心，贴合业主担心被装修公司催促、怕后期出问题自己担责、想合理利用停工时间的核心痛点，每段讲解都紧扣“为什么不能做、怎么做才对”的逻辑，与原文保持一致，结合参考内容完善危害提示，增强说服力。
+结尾范式：以“如果你们也在准备新房装修，不知道还有哪些坑要避，评论区回复 ‘装修’，我把整理好的装修避坑手册，免费发给你们，帮你们省时间、省钱！记得关注我，装修不踩坑！”为核心句式，保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动领福利、评论区回复关键词、关注引导的核心逻辑。
+【开篇&语言要求】
+开篇严格遵循核心强制规则的警示性句式，3秒抓眼球不拖沓，用犀利语气点出瓷砖铺贴后被催工期、盲目施工后期担责的痛点，贴合装修业主避坑需求，不偏离范式结构。
+全程口语化大白话，小白易懂、不生硬说教，站业主共情立场，用警示性语气讲解，贴合口播传播特点，增强代入感，补充的危害提示通俗易懂，让业主清晰了解违规操作的后果。
+可微调句式语序，严禁篡改5个停工避坑要点的核心细节、时间节点、操作规范，每句带标点规范断句，适配口播节奏，避免大长句，同时结合参考内容完善美缝反碱、水电标识相关危害表述。
+【内置固定原文案】
+瓷砖铺完后必须要停工几天，哪怕是装修公司催，下面这5件事也别着急着干，不然后期出问题，责任全是你自己的。
+第一，瓦工结束后不能立马验收。装修公司这时候拿个空鼓锤来，就是忽悠你不懂。你要是签字了，后期有问题就是你的责任了。这里呢，是一定要等水泥砂浆干透了，才能验出来是否空鼓，最起码要等五六天左右。
+第二，美缝不能在瓷砖刚铺完就做，要等一周左右，等缝隙里面的水迹干透了，检查有没有空鼓了再做美缝。不然后期出现了反碱脱落，你找谁去？毕竟美缝反碱后会形成隔离层，导致粘结不牢固，返工又费钱又费力。
+第三，瓷砖铺完后千万不要洒水，你洒水养护的是下面的水泥砂浆，那活儿，瓦工铺的时候就应该把墙面地面打湿再贴，铺完了再打扫干净，盖好保护膜就可以了，别多此一举。
+第四，墙面的水电标识贴不要撕，这是给后期安装师傅看的。你一撕，人家打孔打到水管电线，你就等着哭吧，不仅维修麻烦，还可能引发安全隐患。
+最后，停工这几天也别闲着。闲着你就可以让定制商家上门复尺，提前下单，定制周期差不多一个月，到时候你家油工结束了，这些东西正好能装，一点儿不耽误工期。
+如果你们也在准备新房装修，不知道还有哪些坑要避，评论区回复 “装修”，我把整理好的装修避坑手册，免费发给你们，帮你们省时间、省钱！记得关注我，装修不踩坑！
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近瓷砖铺贴、停工避坑主题，优先选贴砖恶搞、墙面空鼓、瓷砖铺贴等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选瓷砖铺贴、美缝施工、成品保护、水电验收等贴合瓷砖铺贴停工主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，如：“第一，瓦工结束后不能立马验收，至少要等五六天。” 每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数，如 “瓷砖铺完别着急复工，这 5 件事做早了全是坑” 总共 20 个文字 1 个数字，则是 "5.25s"
+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 秒，可以是两位小数，如 “瓷砖铺完别着急复工，这 5 件事做早了全是坑” 总共 20 个文字 1 个数字，则是 "5.25s"）
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "贴砖恶搞 - 恶搞开篇",
+"voiceover": "瓷砖铺完别着急复工，装修公司催也别理，5 件事必等！",
+"duration": "5.75s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "这些事做早了后期全是坑，责任还得你自己担！",
+"duration": "5.00s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "瓷砖铺贴 - 瓷砖完工展示",
+"voiceover": "第一，瓦工结束别立马验收，至少等五六天再验空鼓！",
+"duration": "5.50s"
+}
+]

python-api/app/ai/prompts/system/bk/wt/常见问题25选8-5.9.txt

@@ -0,0 +1,270 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：准备新房装修、不懂水电改造套路、容易被网红颜值工艺忽悠、只看表面好看多花冤枉钱，后期入住返工留遗憾的业主，严格从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"
+}
+]

python-api/app/ai/prompts/system/bk/wt/硬装结束前的收尾工作5.11.txt

@@ -0,0 +1,261 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：硬装刚完工、不懂软装进场前后收尾细节、着急搬家具入住容易遗留隐患，后期发霉反味、墙面破损难修补的装修业主，围绕硬装结束必做 7 个收尾关键要点创作，按原意逻辑编排，可适度口语微调保留原意。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头硬装收尾痛点引入 + 7 个收尾避坑干货 + 结尾避坑手册引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：完整保留原文开头核心原意，仅轻微口语化微调，用警示现实视角点出硬装刚完工别急着进软装，忽略 7 个收尾细节入住容易留隐患、生活闹心吵架的痛点，引出下文 7 个必做收尾关键点。
+中间核心（硬装完工 7 个收尾避坑要点，文案适当调整修改，意思保持原意，保留原有先后逻辑，不随机打乱，可口语顺滑润色）：
+瓷砖除蜡：亮光砖、柔光砖在家具进场前，一定要用瓷砖除蜡剂全屋拖洗一遍，避免表层蜡质残留，入住后地面发蒙有水雾感，看着别扭难打理。
+柜体防护：餐边柜、橱柜吊柜底部贴静电防水膜，阻隔水汽熏坏柜体；橱柜内部铺贴铝箔纸，提升防潮效果，日常清洁打理更省心。
+地漏整改：逐一检查全屋地漏是否存在断层，有断层及时加装加长地漏芯，防止渗水进入砂浆层，避免后期反味、墙面起皮发霉等遗留隐患。
+全屋打胶：家具进场前提前做全屋精细打胶，重点处理踢脚线底部、厨卫窗框与瓷砖交接位置，优先用美容胶，不建议用美缝剂，避免材质过硬后期脱落开裂。
+止逆阀对接：检查油烟机、卫生间浴霸和排风扇，确认排风管与止逆阀规范连接，杜绝师傅偷懒随意摆放管路，防止后期全屋倒灌异味。
+原漆留存：乳胶漆完工后预留未兑水原装漆，密封保存备用，后期装门、装柜体出现磕碰掉漆，可随时修补还原，不用整体返工刷漆。
+（备注：保留原文 7 个收尾要点的核心细节、施工逻辑、隐患后果不变，适当调整句式让口语化更贴合口播，不篡改工艺做法、选材建议、遗留隐患的核心逻辑）
+中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
+排序逻辑：严格按原文 6 大收尾要点顺序排列，不打乱结构，贴合硬装完工到软装进场的真实施工流程，层层递进符合业主装修收尾认知逻辑。
+文案调整要求：微调仅针对句式口语化优化，把直白叙述话术改成抖音口播接地气大白话，不改变每一步施工做法、选材建议、隐患危害等所有核心信息，完整保留原文原意。
+字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 440-480 字，按每秒 4 个纯文字计算，对应时长 110-120s，讲解收尾细节细致不啰嗦，节奏适中，适配短视频完播率。
+内容适配性：7 个收尾要点衔接自然，每一条独立适配空镜分镜，直击业主硬装完工急于入住、忽略隐蔽收尾细节，后期返工闹心的核心痛点，每一条都讲清做法、原因和避坑作用，实用性极强。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修全流程避坑手册、评论区回复关键词引导的核心逻辑。
+【开篇 & 语言要求】
+开篇沿用原文警示吐槽语气，3 秒抓眼球，点破硬装刚结束着急搬软装、忽略收尾细节入住就留隐患闹矛盾的真实痛点，瞬间引发装修完工业主共鸣。
+全程口语化大白话，通俗易懂、接地气，站业主立场拆解装修收尾细节，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
+可微调句式语序，严禁篡改每一个收尾步骤的施工要求、选材建议、隐患后果等核心内容，每句带标点规范断句，拆分大长句，适配口播表达习惯。
+【内置固定原文案】
+装修千万别硬装刚结束就急着把沙发、床这些软装搬进去。先把下面这 7 个收尾的活安排明白，要不然等你人入住进去以后，两口子天天吵架。
+第一，不管你家是亮光砖还是柔光砖，趁家具还没进场，赶紧网购一瓶瓷砖除蜡剂，把地面彻底拖一遍。不然等你住进去，地面怎么都像蒙了一层水雾，看着就闹心。
+第二，餐边柜和橱柜吊柜底部建议贴一层静电防水膜，防止水蒸气慢慢把咱家的吊柜熏坏了。再有就是橱柜里边贴上铝箔纸，它防潮性会更好，而且更好打理卫生。
+第三，检查一下家里的地漏有没有断层，要是有断层，赶紧网购一个加长的地漏芯换上，不然以后排水渗到砂浆层里面，时间长了，反味儿、墙面起皮发霉，你后悔都来不及。
+第四，家具进场前一定要先安排全屋打胶，别自己打，你打不明白。尤其是你的踢脚线底下，以及厨房和卫生间窗框和瓷砖的交界处，一定记得打美容胶，别用美缝剂，美缝剂偏硬，时间长了容易脱落。
+第五，烟机和卫生间的浴霸、排风扇，你要看它有没有跟止逆阀连接。有很多安装师傅图省事儿，把排风管顺手往顶上一扔，反正你也看不着，后期全是味儿。
+第六，乳胶漆施工后记得留一些未兑水的原漆，装在密封瓶里保存，后期安装门、柜体时难免磕碰，方便随时修补。
+记不住的，我都整理在这份装修全流程避坑手册里了。评论扣避坑，拿好少踩坑。
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近硬装收尾、软装进场、装修细节避坑主题，优先选工地恶搞、墙面空鼓、硬装完工全屋全景等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选美缝开荒、成品保护、收尾细节、瓷砖铺贴等贴合硬装收尾避坑主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
+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 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 “5.25s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “empty_shot”,
+“scene”: “防水翻车漏水”,
+“voiceover”: “新房装修刷防水，一上来就开刷的工人，直接撵走别客气！”,
+“duration”: “5.75s”
+},
+{
+“id”: 2,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “他不是在赶工期，只是在图省事，这 4 点一定要做好。”,
+“duration”: “5.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “卫生间基层清理 - 防水施工”,
+“voiceover”: “第一，基层要清理干净，裂缝凹陷补平，管口封好防渗漏。”,
+“duration”: “5.50s”
+}
+]

python-api/app/ai/prompts/system/bk/yg/油工进场5.7.txt

@@ -0,0 +1,258 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【核心定位与脚本类型】
+（一）核心定位
+精准锁定：即将油工进场施工、不懂和油工师傅沟通话术，担心施工偷工减料、甲醛超标、墙面后期开裂掉皮的业主，严格围绕油工进场施工沟通避坑要点创作。
+（二）脚本类型
+装修口播短视频脚本，结构固定：开头痛点 + 6 个油工施工沟通避坑干货 + 结尾引导，无多余内容，无重复，无冗余。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+开头范式：以 “新房装修【核心场景：油工进场】，很多业主不懂行任由师傅自由施工，你以为他是帮你【表面好处：省事、按常规做法施工】，其实他就是图【错误目的：偷工减料、敷衍了事】。下面这 6 句话一定要记牢，照着跟师傅说不踩坑！” 为核心句式，用警示性语气点出常见坑，引出下文要点（保留原文开头核心原意，适配范式结构）。
+中间核心（6 个油工进场沟通要点，文案适当精简微调，意思保持原意，按原文序号排列，不随机抽取）：
+墙固涂刷：跟师傅交代原始墙面涂刷高渗透墙固，工费自理，有效预防墙面开裂反碱。
+挂网范围：不用全屋整体挂网，只在新老墙体交接、石膏板接缝位置局部挂网即可。
+腻子配比：腻子里面只能加水，禁止添加其他胶水，规避甲醛超标，守护家人健康。
+墙面找平：门口、踢脚线、衣柜周边重点做墙面找平，避免后期留出难看缝隙。
+吊顶防锈：吊顶所有钉子眼，必须人工涂刷防锈漆，防止后期生锈泛黄影响颜值。
+验收付款：油工全部施工完毕，验收合格之后再结尾款，严把施工质量关。
+（备注：保留原文 6 个要点，按原文序号排列，保留原文核心细节和避坑逻辑，精简句式，控制整体纯文字 + 数字字数在 180-220 字，贴合短时长口播语感）
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修流程避坑手册】，抠【核心关键词：避坑】直接拿走！”
+【开篇 & 语言要求】
+开篇钩子，直击油工施工不懂沟通、容易被糊弄、墙面留隐患、甲醛超标的痛点，3 秒抓眼球，不拖沓不铺垫。
+全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
+可微调精简句式，不得篡改原文油工施工沟通的核心细节和避坑逻辑，每句必须带标点断句。
+【内置固定原文案】
+油工进场不想踩坑，这 6 句话一定要跟师傅说，听完就懂行！
+第一、跟师傅说原始墙刷高渗透墙固，工费我出，防开裂反碱。
+第二、不要全屋挂网，只在新老墙体、石膏板接缝处挂网就够。
+第三、腻子里除了水啥也不加，家里有老人小孩怕甲醛超标。
+第四、门口、踢脚线、衣柜周围重点找平，别留难看缝隙。
+第五、吊顶钉子眼一定要人工刷防锈漆，防止后期生锈难看。
+第六、油工验收合格再给钱，面子工程必须把好质量关。
+准备装修的朋友，评论区回复避坑直接领取装修流程避坑手册！直接拿着对照参考，少踩坑！
+【内置完整素材库标题】
+合同签署
+卧室原始结构-毛坯基础
+原始门窗原貌-毛坯基础
+厨卫原始毛坯状态-毛坯基础
+地面原始水泥基层-毛坯基础
+客厅原始墙面-毛坯基础
+强弱电箱原始特写-毛坯基础
+毛坯全屋广角全景-毛坯基础
+阳台原始结构空镜-毛坯基础
+墙面点位弹线-现场交底
+开关插座定位-现场交底
+开工仪式简单镜头-现场交底
+施工方案现场讲解-现场交底
+甲乙工长三方对接-现场交底
+给排水点位标记-现场交底
+装修合同核对-现场交底
+卧室原始状态-翻新基础
+厨卫原始状态-翻新基础
+客厅原始状态-翻新基础
+卷尺实测尺寸-量房勘测
+手绘户型草图-量房勘测
+激光水平仪测量-量房勘测
+电脑户型图制作-量房勘测
+设计师入户-量房勘测
+全屋地板铺设施工-主材安装
+全屋开关面板安装-主材安装
+卫浴洁具进场安装-主材安装
+厨卫集成吊顶安装-主材安装
+室内房门安装固定-主材安装
+橱柜柜体现场组装-主材安装
+灯具筒灯射灯安装-主材安装
+衣柜移门五金安装-主材安装
+全屋五金调试-收尾细节
+成品瑕疵修补-收尾细节
+柜体门缝调整-收尾细节
+门窗缝隙密封处理-收尾细节
+全屋基础开荒保洁-美缝开荒
+地面残留胶迹清理-美缝开荒
+撕美缝胶-美缝开荒
+玻璃胶收边打胶细节-美缝开荒
+瓷砖缝隙清理清灰-美缝开荒
+美缝扩缝-美缝开荒
+美缝施工-美缝开荒
+美缝检查-美缝开荒
+门窗玻璃清洁-美缝开荒
+切割机施工特写-墙体拆除
+地板拆除-墙体拆除
+墙体拆除-墙体拆除
+墙面表层铲除-墙体拆除
+局部墙体剔凿修补-墙体拆除
+建筑垃圾实时掉落-墙体拆除
+拆改后现场全貌-墙体拆除
+柜子拆除-墙体拆除
+门洞扩宽切割-墙体拆除
+非墙体拆除-墙体拆除
+飘窗拆除改造-墙体拆除
+工地杂物清扫整理-工地清运
+施工地面清扫除尘-工地清运
+袋装垃圾搬运出场-工地清运
+装修垃圾集中堆放-工地清运
+新墙红砖错缝砌筑-新建砌筑
+新建墙体垂直找平-新建砌筑
+新旧墙体拉结筋施工-新建砌筑
+水泥砂浆搅拌-新建砌筑
+砌墙完工整体展示-新建砌筑
+红砖现场码放-新建砌筑
+轻体砖隔断搭建-新建砌筑
+门头过梁安装固定-新建砌筑
+中央空调风口预留-吊顶造型
+双眼皮吊顶封板施工-吊顶造型
+吊顶完工展示-吊顶造型
+吊顶水平对齐-吊顶造型
+吊顶石膏板批腻子-吊顶造型
+吊顶转角整板防裂-吊顶造型
+吊顶造型裁切及安装-吊顶造型
+吊顶钉眼防锈漆点涂-吊顶造型
+木龙骨基础框架固定-吊顶造型
+石膏板固定-吊顶造型
+石膏板开孔-吊顶造型
+石膏板裁切-吊顶造型
+轻钢龙骨骨架搭建-吊顶造型
+全屋定制柜体打底-柜体木作
+木作封边贴皮-柜体木作
+环保板材现场堆放-柜体木作
+阳台储物柜基层制作-柜体木作
+墙面防潮膜铺设防护-隔音防潮
+墙面隔音棉填充-隔音防潮
+强弱电间距查验-水电验收
+水电完工全屋环视-水电验收
+水管打压测试操作-水电验收
+管线走向拍照留存-水电验收
+线路通电检测检查-水电验收
+隐蔽工程线管覆盖-水电验收
+隐蔽工程细节巡检-水电验收
+下水管道改造调整-水路施工
+卫生间冷热水管排布-水路施工
+厨卫地漏原位查看-水路施工
+厨房水管走顶铺设-水路施工
+悬挂式马桶施工-水路施工
+水管保温棉包裹防护-水路施工
+水管卡扣固定工艺-水路施工
+水管对接-水路施工
+水管铺设-水路施工
+热水器管路预留对接-水路施工
+阳台洗衣水管定位-水路施工
+中央空调装管-电路施工
+吊顶灯线预留走线-电路施工
+地面线管开槽处理-电路施工
+墙面线槽开槽施工-电路施工
+底盒内电线整理-电路施工
+底盒暗盒预埋安装-电路施工
+弱电网线单独排布-电路施工
+强弱电信号防干扰锡箔纸屏蔽膜-电路施工
+强弱电管分槽铺设-电路施工
+电管对接-电路施工
+电管铺设-电路施工
+电箱内部线路整理-电路施工
+电线穿管布线特写-电路施工
+装修材料堆放-电路施工
+全屋墙面铲除大白-墙面基层
+全屋批刮第一遍腻子-墙面基层
+墙固施工-墙面基层
+墙面裂缝挂网防裂-墙面基层
+墙面阴阳角找直处理-墙面基层
+腻子干透精细打磨-墙面基层
+地面地砖地膜保护-成品保护
+开关面板保护贴膜-成品保护
+柜体成品保护包裹-成品保护
+门窗门套包裹防护-成品保护
+乳胶漆修补-面漆涂刷
+乳胶漆效果展示-面漆涂刷
+乳胶漆调配-面漆涂刷
+墙面底漆均匀涂刷-面漆涂刷
+墙面纯色面漆涂刷-面漆涂刷
+背景墙艺术漆施工-面漆涂刷
+门窗边角精细刷涂-面漆涂刷
+顶面乳胶漆滚涂施工-面漆涂刷
+厨卫下水管道包裹-包管找平
+地面自流平施工处理-包管找平
+墙面全屋水泥砂浆找平-包管找平
+管道隔音棉加装-包管找平
+下水口瓷砖铺贴-瓷砖铺贴
+厨卫墙地通缝铺贴-瓷砖铺贴
+地砖干铺施工工艺-瓷砖铺贴
+墙砖定位-瓷砖铺贴
+墙面拉毛加固处理-瓷砖铺贴
+止逆阀安装-瓷砖铺贴
+沙子-瓷砖铺贴
+瓷砖完工展示-瓷砖铺贴
+瓷砖开孔-瓷砖铺贴
+瓷砖找平器调平固定-瓷砖铺贴
+瓷砖泡水预处理-瓷砖铺贴
+砖面挖孔定位-瓷砖铺贴
+窗台石门槛石安装-瓷砖铺贴
+贴墙砖-瓷砖铺贴
+铺地砖-瓷砖铺贴
+铺贴完成成品保护-瓷砖铺贴
+卫生间基层清理-防水施工
+厨卫闭水试验蓄水-防水施工
+墙面地面防水涂料涂刷-防水施工
+墙面防水上翻涂刷-防水施工
+楼下渗水查验确认-防水施工
+管根圆弧加固处理-防水施工
+防水涂层完工特写-防水施工
+阳台户外防水施工-防水施工
+吸睛画面-恶搞开篇
+工地恶搞-恶搞开篇
+搞笑涂料施工-恶搞开篇
+暴力拆除-恶搞开篇
+炫技-恶搞开篇
+贴砖恶搞-恶搞开篇
+墙体掉落-施工翻车镜
+墙面开裂-施工翻车镜
+墙面空鼓-施工翻车镜
+水管错位-施工翻车镜
+电线乱接-施工翻车镜
+防水翻车漏水-施工翻车镜
+墙面漆面细节查验-全屋验收
+柜体开合顺畅度检查-全屋验收
+踢脚线安装验收-软装进场
+验收合格签字确认-全屋验收
+窗帘轨道窗帘安装-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，最好能贴近油工主题，优先选墙面开裂、墙面空鼓、搞笑涂料施工等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+分点阐述全部用空镜，空镜（素材库标题）与文案内容需匹配，如无法匹配则选择近似的空镜（优先选墙面基层、面漆涂刷、吊顶造型等贴合油工主题的空镜）
+结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜
+“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
+每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数。
+type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库选匹配标题。
+“segment” 对应 “人物出镜”，人物出镜画面内容可语句顺延到下一画面。
+“empty_shot” 对应上述素材库标题，文案内容需匹配，匹配不上选近似空镜。
+禁止总字数偏离 180–220（含数字，不含标点符号）、总时长偏离 45–55 秒。
+禁止篡改原文油工施工沟通避坑相关的核心细节和逻辑。
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment” 或 “empty_shot”
+scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+voiceover: “配音文案”
+duration: “分镜时长”
+【示例】
+[
+{
+"id": 1,
+"type": "empty_shot",
+"scene": "搞笑涂料施工 - 恶搞开篇",
+"voiceover": "油工进场不想踩坑，记住这 6 句话就够了",
+"duration": "4.25s"
+},
+{
+"id": 2,
+"type": "segment",
+"scene": "人物出镜",
+"voiceover": "照着这 6 点跟油工师傅沟通，再也不怕被糊弄",
+"duration": "4.75s"
+},
+{
+"id": 3,
+"type": "empty_shot",
+"scene": "墙固施工-墙面基层",
+"voiceover": "第一，原始墙面刷高渗透墙固，自费也能防开裂反碱。",
+"duration": "5.25s"
+}
+]

python-api/app/ai/prompts/user/script.txt

@@ -0,0 +1 @@
+请帮我创作一份口播类短视频分镜脚本。

python-api/app/ai/prompts/user/title.txt

@@ -0,0 +1,14 @@
+请根据以下脚本内容，创作一个${title_type_desc}。
+
+使用场景：${usage_desc}
+脚本内容：
+${script_content}
+
+标题类型：${title_type_desc}
+字数限制：严格控制在 ${max_length} 个字以内（含标点）
+风格要求：${style_requirement}
+
+注意：
+${usage_note}
+
+直接返回标题文字，不要加引号、书名号或任何额外说明。

python-api/app/ai/prompts/user/title_system.txt

@@ -0,0 +1,16 @@
+你是一位专业的短视频标题创作专家，擅长为口播类短视频创作吸引眼球的标题。
+
+【当前任务场景】
+${usage_desc}
+
+【主标题（大标题）与副标题（小标题）的区别】
+- 主标题：视频最核心的卖点/钩子，必须极度吸睛。要求简短有力，善用数字、疑问、痛点、冲突等手法。
+- 副标题：对主标题的补充说明或延伸，承担"解释原因""制造悬念""补充细节"的作用。
+
+创作原则：
+1. 标题要紧扣脚本核心内容，提炼最有吸引力的点
+2. 语言口语化，符合短视频平台（抖音、快手）风格
+3. 主标题要"抓眼"，副标题要"留人"
+4. 严格控制字数，不超过用户指定的限制
+5. 直接返回标题文字，不要加引号、书名号或其他装饰符号
+6. 不要返回任何解释、说明或JSON格式

python-api/app/ai/providers/__init__.py

@@ -0,0 +1,33 @@
+"""
+LLM Provider 导出
+=================
+"""
+
+from app.ai.providers.base import (
+    GenerationResult,
+    LLMProvider,
+    ModelHealth,
+    ModelUnavailableError,
+    ProviderError,
+)
+
+# 火山方舟官方 SDK Provider
+# 需要: pip install 'volcengine-python-sdk[ark]'
+try:
+    from app.ai.providers.volcengine_provider import VolcengineProvider
+
+    VOLCENGINE_AVAILABLE = True
+except ImportError:
+    VOLCENGINE_AVAILABLE = False
+    VolcengineProvider = None
+
+__all__ = [
+    "LLMProvider",
+    "GenerationResult",
+    "ModelHealth",
+    "ProviderError",
+    "ModelUnavailableError",
+]
+
+if VOLCENGINE_AVAILABLE:
+    __all__.append("VolcengineProvider")

python-api/app/ai/providers/base.py

@@ -0,0 +1,115 @@
+"""
+LLM Provider 抽象基类
+=====================
+
+定义所有 AI 模型提供商的统一接口。
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+from pydantic import BaseModel
+
+
+class ModelHealth(BaseModel):
+    """模型健康状态"""
+
+    id: str
+    name: str
+    is_available: bool
+    response_time: float  # 毫秒
+    last_error: str | None = None
+
+
+class GenerationResult(BaseModel):
+    """生成结果"""
+
+    content: str
+    usage: dict | None = None  # token 用量等
+    model: str  # 实际使用的模型
+
+
+class LLMProvider(ABC):
+    """
+    LLM 提供商抽象基类
+
+    所有 AI 模型提供商（OpenAI、文心一言、通义千问等）需实现此接口。
+    """
+
+    # 提供商标识
+    provider_id: str = ""
+    provider_name: str = ""
+
+    def __init__(self, api_key: str | None = None, base_url: str | None = None, **kwargs):
+        """
+        初始化 Provider
+
+        Args:
+            api_key: API 密钥
+            base_url: 自定义 Base URL（用于代理或私有部署）
+            **kwargs: 其他配置参数
+        """
+        self.api_key = api_key
+        self.base_url = base_url
+        self.config = kwargs
+
+    @abstractmethod
+    async def generate(
+        self,
+        prompt: str,
+        model: str | None = None,
+        temperature: float = 0.7,
+        max_tokens: int | None = None,
+        **kwargs,
+    ) -> GenerationResult:
+        """
+        同步生成文本
+
+        Args:
+            prompt: 提示词
+            model: 模型名称，None 则使用默认模型
+            temperature: 随机性（0-2）
+            max_tokens: 最大生成 token 数
+            **kwargs: 额外参数
+
+        Returns:
+            GenerationResult: 生成结果
+        """
+        pass
+
+    @abstractmethod
+    async def health_check(self, model: str | None = None) -> ModelHealth:
+        """
+        健康检查
+
+        Args:
+            model: 指定模型，None 则检查默认模型
+
+        Returns:
+            ModelHealth: 健康状态
+        """
+        pass
+
+    @property
+    @abstractmethod
+    def available_models(self) -> list[str]:
+        """返回可用的模型列表"""
+        pass
+
+
+class ProviderError(Exception):
+    """Provider 调用异常"""
+
+    def __init__(
+        self, message: str, provider_id: str = "", original_error: Exception | None = None
+    ):
+        super().__init__(message)
+        self.provider_id = provider_id
+        self.original_error = original_error
+
+
+class ModelUnavailableError(ProviderError):
+    """模型不可用异常"""
+
+    pass

python-api/app/ai/providers/vidu_provider.py

@@ -0,0 +1,276 @@
+"""
+Vidu API Provider
+=================
+
+封装 Vidu 语音/视频相关 HTTP API：
+- 同步 TTS（/ent/v2/audio-tts）
+- 声音复刻（/ent/v2/audio-clone）
+- 视频生成（/ent/v2/lip-sync）
+- 查询任务（/ent/v2/tasks/{id}/creations）
+
+统一使用 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_vidu_error(status: int, message: str) -> PlatformError:
+    """把 Vidu HTTP 错误映射为标准 PlatformError"""
+    mapping = {
+        429: (PlatformErrorType.RATE_LIMIT, True),
+        401: (PlatformErrorType.AUTH_FAILED, False),
+        403: (PlatformErrorType.AUTH_FAILED, False),
+        400: (PlatformErrorType.BAD_REQUEST, False),
+        404: (PlatformErrorType.NOT_FOUND, False),
+        500: (PlatformErrorType.SERVER_ERROR, True),
+        502: (PlatformErrorType.SERVER_ERROR, True),
+        503: (PlatformErrorType.SERVER_ERROR, True),
+    }
+    error_type, retryable = mapping.get(status, (PlatformErrorType.UNKNOWN, False))
+    return PlatformError(
+        message=message,
+        platform="vidu",
+        retryable=retryable,
+        error_type=error_type,
+        status_code=status,
+    )
+
+
+class ViduProvider:
+    """Vidu API 客户端封装
+
+    使用 httpx.AsyncClient，支持外部注入（由 lifespan 管理生命周期）。
+    """
+
+    def __init__(
+        self,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        client: httpx.AsyncClient | None = None,
+    ):
+        settings = get_settings()
+        self.api_key = api_key or settings.VIDU_API_KEY
+        if base_url:
+            self.base_url = base_url.rstrip("/")
+        else:
+            from app.core.platform_config import get_platform_config_loader
+
+            platform_config = get_platform_config_loader().get_platform("vidu")
+            self.base_url = (platform_config.base_url if platform_config else "https://api.vidu.cn").rstrip("/")
+
+        if not self.api_key:
+            raise ValueError("Vidu API Key 未配置，请在 .env 中设置 VIDU_API_KEY")
+
+        if client is not None:
+            self.client = client
+            self._owns_client = False
+            # 外部传入的 client 也要补认证头（main.py / scheduler 共用 client 场景）
+            self.client.headers["Authorization"] = f"Token {self.api_key}"
+            self.client.headers["Content-Type"] = "application/json"
+        else:
+            self.client = httpx.AsyncClient(
+                timeout=httpx.Timeout(30.0, connect=5.0),
+                limits=httpx.Limits(max_connections=20, max_keepalive_connections=20),
+                headers={
+                    "Authorization": f"Token {self.api_key}",
+                    "Content-Type": "application/json",
+                },
+            )
+            self._owns_client = True
+
+    async def close(self) -> None:
+        """关闭 HTTP Client，释放连接池。仅在自己创建 Client 时关闭。"""
+        if self._owns_client and not self.client.is_closed:
+            await self.client.aclose()
+
+    # ==================== TTS 语音合成 ====================
+
+    async def tts_sync(
+        self,
+        text: str,
+        voice_id: str,
+        speed: float = 1.0,
+        volume: int = 0,
+        pitch: int = 0,
+        emotion: str | None = None,
+        pronunciation_dict_tone: list[str] | None = None,
+        payload: str | None = None,
+    ) -> dict[str, Any]:
+        """同步语音合成
+
+        POST /ent/v2/audio-tts
+        """
+        url = f"{self.base_url}/ent/v2/audio-tts"
+
+        body: dict[str, Any] = {
+            "text": text,
+            "voice_setting_voice_id": voice_id,
+            "voice_setting_speed": speed,
+            "voice_setting_volume": volume,
+            "voice_setting_pitch": pitch,
+        }
+        if emotion:
+            body["voice_setting_emotion"] = emotion
+        if pronunciation_dict_tone:
+            body["pronunciation_dict_tone"] = pronunciation_dict_tone
+        if payload:
+            body["payload"] = payload
+
+        logger.info(f"[Vidu TTS] 请求参数: text_length={len(text)}")
+
+        logger.info(f"[Vidu TTS] 提交请求: url={url}, body={body}")
+
+        try:
+            resp = await self.client.post(url, json=body)
+            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}"
+                logger.error(f"[Vidu TTS] 请求失败: url={url}, status={resp.status_code}, response={data}")
+                raise _map_vidu_error(resp.status_code, f"Vidu TTS error: {msg}")
+            return data
+        except (httpx.NetworkError, httpx.TimeoutException) as e:
+            logger.error(f"[Vidu TTS] 网络错误: {e}")
+            raise PlatformError(
+                f"Vidu TTS 网络错误: {e}",
+                platform="vidu",
+                retryable=True,
+                error_type=PlatformErrorType.TIMEOUT,
+            ) from e
+
+    # ==================== 声音复刻 ====================
+
+    async def clone_voice(
+        self,
+        audio_url: str,
+        voice_id: str,
+        text: str,
+        prompt_audio_url: str | None = None,
+        prompt_text: str | None = None,
+        payload: str | None = None,
+    ) -> dict[str, Any]:
+        """声音复刻（同步接口）
+
+        POST /ent/v2/audio-clone
+        """
+        url = f"{self.base_url}/ent/v2/audio-clone"
+
+        body: dict[str, Any] = {
+            "audio_url": audio_url,
+            "voice_id": voice_id,
+            "text": text,
+        }
+        if prompt_audio_url:
+            body["prompt_audio_url"] = prompt_audio_url
+        if prompt_text:
+            body["prompt_text"] = prompt_text
+        if payload:
+            body["payload"] = payload
+
+        try:
+            resp = await self.client.post(url, json=body)
+            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}"
+                logger.error(f"[Vidu Clone] 请求失败: url={url}, status={resp.status_code}, response={data}")
+                raise _map_vidu_error(resp.status_code, f"Vidu clone error: {msg}")
+            return data
+        except (httpx.NetworkError, httpx.TimeoutException) as e:
+            logger.error(f"[Vidu Clone] 网络错误: {e}")
+            raise PlatformError(
+                f"Vidu Clone 网络错误: {e}",
+                platform="vidu",
+                retryable=True,
+                error_type=PlatformErrorType.TIMEOUT,
+            ) from e
+
+    # ==================== 视频生成 ====================
+
+    async def lip_sync(
+        self,
+        video_url: str,
+        audio_url: str | None = None,
+        text: str | None = None,
+        voice_id: str | None = None,
+        speed: float = 1.0,
+        volume: int = 0,
+        ref_photo_url: str | None = None,
+        callback_url: str | None = None,
+        payload: str | None = None,
+    ) -> dict[str, Any]:
+        """视频生成（异步接口）
+
+        POST /ent/v2/lip-sync
+        """
+        url = f"{self.base_url}/ent/v2/lip-sync"
+
+        body: dict[str, Any] = {"video_url": video_url}
+
+        if audio_url:
+            body["audio_url"] = audio_url
+        if text:
+            body["text"] = text
+        if voice_id:
+            body["voice_id"] = voice_id
+        if speed != 1.0:
+            body["speed"] = speed
+        if volume != 0:
+            body["volume"] = volume
+        if ref_photo_url:
+            body["ref_photo_url"] = ref_photo_url
+        if callback_url:
+            body["callback_url"] = callback_url
+        if payload:
+            body["payload"] = payload
+
+        try:
+            resp = await self.client.post(url, json=body)
+            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}"
+                logger.error(f"[Vidu LipSync] 请求失败: url={url}, status={resp.status_code}, response={data}")
+                raise _map_vidu_error(resp.status_code, f"Vidu lip-sync error: {msg}")
+            return data
+        except (httpx.NetworkError, httpx.TimeoutException) as e:
+            logger.error(f"[Vidu LipSync] 网络错误: {e}")
+            raise PlatformError(
+                f"Vidu LipSync 网络错误: {e}",
+                platform="vidu",
+                retryable=True,
+                error_type=PlatformErrorType.TIMEOUT,
+            ) from e
+
+    # ==================== 查询任务 ====================
+
+    async def query_task(self, task_id: str) -> dict[str, Any]:
+        """查询任务状态及生成物
+
+        GET /ent/v2/tasks/{task_id}/creations
+        """
+        url = f"{self.base_url}/ent/v2/tasks/{task_id}/creations"
+
+        try:
+            resp = await self.client.get(url)
+            data = resp.json()
+            if resp.status_code != 200:
+                msg = data.get("err_code") or data.get("message") or f"HTTP {resp.status_code}"
+                logger.error(f"[Vidu Query] 请求失败: url={url}, status={resp.status_code}, response={data}")
+                raise _map_vidu_error(resp.status_code, f"Vidu query task error: {msg}")
+            return data
+        except (httpx.NetworkError, httpx.TimeoutException) as e:
+            logger.error(f"[Vidu Query] 网络错误: {e}")
+            raise PlatformError(
+                f"Vidu Query 网络错误: {e}",
+                platform="vidu",
+                retryable=True,
+                error_type=PlatformErrorType.TIMEOUT,
+            ) from e

python-api/app/ai/providers/volcengine_caption_provider.py

@@ -0,0 +1,251 @@
+"""
+火山引擎 OpenSpeech Provider
+=============================
+
+直接封装火山 OpenSpeech HTTP API：
+- 字幕生成（/vc/submit + /vc/query）
+- 自动打轴（/vc/ata/submit + /vc/ata/query）
+
+使用 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_caption_error(status: int, message: str, code: int | None = None) -> PlatformError:
+    """把火山字幕错误映射为标准 PlatformError"""
+    error_mapping = {
+        1001: (PlatformErrorType.BAD_REQUEST, False),
+        1002: (PlatformErrorType.AUTH_FAILED, False),
+        1003: (PlatformErrorType.RATE_LIMIT, True),
+        1010: (PlatformErrorType.BAD_REQUEST, False),
+        1011: (PlatformErrorType.BAD_REQUEST, False),
+        1012: (PlatformErrorType.BAD_REQUEST, False),
+        1013: (PlatformErrorType.BAD_REQUEST, False),
+    }
+
+    if code is not None and code in error_mapping:
+        error_type, retryable = error_mapping[code]
+        return PlatformError(
+            message, platform="volcengine_caption",
+            retryable=retryable, error_type=error_type,
+            status_code=status,
+        )
+
+    http_mapping = {
+        429: (PlatformErrorType.RATE_LIMIT, True),
+        401: (PlatformErrorType.AUTH_FAILED, False),
+        403: (PlatformErrorType.AUTH_FAILED, False),
+        400: (PlatformErrorType.BAD_REQUEST, False),
+        500: (PlatformErrorType.SERVER_ERROR, True),
+        502: (PlatformErrorType.SERVER_ERROR, True),
+        503: (PlatformErrorType.SERVER_ERROR, True),
+    }
+    error_type, retryable = http_mapping.get(status, (PlatformErrorType.UNKNOWN, False))
+    return PlatformError(
+        message, platform="volcengine_caption",
+        retryable=retryable, error_type=error_type,
+        status_code=status,
+    )
+
+
+class VolcengineCaptionProvider:
+    """火山引擎字幕 Provider
+
+    直接调用 OpenSpeech HTTP API，不做业务层处理（如格式转换、轮询）。
+    """
+
+    BASE_URL = "https://openspeech.bytedance.com/api/v1/vc"
+    DEFAULT_TIMEOUT = 60.0
+
+    def __init__(
+        self,
+        appid: str | None = None,
+        token: str | None = None,
+        client: httpx.AsyncClient | None = None,
+    ):
+        settings = get_settings()
+        self.appid = appid or settings.VOLCENGINE_CAPTION_APPID or ""
+        self.token = token or settings.VOLCENGINE_CAPTION_TOKEN or ""
+
+        if not self.appid:
+            raise PlatformError(
+                "VOLCENGINE_CAPTION_APPID 未配置",
+                platform="volcengine_caption",
+                retryable=False,
+                error_type=PlatformErrorType.BAD_REQUEST,
+            )
+        if not self.token:
+            raise PlatformError(
+                "VOLCENGINE_CAPTION_TOKEN 未配置",
+                platform="volcengine_caption",
+                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 submit_caption_task(
+        self,
+        audio_url: str,
+        language: str = "zh-CN",
+        caption_type: str = "auto",
+        use_punc: bool = True,
+        use_itn: bool = True,
+        words_per_line: int = 46,
+        max_lines: int = 1,
+    ) -> dict[str, Any]:
+        """提交字幕生成任务，返回 {id: task_id}"""
+        params = {
+            "appid": self.appid,
+            "language": language,
+            "caption_type": caption_type,
+            "use_punc": str(use_punc),
+            "use_itn": str(use_itn),
+            "words_per_line": words_per_line,
+            "max_lines": max_lines,
+        }
+        payload = {"url": audio_url}
+
+        try:
+            response = await self.client.post(
+                f"{self.BASE_URL}/submit",
+                params=params,
+                json=payload,
+                headers=self._get_headers(),
+            )
+            response.raise_for_status()
+            data = response.json()
+            if "id" not in data:
+                raise _map_caption_error(500, f"提交任务失败: {data.get('message', '未知错误')}")
+            return data
+        except PlatformError:
+            raise
+        except httpx.HTTPStatusError as e:
+            raise _map_caption_error(e.response.status_code, f"HTTP错误: {e.response.status_code}") from e
+        except (httpx.NetworkError, httpx.TimeoutException) as e:
+            raise PlatformError(
+                f"字幕服务网络错误: {e}", platform="volcengine_caption",
+                retryable=True, error_type=PlatformErrorType.TIMEOUT,
+            ) from e
+        except Exception as e:
+            raise _map_caption_error(500, f"提交任务失败: {str(e)}") from e
+
+    async def query_caption_task(
+        self,
+        task_id: str,
+        blocking: bool = False,
+    ) -> dict[str, Any]:
+        """查询字幕任务结果，返回原始 JSON"""
+        params = {
+            "appid": self.appid,
+            "id": task_id,
+            "blocking": 1 if blocking else 0,
+        }
+
+        try:
+            response = await self.client.get(
+                f"{self.BASE_URL}/query",
+                params=params,
+                headers=self._get_headers(),
+            )
+            response.raise_for_status()
+            return response.json()
+        except PlatformError:
+            raise
+        except httpx.HTTPStatusError as e:
+            raise _map_caption_error(e.response.status_code, f"HTTP错误: {e.response.status_code}") from e
+        except (httpx.NetworkError, httpx.TimeoutException) as e:
+            raise PlatformError(
+                f"字幕服务网络错误: {e}", platform="volcengine_caption",
+                retryable=True, error_type=PlatformErrorType.TIMEOUT,
+            ) from e
+        except Exception as e:
+            raise _map_caption_error(500, f"查询任务失败: {str(e)}") from e
+
+    # ==================== 自动打轴 ====================
+
+    async def submit_auto_align_task(
+        self,
+        audio_url: str,
+        audio_text: str,
+        caption_type: str = "speech",
+        sta_punc_mode: int = 3,
+    ) -> dict[str, Any]:
+        """提交自动字幕打轴任务，返回 {id: task_id}"""
+        params = {
+            "appid": self.appid,
+            "caption_type": caption_type,
+            "sta_punc_mode": sta_punc_mode,
+        }
+        payload = {"url": audio_url, "audio_text": audio_text}
+
+        try:
+            response = await self.client.post(
+                f"{self.BASE_URL}/ata/submit",
+                params=params,
+                json=payload,
+                headers=self._get_headers(),
+            )
+            response.raise_for_status()
+            data = response.json()
+            if "id" not in data:
+                raise _map_caption_error(500, f"提交打轴任务失败: {data.get('message', '未知错误')}")
+            return data
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise _map_caption_error(500, f"提交打轴任务失败: {str(e)}") from e
+
+    async def query_auto_align_task(
+        self,
+        task_id: str,
+        blocking: bool = False,
+    ) -> dict[str, Any]:
+        """查询打轴任务结果，返回原始 JSON"""
+        params = {
+            "appid": self.appid,
+            "id": task_id,
+            "blocking": 1 if blocking else 0,
+        }
+
+        try:
+            response = await self.client.get(
+                f"{self.BASE_URL}/ata/query",
+                params=params,
+                headers=self._get_headers(),
+            )
+            response.raise_for_status()
+            return response.json()
+        except PlatformError:
+            raise
+        except Exception as e:
+            raise _map_caption_error(500, f"查询打轴任务失败: {str(e)}") from e

python-api/app/ai/providers/volcengine_mediakit_provider.py

@@ -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

python-api/app/ai/providers/volcengine_provider.py

@@ -0,0 +1,323 @@
+"""
+火山方舟官方 SDK Provider
+==========================
+
+基于火山方舟官方 Python SDK 实现，支持：
+- 文本生成 (Chat Completions)
+- 流式输出
+- 向量化
+- 深度思考
+- 工具调用
+
+安装依赖:
+    pip install 'volcengine-python-sdk[ark]'
+
+文档:
+    https://www.volcengine.com/docs/82379
+"""
+
+from __future__ import annotations
+
+import logging
+import time
+
+from app.ai.providers.base import (
+    GenerationResult,
+    LLMProvider,
+    ModelHealth,
+    ProviderError,
+)
+from app.core.exceptions import PlatformError, PlatformErrorType
+
+logger = logging.getLogger(__name__)
+
+# 尝试导入火山方舟 SDK
+try:
+    from volcenginesdkarkruntime import AsyncArk
+
+    VOLCENGINE_SDK_AVAILABLE = True
+except ImportError:
+    VOLCENGINE_SDK_AVAILABLE = False
+    logger.warning("火山方舟 SDK 未安装，请运行: pip install 'volcengine-python-sdk[ark]'")
+
+
+class VolcengineProvider(LLMProvider):
+    """
+    火山方舟官方 SDK Provider
+
+    支持能力：
+    - 文本对话 (Chat Completions)
+    - 向量化 (Embeddings)
+    - 深度思考 (Reasoning)
+    """
+
+    provider_id = "volcengine"
+    provider_name = "火山方舟"
+
+    # 默认配置
+    DEFAULT_BASE_URL = "https://ark.cn-beijing.volces.com/api/v3"
+    DEFAULT_TIMEOUT = 1800  # 秒，方舟推荐 1800 秒以上
+
+    # 模型 ID 映射（从配置文件加载）
+    PRESET_MODELS: dict[str, str] = {}
+
+    @classmethod
+    def load_models_from_config(cls, models: list[dict]):
+        """
+        从配置文件加载模型列表
+
+        Args:
+            models: 模型列表，每个模型包含 model_name 字段
+        """
+        cls.PRESET_MODELS = {}
+        for model in models:
+            model_id = model.get("model_name")
+            model_alias = model.get("id")
+            if model_id and model_alias:
+                cls.PRESET_MODELS[model_alias] = model_id
+
+        # 确保至少有一个默认模型
+        if not cls.PRESET_MODELS:
+            cls.PRESET_MODELS = {
+                "doubao-seed-2-0-pro": "doubao-seed-2-0-pro-260215",
+            }
+
+        logger.info(f"已加载 {len(cls.PRESET_MODELS)} 个模型: {list(cls.PRESET_MODELS.keys())}")
+
+    def __init__(
+        self,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        timeout: int = DEFAULT_TIMEOUT,
+        default_model: str | None = None,
+        **kwargs,
+    ):
+        """
+        初始化火山方舟 Provider
+
+        Args:
+            api_key: API Key，从火山方舟控制台获取
+            base_url: API 基础地址，默认北京节点
+            timeout: 请求超时时间（秒）
+            default_model: 默认模型（Model ID）
+        """
+        from app.config import get_settings
+        from app.core.platform_config import get_platform_config_loader
+
+        settings = get_settings()
+        # API Key 从环境变量读取
+        resolved_api_key = api_key or settings.VOLCENGINE_API_KEY
+        # base_url 从 platform-config.yaml 读取，fallback 到代码常量
+        loader = get_platform_config_loader()
+        platform = loader.get_platform("volcengine_ark")
+        yaml_base_url = platform.base_url if platform else None
+        resolved_base_url = base_url or yaml_base_url or self.DEFAULT_BASE_URL
+
+        super().__init__(resolved_api_key, resolved_base_url, **kwargs)
+
+        if not VOLCENGINE_SDK_AVAILABLE:
+            raise ProviderError(
+                "火山方舟 SDK 未安装，请运行: pip install 'volcengine-python-sdk[ark]'",
+                provider_id=self.provider_id,
+            )
+
+        if not self.api_key:
+            raise ProviderError("火山方舟 API Key 未配置", provider_id=self.provider_id)
+
+        self.timeout = timeout
+        # 使用模型 ID 映射（自动映射）
+        if default_model:
+            self.default_model = self.PRESET_MODELS.get(default_model, default_model)
+        elif self.PRESET_MODELS:
+            self.default_model = list(self.PRESET_MODELS.values())[0]
+        else:
+            # 兜底：使用一个默认模型ID（如果用户未配置任何模型）
+            self.default_model = "doubao-seed-2-0-pro-260215"
+
+        self.client = self._create_client()
+
+    def _create_client(self) -> AsyncArk:
+        """创建火山方舟异步客户端"""
+        return AsyncArk(
+            api_key=self.api_key,
+            base_url=self.base_url or self.DEFAULT_BASE_URL,
+            timeout=self.timeout,
+        )
+
+    async def generate(
+        self,
+        prompt: str,
+        model: str | None = None,
+        temperature: float = 0.7,
+        max_tokens: int | None = None,
+        system_prompt: str | None = None,
+        **kwargs,
+    ) -> GenerationResult:
+        """
+        同步生成文本
+
+        Args:
+            prompt: 用户提示词
+            model: 模型 ID（如 doubao-seed-2-0-pro-260215）
+            temperature: 随机性 (0-2)
+            max_tokens: 最大生成 token 数
+            system_prompt: 系统提示词（可选）
+            **kwargs: 额外参数（如 reasoning_effort 控制思考程度）
+
+        Returns:
+            GenerationResult: 生成结果
+        """
+        try:
+            # 构建消息
+            messages = []
+            if system_prompt:
+                messages.append({"role": "system", "content": system_prompt})
+            messages.append({"role": "user", "content": prompt})
+
+            # 映射模型名称到模型 ID
+            model_id = self.PRESET_MODELS.get(model, model) if model else self.default_model
+
+            # 构建请求参数
+            request_params = {
+                "model": model_id,
+                "messages": messages,
+                "temperature": temperature,
+            }
+
+            if max_tokens:
+                request_params["max_tokens"] = max_tokens
+
+            # 额外参数（如深度思考）
+            if "reasoning_effort" in kwargs:
+                request_params["reasoning_effort"] = kwargs["reasoning_effort"]
+
+            if kwargs.get("response_format") == "json_object":
+                request_params["response_format"] = {"type": "json_object"}
+
+            # 调用 API
+            completion = await self.client.chat.completions.create(**request_params)
+
+            # 解析结果
+            content = completion.choices[0].message.content or ""
+            usage = None
+            if completion.usage:
+                usage = {
+                    "prompt_tokens": completion.usage.prompt_tokens,
+                    "completion_tokens": completion.usage.completion_tokens,
+                    "total_tokens": completion.usage.total_tokens,
+                }
+
+            return GenerationResult(
+                content=content,
+                usage=usage,
+                model=completion.model or model or self.default_model,
+            )
+
+        except Exception as e:
+            raise self._wrap_error(e)
+
+    async def create_embeddings(self, texts: list[str], model: str | None = None, **kwargs) -> dict:
+        """
+        文本向量化
+
+        Args:
+            texts: 文本列表
+            model: 向量化模型
+
+        Returns:
+            dict: 包含向量化结果
+        """
+        try:
+            response = await self.client.embeddings.create(
+                model=model or "doubao-embedding-1.5", input=texts, **kwargs
+            )
+
+            embeddings = []
+            for item in response.data:
+                embeddings.append(
+                    {
+                        "index": item.index,
+                        "embedding": item.embedding,
+                    }
+                )
+
+            return {
+                "embeddings": embeddings,
+                "model": response.model,
+                "usage": {
+                    "prompt_tokens": response.usage.prompt_tokens,
+                    "total_tokens": response.usage.total_tokens,
+                },
+            }
+
+        except Exception as e:
+            raise self._wrap_error(e)
+
+    async def health_check(self, model: str | None = None) -> ModelHealth:
+        """健康检查"""
+        start_time = time.time()
+        test_model = model or self.default_model
+
+        try:
+            await self.client.chat.completions.create(
+                model=test_model,
+                messages=[{"role": "user", "content": "Hi"}],
+                max_tokens=5,
+            )
+
+            response_time = (time.time() - start_time) * 1000
+
+            return ModelHealth(
+                id=test_model,
+                name=f"火山方舟 {test_model}",
+                is_available=True,
+                response_time=response_time,
+                last_error=None,
+            )
+
+        except Exception as e:
+            return ModelHealth(
+                id=test_model,
+                name=f"火山方舟 {test_model}",
+                is_available=False,
+                response_time=(time.time() - start_time) * 1000,
+                last_error=str(e),
+            )
+
+    def _wrap_error(self, e: Exception) -> PlatformError:
+        """把 SDK 异常翻译为标准 PlatformError"""
+        message = str(e)
+        status = getattr(e, "status_code", None) or getattr(e, "code", None)
+
+        if status == 429 or "rate limit" in message.lower():
+            return PlatformError(
+                message, platform="volcengine_ark", retryable=True,
+                error_type=PlatformErrorType.RATE_LIMIT, status_code=status,
+            )
+        elif status in (401, 403) or "authentication" in message.lower():
+            return PlatformError(
+                message, platform="volcengine_ark", retryable=False,
+                error_type=PlatformErrorType.AUTH_FAILED, status_code=status,
+            )
+        elif status and status >= 500:
+            return PlatformError(
+                message, platform="volcengine_ark", retryable=True,
+                error_type=PlatformErrorType.SERVER_ERROR, status_code=status,
+            )
+        elif "timeout" in message.lower() or isinstance(e, TimeoutError):
+            return PlatformError(
+                message, platform="volcengine_ark", retryable=True,
+                error_type=PlatformErrorType.TIMEOUT,
+            )
+        else:
+            return PlatformError(
+                message, platform="volcengine_ark", retryable=False,
+                error_type=PlatformErrorType.UNKNOWN,
+            )
+
+    @property
+    def available_models(self) -> list[str]:
+        """返回可用模型列表（与 platform-config.yaml 配置保持一致）"""
+        return [
+            "doubao-seed-2-0-pro",
+        ]

python-api/app/api/deps.py

@@ -0,0 +1,84 @@
+"""
+依赖注入工具
+============
+"""
+
+from __future__ import annotations
+
+from fastapi import Depends, HTTPException, status
+from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.config import get_settings
+from app.core.security import verify_access_token
+from app.db.session import get_db as db_session
+from app.models.user import User
+
+settings = get_settings()
+security = HTTPBearer(auto_error=False)
+
+
+# 数据库依赖
+async def get_db() -> AsyncSession:
+    """获取数据库 Session"""
+    async for session in db_session():
+        yield session
+
+
+async def get_current_user(
+    credentials: HTTPAuthorizationCredentials | None = Depends(security),
+    db: AsyncSession = Depends(get_db),
+) -> User:
+    """从 Authorization Header 中提取 JWT Access Token 并验证。"""
+    if credentials is None:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="缺少认证信息",
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+
+    token = credentials.credentials
+    payload = verify_access_token(token)
+    if not payload or not payload.get("sub"):
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="Token 无效或已过期",
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+
+    user_id = payload.get("sub")
+    result = await db.execute(select(User).where(User.id == user_id))
+    user = result.scalar_one_or_none()
+
+    if user is None:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="用户不存在",
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+
+    if not user.is_active:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail="账号已被封禁",
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+
+    return user
+
+
+async def get_current_user_optional(
+    credentials: HTTPAuthorizationCredentials | None = Depends(security),
+    db=Depends(get_db),
+) -> User | None:
+    """
+    获取当前登录用户（可选，未登录返回 None）
+    """
+    if credentials is None:
+        return None
+
+    try:
+        return await get_current_user(credentials, db)
+    except HTTPException:
+        return None

python-api/app/api/v1/auth.py

@@ -0,0 +1,220 @@
+"""
+认证模块 API
+============
+
+采用"手机号 + JWT + 单设备登录"的认证方案。
+
+核心接口：
+- /login: 手机号验证码登录（签发双 Token + SSE 踢人）
+- /refresh: Refresh Token 轮换（换取新 Token 对）
+- /logout: 登出（删除设备记录）
+- /send-code: 发送短信验证码
+- /me: 获取当前用户信息
+"""
+
+from __future__ import annotations
+
+from fastapi import APIRouter, Depends, HTTPException, Request, status
+
+from app.api.deps import get_current_user
+from app.crud import user as user_crud
+from app.db.session import AsyncSession, get_db
+from app.models.user import User
+from app.schemas.auth import (
+    MobileLoginRequest,
+    RefreshTokenRequest,
+    SendSmsCodeRequest,
+    TokenResponse,
+)
+from app.schemas.common import ApiResponse, success_response
+from app.schemas.user import UpdateNicknameRequest, UserProfileResponse
+from app.services.auth_service import (
+    login_with_sms,
+    logout,
+    refresh_access_token,
+    send_sms_code,
+)
+
+router = APIRouter()
+
+
+@router.post("/send-code", response_model=ApiResponse[dict])
+async def send_code(
+    request: SendSmsCodeRequest,
+    db: AsyncSession = Depends(get_db),
+):
+    """
+    发送短信验证码
+
+    开发阶段验证码直接打印到日志，生产环境接入短信服务商。
+    每个手机号每日最多发送 10 次。
+    """
+    # 校验用户是否存在
+    user = await user_crud.get_by_mobile(db, mobile=request.mobile)
+    if user is None:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="用户不存在",
+        )
+
+    try:
+        await send_sms_code(request.mobile)
+    except ValueError as e:
+        raise HTTPException(
+            status_code=status.HTTP_429_TOO_MANY_REQUESTS,
+            detail=str(e),
+        )
+    return success_response(
+        data={"expire_minutes": 5},
+        message="验证码已发送",
+    )
+
+
+@router.post("/login", response_model=ApiResponse[TokenResponse])
+async def login(
+    request: MobileLoginRequest,
+    db: AsyncSession = Depends(get_db),
+    http_request: Request = None,
+):
+    """
+    手机号验证码登录
+
+    流程：
+    1. 校验验证码
+    2. 获取或创建用户
+    3. 踢掉旧设备（SSE 推送）
+    4. 创建/覆盖设备记录
+    5. 签发双 Token（Access + Refresh）
+    """
+    # 获取客户端 IP（优先从 Nginx 转发头读取真实公网 IP）
+    client_ip = None
+    if http_request:
+        xff = http_request.headers.get("x-forwarded-for")
+        if xff:
+            client_ip = xff.split(",")[0].strip()
+        else:
+            xri = http_request.headers.get("x-real-ip")
+            client_ip = xri or (http_request.client.host if http_request.client else None)
+
+    try:
+        result = await login_with_sms(
+            db,
+            mobile=request.mobile,
+            code=request.code,
+            device_id=request.device_id,
+            device_name=request.device_name,
+            os_info=request.os_info,
+            app_version=request.app_version,
+            ip=client_ip,
+        )
+    except ValueError as e:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=str(e),
+        )
+
+    return success_response(
+        data=TokenResponse(
+            access_token=result["access_token"],
+            refresh_token=result["refresh_token"],
+            user=result["user"],
+        ),
+        message="登录成功",
+    )
+
+
+@router.post("/refresh", response_model=ApiResponse[dict])
+async def refresh_token(
+    request: RefreshTokenRequest,
+    db: AsyncSession = Depends(get_db),
+):
+    """
+    用 Refresh Token 换取新的 Token 对（Token 轮换）
+
+    每次刷新都会生成全新的 Access Token 和 Refresh Token，
+    同时更新设备记录中的 refresh_token_hash。
+    """
+    try:
+        result = await refresh_access_token(db, refresh_token=request.refresh_token)
+    except ValueError as e:
+        raise HTTPException(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail=str(e),
+            headers={"WWW-Authenticate": "Bearer"},
+        )
+
+    return success_response(
+        data={
+            "access_token": result["access_token"],
+            "refresh_token": result["refresh_token"],
+        },
+        message="Token 刷新成功",
+    )
+
+
+@router.post("/logout", response_model=ApiResponse[dict])
+async def do_logout(
+    current_user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """
+    用户登出
+
+    删除设备记录，注销 SSE 连接，使当前设备的 Token 失效。
+    """
+    await logout(db, user_id=current_user.id)
+
+    return success_response(
+        data={},
+        message="登出成功",
+    )
+
+
+@router.get("/me", response_model=ApiResponse[UserProfileResponse])
+async def get_me(
+    current_user: User = Depends(get_current_user),
+):
+    """获取当前登录用户信息"""
+    return success_response(
+        data=UserProfileResponse(
+            id=current_user.id,
+            mobile=current_user.mobile,
+            nickname=current_user.nickname,
+            avatar=current_user.avatar_url or "",
+            status=current_user.status,
+            source=current_user.source,
+            last_login_at=current_user.last_login_at,
+            created_at=current_user.created_at,
+        )
+    )
+
+
+@router.patch("/me", response_model=ApiResponse[UserProfileResponse])
+async def update_me(
+    request: UpdateNicknameRequest,
+    current_user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    """修改当前用户信息（仅支持修改昵称）"""
+    # current_user 来自 get_current_user 的会话，和当前 db 不是同一个会话
+    # 需要重新查询到当前会话中才能正确提交
+    user = await user_crud.get(db, id=current_user.id)
+    if user is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="用户不存在")
+    user.nickname = request.nickname.strip()
+    await db.commit()
+    await db.refresh(user)
+
+    return success_response(
+        data=UserProfileResponse(
+            id=user.id,
+            mobile=user.mobile,
+            nickname=user.nickname,
+            avatar=user.avatar_url or "",
+            status=user.status,
+            source=user.source,
+            last_login_at=user.last_login_at,
+            created_at=user.created_at,
+        ),
+        message="昵称修改成功",
+    )