bump version to 1.8.0

Rust 层 video_compose.rs 和 lib.rs 中的校验使用绝对误差 0.01
（约 1.78% 相对误差），比前端 videoValidation.ts 的 3% 更严格，
导致部分前端通过的视频在 Rust 层被拦截。

统一改为 ，
与前端的相对误差算法保持一致。

.github/workflows/release.yml

@@ -25,6 +25,8 @@ jobs:
     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
@@ -96,6 +98,7 @@ jobs:
         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
@@ -103,12 +106,25 @@ jobs:
           name: macos-universal
           path: |
             tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
-            tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg.sig
+            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
@@ -144,6 +160,7 @@ jobs:
           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 }}
 
@@ -170,6 +187,7 @@ jobs:
         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
@@ -178,4 +196,15 @@ jobs:
           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

@@ -27,3 +27,9 @@ test_kick.sh
 .qiniu_pythonsdk_hostscache.json
 tauri-app/src-tauri/binaries/*
 .tauri-signing-key
+*.key
+*test*.key*
+.atomcode/
+mixkit_bgm/
+*.exe
+*.exe.sig

.gitlab-ci.yml

@@ -80,8 +80,9 @@ build-frontend-macos:
     paths:
       # DMG 安装包 (推荐用户下载)
       - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/dmg/*.dmg
-      # .app bundle (供进一步分发或公证使用)
-      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app
+      # Updater 专用包 + 签名
+      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz
+      - tauri-app/src-tauri/target/universal-apple-darwin/release/bundle/macos/*.app.tar.gz.sig
     expire_in: "${ARTIFACT_EXPIRE_DAYS} days"
   timeout: 45 minutes
   retry:
@@ -114,8 +115,11 @@ build-frontend-windows:
   artifacts:
     name: "meijiaka-windows-${CI_COMMIT_REF_NAME}-${CI_COMMIT_SHORT_SHA}"
     paths:
-      # NSIS 安装包 (推荐用户下载)
+      # Updater 专用包 + 签名
       - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe
+      - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*.exe.sig
+      # NSIS 安装包 (推荐用户下载)
+      - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/*-setup.exe
       # MSI 安装包 (企业部署场景)
       - tauri-app/src-tauri/target/x86_64-pc-windows-msvc/release/bundle/msi/*.msi
     expire_in: "${ARTIFACT_EXPIRE_DAYS} days"

AGENTS.md

@@ -9,7 +9,7 @@
 **美家卡智影**是一款面向桌面端的 AI 视频创作应用，采用"Python 后端 API + Tauri 桌面前端"的混合架构。
 
 - **产品标识**: `cn.meijiaka.ai-video` / `cn.meijiaka.ai-zy`
-- **版本**: `1.5.18`
+- **版本**: `1.8.0`
 - **核心功能**: AI 脚本生成、AI 配音合成（TTS）、声音复刻、视频生成（Vidu）、视频字幕生成、压制成片（FFmpeg）、项目本地持久化
 
 ### 技术栈总览

VERSION

@@ -1 +1 @@
-1.5.18
+1.8.0

docs/app-update-system.md

@@ -71,7 +71,7 @@ INSERT INTO app_releases (version, release_date, notes, mandatory) VALUES
 ('0.2.0', '2026-04-20 10:00:00', '新增：批量导出功能\n优化：性能提升 30%', FALSE);
 ```
 
-#### 2.1.2 release_packages - 平台包信息
+#### 2.1.2 mjk_app_release_packages - 平台包信息
 
 | 字段 | 类型 | 说明 | 约束 |
 |------|------|------|------|
@@ -97,7 +97,7 @@ INSERT INTO app_releases (version, release_date, notes, mandatory) VALUES
 
 **示例数据**:
 ```sql
-INSERT INTO release_packages (release_id, platform, architecture, filename, file_url, file_size, file_hash) VALUES
+INSERT INTO mjk_app_release_packages (release_id, platform, architecture, filename, file_url, file_size, file_hash) VALUES
 (2, 'darwin', 'x86_64', 'meijiaka_0.1.1_darwin_x86_64.dmg',
  'https://cdn.meijiaka.com/releases/meijiaka_0.1.1_darwin_x86_64.dmg',
  102400000, 'sha256:abc123...'),
@@ -129,7 +129,7 @@ INSERT INTO release_packages (release_id, platform, architecture, filename, file
 CREATE INDEX idx_releases_release_date ON app_releases(release_date DESC);
 
 -- 平台包复合索引
-CREATE INDEX idx_packages_platform_arch ON release_packages(platform, architecture);
+CREATE INDEX idx_packages_platform_arch ON mjk_app_release_packages(platform, architecture);
 
 -- 下载统计
 CREATE INDEX idx_downloads_release_id ON update_downloads(release_id);
@@ -151,7 +151,7 @@ CREATE TABLE IF NOT EXISTS app_releases (
 );
 
 -- 创建平台包信息表
-CREATE TABLE IF NOT EXISTS release_packages (
+CREATE TABLE IF NOT EXISTS mjk_app_release_packages (
     id SERIAL PRIMARY KEY,
     release_id INTEGER NOT NULL REFERENCES app_releases(id) ON DELETE CASCADE,
     platform VARCHAR(20) NOT NULL,
@@ -177,8 +177,8 @@ CREATE TABLE IF NOT EXISTS update_downloads (
 -- 创建索引
 CREATE INDEX IF NOT EXISTS idx_releases_version ON app_releases(version);
 CREATE INDEX IF NOT EXISTS idx_releases_release_date ON app_releases(release_date DESC);
-CREATE INDEX IF NOT EXISTS idx_packages_platform_arch ON release_packages(platform, architecture);
-CREATE INDEX IF NOT EXISTS idx_packages_release_id ON release_packages(release_id);
+CREATE INDEX IF NOT EXISTS idx_packages_platform_arch ON mjk_app_release_packages(platform, architecture);
+CREATE INDEX IF NOT EXISTS idx_packages_release_id ON mjk_app_release_packages(release_id);
 CREATE INDEX IF NOT EXISTS idx_downloads_release_id ON update_downloads(release_id);
 CREATE INDEX IF NOT EXISTS idx_downloads_download_at ON update_downloads(download_at);
 
@@ -240,7 +240,7 @@ class AppRelease(Base):
 
 class ReleasePackage(Base):
     """平台包信息"""
-    __tablename__ = "release_packages"
+    __tablename__ = "mjk_app_release_packages"
     
     id: Mapped[int] = mapped_column(Integer, primary_key=True)
     release_id: Mapped[int] = mapped_column(

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/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/release-guide.md

@@ -170,4 +170,4 @@ Tauri updater 插件已内置跨平台安装逻辑，前端代码无需区分平
 | `tauri-app/src-tauri/tauri.conf.json` | updater 配置：公钥 + endpoint URL |
 | `python-api/scripts/publish_release.py` | 发版脚本（扫描 .sig → 上传七牛云 → 写数据库） |
 | `python-api/app/api/v1/update.py` | 后端更新检查 API |
-| `python-api/app/models/update.py` | 数据库模型（`app_releases` / `release_packages`） |
+| `python-api/app/models/update.py` | 数据库模型（`mjk_app_releases` / `mjk_app_release_packages`） |

docs/user-data-isolation-plan.md

@@ -0,0 +1,183 @@
+# 用户数据隔离改造方案
+
+## 背景
+
+当前所有本地数据存储在全局路径下，切换账号后 A 用户的数据对 B 用户可见。涉及隐私（音色素材）和商业数据（项目文件），需要按 `user_id` 隔离。
+
+## 目标
+
+- 按登录用户的 `user_id` 隔离本地数据
+- 未登录时使用匿名沙盒或禁止写入
+- 兼容旧数据，首次启动自动迁移
+
+## 改动范围
+
+### 1. Rust 层 — 路径改造（`src/storage/paths.rs`）
+
+新增用户隔离根目录，用户相关数据全部迁移：
+
+```
+{app_local_data_dir}/
+  users/
+    {user_id}/
+      voices.json           ← 音色素材库
+      cover_avatars.json    ← 封面头像库
+      projects/             ← 项目目录
+      config.json           ← 用户级配置（可选）
+  bgm_cache/                ← 全局共享（缓存无隐私问题）
+  config.json               ← 全局配置（窗口状态、偏好设置等）
+  temp/                     ← 临时文件（定时清理）
+```
+
+**需要修改的函数：**
+
+| 当前路径 | 改造后 |
+|---|---|
+| `{data}/voices.json` | `{data}/users/{user_id}/voices.json` |
+| `{data}/cover_avatars.json` | `{data}/users/{user_id}/cover_avatars.json` |
+| `{data}/cover_avatars/` | `{data}/users/{user_id}/cover_avatars/` |
+| `{data}/projects/` | `{data}/users/{user_id}/projects/` |
+| `{data}/config.json` | 保持全局（或拆分为全局+用户级） |
+| `{data}/bgm_cache/` | 保持全局 |
+| `{config}/auth.json` | 保持全局（只存当前登录态） |
+
+**新增：**
+- `get_current_user_id() -> Option<String>`：从全局状态或调用方获取当前 user_id
+- `get_user_data_dir(user_id: &str)`：返回用户隔离目录
+
+### 2. Rust 层 — 存储命令改造
+
+**受影响的命令文件：**
+- `src/commands/voice.rs` — load/save/delete voice materials
+- `src/commands/project.rs` — 项目 CRUD
+- `src/commands/avatar.rs` — 封面头像
+- `src/commands/config.rs` — 配置（决定全局 or 用户级）
+
+**改造方式：**
+
+方式 A（推荐）：命令函数签名增加 `user_id: String` 参数
+```rust
+#[tauri::command]
+pub async fn load_voice_materials(user_id: String) -> ApiResponse<Vec<VoiceMaterial>> {
+    let path = get_user_voices_json_path(&user_id)?;
+    // ...
+}
+```
+
+方式 B：命令内部从 AppHandle 全局状态读取当前 user_id
+```rust
+let user_id = app.state::<CurrentUser>().id.clone();
+```
+
+**推荐方式 A**，前端调用时传入 `user.id`，减少 Rust 层对全局状态的依赖，更明确。
+
+### 3. 前端 — AuthStore 改造（`src/store/authStore.ts`）
+
+**新增：**
+- 登录成功后，写入一个全局标记 `CURRENT_USER_ID = user.id`
+- 登出/被踢时，清除该标记
+- 所有调用 Rust 存储命令的地方，带上 `userId` 参数
+
+**受影响的 Store：**
+- `voiceStore.ts` — `loadVoiceMaterials()`、`addVoiceMaterial()` 等需要传 `userId`
+- `projectStore.ts` — 项目操作需要传 `userId`
+- `avatarStore.ts` — 封面头像操作需要传 `userId`
+
+### 4. 前端 — API 调用改造
+
+所有 `invoke('xxx', { ... })` 调用用户相关命令时，增加 `userId`：
+
+```typescript
+// 改造前
+await invoke('load_voice_materials')
+
+// 改造后
+const userId = useAuthStore.getState().user?.id;
+await invoke('load_voice_materials', { userId })
+```
+
+### 5. 数据迁移策略
+
+**检测时机：** 应用启动时，`init_app_data_dir` 之后
+
+**迁移逻辑（Rust）：**
+```rust
+pub fn migrate_legacy_data(data_dir: &Path) -> Result<(), StorageError> {
+    // 1. 检查是否存在旧数据（全局 voices.json / projects / cover_avatars.json）
+    let legacy_voices = data_dir.join("voices.json");
+    if !legacy_voices.exists() {
+        return Ok(()); // 无旧数据，跳过
+    }
+
+    // 2. 读取 auth.json 获取当前登录的 user_id
+    let auth_path = get_auth_state_path(app)?;
+    let auth: Option<AuthState> = read_json(&auth_path)?;
+    let user_id = match auth.and_then(|a| a.user).map(|u| u.id) {
+        Some(id) => id,
+        None => {
+            // 未登录但有旧数据：移到 anonymous/ 目录，提示用户登录后迁移
+            return move_to_anonymous(data_dir);
+        }
+    };
+
+    // 3. 创建用户目录并迁移
+    let user_dir = data_dir.join("users").join(&user_id);
+    ensure_dir(&user_dir)?;
+
+    // 迁移 voices.json
+    if legacy_voices.exists() {
+        fs::rename(&legacy_voices, user_dir.join("voices.json"))?;
+    }
+
+    // 迁移 cover_avatars.json + cover_avatars/
+    let legacy_avatars = data_dir.join("cover_avatars.json");
+    if legacy_avatars.exists() {
+        fs::rename(&legacy_avatars, user_dir.join("cover_avatars.json"))?;
+    }
+    let legacy_avatars_dir = data_dir.join("cover_avatars");
+    if legacy_avatars_dir.exists() {
+        fs::rename(&legacy_avatars_dir, user_dir.join("cover_avatars"))?;
+    }
+
+    // 迁移 projects/
+    let legacy_projects = data_dir.join("projects");
+    if legacy_projects.exists() {
+        fs::rename(&legacy_projects, user_dir.join("projects"))?;
+    }
+
+    // 4. 写迁移标记，避免重复迁移
+    let flag = data_dir.join(".migration_v1_done");
+    fs::write(&flag, "done")?;
+
+    Ok(())
+}
+```
+
+**迁移顺序：**
+1. 启动应用
+2. 初始化 `app_local_data_dir`
+3. 检测 `.migration_v1_done` 标记，不存在则执行迁移
+4. 迁移完成后继续正常启动
+
+## 工作量评估
+
+| 模块 | 文件数 | 预估工作量 |
+|---|---|---|
+| paths.rs 改造 | 1 | 2h |
+| Rust 存储命令加 user_id 参数 | ~8 个文件 | 4h |
+| lib.rs 注册新签名 | 1 | 0.5h |
+| 前端 Store 改造 | ~4 个文件 | 3h |
+| 数据迁移逻辑 | 1 个新文件 | 3h |
+| 测试验证 | — | 2h |
+| **总计** | | **~14.5h** |
+
+## 风险点
+
+1. **多设备登录同一账号**：数据只在本地隔离，不同设备间数据不互通。如果需要跨设备同步，需要后端支持。
+2. **匿名数据**：未登录时产生的数据（理论上目前不存在，因为功能都需要登录），需要决定是禁止未登录操作还是存到 `anonymous/` 目录。
+3. **回滚**：迁移是单向的（移动文件），回滚需要手动恢复。建议迁移前做备份副本而非直接 move。
+
+## 建议实施时机
+
+- **v1.8.0** 或 **v1.9.0** 版本中实施
+- 最好在素材库数据量还不大的早期做，迁移成本低

docs/user-data-isolation-review.md

@@ -0,0 +1,259 @@
+# 用户数据隔离方案评审报告
+
+## 结论
+
+**方案大方向正确，但存在 3 个关键设计缺陷必须修正**，修正后可用。
+
+---
+
+## 关键缺陷
+
+### ❌ 缺陷 1：前端传 userId 到 Rust 命令 — 安全漏洞
+
+**方案原文：**
+> 方式 A（推荐）：命令函数签名增加 `user_id: String` 参数
+> 前端调用时传入 `user.id`
+
+**问题：** Tauri `#[tauri::command]` 的参数由前端传入，前端可以伪造任意 `userId`。
+
+```typescript
+// 恶意前端代码：A 用户传入 B 的 userId，即可读取 B 的本地数据
+await invoke('load_voice_materials', { userId: 'B的userId' })
+```
+
+**这完全破坏了隔离的安全性。**
+
+**修正方案（推荐方式 B）：**
+
+Rust 命令从已认证的 `auth.json` 中读取当前 `user.id`，不接收前端传来的 `userId`：
+
+```rust
+use tauri::State;
+
+// 全局状态存储当前用户
+pub struct CurrentUser {
+    pub id: std::sync::Mutex<Option<String>>,
+}
+
+#[tauri::command]
+pub async fn load_voice_materials(
+    app: tauri::AppHandle,
+) -> ApiResponse<Vec<VoiceMaterial>> {
+    // 从 auth.json 读取已认证的 user.id
+    let auth: Option<AuthState> = crate::storage::auth::load_auth_state(&app)?;
+    let user_id = match auth.and_then(|a| a.user).map(|u| u.id) {
+        Some(id) => id,
+        None => return ApiResponse::err(401, "未登录"),
+    };
+    
+    let path = get_user_voices_json_path(&user_id)?;
+    // ...
+}
+```
+
+或更简洁：在 `lib.rs` 的 `setup` 中读取 `auth.json`，将 `user_id` 存入 `ManagedState`，所有命令通过 `app.state::<CurrentUser>()` 获取。
+
+**前端完全不需要传 `userId`，Rust 层自治。**
+
+---
+
+### ❌ 缺陷 2：迁移用 `fs::rename`（move）— 不可逆且易崩溃
+
+**方案原文：**
+```rust
+fs::rename(&legacy_voices, user_dir.join("voices.json"))?;
+```
+
+**问题：**
+- `rename` 是原子操作，但**多个文件的迁移不是原子的**
+- 如果迁移 `voices.json` 后、迁移 `projects/` 前进程崩溃，会留下半迁移状态
+- 不可逆，回滚困难
+
+**修正方案：**
+
+```rust
+pub fn migrate_legacy_data(data_dir: &Path, app: &AppHandle) -> Result<(), StorageError> {
+    // 1. 检查迁移标记
+    let flag = data_dir.join(".migration_v1_done");
+    if flag.exists() { return Ok(()); }
+
+    // 2. 检查是否有旧数据
+    let legacy_items = vec![
+        ("voices.json", false),
+        ("cover_avatars.json", false),
+        ("cover_avatars/", true),
+        ("projects/", true),
+    ];
+    let has_legacy = legacy_items.iter().any(|(name, _)| data_dir.join(name).exists());
+    if !has_legacy {
+        // 无旧数据，直接写标记跳过
+        fs::write(&flag, "none")?;
+        return Ok(());
+    }
+
+    // 3. 获取当前登录用户
+    let auth: Option<AuthState> = crate::storage::auth::load_auth_state(app)?;
+    let user_id = match auth.and_then(|a| a.user).map(|u| u.id) {
+        Some(id) => id,
+        None => {
+            // 未登录但有旧数据：复制到 anonymous/，登录后再手动迁移
+            let anon_dir = data_dir.join("anonymous");
+            ensure_dir(&anon_dir)?;
+            for (name, is_dir) in &legacy_items {
+                let src = data_dir.join(name);
+                if src.exists() {
+                    let dest = anon_dir.join(name);
+                    if *is_dir {
+                        copy_dir_all(&src, &dest)?;
+                    } else {
+                        fs::copy(&src, &dest)?;
+                    }
+                }
+            }
+            fs::write(&flag, "anonymous")?;
+            return Ok(());
+        }
+    };
+
+    // 4. 创建用户目录，用 copy 而非 move
+    let user_dir = data_dir.join("users").join(&user_id);
+    ensure_dir(&user_dir)?;
+
+    for (name, is_dir) in &legacy_items {
+        let src = data_dir.join(name);
+        let dest = user_dir.join(name);
+        if src.exists() {
+            if *is_dir {
+                copy_dir_all(&src, &dest)?;
+            } else {
+                fs::copy(&src, &dest)?;
+            }
+        }
+    }
+
+    // 5. copy 成功后，再写标记，然后延迟清理旧数据
+    fs::write(&flag, user_id)?;
+    
+    // 可选：启动后台线程，延迟 7 天后删除旧数据
+    // 给用户一个回滚窗口
+
+    Ok(())
+}
+```
+
+---
+
+### ⚠️ 缺陷 3：缺少切换用户时的热切换设计
+
+**当前问题：**
+- 切换账号后，前端 Zustand store 中仍残留上一个用户的数据
+- 需要页面刷新或重启应用才能加载新用户的数据
+
+**修正方案：**
+
+在 `authStore.logout()` 和 `authStore.login()` 中增加**数据刷新契约**：
+
+```typescript
+// authStore.ts
+logout: async () => {
+  // ... 原有逻辑 ...
+  
+  // 新增：清空所有用户相关的内存状态
+  useVoiceStore.getState().reset();
+  useProjectStore.getState().reset();
+  useAvatarStore.getState().reset();
+  
+  // 通知 Rust 层清空缓存
+  await invoke('switch_user', { userId: null });
+},
+
+login: async (phone, code) => {
+  // ... 原有登录逻辑 ...
+  
+  // 新增：通知 Rust 层切换数据目录
+  await invoke('switch_user', { userId: data.user.id });
+  
+  // 重新加载当前用户的数据
+  await useVoiceStore.getState().loadMaterials();
+  await useProjectStore.getState().loadProjects();
+},
+```
+
+Rust 层 `switch_user` 命令：
+```rust
+#[tauri::command]
+pub async fn switch_user(
+    app: tauri::AppHandle,
+    user_id: Option<String>,
+) -> Result<(), String> {
+    // 更新 ManagedState 中的当前 user_id
+    let state = app.state::<CurrentUser>();
+    let mut guard = state.id.lock().map_err(|e| e.to_string())?;
+    *guard = user_id;
+    Ok(())
+}
+```
+
+---
+
+## 次要问题
+
+### ⚠️ `sanitize_id` 对 user_id 的兼容性
+
+当前 `sanitize_id` 只允许 `a-zA-Z0-9_-`。测试确认：
+- UUID 格式（`550e8400-e29b-41d4-a716-446655440000`）：✅ 通过
+- 邮箱格式（`user@example.com`）：❌ 失败
+- 含点号（`user.name`）：❌ 失败
+
+**建议：** 确认后端 `user.id` 的格式。如果是 UUID，无需改动；如果是邮箱或其他格式，需要对 `user_id` 单独做路径净化（如用 `sanitize_filename` 或直接 base64/urlencode）。
+
+### ⚠️ `temp/` 目录也应隔离
+
+当前 `extract_audio_from_video` 写到 `app_local_data_dir/temp/`，如果多用户并发操作会冲突。建议：
+```
+{app_local_data_dir}/temp/{user_id}/
+```
+
+### ⚠️ 全局 `config.json` 的拆分
+
+当前 `config.json` 存的是 API 地址和环境配置（`production`/`debug`），属于设备级配置，保持全局合理。
+
+但如果以后增加用户偏好（主题、音量、快捷键），需要拆分为：
+- `config.json` — 设备级（全局）
+- `users/{user_id}/preferences.json` — 用户级
+
+---
+
+## 与主流规范对比
+
+| 应用 | 隔离方式 | 说明 |
+|---|---|---|
+| **微信/QQ 桌面端** | ✅ 按账号隔离目录 | 每个账号独立数据目录，切换账号需重启 |
+| **Discord/Slack** | ❌ 不隔离 | 完全云端，本地只有缓存 |
+| **VS Code** | ⚠️ 按 workspace | 不严格按用户，但 settings.json 可放用户目录 |
+| **Figma** | ❌ 不隔离 | 完全云端 |
+| **Adobe Creative Cloud** | ✅ 按账号隔离 | 登录后数据按 Creative Cloud 账号隔离 |
+
+**本项目定位：** 本地创作工具，数据以本地为主，且支持多设备登录（手机号+验证码）。
+
+**结论：** 按 `user_id` 隔离是**合理且必要的**，尤其在涉及**声音复刻素材**这种高敏感隐私数据时。
+
+---
+
+## 修正后的工作量
+
+| 模块 | 修正后工作量 | 说明 |
+|---|---|---|
+| `paths.rs` 改造 | 2h | 加 `users/{user_id}/` 前缀 |
+| `ManagedState` + `switch_user` | 2h | 新增当前用户状态管理 |
+| Rust 命令读 auth.json 获取 user_id | 4h | 替代前端传参方案 |
+| 前端 Store 增加 `reset()` + 登录后重载 | 2h | 热切换体验 |
+| 数据迁移（copy + 标记） | 3h | 安全迁移 |
+| 测试验证 | 2h | |
+| **总计** | **~15h** | 比原方案多 0.5h（主要在 State 管理） |
+
+---
+
+## 建议实施时机
+
+**v1.8.0** 实施，趁数据量小、迁移成本低时做。

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

python-api/.env.example

@@ -4,7 +4,7 @@
 
 # === 基础配置 ===
 APP_NAME=美家卡智影 API
-APP_VERSION=1.5.18
+APP_VERSION=1.8.0
 # ⚠️ 生产环境必须设为 false
 DEBUG=true
 ENV=development
@@ -47,6 +47,9 @@ VOLCENGINE_API_KEY=your-volcengine-api-key
 VOLCENGINE_CAPTION_APPID=your-caption-appid
 VOLCENGINE_CAPTION_TOKEN=your-caption-token
 
+# 火山 MediaKit
+VOLCENGINE_MEDIAKIT_TOKEN=your-mediakit-token
+
 # Vidu（TTS、声音复刻、对口型）
 VIDU_API_KEY=your-vidu-api-key
 
@@ -71,7 +74,9 @@ SMS_APP_ID=your-sms-app-id
 SMS_SECRET_KEY=your-16-24-32-byte-aes-key
 SMS_BASE_URL=https://bjksmtn.b2m.cn/inter/sendSingleSMS
 # SMS_EXTENDED_CODE=    # 扩展码（选填）
+# 免验证码登录白名单（逗号分隔），名单内的手机号登录时跳过验证码校验
+# SMS_CODE_WHITELIST=13800138000,13900139000
 
 # === 日志配置 ===
 # 生产环境建议 INFO
-LOG_LEVEL=DEBUG
+LOG_LEVEL=ERROR

python-api/.qiniu_pythonsdk_hostscache.json

@@ -1 +1 @@
-{"http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:media-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1778077071}, "http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:img-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1776433218}}
+{"http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:media-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1780541956}, "http:Pn60lJXcaOGKvMjn5qv-OMr7wR1lp1p8QG7Ul6NK:img-liche": {"upHosts": ["http://upload-z2.qiniup.com", "http://up-z2.qiniup.com"], "ioHosts": ["http://iovip-z2.qbox.me"], "rsHosts": ["http://rs-z2.qbox.me"], "rsfHosts": ["http://rsf-z2.qbox.me"], "apiHosts": ["http://api-z2.qiniu.com"], "deadline": 1776433218}}

python-api/Dockerfile

@@ -46,4 +46,4 @@ COPY pyproject.toml .
 
 EXPOSE 8000
 
-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--no-access-log"]

python-api/alembic/env.py

@@ -20,17 +20,18 @@ load_dotenv()
 
 # 导入模型
 from app.db.session import Base
+from app.models.bgm_music import BgmMusic  # noqa
 from app.models.broll_category import BrollCategory  # noqa
 from app.models.broll_material import BrollMaterial  # noqa
 from app.models.broll_tag import BrollTag  # noqa
+from app.models.cover_background import CoverBackground  # noqa
 from app.models.point_batch import PointBatch  # noqa
 from app.models.point_recharge_order import PointRechargeOrder  # noqa
 from app.models.point_transaction import PointTransaction  # noqa
+from app.models.update import AppRelease, ReleasePackage  # noqa
 from app.models.user import User  # noqa
 from app.models.user_device import UserDevice  # noqa
 from app.models.user_point import UserPoint  # noqa
-from app.models.cover_background import CoverBackground  # noqa
-from app.models.update import AppRelease, ReleasePackage  # noqa
 
 # this is the Alembic Config object
 config = context.config

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/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/constants.py

@@ -20,3 +20,4 @@ class Method:
     CAPTION = "caption"
     AUTO_ALIGN = "auto_align"
     VIDEO_GENERATE = "video_generate"
+    REMOVE_BACKGROUND = "remove_background"

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

@@ -218,24 +218,35 @@ class ViduAdapter(PlatformAdapter, SyncCapable, TaskCapable, CallbackCapable):
         callback_url: str | None = None,
     ) -> bool:
         """验证 Vidu 回调 HMAC-SHA256 签名"""
-        signature = headers.get("X-HMAC-SIGNATURE")
-        algorithm = headers.get("X-HMAC-ALGORITHM")
-        access_key = headers.get("X-HMAC-ACCESS-KEY")
-        signed_headers_str = headers.get("X-HMAC-SIGNED-HEADERS")
-        date = headers.get("Date")
+        import logging
+        logger = logging.getLogger(__name__)
+
+        # HTTP 头大小写不敏感：建立小写 key 的查找表
+        headers_lower = {k.lower(): v for k, v in headers.items()}
+
+        signature = headers_lower.get("x-hmac-signature")
+        algorithm = headers_lower.get("x-hmac-algorithm")
+        access_key = headers_lower.get("x-hmac-access-key")
+        signed_headers_str = headers_lower.get("x-hmac-signed-headers")
+        date = headers_lower.get("date")
 
         if not all([signature, algorithm, access_key, signed_headers_str, date]):
+            logger.warning(f"[Vidu] 签名验证失败: 缺少必要头, headers={list(headers.keys())}")
             return False
         if algorithm != "hmac-sha256":
+            logger.warning(f"[Vidu] 签名验证失败: 不支持的算法 {algorithm}")
             return False
         if access_key != "vidu":
+            logger.warning(f"[Vidu] 签名验证失败: access_key 不匹配 {access_key}")
             return False
 
         header_names = [h.strip() for h in signed_headers_str.split(";") if h.strip()]
         header_values: dict[str, str] = {}
         for name in header_names:
-            value = headers.get(name)
+            # 签名头名也可能大小写不一致，统一用小写查找
+            value = headers_lower.get(name.lower())
             if value is None:
+                logger.warning(f"[Vidu] 签名验证失败: 缺少签名头 {name}")
                 return False
             header_values[name] = value
 
@@ -258,7 +269,15 @@ class ViduAdapter(PlatformAdapter, SyncCapable, TaskCapable, CallbackCapable):
             hmac.new(secret.encode("utf-8"), signing_string.encode("utf-8"), hashlib.sha256).digest()
         ).decode("utf-8")
 
-        return hmac.compare_digest(signature, expected)
+        if not hmac.compare_digest(signature, expected):
+            logger.warning(
+                f"[Vidu] 签名验证失败: callback_url={callback_url}, "
+                f"signing_string={repr(signing_string)}, "
+                f"expected={expected[:20]}..., received={signature[:20]}..."
+            )
+            return False
+
+        return True
 
     async def verify_nonce(
         self,

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/prompts/__init__.py

@@ -11,8 +11,11 @@ Prompt 模板系统
     # 获取分类列表
     categories = list_categories()
 
-    # 加载 System Prompt（大类+小类，随机取一个）
-    system = load_system_prompt("bk", "ht")
+    # 扫描某分类下的所有提示词文件
+    files = list_prompt_files("bk")
+
+    # 加载指定文件的 System Prompt
+    system = load_prompt_file("bk", "水电改造避坑——水电改造的4个坑.txt")
 
     # 加载并渲染 User Prompt
     user = load_script_user_prompt(
@@ -24,7 +27,9 @@ from .loader import (
     PolishPromptBuilder,
     ScriptPromptBuilder,
     list_categories,
+    list_prompt_files,
     load_prompt,
+    load_prompt_file,
     load_script_user_prompt,
     load_system_prompt,
     render_template,
@@ -36,6 +41,8 @@ __all__ = [
     "load_system_prompt",
     "load_script_user_prompt",
     "list_categories",
+    "list_prompt_files",
+    "load_prompt_file",
     "ScriptPromptBuilder",
     "PolishPromptBuilder",
 ]

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

@@ -77,18 +77,13 @@ def list_categories() -> list[dict]:
     """
     返回所有分类结构
 
-    以 system/_meta.json 为准，只返回配置中定义的分类。
-    count 动态扫描对应目录统计。
+    以 system/_meta.json 为准，只返回配置中定义的大类。
 
     Returns:
         [
           {
             "code": "bk",
-            "name": "装修避坑",
-            "subcategories": [
-              {"code": "ht", "name": "装修合同避坑", "count": 2},
-              ...
-            ]
+            "name": "装修避坑"
           },
           ...
         ]
@@ -99,64 +94,84 @@ def list_categories() -> list[dict]:
     for cat_meta in meta.get("categories", []):
         cat_code = cat_meta["code"]
         cat_name = cat_meta.get("name", cat_code)
-        cat_dir = SYSTEM_PROMPTS_DIR / cat_code
-
-        subcategories = []
-        for sub_meta in cat_meta.get("subcategories", []):
-            sub_code = sub_meta["code"]
-            sub_name = sub_meta.get("name", sub_code)
-            sub_dir = cat_dir / sub_code
-
-            # 统计提示词文件数量
-            count = 0
-            if sub_dir.exists():
-                count = len([
-                    f for f in sub_dir.iterdir()
-                    if f.is_file() and f.suffix == ".txt"
-                ])
-
-            subcategories.append({
-                "code": sub_code,
-                "name": sub_name,
-                "count": count,
-            })
-
         categories.append({
             "code": cat_code,
             "name": cat_name,
-            "subcategories": subcategories,
         })
 
     return categories
 
 
-def load_system_prompt(category: str, subcategory: str) -> str:
+def list_prompt_files(category: str) -> list[dict]:
     """
-    根据大类+小类随机加载一个 System Prompt
+    扫描指定分类目录下的所有提示词文件
+
+    文件名格式: 文案——描述.txt
+    解析为 label + desc 返回给前端展示。
 
     Args:
         category: 大类代码，如 "bk"
-        subcategory: 小类代码，如 "ht"
 
     Returns:
-        随机选中的提示词内容，未找到返回空字符串
+        [
+          {
+            "filename": "水电改造避坑——水电改造的4个坑.txt",
+            "label": "水电改造避坑",
+            "desc": "水电改造的4个坑"
+          },
+          ...
+        ]
     """
-    sub_dir = SYSTEM_PROMPTS_DIR / category / subcategory
-    if not sub_dir.exists():
+    cat_dir = SYSTEM_PROMPTS_DIR / category
+    if not cat_dir.exists():
+        return []
+
+    files = []
+    for f in sorted(cat_dir.iterdir()):
+        if f.is_file() and f.suffix == ".txt":
+            name = f.stem  # 不含 .txt
+            if "——" in name:
+                label, desc = name.split("——", 1)
+            else:
+                label = name
+                desc = ""
+            files.append({
+                "filename": f.name,
+                "label": label.strip(),
+                "desc": desc.strip(),
+            })
+
+    return files
+
+
+def load_prompt_file(category: str, filename: str) -> str:
+    """
+    加载指定分类下的指定提示词文件
+
+    Args:
+        category: 大类代码，如 "bk"
+        filename: 文件名，如 "水电改造避坑——水电改造的4个坑.txt"
+
+    Returns:
+        提示词内容，文件不存在返回空字符串
+    """
+    file_path = SYSTEM_PROMPTS_DIR / category / filename
+    if file_path.exists():
+        return file_path.read_text(encoding="utf-8")
+    return ""
+
+
+def load_system_prompt(category: str, subcategory: str) -> str:
+    """
+    【已废弃】根据大类+小类随机加载一个 System Prompt
+
+    保留兼容旧调用，实际行为改为从平铺文件中随机加载。
+    """
+    files = list_prompt_files(category)
+    if not files:
         return ""
-
-    # 收集所有提示词文件
-    prompt_files = [
-        f for f in sub_dir.iterdir()
-        if f.is_file() and f.suffix == ".txt"
-    ]
-
-    if not prompt_files:
-        return ""
-
-    # 随机取一个提示词模板（非安全场景）
-    chosen = random.choice(prompt_files)  # nosec: B311
-    return chosen.read_text(encoding="utf-8")
+    chosen = random.choice(files)  # nosec: B311
+    return load_prompt_file(category, chosen["filename"])
 
 
 

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

@@ -2,20 +2,7 @@
   "categories": [
     {
       "code": "bk",
-      "name": "装修避坑",
-      "subcategories": [
-        { "code": "ht", "name": "装修合同" },
-        { "code": "lc", "name": "装修流程" },
-        { "code": "bj", "name": "装修报价" },
-        { "code": "qw", "name": "全屋定制" },
-        { "code": "sd", "name": "水电改造" },
-        { "code": "wt", "name": "常见问题" },
-        { "code": "wg", "name": "瓦工铺贴" },
-        { "code": "yg", "name": "油工进场" },
-        { "code": "cl", "name": "装修材料" },
-        { "code": "jg", "name": "装修监工" },
-        { "code": "sq", "name": "装修省钱" }
-      ]
+      "name": "装修避坑"
     }
   ]
 }

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

@@ -1,257 +0,0 @@
-你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
-【核心定位与脚本类型】
-（一）核心定位
-精准锁定：准备装修、不懂各品类主材怎么选品牌、怕选错质量差被坑的装修业主，围绕装修 12 大类主材靠谱品牌推荐创作，每次生成随机打乱 12 条品类顺序重新编排，保留原意不变。
-（二）脚本类型
-装修口播短视频脚本，无多余开篇引入，直接进入正文主材品牌推荐，正文干货 + 结尾资料领取引导，无多余内容、无重复冗余。
-【平台适配】
-竖屏 9:16 拍摄
-【核心强制规则】
-无开头范式，去掉所有铺垫引入话术，直接切入各主材品牌推荐正文。
-中间核心（12 大类主材品牌文案可微调口语化，保持原意不变，每次自动随机打乱重新编排顺序）：
-电线优选：熊猫、远东、德力西三大靠谱品牌。
-防水选材认准：德高、雨虹、科顺主流大品牌。
-家装水管优先选：金牛、伟星、日丰口碑款。
-开关面板推荐：公牛、施耐德、西门子放心选。
-腻子粉首选：立邦、美巢、德高环保大品牌。
-家装水泥认准：海螺、红石、中联品质有保障。
-厨卫五金优选：汉斯格雅、科勒、九牧一线品牌。
-木地板推荐：圣象、大自然、生活家主流大牌。
-石膏板选材：龙牌、泰山、可耐福家装常用款。
-瓷砖胶认准：德高、大禹、神工粘结更牢固。
-乳胶漆优选：立邦、多乐士、三棵树环保净味。
-玻璃胶选用：瓦克、西卡、百得防霉耐用款。
-（备注：完整保留每类主材对应的三个品牌，仅微调句式适配口播；每次生成自动随机打乱 12 个品类排序，不改变品牌名单和推荐原意）
-中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
-排序逻辑：内置 12 大类装修主材固定推荐品牌，每次生成脚本自动随机打乱重新排序，不固定原有顺序，避免内容同质化，适合日常短视频日更。
-文案调整要求：仅做口语化精简优化，把直白问句改成顺口口播表述，不替换、不删减任何品牌，保持每类主材三个推荐品牌完整不变，原意丝毫不改。
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 170-190 字，按每秒 4 个字计算，对应时长 42.5-47.5s，内容精炼、节奏紧凑，适配短平快知识口播。
-内容适配性：打乱顺序后语句依然衔接自然，每条独立清晰，直接给到可照搬的主材品牌清单，解决业主选材纠结、怕踩坑的核心痛点，实用性拉满。
-结尾范式：完整保留原文结尾引导原话，仅可轻微优化口语流畅度，不改动评论区扣关键词、领取材料推荐清单的核心引流逻辑。
-【开篇 & 语言要求】
-无开篇铺垫，直接切入主材品牌推荐干货；全程短句口语化、接地气，直白罗列品牌，简单好记、业主可直接收藏对照选材。
-可微调句式语序，严禁替换、删减任意主材品牌，不改变推荐逻辑和原意，语句简短利落，适配短时长口播节奏。
-【内置固定原文案】
-电线买谁家？熊猫、远东、德力西。
-防水买谁家？德高、雨虹、科顺。
-水管买谁家？金牛、伟星、日丰。
-开关买谁家？公牛、施耐德、西门子。
-腻子粉买谁家？立邦、美巢、德高。
-水泥买谁家？海螺、红石、中联。
-五金买谁家？汉斯格雅、科勒、九牧。
-木地板买谁家？圣象、大自然、生活家。
-石膏板买谁家？龙牌、泰山、可耐福。
-瓷砖胶买谁家？德高、大禹、神工。
-乳胶漆买谁家？立邦、多乐士、三棵树。
-玻璃胶买谁家？瓦克、西卡、百得。
-记不住的，我这里有材料推荐清单，评论区扣材料，直接拿走。
-【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
-卧室原始状态-翻新基础
-厨卫原始状态-翻新基础
-客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
-全屋地板铺设施工-主材安装
-全屋开关面板安装-主材安装
-卫浴洁具进场安装-主材安装
-厨卫集成吊顶安装-主材安装
-室内房门安装固定-主材安装
-橱柜柜体现场组装-主材安装
-灯具筒灯射灯安装-主材安装
-衣柜移门五金安装-主材安装
-全屋五金调试-收尾细节
-成品瑕疵修补-收尾细节
-柜体门缝调整-收尾细节
-门窗缝隙密封处理-收尾细节
-全屋基础开荒保洁-美缝开荒
-地面残留胶迹清理-美缝开荒
-撕美缝胶-美缝开荒
-玻璃胶收边打胶细节-美缝开荒
-瓷砖缝隙清理清灰-美缝开荒
-美缝扩缝-美缝开荒
-美缝施工-美缝开荒
-美缝检查-美缝开荒
-门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
-全屋定制柜体打底-柜体木作
-木作封边贴皮-柜体木作
-环保板材现场堆放-柜体木作
-阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
-吸睛画面-恶搞开篇
-工地恶搞-恶搞开篇
-搞笑涂料施工-恶搞开篇
-暴力拆除-恶搞开篇
-炫技-恶搞开篇
-贴砖恶搞-恶搞开篇
-墙体掉落-施工翻车镜
-墙面开裂-施工翻车镜
-墙面空鼓-施工翻车镜
-水管错位-施工翻车镜
-电线乱接-施工翻车镜
-防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
-柜体开合顺畅度检查-全屋验收
-踢脚线安装验收-软装进场
-验收合格签字确认-全屋验收
-窗帘轨道窗帘安装-软装进场
-【分镜固定结构规则】
-开篇的分镜为： 一段人物出镜 
-其他都是空镜补充
-“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
-每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 170-190 字，按每秒 4 个字计算，对应时长 42.5-47.5s，内容精炼、节奏紧凑，适配短平快知识口播。
-type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库选匹配标题。
-“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
-“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
-【输出格式要求】
-输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
-一、分镜内容
-id: 按顺序递增（1、2、3…）
-type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
-voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
-duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数）
-【示例】
-[
-{
-"id": 1,
-"type": "empty_shot",
-"scene": "新建墙体垂直找平 - 新建砌筑",
-"voiceover": "砌墙完工之后，一定要停工静置等待 5 天。",
-"duration": "4.25s"
-}
-]

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

@@ -1,264 +0,0 @@
-你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
-【核心定位与脚本类型】
-（一）核心定位
-精准锁定：新房装修选购家电、主材、辅材，不懂品牌怎么选、怕踩杂牌坑、想直接抄作业的装修业主，围绕 15 大类家装好物优质品牌推荐创作，每次生成随机打乱 15 个品类顺序重新编排，保留原意不变。
-（二）脚本类型
-装修口播短视频脚本，无多余开篇引入，直接进入正文品牌推荐，正文干货罗列 + 结尾资料领取引导，无多余内容、无重复冗余。
-【平台适配】
-竖屏 9:16 拍摄
-【核心强制规则】
-无开头范式，去掉所有铺垫引入话术，直接切入各类家电主材品牌推荐正文。
-中间核心（15 大类家装品牌文案可微调口语化，保持原意不变，每次自动随机打乱重新编排顺序）：
-家用冰箱优选：卡萨帝、海尔、美的三大主流大牌。
-电视选购认准：TCL、海信、索尼画质口碑款。
-淋浴花洒推荐：九牧、恒洁、箭牌卫浴一线品牌。
-家装电线首选：远东、宝胜、熊猫国标品质线缆。
-烟机灶具认准：方太、老板、华帝厨房专业品牌。
-环保乳胶漆选：立邦、三棵树、多乐士家装常用款。
-开关插座优选：施耐德、公牛、西门子安全耐用。
-全屋瓷砖推荐：东鹏、冠珠、马可波罗口碑大品牌。
-家装水管认准：日丰、伟星、保利防爆耐用管材。
-环保板材挑选：万华、兔宝宝、艾格高端环保基材。
-家装防水优选：东方雨虹、立邦、德高家装防水标杆。
-集成吊顶选：奥普、法狮龙、友邦厨卫专用品牌。
-木地板认准：大自然、圣象、世友实木复合主流款。
-腻子粉优选：立邦、美巢、圣戈班环保耐潮产品。
-厨卫地漏选：潜水艇、箭牌、九牧防臭排水好物。
-（备注：完整保留每类对应的三个推荐品牌，仅微调句式适配口播语感；每次生成自动随机打乱 15 个品类排序，不替换品牌、不改变推荐原意）
-中间核心详细分析（贴合口播逻辑，适配业主痛点，不篡改原文核心）
-排序逻辑：内置 15 大类装修家电、主材、辅材固定品牌清单，每次生成脚本自动随机打乱重新排序，不固定原有顺序，规避内容重复，适合短视频日常更新。
-文案调整要求：仅做口语化精简优化，把问句改成顺口口播表述，不删减、不替换任何一个品牌名称，完整保留每品类三大推荐品牌，原意丝毫不变。
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 220-240 字，按每秒 4 个字核算，对应时长 55-60s，内容精炼紧凑、节奏适中，适配短平快知识口播。
-内容适配性：打乱顺序后语句衔接自然，逐条清晰罗列，业主可直接对照抄作业选品牌，解决选材纠结、怕踩坑、不会分辨好坏的核心痛点，实用性极强。
-结尾范式：完整保留原文结尾引导原话，仅轻微优化口语流畅度，不改动新房装修人群定位、评论区扣关键词领取装修避坑手册的核心引流逻辑。
-【开篇 & 语言要求】
-无开篇铺垫，直接切入品牌推荐干货；全程短句大白话、接地气，直白罗列靠谱品牌，简单好记、装修可直接照搬参考。
-可微调句式语序，严禁改动、删减、替换任意品类及对应品牌，不改变推荐逻辑与原意，语句简短利落，适配中短时长口播节奏。
-【内置固定原文案】
-冰箱买谁家？卡萨帝、海尔、美的。
-电视买谁家？TCL、海信、索尼。
-花洒哪家好？九牧、恒洁、箭牌。
-电线买谁家？远东、宝胜、熊猫。
-烟机哪家好？方太、老板、华帝。
-乳胶漆买谁家？立邦、三棵树、多乐士。
-开关插座买谁家？施耐德、公牛、西门子。
-瓷砖哪家好？东鹏、冠珠、马可波罗。
-水管买谁家？日丰、伟星、保利。
-板材选谁家？万华、兔宝宝、艾格。
-防水买谁家？东方雨虹、立邦、德高。
-吊顶选谁家？奥普、法狮龙、友邦。
-地板哪家好？大自然、圣象、世友。
-腻子粉哪家好？立邦、美巢、圣戈邦。
-地漏谁家好？潜水艇、箭牌、九牧。
-准备新房装修的朋友，我整理一份装修避坑手册供你参考，评论区回避坑，直接拿。
-【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
-卧室原始状态-翻新基础
-厨卫原始状态-翻新基础
-客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
-全屋地板铺设施工-主材安装
-全屋开关面板安装-主材安装
-卫浴洁具进场安装-主材安装
-厨卫集成吊顶安装-主材安装
-室内房门安装固定-主材安装
-橱柜柜体现场组装-主材安装
-灯具筒灯射灯安装-主材安装
-衣柜移门五金安装-主材安装
-全屋五金调试-收尾细节
-成品瑕疵修补-收尾细节
-柜体门缝调整-收尾细节
-门窗缝隙密封处理-收尾细节
-全屋基础开荒保洁-美缝开荒
-地面残留胶迹清理-美缝开荒
-撕美缝胶-美缝开荒
-玻璃胶收边打胶细节-美缝开荒
-瓷砖缝隙清理清灰-美缝开荒
-美缝扩缝-美缝开荒
-美缝施工-美缝开荒
-美缝检查-美缝开荒
-门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
-全屋定制柜体打底-柜体木作
-木作封边贴皮-柜体木作
-环保板材现场堆放-柜体木作
-阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
-吸睛画面-恶搞开篇
-工地恶搞-恶搞开篇
-搞笑涂料施工-恶搞开篇
-暴力拆除-恶搞开篇
-炫技-恶搞开篇
-贴砖恶搞-恶搞开篇
-墙体掉落-施工翻车镜
-墙面开裂-施工翻车镜
-墙面空鼓-施工翻车镜
-水管错位-施工翻车镜
-电线乱接-施工翻车镜
-防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
-柜体开合顺畅度检查-全屋验收
-踢脚线安装验收-软装进场
-验收合格签字确认-全屋验收
-窗帘轨道窗帘安装-软装进场
-【分镜固定结构规则】
-开篇的分镜为： 一段人物出镜 
-其他都是空镜补充
-“分镜文案 "等于" 配音文案”，“配音文案” 必须要有标点符号断句，避免大长句，每段分镜的分镜文案字数严格控制在 12-32 个字，含数字，不含标点符号。文案一个分镜说不完，超出必须拆分句子多分镜。句子过长强制拆分成多个分镜，保证语句通顺、带完整标点。
-每个分镜的 "分镜时长" 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 "分镜文案" 的纯文字字数 / 4}，严格控制在 3-8 秒，可以是两位小数
-字数与时长控制：纯文字 + 数字扣除标点，严格控制在 220-240 字，按每秒 4 个字核算，对应时长 55-60s，内容精炼紧凑、节奏适中，适配短平快知识口播。
-type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库选匹配标题。
-“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
-“empty_shot”（空镜补充）对应上述素材库标题，文案内容需匹配，如无法匹配则选择近似的空镜
-【输出格式要求】
-输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
-一、分镜内容
-id: 按顺序递增（1、2、3…）
-type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
-voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
-duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数）
-【示例】
-[
-{
-"id": 1,
-"type": "empty_shot",
-"scene": "新建墙体垂直找平 - 新建砌筑",
-"voiceover": "砌墙完工之后，一定要停工静置等待 5 天。",
-"duration": "4.25s"
-}
-]
-

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

@@ -1,270 +0,0 @@
-你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
-【核心定位与脚本类型】
-（一）核心定位
-精准锁定：准备新房装修、不懂水电改造套路、容易被网红颜值工艺忽悠、只看表面好看多花冤枉钱，后期入住返工留遗憾的业主，严格从10 个水电改造大坑中随机抽取 4 个进行避坑要点创作。
-（二）脚本类型
-装修水电避坑口播短视频脚本，结构固定：范式化定制开头 + 随机 4 个水电避坑干货 + 保留原文结尾引导，无多余内容，无重复，无冗余。
-【平台适配】
-竖屏 9:16 拍摄
-【核心强制规则】
-开头范式
-以 **“新房装修做水电改造，谁要是只追求网红大弧弯、横平竖直的表面颜值，只顾好看不考虑实用，千万别盲目跟风照搬。看着工艺漂亮上档次，其实全是装修公司收割你的面子工程，多花钱还不实用。下面这 4 个水电改造大坑一定要提前避开，看懂少花几万冤枉钱！”** 为固定核心句式，沿用原文 “水电好看都是面子工程、宰客套路” 的核心原意，用警示性语气点出颜值陷阱、多花冤枉钱的痛点，引出下文 4 个坑点，不照搬原文完整长开头，只保留核心立意适配范式结构。
-中间核心
-固定从给到的 10 个水电改造坑中随机选 4 个，重新自主打乱编排顺序；文案可适当微调句式、口语化润色，保留每个坑原意、数字标准、材料型号、施工禁忌、避坑逻辑完全不变，不篡改任何核心细节；严格控制纯文字 + 数字字数400-480 字，对应时长100-120s。
-（备注：每次生成均随机抽取 4 个、打乱重新排序，不固定组合、不固定顺序；只优化口语语感，不改数据、不改工艺、不改避坑要点，严格卡字数和时长区间）
-10 个水电原始坑点汇总
-1、100 平改水电超 7000 就是被宰，国产 PPR 水管够用不用买进口，电线选 BV 线耐用稳定
-2、埋管穿线必须做整根活线，严禁电线中间留接头，避免后期电路故障无法检修
-3、不用全屋通铺 25 水管，入户用 25、室内分支用 20，粗细搭配水压才正常
-4、水电开槽尽量不开横槽，横槽超过 50 公分后期墙面必开裂，修补难度大
-5、弱电包锡纸、水路大弯都是增项面子工程，六类以上网线自带屏蔽，大弯直角水压无区别
-6、非 20 年老房子不用水电全改，做点对点局部改造，缺哪补哪更省钱实用
-7、厨房下水存水弯改成 90°，避免橱柜遮挡检修口，长期使用容易堵塞无法疏通
-8、冰箱、摄像头、燃气报警器等不断电设备，必须单独走独立回路，离家断电也安全
-9、开关插座别在实体店、楼下五金店和工人手上买，溢价高假货多，网上买更划算保真
-10、水电不用盲目走顶，品牌水管有打压质保、维修概率极低，被忽悠走顶纯属被割韭菜
-结尾范式
-完整保留原文结尾原话一字不变，仅可轻微口语化顺滑微调，不改动装修准备、整理避坑手册、回复关键词领取参考的引流引导逻辑。
-【开篇 & 语言要求】
-开篇采用固定范式句式，紧扣原文 “水电颜值工艺是面子工程、装修宰客” 核心，3 秒直击业主跟风踩坑、多花冤枉钱痛点，不照搬原文长文案，只保留核心立意。
-全程沿用原文接地气吐槽大白话，内行视角讲干货，直白易懂不生硬说教，贴合装修业主共情口吻。
-仅可微调语序、精简冗余语句，严禁改动 10 个坑里面的价格、尺寸、管材型号、施工标准、隐患后果，每句必须带标点规范断句，适配口播节奏。
-【内置固定原文案】
-改水电就是你装修被宰的第一刀，干得越漂亮，这一刀就扎得越深。什么好看的大弧弯，横平竖直，看起来是好看，但其实大多数都是面子工程，除了让你多花钱，实际用处一点都没有。水电改造真正重要的 10 个细节你要记住了，就不可能踩坑，全是干货。建议你点赞收藏慢慢看。
-首先，100 平的房子改水电，如果超过 7000 块，你就是被宰了。记住，水管只要是 PPR 管，无论是保利、伟星、日丰哪个国产牌子，都可以，让你买进口的都是看你好骗。电线你就选 BV 线，导电性能稳定，耐用几十年。
-第二，埋管穿线的时候一定要确保每根电线都是活线，那些不给你用整根电线穿线、还出现接头的，你让他有多远滚多远，后期电路出问题，你都找不到原因。
-第三，现在的装修公司都建议你水管用 25 的，说水压大，入住以后你发现水压没有明显的变化。真正的做法是，入户门到室内用 25 的，其他的水管用 20 的就行了。水管从粗到细，水压才能变大，你都换成 25 的根本没有必要。
-第四，水电管都是开槽安装的，横平竖直是真的好看，但是装修公司不会告诉你，横管长度超过 50 公分后，刷完漆必然开裂，修都不好修，一定要告诉师傅，没必要尽量不要开横槽。
-第五，弱电锡纸的包裹、水路大弯工艺等，这些都是容易增项的。现在超过六类的网线基本上都是自带屏蔽功能，包锡纸也是个样子工程，根本没必要。还有大弯水管和直角水管，真的没有水压大小的区别。
-第六，如果你不是 20 年前的老房子，水电没必要全改，去做点对点改造，哪里不够就加哪里，这样省钱还不影响使用。
-第七，厨房的下水存水弯必须改成 90°，不然贴完瓷砖、装好橱柜，原始检修口几乎和橱柜底板挨着，根本打不开。时间一长，垃圾冲也冲不动、扣也扣不着，很容易堵塞。
-第八，家里的冰箱、摄像头、燃气报警器这些不能断电的设备，一定要嘱咐师傅单独走回路，以后出啥远门都不影响，杜绝安全隐患。
-第九，开关插座完全没有必要去实体店买，尤其楼下那些小五金店，很多都是假货，成本可能只有五六块钱一个，却卖到三四十块钱一个，你说这有良心吗？网上购买不仅价格实惠，而且更容易买到正品。如果装修工人给你带的开关插座，我劝你不要用，因为这些成本可能只有两三块钱一个。
-第十，水电走地好，如果师傅跟你说水电走顶好维修、还不会抬高地面，那他就是逮着你割韭菜了。现在品牌的水管完工后都会上门打压测试，维修概率极低。而且，你要是有了质保，后期真出问题，赔的都够你再买一套房子。
-如果你也准备新房装修，我整理了一份装修避坑手册，回个手册发你参考。
-【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
-卧室原始状态-翻新基础
-厨卫原始状态-翻新基础
-客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
-全屋地板铺设施工-主材安装
-全屋开关面板安装-主材安装
-卫浴洁具进场安装-主材安装
-厨卫集成吊顶安装-主材安装
-室内房门安装固定-主材安装
-橱柜柜体现场组装-主材安装
-灯具筒灯射灯安装-主材安装
-衣柜移门五金安装-主材安装
-全屋五金调试-收尾细节
-成品瑕疵修补-收尾细节
-柜体门缝调整-收尾细节
-门窗缝隙密封处理-收尾细节
-全屋基础开荒保洁-美缝开荒
-地面残留胶迹清理-美缝开荒
-撕美缝胶-美缝开荒
-玻璃胶收边打胶细节-美缝开荒
-瓷砖缝隙清理清灰-美缝开荒
-美缝扩缝-美缝开荒
-美缝施工-美缝开荒
-美缝检查-美缝开荒
-门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
-全屋定制柜体打底-柜体木作
-木作封边贴皮-柜体木作
-环保板材现场堆放-柜体木作
-阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
-吸睛画面-恶搞开篇
-工地恶搞-恶搞开篇
-搞笑涂料施工-恶搞开篇
-暴力拆除-恶搞开篇
-炫技-恶搞开篇
-贴砖恶搞-恶搞开篇
-墙体掉落-施工翻车镜
-墙面开裂-施工翻车镜
-墙面空鼓-施工翻车镜
-水管错位-施工翻车镜
-电线乱接-施工翻车镜
-防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
-柜体开合顺畅度检查-全屋验收
-踢脚线安装验收-软装进场
-验收合格签字确认-全屋验收
-窗帘轨道窗帘安装-软装进场
-【分镜固定结构规则】
-开篇的分镜为：一段网红开篇（可选用恶搞开篇或施工翻车镜，贴近水电改造、施工翻车、装修套路主题，优先选工地恶搞、墙面空鼓、毛坯全景等相关）+ 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜。
-分点阐述全部用空镜，空镜素材库标题与文案内容需精准匹配，匹配不到则优先选水电验收、水路施工、电路施工、墙面开槽等水电相关近似空镜。
-结尾的分镜为：一段空镜补充 + 一段人物出镜 + 一段空镜补充，不得有 2 段人物出镜。
-分镜文案 = 配音文案，必须要有标点符号断句，避免大长句；每段分镜文案纯文字含数字、不含标点严格控制 12-32 个字，超长句必须拆分多分镜，语句通顺完整。
-全篇文案硬性约束：纯文字 + 数字扣除标点严控400-480 字、总时长锁定100-120s，不得偏离区间。
-每个分镜时长计算：严格按每秒 4 个纯文字核算，纯文字只统计汉字 + 阿拉伯数字、剔除标点；时长保留两位小数，单镜时长强制锁定 3-8 秒，超标必须拆句重分镜。
-type 定义：segment = 人物出镜；empty_shot = 从上方内置素材库选匹配标题。
-人物出镜画面允许语句语意顺延到下一分镜；空镜必须贴合当前配音文案水电避坑主题。
-每次创作自动从 10 个水电坑随机选 4 个、重新打乱排序，不固定组合、不固定顺序。
-禁止篡改原文 10 个水电坑的价格、尺寸、材料、施工工艺、避坑核心逻辑。
-【输出格式要求】
-输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
-一、分镜内容
-id: 按顺序递增（1、2、3…）
-type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
-voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合装修业主水电避坑痛点）
-duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数）
-【示例】
-[
-{
-"id": 1,
-"type": "empty_shot",
-"scene": "贴砖恶搞 - 恶搞开篇",
-"voiceover": "瓦工进场只盯海棠角，后期必踩大坑，7 个细节记牢",
-"duration": "5.25s"
-},
-{
-"id": 2,
-"type": "segment",
-"scene": "人物出镜",
-"voiceover": "瓦工一来先交代这 7 个细节，师傅绝对不敢糊弄你",
-"duration": "5.25s"
-},
-{
-"id": 3,
-"type": "empty_shot",
-"scene": "墙砖定位-瓷砖铺贴",
-"voiceover": "先说好瓷砖排版，别让瓦工做，商家免费排更精准",
-"duration": "5.00s"
-}
-]

python-api/app/ai/prompts/system/bk/买对不买贵——流量型可多用.txt

@@ -0,0 +1,86 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修避坑口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【普通人装修，就算再有钱，这6样东西，也不能买贵的
+】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：从下面给出的9组装修避坑对比中，**每次随机抽取6组**
+4. 格式要求：每组单独成行，格式严格为"X不要买贵的，Y要买贵的"，必须拆分两行
+5. 随机要求：6组的顺序必须完全随机打乱，每次生成的组合不能重复
+6. 禁止添加任何额外内容（包括标题、序号、解释、空行等）
+
+以下是全部9组避坑对比库：
+床不要买贵的，床垫要买贵的
+灯具不要买贵的，开关插座要买贵的
+木门不要买贵的，门锁要买贵的
+乳胶漆不要买贵的，腻子粉要买贵的
+电视机不要买贵的，投影仪要买贵的
+水槽不要买贵的，水龙头要买贵的
+瓷砖不要买贵的，木地板要买贵的
+前置过滤器不要买贵的，全屋角阀要买贵的
+窗帘不要买贵的，滑轨要买贵的
+【语言要求】
+全程口语化大白话，通俗易懂、接地气，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
+【内置完整素材库标题】
+床不要买贵的
+床垫要买贵的
+灯具不要买贵的
+开关插座要买贵的
+木门不要买贵的
+门锁要买贵的
+乳胶漆不要买贵的
+腻子粉要买贵的
+电视机不要买贵的
+投影仪要买贵的
+水槽不要买贵的
+水龙头要买贵的
+瓷砖不要买贵的
+木地板要买贵的
+前置过滤器不要买贵的
+全屋角阀要买贵的
+窗帘不要买贵的
+滑轨要买贵的
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “普通人装修，就算再有钱，这6样东西，也不能买贵的。”,
+“duration”: “5.25s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “床不要买贵的”,
+“voiceover”: “床不要买贵的”,
+“duration”: “1.50s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “床垫要买贵的”,
+“voiceover”: “床垫要买贵的”,
+“duration”: “1.50s”
+}
+]

python-api/app/ai/prompts/system/bk/停工关键节点——装修必须停工的7个时间点.txt

@@ -229,7 +229,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数）
 【示例】

python-api/app/ai/prompts/system/bk/全屋定制避坑——3个全屋定制避坑干货.txt

@@ -27,28 +27,13 @@
 要是还有不懂的、近期准备新房装修的朋友，我整理了一份装修避坑手册供你参考，评论区抠避坑，拿去用。
 【内置完整素材库标题】
 合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
 厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
 毛坯全屋广角全景-毛坯基础
 阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
 装修合同核对-现场交底
 卧室原始状态-翻新基础
 厨卫原始状态-翻新基础
 客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
 设计师入户-量房勘测
 全屋地板铺设施工-主材安装
 全屋开关面板安装-主材安装
@@ -71,126 +56,10 @@
 美缝施工-美缝开荒
 美缝检查-美缝开荒
 门窗玻璃清洁-美缝开荒
-切割机施工特写-墙体拆除
-地板拆除-墙体拆除
-墙体拆除-墙体拆除
-墙面表层铲除-墙体拆除
-局部墙体剔凿修补-墙体拆除
-建筑垃圾实时掉落-墙体拆除
-拆改后现场全貌-墙体拆除
-柜子拆除-墙体拆除
-门洞扩宽切割-墙体拆除
-非墙体拆除-墙体拆除
-飘窗拆除改造-墙体拆除
-工地杂物清扫整理-工地清运
-施工地面清扫除尘-工地清运
-袋装垃圾搬运出场-工地清运
-装修垃圾集中堆放-工地清运
-新墙红砖错缝砌筑-新建砌筑
-新建墙体垂直找平-新建砌筑
-新旧墙体拉结筋施工-新建砌筑
-水泥砂浆搅拌-新建砌筑
-砌墙完工整体展示-新建砌筑
-红砖现场码放-新建砌筑
-轻体砖隔断搭建-新建砌筑
-门头过梁安装固定-新建砌筑
-中央空调风口预留-吊顶造型
-双眼皮吊顶封板施工-吊顶造型
-吊顶完工展示-吊顶造型
-吊顶水平对齐-吊顶造型
-吊顶石膏板批腻子-吊顶造型
-吊顶转角整板防裂-吊顶造型
-吊顶造型裁切及安装-吊顶造型
-吊顶钉眼防锈漆点涂-吊顶造型
-木龙骨基础框架固定-吊顶造型
-石膏板固定-吊顶造型
-石膏板开孔-吊顶造型
-石膏板裁切-吊顶造型
-轻钢龙骨骨架搭建-吊顶造型
 全屋定制柜体打底-柜体木作
 木作封边贴皮-柜体木作
 环保板材现场堆放-柜体木作
 阳台储物柜基层制作-柜体木作
-墙面防潮膜铺设防护-隔音防潮
-墙面隔音棉填充-隔音防潮
-强弱电间距查验-水电验收
-水电完工全屋环视-水电验收
-水管打压测试操作-水电验收
-管线走向拍照留存-水电验收
-线路通电检测检查-水电验收
-隐蔽工程线管覆盖-水电验收
-隐蔽工程细节巡检-水电验收
-下水管道改造调整-水路施工
-卫生间冷热水管排布-水路施工
-厨卫地漏原位查看-水路施工
-厨房水管走顶铺设-水路施工
-悬挂式马桶施工-水路施工
-水管保温棉包裹防护-水路施工
-水管卡扣固定工艺-水路施工
-水管对接-水路施工
-水管铺设-水路施工
-热水器管路预留对接-水路施工
-阳台洗衣水管定位-水路施工
-中央空调装管-电路施工
-吊顶灯线预留走线-电路施工
-地面线管开槽处理-电路施工
-墙面线槽开槽施工-电路施工
-底盒内电线整理-电路施工
-底盒暗盒预埋安装-电路施工
-弱电网线单独排布-电路施工
-强弱电信号防干扰锡箔纸屏蔽膜-电路施工
-强弱电管分槽铺设-电路施工
-电管对接-电路施工
-电管铺设-电路施工
-电箱内部线路整理-电路施工
-电线穿管布线特写-电路施工
-装修材料堆放-电路施工
-全屋墙面铲除大白-墙面基层
-全屋批刮第一遍腻子-墙面基层
-墙固施工-墙面基层
-墙面裂缝挂网防裂-墙面基层
-墙面阴阳角找直处理-墙面基层
-腻子干透精细打磨-墙面基层
-地面地砖地膜保护-成品保护
-开关面板保护贴膜-成品保护
-柜体成品保护包裹-成品保护
-门窗门套包裹防护-成品保护
-乳胶漆修补-面漆涂刷
-乳胶漆效果展示-面漆涂刷
-乳胶漆调配-面漆涂刷
-墙面底漆均匀涂刷-面漆涂刷
-墙面纯色面漆涂刷-面漆涂刷
-背景墙艺术漆施工-面漆涂刷
-门窗边角精细刷涂-面漆涂刷
-顶面乳胶漆滚涂施工-面漆涂刷
-厨卫下水管道包裹-包管找平
-地面自流平施工处理-包管找平
-墙面全屋水泥砂浆找平-包管找平
-管道隔音棉加装-包管找平
-下水口瓷砖铺贴-瓷砖铺贴
-厨卫墙地通缝铺贴-瓷砖铺贴
-地砖干铺施工工艺-瓷砖铺贴
-墙砖定位-瓷砖铺贴
-墙面拉毛加固处理-瓷砖铺贴
-止逆阀安装-瓷砖铺贴
-沙子-瓷砖铺贴
-瓷砖完工展示-瓷砖铺贴
-瓷砖开孔-瓷砖铺贴
-瓷砖找平器调平固定-瓷砖铺贴
-瓷砖泡水预处理-瓷砖铺贴
-砖面挖孔定位-瓷砖铺贴
-窗台石门槛石安装-瓷砖铺贴
-贴墙砖-瓷砖铺贴
-铺地砖-瓷砖铺贴
-铺贴完成成品保护-瓷砖铺贴
-卫生间基层清理-防水施工
-厨卫闭水试验蓄水-防水施工
-墙面地面防水涂料涂刷-防水施工
-墙面防水上翻涂刷-防水施工
-楼下渗水查验确认-防水施工
-管根圆弧加固处理-防水施工
-防水涂层完工特写-防水施工
-阳台户外防水施工-防水施工
 吸睛画面-恶搞开篇
 工地恶搞-恶搞开篇
 搞笑涂料施工-恶搞开篇
@@ -203,7 +72,6 @@
 水管错位-施工翻车镜
 电线乱接-施工翻车镜
 防水翻车漏水-施工翻车镜
-墙面漆面细节查验-全屋验收
 柜体开合顺畅度检查-全屋验收
 踢脚线安装验收-软装进场
 验收合格签字确认-全屋验收
@@ -224,7 +92,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】

python-api/app/ai/prompts/system/bk/关键监工节点——装修监工6个关键时间点.txt

@@ -232,7 +232,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -240,7 +240,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },

python-api/app/ai/prompts/system/bk/新房装修流程——小白新房装修全流程.txt

@@ -0,0 +1,98 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修流程口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【新房装修全流程】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：严格按照下面的装修流程顺序，可适当调整表述，保持简洁明了
+
+以下是装修顺序：
+第一步、砸墙
+第二步、封窗
+第三步、改水电
+第四步、包隔音棉
+第五步、刷防水
+第六步、闭水试验
+第七步、铺地砖
+第八步、美缝
+第九步、铺地膜
+第十步、吊顶
+第十一步、刮腻子
+第十二步、刷漆
+第十三步、全屋定制
+第十四步、装烟机灶具
+第十五步、装门
+第十六步、装踢脚线
+第十七步、装灯
+第十八步、卫浴
+第十九步、保洁
+第二十步、装窗帘
+第二十一步、软装进场
+
+【语言要求】
+全程简洁化口语，尽量字少的同时表达准确意思，适配口播传播节奏
+【内置完整素材库标题】
+墙体拆除-墙体拆除
+封窗施工
+水电完工全屋环视-水电验收
+管道隔音棉加装-包管找平
+墙面地面防水涂料涂刷-防水施工
+厨卫闭水试验蓄水-防水施工
+铺地砖-瓷砖铺贴
+美缝施工-美缝开荒
+地面地砖地膜保护-成品保护
+石膏板固定-吊顶造型
+全屋批刮第一遍腻子-墙面基层
+墙面纯色面漆涂刷-面漆涂刷
+全屋定制柜体打底-柜体木作
+装烟机灶具
+室内房门安装固定-主材安装
+踢脚线安装验收-软装进场
+灯具筒灯射灯安装-主材安装
+卫浴洁具进场安装-主材安装
+全屋基础开荒保洁-美缝开荒
+窗帘轨道窗帘安装-软装进场
+家具进场摆放就位-软装进场
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “新房装修全流程”,
+“duration”: “1.75s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “墙体拆除-墙体拆除”,
+“voiceover”: “第一步、砸墙。”,
+“duration”: “1.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “封窗施工”,
+“voiceover”: “第二步、封窗”,
+“duration”: “1.25s”
+}
+]

python-api/app/ai/prompts/system/bk/水电改造避坑——水电改造的4个坑.txt

@@ -241,7 +241,7 @@ type 定义：segment = 人物出镜；empty_shot = 从上方内置素材库选
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合装修业主水电避坑痛点）
 duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数）
 【示例】
@@ -263,7 +263,7 @@ duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字
 {
 "id": 3,
 "type": "empty_shot",
-"scene": "墙砖定位-瓷砖铺贴",
+"scene": "瓷砖铺贴 - 瓷砖铺贴",
 "voiceover": "先说好瓷砖排版，别让瓦工做，商家免费排更精准",
 "duration": "5.00s"
 }

python-api/app/ai/prompts/system/bk/水电施工关键——水电施工的4个关键要点.txt

@@ -226,7 +226,7 @@ type 为 segment = 人物出镜；type=empty_shot = 从下方内置素材库选
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】

python-api/app/ai/prompts/system/bk/油工进场要点——油工进场要交代的6句话.txt

@@ -229,7 +229,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment” 或 “empty_shot”
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题
 voiceover: “配音文案”
 duration: “分镜时长”
 【示例】
@@ -251,7 +251,7 @@ duration: “分镜时长”
 {
 "id": 3,
 "type": "empty_shot",
-"scene": "墙固施工-墙面基层",
+"scene": "墙面基层 - 墙面基层",
 "voiceover": "第一，原始墙面刷高渗透墙固，自费也能防开裂反碱。",
 "duration": "5.25s"
 }

python-api/app/ai/prompts/system/bk/瓦工监工要点——瓦工进场监工记得交代的10件事.txt

@@ -240,7 +240,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -248,7 +248,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },

python-api/app/ai/prompts/system/bk/瓦工避坑细节——瓦工避坑的7个细节.txt

@@ -231,7 +231,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】

python-api/app/ai/prompts/system/bk/瓦工铺贴停工——瓷砖铺完不要着急干的5件事.txt

@@ -230,7 +230,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “瓷砖铺完别着急复工，这 5 件事做早了全是坑” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】

python-api/app/ai/prompts/system/bk/监工关键节点——装修必须在场的7个节点.txt

@@ -231,7 +231,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】

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

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

python-api/app/ai/prompts/system/bk/装修交代事项——装修师傅最讨厌业主做的6件事.txt

@@ -232,7 +232,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -240,7 +240,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },

python-api/app/ai/prompts/system/bk/装修合同干货——装修合同三大避坑干货.txt

@@ -231,7 +231,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -239,7 +239,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },

python-api/app/ai/prompts/system/bk/装修合同要点——装修签合同要注意的4点.txt

@@ -231,7 +231,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】

python-api/app/ai/prompts/system/bk/装修合同避坑——8 条装修合同避坑干货.txt

@@ -233,7 +233,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】

python-api/app/ai/prompts/system/bk/装修合理选项——流量型可多用.txt

@@ -0,0 +1,160 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作。
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修避坑口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【装修避坑】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：从下面给出的34组装修避坑对比中，**每次随机抽取10组**
+4. 格式要求：每组单独成行，格式严格为"不要X，要Y"，必须拆分两行
+5. 随机要求：10组的顺序必须完全随机打乱，每次生成的组合不能重复
+6. 禁止添加任何额外内容（包括标题、序号、解释、空行等）
+
+以下是全部34组避坑对比库：
+不要双开门冰箱，要十字开门冰箱
+不要直吸式马桶，要虹吸式马桶
+不要路由器，要全屋WiFi
+不要贵妃椅沙发，要直排沙发
+不要集成灶，要分体灶
+不要榻榻米，要普通床
+不要普通门锁，要智能门锁
+不要瓷砖上墙，要乳胶漆
+不要筒灯，要射灯
+不要深色地砖，要浅色地砖
+不要小双槽，要大单槽
+不要过门石，要全屋通铺
+不要反弹器，要免拉手
+不要无主灯，要双眼皮
+不要复杂背景墙，要简单背景墙
+不要拼色窗帘，要纯色窗帘
+不要正五孔插座，要斜五孔插座
+不要悬空马桶，要落地马桶
+不要回型吊顶，要双眼皮吊顶
+不要复杂吊灯，要吸顶灯
+不要插座外露，要隐藏式插座
+不要开放式收纳柜，要封闭式收纳柜
+不要一体式卫生间，要干湿分离卫生间
+不要造型柜门，要平板柜门
+不要直排下水，要墙排下水
+不要隐形衣架，要普通衣架
+不要双包套，要单包套
+不要阳角条，要海棠角
+不要悬浮电视柜，要落地电视柜
+不要高光衣柜门，要肤感衣柜门
+不要推拉门，要打通阳台
+不要猫眼，要一体门
+不要洗烘一体，要洗烘套装
+不要罗马杠，要窗帘盒
+【语言要求】
+全程口语化大白话，通俗易懂、接地气，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
+【内置完整素材库标题】
+不要双开门冰箱
+要十字开门冰箱
+不要直吸式马桶
+要虹吸式马桶
+不要路由器
+要全屋WiFi
+不要贵妃椅沙发
+要直排沙发
+不要集成灶
+要分体灶
+不要榻榻米
+要普通床
+不要普通门锁
+要智能门锁
+不要瓷砖上墙
+要乳胶漆
+不要筒灯
+要射灯
+不要深色地砖
+要浅色地砖
+不要小双槽
+要大单槽
+不要过门石
+要全屋通铺
+不要反弹器
+要免拉手
+不要无主灯
+要双眼皮
+不要复杂背景墙
+要简单背景墙
+不要拼色窗帘
+要纯色窗帘
+不要正五孔插座
+要斜五孔插座
+不要悬空马桶
+要落地马桶
+不要回型吊顶
+要双眼皮吊顶
+不要复杂吊灯
+要吸顶灯
+不要插座外露
+要隐藏式插座
+不要开放式收纳柜
+要封闭式收纳柜
+不要一体式卫生间
+要干湿分离卫生间
+不要造型柜门
+要平板柜门
+不要直排下水
+要墙排下水
+不要隐形衣架
+要普通衣架
+不要双包套
+要单包套
+不要阳角条
+要海棠角
+不要悬浮电视柜
+要落地电视柜
+不要高光衣柜门
+要肤感衣柜门
+不要推拉门
+要打通阳台
+不要猫眼
+要一体门
+不要洗烘一体
+要洗烘套装
+不要罗马杠
+要窗帘盒
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “装修避坑”,
+“duration”: “1s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “不要小双槽”,
+“voiceover”: “不要小双槽”,
+“duration”: “1.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “要大单槽”,
+“voiceover”: “要大单槽”,
+“duration”: “1s”
+}
+]

python-api/app/ai/prompts/system/bk/装修常见问题——装修必问的18个问题.txt

@@ -260,7 +260,7 @@ type 定义：segment = 人物出镜；empty_shot = 从上方内置素材库选
 一、分镜内容
 id: 按顺序递增（1、2、3…），不得重复、不得跳跃，严格按自然顺序编号
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充），严格对应定义，不得写错
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写；空镜必须从内置素材库中选择，不得自行创作场景）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主；空镜必须从内置素材库中选择，不得自行创作场景）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合装修业主咨询避坑痛点，保留原文问题原意）
 duration: “分镜时长”（格式如 “5s”“5.25s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数，核算精准，不出现偏差）
 【示例】

python-api/app/ai/prompts/system/bk/装修必问问题——半包装修必问 10 大关键问题.txt

@@ -236,7 +236,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 "5.25s"）
 【示例】
@@ -244,7 +244,7 @@ duration: “分镜时长”（如 “5s”，时长为 "配音文案" 的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },

python-api/app/ai/prompts/system/bk/装修省钱要点——装修不值得花钱的8个地方.txt

@@ -223,7 +223,7 @@ type规则：segment=人物出镜，empty_shot=选上方素材库标题。
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】

python-api/app/ai/prompts/system/bk/装修隐形套路——装修的5个隐形套路.txt

@@ -230,7 +230,7 @@ type 定义：segment = 人物出镜；empty_shot = 从上方素材库选匹配
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为配音文案纯文字字数 ÷4，严格控制在 3-8 秒，可以是两位小数）
 【示例】

python-api/app/ai/prompts/system/bk/装备材料选择——流量型可多用.txt

@@ -0,0 +1,121 @@
+你是一位专业的【口播类短视频】脚本创作专家，专注于家装 / 装修领域的抖音 / 视频号口播内容创作
+【平台适配】
+竖屏 9:16 拍摄
+【核心强制规则】
+你的任务是生成装修避坑口播文案，必须严格遵守以下所有规则，不得有任何偏差：
+
+1. 固定开头：第一行必须是【装修材料怎么选】
+2. 固定结尾：最后一行必须是【关注我，装修不踩坑】
+3. 中间内容：从下面给出的21组装修材料选择中，**每次随机抽取12组**
+4. 格式要求：每组单独成行，格式严格为"XXX选哪家，A、B、C"，必须拆分两行
+5. 随机要求：12组的顺序必须完全随机打乱，每次生成的组合不能重复
+6. 禁止添加任何额外内容（包括标题序号解释空行等）
+
+以下是全部21组装修材料选择库：
+冰箱买谁家？海尔、美的、卡萨帝。
+电视买谁家？索尼、海信、TCL。
+花洒哪家好？九牧、恒洁、箭牌。
+电线买谁家？远东、宝胜、熊猫。
+烟机哪家好？方太、老板、华帝。
+乳胶漆买谁家？立邦、三棵树、多乐士。
+开关插座买谁家？公牛、施耐德、西门子。
+瓷砖哪家好？东鹏、冠珠、马可波罗。
+水管买谁家？日丰、伟星、保利。
+板材选谁家？万华、爱格、兔宝宝。
+防水买谁家？立邦、德高、东方雨虹
+吊顶选谁家？奥普、友邦、法狮龙。
+地板哪家好？圣象、世友、大自然。
+腻子粉哪家好？立邦、美巢、圣戈邦。
+地漏谁家好？九牧、箭牌、潜水艇。
+家装水管谁家好？金牛、伟星、日丰
+家装水泥谁家好？海螺、红狮、中联
+厨卫五金谁家好？科勒、九牧、汉斯格雅
+石膏板谁家好？龙牌、泰山、可耐福
+瓷砖胶谁家好？德高、西卡、马贝
+玻璃胶谁家好？瓦克、西卡、百得
+【语言要求】
+全程口语化大白话，通俗易懂接地气，条理清晰干货满满，不生硬说教，适配口播传播节奏
+【内置完整素材库标题】
+冰箱买谁家
+海尔美的卡萨帝
+电视买谁家
+索尼海信TCL
+花洒哪家好
+九牧恒洁箭牌
+电线买谁家
+远东宝胜熊猫
+烟机哪家好
+方太老板华帝
+乳胶漆买谁家
+立邦三棵树多乐士
+开关插座买谁家
+公牛施耐德西门子
+瓷砖哪家好
+东鹏冠珠马可波罗
+水管买谁家
+日丰伟星保利
+板材选谁家
+万华爱格兔宝宝
+防水买谁家
+立邦德高东方雨虹
+吊顶选谁家
+奥普友邦法狮龙
+地板哪家好
+圣象世友大自然
+腻子粉哪家好
+立邦美巢圣戈邦
+地漏谁家好
+九牧箭牌潜水艇
+家装水管谁家好
+金牛伟星日丰
+家装水泥谁家好
+海螺红狮中联
+厨卫五金谁家好
+科勒九牧汉斯格雅
+石膏板谁家好
+龙牌泰山可耐福
+瓷砖胶谁家好
+德高西卡马贝
+玻璃胶谁家好
+瓦克西卡百得
+【分镜固定结构规则】
+开篇的分镜为：一段人物出镜
+中间内容全部用空镜，空镜（内置完整素材库标题）与文案内容需匹配
+结尾的分镜为：一段人物出镜
+“分镜文案 “等于” 配音文案”，“配音文案”严格按照每句一段。
+每个分镜的 “分镜时长” 为 {严格按每秒 4 个纯文字计算时长。文字统计硬性定义：纯文字包含汉字、阿拉伯数字，只扣除标点符号，所有字数、时长全部按这个口径计算，即 “分镜文案” 的纯文字字数 / 4}，严格控制在 1-8 秒，可以是两位小数
+type 为 segment = 人物出镜；type 为 empty_shot = 从内置素材库选匹配标题。
+“segment”（主播口播出镜）对应 “人物出镜”，人物出镜画面的内容，可以不用完整的句子，句子可以延伸到下一个画面
+“empty_shot”（空镜补充）对应上述素材库标题，文案内容需完全匹配
+【输出格式要求】
+输出的内容必须包含以下部分，只输出纯 JSON，不要包含 markdown 代码块或其他说明文字：
+一、分镜内容
+id: 按顺序递增（1、2、3…）
+type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配）
+voiceover: “配音文案”（严格与文案内容匹配）
+duration: “分镜时长”（如 “2s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 1-8 秒，可以是两位小数，如 “不要正五孔插座” 总共 7个文字，则是 “1.75s”）
+【示例】
+[
+{
+“id”: 1,
+“type”: “segment”,
+“scene”: “人物出镜”,
+“voiceover”: “装修材料怎么选”,
+“duration”: “1.75s”
+},
+{
+“id”: 2,
+“type”: “empty_shot”,
+“scene”: “冰箱买谁家”,
+“voiceover”: “冰箱买谁家？”,
+“duration”: “1.25s”
+},
+{
+“id”: 3,
+“type”: “empty_shot”,
+“scene”: “卡萨帝海尔美的”,
+“voiceover”: “卡萨帝、海尔、美的”,
+“duration”: “1.75s”
+}
+]

python-api/app/ai/prompts/system/bk/防水准备事项——防水前要做的事.txt

@@ -252,7 +252,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在12-32个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数（含数字，不含标点符号）/4，严格控制在3-8秒，可以是两位小数，如“他不是在赶工期，只是在图省事，这4点一定要做好”总共20个文字1个数字，则是"5.25s"）
 【示例】
@@ -260,7 +260,7 @@ duration: “分镜时长”（如 “5s”，时长为"配音文案"的字数
 {
 "id": 1,
 "type": "empty_shot",
-"scene": "防水翻车漏水-施工翻车镜",
+"scene": "防水翻车漏水",
 "voiceover": "新房装修刷防水，一上来就开刷的工人，直接撵走别客气！",
 "duration": "5.75s"
 },

python-api/app/ai/prompts/system/bk/阳台装修避坑——阳台装修的5个坑.txt

@@ -251,7 +251,7 @@ type 为 segment = 人物出镜；type 为 empty_shot = 从下方内置素材库
 一、分镜内容
 id: 按顺序递增（1、2、3…）
 type: “segment”（主播口播出镜）或 “empty_shot”（空镜补充）
-scene: “人物出镜” 或上述素材库标题（**必须从内置素材库标题中完整原样复制**，包括连字符"-"前后的顺序，不得调换、缩写或改写）
+scene: “人物出镜” 或上述素材库标题（严格与文案内容匹配，如文案内容前后有区别，以文案开头内容为主）
 voiceover: “配音文案”（必填，口语化，每个分镜严格控制在 12-32 个字，含数字，不含标点符号，必须要有标点符号断句，避免大长句，贴合决策期业主痛点）
 duration: “分镜时长”（如 “5s”，时长为 “配音文案” 的字数（含数字，不含标点符号）/4，严格控制在 3-8 秒，可以是两位小数，如 “他不是在赶工期，只是在图省事，这 4 点一定要做好” 总共 20 个文字 1 个数字，则是 “5.25s”）
 【示例】

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

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

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/api/v1/bgm_music.py

@@ -0,0 +1,43 @@
+"""
+背景音乐 API
+===========
+
+提供装修行业场景化 BGM 列表查询。
+"""
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.api.deps import get_db
+from app.crud.bgm_music import bgm_music
+from app.schemas.bgm_music import BgmMusicItem, BgmMusicListResponse
+from app.schemas.common import ApiResponse
+
+router = APIRouter()
+
+
+@router.get("/bgm-musics", response_model=ApiResponse[BgmMusicListResponse])
+async def list_bgm_musics(
+    category: str | None = Query(None, description="场景分类筛选"),
+    db: AsyncSession = Depends(get_db),
+) -> ApiResponse[BgmMusicListResponse]:
+    """
+    获取背景音乐列表
+
+    按场景分类返回可用的背景音乐列表。
+    分类说明：
+    - knowledge: 知识科普（极简、低频）
+    - showcase: 案例展示（积极、有成就感）
+    - promotion: 促销活动（轻快、有能量）
+    - lifestyle: 家居生活（温馨、治愈）
+    - tech: 智能家居（科技感、高级感）
+    """
+    items = await bgm_music.get_active_by_category(db, category=category)
+    return ApiResponse(
+        code=200,
+        message="success",
+        data=BgmMusicListResponse(
+            items=[BgmMusicItem.model_validate(item) for item in items],
+            total=len(items),
+        ),
+    )

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

@@ -0,0 +1,262 @@
+"""
+图片处理 API
+============
+
+提供图片上传（七牛云）和 AI 抠图（火山引擎 MediaKit）功能。
+"""
+
+import io
+import logging
+import time
+import uuid
+from pathlib import Path
+
+import httpx
+from fastapi import APIRouter, Depends, File, HTTPException, Request, UploadFile
+from pydantic import BaseModel, Field
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.api.deps import get_current_user, get_db
+from app.config import get_settings
+from app.models.user import User
+from app.schemas.common import ApiResponse, success_response
+from app.services import point_service as ps
+from app.services.qiniu_service import get_qiniu_service
+from app.services.volcengine_mediakit_service import VolcengineMediakitService
+from app.utils.file_validation import check_upload_file
+
+router = APIRouter(tags=["Image"])
+
+logger = logging.getLogger(__name__)
+settings = get_settings()
+
+
+# ── Dependencies ──
+
+async def get_mediakit_service(request: Request) -> VolcengineMediakitService:
+    """FastAPI Depends：从 app.state 获取全局 VolcengineMediakitService 实例。"""
+    service = getattr(request.app.state, "volcengine_mediakit_service", None)
+    if service is None:
+        raise HTTPException(
+            status_code=503,
+            detail="MediaKit 服务未初始化，请检查配置",
+        )
+    return service
+
+
+# ── Schemas ──
+
+class ImageUploadResponse(BaseModel):
+    """图片上传响应"""
+
+    url: str = Field(..., description="七牛云图片 URL")
+    key: str = Field(..., description="七牛云文件 key")
+    size: int = Field(..., description="文件大小（字节）")
+
+
+class RemoveBackgroundResponse(BaseModel):
+    """抠图响应"""
+
+    url: str = Field(..., description="抠图结果图片 URL")
+
+
+class RemoveBackgroundRequest(BaseModel):
+    """抠图请求"""
+
+    image_url: str = Field(..., description="原始图片 URL")
+    scene: str = Field(default="human", description="场景类型：general（通用）、human（人物，默认白色描边）或 product（商品）")
+
+
+# ── Endpoints ──
+
+@router.post("/upload/image", response_model=ApiResponse[ImageUploadResponse])
+async def upload_image(
+    file: UploadFile = File(..., description="图片文件"),
+    current_user: User = Depends(get_current_user),
+) -> ApiResponse[ImageUploadResponse]:
+    """
+    上传图片到七牛云
+
+    支持格式：jpg, jpeg, png, gif, webp
+    返回七牛云永久访问 URL。
+    """
+    try:
+        allowed_types = {
+            "image/jpeg",
+            "image/jpg",
+            "image/png",
+            "image/gif",
+            "image/webp",
+        }
+        content_type = file.content_type or ""
+
+        # 如果 content_type 为空，尝试从文件名推断
+        if not content_type:
+            ext = Path(file.filename or "").suffix.lower()
+            ext_to_mime = {
+                ".jpg": "image/jpeg",
+                ".jpeg": "image/jpeg",
+                ".png": "image/png",
+                ".gif": "image/gif",
+                ".webp": "image/webp",
+            }
+            content_type = ext_to_mime.get(ext, "")
+
+        if content_type not in allowed_types:
+            raise HTTPException(
+                status_code=400,
+                detail=f"不支持的图片格式: {content_type}，请上传 jpg/png/gif/webp 图片",
+            )
+
+        # 读取文件内容
+        content = await file.read()
+        if not content:
+            raise HTTPException(status_code=400, detail="文件内容为空")
+
+        # 校验大小和魔数
+        check_upload_file(
+            content,
+            settings.UPLOAD_MAX_IMAGE_SIZE,
+            content_type,
+            "图片",
+        )
+
+        # 生成唯一文件名
+        ext = Path(file.filename or "image.jpg").suffix or ".jpg"
+        unique_name = f"{uuid.uuid4().hex[:16]}{ext}"
+
+        # 上传到七牛云
+        qiniu = get_qiniu_service()
+        bucket, domain = qiniu._get_bucket_and_domain("image")
+        file_key = qiniu.generate_key("image", unique_name)
+        stream = io.BytesIO(content)
+        result = await qiniu.upload_stream_async(
+            stream=stream,
+            key=file_key,
+            mime_type=content_type or "image/jpeg",
+            bucket=bucket,
+            domain=domain,
+        )
+
+        url = result.get("url")
+        returned_key = result.get("key")
+
+        if not url:
+            raise HTTPException(status_code=500, detail="上传到七牛云失败：未返回 URL")
+
+        logger.info(f"[Upload] 图片上传成功: {url[:80]}..., size={len(content)}")
+
+        return success_response(
+            data=ImageUploadResponse(
+                url=url,
+                key=returned_key or file_key,
+                size=len(content),
+            )
+        )
+
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.error(f"[Upload] 图片上传失败: {e}")
+        raise HTTPException(status_code=500, detail=f"上传失败: {e}")
+
+
+@router.post("/image/remove-background", response_model=ApiResponse[RemoveBackgroundResponse])
+async def remove_background(
+    req: RemoveBackgroundRequest,
+    current_user: User = Depends(get_current_user),
+    mediakit_service: VolcengineMediakitService = Depends(get_mediakit_service),
+    db: AsyncSession = Depends(get_db),
+) -> ApiResponse[RemoveBackgroundResponse]:
+    """
+    AI 抠图（火山引擎 MediaKit）
+
+    移除图片背景，返回透明背景图片 URL。
+    每次调用消耗 10 积分。
+    """
+    # 前置积分检查
+    required_points = ps._calculate_cost("cover_avatar")
+    check = await ps.check_balance(db, current_user.id, required_points)
+    if not check["sufficient"]:
+        raise HTTPException(
+            status_code=402,
+            detail=f"积分不足，需要 {required_points} 积分，当前余额 {check['balance']}",
+        )
+
+    try:
+        logger.info(
+            f"[RemoveBackground] 开始抠图: image_url={req.image_url[:80]}..., scene={req.scene}"
+        )
+        result = await mediakit_service.remove_background(
+            image_url=req.image_url,
+            scene=req.scene,
+        )
+
+        if not result.image_url:
+            logger.error(
+                f"[RemoveBackground] 抠图返回空 URL: raw={result.raw}"
+            )
+            raise HTTPException(status_code=500, detail="抠图失败：未返回结果图片 URL")
+
+        logger.info(f"[RemoveBackground] 抠图成功: {result.image_url[:80]}...")
+
+        # 下载抠图结果并转存到七牛云（避免前端 CORS 问题）
+        try:
+            async with httpx.AsyncClient(timeout=60.0) as client:
+                img_resp = await client.get(result.image_url, follow_redirects=True)
+                img_resp.raise_for_status()
+                img_content = img_resp.content
+
+            if not img_content:
+                raise HTTPException(status_code=500, detail="抠图结果下载失败：内容为空")
+
+            # 上传到七牛云 image bucket
+            qiniu = get_qiniu_service()
+            bucket, domain = qiniu._get_bucket_and_domain("image")
+            unique_name = f"{uuid.uuid4().hex[:16]}.png"
+            file_key = qiniu.generate_key("image", unique_name)
+            stream = io.BytesIO(img_content)
+            upload_result = await qiniu.upload_stream_async(
+                stream=stream,
+                key=file_key,
+                mime_type="image/png",
+                bucket=bucket,
+                domain=domain,
+            )
+
+            qiniu_url = upload_result.get("url")
+            if not qiniu_url:
+                raise HTTPException(status_code=500, detail="抠图结果转存到七牛云失败")
+
+            logger.info(f"[RemoveBackground] 结果已转存七牛云: {qiniu_url[:80]}...")
+
+            # 后置扣费（服务已调用成功）
+            await ps.consume(
+                db,
+                user_id=current_user.id,
+                points=required_points,
+                source_type="cover_avatar",
+                source_id=f"cover_avatar_{current_user.id}_{int(time.time() * 1000)}",
+                description="【封面形象抠图】",
+            )
+            await db.commit()
+
+            return success_response(
+                data=RemoveBackgroundResponse(url=qiniu_url),
+                message="抠图成功",
+            )
+        except HTTPException:
+            raise
+        except Exception as e:
+            logger.error(f"[RemoveBackground] 结果转存失败: {e}")
+            raise HTTPException(status_code=500, detail=f"抠图结果转存失败: {e}")
+
+    except HTTPException:
+        raise
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(
+            f"[RemoveBackground] 抠图失败: image_url={req.image_url[:80]}..., error={e}"
+        )
+        raise HTTPException(status_code=500, detail=f"抠图失败: {e}")

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

@@ -7,9 +7,11 @@ from fastapi import APIRouter
 
 from app.api.v1 import (
     auth,
+    bgm_music,
     caption,
     cover_background,
     events,
+    image,
     materials,
     points,
     script,
@@ -59,5 +61,11 @@ api_router.include_router(cover_background.router, tags=["Cover Background"])
 # 积分系统模块
 api_router.include_router(points.router, tags=["Points"])
 
+# 图片处理模块（上传 + 抠图）
+api_router.include_router(image.router, tags=["Image"])
+
+# 背景音乐模块
+api_router.include_router(bgm_music.router, tags=["BGM Music"])
+
 # 应用更新模块
 api_router.include_router(update.router, prefix="/update", tags=["Update"])

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

@@ -14,10 +14,11 @@ import time
 from fastapi import APIRouter, Depends, HTTPException
 from sqlalchemy.ext.asyncio import AsyncSession
 
+from app.ai.model_router import get_model_router
+from app.ai.prompts import list_categories, list_prompt_files, load_prompt, render_template
 from app.api.deps import get_current_user
 from app.db.session import get_db
-from app.ai.model_router import get_model_router
-from app.ai.prompts import list_categories, load_prompt, render_template
+from app.models.user import User
 from app.schemas.common import ApiResponse, success_response
 from app.schemas.script import (
     CategoryItem,
@@ -25,9 +26,8 @@ from app.schemas.script import (
     GenerateTitleResponse,
     PolishRequest,
 )
-from app.services.script_service import get_script_service
 from app.services import point_service as ps
-from app.models.user import User
+from app.services.script_service import get_script_service
 
 router = APIRouter()
 logger = logging.getLogger(__name__)
@@ -38,9 +38,11 @@ async def get_categories():
     """
     获取提示词分类列表
 
-    返回所有大类和小类结构，供前端选择。
+    返回所有大类及其下的提示词文件列表，供前端选择。
     """
     categories = list_categories()
+    for cat in categories:
+        cat["files"] = list_prompt_files(cat["code"])
     return success_response(
         data=categories,
         message="获取分类列表成功",

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

@@ -36,7 +36,7 @@ class ScriptParams(BaseModel):
     """脚本生成参数"""
 
     category: str = Field(..., min_length=1, description="大类代码")
-    subcategory: str = Field(..., min_length=1, description="小类代码")
+    filename: str = Field(..., min_length=1, description="提示词文件名")
 
 
     @field_validator("category")
@@ -46,11 +46,11 @@ class ScriptParams(BaseModel):
             raise ValueError("category 不能为空")
         return v.strip()
 
-    @field_validator("subcategory")
+    @field_validator("filename")
     @classmethod
-    def validate_subcategory(cls, v: str) -> str:
+    def validate_filename(cls, v: str) -> str:
         if not v or not v.strip():
-            raise ValueError("subcategory 不能为空")
+            raise ValueError("filename 不能为空")
         return v.strip()
 
 
@@ -174,7 +174,7 @@ async def create_task(
             required_points = ps._calculate_cost("script")
             validated_params = {
                 "category": script_validated.category,
-                "subcategory": script_validated.subcategory,
+                "filename": script_validated.filename,
             }
 
         elif task_type == "subtitle":

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

@@ -7,7 +7,7 @@
 
 from datetime import UTC, datetime
 
-from fastapi import APIRouter, Depends, HTTPException, Query, status
+from fastapi import APIRouter, Depends, HTTPException, Query, Response, status
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
 
@@ -44,25 +44,30 @@ async def check_update(
     latest: AppRelease | None = result.scalar_one_or_none()
 
     if not latest:
-        raise HTTPException(status_code=status.HTTP_204_NO_CONTENT)
+        return Response(status_code=status.HTTP_204_NO_CONTENT)
 
     # 已是最新版本（或更高）
     if latest.version == version:
-        raise HTTPException(status_code=status.HTTP_204_NO_CONTENT)
+        return Response(status_code=status.HTTP_204_NO_CONTENT)
 
-    # 查询对应平台的包
+    # 查询对应平台的包（优先返回 updater 用的包：有 signature 的 .app.tar.gz / .exe）
     result = await db.execute(
         select(ReleasePackage).where(
             ReleasePackage.release_id == latest.id,
             ReleasePackage.platform == target,
             ReleasePackage.architecture == arch,
+        ).order_by(
+            # 有 signature 的排前面（updater 包），空 signature 的排后面（dmg 安装包）
+            ReleasePackage.signature.desc()
         )
     )
-    pkg: ReleasePackage | None = result.scalar_one_or_none()
+    pkgs = result.scalars().all()
+    # 取第一个：优先有 signature 的 updater 包；如果没有则取任意一个
+    pkg: ReleasePackage | None = pkgs[0] if pkgs else None
 
     if not pkg:
         # 该平台无包，返回 204（避免报错阻断用户）
-        raise HTTPException(status_code=status.HTTP_204_NO_CONTENT)
+        return Response(status_code=status.HTTP_204_NO_CONTENT)
 
     # 构建 Tauri 格式的响应
     platform_key = f"{target}-{arch}"

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

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

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

@@ -43,7 +43,11 @@ async def vidu_callback(request: Request):
     body_bytes = await request.body()
     headers_dict = dict(request.headers)
 
-    logger.info(f"[Vidu] 收到回调: url={request.url}, body={body_bytes.decode('utf-8', errors='replace')[:500]}")
+    # 使用 APP_BASE_URL 构建 callback_url，确保与提交任务时传给 Vidu 的一致
+    #（Nginx 反向代理可能导致 request.url 的 scheme 为 http，与 Vidu 签名时的 https 不一致）
+    app_base_url = get_settings().app_base_url
+    callback_url = f"{app_base_url}/api/v1/vidu/callback" if app_base_url else str(request.url)
+    logger.info(f"[Vidu] 收到回调: request_url={request.url}, callback_url={callback_url}, body={body_bytes.decode('utf-8', errors='replace')[:500]}")
 
     try:
         task_status = await gateway.handle_webhook(
@@ -51,7 +55,7 @@ async def vidu_callback(request: Request):
             headers=headers_dict,
             body=body_bytes,
             secret=get_settings().VIDU_API_KEY,
-            callback_url=str(request.url),
+            callback_url=callback_url,
         )
     except PlatformError as e:
         logger.warning(f"[Vidu] 回调验证失败: {e}")

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

@@ -171,28 +171,37 @@ def _normalize_voice_id(name: str | None) -> str:
     将用户输入的名称规范化为 Vidu 合法的 voice_id。
 
     Vidu 要求：8~256 字符，首字符必须是字母。
+    为避免同一 voice_id 在 Vidu 侧重复导致 "voice clone voice id duplicate" 报错，
+    每次均附加随机后缀，确保全局唯一。
     """
+    # 固定后缀：下划线 + 6 位十六进制随机字符（7 字符）
+    suffix = f"_{uuid.uuid4().hex[:6]}"
+    suffix_len = len(suffix)
+
     if not name:
-        return f"vidu_{uuid.uuid4().hex[:8]}"
+        base = f"vidu_{uuid.uuid4().hex[:8]}"
+    else:
+        # 只保留字母、数字、下划线
+        base = re.sub(r"[^a-zA-Z0-9_]", "", name)
 
-    # 只保留字母、数字、下划线
-    cleaned = re.sub(r"[^a-zA-Z0-9_]", "", name)
+        # 确保首字符是字母
+        if base and not base[0].isalpha():
+            base = "v" + base
+        elif not base:
+            base = "voice"
 
-    # 确保首字符是字母
-    if cleaned and not cleaned[0].isalpha():
-        cleaned = "v" + cleaned
-    elif not cleaned:
-        cleaned = "voice"
+    # 预留后缀长度，总长度不超过 256
+    max_base_len = 256 - suffix_len
+    if len(base) > max_base_len:
+        base = base[:max_base_len]
 
-    # 长度不足 8，补足随机字符
-    if len(cleaned) < 8:
-        cleaned = cleaned + uuid.uuid4().hex[: (8 - len(cleaned))]
+    # 长度不足 8（含后缀），补足随机字符
+    min_total = 8
+    if len(base) + suffix_len < min_total:
+        pad_len = min_total - len(base) - suffix_len
+        base = base + uuid.uuid4().hex[:pad_len]
 
-    # 长度超过 256，截断
-    if len(cleaned) > 256:
-        cleaned = cleaned[:256]
-
-    return cleaned
+    return base + suffix
 
 
 @router.post("/clone/submit", response_model=ApiResponse[VoiceCloneTaskResponse])

python-api/app/config.py

@@ -24,7 +24,7 @@ class Settings(BaseSettings):
 
     # 应用基础配置
     APP_NAME: str = Field(default="美家卡智影 API", description="应用名称")
-    APP_VERSION: str = Field(default="1.5.18", description="应用版本")
+    APP_VERSION: str = Field(default="1.8.0", description="应用版本")
     DEBUG: bool = Field(default=False, description="调试模式")
     ENV: Literal["development", "staging", "production"] = Field(
         default="development", description="运行环境"
@@ -106,6 +106,9 @@ class Settings(BaseSettings):
     VOLCENGINE_CAPTION_APPID: str | None = Field(default=None, description="火山字幕 AppID")
     VOLCENGINE_CAPTION_TOKEN: str | None = Field(default=None, description="火山字幕 Token")
 
+    # 火山引擎 MediaKit 服务（背景移除等多媒体处理）
+    VOLCENGINE_MEDIAKIT_TOKEN: str | None = Field(default=None, description="火山引擎 MediaKit Token")
+
     # Vidu 密钥（base_url 已从 Settings 移除，改用 config/platform-config.yaml 配置）
     VIDU_API_KEY: str | None = Field(default=None, description="Vidu API Key")
 
@@ -134,6 +137,10 @@ class Settings(BaseSettings):
     SMS_EXTENDED_CODE: str | None = Field(
         default=None, description="B2M 短信平台扩展码（选填）"
     )
+    SMS_CODE_WHITELIST: str = Field(
+        default="",
+        description="免验证码登录白名单（逗号分隔的手机号，如 13800138000,13900139000）",
+    )
 
 
 
@@ -175,6 +182,17 @@ class Settings(BaseSettings):
         """是否使用 Redis"""
         return bool(self.REDIS_HOST)
 
+    @property
+    def sms_code_whitelist_set(self) -> set[str]:
+        """免验证码登录白名单（去重、去空格）"""
+        if not self.SMS_CODE_WHITELIST:
+            return set()
+        return {
+            mobile.strip()
+            for mobile in self.SMS_CODE_WHITELIST.split(",")
+            if mobile.strip()
+        }
+
 
 @lru_cache
 def get_settings() -> Settings:

python-api/app/crud/__init__.py

@@ -10,6 +10,7 @@ CRUD 模块
     user_obj = await user.get(db, id="xxx")
 """
 
+from app.crud.bgm_music import bgm_music
 from app.crud.broll_category import broll_category
 from app.crud.broll_material import broll_material
 from app.crud.cover_background import cover_background
@@ -17,6 +18,7 @@ from app.crud.user import user
 
 __all__ = [
     "user",
+    "bgm_music",
     "broll_category",
     "broll_material",
     "cover_background",

python-api/app/crud/bgm_music.py

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

python-api/app/crud/broll_category.py

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

python-api/app/main.py

@@ -66,6 +66,10 @@ async def lifespan(app: FastAPI):
             timeout=httpx.Timeout(60.0, connect=5.0),
             limits=httpx.Limits(max_connections=10, max_keepalive_connections=10),
         ),
+        "volcengine_mediakit": httpx.AsyncClient(
+            timeout=httpx.Timeout(60.0, connect=5.0),
+            limits=httpx.Limits(max_connections=10, max_keepalive_connections=10),
+        ),
         "default": httpx.AsyncClient(
             timeout=httpx.Timeout(30.0, connect=5.0),
             limits=httpx.Limits(max_connections=50, max_keepalive_connections=20),
@@ -90,6 +94,18 @@ async def lifespan(app: FastAPI):
         logger.warning(f"Volcengine Caption Provider 初始化跳过: {e}")
         app.state.volcengine_caption_provider = None
 
+    # 火山 Mediakit Provider
+    from app.ai.providers.volcengine_mediakit_provider import VolcengineMediakitProvider
+
+    try:
+        app.state.volcengine_mediakit_provider = VolcengineMediakitProvider(
+            client=app.state.http_clients["volcengine_mediakit"]
+        )
+        logger.info("Volcengine Mediakit Provider initialized")
+    except Exception as e:
+        logger.warning(f"Volcengine Mediakit Provider 初始化跳过: {e}")
+        app.state.volcengine_mediakit_provider = None
+
     # 火山方舟 Provider（可选，需要 API Key）
     try:
         from app.ai.providers.volcengine_provider import VolcengineProvider
@@ -104,6 +120,7 @@ async def lifespan(app: FastAPI):
     from app.ai.adapters.vidu_adapter import ViduAdapter
     from app.ai.adapters.volcengine_ark_adapter import VolcengineArkAdapter
     from app.ai.adapters.volcengine_caption_adapter import VolcengineCaptionAdapter
+    from app.ai.adapters.volcengine_mediakit_adapter import VolcengineMediakitAdapter
     from app.platform_gateway import PlatformGateway
 
     app.state.vidu_adapter = ViduAdapter(app.state.vidu_provider)
@@ -122,6 +139,15 @@ async def lifespan(app: FastAPI):
         )
         logger.info("VolcengineCaptionAdapter initialized")
 
+    if app.state.volcengine_mediakit_provider:
+        app.state.volcengine_mediakit_adapter = VolcengineMediakitAdapter(
+            app.state.volcengine_mediakit_provider
+        )
+        app.state.platform_gateway.register(
+            "volcengine_mediakit", app.state.volcengine_mediakit_adapter
+        )
+        logger.info("VolcengineMediakitAdapter initialized")
+
     if app.state.volcengine_provider:
         app.state.volcengine_ark_adapter = VolcengineArkAdapter(
             app.state.volcengine_provider
@@ -145,6 +171,7 @@ async def lifespan(app: FastAPI):
     # 初始化 Service（传入 Gateway）
     from app.services.vidu_service import ViduService
     from app.services.volcengine_caption_service import VolcengineCaptionService
+    from app.services.volcengine_mediakit_service import VolcengineMediakitService
 
     app.state.vidu_service = ViduService(app.state.platform_gateway)
     logger.info("Vidu Service initialized")
@@ -157,6 +184,14 @@ async def lifespan(app: FastAPI):
     else:
         app.state.volcengine_caption_service = None
 
+    if app.state.volcengine_mediakit_provider:
+        app.state.volcengine_mediakit_service = VolcengineMediakitService(
+            app.state.platform_gateway
+        )
+        logger.info("Volcengine Mediakit Service initialized")
+    else:
+        app.state.volcengine_mediakit_service = None
+
     # LLM Gateway（可选，向后兼容）
     if app.state.volcengine_provider:
         from app.ai.gateways.llm_gateway import LLMGateway
@@ -326,9 +361,9 @@ def main():
         workers=settings.WORKERS if not settings.DEBUG else 1,
         reload=settings.DEBUG,
         log_level=settings.LOG_LEVEL.lower(),
+        access_log=False,
     )
 
 
 if __name__ == "__main__":
     main()
-# test

python-api/app/models/__init__.py

@@ -7,6 +7,7 @@
 """
 
 from app.models.base import BaseModel, BaseModelBigInt
+from app.models.bgm_music import BgmMusic
 from app.models.broll_category import BrollCategory
 from app.models.broll_material import BrollMaterial
 from app.models.broll_tag import BrollTag
@@ -21,6 +22,7 @@ from app.models.user_point import UserPoint
 __all__ = [
     "BaseModel",
     "BaseModelBigInt",
+    "BgmMusic",
     "User",
     "UserDevice",
     "UserPoint",

python-api/app/models/bgm_music.py

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

python-api/app/models/update.py

@@ -38,7 +38,7 @@ class AppRelease(Base):
 class ReleasePackage(Base):
     """平台安装包信息"""
 
-    __tablename__ = "mjk_release_packages"
+    __tablename__ = "mjk_app_release_packages"
 
     id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
     release_id: Mapped[int] = mapped_column(
@@ -60,5 +60,5 @@ class ReleasePackage(Base):
     release: Mapped["AppRelease"] = relationship("AppRelease", back_populates="packages")
 
     __table_args__ = (
-        UniqueConstraint("release_id", "platform", "architecture", name="uix_pkg_platform_arch"),
+        UniqueConstraint("release_id", "platform", "architecture", "filename", name="uix_app_pkg_platform_arch_filename"),
     )

python-api/app/scheduler/handlers/script_handler.py

@@ -22,18 +22,21 @@ from app.services.script_service import ScriptService
 logger = logging.getLogger(__name__)
 
 
-def _get_category_name(category: str, subcategory: str) -> str:
-    """从 _meta.json 查找分类中文名称，组合为 title"""
+def _get_category_name(category: str, filename: str) -> str:
+    """从文件名解析文案作为 title"""
     meta = _load_system_meta()
+    cat_name = category
     for cat in meta.get("categories", []):
         if cat.get("code") == category:
             cat_name = cat.get("name", category)
-            for sub in cat.get("subcategories", []):
-                if sub.get("code") == subcategory:
-                    sub_name = sub.get("name", subcategory)
-                    return f"{cat_name} · {sub_name}"
-            return cat_name
-    return f"{category}/{subcategory}"
+            break
+    # 从文件名解析文案（前半部分）
+    if filename:
+        name = filename.replace(".txt", "")
+        if "——" in name:
+            label = name.split("——", 1)[0]
+            return f"{cat_name} · {label}"
+    return cat_name
 
 SLOT_KEY = "script:slots"
 
@@ -93,7 +96,7 @@ class ScriptHandler(AsyncHandler):
         changes: list[StateChange] = []
         params = task.params or {}
         category = params.get("category", "")
-        subcategory = params.get("subcategory", "")
+        filename = params.get("filename", "")
 
         await registry.update(
             task.task_id,
@@ -114,13 +117,13 @@ class ScriptHandler(AsyncHandler):
             service = self._get_service()
             shots = await service.generate_script(
                 category=category,
-                subcategory=subcategory,
+                filename=filename,
             )
 
             # 计算分镜真实总时长
             total_duration = sum(s.duration for s in shots if s.duration)
             result_data = {
-                "title": _get_category_name(category, subcategory),
+                "title": _get_category_name(category, filename),
                 "scenes": [s.model_dump() for s in shots],
                 "total_duration": total_duration,
                 "shot_count": len(shots),

python-api/app/schemas/bgm_music.py

@@ -0,0 +1,29 @@
+"""
+背景音乐 Schema
+==============
+"""
+
+from pydantic import BaseModel, Field
+
+
+class BgmMusicItem(BaseModel):
+    """背景音乐项"""
+
+    id: int = Field(description="音乐ID")
+    title: str = Field(description="音乐名称")
+    artist: str | None = Field(default=None, description="艺术家")
+    category: str = Field(description="场景分类")
+    file_path: str = Field(description="相对文件路径")
+    url: str = Field(description="七牛云 URL")
+    duration: float | None = Field(default=None, description="时长（秒）")
+    sort_order: int = Field(default=0, description="排序权重")
+
+    class Config:
+        from_attributes = True
+
+
+class BgmMusicListResponse(BaseModel):
+    """背景音乐列表响应"""
+
+    items: list[BgmMusicItem] = Field(description="音乐列表")
+    total: int = Field(description="总数")

python-api/app/schemas/script.py

@@ -3,7 +3,6 @@
 ===============
 """
 
-from typing import Any
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -12,12 +11,12 @@ from app.schemas.segment import Segment
 ScriptShot = Segment
 
 
-class SubcategoryItem(BaseModel):
-    """小类项"""
+class PromptFileItem(BaseModel):
+    """提示词文件项"""
 
-    code: str = Field(..., description="小类代码")
-    name: str = Field(..., description="小类名称")
-    count: int = Field(..., description="提示词文件数量")
+    filename: str = Field(..., description="文件名")
+    label: str = Field(..., description="文案（文件名前半部分）")
+    desc: str = Field(..., description="描述（文件名后半部分）")
 
 
 class CategoryItem(BaseModel):
@@ -25,14 +24,14 @@ class CategoryItem(BaseModel):
 
     code: str = Field(..., description="大类代码")
     name: str = Field(..., description="大类名称")
-    subcategories: list[SubcategoryItem] = Field(..., description="小类列表")
+    files: list[PromptFileItem] = Field(default_factory=list, description="提示词文件列表")
 
 
 class GenerateScriptRequest(BaseModel):
     """生成脚本请求"""
 
     category: str = Field(..., description="大类代码，如 bk")
-    subcategory: str = Field(..., description="小类代码，如 ht")
+    filename: str = Field(..., description="提示词文件名，如 水电改造避坑——水电改造的4个坑.txt")
     duration: int = Field(default=45, ge=30, le=180, description="视频时长（秒）")
     script_type: str = Field(default="干货型", description="脚本类型")
     model: str | None = Field(None, description="指定模型（可选）")

python-api/app/services/auth_service.py

@@ -18,6 +18,7 @@ from typing import Any
 import httpx
 from sqlalchemy.ext.asyncio import AsyncSession
 
+from app.config import get_settings
 from app.core.redis_client import get_redis_client
 from app.core.security import (
     create_access_token,
@@ -188,8 +189,9 @@ async def login_with_sms(
     5. 创建/覆盖设备记录
     6. 签发双 Token
     """
-    # 1. 校验验证码
-    if not await verify_sms_code(mobile, code):
+    # 1. 校验验证码（白名单内的手机号跳过校验）
+    settings = get_settings()
+    if mobile not in settings.sms_code_whitelist_set and not await verify_sms_code(mobile, code):
         raise ValueError("验证码错误或已过期")
 
     # 2. 查询用户（不再自动注册）

python-api/app/services/material_service.py

@@ -15,6 +15,7 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from app.core.exceptions import ValidationException
 from app.core.redis_client import get_redis_client
 from app.crud import broll_category, broll_material
+from app.models.broll_category import BrollCategory
 
 logger = logging.getLogger(__name__)
 
@@ -48,7 +49,7 @@ def _weighted_choice(materials: list) -> object:  # noqa: ANN001
 
     r = random.uniform(0, total_weight)
     cumulative = 0.0
-    for m, w in zip(materials, weights):
+    for m, w in zip(materials, weights, strict=True):
         cumulative += w
         if r <= cumulative:
             return m
@@ -57,6 +58,64 @@ def _weighted_choice(materials: list) -> object:  # noqa: ANN001
     return materials[-1]
 
 
+async def _try_fallback_to_parent(
+    db: AsyncSession,
+    normalized_scene: str,
+) -> BrollCategory | None:
+    """
+    三级分类匹配失败时，回退到上级（level=2）分类随机选取子分类。
+
+    解析逻辑：
+    - 若 scene 含 '-'，取后半部分作为 parent_name（如 '电路施工-电路施工' -> '电路施工'）
+    - 若不含 '-'，直接以整个 scene 作为 parent_name
+
+    匹配策略（逐级降级）：
+    1. 精确匹配 level=2 分类 name
+    2. 模糊匹配（LIKE %parent_name%），兼容 "电路施工" → "电路施工镜"
+    3. 去掉常见后缀（镜、阶段等）再精确匹配
+
+    返回：
+        随机选中的一个 level=3 子分类，或 None
+    """
+    if "-" in normalized_scene:
+        parent_name = normalized_scene.rsplit("-", 1)[-1]
+    else:
+        parent_name = normalized_scene
+
+    # 1. 精确匹配
+    parent = await broll_category.get_by_name_and_level(
+        db, name=parent_name, level=2
+    )
+
+    # 2. 模糊匹配（兼容 "电路施工" → "电路施工镜"）
+    if parent is None:
+        parent = await broll_category.get_by_name_like_and_level(
+            db, name=parent_name, level=2
+        )
+
+    # 3. 去掉常见后缀再试
+    if parent is None:
+        for suffix in ("镜", "阶段"):
+            if not parent_name.endswith(suffix):
+                candidate = parent_name + suffix
+                parent = await broll_category.get_by_name_and_level(
+                    db, name=candidate, level=2
+                )
+                if parent:
+                    break
+
+    if parent is None:
+        return None
+
+    children = await broll_category.get_children_by_parent_id(
+        db, parent_id=parent.id, level=3
+    )
+    if not children:
+        return None
+
+    return random.choice(children)
+
+
 async def match_material(
     db: AsyncSession,
     scene: str,
@@ -68,11 +127,13 @@ async def match_material(
 
     匹配策略：
     1. 标准化 scene，精确匹配三级分类（level=3）的 name。
-    2. 查询该分类下状态为 active、时长 >= required_duration 的素材。
-    3. 若提供 project_id，从 Redis 获取该项目已使用的 URL 并排除。
-    4. 优先从未使用候选中加权随机选择；若未用候选为空，
+    2. 若精确匹配失败，尝试将 "A-B" 倒序为 "B-A" 再匹配。
+    3. 若仍失败，回退到上级（level=2）分类，随机选取一个子分类。
+    4. 查询该分类下状态为 active、时长 >= required_duration 的素材。
+    5. 若提供 project_id，从 Redis 获取该项目已使用的 URL 并排除。
+    6. 优先从未使用候选中加权随机选择；若未用候选为空，
        fallback 到全部候选（允许复用，保证合成连续性）。
-    5. 原子递增 usage_count，并将选中的 URL 写入 Redis Set（7 天 TTL）。
+    7. 原子递增 usage_count，并将选中的 URL 写入 Redis Set（7 天 TTL）。
 
     Args:
         db: 数据库 Session
@@ -110,6 +171,13 @@ async def match_material(
                 logger.info(
                     f"素材分类顺序颠倒兜底命中: '{normalized}' -> '{reversed_name}'"
                 )
+    # 若仍失败，回退到上级分类随机选取
+    if category is None:
+        category = await _try_fallback_to_parent(db, normalized)
+        if category:
+            logger.info(
+                f"素材回退到上级分类命中: '{normalized}' -> '{category.name}'"
+            )
     if category is None:
         logger.debug(f"未找到分类: {normalized}")
         return None
@@ -217,7 +285,17 @@ async def batch_match(
                 f"批量匹配顺序颠倒兜底命中: '{name}' -> '{rev}'"
             )
 
-    # 3. 收集所有需要的 category_id
+    # 3. 未匹配的 scene 回退到上级分类随机选取
+    unmatched = [name for name in unique_names if name not in scene_to_category]
+    for name in unmatched:
+        fallback_cat = await _try_fallback_to_parent(db, name)
+        if fallback_cat:
+            scene_to_category[name] = fallback_cat
+            logger.info(
+                f"批量匹配回退到上级分类命中: '{name}' -> '{fallback_cat.name}'"
+            )
+
+    # 4. 收集所有需要的 category_id
     needed_category_ids = [
         scene_to_category[name].id
         for name in unique_names

python-api/app/services/point_service.py

@@ -329,6 +329,7 @@ _CATEGORY_MAP: dict[str, str] = {
     "compose": "压制成片",
     "subtitle_burn": "字幕烧录",
     "cover_design": "封面设计",
+    "cover_avatar": "封面形象",
     "wxpay": "充值",
     "compensation": "充值",
     "invite": "充值",

python-api/app/services/script_service.py

@@ -9,7 +9,7 @@ import time
 from pathlib import Path
 
 from app.ai.model_router import get_model_router
-from app.ai.prompts import load_script_user_prompt, load_system_prompt
+from app.ai.prompts import load_prompt_file, load_script_user_prompt
 from app.schemas.script import ScriptShot
 from app.services.ai_response_utils import (
     safe_parse_ai_json_response,
@@ -38,7 +38,7 @@ class ScriptService:
     async def generate_script(
         self,
         category: str,
-        subcategory: str,
+        filename: str,
         model: str | None = None,
     ) -> list[ScriptShot]:
         """
@@ -46,7 +46,7 @@ class ScriptService:
 
         Args:
             category: 大类代码，如 "bk"
-            subcategory: 小类代码，如 "ht"
+            filename: 提示词文件名，如 "水电改造避坑——水电改造的4个坑.txt"
             model: 指定模型
 
         Returns:
@@ -56,13 +56,13 @@ class ScriptService:
         model_router = await get_model_router()
 
         # 加载 Prompt
-        system_prompt = load_system_prompt(category, subcategory)
+        system_prompt = load_prompt_file(category, filename)
         if not system_prompt:
-            raise ValueError(f"未找到提示词: category={category}, subcategory={subcategory}")
+            raise ValueError(f"未找到提示词: category={category}, filename={filename}")
 
         # 用户提示词
         user_prompt = load_script_user_prompt(
-            topic=f"{category}/{subcategory}",
+            topic=f"{category}/{filename}",
         )
 
         # 调用 AI 生成

python-api/app/services/volcengine_mediakit_service.py

@@ -0,0 +1,89 @@
+"""
+火山引擎 MediaKit Service
+=========================
+
+通过 PlatformGateway 调用 MediaKit 第三方 API，自身负责：
+- 参数校验
+- 结果提取与格式化
+"""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass, field
+from typing import Any
+
+from app.ai.adapters.constants import Method
+from app.platform_gateway import PlatformGateway
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class RemoveBackgroundResult:
+    """抠图结果"""
+
+    image_url: str = ""
+    raw: dict[str, Any] = field(default_factory=dict)
+
+
+class VolcengineMediakitService:
+    """火山引擎 MediaKit 服务封装"""
+
+    # 支持的场景
+    SUPPORTED_SCENES = {"general", "human", "product"}
+
+    def __init__(self, gateway: PlatformGateway):
+        self.gateway = gateway
+
+    async def remove_background(
+        self,
+        image_url: str,
+        scene: str = "human",
+    ) -> RemoveBackgroundResult:
+        """同步抠图
+
+        Args:
+            image_url: 原始图片 URL
+            scene: 场景类型，"general"（通用）、"human"（人物）或 "product"（商品）
+
+        Returns:
+            RemoveBackgroundResult: 包含抠图结果图片 URL
+
+        Raises:
+            ValueError: 参数校验失败
+            PlatformError: 平台调用失败
+        """
+        if not image_url:
+            raise ValueError("image_url 不能为空")
+
+        if scene not in self.SUPPORTED_SCENES:
+            raise ValueError(f"不支持的场景: {scene}，可选: {self.SUPPORTED_SCENES}")
+
+        # 人物/商品场景默认启用白色描边 + 裁剪背景
+        enable_contour = scene in ("human", "product")
+        payload = {
+            "image_url": image_url,
+            "scene": scene,
+            "need_contour": enable_contour,
+            "contour_color": "#FFFFFF",
+            "contour_size": 20,
+            "need_crop_background": enable_contour,
+        }
+
+        response = await self.gateway.call_sync(
+            platform="volcengine_mediakit",
+            method=Method.REMOVE_BACKGROUND,
+            payload=payload,
+        )
+
+        if not response.success:
+            raise RuntimeError(
+                response.error_message or "抠图失败"
+            )
+
+        result_image_url = (response.data or {}).get("image_url", "")
+        return RemoveBackgroundResult(
+            image_url=result_image_url,
+            raw=response.data or {},
+        )

python-api/app/utils/file_validation.py

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

python-api/config/platform-config.yaml

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

python-api/config/points-config.yaml

@@ -24,10 +24,13 @@ fixed_costs:
   voice_clone: 200
 
   # 字幕烧录：将生成的字幕文件烧录到视频中（FFmpeg 合成）
-  subtitle_burn: 2
+  subtitle_burn: 5
 
   # 封面设计：根据视频内容自动生成封面图
-  cover_design: 2
+  cover_design: 5
+
+  # 封面形象：上传人物照片 AI 抠图生成透明背景形象
+  cover_avatar: 10
 
   # 压制成片：将多个素材片段合并为最终视频（FFmpeg 拼接）
   compose: 5
@@ -52,11 +55,11 @@ duration_based_costs:
       # 计算依据：中文正常朗读语速约 200~250 字/分钟，取 240 字/分钟：
       #   60秒 ÷ 240字 = 0.25 秒/字
       # 注意：此为经验值，未经过 Vidu TTS 实测校准。实际时长受标点停顿、
-      #       数字/英文混合、TTS 角色风格等因素影响，误差约 ±20%。
+      # 数字/英文混合、TTS 角色风格等因素影响，误差约 ±20%。
       # TODO: 收集实测数据后校准此值。
       seconds_per_char: 0.25
 
-  # ── 视频生成（对口型）──
+  # ── 视频生成 ──
   # 计费公式：max(min_points, ceil(实际视频秒数) × multiplier)
   # 说明：秒数先向上取整为整数，再乘以 multiplier。不足 1 秒按 1 秒计算。
   # 示例：4.5秒视频 → ceil(4.5) × 1 = 5 积分；0.8秒 → ceil(0.8) × 1 = 1 积分
@@ -66,8 +69,7 @@ duration_based_costs:
 
     # 预估参数（执行业务前检查余额时使用）
     estimation:
-      # 是否直接使用输入素材秒数作为预估上限。
-      # 视频生成时长 = 输入音频/素材时长，因此用 input_seconds 预估最准确。
+      # 视频生成时长 = 输入音频时长，因此用 input_seconds 预估最准确。
       # 调用方需传入 input_seconds 参数。
       use_input_seconds: true
 
@@ -77,10 +79,10 @@ duration_based_costs:
 # 支持积分赠送：points 为实际到账积分数，amount_rmb 为支付金额（分）。
 # label 为空时不显示标签角标。
 recharge_options:
-  - { price: 10000,  points: 2000,   label: "",      validity_days: 180 }
+  - { price: 10000,  points: 2000,   label: "",      validity_days: 90 }
   - { price: 50000,  points: 11000,  label: "热销",  validity_days: 180 }
-  - { price: 100000, points: 23000,  label: "推荐",  validity_days: 365 }
-  - { price: 500000, points: 125000, label: "超值",  validity_days: 0 }
+  - { price: 100000, points: 22500,  label: "推荐",  validity_days: 180 }
+  - { price: 500000, points: 120000, label: "超值",  validity_days: 365 }
 
 
 # ── 免费业务（不扣积分）───────────────────────────────

python-api/deploy-test.sh

@@ -15,6 +15,7 @@ echo "========================================"
 PROJECT_DIR="/opt/meijiaka-zy"
 GIT_REPO="http://git2.haodian.cn/xiaoyu/meijiaka-zy.git"
 API_PORT=8081
+COMPOSE_FILE="docker-compose.test.yml"
 
 # 1. 检查 Docker
 echo "[1/7] 检查 Docker 环境..."
@@ -34,7 +35,8 @@ docker compose version || echo "docker-compose 版本: $(docker-compose --versio
 echo "[2/7] 更新代码..."
 if [ -d "$PROJECT_DIR/.git" ]; then
     cd "$PROJECT_DIR"
-    git pull origin master
+    git fetch origin master
+    git reset --hard origin/master
 else
     git clone "$GIT_REPO" "$PROJECT_DIR"
     cd "$PROJECT_DIR"
@@ -83,12 +85,12 @@ echo "✅ 环境变量检查通过"
 
 # 5. 构建镜像
 echo "[5/7] 构建 Docker 镜像..."
-docker compose -f docker-compose.test.yml build --no-cache
+docker compose -f "$COMPOSE_FILE" build --pull
 
 # 6. 启动服务
 echo "[6/7] 启动服务..."
-docker compose -f docker-compose.test.yml down 2>/dev/null || true
-docker compose -f docker-compose.test.yml up -d
+docker compose -f "$COMPOSE_FILE" down 2>/dev/null || true
+docker compose -f "$COMPOSE_FILE" up -d
 
 # 7. 等待并验证
 echo "[7/7] 等待服务启动..."
@@ -98,6 +100,10 @@ MAX_RETRY=12
 RETRY=0
 while [ $RETRY -lt $MAX_RETRY ]; do
     if curl -s http://localhost:$API_PORT/health | grep -q "healthy"; then
+        # 验证 scheduler 容器也在运行
+        if ! docker ps --filter "name=meijiaka-zy-scheduler" --filter "status=running" -q | grep -q .; then
+            echo "⚠️  API 已就绪，但 scheduler 容器未运行，请检查日志"
+        fi
         echo ""
         echo "========================================"
         echo "  ✅ 测试服部署成功！"
@@ -114,8 +120,8 @@ while [ $RETRY -lt $MAX_RETRY ]; do
         echo ""
         echo "  常用命令:"
         echo "    cd $PROJECT_DIR/python-api"
-        echo "    docker compose -f docker-compose.test.yml logs -f"
-        echo "    docker compose -f docker-compose.test.yml restart api"
+        echo "    docker compose -f $COMPOSE_FILE logs -f"
+        echo "    docker compose -f $COMPOSE_FILE restart api"
         echo "========================================"
         exit 0
     fi

python-api/docker-compose.dev.yml

@@ -31,7 +31,7 @@ services:
       - ~/Documents/Meijiaka-zy:/root/Documents/Meijiaka-zy
     ports:
       - "8081:8000"
-    command: uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
+    command: uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload --no-access-log
     networks:
       - meijiaka-network
 

python-api/docker-compose.prod.yml

@@ -34,7 +34,7 @@ services:
     volumes:
       # 仅持久化日志到宿主机，其他数据走对象存储
       - /opt/meijiaka-zy/logs:/root/Documents/Meijiaka-zy/logs
-    command: alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000
+    command: alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000 --no-access-log
     ports:
       - "8000:8000"
     restart: unless-stopped

python-api/docker-compose.test.yml

@@ -68,7 +68,7 @@ services:
       redis:
         condition: service_healthy
     command: >
-      sh -c "alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000"
+      sh -c "alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000 --no-access-log"
     networks:
       - meijiaka-zy
     restart: unless-stopped

python-api/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "meijiaka-ai-api"
-version = "1.5.18"
+version = "1.8.0"
 description = "美家卡智影 - AI 视频创作后端 API"
 authors = [{ name = "Meijiaka Team" }]
 readme = "README.md"
@@ -61,6 +61,9 @@ dependencies = [
 
     # 音频时长探测（TTS 扣费用）
     "mutagen~=1.47.0",
+
+    # 图像处理（智能抠图合成封面）
+    "Pillow>=11.0.0",
 ]
 
 [project.optional-dependencies]

python-api/scripts/import_bgm.py

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

python-api/scripts/publish_release.py

@@ -24,6 +24,9 @@ import sys
 from pathlib import Path
 
 import httpx
+from dotenv import load_dotenv
+
+load_dotenv()
 
 
 def find_packages(bundle_dir: Path) -> list[dict]:
@@ -37,21 +40,30 @@ def find_packages(bundle_dir: Path) -> list[dict]:
             print(f"警告: 签名文件存在但安装包缺失: {pkg_file}")
             continue
 
-        # 解析文件名：{name}_{version}_{target}_{arch}.app.tar.gz
-        parts = pkg_file.stem.split("_")
-        # 最后一个部分可能是 arch，需要处理
-        arch = "aarch64" if "aarch64" in pkg_file.name or "arm64" in pkg_file.name else "x86_64"
-
         signature = sig_file.read_text().strip()
+        file_size = pkg_file.stat().st_size
+        filename = pkg_file.name
 
-        packages.append({
-            "platform": "darwin",
-            "architecture": arch,
-            "filename": pkg_file.name,
-            "local_path": str(pkg_file),
-            "signature": signature,
-            "file_size": pkg_file.stat().st_size,
-        })
+        # 判断文件名是否包含架构标识
+        has_arch_marker = any(marker in filename for marker in ["aarch64", "arm64", "x86_64"])
+
+        if has_arch_marker:
+            # 文件名含架构标识，按标识解析
+            arch = "aarch64" if "aarch64" in filename or "arm64" in filename else "x86_64"
+            archs = [arch]
+        else:
+            # Universal Binary：同时支持 x86_64 和 aarch64
+            archs = ["x86_64", "aarch64"]
+
+        for arch in archs:
+            packages.append({
+                "platform": "darwin",
+                "architecture": arch,
+                "filename": filename,
+                "local_path": str(pkg_file),
+                "signature": signature,
+                "file_size": file_size,
+            })
 
     # Windows: .exe + .exe.sig
     for sig_file in bundle_dir.rglob("*.exe.sig"):
@@ -93,6 +105,29 @@ def find_packages(bundle_dir: Path) -> list[dict]:
             "file_size": pkg_file.stat().st_size,
         })
 
+    # macOS DMG: 给新用户首次安装用（无签名文件）
+    for dmg_file in bundle_dir.rglob("*.dmg"):
+        filename = dmg_file.name
+
+        # 判断文件名是否包含架构标识
+        has_arch_marker = any(marker in filename for marker in ["aarch64", "arm64", "x86_64"])
+        if has_arch_marker:
+            arch = "aarch64" if "aarch64" in filename or "arm64" in filename else "x86_64"
+            archs = [arch]
+        else:
+            # Universal DMG：同时支持 x86_64 和 aarch64
+            archs = ["x86_64", "aarch64"]
+
+        for arch in archs:
+            packages.append({
+                "platform": "darwin",
+                "architecture": arch,
+                "filename": filename,
+                "local_path": str(dmg_file),
+                "signature": "",  # DMG 无签名（非 updater 包）
+                "file_size": dmg_file.stat().st_size,
+            })
+
     return packages
 
 
@@ -165,16 +200,21 @@ def main():
         print(f"  - {p['platform']}-{p['architecture']}: {p['filename']} ({p['file_size'] / 1024 / 1024:.1f} MB)")
 
     # 2. 上传到七牛云（或构造 URL）
+    # 按 local_path 去重，同一个文件只上传一次
+    uploaded = {}  # local_path -> file_url
     for p in packages:
         if args.skip_upload:
             if not args.base_url:
                 print("错误: --skip-upload 时必须提供 --base-url")
                 sys.exit(1)
-            p["file_url"] = f"{args.base_url.rstrip('/')}/{p['filename']}"
+            p["file_url"] = f"{args.base_url.rstrip('/')}/{p['platform']}/{p['filename']}"
         else:
-            key = f"releases/{args.version}/{p['filename']}"
-            print(f"上传 {p['filename']} 到七牛云...")
-            p["file_url"] = upload_to_qiniu(p["local_path"], key)
+            local_path = p["local_path"]
+            if local_path not in uploaded:
+                key = f"meijiaka-zy/releases/{args.version}/{p['platform']}/{p['filename']}"
+                print(f"上传 {p['filename']} ({p['platform']}) 到七牛云...")
+                uploaded[local_path] = upload_to_qiniu(local_path, key)
+            p["file_url"] = uploaded[local_path]
 
         # 删除临时字段
         del p["local_path"]

python-api/scripts/seed_bgm.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+"""
+BGM 种子数据导入脚本
+==================
+
+用于部署环境初始化 BGM 数据。读取同目录下的 bgm_seed_data.json，
+将 129 首系统背景音乐的元数据（含七牛云 URL）写入数据库。
+
+执行方式（在 API 容器内）:
+    python scripts/seed_bgm.py
+
+环境变量依赖:
+    DATABASE_URL — 同应用配置，容器启动时已注入
+"""
+
+import asyncio
+import json
+import os
+import sys
+from pathlib import Path
+
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root))
+
+from dotenv import load_dotenv
+
+load_dotenv()
+
+from sqlalchemy import select, func
+from app.db.session import AsyncSessionLocal
+from app.models.bgm_music import BgmMusic
+
+
+SEED_FILE = Path(__file__).parent / "bgm_seed_data.json"
+
+
+async def seed_bgm():
+    if not SEED_FILE.exists():
+        print(f"错误: 种子数据文件不存在: {SEED_FILE}")
+        return
+
+    with open(SEED_FILE, "r", encoding="utf-8") as f:
+        data = json.load(f)
+
+    async with AsyncSessionLocal() as session:
+        # 检查是否已有数据
+        count = await session.scalar(select(func.count(BgmMusic.id)))
+        if count and count > 0:
+            print(f"数据库中已有 {count} 条 BGM 记录，跳过导入")
+            print("如需强制重新导入，请先清空 mjk_bgm_musics 表")
+            return
+
+        for idx, item in enumerate(data):
+            bgm = BgmMusic(
+                title=item["title"],
+                artist=item.get("artist"),
+                category=item["category"],
+                file_path=item["file_path"],
+                url=item["url"],
+                duration=item.get("duration"),
+                status=item.get("status", "active"),
+                sort_order=item.get("sort_order", idx),
+            )
+            session.add(bgm)
+
+        await session.commit()
+        print(f"种子数据导入完成，共 {len(data)} 首")
+
+
+if __name__ == "__main__":
+    asyncio.run(seed_bgm())

python-api/uv.lock

@@ -944,7 +944,7 @@ wheels = [
 
 [[package]]
 name = "meijiaka-ai-api"
-version = "1.5.18"
+version = "1.8.0"
 source = { virtual = "." }
 dependencies = [
     { name = "aiohttp" },
@@ -957,6 +957,7 @@ dependencies = [
     { name = "openai" },
     { name = "orjson" },
     { name = "passlib", extra = ["bcrypt"] },
+    { name = "pillow" },
     { name = "psycopg2-binary" },
     { name = "pydantic" },
     { name = "pydantic-settings" },
@@ -999,6 +1000,7 @@ requires-dist = [
     { name = "openai", specifier = "~=1.58.0" },
     { name = "orjson", specifier = ">=3.11.0" },
     { name = "passlib", extras = ["bcrypt"], specifier = "~=1.7.4" },
+    { name = "pillow", specifier = ">=11.0.0" },
     { name = "pip-audit", marker = "extra == 'dev'", specifier = "~=2.7.0" },
     { name = "pre-commit", marker = "extra == 'dev'", specifier = "~=4.0.0" },
     { name = "psycopg2-binary", specifier = "~=2.9.10" },
@@ -1280,6 +1282,64 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ef/3c/2c197d226f9ea224a9ab8d197933f9da0ae0aac5b6e0f884e2b8d9c8e9f7/pathspec-1.0.4-py3-none-any.whl", hash = "sha256:fb6ae2fd4e7c921a165808a552060e722767cfa526f99ca5156ed2ce45a5c723", size = 55206, upload-time = "2026-01-27T03:59:45.137Z" },
 ]
 
+[[package]]
+name = "pillow"
+version = "12.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/21/c2bcdd5906101a30244eaffc1b6e6ce71a31bd0742a01eb89e660ebfac2d/pillow-12.2.0.tar.gz", hash = "sha256:a830b1a40919539d07806aa58e1b114df53ddd43213d9c8b75847eee6c0182b5", size = 46987819, upload-time = "2026-04-01T14:46:17.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/4a/01/53d10cf0dbad820a8db274d259a37ba50b88b24768ddccec07355382d5ad/pillow-12.2.0-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:8297651f5b5679c19968abefd6bb84d95fe30ef712eb1b2d9b2d31ca61267f4c", size = 4100837, upload-time = "2026-04-01T14:43:41.506Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/98/f3a6657ecb698c937f6c76ee564882945f29b79bad496abcba0e84659ec5/pillow-12.2.0-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:50d8520da2a6ce0af445fa6d648c4273c3eeefbc32d7ce049f22e8b5c3daecc2", size = 4176528, upload-time = "2026-04-01T14:43:43.773Z" },
+    { url = "https://files.pythonhosted.org/packages/69/bc/8986948f05e3ea490b8442ea1c1d4d990b24a7e43d8a51b2c7d8b1dced36/pillow-12.2.0-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:766cef22385fa1091258ad7e6216792b156dc16d8d3fa607e7545b2b72061f1c", size = 3640401, upload-time = "2026-04-01T14:43:45.87Z" },
+    { url = "https://files.pythonhosted.org/packages/34/46/6c717baadcd62bc8ed51d238d521ab651eaa74838291bda1f86fe1f864c9/pillow-12.2.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5d2fd0fa6b5d9d1de415060363433f28da8b1526c1c129020435e186794b3795", size = 5308094, upload-time = "2026-04-01T14:43:48.438Z" },
+    { url = "https://files.pythonhosted.org/packages/71/43/905a14a8b17fdb1ccb58d282454490662d2cb89a6bfec26af6d3520da5ec/pillow-12.2.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:56b25336f502b6ed02e889f4ece894a72612fe885889a6e8c4c80239ff6e5f5f", size = 4695402, upload-time = "2026-04-01T14:43:51.292Z" },
+    { url = "https://files.pythonhosted.org/packages/73/dd/42107efcb777b16fa0393317eac58f5b5cf30e8392e266e76e51cff28c3d/pillow-12.2.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:f1c943e96e85df3d3478f7b691f229887e143f81fedab9b20205349ab04d73ed", size = 6280005, upload-time = "2026-04-01T14:43:54.242Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/68/b93e09e5e8549019e61acf49f65b1a8530765a7f812c77a7461bca7e4494/pillow-12.2.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:03f6fab9219220f041c74aeaa2939ff0062bd5c364ba9ce037197f4c6d498cd9", size = 8090669, upload-time = "2026-04-01T14:43:57.335Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/6e/3ccb54ce8ec4ddd1accd2d89004308b7b0b21c4ac3d20fa70af4760a4330/pillow-12.2.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5cdfebd752ec52bf5bb4e35d9c64b40826bc5b40a13df7c3cda20a2c03a0f5ed", size = 6395194, upload-time = "2026-04-01T14:43:59.864Z" },
+    { url = "https://files.pythonhosted.org/packages/67/ee/21d4e8536afd1a328f01b359b4d3997b291ffd35a237c877b331c1c3b71c/pillow-12.2.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:eedf4b74eda2b5a4b2b2fb4c006d6295df3bf29e459e198c90ea48e130dc75c3", size = 7082423, upload-time = "2026-04-01T14:44:02.74Z" },
+    { url = "https://files.pythonhosted.org/packages/78/5f/e9f86ab0146464e8c133fe85df987ed9e77e08b29d8d35f9f9f4d6f917ba/pillow-12.2.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:00a2865911330191c0b818c59103b58a5e697cae67042366970a6b6f1b20b7f9", size = 6505667, upload-time = "2026-04-01T14:44:05.381Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/1e/409007f56a2fdce61584fd3acbc2bbc259857d555196cedcadc68c015c82/pillow-12.2.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1e1757442ed87f4912397c6d35a0db6a7b52592156014706f17658ff58bbf795", size = 7208580, upload-time = "2026-04-01T14:44:08.39Z" },
+    { url = "https://files.pythonhosted.org/packages/23/c4/7349421080b12fb35414607b8871e9534546c128a11965fd4a7002ccfbee/pillow-12.2.0-cp313-cp313-win32.whl", hash = "sha256:144748b3af2d1b358d41286056d0003f47cb339b8c43a9ea42f5fea4d8c66b6e", size = 6375896, upload-time = "2026-04-01T14:44:11.197Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/82/8a3739a5e470b3c6cbb1d21d315800d8e16bff503d1f16b03a4ec3212786/pillow-12.2.0-cp313-cp313-win_amd64.whl", hash = "sha256:390ede346628ccc626e5730107cde16c42d3836b89662a115a921f28440e6a3b", size = 7081266, upload-time = "2026-04-01T14:44:13.947Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/25/f968f618a062574294592f668218f8af564830ccebdd1fa6200f598e65c5/pillow-12.2.0-cp313-cp313-win_arm64.whl", hash = "sha256:8023abc91fba39036dbce14a7d6535632f99c0b857807cbbbf21ecc9f4717f06", size = 2463508, upload-time = "2026-04-01T14:44:16.312Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/a4/b342930964e3cb4dce5038ae34b0eab4653334995336cd486c5a8c25a00c/pillow-12.2.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:042db20a421b9bafecc4b84a8b6e444686bd9d836c7fd24542db3e7df7baad9b", size = 5309927, upload-time = "2026-04-01T14:44:18.89Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/de/23198e0a65a9cf06123f5435a5d95cea62a635697f8f03d134d3f3a96151/pillow-12.2.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:dd025009355c926a84a612fecf58bb315a3f6814b17ead51a8e48d3823d9087f", size = 4698624, upload-time = "2026-04-01T14:44:21.115Z" },
+    { url = "https://files.pythonhosted.org/packages/01/a6/1265e977f17d93ea37aa28aa81bad4fa597933879fac2520d24e021c8da3/pillow-12.2.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:88ddbc66737e277852913bd1e07c150cc7bb124539f94c4e2df5344494e0a612", size = 6321252, upload-time = "2026-04-01T14:44:23.663Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/83/5982eb4a285967baa70340320be9f88e57665a387e3a53a7f0db8231a0cd/pillow-12.2.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d362d1878f00c142b7e1a16e6e5e780f02be8195123f164edf7eddd911eefe7c", size = 8126550, upload-time = "2026-04-01T14:44:26.772Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/48/6ffc514adce69f6050d0753b1a18fd920fce8cac87620d5a31231b04bfc5/pillow-12.2.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2c727a6d53cb0018aadd8018c2b938376af27914a68a492f59dfcaca650d5eea", size = 6433114, upload-time = "2026-04-01T14:44:29.615Z" },
+    { url = "https://files.pythonhosted.org/packages/36/a3/f9a77144231fb8d40ee27107b4463e205fa4677e2ca2548e14da5cf18dce/pillow-12.2.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:efd8c21c98c5cc60653bcb311bef2ce0401642b7ce9d09e03a7da87c878289d4", size = 7115667, upload-time = "2026-04-01T14:44:32.773Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/fc/ac4ee3041e7d5a565e1c4fd72a113f03b6394cc72ab7089d27608f8aaccb/pillow-12.2.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9f08483a632889536b8139663db60f6724bfcb443c96f1b18855860d7d5c0fd4", size = 6538966, upload-time = "2026-04-01T14:44:35.252Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/a8/27fb307055087f3668f6d0a8ccb636e7431d56ed0750e07a60547b1e083e/pillow-12.2.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:dac8d77255a37e81a2efcbd1fc05f1c15ee82200e6c240d7e127e25e365c39ea", size = 7238241, upload-time = "2026-04-01T14:44:37.875Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/4b/926ab182c07fccae9fcb120043464e1ff1564775ec8864f21a0ebce6ac25/pillow-12.2.0-cp313-cp313t-win32.whl", hash = "sha256:ee3120ae9dff32f121610bb08e4313be87e03efeadfc6c0d18f89127e24d0c24", size = 6379592, upload-time = "2026-04-01T14:44:40.336Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/c4/f9e476451a098181b30050cc4c9a3556b64c02cf6497ea421ac047e89e4b/pillow-12.2.0-cp313-cp313t-win_amd64.whl", hash = "sha256:325ca0528c6788d2a6c3d40e3568639398137346c3d6e66bb61db96b96511c98", size = 7085542, upload-time = "2026-04-01T14:44:43.251Z" },
+    { url = "https://files.pythonhosted.org/packages/00/a4/285f12aeacbe2d6dc36c407dfbbe9e96d4a80b0fb710a337f6d2ad978c75/pillow-12.2.0-cp313-cp313t-win_arm64.whl", hash = "sha256:2e5a76d03a6c6dcef67edabda7a52494afa4035021a79c8558e14af25313d453", size = 2465765, upload-time = "2026-04-01T14:44:45.996Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/98/4595daa2365416a86cb0d495248a393dfc84e96d62ad080c8546256cb9c0/pillow-12.2.0-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:3adc9215e8be0448ed6e814966ecf3d9952f0ea40eb14e89a102b87f450660d8", size = 4100848, upload-time = "2026-04-01T14:44:48.48Z" },
+    { url = "https://files.pythonhosted.org/packages/0b/79/40184d464cf89f6663e18dfcf7ca21aae2491fff1a16127681bf1fa9b8cf/pillow-12.2.0-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:6a9adfc6d24b10f89588096364cc726174118c62130c817c2837c60cf08a392b", size = 4176515, upload-time = "2026-04-01T14:44:51.353Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/63/703f86fd4c422a9cf722833670f4f71418fb116b2853ff7da722ea43f184/pillow-12.2.0-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:6a6e67ea2e6feda684ed370f9a1c52e7a243631c025ba42149a2cc5934dec295", size = 3640159, upload-time = "2026-04-01T14:44:53.588Z" },
+    { url = "https://files.pythonhosted.org/packages/71/e0/fb22f797187d0be2270f83500aab851536101b254bfa1eae10795709d283/pillow-12.2.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:2bb4a8d594eacdfc59d9e5ad972aa8afdd48d584ffd5f13a937a664c3e7db0ed", size = 5312185, upload-time = "2026-04-01T14:44:56.039Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/8c/1a9e46228571de18f8e28f16fabdfc20212a5d019f3e3303452b3f0a580d/pillow-12.2.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:80b2da48193b2f33ed0c32c38140f9d3186583ce7d516526d462645fd98660ae", size = 4695386, upload-time = "2026-04-01T14:44:58.663Z" },
+    { url = "https://files.pythonhosted.org/packages/70/62/98f6b7f0c88b9addd0e87c217ded307b36be024d4ff8869a812b241d1345/pillow-12.2.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:22db17c68434de69d8ecfc2fe821569195c0c373b25cccb9cbdacf2c6e53c601", size = 6280384, upload-time = "2026-04-01T14:45:01.5Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/03/688747d2e91cfbe0e64f316cd2e8005698f76ada3130d0194664174fa5de/pillow-12.2.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7b14cc0106cd9aecda615dd6903840a058b4700fcb817687d0ee4fc8b6e389be", size = 8091599, upload-time = "2026-04-01T14:45:04.5Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/35/577e22b936fcdd66537329b33af0b4ccfefaeabd8aec04b266528cddb33c/pillow-12.2.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8cbeb542b2ebc6fcdacabf8aca8c1a97c9b3ad3927d46b8723f9d4f033288a0f", size = 6396021, upload-time = "2026-04-01T14:45:07.117Z" },
+    { url = "https://files.pythonhosted.org/packages/11/8d/d2532ad2a603ca2b93ad9f5135732124e57811d0168155852f37fbce2458/pillow-12.2.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4bfd07bc812fbd20395212969e41931001fd59eb55a60658b0e5710872e95286", size = 7083360, upload-time = "2026-04-01T14:45:09.763Z" },
+    { url = "https://files.pythonhosted.org/packages/5e/26/d325f9f56c7e039034897e7380e9cc202b1e368bfd04d4cbe6a441f02885/pillow-12.2.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:9aba9a17b623ef750a4d11b742cbafffeb48a869821252b30ee21b5e91392c50", size = 6507628, upload-time = "2026-04-01T14:45:12.378Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/f7/769d5632ffb0988f1c5e7660b3e731e30f7f8ec4318e94d0a5d674eb65a4/pillow-12.2.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:deede7c263feb25dba4e82ea23058a235dcc2fe1f6021025dc71f2b618e26104", size = 7209321, upload-time = "2026-04-01T14:45:15.122Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/7a/c253e3c645cd47f1aceea6a8bacdba9991bf45bb7dfe927f7c893e89c93c/pillow-12.2.0-cp314-cp314-win32.whl", hash = "sha256:632ff19b2778e43162304d50da0181ce24ac5bb8180122cbe1bf4673428328c7", size = 6479723, upload-time = "2026-04-01T14:45:17.797Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/8b/601e6566b957ca50e28725cb6c355c59c2c8609751efbecd980db44e0349/pillow-12.2.0-cp314-cp314-win_amd64.whl", hash = "sha256:4e6c62e9d237e9b65fac06857d511e90d8461a32adcc1b9065ea0c0fa3a28150", size = 7217400, upload-time = "2026-04-01T14:45:20.529Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/94/220e46c73065c3e2951bb91c11a1fb636c8c9ad427ac3ce7d7f3359b9b2f/pillow-12.2.0-cp314-cp314-win_arm64.whl", hash = "sha256:b1c1fbd8a5a1af3412a0810d060a78b5136ec0836c8a4ef9aa11807f2a22f4e1", size = 2554835, upload-time = "2026-04-01T14:45:23.162Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/ab/1b426a3974cb0e7da5c29ccff4807871d48110933a57207b5a676cccc155/pillow-12.2.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:57850958fe9c751670e49b2cecf6294acc99e562531f4bd317fa5ddee2068463", size = 5314225, upload-time = "2026-04-01T14:45:25.637Z" },
+    { url = "https://files.pythonhosted.org/packages/19/1e/dce46f371be2438eecfee2a1960ee2a243bbe5e961890146d2dee1ff0f12/pillow-12.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:d5d38f1411c0ed9f97bcb49b7bd59b6b7c314e0e27420e34d99d844b9ce3b6f3", size = 4698541, upload-time = "2026-04-01T14:45:28.355Z" },
+    { url = "https://files.pythonhosted.org/packages/55/c3/7fbecf70adb3a0c33b77a300dc52e424dc22ad8cdc06557a2e49523b703d/pillow-12.2.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5c0a9f29ca8e79f09de89293f82fc9b0270bb4af1d58bc98f540cc4aedf03166", size = 6322251, upload-time = "2026-04-01T14:45:30.924Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/3c/7fbc17cfb7e4fe0ef1642e0abc17fc6c94c9f7a16be41498e12e2ba60408/pillow-12.2.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:1610dd6c61621ae1cf811bef44d77e149ce3f7b95afe66a4512f8c59f25d9ebe", size = 8127807, upload-time = "2026-04-01T14:45:33.908Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/c3/a8ae14d6defd2e448493ff512fae903b1e9bd40b72efb6ec55ce0048c8ce/pillow-12.2.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0a34329707af4f73cf1782a36cd2289c0368880654a2c11f027bcee9052d35dd", size = 6433935, upload-time = "2026-04-01T14:45:36.623Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/32/2880fb3a074847ac159d8f902cb43278a61e85f681661e7419e6596803ed/pillow-12.2.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8e9c4f5b3c546fa3458a29ab22646c1c6c787ea8f5ef51300e5a60300736905e", size = 7116720, upload-time = "2026-04-01T14:45:39.258Z" },
+    { url = "https://files.pythonhosted.org/packages/46/87/495cc9c30e0129501643f24d320076f4cc54f718341df18cc70ec94c44e1/pillow-12.2.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fb043ee2f06b41473269765c2feae53fc2e2fbf96e5e22ca94fb5ad677856f06", size = 6540498, upload-time = "2026-04-01T14:45:41.879Z" },
+    { url = "https://files.pythonhosted.org/packages/18/53/773f5edca692009d883a72211b60fdaf8871cbef075eaa9d577f0a2f989e/pillow-12.2.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f278f034eb75b4e8a13a54a876cc4a5ab39173d2cdd93a638e1b467fc545ac43", size = 7239413, upload-time = "2026-04-01T14:45:44.705Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/e4/4b64a97d71b2a83158134abbb2f5bd3f8a2ea691361282f010998f339ec7/pillow-12.2.0-cp314-cp314t-win32.whl", hash = "sha256:6bb77b2dcb06b20f9f4b4a8454caa581cd4dd0643a08bacf821216a16d9c8354", size = 6482084, upload-time = "2026-04-01T14:45:47.568Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/13/306d275efd3a3453f72114b7431c877d10b1154014c1ebbedd067770d629/pillow-12.2.0-cp314-cp314t-win_amd64.whl", hash = "sha256:6562ace0d3fb5f20ed7290f1f929cae41b25ae29528f2af1722966a0a02e2aa1", size = 7225152, upload-time = "2026-04-01T14:45:50.032Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/6e/cf826fae916b8658848d7b9f38d88da6396895c676e8086fc0988073aaf8/pillow-12.2.0-cp314-cp314t-win_arm64.whl", hash = "sha256:aa88ccfe4e32d362816319ed727a004423aab09c5cea43c01a4b435643fa34eb", size = 2556579, upload-time = "2026-04-01T14:45:52.529Z" },
+]
+
 [[package]]
 name = "pip"
 version = "26.0.1"

scripts/add_new_material_categories.sql

@@ -0,0 +1,127 @@
+-- 新增素材分类 SQL（2025-06-03）
+-- 文件1：新房装修流程（4 个分类）+ 文件2：装备材料选择（44 个分类）
+
+DO $$
+DECLARE
+    l1_cailiao_id bigint;
+    l2_fengchuang_id bigint;
+    l2_zhanshi_id bigint;
+BEGIN
+    -- ====================== 文件1：新房装修流程 ======================
+
+    -- 二级：封窗镜（拆改改造类下，sort_order=4）
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('chaigai-fengchuang', '封窗镜', 46, 2, 4, 'active', NOW(), NOW())
+    RETURNING id INTO l2_fengchuang_id;
+
+    -- 三级：封窗施工-封窗镜
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('chaigai-fengchuang-fcsg', '封窗施工-封窗镜', l2_fengchuang_id, 3, 1, 'active', NOW(), NOW());
+
+    -- 三级：装烟机灶具-主材安装镜（parent_id=189 主材安装镜，sort_order=9）
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('anzhuang-zhucai-zyjzj', '装烟机灶具-主材安装镜', 189, 3, 9, 'active', NOW(), NOW());
+
+    -- 三级：家具进场摆放就位-软装进场镜（parent_id=219 软装进场镜，sort_order=2）
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('ruanzhuang-ruanchang-jjjcbfjw', '家具进场摆放就位-软装进场镜', 219, 3, 2, 'active', NOW(), NOW());
+
+    -- ====================== 文件2：装备材料选择 ======================
+
+    -- 一级：装修材料选择（sort_order=90）
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao', '装修材料选择', NULL, 1, 90, 'active', NOW(), NOW())
+    RETURNING id INTO l1_cailiao_id;
+
+    -- 二级：材料展示
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi', '材料展示', l1_cailiao_id, 2, 1, 'active', NOW(), NOW())
+    RETURNING id INTO l2_zhanshi_id;
+
+    -- 三级：XX买谁家 + 品牌组合（42 个）
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-bxmsj', '冰箱买谁家', l2_zhanshi_id, 3, 1, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-dsmsj', '电视买谁家', l2_zhanshi_id, 3, 2, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-hsj', '花洒哪家好', l2_zhanshi_id, 3, 3, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-dxmsj', '电线买谁家', l2_zhanshi_id, 3, 4, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-yjj', '烟机哪家好', l2_zhanshi_id, 3, 5, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-rjqmsj', '乳胶漆买谁家', l2_zhanshi_id, 3, 6, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-kgczmsj', '开关插座买谁家', l2_zhanshi_id, 3, 7, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-czj', '瓷砖哪家好', l2_zhanshi_id, 3, 8, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-sgmsj', '水管买谁家', l2_zhanshi_id, 3, 9, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-bcxsj', '板材选谁家', l2_zhanshi_id, 3, 10, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-fsmsj', '防水买谁家', l2_zhanshi_id, 3, 11, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-ddxsj', '吊顶选谁家', l2_zhanshi_id, 3, 12, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-dbj', '地板哪家好', l2_zhanshi_id, 3, 13, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-nzfj', '腻子粉哪家好', l2_zhanshi_id, 3, 14, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-dlsj', '地漏谁家好', l2_zhanshi_id, 3, 15, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-jzsgsj', '家装水管谁家好', l2_zhanshi_id, 3, 16, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-jzsnsj', '家装水泥谁家好', l2_zhanshi_id, 3, 17, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-cwwjsj', '厨卫五金谁家好', l2_zhanshi_id, 3, 18, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-sgbsj', '石膏板谁家好', l2_zhanshi_id, 3, 19, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-czjsj', '瓷砖胶谁家好', l2_zhanshi_id, 3, 20, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-bljsj', '玻璃胶谁家好', l2_zhanshi_id, 3, 21, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-hemdksd', '海尔美的卡萨帝', l2_zhanshi_id, 3, 22, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-snhxtcl', '索尼海信TCL', l2_zhanshi_id, 3, 23, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-jmhjjp', '九牧恒洁箭牌', l2_zhanshi_id, 3, 24, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-ydbsxm', '远东宝胜熊猫', l2_zhanshi_id, 3, 25, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-ftlbhd', '方太老板华帝', l2_zhanshi_id, 3, 26, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-lbsksdls', '立邦三棵树多乐士', l2_zhanshi_id, 3, 27, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-gnsndxmz', '公牛施耐德西门子', l2_zhanshi_id, 3, 28, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-dpgzmkbl', '东鹏冠珠马可波罗', l2_zhanshi_id, 3, 29, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-rfwxbl', '日丰伟星保利', l2_zhanshi_id, 3, 30, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-whagtbb', '万华爱格兔宝宝', l2_zhanshi_id, 3, 31, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-lbdgdfyh', '立邦德高东方雨虹', l2_zhanshi_id, 3, 32, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-apybfsl', '奥普友邦法狮龙', l2_zhanshi_id, 3, 33, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-sxsydzr', '圣象世友大自然', l2_zhanshi_id, 3, 34, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-lbmcsgb', '立邦美巢圣戈邦', l2_zhanshi_id, 3, 35, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-jmjpqst', '九牧箭牌潜水艇', l2_zhanshi_id, 3, 36, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-jnwxrf', '金牛伟星日丰', l2_zhanshi_id, 3, 37, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-hlhszl', '海螺红狮中联', l2_zhanshi_id, 3, 38, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-kljmhsgy', '科勒九牧汉斯格雅', l2_zhanshi_id, 3, 39, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-lptsknf', '龙牌泰山可耐福', l2_zhanshi_id, 3, 40, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-dgxkm', '德高西卡马贝', l2_zhanshi_id, 3, 41, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('cailiao-zhanshi-wkxkbd', '瓦克西卡百得', l2_zhanshi_id, 3, 42, 'active', NOW(), NOW());
+
+END $$;

scripts/admin-ops.sql

@@ -11,11 +11,11 @@
 
 DO $$
 DECLARE
-    v_mobile       TEXT := '13800138000';     -- ← 修改：手机号
-    v_nickname     TEXT := '新用户昵称';        -- ← 修改：昵称（可为空）
+    v_mobile       TEXT := '15359215971';     -- ← 修改：手机号
+    v_nickname     TEXT := '家迪装饰';        -- ← 修改：昵称（可为空）
     v_source       TEXT := 'manual';           -- ← 修改：注册来源：manual / invite / promotion
     v_invited_by   UUID := NULL;               -- ← 修改：邀请人 user_id（没有则留 NULL）
-    v_gift_points  INT  := 2000;                -- ← 修改：赠送初始积分（0 表示不赠送）
+    v_gift_points  INT  := 10000;                -- ← 修改：赠送初始积分（0 表示不赠送）
     v_gift_days    INT  := 365;                -- ← 修改：赠送积分有效期（天）
     v_user_id      UUID;
     v_batch_id     BIGINT;
@@ -108,8 +108,8 @@ END $$;
 
 DO $$
 DECLARE
-    v_mobile       TEXT := '13800138000';     -- ← 修改：目标用户手机号
-    v_gift_points  INT  := 500;                -- ← 修改：赠送积分数量
+    v_mobile       TEXT := '18750556093';     -- ← 修改：目标用户手机号
+    v_gift_points  INT  := 5000;                -- ← 修改：赠送积分数量
     v_gift_days    INT  := 180;                -- ← 修改：有效期（天）
     v_reason       TEXT := '运营活动赠送';       -- ← 修改：赠送原因（写入流水描述）
     v_user_id      UUID;

scripts/batch_upload_qiniu.py

@@ -0,0 +1,50 @@
+import os
+import sys
+from pathlib import Path
+from dotenv import load_dotenv
+from qiniu import Auth, put_file
+
+# 加载环境变量
+env_path = Path(__file__).resolve().parent.parent / 'python-api' / '.env'
+load_dotenv(env_path)
+
+access_key = os.getenv('QINIU_ACCESS_KEY')
+secret_key = os.getenv('QINIU_SECRET_KEY')
+bucket = os.getenv('QINIU_VIDEO_BUCKET', 'media-liche')
+domain = os.getenv('QINIU_VIDEO_DOMAIN', 'media.liche.cn')
+
+if not access_key or not secret_key:
+    print("错误: 未找到七牛云凭证，请检查 .env 文件")
+    sys.exit(1)
+
+q = Auth(access_key, secret_key)
+src_dir = Path('/Users/0fun/Downloads/新增素材6.2')
+
+total = 0
+success = 0
+failed = 0
+
+files = sorted([p for p in src_dir.rglob('*.mp4') if not p.name.startswith('._') and '.DS_Store' not in str(p)])
+
+print(f"发现 {len(files)} 个 MP4 文件，开始上传...\n")
+
+for mp4_path in files:
+    total += 1
+    key = f"meijiaka-zy/materials/{mp4_path.name}"
+
+    try:
+        token = q.upload_token(bucket, key, 3600)
+        ret, info = put_file(token, key, str(mp4_path))
+        if ret is not None:
+            url = f"https://{domain}/{key}"
+            print(f"✅ [{total}/{len(files)}] {mp4_path.name}")
+            success += 1
+        else:
+            print(f"❌ [{total}/{len(files)}] {mp4_path.name} → 失败: {info}")
+            failed += 1
+    except Exception as e:
+        print(f"❌ [{total}/{len(files)}] {mp4_path.name} → 异常: {e}")
+        failed += 1
+
+print(f"\n{'=' * 50}")
+print(f"总计: {total}, 成功: {success}, 失败: {failed}")