10 KiB
10 KiB
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 个文件)
SKILL.md— 新增「创作模式」章节 + 更新 frontmatter description + 更新流程图注释 + 更新关键规则一 + 快速启动模板加模式字段创作流程规范.md— 二、用户确认门机制 → 二、创作模式与用户确认门机制;新增模式定义+模式切换规则;P0 规则改为模式条件;严禁行为/修改循环规则标注共创模式适用2_任务需求拆解完善.md— Gate-0 加模式标注4_账号设定解析和确认.md— Gate-1 加模式标注5_生成短视频选题.md— Gate-2 加模式标注(AI自动选推荐方案)6_生成短视频框架.md— Gate-3 加模式标注7_生成短视频大纲.md— Gate-4 加模式标注(默认路径B)10_生成短视频分镜脚本.md— Gate-5 加模式标注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项·编导意图解析)
- S5:新增辅助参考
新增方法论引用覆盖率:5/5(100%)
| 新增方法论 | 引用步骤 | 状态 |
|---|---|---|
| 分块4 网感坐标 | S5 | ✅ |
| 分块5 情绪递进设计 | S6/S7/S11 | ✅ |
| 分块6 情感铺垫设计 | S9/S11 | ✅ |
| 分块7 脚本质量检查清单 | S11 | ✅ |
| 分块8 编导意图解析规则 | S11 | ✅ |