bump version to 1.8.2

避免'扣避坑'/'抠避坑'等表达被平台判定为敏感词。

.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
@@ -121,6 +123,8 @@ jobs:
     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

.gitignore

@@ -31,3 +31,5 @@ tauri-app/src-tauri/binaries/*
 *test*.key*
 .atomcode/
 mixkit_bgm/
+*.exe
+*.exe.sig

AGENTS.md

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

VERSION

@@ -1 +1 @@
-1.6.0
+1.8.2

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/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.2
 # ⚠️ 生产环境必须设为 false
 DEBUG=true
 ENV=development
@@ -79,4 +79,4 @@ SMS_BASE_URL=https://bjksmtn.b2m.cn/inter/sendSingleSMS
 
 # === 日志配置 ===
 # 生产环境建议 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/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/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/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/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

@@ -9,7 +9,7 @@
 【核心强制规则】
 开头范式：保留原文完整开头结构与核心原意，仅微调口语语气，不篡改句意，直击全屋定制合同签完仍乱加价、套路多的痛点，引出3个必看避坑要点。
 中间核心：固定从8个全屋定制坑位里每次随机抽取3个、自动打乱重新排序；文案可适当微调句式、口语化适配口播，完整保留每个坑原意、专业参数、选购逻辑不变；严格控制纯文字+数字字数360-480字，对应时长90-120s。
-结尾范式：完整保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动领福利、评论区扣关键词的核心逻辑。
+结尾范式：完整保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动领福利、评论区回复关键词的核心逻辑。
 【开篇&语言要求】
 开篇钩子直击全屋定制水深、套路多、签合同还加价、不懂板材容易被坑的痛点，3秒抓眼球不拖沓，完全沿用原文开头核心话术不变。
 全程口语化大白话，小白易懂、不生硬说教，站业主共情立场，贴合原文接地气口播风格。
@@ -24,31 +24,16 @@
 第六就是铰链，你问他什么品牌，但凡跟你说是他们自有品牌，直接让他有多远滚多远。他又不是生产队的驴，啥都能生产。多半是找小工厂代工的，别为了省那点钱，铰链就认准汉高、东泰、德蒂，每天都要开关，咱们可不能马虎。
 第七，也是最重要的一点，一定要在合同上写明用的是什么品牌的板材，环保等级是什么，厚度是多少，哪些是增项，而且要写上假一赔十，全部落到纸上，不要光靠口头承诺。
 第八，全屋定制，不管是橱柜也好，衣柜也好，一线品牌和六线品牌做出来都是一模一样的。说白了，所有全屋定制都是板材的二道贩子，咱们就找本地工厂，关键看设计和安装。
-要是还有不懂的、近期准备新房装修的朋友，我整理了一份装修避坑手册供你参考，评论区抠避坑，拿去用。
+要是还有不懂的、近期准备新房装修的朋友，我整理了一份装修避坑手册供你参考，评论区回复避坑，拿去用。
 【内置完整素材库标题】
 合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
 厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
 毛坯全屋广角全景-毛坯基础
 阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
 装修合同核对-现场交底
 卧室原始状态-翻新基础
 厨卫原始状态-翻新基础
 客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
 设计师入户-量房勘测
 全屋地板铺设施工-主材安装
 全屋开关面板安装-主材安装
@@ -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

@@ -21,7 +21,7 @@
 文案调整要求：微调仅针对句式口语化优化，把书面表述改成抖音接地气口播大白话，不改变每个节点的施工要求、到场必要性、后期隐患，所有细节完整保留。
 字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 360-440 字，按每秒 4 个纯文字计算，对应时长 90-110s，内容精炼不啰嗦，节奏适中符合短视频完播习惯。
 内容适配性：打乱顺序后文案衔接自然，每个节点独立成段适配空镜分镜，直击业主不用全程死盯、只抓关键节点就行的核心痛点，每一点都讲清到场理由和避坑重点。
-结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领资料、评论区扣关键词、福利引导的核心逻辑。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领资料、评论区回复关键词、福利引导的核心逻辑。
 【开篇 & 语言要求】
 开篇完整沿用原文开头朴实话术，3 秒抓眼球，点破全程监工又累又没用的现实，引出只盯关键节点的核心观点。
 全程口语化大白话，小白易懂、接地气实在，站普通业主视角共情讲解，不生硬说教，语气真诚接地气。
@@ -34,7 +34,7 @@
 第四，吊顶时，你必须在场，确认好使用的是轻钢龙骨，别让师傅偷换用木龙骨，再直接封上石膏板，后期变形发霉，等你发现那就晚了。
 第五，全屋定制安装，你必须在场，通过五金孔检查板材品质，还要叮嘱师傅做好封边，少做一步，你家都可能甲醛超标。
 第六，房子做完闭水试验，你必须亲自去楼下邻居家看看有没有漏水，如果只让师傅拍照片，你根本不知道他是什么时候拍的。真出了问题还得你来赔付。
-记不住的，我整理了装修全流程避坑手册。评论区抠避坑，拿去用。
+记不住的，我整理了装修全流程避坑手册。评论区回复避坑，拿去用。
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -14,7 +14,7 @@
 走管方式：厨卫水电统一走顶，漏水易发现、后期维修方便；其余空间走地施工，节省装修材料成本。
 完工验收：水电完工必须做 30 分钟水管打压，确保无渗漏，电路检测通断正常后，再签字确认验收。
 （备注：保留原文 4 个要点，按原文序号排列，保留原文核心细节和避坑逻辑，适当微调句式贴合口播，严格控制纯文字 + 数字 170-210 字，适配时长 42.5-52.5s）
-结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修避坑手册】，抠【核心关键词：避坑】直接拿走，对照参考少走弯路！”
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修避坑手册】，回复【核心关键词：避坑】直接拿走，对照参考少走弯路！”
 【开篇 & 语言要求】
 开篇钩子，直击水电装错隐患大、返工成本高的痛点，3 秒抓眼球，不拖沓不铺垫（保留原文 “水电装错毁一生，这几条关键点错一个返工要好几万” 核心钩子）。
 全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
@@ -26,7 +26,7 @@
 3. 厨卫水电必走顶，漏水易发现好维修，其他地方走地省材料。
 4. 验收必做水管打压30分钟无渗漏，电路测通断再签字。
 水电是隐蔽工程，紧盯施工别偷懒，别等返工才追悔莫及！
-近期准备装修的可以找我领装修避坑手册，评论区扣避坑，直接拿走。
+近期准备装修的可以找我领装修避坑手册，评论区回复避坑，直接拿走。
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -16,7 +16,7 @@
 吊顶防锈：吊顶所有钉子眼，必须人工涂刷防锈漆，防止后期生锈泛黄影响颜值。
 验收付款：油工全部施工完毕，验收合格之后再结尾款，严把施工质量关。
 （备注：保留原文 6 个要点，按原文序号排列，保留原文核心细节和避坑逻辑，精简句式，控制整体纯文字 + 数字字数在 180-220 字，贴合短时长口播语感）
-结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修流程避坑手册】，抠【核心关键词：避坑】直接拿走！”
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修流程避坑手册】，回复【核心关键词：避坑】直接拿走！”
 【开篇 & 语言要求】
 开篇钩子，直击油工施工不懂沟通、容易被糊弄、墙面留隐患、甲醛超标的痛点，3 秒抓眼球，不拖沓不铺垫。
 全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
@@ -29,7 +29,7 @@
 第四、门口、踢脚线、衣柜周围重点找平，别留难看缝隙。
 第五、吊顶钉子眼一定要人工刷防锈漆，防止后期生锈难看。
 第六、油工验收合格再给钱，面子工程必须把好质量关。
-准备装修的朋友，评论区扣避坑直接领取装修流程避坑手册！直接拿着对照参考，少踩坑！
+准备装修的朋友，评论区回复避坑直接领取装修流程避坑手册！直接拿着对照参考，少踩坑！
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -25,7 +25,7 @@
 文案调整要求：仅做口语化句式微调，把书面表述改成接地气口播大白话，不改动任何施工细节、工艺要求、禁忌标准，完整保留 10 条话术核心原意。
 字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 440-480 字，按每秒 4 个纯文字计算，对应时长 110-120s，讲解饱满不拖沓，符合短视频用户完播习惯。
 内容适配性：打乱顺序后文案衔接自然，每条话术独立成点、逻辑通顺，贴合业主瓦工进场监工刚需，直击无效送礼不如专业话术管用的核心痛点，每一条都明确施工标准和避坑要点。
-结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领资料、评论区扣关键词、福利引导的核心逻辑。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领资料、评论区回复关键词、福利引导的核心逻辑。
 【开篇 & 语言要求】
 开篇完整沿用原文开头句式和吐槽语气，3 秒抓眼球，直击业主花钱送礼无效监工的通病，引出专业监工话术。
 全程口语化大白话，接地气、通俗易懂，站装修业主视角共情讲解，不生硬说教。
@@ -42,7 +42,7 @@
 第八句，师傅，所有的转角都要海棠角，后期我要做美缝，千万别给我做阳角条。
 第九句，师傅需要贴止逆阀的地方一定要帮我贴一块整砖。我的止逆阀也买回来，你按这个开孔以后，顺手帮我装上吧。
 第十句，师傅，我家橱柜和浴室柜不打算装挡水条，所以对墙面阴阳角的垂直度要求比较高，麻烦你上点心啊。
-准备新房装修的朋友，我整理了装修全流程避坑手册。评论区抠避坑，拿去用。
+准备新房装修的朋友，我整理了装修全流程避坑手册。评论区回复避坑，拿去用。
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -17,7 +17,7 @@
 6. 卫生间回填：卫生间千万不要用建筑垃圾回填，让师傅用陶粒回填，陶粒质轻还吸水，回填完再铺一层钢筋网，加水泥找平，才能保证后期地面不下沉。
 7. 后期保护：师傅贴完砖以后要及时清缝，后期美缝才不会崩瓷，还要用厚纸板把地砖盖好，做好成品保护，避免后期施工造成刮痕。
 （备注：保留原文7个要点，按原文序号排列，保留原文核心细节和避坑逻辑，适当调整句式让口语化更贴合口播）
-结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑手续】，抠【核心关键词：避坑】直接拿走！”
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑手续】，回复【核心关键词：避坑】直接拿走！”
 【开篇&语言要求】
 开篇钩子，直击瓦工施工糊弄、后期瓷砖出问题的痛点，3秒抓眼球，不拖沓不铺垫。
 全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
@@ -31,7 +31,7 @@
 第五，所有需要开孔的瓷砖必须用专业开孔器来开，保证开孔规整，不然后期瓷砖很容易从开口处开裂。
 第六，卫生间千万不要用建筑垃圾回填，让师傅用陶粒回填，陶粒轻还吸水。回填完再铺一层钢筋网，加水泥找平，才能保证后期地面不下沉。
 第七，师傅贴完砖以后要及时清缝，后期美缝才不会崩瓷，还要用厚纸板把地砖盖好，做好保护，避免后期施工造成刮痕。
-准备新房装修的朋友，我整理了一份装修全流程避坑手续。抠避坑，直接拿去用。
+准备新房装修的朋友，我整理了一份装修全流程避坑手续。回复避坑，直接拿去用。
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -20,7 +20,7 @@
 2.  文案调整要求：微调仅针对句式口语化优化，比如将书面化表述改为抖音/视频号口播常用的接地气语气，补充轻微危害提示（结合美缝反碱脱落、水电标识撕毁的隐患），不改变每个坑的核心信息——如验收等待五六天、美缝等待一周、禁止洒水、保留水电标识、定制复尺周期一个月等核心时间节点和禁忌，所有细节完全保留，贴合原文原意。
 3.  字数与时长控制：纯文字+数字（扣除标点）严格控制在400-480字，按每秒4个纯文字计算，对应时长100-120s，既保证每个避坑点讲解透彻，补充必要危害提示，又不拖沓，符合短视频用户观看习惯，避免用户划走。
 4.  内容适配性：5个避坑要点讲解时需衔接自然，每个坑独立成段（分镜对应空镜），不重复、不冗余，重点突出“停工避坑”核心，贴合业主担心被装修公司催促、怕后期出问题自己担责、想合理利用停工时间的核心痛点，每段讲解都紧扣“为什么不能做、怎么做才对”的逻辑，与原文保持一致，结合参考内容完善危害提示，增强说服力。
-结尾范式：以“如果你们也在准备新房装修，不知道还有哪些坑要避，评论区扣 ‘装修’，我把整理好的装修避坑手册，免费发给你们，帮你们省时间、省钱！记得关注我，装修不踩坑！”为核心句式，保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动领福利、评论区扣关键词、关注引导的核心逻辑。
+结尾范式：以“如果你们也在准备新房装修，不知道还有哪些坑要避，评论区回复 ‘装修’，我把整理好的装修避坑手册，免费发给你们，帮你们省时间、省钱！记得关注我，装修不踩坑！”为核心句式，保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动领福利、评论区回复关键词、关注引导的核心逻辑。
 【开篇&语言要求】
 开篇严格遵循核心强制规则的警示性句式，3秒抓眼球不拖沓，用犀利语气点出瓷砖铺贴后被催工期、盲目施工后期担责的痛点，贴合装修业主避坑需求，不偏离范式结构。
 全程口语化大白话，小白易懂、不生硬说教，站业主共情立场，用警示性语气讲解，贴合口播传播特点，增强代入感，补充的危害提示通俗易懂，让业主清晰了解违规操作的后果。
@@ -32,7 +32,7 @@
 第三，瓷砖铺完后千万不要洒水，你洒水养护的是下面的水泥砂浆，那活儿，瓦工铺的时候就应该把墙面地面打湿再贴，铺完了再打扫干净，盖好保护膜就可以了，别多此一举。
 第四，墙面的水电标识贴不要撕，这是给后期安装师傅看的。你一撕，人家打孔打到水管电线，你就等着哭吧，不仅维修麻烦，还可能引发安全隐患。
 最后，停工这几天也别闲着。闲着你就可以让定制商家上门复尺，提前下单，定制周期差不多一个月，到时候你家油工结束了，这些东西正好能装，一点儿不耽误工期。
-如果你们也在准备新房装修，不知道还有哪些坑要避，评论区扣 “装修”，我把整理好的装修避坑手册，免费发给你们，帮你们省时间、省钱！记得关注我，装修不踩坑！
+如果你们也在准备新房装修，不知道还有哪些坑要避，评论区回复 “装修”，我把整理好的装修避坑手册，免费发给你们，帮你们省时间、省钱！记得关注我，装修不踩坑！
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -17,7 +17,7 @@
 木工吊顶：木工做吊顶务必在场，拐角整板铺设、接缝开 V 型槽，防止后期乳胶漆开裂。
 腻子施工：刮腻子阶段一定要在场，禁止往腻子里加胶水，避免甲醛超标形成毒气房。
 （备注：保留原文 7 个要点，按原文序号排列，保留原文核心细节和避坑逻辑，精简句式控制整体字数，贴合口播语感）
-结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全程避坑手册】，抠【核心关键词：避坑】直接拿走！”
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全程避坑手册】，回复【核心关键词：避坑】直接拿走！”
 【开篇 & 语言要求】
 开篇钩子，直击装修不懂监工节点、容易被糊弄、住进甲醛房的痛点，3 秒抓眼球，不拖沓不铺垫。
 全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
@@ -31,7 +31,7 @@
 第五，贴砖时要在场，检查平整度空鼓率，阴阳角方正、缝隙均匀才合格。
 第六，木工吊顶必在场，拐角整板、接缝做 V 型槽，杜绝后期乳胶漆开裂。
 第七，刮腻子一定要在场，严禁往腻子加胶水，不然甲醛超标变毒气房。
-准备装修的朋友，我整理了避坑手册，评论区扣避坑直接领取参考！
+准备装修的朋友，我整理了避坑手册，评论区回复避坑直接领取参考！
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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,46 +20,25 @@
 排序逻辑：严格按原文 6 大收尾要点顺序排列，不打乱结构，贴合硬装完工到软装进场的真实施工流程，层层递进符合业主装修收尾认知逻辑。
 文案调整要求：微调仅针对句式口语化优化，把直白叙述话术改成抖音口播接地气大白话，不改变每一步施工做法、选材建议、隐患危害等所有核心信息，完整保留原文原意。
 字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 440-480 字，按每秒 4 个纯文字计算，对应时长 110-120s，讲解收尾细节细致不啰嗦，节奏适中，适配短视频完播率。
-内容适配性：7 个收尾要点衔接自然，每一条独立适配空镜分镜，直击业主硬装完工急于入住、忽略隐蔽收尾细节，后期返工闹心的核心痛点，每一条都讲清做法、原因和避坑作用，实用性极强。
-结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修全流程避坑手册、评论区扣关键词引导的核心逻辑。
+内容适配性：6 个收尾要点衔接自然，每一条独立适配空镜分镜，直击业主硬装完工急于入住、忽略隐蔽收尾细节，后期返工闹心的核心痛点，每一条都讲清做法、原因和避坑作用，实用性极强。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修全流程避坑手册、评论区回复关键词引导的核心逻辑。
 【开篇 & 语言要求】
 开篇沿用原文警示吐槽语气，3 秒抓眼球，点破硬装刚结束着急搬软装、忽略收尾细节入住就留隐患闹矛盾的真实痛点，瞬间引发装修完工业主共鸣。
 全程口语化大白话，通俗易懂、接地气，站业主立场拆解装修收尾细节，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
 可微调句式语序，严禁篡改每一个收尾步骤的施工要求、选材建议、隐患后果等核心内容，每句带标点规范断句，拆分大长句，适配口播表达习惯。
 【内置固定原文案】
-装修千万别硬装刚结束就急着把沙发、床这些软装搬进去。先把下面这 7 个收尾的活安排明白，要不然等你人入住进去以后，两口子天天吵架。
+装修千万别硬装刚结束就急着把沙发、床这些软装搬进去。先把下面这 6 个收尾的活安排明白，要不然等你人入住进去以后，两口子天天吵架。
 第一，不管你家是亮光砖还是柔光砖，趁家具还没进场，赶紧网购一瓶瓷砖除蜡剂，把地面彻底拖一遍。不然等你住进去，地面怎么都像蒙了一层水雾，看着就闹心。
 第二，餐边柜和橱柜吊柜底部建议贴一层静电防水膜，防止水蒸气慢慢把咱家的吊柜熏坏了。再有就是橱柜里边贴上铝箔纸，它防潮性会更好，而且更好打理卫生。
 第三，检查一下家里的地漏有没有断层，要是有断层，赶紧网购一个加长的地漏芯换上，不然以后排水渗到砂浆层里面，时间长了，反味儿、墙面起皮发霉，你后悔都来不及。
 第四，家具进场前一定要先安排全屋打胶，别自己打，你打不明白。尤其是你的踢脚线底下，以及厨房和卫生间窗框和瓷砖的交界处，一定记得打美容胶，别用美缝剂，美缝剂偏硬，时间长了容易脱落。
 第五，烟机和卫生间的浴霸、排风扇，你要看它有没有跟止逆阀连接。有很多安装师傅图省事儿，把排风管顺手往顶上一扔，反正你也看不着，后期全是味儿。
 第六，乳胶漆施工后记得留一些未兑水的原漆，装在密封瓶里保存，后期安装门、柜体时难免磕碰，方便随时修补。
-记不住的，我都整理在这份装修全流程避坑手册里了。评论扣避坑，拿好少踩坑。
+记不住的，我都整理在这份装修全流程避坑手册里了。评论回复避坑，拿好少踩坑。
 【内置完整素材库标题】
-合同签署
-卧室原始结构-毛坯基础
-原始门窗原貌-毛坯基础
-厨卫原始毛坯状态-毛坯基础
-地面原始水泥基层-毛坯基础
-客厅原始墙面-毛坯基础
-强弱电箱原始特写-毛坯基础
-毛坯全屋广角全景-毛坯基础
-阳台原始结构空镜-毛坯基础
-墙面点位弹线-现场交底
-开关插座定位-现场交底
-开工仪式简单镜头-现场交底
-施工方案现场讲解-现场交底
-甲乙工长三方对接-现场交底
-给排水点位标记-现场交底
-装修合同核对-现场交底
 卧室原始状态-翻新基础
 厨卫原始状态-翻新基础
 客厅原始状态-翻新基础
-卷尺实测尺寸-量房勘测
-手绘户型草图-量房勘测
-激光水平仪测量-量房勘测
-电脑户型图制作-量房勘测
-设计师入户-量房勘测
 全屋地板铺设施工-主材安装
 全屋开关面板安装-主材安装
 卫浴洁具进场安装-主材安装
@@ -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

@@ -21,7 +21,7 @@
 文案调整要求：微调仅针对句式口语化优化，改成抖音口播接地气大白话，不改变每个要点的施工场景、业主行为、带来的影响，完整保留原意不变。
 字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 400-480 字，按每秒 4 个纯文字计算，对应时长 100-120s，讲解饱满不拖沓，符合短视频完播习惯。
 内容适配性：6 个要点讲解衔接自然，每点独立成段适配空镜分镜，聚焦业主不懂行乱指挥、盲目加活的通病，既讲做法又讲背后利弊，真实接地气、容易引发共鸣。
-结尾范式：以 “如果你也准备新房装修，我整理了一份装修全流程避坑手册。评论区抠避坑，拿去用。” 为核心句式，保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动核心逻辑。
+结尾范式：以 “如果你也准备新房装修，我整理了一份装修全流程避坑手册。评论区回复避坑，拿去用。” 为核心句式，保留原文结尾结构和领资料引导话术，仅可轻微优化口语流畅度，不改动核心逻辑。
 【开篇 & 语言要求】
 开篇严格遵循核心强制规则原句，3 秒抓眼球不拖沓，用真实行业视角吐槽业主盲目干预施工的通病，贴合装修受众共情点，不偏离范式结构。
 全程口语化大白话，小白易懂、不生硬说教，站客观中立角度讲解，语气接地气有真实感，贴合口播传播特点。
@@ -34,7 +34,7 @@
 第四，木工师傅高高兴兴来了，你却告诉他，所有接缝处都要做 V 字型槽，转角处要做到 T 字型。师傅一听就知道你是懂行的。后期墙面是不容易开裂了，又给师傅增加好多活儿。
 第五，瓦工师傅来了，懂行的业主要求把卫生间先找坡度，地漏做成回形地漏，这样不仅下水快，还好看，可这又得浪费师傅半天时间，重新找坡度。
 第六，瓦工还没结束，部分业主已经提前买好了地漏和油烟止逆阀，要求师傅一并装上。这下好了，之后安装电器的师傅想赚点外快都不行。
-如果你也准备新房装修，我整理了一份装修全流程避坑手册。评论区抠避坑，拿去用。
+如果你也准备新房装修，我整理了一份装修全流程避坑手册。评论区回复避坑，拿去用。
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -18,7 +18,7 @@
 文案调整要求：微调仅针对句式口语化优化，把书面合同话术改成抖音口播接地气大白话，不改变违约金比例、付款节点金额、备注 5 条硬性约定等所有核心数字和规则，完整保留原文原意。
 字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 400-480 字，按每秒 4 个纯文字计算，对应时长 100-120s，讲解条款细致不啰嗦，节奏适中，适配短视频完播率。
 内容适配性：三大要点及备注条款衔接自然，每部分独立适配空镜分镜，直击业主签约被套路、后期加价维权难的核心痛点，每一条都讲清陷阱、整改方法和保障作用，实用性极强。
-结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修合同模板、评论区扣关键词引导的核心逻辑。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修合同模板、评论区回复关键词引导的核心逻辑。
 【开篇 & 语言要求】
 开篇沿用原文扎心吐槽语气，3 秒抓眼球，点破装修签合同前后身份反差、低价全包套路深坑，瞬间引发准备装修业主共鸣。
 全程口语化大白话，通俗易懂、接地气，站业主立场拆解合同陷阱，条理清晰、干货满满，不生硬说教，适配口播传播节奏。
@@ -33,7 +33,7 @@
 3，因设计和施工造成的房屋、墙体等结构安全隐患，由乙方全权负责。
 4，若乙方原因延误工期，每延误一天，支付工程款总费用的 1%。
 5，乙方承诺赠送的家电，必须在甲方支付最后一笔工程款之前安装到位。
-合同这么签，谁都坑不了你。记不住的，我整理了装修合同模板，抠合同拿去用，对着谈准没错。
+合同这么签，谁都坑不了你。记不住的，我整理了装修合同模板，回复合同拿去用，对着谈准没错。
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -15,13 +15,13 @@
 5. 安全责任：80%的公司只写按安全标准施工，但出事谁负责？合同必须注明工人人身安全及财产损失全部由装修公司承担。
 6. 违约金恶心点：单方面解约违约金写得很高，公司不会主动解约，就是为了绑死客户。违约金超过20%直接拉黑，别犹豫。
 （备注：随机抽取上述4点作为中间核心，重编序号，保留原文核心数据和避坑逻辑，适当调整句式让口语化更贴合口播）
-结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑指南】，抠【核心关键词：合同】直接拿走，对照检查，少踩坑！”
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑指南】，回复【核心关键词：合同】直接拿走，对照检查，少踩坑！”
 【开篇&语言要求】
 开篇1–2句话钩子，直击装修合同文字陷阱、被装修公司坑钱的痛点，3秒抓眼球，不拖沓不铺垫（保留原文“玩的都是文字游戏，少踩一个坑等于多赚一笔钱”核心钩子）。
 全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
 可微调句式，不得篡改原文中工期、赔偿金比例、付款节点、材料条款等核心数字数据，每句必须带标点断句。
 【细节固定要求】
-结尾必须固定话术：我整理了装修全流程避坑指南，抠合同直接拿走。同时保留原文结尾“记不住的，我整理了装修合同样本，评论区抠合同，直接拿着对照检查，少踩坑！”
+结尾必须固定话术：我整理了装修全流程避坑指南，回复合同直接拿走。同时保留原文结尾“记不住的，我整理了装修合同样本，评论区回复合同，直接拿着对照检查，少踩坑！”
 总分镜数量固定12–20个，每个分镜时长3–8秒，可保留两位小数。
 【内置固定原文案】
 新房装修签合同千万注意这6个点，玩的都是文字游戏，耐心听我讲完，少踩一个坑等于多赚一笔钱。
@@ -31,7 +31,7 @@
 第四，材料调换坑。很多公司条款上面写着，当材料断货时，可用同等价钱调换，但有这条，偷工减料就成了理所当然。同价产品很难界定，同价的杂牌你敢用吗？这条必须划掉。
 第五，安全责任。有80%的公司只写按安全标准施工，但别不提出事谁负责？一旦发生安全事故，就是扯不完的皮。合同里必须注明工人人身安全及财产损失全部由装修公司承担。
 第六，也是最恶心的一点，很多公司把单方面解约违约金写得很高，他们根本不会主动解约，这条就是为了绑死你。违约金超过20%，你发现问题也不敢换人，所以超过20%直接拉黑，别犹豫。
-记不住的，我整理了装修合同样本，评论区抠合同，直接拿走对照检查，少踩坑！
+记不住的，我整理了装修合同样本，评论区回复合同，直接拿走对照检查，少踩坑！
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -18,7 +18,7 @@
 甲醛整改：约定全屋甲醛检测若不合格，由装修公司负责免费整改，并承担全部相关费用，避免入住甲醛超标、维权无门。
 违约赔付：明确双方违约责任，写清违约金比例和逾期赔付金额，约束双方行为，让装修公司不敢随意违约、敷衍施工。
 （备注：保留原文 8 个要点，按原文序号排列，保留原文核心数据、条款逻辑与避坑内涵，微调句式适配口播，严格控制纯文字 + 数字字数 400-440 字，适配时长 100-110s）
-结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修标准合同模板】，抠【核心关键词：装修】直接拿走，对照检查，少踩坑！”
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修标准合同模板】，回复【核心关键词：装修】直接拿走，对照检查，少踩坑！”
 【开篇 & 语言要求】
 开篇钩子，直击装修签合同盲目乱签、被模板套路、后期权益受损的痛点，3 秒抓眼球，不拖沓不铺垫（保留原文 “准备装修的家人们注意了！签合同别瞎签，装修公司固定模板直接签必踩坑” 核心钩子）。
 全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
@@ -33,7 +33,7 @@
 第六，材料假一罚十，品牌型号对好，你确认后再施工。防止装修公司以次充好，偷换材料。
 第七，甲醛检测不合格，装修公司整改并承担所有费用。避免入住后甲醛超标，维权无门。
 第八，违约责任划清楚，违约金和逾期赔付金额写明白。保障自己权益，让装修公司不敢随意违约。
-准备装修的，我整理了合同模板，评论区扣装修就能领！帮你装修少踩坑、省麻烦！
+准备装修的，我整理了合同模板，评论区回复装修就能领！帮你装修少踩坑、省麻烦！
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -25,7 +25,7 @@
 文案调整要求：微调仅针对句式口语化优化，把书面提问话术改成抖音接地气口播大白话，不改变每个环节询问的项目、品牌、工艺、收费、责任划分等核心信息，全部细节原样保留。
 字数与时长控制：纯文字 + 数字（扣除标点）严格控制在 400-480 字，按每秒 4 个纯文字计算，对应时长 100-120s，讲解环节完整、节奏适中，不啰嗦不拖沓，适配短视频完播习惯。
 内容适配性：十大问题衔接自然，每个施工环节独立成段适配空镜分镜，直击半包业主不会询价、容易被低价套路、后期增项扯皮的核心痛点，逐条给到可直接照着问的实用话术。
-结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修报价注意事项、评论区扣关键词领资料的核心逻辑。
+结尾范式：完整保留原文结尾原话，仅可轻微优化口语流畅度，不改动领取装修报价注意事项、评论区回复关键词领资料的核心逻辑。
 【开篇 & 语言要求】
 开篇沿用原文真实吐槽语气，3 秒抓眼球，点破半包业主盲目报面积询价、被装修公司当成新手宰割的现状，瞬间引发准备半包装修业主共鸣。
 全程口语化大白话，小白一听就懂、可直接照搬拿去问装修公司，站业主立场拆解半包询价所有关键点，条理清晰干货满满，不生硬说教，贴合口播传播节奏。
@@ -38,7 +38,7 @@
 第四，吊顶，问用的是木龙骨还是轻钢龙骨？石膏板是什么牌子的？做单层还是做双层？七字拐、八字缝有没有做？
 第五，砌墙，问墙固用什么牌子，是油工刷还是开工就刷？挂网是局部还是全屋挂网？全挂要不要加钱？腻子的话，我只认国产一线品牌，其他我都不要。墙顶面我只要顺平就好，柜子后面、踢脚线、门口、窗口局部都要找平就行。乳胶漆用的是什么牌子，有没有刷底漆？是刷几遍，都要给我备注上。
 最后，装修用的材料，如果发现是以次充好，该怎么赔？工人安全是谁来负责？工期耽误了又该怎么赔？施工不达标，要不要整改？整改费用谁出？
-这些问题你不搞清楚，后期肯定扯皮。我整理了装修报价注意事项，评论区抠报价，拿去用
+这些问题你不搞清楚，后期肯定扯皮。我整理了装修报价注意事项，评论区回复报价，拿去用
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -9,7 +9,7 @@
 【核心强制规则】
 开头范式：原样保留原文开头结构和话术，仅可微调口语语气，不改动核心句意，直接引出8个不值得花钱的装修点位。
 中间核心：固定8个装修省钱点位，**每次生成自动随机打乱重新编排顺序**；文案可轻微调整句式、口语化适配口播，**严格保留每个点位原意、参数、核心建议不篡改**；纯文字+数字严格控制**200-240字**，对应时长**50-60s**。
-结尾范式：尽可能原样保留原文结尾结构，仅可微调引导话术，保持领资料抠关键词的原意不变。
+结尾范式：尽可能原样保留原文结尾结构，仅可微调引导话术，保持领资料回复关键词的原意不变。
 【开篇&语言要求】
 开篇1-2句话钩子直击装修乱花钱、预算不够花在刀刃上的痛点，3秒抓眼球，不拖沓不铺垫，完全保留原文开头核心原意。
 全程口语化大白话，小白易懂，不生硬说教，站业主共情立场，贴合原文口语化风格。
@@ -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

@@ -21,7 +21,7 @@
 字数与时长控制：纯文字 + 数字扣除标点，严格控制在 440-480 字，按每秒 4 个字核算，对应时长 110-120s，内容饱满共情、节奏平缓走心，适配中长故事型口播完播习惯。
 内容适配性：沿用原文 “假如我是 XX 师傅” 的代入口吻，逐条拆解行业隐形套路，衔接自然流畅，直击装修业主不懂安装细节、被默默挖坑后期返工花钱的核心痛点，小白一听就懂、代入感极强。
 结尾范式
-完整保留原文结尾原话，只可轻微口语化微调，不改动装修套路深、整理全流程避坑手册、评论扣关键词领取、提前避坑少走弯路的福利引导核心逻辑。
+完整保留原文结尾原话，只可轻微口语化微调，不改动装修套路深、整理全流程避坑手册、评论回复关键词领取、提前避坑少走弯路的福利引导核心逻辑。
 【开篇 & 语言要求】
 开篇完整沿用原文开头原话，直击人性套路，3 秒抓住装修业主好奇心；
 全程保持原文第一人称代入共情口吻，接地气、写实走心，站业主视角拆解行业内幕，不生硬说教、不夸张造谣；
@@ -33,7 +33,7 @@
 假如我是安装油烟机的师傅，我一定不会提醒你烟机支架可以换成升降的。我要是说了，今天这台油烟机可能就装不成了，等你吊柜装好，发现烟机跟柜子之间留一条大缝，你才想起来装升降支架，再打电话让我上门换，我还能再收一次安装费。
 假如我是安装橱柜的师傅，我一定不会提，给你板材切割的断面要用收边条封上。我要是说了，活儿多了还得我干，搞不好还因为这点小事扣我尾款，我还是不说的好，等以后板材受潮发霉，你也想不到是因为没封边造成的。
 假如我是安装浴室柜的师傅，我一定不会提醒你提前买好下水器，我直接把下水管给你塞进去就完事。我要是说了，还得等你去买，买回来我还得帮你装，万一装不上或者漏水，又是一堆麻烦，何必呢？
-装修套路深，想省心不存在的。我整理了全流程避坑手册，抠手册直接拿走，提前了解，少走弯路。
+装修套路深，想省心不存在的。我整理了全流程避坑手册，回复手册直接拿走，提前了解，少走弯路。
 【内置完整素材库标题】
 合同签署
 卧室原始结构-毛坯基础
@@ -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

@@ -13,7 +13,7 @@
 【核心强制规则】
 开头范式：以“新房装修【核心场景：防水】，谁要是给你一上来就【错误操作】，你就直接撵走他。你以为他是帮你【表面好处：赶工期】，其实他就是图【错误目的：省事儿、不想多花功夫】。下面这8点一定要做到位，少一步都不行！”为核心句式，用警示性语气点出常见坑，引出下文要点。
 中间核心（8个装修防水要点，文案可以修改，意思保持原意，可随机抽取4个重编序号）： 1. 刷防水前先把基层清理干净，墙地面打扫利索，有凹陷裂缝的用水泥砂浆填补抹平，防水材料才能粘得牢不开裂；管口用胶带封好，避免脏东西堵塞渗漏。 2. 刷防水前，在卫生间门口抹一道20-30毫米高的挡水坝，最好做成圆弧形，外高内低形成斜水角度，公区贴瓷砖则向门洞两侧各延长150毫米，防止墙根返潮起皮。 3. 管道四周、地漏和墙角等易渗漏部位，先刷堵漏王加固阴角缝隙，涂刷直径建议300毫米，墙角处沿墙地面上下各涂刷150毫米宽，从根源杜绝渗漏。 4. 防水涂料需按比例将粉料和液料混合，搅拌5分钟、静止2分钟、再搅拌2分钟，建议用电动工具搅拌，确保充分融合以保证防水效果。 5. 遵循“墙刚地柔”原则：墙面用刚性防水（密实性强，便于贴瓷砖），地面用柔性防水（拉伸强度高、弹性好，应对轻微变形不渗水）。 6. 涂刷时先重点处理管道四周和墙角，再大面积十字交叉涂刷（横竖各一遍），淋浴区涂刷高度不低于1.8米，干区浴室柜位置不低于1.2米，门口不低于30公分，地面防水上返墙面200毫米以上。 7. 第一遍防水完全干燥后，再刷第二遍，两遍涂刷方向相互垂直，避免遗漏和针气孔缺陷，做到双重防护。 8. 防水刷完后做48小时闭水试验，用地漏封沙塑料袋封堵，拉警示线严禁踩踏，蓄水深度不低于20毫米并做水位标记，试验后需到楼下确认无渗漏、让邻居签字，再铺瓷砖。 
-结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑指南】，抠【核心关键词：防水】直接拿走，里面全是实用干货，需要的可以找我要！
+结尾范式：准备新房装修的朋友，我整理了一份【相关福利：装修全流程避坑指南】，回复【核心关键词：防水】直接拿走，里面全是实用干货，需要的可以找我要！
 
 【字数&时长硬约束】
 总字数：不含标点、含数字，严格控制在400–480字。
@@ -27,7 +27,7 @@
 可微调句式，不得篡改原文施工流程、尺寸、时间等核心数字数据，每句必须带标点断句。
 
 【细节固定要求】
-结尾必须固定话术：我整理了装修全流程避坑指南，抠防水直接拿走。
+结尾必须固定话术：我整理了装修全流程避坑指南，回复防水直接拿走。
 总分镜数量固定12–20个，每个分镜时长3–8秒，可保留两位小数。
 
 【分镜固定结构规则】
@@ -50,7 +50,7 @@ type为segment=人物出镜；type为empty_shot=从下方内置素材库选匹
 第六，刷的时候先重点处理管道四周和墙角，再大面积涂刷，横竖各刷一遍形成十字交叉，涂刷厚度要达标。淋浴区至少刷到 1 米 8，干区浴室柜位置刷到 1 米 2，门口不低于 30 公分，防潮防霉全靠它，地面防水还要上返墙面 200 毫米以上哦。
 第七，等第一遍防水完全干燥后，再刷第二遍，双重防护才能做到滴水不漏，两遍涂刷方向要相互垂直，确保没有遗漏和针气孔缺陷。
 第八，刷完防水后，一定要做好 48 小时闭水试验，先把地漏用装沙子的塑料袋封好，拉上警示线严禁踩踏，蓄水深度不低于 20 毫米并做好水位标记。试验结束后，你要亲自到楼下看看漏没漏，让邻居签个字确认没问题，再铺瓷砖，避免后期返工扯皮。
-准备新房装修的朋友，我整理了一份装修全流程避坑指南，抠防水直接拿走，里面全是实用干货，需要的可以找我要！
+准备新房装修的朋友，我整理了一份装修全流程避坑指南，回复防水直接拿走，里面全是实用干货，需要的可以找我要！
 
 【内置完整素材库标题】
 合同签署
@@ -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

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

python-api/app/ai/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/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

@@ -50,15 +50,20 @@ async def check_update(
     if latest.version == version:
         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（避免报错阻断用户）

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.2", description="应用版本")
     DEBUG: bool = Field(default=False, description="调试模式")
     ENV: Literal["development", "staging", "production"] = Field(
         default="development", description="运行环境"

python-api/app/crud/broll_category.py

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

python-api/app/main.py

@@ -361,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/bgm_music.py

@@ -36,8 +36,8 @@ class BgmMusic(BaseModelBigInt):
     file_path: Mapped[str] = mapped_column(
         String(512), nullable=False, comment="相对文件路径"
     )
-    url: Mapped[str | None] = mapped_column(
-        String(1024), nullable=True, comment="七牛云 URL"
+    url: Mapped[str] = mapped_column(
+        String(1024), nullable=False, comment="七牛云 URL"
     )
     duration: Mapped[float] = mapped_column(
         Float, nullable=True, 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

@@ -14,7 +14,7 @@ class BgmMusicItem(BaseModel):
     artist: str | None = Field(default=None, description="艺术家")
     category: str = Field(description="场景分类")
     file_path: str = Field(description="相对文件路径")
-    url: str | None = Field(default=None, description="七牛云 URL")
+    url: str = Field(description="七牛云 URL")
     duration: float | None = Field(default=None, description="时长（秒）")
     sort_order: int = Field(default=0, 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/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__)
 
@@ -25,7 +26,12 @@ _USED_MATERIALS_TTL = 7 * 24 * 3600
 def _normalize_scene(scene: str) -> str:
     """标准化场景描述，用于匹配三级分类 name"""
     # 去除所有 Unicode 空白字符（空格、全角空格、换行、tab 等）
-    return re.sub(r"\s+", "", scene)
+    cleaned = re.sub(r"\s+", "", scene)
+    # 去除常见中文标点符号（逗号、句号、感叹号、问号、顿号、分号、冒号、引号、括号等）
+    cleaned = re.sub(r"[，。！？、；：""''（）【】《》]+", "", cleaned)
+    # 去除零宽字符（零宽空格、零宽非连接符、零宽连接符、零宽非断空格等）
+    cleaned = re.sub(r"[\u200b-\u200f\ufeff]+", "", cleaned)
+    return cleaned
 
 
 def _weighted_choice(materials: list) -> object:  # noqa: ANN001
@@ -48,7 +54,7 @@ def _weighted_choice(materials: list) -> object:  # noqa: ANN001
 
     r = random.uniform(0, total_weight)
     cumulative = 0.0
-    for m, w in zip(materials, weights):
+    for m, w in zip(materials, weights, strict=True):
         cumulative += w
         if r <= cumulative:
             return m
@@ -57,6 +63,64 @@ def _weighted_choice(materials: list) -> object:  # noqa: ANN001
     return materials[-1]
 
 
+async def _try_fallback_to_parent(
+    db: AsyncSession,
+    normalized_scene: str,
+) -> BrollCategory | None:
+    """
+    三级分类匹配失败时，回退到上级（level=2）分类随机选取子分类。
+
+    解析逻辑：
+    - 若 scene 含 '-'，取后半部分作为 parent_name（如 '电路施工-电路施工' -> '电路施工'）
+    - 若不含 '-'，直接以整个 scene 作为 parent_name
+
+    匹配策略（逐级降级）：
+    1. 精确匹配 level=2 分类 name
+    2. 模糊匹配（LIKE %parent_name%），兼容 "电路施工" → "电路施工镜"
+    3. 去掉常见后缀（镜、阶段等）再精确匹配
+
+    返回：
+        随机选中的一个 level=3 子分类，或 None
+    """
+    if "-" in normalized_scene:
+        parent_name = normalized_scene.rsplit("-", 1)[-1]
+    else:
+        parent_name = normalized_scene
+
+    # 1. 精确匹配
+    parent = await broll_category.get_by_name_and_level(
+        db, name=parent_name, level=2
+    )
+
+    # 2. 模糊匹配（兼容 "电路施工" → "电路施工镜"）
+    if parent is None:
+        parent = await broll_category.get_by_name_like_and_level(
+            db, name=parent_name, level=2
+        )
+
+    # 3. 去掉常见后缀再试
+    if parent is None:
+        for suffix in ("镜", "阶段"):
+            if not parent_name.endswith(suffix):
+                candidate = parent_name + suffix
+                parent = await broll_category.get_by_name_and_level(
+                    db, name=candidate, level=2
+                )
+                if parent:
+                    break
+
+    if parent is None:
+        return None
+
+    children = await broll_category.get_children_by_parent_id(
+        db, parent_id=parent.id, level=3
+    )
+    if not children:
+        return None
+
+    return random.choice(children)
+
+
 async def match_material(
     db: AsyncSession,
     scene: str,
@@ -68,11 +132,13 @@ async def match_material(
 
     匹配策略：
     1. 标准化 scene，精确匹配三级分类（level=3）的 name。
-    2. 查询该分类下状态为 active、时长 >= required_duration 的素材。
-    3. 若提供 project_id，从 Redis 获取该项目已使用的 URL 并排除。
-    4. 优先从未使用候选中加权随机选择；若未用候选为空，
+    2. 若精确匹配失败，尝试将 "A-B" 倒序为 "B-A" 再匹配。
+    3. 若仍失败，回退到上级（level=2）分类，随机选取一个子分类。
+    4. 查询该分类下状态为 active、时长 >= required_duration 的素材。
+    5. 若提供 project_id，从 Redis 获取该项目已使用的 URL 并排除。
+    6. 优先从未使用候选中加权随机选择；若未用候选为空，
        fallback 到全部候选（允许复用，保证合成连续性）。
-    5. 原子递增 usage_count，并将选中的 URL 写入 Redis Set（7 天 TTL）。
+    7. 原子递增 usage_count，并将选中的 URL 写入 Redis Set（7 天 TTL）。
 
     Args:
         db: 数据库 Session
@@ -94,11 +160,21 @@ async def match_material(
 
     normalized = _normalize_scene(scene)
 
-    # 1. 查找三级分类（精确匹配 + 顺序颠倒兜底）
+    # 1. 查找三级分类（精确匹配 -> 全量内存匹配兜底 -> 顺序颠倒 -> 上级回退）
     category = await broll_category.get_by_name_and_level(
         db, name=normalized, level=3
     )
-    # 若精确匹配失败，尝试将 "A-B" 倒序为 "B-A" 再匹配
+    # 精确匹配失败时，全量查询后在内存标准化匹配（兼容数据库 name 含不可见字符）
+    if category is None:
+        all_categories = await broll_category.get_by_level(db, level=3)
+        for c in all_categories:
+            if _normalize_scene(c.name) == normalized:
+                category = c
+                logger.info(
+                    f"素材分类全量内存匹配命中: '{normalized}' -> '{c.name}'"
+                )
+                break
+    # 若仍失败，尝试将 "A-B" 倒序为 "B-A" 再匹配
     if category is None:
         parts = normalized.rsplit("-", 1)
         if len(parts) == 2:
@@ -110,17 +186,35 @@ async def match_material(
                 logger.info(
                     f"素材分类顺序颠倒兜底命中: '{normalized}' -> '{reversed_name}'"
                 )
+    # 若仍失败，回退到上级分类随机选取
     if category is None:
-        logger.debug(f"未找到分类: {normalized}")
+        category = await _try_fallback_to_parent(db, normalized)
+        if category:
+            logger.info(
+                f"素材回退到上级分类命中: '{normalized}' -> '{category.name}'"
+            )
+    if category is None:
+        logger.warning(f"素材匹配失败: 未找到分类 '{normalized}' (原始 scene: '{scene}')")
         return None
 
-    # 2. 查询候选素材
-    materials = await broll_material.get_active_by_category_and_duration(
-        db, category_id=category.id, min_duration=required_duration
+    # 2. 查询该分类下所有 active 素材（先不过滤时长，用于日志诊断）
+    all_materials = await broll_material.get_active_by_categories(
+        db, category_ids=[category.id]
     )
+    if not all_materials:
+        logger.warning(f"素材匹配失败: 分类 '{normalized}' 下无任何可用素材")
+        return None
+
+    # 按时长过滤（优先严格匹配，失败时逐步放宽到 70% 兜底）
+    materials = [m for m in all_materials if m.duration >= required_duration]
     if not materials:
-        logger.debug(
-            f"分类 {normalized} 无足够时长的素材 (需 >= {required_duration}s)"
+        materials = [m for m in all_materials if m.duration >= required_duration * 0.7]
+    if not materials:
+        materials = all_materials
+    if not materials:
+        max_duration = max(m.duration for m in all_materials)
+        logger.warning(
+            f"素材匹配失败: 分类 '{normalized}' 无足够时长的素材 (需 >= {required_duration}s, 最大可用: {max_duration}s)"
         )
         return None
 
@@ -187,37 +281,52 @@ async def batch_match(
     normalized_scenes = [_normalize_scene(s["scene"]) for s in scenes]
     unique_names = list(set(normalized_scenes))
 
-    # 2. 批量查询分类（1 次 DB）—— 同时查询原始名和倒序名
-    reversed_names: list[str] = []
-    name_to_reversed: dict[str, str] = {}
-    for name in unique_names:
-        parts = name.rsplit("-", 1)
-        if len(parts) == 2:
-            rev = f"{parts[1]}-{parts[0]}"
-            reversed_names.append(rev)
-            name_to_reversed[name] = rev
-
-    all_query_names = unique_names + reversed_names
+    # 2. 批量查询分类：优先精确查询，失败时全量内存匹配兜底
     categories = await broll_category.get_by_names_and_level(
-        db, names=all_query_names, level=3
+        db, names=unique_names, level=3
     )
     category_map: dict[str, object] = {}
     for c in categories:
-        category_map[c.name] = c
+        category_map[_normalize_scene(c.name)] = c
+
+    # 收集未命中的 name，准备全量兜底
+    unmatched_by_exact = [name for name in unique_names if name not in category_map]
+    if unmatched_by_exact:
+        all_categories = await broll_category.get_by_level(db, level=3)
+        for c in all_categories:
+            normalized_db_name = _normalize_scene(c.name)
+            if normalized_db_name not in category_map:
+                category_map[normalized_db_name] = c
+
+    # 构建原始 scene -> category 的映射
+    reversed_map: dict[str, str] = {}
+    for name in unique_names:
+        parts = name.rsplit("-", 1)
+        if len(parts) == 2:
+            reversed_map[name] = f"{parts[1]}-{parts[0]}"
 
-    # 构建原始 scene -> category 的映射（优先精确匹配，fallback 倒序匹配）
     scene_to_category: dict[str, object] = {}
     for name in unique_names:
         if name in category_map:
             scene_to_category[name] = category_map[name]
-        elif name in name_to_reversed and name_to_reversed[name] in category_map:
-            rev = name_to_reversed[name]
+        elif name in reversed_map and reversed_map[name] in category_map:
+            rev = reversed_map[name]
             scene_to_category[name] = category_map[rev]
             logger.info(
                 f"批量匹配顺序颠倒兜底命中: '{name}' -> '{rev}'"
             )
 
-    # 3. 收集所有需要的 category_id
+    # 3. 未匹配的 scene 回退到上级分类随机选取
+    unmatched = [name for name in unique_names if name not in scene_to_category]
+    for name in unmatched:
+        fallback_cat = await _try_fallback_to_parent(db, name)
+        if fallback_cat:
+            scene_to_category[name] = fallback_cat
+            logger.info(
+                f"批量匹配回退到上级分类命中: '{name}' -> '{fallback_cat.name}'"
+            )
+
+    # 4. 收集所有需要的 category_id
     needed_category_ids = [
         scene_to_category[name].id
         for name in unique_names
@@ -253,13 +362,25 @@ async def batch_match(
 
         category = scene_to_category.get(scene_name)
         if category is None:
+            original_scene = scenes[idx]["scene"]
+            logger.warning(
+                f"批量素材匹配失败: 未找到分类 '{scene_name}' (原始 scene: '{original_scene}')"
+            )
             results.append(None)
             continue
 
         materials = materials_by_category.get(category.id, [])
-        # 按时长过滤
+        # 按时长过滤（优先严格匹配，失败时逐步放宽到 70% 兜底）
         candidates = [m for m in materials if m.duration >= required_duration]
         if not candidates:
+            candidates = [m for m in materials if m.duration >= required_duration * 0.7]
+        if not candidates:
+            candidates = materials
+        if not candidates:
+            max_duration = max((m.duration for m in materials), default=0)
+            logger.warning(
+                f"批量素材匹配失败: 分类 '{scene_name}' -> '{category.name}' 无足够时长的素材 (需 >= {required_duration}s, 最大可用: {max_duration}s)"
+            )
             results.append(None)
             continue
 

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/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.2"
 description = "美家卡智影 - AI 视频创作后端 API"
 authors = [{ name = "Meijiaka Team" }]
 readme = "README.md"

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

@@ -56,7 +56,7 @@ async def seed_bgm():
                 artist=item.get("artist"),
                 category=item["category"],
                 file_path=item["file_path"],
-                url=item.get("url"),
+                url=item["url"],
                 duration=item.get("duration"),
                 status=item.get("status", "active"),
                 sort_order=item.get("sort_order", idx),

python-api/uv.lock

@@ -944,7 +944,7 @@ wheels = [
 
 [[package]]
 name = "meijiaka-ai-api"
-version = "1.5.18"
+version = "1.8.2"
 source = { virtual = "." }
 dependencies = [
     { name = "aiohttp" },

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

scripts/bump-version.py

@@ -224,10 +224,25 @@ def main():
     print("  - python-api/.env.example")
 
     if len(sys.argv) > 1:
+        # 自动提交版本更新，确保 tag 落在正确的 commit 上
+        subprocess.run(
+            ["git", "add", "-A"],
+            cwd=ROOT,
+            check=True,
+            capture_output=True,
+        )
+        subprocess.run(
+            ["git", "commit", "-m", f"bump version to {version}"],
+            cwd=ROOT,
+            check=True,
+            capture_output=True,
+        )
+        print(f"✅ 已提交: bump version to {version}")
         create_git_tag(version)
         print("\n下一步:")
-        print(f"  git add -A && git commit -m 'bump version to {version}'")
         print(f"  git push && git push origin v{version}")
+        print(f"  # 如果使用 GitHub Actions，同时推送到 GitHub remote:")
+        print(f"  git push github-new && git push github-new v{version}")
 
 
 if __name__ == "__main__":

scripts/check_all_duplicate_materials.sql

@@ -0,0 +1,36 @@
+-- 统计全部素材中的重复命名（整个素材库）
+-- ============================================
+
+-- 1. 按 title 分组，找出重复的素材
+SELECT
+    title,
+    COUNT(*) AS duplicate_count,
+    STRING_AGG(DISTINCT url, ', ' ORDER BY url) AS urls,
+    STRING_AGG(DISTINCT CAST(id AS TEXT), ', ' ORDER BY CAST(id AS TEXT)) AS ids
+FROM mjk_broll_materials
+WHERE status != 'deleted'
+GROUP BY title
+HAVING COUNT(*) > 1
+ORDER BY duplicate_count DESC, title;
+
+-- 2. 按 url 分组，找出重复的素材
+SELECT
+    url,
+    COUNT(*) AS duplicate_count,
+    STRING_AGG(DISTINCT title, ', ' ORDER BY title) AS titles,
+    STRING_AGG(DISTINCT CAST(id AS TEXT), ', ' ORDER BY CAST(id AS TEXT)) AS ids
+FROM mjk_broll_materials
+WHERE status != 'deleted'
+GROUP BY url
+HAVING COUNT(*) > 1
+ORDER BY duplicate_count DESC, url;
+
+-- 3. 统计概览：总素材数、唯一 title 数、唯一 url 数
+SELECT
+    COUNT(*) AS total_materials,
+    COUNT(DISTINCT title) AS unique_titles,
+    COUNT(DISTINCT url) AS unique_urls,
+    COUNT(*) - COUNT(DISTINCT title) AS title_duplicates,
+    COUNT(*) - COUNT(DISTINCT url) AS url_duplicates
+FROM mjk_broll_materials
+WHERE status != 'deleted';

scripts/fix_bikeng_slugs.sql

@@ -0,0 +1,92 @@
+-- 修正 slug：去掉中文字符，改为序号格式
+BEGIN;
+
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-001' WHERE name = '不要一体式卫生间' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-002' WHERE name = '不要双包套' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-003' WHERE name = '不要双开门冰箱' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-004' WHERE name = '不要反弹器' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-005' WHERE name = '不要回型吊顶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-006' WHERE name = '不要复杂吊灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-007' WHERE name = '不要复杂背景墙' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-008' WHERE name = '不要小双槽' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-009' WHERE name = '不要开放式收纳柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-010' WHERE name = '不要悬浮电视柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-011' WHERE name = '不要悬空马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-012' WHERE name = '不要拼色窗帘' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-013' WHERE name = '不要推拉门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-014' WHERE name = '不要插座外露' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-015' WHERE name = '不要无主灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-016' WHERE name = '不要普通门锁' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-017' WHERE name = '不要榻榻米' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-018' WHERE name = '不要正五孔插座' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-019' WHERE name = '不要洗烘一体' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-020' WHERE name = '不要深色地砖' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-021' WHERE name = '不要猫眼' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-022' WHERE name = '不要瓷砖上墙' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-023' WHERE name = '不要直吸马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-024' WHERE name = '不要直排下水' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-025' WHERE name = '不要筒灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-026' WHERE name = '不要罗马杠' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-027' WHERE name = '不要贵妃椅沙发' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-028' WHERE name = '不要路由器' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-029' WHERE name = '不要过门石' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-030' WHERE name = '不要造型柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-031' WHERE name = '不要阳角条' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-032' WHERE name = '不要隐形衣架' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-033' WHERE name = '不要集成灶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-034' WHERE name = '不要高光衣柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-035' WHERE name = '要一体门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-036' WHERE name = '要乳胶漆' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-037' WHERE name = '要免拉手' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-038' WHERE name = '要全屋WiFi' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-039' WHERE name = '要全屋通铺' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-040' WHERE name = '要分体灶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-041' WHERE name = '要十字开门冰箱' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-042' WHERE name = '要单包套' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-043' WHERE name = '要双眼皮' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-044' WHERE name = '要双眼皮吊顶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-045' WHERE name = '要吸顶灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-046' WHERE name = '要墙排下水' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-047' WHERE name = '要大单槽' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-048' WHERE name = '要封闭式收纳柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-049' WHERE name = '要射灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-050' WHERE name = '要干湿分离卫生间' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-051' WHERE name = '要平板柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-052' WHERE name = '要打通阳台' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-053' WHERE name = '要斜五孔插座' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-054' WHERE name = '要普通床' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-055' WHERE name = '要普通衣架' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-056' WHERE name = '要智能门锁' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-057' WHERE name = '要洗烘套装' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-058' WHERE name = '要浅色地砖' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-059' WHERE name = '要海棠角' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-060' WHERE name = '要直排沙发' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-061' WHERE name = '要窗帘盒' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-062' WHERE name = '要简约背景墙' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-063' WHERE name = '要纯色窗帘' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-064' WHERE name = '要肤感衣柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-065' WHERE name = '要落地电视柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-066' WHERE name = '要落地马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-067' WHERE name = '要虹吸马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-068' WHERE name = '要隐藏式插座' AND level = 3;
+
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-001' WHERE name = '乳胶漆不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-002' WHERE name = '全屋角阀要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-003' WHERE name = '前置过滤器不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-004' WHERE name = '床不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-005' WHERE name = '床垫要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-006' WHERE name = '开关插座要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-007' WHERE name = '投影仪要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-008' WHERE name = '木地板要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-009' WHERE name = '木门不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-010' WHERE name = '水槽不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-011' WHERE name = '水龙头要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-012' WHERE name = '滑轨要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-013' WHERE name = '灯具不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-014' WHERE name = '瓷砖不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-015' WHERE name = '电视机不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-016' WHERE name = '窗帘不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-017' WHERE name = '腻子粉要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-018' WHERE name = '门锁要买贵的' AND level = 3;
+
+COMMIT;

scripts/fix_bikeng_slugs_pinyin.sql

@@ -0,0 +1,92 @@
+-- 修正 slug：拼音首字母格式
+BEGIN;
+
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byytswsj' WHERE name = '不要一体式卫生间' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bysbt' WHERE name = '不要双包套' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byskmbx' WHERE name = '不要双开门冰箱' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byftq' WHERE name = '不要反弹器' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byhxdd' WHERE name = '不要回型吊顶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byfzdd' WHERE name = '不要复杂吊灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byfzbjq' WHERE name = '不要复杂背景墙' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byxsc' WHERE name = '不要小双槽' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bykfssng' WHERE name = '不要开放式收纳柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byxfdsg' WHERE name = '不要悬浮电视柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byxkmt' WHERE name = '不要悬空马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bypscl' WHERE name = '不要拼色窗帘' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bytlm' WHERE name = '不要推拉门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byczwl' WHERE name = '不要插座外露' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bywzd' WHERE name = '不要无主灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byptms' WHERE name = '不要普通门锁' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byttm' WHERE name = '不要榻榻米' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byzwkcz' WHERE name = '不要正五孔插座' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byxhyt' WHERE name = '不要洗烘一体' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byssdz' WHERE name = '不要深色地砖' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bymy' WHERE name = '不要猫眼' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byczsq' WHERE name = '不要瓷砖上墙' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byzxmt' WHERE name = '不要直吸马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byzpxs' WHERE name = '不要直排下水' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bytd' WHERE name = '不要筒灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bylmg' WHERE name = '不要罗马杠' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bygfysf' WHERE name = '不要贵妃椅沙发' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bylyq' WHERE name = '不要路由器' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-bygms' WHERE name = '不要过门石' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byzxgm' WHERE name = '不要造型柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byyjt' WHERE name = '不要阳角条' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byyxyj' WHERE name = '不要隐形衣架' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byjcz' WHERE name = '不要集成灶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-byggygm' WHERE name = '不要高光衣柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yytm' WHERE name = '要一体门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yrjq' WHERE name = '要乳胶漆' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ymls' WHERE name = '要免拉手' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yqwwifi' WHERE name = '要全屋WiFi' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yqwtp' WHERE name = '要全屋通铺' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yftz' WHERE name = '要分体灶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yszkmbx' WHERE name = '要十字开门冰箱' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ydbt' WHERE name = '要单包套' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ysyp' WHERE name = '要双眼皮' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ysypdd' WHERE name = '要双眼皮吊顶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yxdd' WHERE name = '要吸顶灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yqpxs' WHERE name = '要墙排下水' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yddc' WHERE name = '要大单槽' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yfbssng' WHERE name = '要封闭式收纳柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ysd' WHERE name = '要射灯' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ygsflwsj' WHERE name = '要干湿分离卫生间' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ypbgm' WHERE name = '要平板柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ydtyt' WHERE name = '要打通阳台' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yxwkcz' WHERE name = '要斜五孔插座' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yptc' WHERE name = '要普通床' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yptyj' WHERE name = '要普通衣架' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yznms' WHERE name = '要智能门锁' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yxhtz' WHERE name = '要洗烘套装' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yqsdz' WHERE name = '要浅色地砖' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yhtj' WHERE name = '要海棠角' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yzpsf' WHERE name = '要直排沙发' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yclh' WHERE name = '要窗帘盒' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yjybjq' WHERE name = '要简约背景墙' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ycscl' WHERE name = '要纯色窗帘' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yfgygm' WHERE name = '要肤感衣柜门' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-ylddsg' WHERE name = '要落地电视柜' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yldmt' WHERE name = '要落地马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yhxmt' WHERE name = '要虹吸马桶' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-buyao-yycscz' WHERE name = '要隐藏式插座' AND level = 3;
+
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-rjqbymgd' WHERE name = '乳胶漆不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-qwjfymgd' WHERE name = '全屋角阀要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-qzglqbymgd' WHERE name = '前置过滤器不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-cbymgd' WHERE name = '床不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-cdymgd' WHERE name = '床垫要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-kgczymgd' WHERE name = '开关插座要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-tyyymgd' WHERE name = '投影仪要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-mdbymgd' WHERE name = '木地板要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-mmbymgd' WHERE name = '木门不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-scbymgd' WHERE name = '水槽不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-sltymgd' WHERE name = '水龙头要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-hgymgd' WHERE name = '滑轨要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-djbymgd' WHERE name = '灯具不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-czbymgd' WHERE name = '瓷砖不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-dsjbymgd' WHERE name = '电视机不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-clbymgd' WHERE name = '窗帘不要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-nzfymgd' WHERE name = '腻子粉要买贵的' AND level = 3;
+UPDATE mjk_broll_categories SET slug = 'bikeng-maidui-msymgd' WHERE name = '门锁要买贵的' AND level = 3;
+
+COMMIT;

scripts/insert_cover_backgrounds_bk.sql

@@ -0,0 +1,47 @@
+-- 封面背景图批量导入 SQL
+-- script_code: bk（装修避坑）
+-- 生成时间: 2026-06-01
+-- 共 41 张
+
+INSERT INTO mjk_cover_backgrounds (script_code, title, url, sort_order, status, created_at, updated_at) VALUES
+  ('bk', '04e1bd3b19', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/04e1bd3b19.png', 1, 'active', NOW(), NOW())
+,   ('bk', '1c7d6b9ce9', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/1c7d6b9ce9.png', 2, 'active', NOW(), NOW())
+,   ('bk', '2508cc7679', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/2508cc7679.png', 3, 'active', NOW(), NOW())
+,   ('bk', '280bc39306', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/280bc39306.png', 4, 'active', NOW(), NOW())
+,   ('bk', '2bb52b3f65', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/2bb52b3f65.png', 5, 'active', NOW(), NOW())
+,   ('bk', '2c08dbd929', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/2c08dbd929.png', 6, 'active', NOW(), NOW())
+,   ('bk', '3079192f62', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/3079192f62.png', 7, 'active', NOW(), NOW())
+,   ('bk', '3409a04e66', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/3409a04e66.png', 8, 'active', NOW(), NOW())
+,   ('bk', '3cd57f9008', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/3cd57f9008.png', 9, 'active', NOW(), NOW())
+,   ('bk', '4a7555e3f0', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/4a7555e3f0.png', 10, 'active', NOW(), NOW())
+,   ('bk', '4c3965959a', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/4c3965959a.png', 11, 'active', NOW(), NOW())
+,   ('bk', '4cecdd5f83', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/4cecdd5f83.png', 12, 'active', NOW(), NOW())
+,   ('bk', '54b164fef1', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/54b164fef1.png', 13, 'active', NOW(), NOW())
+,   ('bk', '5fd98a1da7', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/5fd98a1da7.png', 14, 'active', NOW(), NOW())
+,   ('bk', '645f2970bf', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/645f2970bf.png', 15, 'active', NOW(), NOW())
+,   ('bk', '70cb74ee0e', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/70cb74ee0e.png', 16, 'active', NOW(), NOW())
+,   ('bk', '76955a5f76', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/76955a5f76.png', 17, 'active', NOW(), NOW())
+,   ('bk', '8395b3784a', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/8395b3784a.png', 18, 'active', NOW(), NOW())
+,   ('bk', '85c6ed85e1', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/85c6ed85e1.png', 19, 'active', NOW(), NOW())
+,   ('bk', '95ff4cf029', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/95ff4cf029.png', 20, 'active', NOW(), NOW())
+,   ('bk', '979dfb0215', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/979dfb0215.png', 21, 'active', NOW(), NOW())
+,   ('bk', 'a12d375624', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/a12d375624.png', 22, 'active', NOW(), NOW())
+,   ('bk', 'a1411511aa', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/a1411511aa.png', 23, 'active', NOW(), NOW())
+,   ('bk', 'a16a0b348c', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/a16a0b348c.png', 24, 'active', NOW(), NOW())
+,   ('bk', 'ae4ed9a335', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/ae4ed9a335.png', 25, 'active', NOW(), NOW())
+,   ('bk', 'c07f6556fd', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/c07f6556fd.png', 26, 'active', NOW(), NOW())
+,   ('bk', 'c1460b5f5a', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/c1460b5f5a.png', 27, 'active', NOW(), NOW())
+,   ('bk', 'cd8b455000', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/cd8b455000.png', 28, 'active', NOW(), NOW())
+,   ('bk', 'd16d93b73d', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/d16d93b73d.png', 29, 'active', NOW(), NOW())
+,   ('bk', 'd18088bb3f', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/d18088bb3f.png', 30, 'active', NOW(), NOW())
+,   ('bk', 'd540fc6c4b', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/d540fc6c4b.png', 31, 'active', NOW(), NOW())
+,   ('bk', 'dbf4c4ff92', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/dbf4c4ff92.png', 32, 'active', NOW(), NOW())
+,   ('bk', 'dce3d6fb91', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/dce3d6fb91.png', 33, 'active', NOW(), NOW())
+,   ('bk', 'ec8c953ccb', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/ec8c953ccb.png', 34, 'active', NOW(), NOW())
+,   ('bk', 'ef9575b715', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/ef9575b715.png', 35, 'active', NOW(), NOW())
+,   ('bk', 'f3023c5554', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/f3023c5554.png', 36, 'active', NOW(), NOW())
+,   ('bk', 'f4679775ce', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/f4679775ce.png', 37, 'active', NOW(), NOW())
+,   ('bk', 'f9192aa4a9', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/f9192aa4a9.png', 38, 'active', NOW(), NOW())
+,   ('bk', 'f98d79311e', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/f98d79311e.png', 39, 'active', NOW(), NOW())
+,   ('bk', 'fadcca7a06', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/fadcca7a06.png', 40, 'active', NOW(), NOW())
+,   ('bk', 'fb04e41a2c', 'https://img.liche.cn/meijiaka-zy/cover_templete/bk/fb04e41a2c.png', 41, 'active', NOW(), NOW());

scripts/insert_new_materials_6.2.sql

@@ -0,0 +1,72 @@
+-- 新增素材6.2 批量导入 SQL
+-- 共 67 个素材
+-- URL前缀: https://media.liche.cn/meijiaka-zy/materials/
+
+INSERT INTO mjk_broll_materials (category_id, title, url, duration, usage_count, status, created_at, updated_at) VALUES
+  ((SELECT id FROM mjk_broll_categories WHERE name = '万华爱格兔宝宝' AND level = 3), '3c28619290414e552e988e09b3675b72', 'https://media.liche.cn/meijiaka-zy/materials/3c28619290414e552e988e09b3675b72.mp4', 5.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '东鹏冠珠马可波罗' AND level = 3), '182e4c8bbcea8f103672b147b4606213', 'https://media.liche.cn/meijiaka-zy/materials/182e4c8bbcea8f103672b147b4606213.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '九牧恒洁箭牌' AND level = 3), '7d5607ab1886ba948fc1e94398473274', 'https://media.liche.cn/meijiaka-zy/materials/7d5607ab1886ba948fc1e94398473274.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '九牧箭牌潜水艇' AND level = 3), '6924bfd00653c3c6cfcb2d1d02c4789c', 'https://media.liche.cn/meijiaka-zy/materials/6924bfd00653c3c6cfcb2d1d02c4789c.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '乳胶漆买谁家' AND level = 3), '6086a32ec41db26e5bc570f1f27c1fbc', 'https://media.liche.cn/meijiaka-zy/materials/6086a32ec41db26e5bc570f1f27c1fbc.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '公牛施耐德西门子' AND level = 3), 'c0a3e230b32026b78596c192718345cb', 'https://media.liche.cn/meijiaka-zy/materials/c0a3e230b32026b78596c192718345cb.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '冰箱买谁家' AND level = 3), 'fad1e564d3272515eab8dd75079870de', 'https://media.liche.cn/meijiaka-zy/materials/fad1e564d3272515eab8dd75079870de.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '厨卫五金谁家好' AND level = 3), '4d20e0593c973366e064451fd9561eff', 'https://media.liche.cn/meijiaka-zy/materials/4d20e0593c973366e064451fd9561eff.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '吊顶选谁家' AND level = 3), '4ee89978139e0e55c809aedf5a56ddc2', 'https://media.liche.cn/meijiaka-zy/materials/4ee89978139e0e55c809aedf5a56ddc2.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '圣象世友大自然' AND level = 3), '5c78732634c008867211a9a34d124881', 'https://media.liche.cn/meijiaka-zy/materials/5c78732634c008867211a9a34d124881.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '地板哪家好' AND level = 3), '647972fffa483aa807ecd08ed53219be', 'https://media.liche.cn/meijiaka-zy/materials/647972fffa483aa807ecd08ed53219be.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '地漏谁家好' AND level = 3), 'd4fb5c1a8bf3cecf8662f82b6977a954', 'https://media.liche.cn/meijiaka-zy/materials/d4fb5c1a8bf3cecf8662f82b6977a954.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '奥普友邦法狮龙' AND level = 3), 'a6cc0fb2a45ea0e4b988451baddac499', 'https://media.liche.cn/meijiaka-zy/materials/a6cc0fb2a45ea0e4b988451baddac499.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家装水泥谁家好' AND level = 3), 'e189e0507cd2ecb0be2e32d2cf65dccd', 'https://media.liche.cn/meijiaka-zy/materials/e189e0507cd2ecb0be2e32d2cf65dccd.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家装水管谁家好' AND level = 3), '72d9643978717084039cf3507f9bdd04', 'https://media.liche.cn/meijiaka-zy/materials/72d9643978717084039cf3507f9bdd04.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '开关插座买谁家' AND level = 3), '8df9cfec100cea2661784361571a3a11', 'https://media.liche.cn/meijiaka-zy/materials/8df9cfec100cea2661784361571a3a11.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '德高西卡马贝' AND level = 3), 'b365eb193c1ede5777cc04d2427ea0e7', 'https://media.liche.cn/meijiaka-zy/materials/b365eb193c1ede5777cc04d2427ea0e7.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '方太老板华帝' AND level = 3), '9e37037aad90b25493228d05c0405696', 'https://media.liche.cn/meijiaka-zy/materials/9e37037aad90b25493228d05c0405696.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '日丰伟星保利' AND level = 3), '3318c054d10f5ecca8ce397f435c01af', 'https://media.liche.cn/meijiaka-zy/materials/3318c054d10f5ecca8ce397f435c01af.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '板材选谁家' AND level = 3), '9e5eb608644425a51613e2e145ba28e0', 'https://media.liche.cn/meijiaka-zy/materials/9e5eb608644425a51613e2e145ba28e0.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '水管买谁家' AND level = 3), '0d37b9dbf4b44858f16f155ba88a7054', 'https://media.liche.cn/meijiaka-zy/materials/0d37b9dbf4b44858f16f155ba88a7054.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '海尔美的卡萨帝' AND level = 3), '33e3a3ae93f65e72d055431b0d132495', 'https://media.liche.cn/meijiaka-zy/materials/33e3a3ae93f65e72d055431b0d132495.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '海螺红狮中联' AND level = 3), 'cd7f119729a062df350940bb003f873d', 'https://media.liche.cn/meijiaka-zy/materials/cd7f119729a062df350940bb003f873d.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '烟机哪家好' AND level = 3), '01690f5d76a40142f365da61319c9f31', 'https://media.liche.cn/meijiaka-zy/materials/01690f5d76a40142f365da61319c9f31.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '玻璃胶谁家好' AND level = 3), '52d7c9db8291af1d9e2061c3288bec2b', 'https://media.liche.cn/meijiaka-zy/materials/52d7c9db8291af1d9e2061c3288bec2b.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '瓦克西卡百得' AND level = 3), '1e2774b366631016acecc03c322dc0a2', 'https://media.liche.cn/meijiaka-zy/materials/1e2774b366631016acecc03c322dc0a2.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '瓷砖哪家好' AND level = 3), 'e727f0ea33030c14d33185329794398c', 'https://media.liche.cn/meijiaka-zy/materials/e727f0ea33030c14d33185329794398c.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '瓷砖胶谁家好' AND level = 3), '07a1f9a9ec09809d33781a2b6265ff48', 'https://media.liche.cn/meijiaka-zy/materials/07a1f9a9ec09809d33781a2b6265ff48.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '电线买谁家' AND level = 3), '04f61f5a57454799d2aa1000764311af', 'https://media.liche.cn/meijiaka-zy/materials/04f61f5a57454799d2aa1000764311af.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '电视买谁家' AND level = 3), '82c400fbc27c42dd8992458d2e94c047', 'https://media.liche.cn/meijiaka-zy/materials/82c400fbc27c42dd8992458d2e94c047.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '石膏板谁家好' AND level = 3), 'e6469a2dc66350c330d2d87f08a9cd5a', 'https://media.liche.cn/meijiaka-zy/materials/e6469a2dc66350c330d2d87f08a9cd5a.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '科勒九牧汉斯格雅' AND level = 3), '80506a9eb5e1a06d3c5cb98eaae515cd', 'https://media.liche.cn/meijiaka-zy/materials/80506a9eb5e1a06d3c5cb98eaae515cd.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '立邦三棵树多乐士' AND level = 3), '82b26195cdb7a08793abf3ff17d400eb', 'https://media.liche.cn/meijiaka-zy/materials/82b26195cdb7a08793abf3ff17d400eb.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '立邦德高东方雨虹' AND level = 3), '03602a66190ad519f81c70a80e6cd0d2', 'https://media.liche.cn/meijiaka-zy/materials/03602a66190ad519f81c70a80e6cd0d2.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '立邦美巢圣戈邦' AND level = 3), 'cc00321964988a29315468e4dca53d06', 'https://media.liche.cn/meijiaka-zy/materials/cc00321964988a29315468e4dca53d06.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '索尼海信TCL' AND level = 3), 'fb9d3b062be7ed44fef7ec81490a4963', 'https://media.liche.cn/meijiaka-zy/materials/fb9d3b062be7ed44fef7ec81490a4963.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '腻子粉哪家好' AND level = 3), '887c5ea3238d2c1196eb09c410dc8f7f', 'https://media.liche.cn/meijiaka-zy/materials/887c5ea3238d2c1196eb09c410dc8f7f.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '花洒哪家好' AND level = 3), 'f6d4592e08482cb903daca04d432f3ed', 'https://media.liche.cn/meijiaka-zy/materials/f6d4592e08482cb903daca04d432f3ed.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '远东宝胜熊猫' AND level = 3), 'c5ac8d8ff5435e123c8016657fbf955c', 'https://media.liche.cn/meijiaka-zy/materials/c5ac8d8ff5435e123c8016657fbf955c.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '金牛伟星日丰' AND level = 3), '3c9546527a38c300050ed28bda81e204', 'https://media.liche.cn/meijiaka-zy/materials/3c9546527a38c300050ed28bda81e204.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '防水买谁家' AND level = 3), '3e7c5b554836376605828f374bd15ae5', 'https://media.liche.cn/meijiaka-zy/materials/3e7c5b554836376605828f374bd15ae5.mp4', 3.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '龙牌泰山可耐福' AND level = 3), '6589ffbf04c596583d2d2316216c7428', 'https://media.liche.cn/meijiaka-zy/materials/6589ffbf04c596583d2d2316216c7428.mp4', 5.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '488d5a9ac72bf8e9a2a574284f2bdded', 'https://media.liche.cn/meijiaka-zy/materials/488d5a9ac72bf8e9a2a574284f2bdded.mp4', 10.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '3c716b567964591569abfc8d16e7ff9b', 'https://media.liche.cn/meijiaka-zy/materials/3c716b567964591569abfc8d16e7ff9b.mp4', 9.97, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '2fb5183ef1547fb3d7d4d8e56fe5154a', 'https://media.liche.cn/meijiaka-zy/materials/2fb5183ef1547fb3d7d4d8e56fe5154a.mp4', 10.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '0d7081072e409e8f2c7d3a61a793f348', 'https://media.liche.cn/meijiaka-zy/materials/0d7081072e409e8f2c7d3a61a793f348.mp4', 10.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), 'f083bfca1800c171af2dfc767fc5d28a', 'https://media.liche.cn/meijiaka-zy/materials/f083bfca1800c171af2dfc767fc5d28a.mp4', 8.48, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '8e198970fe0be12c9067fefe658d1cdd', 'https://media.liche.cn/meijiaka-zy/materials/8e198970fe0be12c9067fefe658d1cdd.mp4', 9.8, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '3763505e431dc39a9fef135ad82ee6f1', 'https://media.liche.cn/meijiaka-zy/materials/3763505e431dc39a9fef135ad82ee6f1.mp4', 9.92, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '0576abe034e932071d7c3b67104e79c3', 'https://media.liche.cn/meijiaka-zy/materials/0576abe034e932071d7c3b67104e79c3.mp4', 9.9, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), '07281a59949dcaa72c22b54b8569e1ea', 'https://media.liche.cn/meijiaka-zy/materials/07281a59949dcaa72c22b54b8569e1ea.mp4', 4.71, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '装烟机灶具-主材安装镜' AND level = 3), 'e8d1429ec925636603b69b57ca3eba52', 'https://media.liche.cn/meijiaka-zy/materials/e8d1429ec925636603b69b57ca3eba52.mp4', 4.09, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), '9d516288fc104f41e3a4c3747883a072', 'https://media.liche.cn/meijiaka-zy/materials/9d516288fc104f41e3a4c3747883a072.mp4', 6.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), '8b293fcabbf5e8dc2f84a77e9cbb9956', 'https://media.liche.cn/meijiaka-zy/materials/8b293fcabbf5e8dc2f84a77e9cbb9956.mp4', 6.18, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), '432a789688f8f729ec72ccbf8571820a', 'https://media.liche.cn/meijiaka-zy/materials/432a789688f8f729ec72ccbf8571820a.mp4', 10.0, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), '3a97f3ebd82b3ff8c04ec47871199159', 'https://media.liche.cn/meijiaka-zy/materials/3a97f3ebd82b3ff8c04ec47871199159.mp4', 5.62, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), 'a67d0a41c10ea002968fb0ed1ad8ae0e', 'https://media.liche.cn/meijiaka-zy/materials/a67d0a41c10ea002968fb0ed1ad8ae0e.mp4', 8.55, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), '6b28e44d37a14c3d9ac8b503a29a421c', 'https://media.liche.cn/meijiaka-zy/materials/6b28e44d37a14c3d9ac8b503a29a421c.mp4', 8.92, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), '9468e8aba0f47eeef9bc59e395bfcc72', 'https://media.liche.cn/meijiaka-zy/materials/9468e8aba0f47eeef9bc59e395bfcc72.mp4', 10.2, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '封窗施工-封窗镜' AND level = 3), 'b5d109f43246296ca6de51d28e596dcd', 'https://media.liche.cn/meijiaka-zy/materials/b5d109f43246296ca6de51d28e596dcd.mp4', 10.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家具进场摆放就位-软装进场镜' AND level = 3), 'a15878e831df63d8cffc1066bf25e257', 'https://media.liche.cn/meijiaka-zy/materials/a15878e831df63d8cffc1066bf25e257.mp4', 7.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家具进场摆放就位-软装进场镜' AND level = 3), '1622140bd7229107b38927b831f8bea8', 'https://media.liche.cn/meijiaka-zy/materials/1622140bd7229107b38927b831f8bea8.mp4', 10.01, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家具进场摆放就位-软装进场镜' AND level = 3), '5ef57acfda494cfdfb5185594c51364c', 'https://media.liche.cn/meijiaka-zy/materials/5ef57acfda494cfdfb5185594c51364c.mp4', 7.85, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家具进场摆放就位-软装进场镜' AND level = 3), '4473c9736c25e77375459bd2968f4753', 'https://media.liche.cn/meijiaka-zy/materials/4473c9736c25e77375459bd2968f4753.mp4', 6.11, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家具进场摆放就位-软装进场镜' AND level = 3), '67526f381c629710d78c53ec3a2f6941', 'https://media.liche.cn/meijiaka-zy/materials/67526f381c629710d78c53ec3a2f6941.mp4', 5.2, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家具进场摆放就位-软装进场镜' AND level = 3), '1690725fa66d82b9400e462839328658', 'https://media.liche.cn/meijiaka-zy/materials/1690725fa66d82b9400e462839328658.mp4', 7.41, 0, 'active', NOW(), NOW()),
+  ((SELECT id FROM mjk_broll_categories WHERE name = '家具进场摆放就位-软装进场镜' AND level = 3), '28b67c0a7565ff259f889456334d000d', 'https://media.liche.cn/meijiaka-zy/materials/28b67c0a7565ff259f889456334d000d.mp4', 9.45, 0, 'active', NOW(), NOW());

scripts/seed_bikeng_categories.sql

@@ -0,0 +1,202 @@
+-- 装修避坑通用素材分类体系
+-- 共 86 个三级分类（68 个不要X要Y + 18 个买对不买贵）
+
+DO $$
+DECLARE
+    l1_id bigint;
+    l2_buyao_id bigint;
+    l2_maidui_id bigint;
+BEGIN
+
+    -- 一级：装修避坑通用
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-tongyong', '装修避坑通用', NULL, 1, 90, 'active', NOW(), NOW())
+    RETURNING id INTO l1_id;
+
+    -- 二级：不要X要Y
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao', '不要X要Y', l1_id, 2, 1, 'active', NOW(), NOW())
+    RETURNING id INTO l2_buyao_id;
+
+    -- 二级：买对不买贵
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui', '买对不买贵', l1_id, 2, 2, 'active', NOW(), NOW())
+    RETURNING id INTO l2_maidui_id;
+
+    -- 三级：不要X要Y（68个）
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要一体式卫生间', '不要一体式卫生间', l2_buyao_id, 3, 1, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要双包套', '不要双包套', l2_buyao_id, 3, 2, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要双开门冰箱', '不要双开门冰箱', l2_buyao_id, 3, 3, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要反弹器', '不要反弹器', l2_buyao_id, 3, 4, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要回型吊顶', '不要回型吊顶', l2_buyao_id, 3, 5, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要复杂吊灯', '不要复杂吊灯', l2_buyao_id, 3, 6, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要复杂背景墙', '不要复杂背景墙', l2_buyao_id, 3, 7, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要小双槽', '不要小双槽', l2_buyao_id, 3, 8, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要开放式收纳柜', '不要开放式收纳柜', l2_buyao_id, 3, 9, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要悬浮电视柜', '不要悬浮电视柜', l2_buyao_id, 3, 10, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要悬空马桶', '不要悬空马桶', l2_buyao_id, 3, 11, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要拼色窗帘', '不要拼色窗帘', l2_buyao_id, 3, 12, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要推拉门', '不要推拉门', l2_buyao_id, 3, 13, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要插座外露', '不要插座外露', l2_buyao_id, 3, 14, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要无主灯', '不要无主灯', l2_buyao_id, 3, 15, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要普通门锁', '不要普通门锁', l2_buyao_id, 3, 16, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要榻榻米', '不要榻榻米', l2_buyao_id, 3, 17, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要正五孔插座', '不要正五孔插座', l2_buyao_id, 3, 18, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要洗烘一体', '不要洗烘一体', l2_buyao_id, 3, 19, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要深色地砖', '不要深色地砖', l2_buyao_id, 3, 20, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要猫眼', '不要猫眼', l2_buyao_id, 3, 21, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要瓷砖上墙', '不要瓷砖上墙', l2_buyao_id, 3, 22, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要直吸马桶', '不要直吸马桶', l2_buyao_id, 3, 23, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要直排下水', '不要直排下水', l2_buyao_id, 3, 24, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要筒灯', '不要筒灯', l2_buyao_id, 3, 25, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要罗马杠', '不要罗马杠', l2_buyao_id, 3, 26, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要贵妃椅沙发', '不要贵妃椅沙发', l2_buyao_id, 3, 27, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要路由器', '不要路由器', l2_buyao_id, 3, 28, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要过门石', '不要过门石', l2_buyao_id, 3, 29, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要造型柜门', '不要造型柜门', l2_buyao_id, 3, 30, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要阳角条', '不要阳角条', l2_buyao_id, 3, 31, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要隐形衣架', '不要隐形衣架', l2_buyao_id, 3, 32, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要集成灶', '不要集成灶', l2_buyao_id, 3, 33, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-不要高光衣柜门', '不要高光衣柜门', l2_buyao_id, 3, 34, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要一体门', '要一体门', l2_buyao_id, 3, 35, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要乳胶漆', '要乳胶漆', l2_buyao_id, 3, 36, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要免拉手', '要免拉手', l2_buyao_id, 3, 37, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要全屋wifi', '要全屋WiFi', l2_buyao_id, 3, 38, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要全屋通铺', '要全屋通铺', l2_buyao_id, 3, 39, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要分体灶', '要分体灶', l2_buyao_id, 3, 40, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要十字开门冰箱', '要十字开门冰箱', l2_buyao_id, 3, 41, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要单包套', '要单包套', l2_buyao_id, 3, 42, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要双眼皮', '要双眼皮', l2_buyao_id, 3, 43, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要双眼皮吊顶', '要双眼皮吊顶', l2_buyao_id, 3, 44, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要吸顶灯', '要吸顶灯', l2_buyao_id, 3, 45, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要墙排下水', '要墙排下水', l2_buyao_id, 3, 46, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要大单槽', '要大单槽', l2_buyao_id, 3, 47, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要封闭式收纳柜', '要封闭式收纳柜', l2_buyao_id, 3, 48, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要射灯', '要射灯', l2_buyao_id, 3, 49, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要干湿分离卫生间', '要干湿分离卫生间', l2_buyao_id, 3, 50, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要平板柜门', '要平板柜门', l2_buyao_id, 3, 51, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要打通阳台', '要打通阳台', l2_buyao_id, 3, 52, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要斜五孔插座', '要斜五孔插座', l2_buyao_id, 3, 53, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要普通床', '要普通床', l2_buyao_id, 3, 54, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要普通衣架', '要普通衣架', l2_buyao_id, 3, 55, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要智能门锁', '要智能门锁', l2_buyao_id, 3, 56, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要洗烘套装', '要洗烘套装', l2_buyao_id, 3, 57, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要浅色地砖', '要浅色地砖', l2_buyao_id, 3, 58, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要海棠角', '要海棠角', l2_buyao_id, 3, 59, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要直排沙发', '要直排沙发', l2_buyao_id, 3, 60, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要窗帘盒', '要窗帘盒', l2_buyao_id, 3, 61, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要简约背景墙', '要简约背景墙', l2_buyao_id, 3, 62, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要纯色窗帘', '要纯色窗帘', l2_buyao_id, 3, 63, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要肤感衣柜门', '要肤感衣柜门', l2_buyao_id, 3, 64, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要落地电视柜', '要落地电视柜', l2_buyao_id, 3, 65, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要落地马桶', '要落地马桶', l2_buyao_id, 3, 66, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要虹吸马桶', '要虹吸马桶', l2_buyao_id, 3, 67, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-buyao-要隐藏式插座', '要隐藏式插座', l2_buyao_id, 3, 68, 'active', NOW(), NOW());
+
+    -- 三级：买对不买贵（18个）
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-乳胶漆不要买贵的', '乳胶漆不要买贵的', l2_maidui_id, 3, 1, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-全屋角阀要买贵的', '全屋角阀要买贵的', l2_maidui_id, 3, 2, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-前置过滤器不要买贵的', '前置过滤器不要买贵的', l2_maidui_id, 3, 3, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-床不要买贵的', '床不要买贵的', l2_maidui_id, 3, 4, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-床垫要买贵的', '床垫要买贵的', l2_maidui_id, 3, 5, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-开关插座要买贵的', '开关插座要买贵的', l2_maidui_id, 3, 6, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-投影仪要买贵的', '投影仪要买贵的', l2_maidui_id, 3, 7, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-木地板要买贵的', '木地板要买贵的', l2_maidui_id, 3, 8, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-木门不要买贵的', '木门不要买贵的', l2_maidui_id, 3, 9, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-水槽不要买贵的', '水槽不要买贵的', l2_maidui_id, 3, 10, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-水龙头要买贵的', '水龙头要买贵的', l2_maidui_id, 3, 11, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-滑轨要买贵的', '滑轨要买贵的', l2_maidui_id, 3, 12, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-灯具不要买贵的', '灯具不要买贵的', l2_maidui_id, 3, 13, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-瓷砖不要买贵的', '瓷砖不要买贵的', l2_maidui_id, 3, 14, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-电视机不要买贵的', '电视机不要买贵的', l2_maidui_id, 3, 15, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-窗帘不要买贵的', '窗帘不要买贵的', l2_maidui_id, 3, 16, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-腻子粉要买贵的', '腻子粉要买贵的', l2_maidui_id, 3, 17, 'active', NOW(), NOW());
+    INSERT INTO mjk_broll_categories (slug, name, parent_id, level, sort_order, status, created_at, updated_at)
+    VALUES ('bikeng-maidui-门锁要买贵的', '门锁要买贵的', l2_maidui_id, 3, 18, 'active', NOW(), NOW());
+
+END $$;

scripts/upload_new_materials_6.2.sh

@@ -0,0 +1,203 @@
+#!/bin/bash
+# 新增素材6.2 批量上传脚本
+
+# 万华爱格兔宝宝 (5.0s)
+qshell fput meijiaka-zy materials/3c28619290414e552e988e09b3675b72.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/万华爱格兔宝宝/3c28619290414e552e988e09b3675b72.mp4'
+
+# 东鹏冠珠马可波罗 (5.01s)
+qshell fput meijiaka-zy materials/182e4c8bbcea8f103672b147b4606213.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/东鹏冠珠马可波罗/182e4c8bbcea8f103672b147b4606213.mp4'
+
+# 九牧恒洁箭牌 (5.01s)
+qshell fput meijiaka-zy materials/7d5607ab1886ba948fc1e94398473274.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/九牧恒洁箭牌/7d5607ab1886ba948fc1e94398473274.mp4'
+
+# 九牧箭牌潜水艇 (5.01s)
+qshell fput meijiaka-zy materials/6924bfd00653c3c6cfcb2d1d02c4789c.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/九牧箭牌潜水艇/6924bfd00653c3c6cfcb2d1d02c4789c.mp4'
+
+# 乳胶漆买谁家 (3.0s)
+qshell fput meijiaka-zy materials/6086a32ec41db26e5bc570f1f27c1fbc.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/乳胶漆买谁家/6086a32ec41db26e5bc570f1f27c1fbc.mp4'
+
+# 公牛施耐德西门子 (5.01s)
+qshell fput meijiaka-zy materials/c0a3e230b32026b78596c192718345cb.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/公牛施耐德西门子/c0a3e230b32026b78596c192718345cb.mp4'
+
+# 冰箱买谁家 (3.0s)
+qshell fput meijiaka-zy materials/fad1e564d3272515eab8dd75079870de.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/冰箱买谁家/fad1e564d3272515eab8dd75079870de.mp4'
+
+# 厨卫五金谁家好 (3.0s)
+qshell fput meijiaka-zy materials/4d20e0593c973366e064451fd9561eff.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/厨卫五金谁家好/4d20e0593c973366e064451fd9561eff.mp4'
+
+# 吊顶选谁家 (3.0s)
+qshell fput meijiaka-zy materials/4ee89978139e0e55c809aedf5a56ddc2.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/吊顶选谁家/4ee89978139e0e55c809aedf5a56ddc2.mp4'
+
+# 圣象世友大自然 (5.01s)
+qshell fput meijiaka-zy materials/5c78732634c008867211a9a34d124881.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/圣象世友大自然/5c78732634c008867211a9a34d124881.mp4'
+
+# 地板哪家好 (3.0s)
+qshell fput meijiaka-zy materials/647972fffa483aa807ecd08ed53219be.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/地板哪家好/647972fffa483aa807ecd08ed53219be.mp4'
+
+# 地漏谁家好 (3.0s)
+qshell fput meijiaka-zy materials/d4fb5c1a8bf3cecf8662f82b6977a954.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/地漏谁家好/d4fb5c1a8bf3cecf8662f82b6977a954.mp4'
+
+# 奥普友邦法狮龙 (5.01s)
+qshell fput meijiaka-zy materials/a6cc0fb2a45ea0e4b988451baddac499.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/奥普友邦法狮龙/a6cc0fb2a45ea0e4b988451baddac499.mp4'
+
+# 家装水泥谁家好 (3.0s)
+qshell fput meijiaka-zy materials/e189e0507cd2ecb0be2e32d2cf65dccd.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/家装水泥谁家好/e189e0507cd2ecb0be2e32d2cf65dccd.mp4'
+
+# 家装水管谁家好 (3.0s)
+qshell fput meijiaka-zy materials/72d9643978717084039cf3507f9bdd04.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/家装水管谁家好/72d9643978717084039cf3507f9bdd04.mp4'
+
+# 开关插座买谁家 (3.0s)
+qshell fput meijiaka-zy materials/8df9cfec100cea2661784361571a3a11.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/开关插座买谁家/8df9cfec100cea2661784361571a3a11.mp4'
+
+# 德高西卡马贝 (5.01s)
+qshell fput meijiaka-zy materials/b365eb193c1ede5777cc04d2427ea0e7.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/德高西卡马贝/b365eb193c1ede5777cc04d2427ea0e7.mp4'
+
+# 方太老板华帝 (5.01s)
+qshell fput meijiaka-zy materials/9e37037aad90b25493228d05c0405696.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/方太老板华帝/9e37037aad90b25493228d05c0405696.mp4'
+
+# 日丰伟星保利 (5.01s)
+qshell fput meijiaka-zy materials/3318c054d10f5ecca8ce397f435c01af.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/日丰伟星保利/3318c054d10f5ecca8ce397f435c01af.mp4'
+
+# 板材选谁家 (3.0s)
+qshell fput meijiaka-zy materials/9e5eb608644425a51613e2e145ba28e0.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/板材选谁家/9e5eb608644425a51613e2e145ba28e0.mp4'
+
+# 水管买谁家 (3.0s)
+qshell fput meijiaka-zy materials/0d37b9dbf4b44858f16f155ba88a7054.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/水管买谁家/0d37b9dbf4b44858f16f155ba88a7054.mp4'
+
+# 海尔美的卡萨帝 (5.01s)
+qshell fput meijiaka-zy materials/33e3a3ae93f65e72d055431b0d132495.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/海尔美的卡萨帝/33e3a3ae93f65e72d055431b0d132495.mp4'
+
+# 海螺红狮中联 (5.01s)
+qshell fput meijiaka-zy materials/cd7f119729a062df350940bb003f873d.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/海螺红狮中联/cd7f119729a062df350940bb003f873d.mp4'
+
+# 烟机哪家好 (3.0s)
+qshell fput meijiaka-zy materials/01690f5d76a40142f365da61319c9f31.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/烟机哪家好/01690f5d76a40142f365da61319c9f31.mp4'
+
+# 玻璃胶谁家好 (3.0s)
+qshell fput meijiaka-zy materials/52d7c9db8291af1d9e2061c3288bec2b.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/玻璃胶谁家好/52d7c9db8291af1d9e2061c3288bec2b.mp4'
+
+# 瓦克西卡百得 (5.01s)
+qshell fput meijiaka-zy materials/1e2774b366631016acecc03c322dc0a2.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/瓦克西卡百得/1e2774b366631016acecc03c322dc0a2.mp4'
+
+# 瓷砖哪家好 (3.0s)
+qshell fput meijiaka-zy materials/e727f0ea33030c14d33185329794398c.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/瓷砖哪家好/e727f0ea33030c14d33185329794398c.mp4'
+
+# 瓷砖胶谁家好 (3.0s)
+qshell fput meijiaka-zy materials/07a1f9a9ec09809d33781a2b6265ff48.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/瓷砖胶谁家好/07a1f9a9ec09809d33781a2b6265ff48.mp4'
+
+# 电线买谁家 (3.0s)
+qshell fput meijiaka-zy materials/04f61f5a57454799d2aa1000764311af.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/电线买谁家/04f61f5a57454799d2aa1000764311af.mp4'
+
+# 电视买谁家 (3.0s)
+qshell fput meijiaka-zy materials/82c400fbc27c42dd8992458d2e94c047.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/电视买谁家/82c400fbc27c42dd8992458d2e94c047.mp4'
+
+# 石膏板谁家好 (3.0s)
+qshell fput meijiaka-zy materials/e6469a2dc66350c330d2d87f08a9cd5a.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/石膏板谁家好/e6469a2dc66350c330d2d87f08a9cd5a.mp4'
+
+# 科勒九牧汉斯格雅 (5.01s)
+qshell fput meijiaka-zy materials/80506a9eb5e1a06d3c5cb98eaae515cd.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/科勒九牧汉斯格雅/80506a9eb5e1a06d3c5cb98eaae515cd.mp4'
+
+# 立邦三棵树多乐士 (5.01s)
+qshell fput meijiaka-zy materials/82b26195cdb7a08793abf3ff17d400eb.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/立邦三棵树多乐士/82b26195cdb7a08793abf3ff17d400eb.mp4'
+
+# 立邦德高东方雨虹 (5.01s)
+qshell fput meijiaka-zy materials/03602a66190ad519f81c70a80e6cd0d2.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/立邦德高东方雨虹/03602a66190ad519f81c70a80e6cd0d2.mp4'
+
+# 立邦美巢圣戈邦 (5.01s)
+qshell fput meijiaka-zy materials/cc00321964988a29315468e4dca53d06.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/立邦美巢圣戈邦/cc00321964988a29315468e4dca53d06.mp4'
+
+# 索尼海信TCL (5.01s)
+qshell fput meijiaka-zy materials/fb9d3b062be7ed44fef7ec81490a4963.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/索尼海信TCL/fb9d3b062be7ed44fef7ec81490a4963.mp4'
+
+# 腻子粉哪家好 (3.0s)
+qshell fput meijiaka-zy materials/887c5ea3238d2c1196eb09c410dc8f7f.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/腻子粉哪家好/887c5ea3238d2c1196eb09c410dc8f7f.mp4'
+
+# 花洒哪家好 (3.0s)
+qshell fput meijiaka-zy materials/f6d4592e08482cb903daca04d432f3ed.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/花洒哪家好/f6d4592e08482cb903daca04d432f3ed.mp4'
+
+# 远东宝胜熊猫 (5.01s)
+qshell fput meijiaka-zy materials/c5ac8d8ff5435e123c8016657fbf955c.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/远东宝胜熊猫/c5ac8d8ff5435e123c8016657fbf955c.mp4'
+
+# 金牛伟星日丰 (5.01s)
+qshell fput meijiaka-zy materials/3c9546527a38c300050ed28bda81e204.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/金牛伟星日丰/3c9546527a38c300050ed28bda81e204.mp4'
+
+# 防水买谁家 (3.0s)
+qshell fput meijiaka-zy materials/3e7c5b554836376605828f374bd15ae5.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/防水买谁家/3e7c5b554836376605828f374bd15ae5.mp4'
+
+# 龙牌泰山可耐福 (5.01s)
+qshell fput meijiaka-zy materials/6589ffbf04c596583d2d2316216c7428.mp4 '/Users/0fun/Downloads/新增素材6.2/其他/装修材料选择/龙牌泰山可耐福/6589ffbf04c596583d2d2316216c7428.mp4'
+
+# 装烟机灶具-主材安装镜 (10.01s)
+qshell fput meijiaka-zy materials/488d5a9ac72bf8e9a2a574284f2bdded.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/488d5a9ac72bf8e9a2a574284f2bdded.mp4'
+
+# 装烟机灶具-主材安装镜 (9.97s)
+qshell fput meijiaka-zy materials/3c716b567964591569abfc8d16e7ff9b.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/3c716b567964591569abfc8d16e7ff9b.mp4'
+
+# 装烟机灶具-主材安装镜 (10.01s)
+qshell fput meijiaka-zy materials/2fb5183ef1547fb3d7d4d8e56fe5154a.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/2fb5183ef1547fb3d7d4d8e56fe5154a.mp4'
+
+# 装烟机灶具-主材安装镜 (10.01s)
+qshell fput meijiaka-zy materials/0d7081072e409e8f2c7d3a61a793f348.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/0d7081072e409e8f2c7d3a61a793f348.mp4'
+
+# 装烟机灶具-主材安装镜 (8.48s)
+qshell fput meijiaka-zy materials/f083bfca1800c171af2dfc767fc5d28a.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/f083bfca1800c171af2dfc767fc5d28a.mp4'
+
+# 装烟机灶具-主材安装镜 (9.8s)
+qshell fput meijiaka-zy materials/8e198970fe0be12c9067fefe658d1cdd.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/8e198970fe0be12c9067fefe658d1cdd.mp4'
+
+# 装烟机灶具-主材安装镜 (9.92s)
+qshell fput meijiaka-zy materials/3763505e431dc39a9fef135ad82ee6f1.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/3763505e431dc39a9fef135ad82ee6f1.mp4'
+
+# 装烟机灶具-主材安装镜 (9.9s)
+qshell fput meijiaka-zy materials/0576abe034e932071d7c3b67104e79c3.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/0576abe034e932071d7c3b67104e79c3.mp4'
+
+# 装烟机灶具-主材安装镜 (4.71s)
+qshell fput meijiaka-zy materials/07281a59949dcaa72c22b54b8569e1ea.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/07281a59949dcaa72c22b54b8569e1ea.mp4'
+
+# 装烟机灶具-主材安装镜 (4.09s)
+qshell fput meijiaka-zy materials/e8d1429ec925636603b69b57ca3eba52.mp4 '/Users/0fun/Downloads/新增素材6.2/安装收尾类/电器安装/装烟机灶具/e8d1429ec925636603b69b57ca3eba52.mp4'
+
+# 封窗施工-封窗镜 (6.01s)
+qshell fput meijiaka-zy materials/9d516288fc104f41e3a4c3747883a072.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/9d516288fc104f41e3a4c3747883a072.mp4'
+
+# 封窗施工-封窗镜 (6.18s)
+qshell fput meijiaka-zy materials/8b293fcabbf5e8dc2f84a77e9cbb9956.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/8b293fcabbf5e8dc2f84a77e9cbb9956.mp4'
+
+# 封窗施工-封窗镜 (10.0s)
+qshell fput meijiaka-zy materials/432a789688f8f729ec72ccbf8571820a.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/432a789688f8f729ec72ccbf8571820a.mp4'
+
+# 封窗施工-封窗镜 (5.62s)
+qshell fput meijiaka-zy materials/3a97f3ebd82b3ff8c04ec47871199159.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/3a97f3ebd82b3ff8c04ec47871199159.mp4'
+
+# 封窗施工-封窗镜 (8.55s)
+qshell fput meijiaka-zy materials/a67d0a41c10ea002968fb0ed1ad8ae0e.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/a67d0a41c10ea002968fb0ed1ad8ae0e.mp4'
+
+# 封窗施工-封窗镜 (8.92s)
+qshell fput meijiaka-zy materials/6b28e44d37a14c3d9ac8b503a29a421c.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/6b28e44d37a14c3d9ac8b503a29a421c.mp4'
+
+# 封窗施工-封窗镜 (10.2s)
+qshell fput meijiaka-zy materials/9468e8aba0f47eeef9bc59e395bfcc72.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/9468e8aba0f47eeef9bc59e395bfcc72.mp4'
+
+# 封窗施工-封窗镜 (10.01s)
+qshell fput meijiaka-zy materials/b5d109f43246296ca6de51d28e596dcd.mp4 '/Users/0fun/Downloads/新增素材6.2/拆改改造类/封窗/封窗施工/b5d109f43246296ca6de51d28e596dcd.mp4'
+
+# 家具进场摆放就位-软装进场镜 (7.01s)
+qshell fput meijiaka-zy materials/a15878e831df63d8cffc1066bf25e257.mp4 '/Users/0fun/Downloads/新增素材6.2/软装完工&验收类/软装进场镜/家具进场摆放就位-软装进场/a15878e831df63d8cffc1066bf25e257.mp4'
+
+# 家具进场摆放就位-软装进场镜 (10.01s)
+qshell fput meijiaka-zy materials/1622140bd7229107b38927b831f8bea8.mp4 '/Users/0fun/Downloads/新增素材6.2/软装完工&验收类/软装进场镜/家具进场摆放就位-软装进场/1622140bd7229107b38927b831f8bea8.mp4'
+
+# 家具进场摆放就位-软装进场镜 (7.85s)
+qshell fput meijiaka-zy materials/5ef57acfda494cfdfb5185594c51364c.mp4 '/Users/0fun/Downloads/新增素材6.2/软装完工&验收类/软装进场镜/家具进场摆放就位-软装进场/5ef57acfda494cfdfb5185594c51364c.mp4'
+
+# 家具进场摆放就位-软装进场镜 (6.11s)
+qshell fput meijiaka-zy materials/4473c9736c25e77375459bd2968f4753.mp4 '/Users/0fun/Downloads/新增素材6.2/软装完工&验收类/软装进场镜/家具进场摆放就位-软装进场/4473c9736c25e77375459bd2968f4753.mp4'
+
+# 家具进场摆放就位-软装进场镜 (5.2s)
+qshell fput meijiaka-zy materials/67526f381c629710d78c53ec3a2f6941.mp4 '/Users/0fun/Downloads/新增素材6.2/软装完工&验收类/软装进场镜/家具进场摆放就位-软装进场/67526f381c629710d78c53ec3a2f6941.mp4'
+
+# 家具进场摆放就位-软装进场镜 (7.41s)
+qshell fput meijiaka-zy materials/1690725fa66d82b9400e462839328658.mp4 '/Users/0fun/Downloads/新增素材6.2/软装完工&验收类/软装进场镜/家具进场摆放就位-软装进场/1690725fa66d82b9400e462839328658.mp4'
+
+# 家具进场摆放就位-软装进场镜 (9.45s)
+qshell fput meijiaka-zy materials/28b67c0a7565ff259f889456334d000d.mp4 '/Users/0fun/Downloads/新增素材6.2/软装完工&验收类/软装进场镜/家具进场摆放就位-软装进场/28b67c0a7565ff259f889456334d000d.mp4'

tauri-app/AGENTS.md

@@ -9,7 +9,7 @@
 **美家卡智影**（产品名）是一款基于 Tauri v2 + React 19 + TypeScript 的桌面端 AI 视频创作应用。
 
 - **产品标识**: `cn.meijiaka.ai-video`
-- **版本**: `1.5.18`
+- **版本**: `1.8.2`
 - **窗口尺寸**: 1200×800，不可缩放（`resizable: false`）
 - **核心功能**: AI 脚本生成、AI 配音合成、视频生成、压制成片（FFmpeg）、项目本地持久化
 

tauri-app/eslint.config.js

@@ -36,7 +36,9 @@ export default tseslint.config(
       ...react.configs.recommended.rules,
       ...react.configs['jsx-runtime'].rules,
       ...reactHooks.configs.recommended.rules,
+      'react/prop-types': 'off', // TypeScript 已有类型检查，无需 PropTypes
       'react-hooks/set-state-in-effect': 'warn',
+      'react-hooks/incompatible-library': 'off', // TanStack Virtual 等常见库误报
       'react-refresh/only-export-components': 'warn',
       'react/no-unescaped-entities': 'warn',
 

tauri-app/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "tauri-app",
-  "version": "1.5.18",
+  "version": "1.8.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tauri-app",
-      "version": "1.5.18",
+      "version": "1.8.2",
       "dependencies": {
         "@microsoft/fetch-event-source": "^2.0.1",
         "@tanstack/react-virtual": "^3.13.23",

tauri-app/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tauri-app",
   "private": true,
-  "version": "1.6.0",
+  "version": "1.8.2",
   "type": "module",
   "scripts": {
     "dev": "vite",

tauri-app/src-tauri/.gitignore

@@ -5,3 +5,6 @@
 # Generated by Tauri
 # will have schema files for capabilities auto-completion
 /gen/schemas
+
+# Sidecar binaries (FFmpeg / ffprobe) — large platform-specific executables
+/binaries/

tauri-app/src-tauri/Cargo.lock

@@ -4219,12 +4219,13 @@ dependencies = [
 
 [[package]]
 name = "tauri-app"
-version = "1.6.0"
+version = "1.8.2"
 dependencies = [
  "base64 0.22.1",
  "chrono",
  "dirs 5.0.1",
  "fs2",
+ "log",
  "reqwest 0.12.28",
  "serde",
  "serde_json",

tauri-app/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "tauri-app"
-version = "1.6.0"
+version = "1.8.2"
 description = "美家卡智影 - AI 视频创作桌面应用"
 authors = ["美家卡科技"]
 edition = "2021"
@@ -27,6 +27,7 @@ tauri-plugin-updater = "2"
 tauri-plugin-process = "2"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
+log = "0.4"
 dirs = "5"
 # HTTP 客户端: 精简功能
 # 使用 default-tls（默认）+ json，无需额外 features
@@ -43,6 +44,6 @@ thiserror = "1"
 # 文件锁（跨平台）
 fs2 = "0.4"
 # 异步运行时定时器（FFmpeg 超时保护）
-tokio = { version = "1", features = ["time"] }
+tokio = { version = "1", features = ["time", "sync"] }
 tauri-plugin-single-instance = "2"
 

tauri-app/src-tauri/capabilities/default.json

@@ -53,6 +53,7 @@
     "dialog:allow-open",
     "core:window:allow-show",
     "core:window:allow-set-focus",
-    "updater:default"
+    "updater:default",
+    "process:allow-restart"
   ]
 }

tauri-app/src-tauri/src/commands/asset.rs

@@ -6,11 +6,17 @@ use crate::storage::project as project_storage;
 
 #[tauri::command]
 pub async fn save_project_asset(
+    app: tauri::AppHandle,
     project_id: String,
     filename: String,
     base64_data: String,
 ) -> ApiResponse<String> {
-    match project_storage::save_project_asset(&project_id, &filename, &base64_data).map_err_string() {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: None },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: None },
+    };
+    match project_storage::save_project_asset(&user_id, &project_id, &filename, &base64_data).map_err_string() {
         Ok(path) => ApiResponse {
             code: 200,
             message: "资源保存成功".to_string(),
@@ -26,10 +32,16 @@ pub async fn save_project_asset(
 
 #[tauri::command]
 pub async fn get_video_save_path(
+    app: tauri::AppHandle,
     project_id: String,
     filename: String,
 ) -> ApiResponse<String> {
-    match project_storage::get_video_save_path(&project_id, &filename).map_err_string() {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: None },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: None },
+    };
+    match project_storage::get_video_save_path(&user_id, &project_id, &filename).map_err_string() {
         Ok(path) => ApiResponse {
             code: 200,
             message: "获取路径成功".to_string(),

tauri-app/src-tauri/src/commands/auth_state.rs

@@ -3,6 +3,7 @@
 use crate::ApiResponse;
 use crate::StringResultExt;
 use crate::storage::auth as auth_storage;
+use tauri::Manager;
 
 #[tauri::command]
 pub async fn load_auth_state(app: tauri::AppHandle) -> ApiResponse<Option<serde_json::Value>> {
@@ -26,11 +27,21 @@ pub async fn save_auth_state(
     state: serde_json::Value,
 ) -> ApiResponse<bool> {
     match auth_storage::save_auth_state(&app, &state).map_err_string() {
-        Ok(_) => ApiResponse {
-            code: 200,
-            message: "Auth state saved successfully".to_string(),
-            data: Some(true),
-        },
+        Ok(_) => {
+            // 保存 auth 成功后，检查是否需要迁移旧全局数据
+            // 场景：用户在退出状态下升级应用，setup 阶段跳过迁移；
+            // 重新登录时触发迁移，确保旧数据正确归入当前用户目录
+            if let Ok(data_dir) = app.path().app_local_data_dir() {
+                if let Err(e) = crate::migrate_legacy_data(&data_dir, &app) {
+                    eprintln!("[save_auth_state] 数据迁移失败: {}", e);
+                }
+            }
+            ApiResponse {
+                code: 200,
+                message: "Auth state saved successfully".to_string(),
+                data: Some(true),
+            }
+        }
         Err(e) => ApiResponse {
             code: 500,
             message: format!("Failed to save auth state: {}", e),

tauri-app/src-tauri/src/commands/cover_avatar.rs

@@ -17,8 +17,15 @@ pub struct CoverAvatarArgs {
 
 /// 加载封面形象库
 #[tauri::command]
-pub async fn load_cover_avatars() -> ApiResponse<Vec<cover_avatar_storage::CoverAvatar>> {
-    match cover_avatar_storage::load_cover_avatars() {
+pub async fn load_cover_avatars(
+    app: tauri::AppHandle,
+) -> ApiResponse<Vec<cover_avatar_storage::CoverAvatar>> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(vec![]) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(vec![]) },
+    };
+    match cover_avatar_storage::load_cover_avatars(&user_id) {
         Ok(list) => ApiResponse {
             code: 200,
             message: "封面形象库加载成功".to_string(),
@@ -35,8 +42,14 @@ pub async fn load_cover_avatars() -> ApiResponse<Vec<cover_avatar_storage::Cover
 /// 保存封面形象
 #[tauri::command]
 pub async fn save_cover_avatar(
+    app: tauri::AppHandle,
     args: CoverAvatarArgs,
 ) -> ApiResponse<bool> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(false) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(false) },
+    };
     let avatar = cover_avatar_storage::CoverAvatar {
         id: args.id,
         name: args.name,
@@ -44,7 +57,7 @@ pub async fn save_cover_avatar(
         local_path: args.local_path,
         created_at: args.created_at,
     };
-    match cover_avatar_storage::add_cover_avatar(avatar) {
+    match cover_avatar_storage::add_cover_avatar(&user_id, avatar) {
         Ok(_) => ApiResponse {
             code: 200,
             message: "封面形象保存成功".to_string(),
@@ -61,9 +74,15 @@ pub async fn save_cover_avatar(
 /// 删除封面形象
 #[tauri::command]
 pub async fn delete_cover_avatar_cmd(
+    app: tauri::AppHandle,
     id: String,
 ) -> ApiResponse<bool> {
-    match cover_avatar_storage::delete_cover_avatar(&id) {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(false) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(false) },
+    };
+    match cover_avatar_storage::delete_cover_avatar(&user_id, &id) {
         Ok(_) => ApiResponse {
             code: 200,
             message: "封面形象删除成功".to_string(),
@@ -90,8 +109,15 @@ pub struct SaveCoverAvatarImageArgs {
 /// 保存封面形象图片文件（前端传入 base64 编码）
 #[tauri::command]
 pub async fn save_cover_avatar_image(
+    app: tauri::AppHandle,
     args: SaveCoverAvatarImageArgs,
 ) -> ApiResponse<String> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: None },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: None },
+    };
+
     let image_bytes = match base64::Engine::decode(
         &base64::engine::general_purpose::STANDARD,
         &args.image_data,
@@ -105,6 +131,7 @@ pub async fn save_cover_avatar_image(
     };
 
     match cover_avatar_storage::save_cover_avatar_image(
+        &user_id,
         &args.avatar_id,
         &image_bytes,
         &args.ext,

tauri-app/src-tauri/src/commands/product.rs

@@ -23,8 +23,17 @@ pub struct ProductItem {
 
 /// 获取成品保存路径（项目成品目录）
 #[tauri::command]
-pub async fn get_product_save_path(project_id: String, filename: String) -> ApiResponse<String> {
-    match get_project_products_dir(&project_id) {
+pub async fn get_product_save_path(
+    app: tauri::AppHandle,
+    project_id: String,
+    filename: String,
+) -> ApiResponse<String> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: None },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: None },
+    };
+    match get_project_products_dir(&user_id, &project_id) {
         Ok(products_dir) => {
             let safe_filename = match sanitize_filename(&filename) {
                 Ok(name) => name,
@@ -52,8 +61,13 @@ pub async fn get_product_save_path(project_id: String, filename: String) -> ApiR
 }
 
 #[tauri::command]
-pub async fn list_local_products(_app: AppHandle) -> ApiResponse<Vec<ProductItem>> {
-    let projects_root = match crate::storage::get_projects_root_dir() {
+pub async fn list_local_products(app: AppHandle) -> ApiResponse<Vec<ProductItem>> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(vec![]) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(vec![]) },
+    };
+    let projects_root = match crate::storage::get_projects_root_dir(&user_id) {
         Ok(dir) => dir,
         Err(e) => return ApiResponse {
             code: 500,
@@ -191,10 +205,19 @@ pub async fn list_local_products(_app: AppHandle) -> ApiResponse<Vec<ProductItem
 }
 
 #[tauri::command]
-pub async fn delete_local_product(path: String) -> ApiResponse<()> {
+pub async fn delete_local_product(
+    app: tauri::AppHandle,
+    path: String,
+) -> ApiResponse<()> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: None },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: None },
+    };
+
     let target = PathBuf::from(&path);
 
-    // 安全检查：确保路径在应用数据目录内
+    // 安全检查：确保路径在应用数据目录内，且在当前用户目录下
     let canonical = match target.canonicalize() {
         Ok(p) => p,
         Err(e) if e.kind() == std::io::ErrorKind::NotFound => {
@@ -219,8 +242,9 @@ pub async fn delete_local_product(path: String) -> ApiResponse<()> {
             data: None,
         },
     };
+    let app_data_canonical = app_data.canonicalize().unwrap_or_else(|_| app_data.clone());
 
-    if !canonical.starts_with(app_data) {
+    if !canonical.starts_with(&app_data_canonical) {
         return ApiResponse {
             code: 400,
             message: "路径不在允许范围内".to_string(),
@@ -228,6 +252,17 @@ pub async fn delete_local_product(path: String) -> ApiResponse<()> {
         };
     }
 
+    // 用户隔离检查：路径必须在当前用户的 users/{id}/ 目录下
+    let user_prefix = app_data.join("users").join(&user_id);
+    let user_prefix_canonical = user_prefix.canonicalize().unwrap_or_else(|_| user_prefix.clone());
+    if !canonical.starts_with(&user_prefix_canonical) {
+        return ApiResponse {
+            code: 403,
+            message: "无权操作其他用户的数据".to_string(),
+            data: None,
+        };
+    }
+
     if target.exists() && target.is_file() {
         match fs::remove_file(&target) {
             Ok(_) => ApiResponse {
@@ -251,7 +286,17 @@ pub async fn delete_local_product(path: String) -> ApiResponse<()> {
 }
 
 #[tauri::command]
-pub async fn rename_local_product(path: String, new_filename: String) -> ApiResponse<()> {
+pub async fn rename_local_product(
+    app: tauri::AppHandle,
+    path: String,
+    new_filename: String,
+) -> ApiResponse<()> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: None },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: None },
+    };
+
     let old_path = PathBuf::from(&path);
 
     // 安全检查
@@ -279,8 +324,9 @@ pub async fn rename_local_product(path: String, new_filename: String) -> ApiResp
             data: None,
         },
     };
+    let app_data_canonical = app_data.canonicalize().unwrap_or_else(|_| app_data.clone());
 
-    if !canonical.starts_with(app_data) {
+    if !canonical.starts_with(&app_data_canonical) {
         return ApiResponse {
             code: 400,
             message: "路径不在允许范围内".to_string(),
@@ -288,6 +334,17 @@ pub async fn rename_local_product(path: String, new_filename: String) -> ApiResp
         };
     }
 
+    // 用户隔离检查
+    let user_prefix = app_data.join("users").join(&user_id);
+    let user_prefix_canonical = user_prefix.canonicalize().unwrap_or_else(|_| user_prefix.clone());
+    if !canonical.starts_with(&user_prefix_canonical) {
+        return ApiResponse {
+            code: 403,
+            message: "无权操作其他用户的数据".to_string(),
+            data: None,
+        };
+    }
+
     let parent = match old_path.parent() {
         Some(p) => p.to_path_buf(),
         None => return ApiResponse {
@@ -337,7 +394,17 @@ pub async fn rename_local_product(path: String, new_filename: String) -> ApiResp
 
 /// 导出成品到用户指定位置
 #[tauri::command]
-pub async fn export_product(source_path: String, target_path: String) -> ApiResponse<String> {
+pub async fn export_product(
+    app: tauri::AppHandle,
+    source_path: String,
+    target_path: String,
+) -> ApiResponse<String> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: None },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: None },
+    };
+
     let source = PathBuf::from(&source_path);
     let target = PathBuf::from(&target_path);
 
@@ -359,8 +426,9 @@ pub async fn export_product(source_path: String, target_path: String) -> ApiResp
             data: None,
         },
     };
+    let app_data_canonical = app_data.canonicalize().unwrap_or_else(|_| app_data.clone());
 
-    if !source_canonical.starts_with(app_data) {
+    if !source_canonical.starts_with(&app_data_canonical) {
         return ApiResponse {
             code: 400,
             message: "源文件不在允许范围内".to_string(),
@@ -368,6 +436,17 @@ pub async fn export_product(source_path: String, target_path: String) -> ApiResp
         };
     }
 
+    // 用户隔离检查：source 必须在当前用户目录下
+    let user_prefix = app_data.join("users").join(&user_id);
+    let user_prefix_canonical = user_prefix.canonicalize().unwrap_or_else(|_| user_prefix.clone());
+    if !source_canonical.starts_with(&user_prefix_canonical) {
+        return ApiResponse {
+            code: 403,
+            message: "无权导出其他用户的数据".to_string(),
+            data: None,
+        };
+    }
+
     if !source.exists() || !source.is_file() {
         return ApiResponse {
             code: 404,

tauri-app/src-tauri/src/commands/project.rs

@@ -9,8 +9,17 @@ use crate::storage::project as project_storage;
 // ============================================================
 
 #[tauri::command]
-pub async fn save_project_meta_raw(project_id: String, json_content: String) -> ApiResponse<bool> {
-    match project_storage::save_project_meta_raw(&project_id, &json_content).map_err_string() {
+pub async fn save_project_meta_raw(
+    app: tauri::AppHandle,
+    project_id: String,
+    json_content: String,
+) -> ApiResponse<bool> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(false) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(false) },
+    };
+    match project_storage::save_project_meta_raw(&user_id, &project_id, &json_content).map_err_string() {
         Ok(_) => ApiResponse {
             code: 200,
             message: "Project saved successfully".to_string(),
@@ -25,8 +34,16 @@ pub async fn save_project_meta_raw(project_id: String, json_content: String) ->
 }
 
 #[tauri::command]
-pub async fn load_project_meta(project_id: String) -> ApiResponse<serde_json::Value> {
-    match project_storage::load_project_meta(&project_id).map_err_string() {
+pub async fn load_project_meta(
+    app: tauri::AppHandle,
+    project_id: String,
+) -> ApiResponse<serde_json::Value> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(serde_json::Value::Null) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(serde_json::Value::Null) },
+    };
+    match project_storage::load_project_meta(&user_id, &project_id).map_err_string() {
         Ok(data) => ApiResponse {
             code: 200,
             message: "Project loaded successfully".to_string(),
@@ -41,8 +58,17 @@ pub async fn load_project_meta(project_id: String) -> ApiResponse<serde_json::Va
 }
 
 #[tauri::command]
-pub async fn save_project_segments_raw(project_id: String, json_content: String) -> ApiResponse<bool> {
-    match project_storage::save_project_segments_raw(&project_id, &json_content).map_err_string() {
+pub async fn save_project_segments_raw(
+    app: tauri::AppHandle,
+    project_id: String,
+    json_content: String,
+) -> ApiResponse<bool> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(false) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(false) },
+    };
+    match project_storage::save_project_segments_raw(&user_id, &project_id, &json_content).map_err_string() {
         Ok(_) => ApiResponse {
             code: 200,
             message: "Segments saved successfully".to_string(),
@@ -57,8 +83,16 @@ pub async fn save_project_segments_raw(project_id: String, json_content: String)
 }
 
 #[tauri::command]
-pub async fn load_project_segments(project_id: String) -> ApiResponse<serde_json::Value> {
-    match project_storage::load_project_segments(&project_id).map_err_string() {
+pub async fn load_project_segments(
+    app: tauri::AppHandle,
+    project_id: String,
+) -> ApiResponse<serde_json::Value> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(serde_json::Value::Array(vec![])) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(serde_json::Value::Array(vec![])) },
+    };
+    match project_storage::load_project_segments(&user_id, &project_id).map_err_string() {
         Ok(data) => ApiResponse {
             code: 200,
             message: "Segments loaded successfully".to_string(),
@@ -73,8 +107,15 @@ pub async fn load_project_segments(project_id: String) -> ApiResponse<serde_json
 }
 
 #[tauri::command]
-pub async fn list_local_projects() -> ApiResponse<Vec<serde_json::Value>> {
-    match project_storage::list_projects().map_err_string() {
+pub async fn list_local_projects(
+    app: tauri::AppHandle,
+) -> ApiResponse<Vec<serde_json::Value>> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(vec![]) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(vec![]) },
+    };
+    match project_storage::list_projects(&user_id).map_err_string() {
         Ok(projects) => ApiResponse {
             code: 200,
             message: "Projects listed successfully".to_string(),
@@ -89,8 +130,16 @@ pub async fn list_local_projects() -> ApiResponse<Vec<serde_json::Value>> {
 }
 
 #[tauri::command]
-pub async fn delete_local_project(project_id: String) -> ApiResponse<bool> {
-    match project_storage::delete_project(&project_id).map_err_string() {
+pub async fn delete_local_project(
+    app: tauri::AppHandle,
+    project_id: String,
+) -> ApiResponse<bool> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(false) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(false) },
+    };
+    match project_storage::delete_project(&user_id, &project_id).map_err_string() {
         Ok(_) => ApiResponse {
             code: 200,
             message: "Project deleted successfully".to_string(),
@@ -105,10 +154,20 @@ pub async fn delete_local_project(project_id: String) -> ApiResponse<bool> {
 }
 
 #[tauri::command]
-pub async fn delete_project_file(project_id: String, file_path: String) -> ApiResponse<bool> {
+pub async fn delete_project_file(
+    app: tauri::AppHandle,
+    project_id: String,
+    file_path: String,
+) -> ApiResponse<bool> {
     use crate::storage::get_project_dir_path;
 
-    let project_dir: std::path::PathBuf = match get_project_dir_path(&project_id) {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse { code: 401, message: "未登录".to_string(), data: Some(false) },
+        Err(e) => return ApiResponse { code: 500, message: format!("获取用户信息失败: {}", e), data: Some(false) },
+    };
+
+    let project_dir: std::path::PathBuf = match get_project_dir_path(&user_id, &project_id) {
         Ok(d) => d,
         Err(e) => return ApiResponse {
             code: 500,

tauri-app/src-tauri/src/commands/video_compose.rs

@@ -28,21 +28,59 @@ pub struct UploadResult {
 /// 兼容旧命名
 pub type UploadVideoResult = UploadResult;
 
-/// 获取项目视频目录
-fn get_project_video_dir(project_id: &str) -> Result<std::path::PathBuf, String> {
-    crate::storage::get_project_videos_dir(project_id)
+/// 获取项目视频目录（内部辅助函数，从 auth.json 读取当前用户）
+fn get_project_video_dir(app: &AppHandle, project_id: &str) -> Result<std::path::PathBuf, String> {
+    let user_id = match crate::storage::auth::get_current_user_id(app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return Err("未登录".to_string()),
+        Err(e) => return Err(format!("获取用户信息失败: {}", e)),
+    };
+    crate::storage::get_project_videos_dir(&user_id, project_id)
         .map_err(|e| format!("获取项目视频目录失败: {}", e))
 }
 
+/// 校验视频比例是否为 9:16（允许 ±3% 容差）
+fn validate_nine_sixteen_aspect(width: u32, height: u32) -> Result<(), String> {
+    if width == 0 || height == 0 {
+        return Err("无法读取视频分辨率".to_string());
+    }
+    let ratio = width as f64 / height as f64;
+    let expected = 9.0 / 16.0;
+    if (ratio - expected).abs() / expected > 0.03 {
+        return Err(format!(
+            "视频比例必须是 9:16，当前为 {}×{}（比例 {:.3}）",
+            width, height, ratio
+        ));
+    }
+    Ok(())
+}
 
-/// 直接拼接已标准化的视频片段（不做裁剪，只做 concat）
+/// 根据素材最大高度决定目标输出分辨率
+///
+/// 向上统一到最高素材的分辨率：只要存在 1080p 素材，成片就输出 1080p，
+/// 避免高分辨率素材被强制压缩到 720p 导致画面模糊。
+/// 720p 素材会被放大拼接，虽然略有损失，但优于整体降质。
+fn resolve_target_resolution(heights: &[u32]) -> Option<(u32, u32)> {
+    let max_height = heights.iter().max()?;
+    if *max_height >= 1920 {
+        Some((1080, 1920))
+    } else {
+        Some((720, 1280))
+    }
+}
+
+/// 拼接视频片段
+///
+/// 1. 探测所有片段分辨率并校验 9:16 比例
+/// 2. 按最大高度决定目标输出分辨率（向上统一，避免高分辨率素材被压糊）
+/// 3. 统一标准化后拼接
 #[tauri::command]
 pub async fn concat_video_clips(
     app: AppHandle,
     project_id: String,
     clip_paths: Vec<String>,
 ) -> ApiResponse<ComposeVideoResult> {
-    let video_dir = match get_project_video_dir(&project_id) {
+    let video_dir = match get_project_video_dir(&app, &project_id) {
         Ok(dir) => dir,
         Err(e) => {
             return ApiResponse {
@@ -58,29 +96,49 @@ pub async fn concat_video_clips(
         .unwrap()
         .as_millis();
 
-    // 生成 concat 列表文件
-    let list_path = video_dir.join(format!("concat_list_{}.txt", timestamp));
-    let mut list_content = String::new();
+    // 1. 探测所有片段分辨率并校验 9:16
+    let mut heights = Vec::new();
     for path in &clip_paths {
-        list_content.push_str(&format!("file '{}'\n", ffmpeg_cmd::escape_ffmpeg_path(path)));
-    }
-    if let Err(e) = std::fs::write(&list_path, list_content) {
-        return ApiResponse {
-            code: 500,
-            message: format!("创建拼接列表失败: {}", e),
-            data: None,
-        };
+        match ffmpeg_cmd::get_video_metadata(&app, path).await {
+            Ok(meta) => {
+                if let Err(e) = validate_nine_sixteen_aspect(meta.width, meta.height) {
+                    return ApiResponse { code: 400, message: e, data: None };
+                }
+                heights.push(meta.height);
+            }
+            Err(e) => {
+                return ApiResponse {
+                    code: 500,
+                    message: format!("读取视频元数据失败: {}", e),
+                    data: None,
+                };
+            }
+        }
     }
 
-    // 执行拼接（所有片段已标准化，编码一致，直接用 copy）
+    let (target_width, target_height) = match resolve_target_resolution(&heights) {
+        Some(res) => res,
+        None => {
+            return ApiResponse {
+                code: 400,
+                message: "没有可拼接的视频片段".to_string(),
+                data: None,
+            };
+        }
+    };
+
+    // 2. 执行拼接（内部会先标准化到目标分辨率）
     let output_filename = format!("composed_{}.mp4", timestamp);
     let output_path = video_dir.join(&output_filename);
     let output_path_str = output_path.to_string_lossy().to_string();
 
-    let concat_res = ffmpeg_cmd::concat_videos_copy(&app, list_path.to_str().unwrap(), &output_path_str).await;
-
-    // 清理列表文件
-    let _ = std::fs::remove_file(&list_path);
+    let concat_res = ffmpeg_cmd::concat_videos_robust(
+        &app,
+        clip_paths,
+        &output_path_str,
+        target_width,
+        target_height,
+    ).await;
 
     if let Err(e) = concat_res {
         return ApiResponse {
@@ -91,7 +149,6 @@ pub async fn concat_video_clips(
     }
 
     // 总时长由前端提供（各片段时长的精确累加）
-    // 此处不通过 ffprobe 读取，避免依赖
     let total_duration = 0.0;
 
     ApiResponse {
@@ -103,7 +160,6 @@ pub async fn concat_video_clips(
         }),
     }
 }
-
 /// 空镜片段生成请求参数
 #[derive(Debug, Deserialize)]
 #[serde(rename_all = "camelCase")]
@@ -134,8 +190,25 @@ pub async fn generate_empty_shot_clip(
         let _ = std::fs::remove_file(&temp_audio);
     };
 
-    // 1. 截取空镜视频并标准化
-    if let Err(e) = ffmpeg_cmd::clip_video(&app, &args.video_source, 0.0, args.duration, &temp_video).await {
+    // 1. 探测输入分辨率并校验 9:16 比例
+    let (video_width, video_height) = match ffmpeg_cmd::get_video_metadata(&app, &args.video_source).await {
+        Ok(meta) => {
+            if let Err(e) = validate_nine_sixteen_aspect(meta.width, meta.height) {
+                return ApiResponse { code: 400, message: e, data: None };
+            }
+            (meta.width, meta.height)
+        }
+        Err(e) => {
+            return ApiResponse {
+                code: 500,
+                message: format!("读取视频元数据失败: {}", e),
+                data: None,
+            };
+        }
+    };
+
+    // 2. 截取空镜视频并标准化（保持输入分辨率）
+    if let Err(e) = ffmpeg_cmd::clip_video(&app, &args.video_source, 0.0, args.duration, &temp_video, video_width, video_height).await {
         cleanup();
         return ApiResponse {
             code: 500,
@@ -278,7 +351,24 @@ pub async fn extract_video_segment(
         };
     };
 
-    match ffmpeg_cmd::clip_video(&app, &safe_input, args.start, args.duration, &safe_output).await {
+    // 探测输入分辨率并校验 9:16 比例
+    let (video_width, video_height) = match ffmpeg_cmd::get_video_metadata(&app, &safe_input).await {
+        Ok(meta) => {
+            if let Err(e) = validate_nine_sixteen_aspect(meta.width, meta.height) {
+                return ApiResponse { code: 400, message: e, data: None };
+            }
+            (meta.width, meta.height)
+        }
+        Err(e) => {
+            return ApiResponse {
+                code: 500,
+                message: format!("读取视频元数据失败: {}", e),
+                data: None,
+            };
+        }
+    };
+
+    match ffmpeg_cmd::clip_video(&app, &safe_input, args.start, args.duration, &safe_output, video_width, video_height).await {
         Ok(_) => ApiResponse {
             code: 200,
             message: "视频片段截取成功".to_string(),

tauri-app/src-tauri/src/commands/voice.rs

@@ -2,6 +2,7 @@
 
 use crate::ApiResponse;
 use crate::storage::voice as voice_storage;
+use tauri::Manager;
 
 // --------------------- 音色素材库命令 ---------------------
 
@@ -19,8 +20,24 @@ pub struct VoiceMaterialArgs {
 
 /// 加载音色素材库
 #[tauri::command]
-pub async fn load_voice_materials() -> ApiResponse<Vec<voice_storage::VoiceMaterial>> {
-    match voice_storage::load_voice_materials() {
+pub async fn load_voice_materials(
+    app: tauri::AppHandle,
+) -> ApiResponse<Vec<voice_storage::VoiceMaterial>> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse {
+            code: 401,
+            message: "未登录".to_string(),
+            data: Some(vec![]),
+        },
+        Err(e) => return ApiResponse {
+            code: 500,
+            message: format!("获取用户信息失败: {}", e),
+            data: Some(vec![]),
+        },
+    };
+
+    match voice_storage::load_voice_materials(&user_id) {
         Ok(list) => ApiResponse {
             code: 200,
             message: "素材库加载成功".to_string(),
@@ -37,8 +54,23 @@ pub async fn load_voice_materials() -> ApiResponse<Vec<voice_storage::VoiceMater
 /// 保存音色素材
 #[tauri::command]
 pub async fn save_voice_material(
+    app: tauri::AppHandle,
     args: VoiceMaterialArgs,
 ) -> ApiResponse<bool> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse {
+            code: 401,
+            message: "未登录".to_string(),
+            data: Some(false),
+        },
+        Err(e) => return ApiResponse {
+            code: 500,
+            message: format!("获取用户信息失败: {}", e),
+            data: Some(false),
+        },
+    };
+
     let material = voice_storage::VoiceMaterial {
         id: args.id,
         name: args.name,
@@ -48,7 +80,7 @@ pub async fn save_voice_material(
         status: args.status,
         created_at: args.created_at,
     };
-    match voice_storage::add_voice_material(material) {
+    match voice_storage::add_voice_material(&user_id, material) {
         Ok(_) => ApiResponse {
             code: 200,
             message: "素材保存成功".to_string(),
@@ -65,9 +97,24 @@ pub async fn save_voice_material(
 /// 删除音色素材
 #[tauri::command]
 pub async fn delete_voice_material_cmd(
+    app: tauri::AppHandle,
     id: String,
 ) -> ApiResponse<bool> {
-    match voice_storage::delete_voice_material(&id) {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse {
+            code: 401,
+            message: "未登录".to_string(),
+            data: Some(false),
+        },
+        Err(e) => return ApiResponse {
+            code: 500,
+            message: format!("获取用户信息失败: {}", e),
+            data: Some(false),
+        },
+    };
+
+    match voice_storage::delete_voice_material(&user_id, &id) {
         Ok(_) => ApiResponse {
             code: 200,
             message: "素材删除成功".to_string(),
@@ -97,8 +144,23 @@ pub struct SaveAudioArgs {
 /// 保存音频文件（前端传入 base64 编码）
 #[tauri::command]
 pub async fn save_audio(
+    app: tauri::AppHandle,
     args: SaveAudioArgs,
 ) -> ApiResponse<voice_storage::AudioMeta> {
+    let user_id = match crate::storage::auth::get_current_user_id(&app) {
+        Ok(Some(id)) => id,
+        Ok(None) => return ApiResponse {
+            code: 401,
+            message: "未登录".to_string(),
+            data: None,
+        },
+        Err(e) => return ApiResponse {
+            code: 500,
+            message: format!("获取用户信息失败: {}", e),
+            data: None,
+        },
+    };
+
     let audio_bytes = match base64::Engine::decode(
         &base64::engine::general_purpose::STANDARD,
         &args.audio_data,
@@ -112,6 +174,7 @@ pub async fn save_audio(
     };
 
     match voice_storage::save_audio_file(
+        &user_id,
         &args.project_id,
         &args.audio_id,
         &audio_bytes,
@@ -169,6 +232,70 @@ pub async fn extract_audio_segment(
     }
 }
 
+/**
+ * 从本地视频文件中提取音频（MP4 → MP3）
+ *
+ * 输出文件自动生成在 app_local_data_dir/temp/ 下。
+ * @param input_path 本地视频文件路径（需在 app_local_data_dir 下）
+ * @returns 提取后的 MP3 文件路径
+ */
+#[tauri::command]
+pub async fn extract_audio_from_video(
+    app: tauri::AppHandle,
+    input_path: String,
+) -> ApiResponse<String> {
+    // 验证输入路径安全
+    let safe_input = match crate::ffmpeg_cmd::sanitize_output_path(&input_path) {
+        Ok(p) => p,
+        Err(e) => {
+            return ApiResponse {
+                code: 500,
+                message: format!("路径验证失败: {}", e),
+                data: None,
+            };
+        }
+    };
+
+    // 生成输出路径：app_local_data_dir/temp/extracted_{uuid}.mp3
+    let output_path = match app.path().app_local_data_dir() {
+        Ok(dir) => {
+            let temp_dir = dir.join("temp");
+            if let Err(e) = std::fs::create_dir_all(&temp_dir) {
+                return ApiResponse {
+                    code: 500,
+                    message: format!("创建临时目录失败: {}", e),
+                    data: None,
+                };
+            }
+            temp_dir.join(format!("extracted_{}.mp3", uuid::Uuid::new_v4()))
+        }
+        Err(e) => {
+            return ApiResponse {
+                code: 500,
+                message: format!("获取应用目录失败: {}", e),
+                data: None,
+            };
+        }
+    };
+
+    match crate::ffmpeg_cmd::extract_audio_from_video(
+        &app,
+        &safe_input,
+        &output_path.to_string_lossy(),
+    ).await {
+        Ok(_) => ApiResponse {
+            code: 200,
+            message: "音频提取成功".to_string(),
+            data: Some(output_path.to_string_lossy().to_string()),
+        },
+        Err(e) => ApiResponse {
+            code: 500,
+            message: format!("音频提取失败: {}", e),
+            data: None,
+        },
+    }
+}
+
 /// 上传本地音频文件到后端，后端上传到七牛云并返回 URL
 #[tauri::command]
 pub async fn upload_audio_file(

tauri-app/src-tauri/src/ffmpeg_cmd.rs

@@ -3,6 +3,11 @@ use crate::StringResultExt;
 use tauri_plugin_shell::process::CommandEvent;
 use tauri::{AppHandle, Emitter};
 use serde::{Deserialize, Serialize};
+use std::sync::LazyLock;
+use tokio::sync::Semaphore;
+
+/// 预览转码并发锁：保证同时只有一个 FFmpeg 进程在转码，避免 CPU/磁盘争抢
+static PREVIEW_SEMAPHORE: LazyLock<Semaphore> = LazyLock::new(|| Semaphore::new(1));
 
 /// 视频元数据（由 ffprobe 解析）
 #[derive(Debug, Serialize, Deserialize)]
@@ -19,11 +24,42 @@ struct PhaseInfo {
     total: u8,
 }
 
-/// FFmpeg 路径转义（替换 `:` 为 `\:`，替换 `'` 为 `'\''`）
+/// FFmpeg concat 列表文件中的路径转义（单引号用 `'\''` 包裹转义）
 pub fn escape_ffmpeg_path(path: &str) -> String {
+    // 去掉 Windows UNC 前缀（\\?\）
+    let path = if path.starts_with(r"\\?\") {
+        &path[4..]
+    } else {
+        path
+    };
+    // concat 列表中路径被单引号包裹，需要将单引号转义为 '\''
     path.replace("'", "'\\''")
 }
 
+/// FFmpeg filter 字符串中的路径转义（用于单引号包裹的字符串内部）
+fn escape_ffmpeg_filter_path(path: &str) -> String {
+    // 去掉 Windows UNC 前缀（\\?\）
+    let path = if path.starts_with(r"\\?\") {
+        &path[4..]
+    } else {
+        path
+    };
+    // 使用正斜杠，避免反斜杠在 filter 字符串中被当作转义符
+    let path = path.replace('\\', "/");
+    // 单引号内需要将 ' 转义为 \'
+    path.replace("'", "\\'")
+}
+
+/// 去掉 Windows UNC 前缀（\\?\），使 convertFileSrc 能正确生成 asset:// URL
+fn normalize_path(path: &std::path::Path) -> String {
+    let s = path.to_string_lossy().to_string();
+    if s.starts_with(r"\\?\") {
+        std::path::PathBuf::from(&s[4..]).to_string_lossy().to_string()
+    } else {
+        s
+    }
+}
+
 /// 验证路径在允许的目录内，防止路径遍历攻击
 /// 允许的目录：应用数据目录（app_local_data_dir）
 fn validate_safe_path(path: &str) -> Result<String, String> {
@@ -46,8 +82,13 @@ fn validate_safe_path(path: &str) -> Result<String, String> {
     let canonical = abs_path.canonicalize()
         .unwrap_or(abs_path.clone());
 
+    // 同时规范化允许目录（Windows 上 canonicalize 会添加 \\?\ 前缀，
+    // 必须与输入路径保持一致的规范化格式才能正确比较）
+    let allowed_canonical = allowed_dir.canonicalize()
+        .unwrap_or(allowed_dir.clone());
+
     // 检查是否在允许目录下
-    if !canonical.starts_with(allowed_dir) {
+    if !canonical.starts_with(&allowed_canonical) {
         return Err(format!("路径不在允许目录内: {}", path.display()));
     }
 
@@ -82,9 +123,23 @@ pub fn sanitize_output_path(path: &str) -> Result<String, String> {
  * 使用 Tauri 官方 sidecar API，自动处理开发/生产环境的 sidecar 查找。
  */
 pub async fn run_ffmpeg(app: &AppHandle, args: Vec<String>) -> Result<String, String> {
-    let (mut rx, child) = app.shell()
+    run_ffmpeg_in_dir(app, args, None).await
+}
+
+pub async fn run_ffmpeg_in_dir(
+    app: &AppHandle,
+    args: Vec<String>,
+    current_dir: Option<&std::path::Path>,
+) -> Result<String, String> {
+    let cmd = app.shell()
         .sidecar("ffmpeg")
-        .map_err(|e| format!("Failed to find ffmpeg sidecar: {e}"))?
+        .map_err(|e| format!("Failed to find ffmpeg sidecar: {e}"))?;
+    let cmd = if let Some(dir) = current_dir {
+        cmd.current_dir(dir)
+    } else {
+        cmd
+    };
+    let (mut rx, child) = cmd
         .args(args)
         .spawn()
         .map_err(|e| format!("Failed to spawn ffmpeg: {e}"))?;
@@ -100,6 +155,7 @@ pub async fn run_ffmpeg(app: &AppHandle, args: Vec<String>) -> Result<String, St
                 }
                 CommandEvent::Stderr(line) => {
                     let log = String::from_utf8_lossy(&line);
+                    log::debug!("[ffmpeg stderr] {}", log.trim());
                     stderr_output.push_str(&log);
                     stderr_output.push('\n');
 
@@ -114,7 +170,12 @@ pub async fn run_ffmpeg(app: &AppHandle, args: Vec<String>) -> Result<String, St
                 }
                 CommandEvent::Terminated(status) => {
                     match status.code {
-                        Some(0) => return Ok(()),
+                        Some(0) => {
+                            if !stderr_output.is_empty() {
+                                log::debug!("[ffmpeg] stderr:\n{}", stderr_output.trim());
+                            }
+                            return Ok(());
+                        }
                         Some(code) => {
                             let err_detail = if stderr_output.is_empty() {
                                 "(no stderr output)".to_string()
@@ -145,16 +206,27 @@ pub async fn run_ffmpeg(app: &AppHandle, args: Vec<String>) -> Result<String, St
 
 
 /**
- * 标准化单个视频片段 (调整为 1080:1920, 25fps, libx264, aac 44100Hz stereo)
+ * 标准化单个视频片段 (调整为目标分辨率, 25fps, libx264, aac 44100Hz stereo)
  */
-pub async fn standardize_video(app: &AppHandle, input_path: &str, output_path: &str) -> Result<(), String> {
+pub async fn standardize_video(
+    app: &AppHandle,
+    input_path: &str,
+    output_path: &str,
+    target_width: u32,
+    target_height: u32,
+) -> Result<(), String> {
     // 验证路径安全
     let safe_input = validate_safe_path(input_path)?;
     let safe_output = sanitize_output_path(output_path)?;
-    
+
+    let vf = format!(
+        "fps=25,scale={}:{}:force_original_aspect_ratio=decrease,pad={}:{}:(ow-iw)/2:(oh-ih)/2,format=yuv420p",
+        target_width, target_height, target_width, target_height
+    );
+
     let args = vec![
         "-i".to_string(), safe_input,
-        "-vf".to_string(), "fps=25,scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2,format=yuv420p".to_string(),
+        "-vf".to_string(), vf,
         "-c:v".to_string(), "libx264".to_string(),
         "-c:a".to_string(), "aac".to_string(),
         "-ar".to_string(), "44100".to_string(),
@@ -190,7 +262,13 @@ pub async fn concat_videos_copy(app: &AppHandle, list_path: &str, output_path: &
 /**
  * 拼接视频 - 兼容模式 (多步走：标准化 -> 拼接)
  */
-pub async fn concat_videos_robust(app: &AppHandle, video_paths: Vec<String>, output_path: &str) -> Result<(), String> {
+pub async fn concat_videos_robust(
+    app: &AppHandle,
+    video_paths: Vec<String>,
+    output_path: &str,
+    target_width: u32,
+    target_height: u32,
+) -> Result<(), String> {
     // 使用输出路径的父目录作为临时目录（确保在安全目录内）
     let output_parent = std::path::Path::new(output_path)
         .parent()
@@ -200,13 +278,13 @@ pub async fn concat_videos_robust(app: &AppHandle, video_paths: Vec<String>, out
         .duration_since(std::time::UNIX_EPOCH)
         .unwrap()
         .as_millis();
-    
+
     let mut standardized_paths = Vec::new();
 
     // 1. 标准化每个片段（内部已验证路径）
     for (i, path) in video_paths.iter().enumerate() {
         let std_path = output_parent.join(format!("std_{}_{}.mp4", timestamp, i));
-        match standardize_video(app, path, std_path.to_str().unwrap()).await {
+        match standardize_video(app, path, std_path.to_str().unwrap(), target_width, target_height).await {
             Ok(()) => standardized_paths.push(std_path),
             Err(e) => {
                 // 清理本轮已创建的标准化文件
@@ -264,14 +342,26 @@ pub async fn add_audio_to_video(app: &AppHandle, video_path: &str, audio_path: &
 }
 
 /**
- * 将封面图转换为一段短视频 (0.5s, 1080x1920, 25fps)
+ * 将封面图转换为一段短视频 (0.5s, 目标分辨率, 25fps)
  * 带静音音频轨道，避免 concat 时丢失后续片段音频
  */
-pub async fn create_cover_video(app: &AppHandle, input_path: &str, output_path: &str, duration: &str) -> Result<(), String> {
+pub async fn create_cover_video(
+    app: &AppHandle,
+    input_path: &str,
+    output_path: &str,
+    duration: &str,
+    target_width: u32,
+    target_height: u32,
+) -> Result<(), String> {
     // 验证路径安全
     let safe_input = validate_safe_path(input_path)?;
     let safe_output = sanitize_output_path(output_path)?;
-    
+
+    let vf = format!(
+        "scale={}:{}:force_original_aspect_ratio=decrease,pad={}:{}:(ow-iw)/2:(oh-ih)/2,setsar=1",
+        target_width, target_height, target_width, target_height
+    );
+
     let args = vec![
         "-loop".to_string(), "1".to_string(),
         "-i".to_string(), safe_input,
@@ -281,7 +371,7 @@ pub async fn create_cover_video(app: &AppHandle, input_path: &str, output_path:
         "-c:a".to_string(), "aac".to_string(),
         "-t".to_string(), duration.to_string(),
         "-pix_fmt".to_string(), "yuv420p".to_string(),
-        "-vf".to_string(), "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2,setsar=1".to_string(),
+        "-vf".to_string(), vf,
         "-r".to_string(), "25".to_string(),
         "-shortest".to_string(),
         "-y".to_string(),
@@ -342,6 +432,58 @@ fn get_fonts_dir(app: &AppHandle) -> Result<std::path::PathBuf, String> {
  * 使用抖音美好体 Bold (DouyinSans Bold) 作为默认字体。
  * 支持可选的 PNG overlay（用于大标题/小标题，效果与前端 Canvas 预览一致）。
  */
+/// 为 FFmpeg 字幕压制准备临时工作目录，将 ASS 文件和字体复制到该目录，
+/// 返回 (临时目录路径, ASS 相对文件名, filter 字符串)
+fn prepare_subtitle_work_dir(
+    safe_ass: &str,
+    app: &AppHandle,
+) -> Result<(std::path::PathBuf, String, String), String> {
+    let ass_path = std::path::Path::new(safe_ass);
+    let ass_file_name = ass_path
+        .file_name()
+        .ok_or("无效的 ASS 文件路径")?
+        .to_string_lossy()
+        .to_string();
+
+    // 创建临时目录（系统临时目录下）
+    let temp_dir = std::env::temp_dir().join(format!(
+        "meijiaka_subtitle_{}",
+        std::time::SystemTime::now()
+            .duration_since(std::time::UNIX_EPOCH)
+            .unwrap_or_default()
+            .as_millis()
+    ));
+    std::fs::create_dir_all(&temp_dir)
+        .map_err(|e| format!("创建临时目录失败: {}", e))?;
+
+    // 复制 ASS 文件到临时目录
+    let temp_ass = temp_dir.join(&ass_file_name);
+    if let Err(e) = std::fs::copy(safe_ass, &temp_ass) {
+        let _ = std::fs::remove_dir_all(&temp_dir);
+        return Err(format!("复制 ASS 文件到临时目录失败: {}", e));
+    }
+
+    // 复制字体文件到临时目录
+    if let Ok(fonts_dir) = get_fonts_dir(app) {
+        if let Ok(entries) = std::fs::read_dir(&fonts_dir) {
+            for entry in entries.flatten() {
+                let path = entry.path();
+                if let Some(ext) = path.extension() {
+                    let ext = ext.to_string_lossy().to_lowercase();
+                    if ext == "ttf" || ext == "otf" || ext == "woff" || ext == "woff2" {
+                        let _ = std::fs::copy(&path, temp_dir.join(path.file_name().unwrap_or_default()));
+                    }
+                }
+            }
+        }
+    }
+
+    // 使用相对路径的 filter 字符串（无 C: 盘符问题）
+    let filter = format!("subtitles='{}'", escape_ffmpeg_filter_path(&ass_file_name));
+
+    Ok((temp_dir, ass_file_name, filter))
+}
+
 pub async fn burn_ass_subtitle(
     app: &AppHandle,
     video_path: &str,
@@ -358,18 +500,8 @@ pub async fn burn_ass_subtitle(
     let safe_ass = validate_safe_path(ass_path)?;
     let safe_output = sanitize_output_path(output_path)?;
 
-    let ass_path_escaped = escape_ffmpeg_path(&safe_ass);
-
-    // 构建 ASS filter（尝试带 fontsdir）
-    let ass_filter = if let Ok(fonts_dir) = get_fonts_dir(app) {
-        if let Some(fonts_dir_str) = fonts_dir.to_str() {
-            format!("ass='{}':fontsdir='{}'", ass_path_escaped, escape_ffmpeg_path(fonts_dir_str))
-        } else {
-            format!("ass='{}'", ass_path_escaped)
-        }
-    } else {
-        format!("ass='{}'", ass_path_escaped)
-    };
+    // 准备临时工作目录（ASS + 字体），使用相对路径避开 Windows C: 盘符问题
+    let (work_dir, _ass_name, subtitle_filter) = prepare_subtitle_work_dir(&safe_ass, app)?;
 
     // 如果有 overlay 图片，先 overlay 再 burn 字幕（两步避免 filter_complex 音频映射问题）
     if let Some(img_path) = overlay_image {
@@ -393,6 +525,7 @@ pub async fn burn_ass_subtitle(
 
         let _ = app.emit("ffmpeg-phase-start", PhaseInfo { step: 1, total: 2 });
         if let Err(e) = run_ffmpeg(app, overlay_args).await {
+            let _ = std::fs::remove_dir_all(&work_dir);
             let _ = std::fs::remove_file(&temp_output);
             return Err(format!("Overlay 图片失败: {}", e));
         }
@@ -400,7 +533,7 @@ pub async fn burn_ass_subtitle(
         // Step 2: burn ASS 字幕
         let burn_args = vec![
             "-i".to_string(), temp_output.clone(),
-            "-vf".to_string(), ass_filter.clone(),
+            "-vf".to_string(), subtitle_filter.clone(),
             "-c:v".to_string(), "libx264".to_string(),
             "-preset".to_string(), "medium".to_string(),
             "-crf".to_string(), "23".to_string(),
@@ -411,40 +544,18 @@ pub async fn burn_ass_subtitle(
         ];
 
         let _ = app.emit("ffmpeg-phase-start", PhaseInfo { step: 2, total: 2 });
-        let result = run_ffmpeg(app, burn_args).await;
+        let result = run_ffmpeg_in_dir(app, burn_args, Some(&work_dir)).await;
+        let _ = std::fs::remove_dir_all(&work_dir);
         let _ = std::fs::remove_file(&temp_output);
         return result.map(|_| ());
     }
 
-    // 无 overlay，走原有单步逻辑（带 fontsdir 回退）
-    let filter = ass_filter.clone();
+    // 无 overlay，单步 burn 字幕
     let _ = app.emit("ffmpeg-phase-start", PhaseInfo { step: 1, total: 1 });
 
-    let args = vec![
-        "-i".to_string(), safe_video.clone(),
-        "-vf".to_string(), filter,
-        "-c:v".to_string(), "libx264".to_string(),
-        "-preset".to_string(), "medium".to_string(),
-        "-crf".to_string(), "23".to_string(),
-        "-pix_fmt".to_string(), "yuv420p".to_string(),
-        "-c:a".to_string(), "copy".to_string(),
-        "-y".to_string(),
-        safe_output.clone(),
-    ];
-
-    match run_ffmpeg(app, args).await {
-        Ok(_) => return Ok(()),
-        Err(e) => {
-            eprintln!("[ffmpeg] 带 fontsdir 的 ASS 烧录失败，尝试回退: {}", e);
-        }
-    }
-
-    // 回退：不带 fontsdir
-    let filter = format!("ass='{}'", ass_path_escaped);
-
     let args = vec![
         "-i".to_string(), safe_video,
-        "-vf".to_string(), filter,
+        "-vf".to_string(), subtitle_filter,
         "-c:v".to_string(), "libx264".to_string(),
         "-preset".to_string(), "medium".to_string(),
         "-crf".to_string(), "23".to_string(),
@@ -454,49 +565,12 @@ pub async fn burn_ass_subtitle(
         safe_output,
     ];
 
-    run_ffmpeg(app, args).await.map(|_| ())
+    let result = run_ffmpeg_in_dir(app, args, Some(&work_dir)).await;
+    let _ = std::fs::remove_dir_all(&work_dir);
+    result.map(|_| ())
 }
 
-/** 压制 ASS 字幕到视频（带自定义字体目录）
- * 当前未使用，保留为扩展点。
- */
-#[allow(dead_code)]
-pub async fn burn_ass_subtitle_with_fonts(
-    app: &AppHandle,
-    video_path: &str,
-    ass_path: &str,
-    fonts_dir: &str,
-    output_path: &str,
-) -> Result<(), String> {
-    // 输入路径验证：HTTP URL 直接传递，本地文件需要安全检查
-    let safe_video = if video_path.starts_with("http://") || video_path.starts_with("https://") {
-        video_path.to_string()
-    } else {
-        validate_safe_path(video_path)?
-    };
-    let safe_ass = validate_safe_path(ass_path)?;
-    let safe_output = sanitize_output_path(output_path)?;
-    
-    let filter = format!(
-        "ass='{}':fontsdir='{}'",
-        escape_ffmpeg_path(&safe_ass),
-        escape_ffmpeg_path(fonts_dir)
-    );
-    
-    let args = vec![
-        "-i".to_string(), safe_video,
-        "-vf".to_string(), filter,
-        "-c:v".to_string(), "libx264".to_string(),
-        "-preset".to_string(), "medium".to_string(),
-        "-crf".to_string(), "23".to_string(),
-        "-pix_fmt".to_string(), "yuv420p".to_string(),
-        "-c:a".to_string(), "copy".to_string(),
-        "-y".to_string(),
-        safe_output
-    ];
-    
-    run_ffmpeg(app, args).await.map(|_| ())
-}
+
 
 /**
  * 混合背景音乐到视频（保留原视频音频）
@@ -504,7 +578,7 @@ pub async fn burn_ass_subtitle_with_fonts(
  * 使用 FFmpeg amix 滤镜将 BGM 与原视频音频混合。
  * 如果 BGM 短于视频，会自动循环；如果长于视频，会截断到视频长度。
  *
- * 注意：bgm_path 来自应用资源目录，不做 validate_safe_path 检查。
+ * BGM 路径必须是本地文件（由前端下载到 bgm_cache 后传入）。
  */
 pub async fn mix_bgm_to_video(
     app: &AppHandle,
@@ -515,8 +589,13 @@ pub async fn mix_bgm_to_video(
     bgm_volume: f64,
 ) -> Result<(), String> {
     let safe_video = validate_safe_path(video_path)?;
-    // BGM 来自应用资源目录，直接传递（路径由前端通过 Tauri path API 解析）
-    let safe_bgm = bgm_path.to_string();
+    // BGM 可以是用户通过系统文件选择器选取的任意本地文件，
+    // 验证文件存在且不含路径遍历字符
+    let safe_bgm = if !bgm_path.contains("..") && std::path::Path::new(bgm_path).exists() {
+        bgm_path.to_string()
+    } else {
+        return Err(format!("BGM 文件不存在或路径非法: {}", bgm_path));
+    };
     let safe_output = sanitize_output_path(output_path)?;
 
     // 构建 filter_complex:
@@ -524,7 +603,7 @@ pub async fn mix_bgm_to_video(
     // [1:a]volume=0.25,aloop=loop=-1:size=2e+09[bgm]; — BGM 调整音量后无限循环
     // [a0][bgm]amix=inputs=2:duration=first:dropout_transition=2[aout] — 混合，以第一个输入时长为准
     let filter_complex = format!(
-        "[0:a]volume={:.2}[a0];[1:a]volume={:.2},aloop=loop=-1:size=2e+09[bgm];[a0][bgm]amix=inputs=2:duration=first:dropout_transition=2[aout]",
+        "[0:a]volume={:.2}[a0];[1:a]volume={:.2},aloop=loop=-1:size=2e+09[bgm];[a0][bgm]amix=inputs=2:duration=first:dropout_transition=2:normalize=0[aout]",
         video_volume, bgm_volume
     );
 
@@ -695,7 +774,7 @@ pub async fn get_video_metadata(app: &AppHandle, input_path: &str) -> Result<Vid
 /**
  * 裁剪视频片段（支持本地文件和 HTTP URL）
  *
- * 从起始时间裁剪指定时长，同时标准化输出格式（1080x1920, 25fps, libx264, aac）。
+ * 从起始时间裁剪指定时长，同时标准化输出格式（目标分辨率, 25fps, libx264, aac）。
  * 适用于从人物形象素材或空镜素材中提取指定时长的片段。
  */
 pub async fn clip_video(
@@ -704,6 +783,8 @@ pub async fn clip_video(
     start: f64,
     duration: f64,
     output_path: &str,
+    target_width: u32,
+    target_height: u32,
 ) -> Result<(), String> {
     let safe_output = sanitize_output_path(output_path)?;
 
@@ -720,11 +801,16 @@ pub async fn clip_video(
     let start_str = format!("{:.3}", start);
     let duration_str = format!("{:.3}", duration);
 
+    let vf = format!(
+        "fps=25,scale={}:{}:force_original_aspect_ratio=decrease,pad={}:{}:(ow-iw)/2:(oh-ih)/2,format=yuv420p",
+        target_width, target_height, target_width, target_height
+    );
+
     let args = vec![
         "-ss".to_string(), start_str,
         "-t".to_string(), duration_str,
         "-i".to_string(), safe_input,
-        "-vf".to_string(), "fps=25,scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2,format=yuv420p".to_string(),
+        "-vf".to_string(), vf,
         "-c:v".to_string(), "libx264".to_string(),
         "-preset".to_string(), "veryfast".to_string(),
         "-crf".to_string(), "23".to_string(),
@@ -776,29 +862,154 @@ pub async fn extract_audio_segment(
 
 
 
+/**
+ * 从视频中提取音频（完整时长）
+ *
+ * 将视频文件的音轨提取为 MP3 格式，输出到指定路径。
+ * 适用于 MP4 → MP3 转换，供声音复刻使用。
+ */
+pub async fn extract_audio_from_video(
+    app: &AppHandle,
+    input_path: &str,
+    output_path: &str,
+) -> Result<(), String> {
+    let safe_input = validate_safe_path(input_path)?;
+    let safe_output = sanitize_output_path(output_path)?;
+
+    let args = vec![
+        "-i".to_string(), safe_input,
+        "-vn".to_string(),          // 去掉视频
+        "-c:a".to_string(), "libmp3lame".to_string(),
+        "-b:a".to_string(), "192k".to_string(),
+        "-ar".to_string(), "44100".to_string(),
+        "-ac".to_string(), "2".to_string(),
+        "-y".to_string(),
+        safe_output,
+    ];
+    run_ffmpeg(app, args).await.map(|_| ())
+}
+
+/**
+ * 解析 ffprobe 返回的帧率字符串（如 "30000/1001" 或 "30/1"）
+ */
+fn parse_frame_rate(s: &str) -> f64 {
+    if s.is_empty() {
+        return 0.0;
+    }
+    if let Some(idx) = s.find('/') {
+        let num: f64 = s[..idx].parse().unwrap_or(0.0);
+        let den: f64 = s[idx + 1..].parse().unwrap_or(1.0);
+        if den > 0.0 {
+            return num / den;
+        }
+    }
+    s.parse().unwrap_or(0.0)
+}
+
 /**
  * 为预览转码视频（统一为浏览器兼容格式）
  *
- * 将任意格式的视频转码为 H.264 Baseline + YUV420p 540p，
- * 确保在所有平台的浏览器/WebView 中都能正常预览。
+ * 快速通过检测：只有满足全部兼容性条件的视频才直接返回原路径，
+ * 任一不满足则强制转码为 H.264 Baseline + YUV420p 540p 代理。
+ *
+ * 检测项（基于主流浏览器/WebView 兼容性最佳实践）：
+ * - codec: H.264
+ * - pix_fmt: YUV420p
+ * - profile: Baseline / Constrained Baseline / Main
+ * - level: <= 4.1
+ * - color_range: limited (tv) — macOS VideoToolbox 对 full range 支持不完整
+ * - has_b_frames: 0 — macOS WKWebView 对 B-frames 支持不完整
+ * - refs: <= 4 — 参考帧数过多可能导致解码失败
+ * - r_frame_rate: <= 60fps — 高帧率可能异常
+ * - width/height: <= 1920x1920
+ *
+ * 转码参数参考 Mux/Transloadit 主流推荐，针对预览场景优化：
+ * - preset ultrafast: 编码速度优先（预览不追求极致压缩率）
+ * - crf 28: 预览画质够用
+ * - g 30 / keyint_min 30: 每秒一个关键帧，seek 更精确
+ * - 保留音频（人物形象视频有配音）
+ * - +faststart: moov atom 前置，快速开始播放
+ *
+ * 并发控制：tokio Semaphore(1)，保证同时只有一个 FFmpeg 进程在跑，
+ * 避免多视频同时预览时 CPU/磁盘争抢。
+ *
  * 转码结果按（文件路径 + 大小 + 修改时间）缓存，避免重复处理。
  */
 pub async fn transcode_for_preview(app: &AppHandle, input_path: &str) -> Result<String, String> {
-    let input = std::path::Path::new(input_path);
-    if !input.exists() {
-        return Err(format!("输入文件不存在: {}", input_path));
-    }
+    // 网络视频：先下载到本地缓存，再统一走转码/预览流程
+    let path_str = if input_path.starts_with("http://") || input_path.starts_with("https://") {
+        let app_data_dir = crate::storage::paths::get_app_data_dir()
+            .map_err(|e| format!("无法获取应用数据目录: {}", e))?;
+        let cache_dir = app_data_dir.join("video_cache");
+        std::fs::create_dir_all(&cache_dir)
+            .map_err(|e| format!("无法创建缓存目录: {}", e))?;
 
-    let path_str = input.canonicalize()
-        .unwrap_or(input.to_path_buf())
-        .to_string_lossy()
-        .to_string();
+        let url_hash = {
+            use std::collections::hash_map::DefaultHasher;
+            use std::hash::{Hash, Hasher};
+            let mut hasher = DefaultHasher::new();
+            input_path.hash(&mut hasher);
+            format!("{:016x}", hasher.finish())
+        };
 
-    // 快速检测：如果已经是 H.264 + YUV420p，直接返回原始路径（避免应用自己生成的成品重复转码）
+        let download_path = cache_dir.join(format!("download_{}.mp4", url_hash));
+
+        if !download_path.exists() {
+            log::info!("[transcode_for_preview] 下载网络视频: {} -> {}", input_path, download_path.display());
+            let client = reqwest::Client::builder()
+                .timeout(std::time::Duration::from_secs(60))
+                .build()
+                .map_err(|e| format!("创建 HTTP 客户端失败: {}", e))?;
+            let response = client.get(input_path)
+                .header("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64)")
+                .send()
+                .await
+                .map_err(|e| format!("下载网络视频失败: {}", e))?
+                .error_for_status()
+                .map_err(|e| format!("下载网络视频返回错误: {}", e))?;
+            let bytes = response.bytes()
+                .await
+                .map_err(|e| format!("读取网络视频数据失败: {}", e))?;
+            // 用 spawn_blocking 避免同步写文件阻塞 tokio 运行时
+            let download_path_clone = download_path.clone();
+            let bytes_clone = bytes.clone();
+            let write_result = tokio::task::spawn_blocking(move || {
+                std::fs::write(&download_path_clone, &bytes_clone)
+            })
+            .await;
+            if let Err(e) = write_result {
+                let _ = std::fs::remove_file(&download_path);
+                return Err(format!("写入任务失败: {}", e));
+            }
+            if let Err(e) = write_result.unwrap() {
+                let _ = std::fs::remove_file(&download_path);
+                return Err(format!("保存网络视频失败: {}", e));
+            }
+            if let Ok(file) = std::fs::File::open(&download_path) {
+                let _ = file.sync_all();
+            }
+            log::info!("[transcode_for_preview] 下载完成: {} bytes", bytes.len());
+        }
+
+        download_path.to_string_lossy().to_string()
+    } else {
+        let input = std::path::Path::new(input_path);
+        if !input.exists() {
+            return Err(format!("输入文件不存在: {}", input_path));
+        }
+        input.canonicalize()
+            .unwrap_or(input.to_path_buf())
+            .to_string_lossy()
+            .to_string()
+    };
+
+    // ============================================================
+    // 1. 快速通过检测：用 ffprobe 全面检查视频兼容性
+    // ============================================================
     let probe_args = vec![
         "-v".to_string(), "error".to_string(),
         "-select_streams".to_string(), "v:0".to_string(),
-        "-show_entries".to_string(), "stream=codec_name,pix_fmt,width,height".to_string(),
+        "-show_entries".to_string(), "stream=codec_name,pix_fmt,width,height,profile,level,color_range,has_b_frames,refs,r_frame_rate".to_string(),
         "-of".to_string(), "json".to_string(),
         path_str.clone(),
     ];
@@ -823,11 +1034,38 @@ pub async fn transcode_for_preview(app: &AppHandle, input_path: &str) -> Result<
                     if let Some(stream) = parsed.get("streams").and_then(|s| s.as_array()).and_then(|a| a.first()) {
                         let codec = stream.get("codec_name").and_then(|v| v.as_str()).unwrap_or("");
                         let pix_fmt = stream.get("pix_fmt").and_then(|v| v.as_str()).unwrap_or("");
-                        // 应用生成的视频通常是 1080p 及以下；若用户上传了 4K H.264，仍转码为 540p 代理以保证预览流畅
+                        let profile = stream.get("profile").and_then(|v| v.as_str()).unwrap_or("");
+                        let level = stream.get("level").and_then(|v| v.as_i64()).unwrap_or(0);
+                        let color_range = stream.get("color_range").and_then(|v| v.as_str()).unwrap_or("tv");
+                        let has_b_frames = stream.get("has_b_frames").and_then(|v| v.as_i64()).unwrap_or(0);
+                        let refs = stream.get("refs").and_then(|v| v.as_i64()).unwrap_or(0);
+                        let r_frame_rate = stream.get("r_frame_rate").and_then(|v| v.as_str()).unwrap_or("");
                         let width = stream.get("width").and_then(|v| v.as_u64()).unwrap_or(0);
                         let height = stream.get("height").and_then(|v| v.as_u64()).unwrap_or(0);
-                        if codec == "h264" && pix_fmt == "yuv420p" && width <= 1920 && height <= 1920 {
-                            return Ok(path_str);
+
+                        let is_safe_profile = profile == "Baseline"
+                            || profile == "Constrained Baseline"
+                            || profile == "Main";
+                        let is_limited_range = color_range == "tv" || color_range.is_empty();
+                        let no_b_frames = has_b_frames == 0;
+                        let refs_ok = refs <= 4;
+                        let level_ok = level <= 41;
+                        let fps = parse_frame_rate(r_frame_rate);
+                        let fps_ok = fps > 0.0 && fps <= 60.0;
+                        let resolution_ok = width <= 1920 && height <= 1920;
+
+                        let can_skip = codec == "h264"
+                            && pix_fmt == "yuv420p"
+                            && is_safe_profile
+                            && is_limited_range
+                            && no_b_frames
+                            && refs_ok
+                            && level_ok
+                            && fps_ok
+                            && resolution_ok;
+
+                        if can_skip {
+                            return Ok(normalize_path(&std::path::Path::new(&path_str)));
                         }
                     }
                 }
@@ -839,10 +1077,11 @@ pub async fn transcode_for_preview(app: &AppHandle, input_path: &str) -> Result<
         }
     }
 
-    // 获取文件元数据用于缓存 key
-    let metadata = std::fs::metadata(input_path)
+    // ============================================================
+    // 2. 缓存检查
+    // ============================================================
+    let metadata = std::fs::metadata(&path_str)
         .map_err(|e| format!("无法读取文件元数据: {}", e))?;
-    // 某些文件系统（如 FAT32）不支持修改时间，失败时回退为 0
     let mtime = metadata.modified()
         .ok()
         .and_then(|t| t.duration_since(std::time::UNIX_EPOCH).ok())
@@ -850,7 +1089,6 @@ pub async fn transcode_for_preview(app: &AppHandle, input_path: &str) -> Result<
         .as_secs();
     let file_size = metadata.len();
 
-    // 计算缓存路径（基于文件路径 hash + 大小 + 修改时间）
     let path_hash = {
         use std::collections::hash_map::DefaultHasher;
         use std::hash::{Hash, Hasher};
@@ -864,9 +1102,10 @@ pub async fn transcode_for_preview(app: &AppHandle, input_path: &str) -> Result<
     let cache_dir = app_data_dir.join("video_cache");
     std::fs::create_dir_all(&cache_dir)
         .map_err(|e| format!("无法创建缓存目录: {}", e))?;
-    let cache_path = cache_dir.join(format!("preview_{}_{}_{}.mp4", path_hash, file_size, mtime));
+    // 缓存版本号：每次修改转码参数后递增，确保旧缓存自动失效
+    const CACHE_VERSION: &str = "v3";
+    let cache_path = cache_dir.join(format!("preview_{}_{}_{}_{}.mp4", path_hash, file_size, mtime, CACHE_VERSION));
 
-    // 缓存命中且文件完整，直接返回
     if cache_path.exists() {
         let cache_meta = std::fs::metadata(&cache_path)
             .map_err(|e| format!("无法读取缓存文件: {}", e))?;
@@ -875,23 +1114,58 @@ pub async fn transcode_for_preview(app: &AppHandle, input_path: &str) -> Result<
         }
     }
 
-    // FFmpeg 转码：H.264 Baseline + YUV420p，540p，无音频，faststart
+    // ============================================================
+    // 3. FFmpeg 转码（带并发锁）
+    // ============================================================
+    let _permit = PREVIEW_SEMAPHORE.acquire().await
+        .map_err(|e| format!("无法获取转码锁: {}", e))?;
+
+    // 先写入临时文件，避免 FFmpeg 写入过程中被 WebKit 读取到不完整文件
+    let tmp_path = cache_path.with_extension("mp4.tmp");
+
     let args = vec![
-        "-i".to_string(), path_str,
+        "-i".to_string(), path_str.clone(),
+        "-map".to_string(), "0:v:0".to_string(),
+        "-map".to_string(), "0:a:0?".to_string(),
         "-c:v".to_string(), "libx264".to_string(),
         "-profile:v".to_string(), "baseline".to_string(),
         "-level".to_string(), "3.0".to_string(),
         "-pix_fmt".to_string(), "yuv420p".to_string(),
         "-preset".to_string(), "ultrafast".to_string(),
-        "-crf".to_string(), "28".to_string(),
+        "-crf".to_string(), "23".to_string(),
         "-vf".to_string(), "scale=540:-2:force_original_aspect_ratio=decrease".to_string(),
-        "-an".to_string(),
+        "-c:a".to_string(), "aac".to_string(),
+        "-b:a".to_string(), "128k".to_string(),
         "-movflags".to_string(), "+faststart".to_string(),
+        "-f".to_string(), "mp4".to_string(),
         "-y".to_string(),
-        cache_path.to_string_lossy().to_string(),
+        tmp_path.to_string_lossy().to_string(),
     ];
 
     run_ffmpeg(app, args).await?;
 
+    // 转码完成后验证临时文件大小
+    let output_meta = std::fs::metadata(&tmp_path)
+        .map_err(|e| format!("转码后无法读取临时文件: {}", e))?;
+    if output_meta.len() < 1024 {
+        let _ = std::fs::remove_file(&tmp_path);
+        return Err(format!("FFmpeg 转码输出文件过小: {} bytes", output_meta.len()));
+    }
+    log::info!("[transcode_for_preview] 转码完成: {} ({} bytes)", tmp_path.display(), output_meta.len());
+
+    // 原子重命名：确保 WebKit 只读到完整文件
+    std::fs::rename(&tmp_path, &cache_path)
+        .map_err(|e| format!("重命名缓存文件失败: {}", e))?;
+
+    // 强制刷新文件系统缓存（文件数据 + 目录项），避免 WebKit asset:// 首次读取到不完整数据
+    if let Ok(file) = std::fs::File::open(&cache_path) {
+        let _ = file.sync_all();
+    }
+    if let Some(parent) = cache_path.parent() {
+        if let Ok(dir) = std::fs::OpenOptions::new().read(true).open(parent) {
+            let _ = dir.sync_all();
+        }
+    }
+
     Ok(cache_path.to_string_lossy().to_string())
 }