mcn-short-video/.workbuddy/memory/2026-07-27.md

2026-07-27 工作日志

抖音短视频解析接口开发

新建两个文件：

1. API 脚本

• 路径：scripts/Douyin_Video_Analysis_API.py
• 三种子命令：analyze（完整流程）、upload（仅上传）、detail（仅查询）
• 两步流程：POST 上传链接获取视频 ID → GET 轮询获取解析结果
• 轮询机制：间隔 30 秒、超时 10 分钟，content 或 analysis 非空时完成
• 07-27 优化：轮询间隔 30s→10s；code=500, msg="视频解析未完成" 从异常日志改为正常"解析中"状态，不再输出 ERROR
• 环境切换：--env test/prod，测试 maiya-trans.test.youmanvideo.com，线上 ai.maiyawx.com
• 鉴权方式：URL 查询参数 fsUserId（默认 6ga153ef），无需 API Key
• 仅用标准库（urllib），与现有 MCN_CYLG_API.py 风格一致

2. 接口定义文档

• 路径：references/接口调用/Douyin_Video_Analysis.md
• 包含：环境变量配置、三种子命令说明、两步接口详细信息、字段说明、与创作流程 S3 的集成方式

创作流程双模式设计

新增两种创作模式，控制 Gate（确认门）行为：

模式定义

• ⚡ 快速模式（默认）：AI 自动判断执行全流程，所有 Gate-0~6 自动通过；Gate-2 选题 AI 自动选推荐方案；Gate-4 默认路径B
• 🤝 共创模式：每个 Gate 必须用户确认后推进；Gate-2 用户必须选择方案

模式切换规则

• 默认快速模式
• 启动时注明 / 中途随时切换
• 切换生效点：下一个未执行的 Gate

修改文件清单（共 9 个文件）

1. SKILL.md — 新增「创作模式」章节 + 更新 frontmatter description + 更新流程图注释 + 更新关键规则一 + 快速启动模板加模式字段
2. 创作流程规范.md — 二、用户确认门机制 → 二、创作模式与用户确认门机制；新增模式定义+模式切换规则；P0 规则改为模式条件；严禁行为/修改循环规则标注共创模式适用
3. 2_任务需求拆解完善.md — Gate-0 加模式标注
4. 4_账号设定解析和确认.md — Gate-1 加模式标注
5. 5_生成短视频选题.md — Gate-2 加模式标注（AI自动选推荐方案）
6. 6_生成短视频框架.md — Gate-3 加模式标注
7. 7_生成短视频大纲.md — Gate-4 加模式标注（默认路径B）
8. 10_生成短视频分镜脚本.md — Gate-5 加模式标注
9. 11_脚本检查和诊断.md — Gate-6 加模式标注（自动生成回顾.html）

动态增量目录 reference-add

• 新建 references/知识库-add/ 文件夹（后升级为 reference-add/）
• 07-27 升级为 reference-add/：与 references/ 平级，三层结构：创作流程/ + 接口调用/ + 知识库/（01-10），覆盖全品类动态增量
• 更新 SKILL.md：目录树新增 reference-add 独立结构 + 文件分类表「增量」行 + 关键规则「四、动态增量管理」重写为三类整理规则
• 删除旧 references-add/ 和 references/知识库-add/，全项目零残留
• 核心逻辑：Skill 部署到非原始路径时，新增流程/接口/知识统一归入 reference-add/ 对应子目录；引用优先级 references/ → reference-add/

references-add 重命名

• reference-add → references-add（统一命名风格）
• SKILL.md：13 处替换；README.md：6 处替换；零遗漏

MCN 创意灵感接口双模式命名优化

• recall 子命令用途从「知识库召回」→「查询事件库」
• 修改文件：scripts/MCN_CYLG_API.py（8处）、references/接口调用/MCN_CYLG_python.md（5处）、SKILL.md（3处）
• 两种模式：🔍联网搜索(search, is_online=1) + 📚查询事件库(recall, is_online=0)

动态增量加载规则补全

• SKILL.md 规则四新增「运行时加载规则」表：references-add/ 有内容时，创作流程/知识库/接口调用三维度均同时加载两个目录
• README.md「引用优先级」从「先查标准库→未命中再查增量」改为「并发合并策略」

SKILL.md 全量审计（8问题全部修复）

P0 执行阻断级（4个）

• SKILL.md L464 路径规范补上 references-add/ 双目录
• 创作流程规范.md L251 路径解析补上 references-add/知识库/
• 创作流程规范.md L232 分类名「10 广告植入」→「10 广告植入方法论」
• README.md 引用策略冲突 → 并发合并

P1 健壮性（2个）

• 6_生成短视频框架.md L150 03_反转叙事套路.md 补全 知识库/03_框架节奏/ 前缀
• 9_生成短视频脚本.md L97 素人泛生活Vlog创作法...md 补全 知识库/07_对话风格/ 前缀

P2 路径层级（2个）

• 11_脚本检查和诊断.md 2处 创作流程规范.md 引用补上 ../ 前缀

创作流程功能框图重新生成

• 基于 1_脚本创作方法/references/创作流程 11步最新文件内容，重新生成创作流程功能框图
• 框图结构：4列Grid布局（流程步骤 / 关联知识库 / 输入格式 / 输出格式），从上到下排列
• 每步的输入/输出格式从步骤文件中精确提取（字段名、格式说明、来源步骤标注）
• 知识库映射来自创作流程规范第四节（★核心/●间接/△补充 三级标注）
• 7个Gate确认门独立行展示（橙色虚线标识）
• 可选步骤(S3/S8)灰色底色标注，S10双路径分列展示输入
• 清理 3_产品功能设计/产品文档/ 文件夹：删除短视频选题创作方法.md、短视频脚本创作_产品交付.html、11步创作流程.html（与产品规划和整体框图不相关）
• 保留6个文件：00_项目章程/02_产品架构/03_可视化设计说明/04_产品文档/产品框架图.html/创作流程功能框图.html

