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