全量相对路径部署就绪审计

• 0 个绝对路径 ✅
• 0 个不存在的文件引用 ✅
• 所有知识库引用格式统一（知识库/编号_分类/文件名.md） ✅
• 所有 Markdown 链接可导航 ✅
• 产出路径 ../2_脚本创作案例/ 层级正确 ✅
• Python 脚本中无本地文件 I/O 操作 ✅

创作流程情感表达系统性优化（6步全链路强化）

基于知识库新增的情绪共鸣方法论（网感坐标/情绪递进设计/情感铺垫设计/脚本质量自动检查清单/编导意图解析规则），对创作流程 S5→S6→S7→S9→S11 全链路进行情感维度补强，解决"事件堆砌、情感表达薄弱"的系统性盲区。

修改文件清单（5个步骤文件 + 1个规范文件 = 6文件）

1. S6 生成短视频框架.md（#180）

• 8列维度说明表：情绪曲线 → 情绪功能位（蓄力/承接/转折/释放四选一）
• System Prompt：知识库引用从 06_剧情钩子/ → 07_情绪共鸣/ 分块5+分块1
• 新增四功能位设计规则（System Prompt）：蓄力场/承接场/转折场/释放场定义 + 全片情绪闭环自检
• 模板A+B：场次结构表头 情绪曲线 → 情绪功能位，内容从简单情绪标签改为功能位标注
• 输出模板：表头更新 + 情绪描述从"曲线走势"→"功能位弧线闭环路径"
• User Prompt：情绪标注要求从"起点→终点"→"功能位+情绪路径+闭环自检"
• Gate-3确认门：检查项从"情绪曲线调整"→"情绪功能位弧线是否完整"

2. S9 生成短视频脚本.md（#182）

• System Prompt：新增引用 07_情绪共鸣/ 分块5+6
• 新增规则：四通道表达模型（动作/表情/环境/台词协同）、情感债务机制（存入期→偿还期）、留白法则（每场1-2s纯画面）
• 禁止行为：从4项→8项（新增：禁用概括词/不准偏离功能位/禁用旁白直述/释放场必须有留白/不得漏情感债务偿还）
• 脚本质量自检：从5项→8项（新增：情绪功能位闭环/情感表达/情感债务/情绪留白）
• 输出模板自检清单：升级为9项情感维度版本

3. S11 脚本检查和诊断.md（#181）

• 新增第五节：情感表达专项检查（7项：情绪功能位闭环/四通道表达/情感债务/情绪留白/Show don't tell/事件堆砌检测/体感兑现）
• 原有章节重编号：六→七、七→八
• 爆款要素维度：情绪曲线高潮点 → 情绪功能位闭环+体感兑现（细化3项评分：四功能位完整3分+释放力度2分+体感兑现2分）
• System Prompt：新增引用 07_情绪共鸣/ + 12_拆解评估/ 分块7
• 输出要求：新增情感表达专项检查产出项

4. S5 生成短视频选题.md（#185）

• 选题维度：新增 目标体感 字段（从网感坐标选取 + 情绪标签 + 避免体感）
• System Prompt：新增引用 07_情绪共鸣/ 分块4（网感坐标）
• 输出模板：三个方案各增加「目标体感」行
• 输出清单：从5维→6维（加入目标体感）

5. S7 生成短视频大纲.md（#183）

• 大纲结构：情绪曲线 → 情绪设计卡（含：弧线类型/事件功能位标注/情绪路径/缺口自检/情感债务设计）
• System Prompt：新增 07_情绪共鸣/ 分块5引用 + 情绪功能位对齐S6硬约束
• 禁止行为：新增"不得使用简化情绪曲线，必须展开为完整情绪设计卡"
• 输出模板：完整情绪设计卡（含弧线类型+事件功能位标注表+情感债务设计表+缺口自检清单）
• Gate-4确认门：检查项从"情绪曲线合理"→"情绪设计卡是否合理（四功能位完整+情感债务闭环）"
• 输出清单：新增情绪设计卡产出项

6. 创作流程规范.md（#184）

• 知识库分类索引：新增 07_情绪共鸣（3文件：三层模型/网感坐标/情绪递进+情感铺垫） + 12_拆解评估（2文件：七类30项/编导意图解析）
• 步骤→知识库映射表：6处更新
  • S5：新增辅助参考 07_情绪共鸣 ●（网感坐标·目标体感确定）
  • S6：核心依赖从 06_剧情钩子 ● → 07_情绪共鸣 ★（情绪功能位）
  • S7：从空 → 新增辅助参考 07_情绪共鸣 ●（情绪设计卡·情感债务）
  • S9：新增核心依赖 07_情绪共鸣 ★（四通道表达·情感债务·留白法则）
  • S11：新增 07_情绪共鸣 ●（情感表达专项检查）+ 12_拆解评估 ●（七类30项·编导意图解析）

新增方法论引用覆盖率：5/5（100%）

新增方法论	引用步骤	状态
分块4 网感坐标	S5	✅
分块5 情绪递进设计	S6/S7/S11	✅
分块6 情感铺垫设计	S9/S11	✅
分块7 脚本质量检查清单	S11	✅
分块8 编导意图解析规则	S11	✅