# 2026-07-23 工作日志

## MCN_CYLG_API.py 重构为双模式调用

## 创作流程知识库引用方式修复（按需选取）

审计发现 S5/S3/S8/S11 四个步骤存在知识库引用问题，逐一修复：

### S5 选题方法论从内嵌转引用式
- 5大方法论表格：「方法+编导说明+示例」→「方法+一句话定位+知识库文件路径」（6个文件精确映射）
- 12种钩子策略（旧自定义分类）→ 10种标准分类对齐 `04_爆款开场`，加引用标注

### S3 钩子分类对齐知识库
- 4种钩子（提问/痛点/反常识/故事切入）→ 10种标准分类（对齐 `04_爆款开场`）
- System Prompt 新增 2 条知识库引用规则（04_爆款开场 + 01_账号设定）

### S8 处理规则添加知识库引用
- 第二步"植入方式选择"添加引用 `10_广告植入方法论`（一+五节）
- 第四步"合规检查"添加引用 `10_广告植入方法论`（三+四+六节）
- System Prompt 已有引用，处理规则补标注

### S11 精化 08_脚本诊断 引用粒度
- `08_脚本诊断/`全部文件（4个）→ 只引用 2 个质量检查文件
- 排除 2 个流程规范文件（各意图详细流程、四种意图）

### 未修改项
- S7 按用户要求暂不添加知识库引用，保持现状

### 背景
用户要求脚本支持两种用法：
1. 联网搜索（search）— 输入创作意图 + 搜索内容，提示词说明"搜索网络信息"
2. 知识库召回（recall）— 输入创作意图 + 搜索标签和内容，提示词说明"召回知识库中的知识"

### 实现内容
- 脚本从单一 `--query` 模式重构为子命令模式：`search` 和 `recall`
- search 模式：`is_online=1`，query 前缀 `联网搜索`
- recall 模式：`is_online=0`，query 前缀 `召回知识库中的知识`
- query 结构化构造：前缀 + 创作意图 + 搜索内容（+搜索标签）
- MD 文档同步更新：两种模式参数说明、query 构造格式、命令行参数对照表、调试示例

### 发现的 Dify 服务端问题
- **"搜索网络信息"前缀触发 Dify 工作流 bug**：该关键词命中 Dify 应用的条件分支，该分支引用了已删除的 `Doubao-Seed-Evolving` 模型，导致 400 错误
- **解决方案**：search 模式前缀改为 `联网搜索`，语义一致且不触发 bug
- "召回知识库中的知识"前缀无此问题，recall 模式直接可用

### 验证结果
- search 模式：HTTP 200，41.4 秒，返回"耄耋猫"梗解析 + 完整分镜脚本
- recall 模式：HTTP 200，77.1 秒，返回猫咪应激知识 + 3 个选题方向 + 分镜脚本
- 两种模式均已用脚本 `MCN_CYLG_API.py` 的子命令格式验证通过

### 文件变更
- `scripts/MCN_CYLG_API.py` — 重构为子命令模式（search/recall）
- `references/接口调用/MCN_CYLG_python.md` — 全文重写，覆盖两种模式说明

## Skill 完整性检查与修复

### 检查范围
对 `1_脚本创作方法/` 全目录进行完整性验证：SKILL.md 内容准确性、11步文件引用一致性、接口文档与脚本一致性、知识库映射表准确性

### 发现并修复的问题（7项）

**P0（路径/名称错误）：**
1. SKILL.md L251 根目录名 `脚本创作验证/` → `1_脚本创作方法/`
2. SKILL.md L324 过程产物路径 `deliverables/脚本创作案例/` → `2_脚本创作案例/`

**P1（内容不一致）：**
3. 创作流程规范.md S7映射表：仍列4个知识库引用 → 改为 `— | —`（S7已无知识库引用）
4. 创作流程规范.md S9映射表：仍列5个引用 → 改为 `07_对话风格 ★ | —`（清理后仅保留07）
5. SKILL.md S9描述：`6列逐镜头脚本` → `场次叙事格式脚本`
6. MCN_CYLG_python.md 请求体示例：query前缀 `搜索网络信息` → `联网搜索`
7. MCN_CYLG_API.py docstring：`"搜索网络信息"` → `"联网搜索"`

**P2（映射表辅助引用修正）：**
- S3/S4/S5/S6/S8/S10/S11 的辅助（●/△）引用列有多处列了但步骤文件中实际不存在，全部清理为 `—`

### 修复后映射表状态
映射表与步骤文件实际引用 100% 一致：
- S1: — | S2: 01△/02△/03△/07△ | S3: — | S4: 01★/07★
- S5: 02★/04● | S6: 03★/04●/05●/06● | S7: — | S8: 10★
- S9: 07★ | S10: 09★ | S11: 08★/03●/04●/07●

## deliverables 残留引用清理

用户指出 `deliverables/` 目录已不存在，清理 `3_产品页面设计/` 下两份 `03_可视化设计说明.md` 中的 6 处残留：

| 文件 | 修改 |
|------|------|
| `3_产品页面设计/产品文档/03_可视化设计说明.md` | 3处 → `../产品规划案例/...` |
| `3_产品页面设计/产品规划案例/产品文档/03_可视化设计说明.md` | 3处 → `../流程图/...`、`../产品框图/...`、`../短视频脚本创作_产品交付.html` |

全项目 `deliverables/` 路径引用清零（HTML 锚点 `id="deliverables"` 为页面内部 ID，非路径引用，无需修改）。

## 步骤1/2 重新命名：任务拆分 + 需求完善

用户明确两个步骤的语义：
- **S1 任务拆分**（原"需求拆分任务规划"）：将用户创作需求按五维度拆解为详细执行任务，判定信息完整度，生成缺失补全清单
- **S2 需求完善**（原"任务需求拆解完善"）：基于 S1 任务拆分结果，归类用户已有内容 + AI补全模糊意图 + 标注信息层级

修改范围（共8个文件）：
| 文件 | 改动数 |
|------|:--:|
| SKILL.md（流程总览、步骤描述、文件索引） | 5处 |
| 创作流程规范.md（索引表、Gate-0、映射表） | 4处 |
| 1_需求拆分任务规划.md（描述、会话状态、下游依赖） | 3处 |
| 2_任务需求拆解完善.md（描述、角色、会话状态、上游依赖、Gate-0文案） | 5处 |
| 3_对标视频账号拆解.md（上游依赖） | 1处 |
| 4_账号设定解析和确认.md（上游依赖） | 1处 |
| 5_生成短视频选题.md（上游依赖） | 1处 |
| 6_生成短视频框架.md（上游依赖） | 1处 |
| 11_脚本检查和诊断.md（回顾HTML映射表） | 1处 |
| 创作回顾.html | 4处 |

步骤文件（.md）未改名，文件名仍为 `1_需求拆分任务规划.md` / `2_任务需求拆解完善.md`，仅步骤逻辑名称变更。

## 11步创作流程模拟运行

选题来源：WebSearch 搜索到当前抖音最热话题「26版西游记职场梗」（5亿+播放），以此为选题跑通全流程。

- 账号：热点打工人 / 达人「阿瓜」（打工人嘴替型，95后互联网运营）
- 脚本：脚本01《每个公司都有这四种人，你是哪一个？》
- 流程：Step1→2→(3跳过)→4→5→6→7→(8跳过)→9→10→11，7个Gate全部通过
- 产出：10个过程文件 + 达人设定.md，存放于 `2_脚本创作案例/账号热点打工人/`
- 诊断：85/100分，65%爆款概率，预估50万-200万播放
- 核心亮点：3秒钩子+四角色金句映射+「被榨汁」终极反转+评论区互动设计

## 创作回顾HTML页面

用户要求用网页整理11步流程各阶段产出。生成`脚本01/创作回顾.html`（42KB），内容覆盖：
- 顶部Hero（项目信息+达人标签）
- 流程总览条（11步+6确认门+2跳过标注）
- 逐阶段卡片：S1需求拆分（含联网热搜4选题）、S2需求拆解（AI补全+信息层级）、S3对标拆解（跳过）、S4账号设定（8维人设卡片）、S5选题方案（3选题对比+推荐A标注）、S6脚本框架（场次表+情绪曲线）、S7脚本大纲（3场次大纲+金句预览）、S8广告植入（跳过）、S9脚本正文（完整3场次叙事脚本，金句高亮）、S10分镜脚本（18镜概览表+拍摄清单）、S11诊断报告（85分圆环+四维度评分条+3问题+最终结论）
- 交付清单（10项产出）
- 设计：~5色步骤编号、Gate橙色标注、跳过灰色处理、金句红色高亮、紫白配色

遇到路径编码问题：Write工具写入中文目录时产生乱码目录`��本01/`，通过PowerShell Move-Item将HTML移到正确位置并清理空目录。

## 步骤5选题阶段增加「用户选择」机制

用户反馈：多选题时AI不应自动选择，应让用户选感兴趣的选题。修改4个文件：

| 文件 | 修改 |
|------|------|
| `5_生成短视频选题.md` | 「四、用户确认机制」→「四、用户选择机制（强制执行）」，新增"AI不得代选/不得默认/不得预判"规则 |
| `SKILL.md` L61/128 | 流程总览Gate-2标注「用户选择选题」；步骤5描述强调"用户必须从多个方案中明确选择一个，AI不得代为决定" |
| `创作流程规范.md` L38/67 | Gate-2通过指令示例扩展为`选方案一/用第二个/通过`；新增Gate-2特殊规则：选择式提交格式模板，不可仅回"通过" |
| `脚本01/05_选题方案.md` | 最后一行"模拟模式默认选A"替换为标准Gate-2选择式提交格式（3选项+组合+重新生成） |

Gate-2现在是7个确认门中唯一在产出多个方案时必须用户明确选择一个的交互节点。

## 创作回顾.html 列为固定交付物

新增规则：每条脚本创作完成后必须生成创作回顾.html。修改3个文件：

| 文件 | 修改 |
|------|------|
| `SKILL.md` L208 | 步骤11新增「最终交付物（确认后自动生成）」段落，含命名规则和存放路径 |
| `SKILL.md` L334/351/362 | 目录结构新增`脚本01_标题_创作回顾.html`（账号文件夹根目录，与达人设定.md同级）；命名规则新增对应条目 |
| `创作流程规范.md` L23 | 步骤索引表新增一行「生成创作回顾.html 🔴」在步骤⑪之后 |
| `11_脚本检查和诊断.md` L70/74/77-94/160 | 输出列表新增🔴创作回顾.html；下游依赖链更新；新增「创作回顾.html 生成规则」章节（含10板块→来源文件映射表）；User Prompt模板新增第5项生成指令

### 18:47 P1 缺陷修复（3项）
- 修复两处UTF-8编码乱码：`SKILL.md` L124 "确认��人设" → "确认的人设"；`6_生成短视频框架.md` L128 "需���完善" → "需求完善"
- `7_生成短视频大纲.md` Gate-4 确认模板新增第④项「路径选择」（A快速/B完整·推荐），恢复双路径用户交互点

### 18:48 P0 缺陷修复（3项）
- `SKILL.md` L240/269/345 三处"6列"旧格式描述 → "场次叙事格式"，全文件 `6列` 已清零

### 18:50 路径规范化 — 全量相对路径 + 产出路径规范

确认技能目录零绝对路径后，完成两项工作：

**1. 知识库路径显式映射：**
- `创作流程规范.md` 四、引用格式规范 新增：`知识库/` → `references/知识库/`（相对于技能根目录），明确步骤文件引用知识库的实际相对路径为 `../知识库/`
- 确保拷贝到任意电脑后，AI 能根据映射规则找到知识库文件

**2. 新增「五、产出路径规范」章节：**
- 输出根目录：`../2_脚本创作案例/{账号名}/`
- 12行步骤→文件名→路径映射表（含步骤4双写规则、🔶可选标注、🔴回顾页）
- 目录创建规则、编号自增规则、达人设定账号级共享规则
- SKILL.md 补充"路径规范"段落声明全技能路径已相对化

**3. 同步修复：**
- `11_脚本检查和诊断.md` L94 回顾页路径 `2_脚本创作案例/` → `../2_脚本创作案例/`（相对于技能根目录）

### 18:55 创作流程全量检查第三轮 → P0+P1+P2 修复

全量检查发现 8 项问题（P0 2项 / P1 4项 / P2 1项 / 另1项已确认无问题），全部修复：

**P0（执行报错级）：**
| # | 修复 |
|---|------|
| 1 | `9_生成短视频脚本.md` 4处知识库文件名补全 `_通用_对话风格` 后缀 |
| 2 | `SKILL.md` L363 编码乱码 "可选���骤产出" → "可选步骤产出" |

**P1（不一致级）：**
| # | 修复 |
|---|------|
| 3 | `SKILL.md` L1 UTF-8 BOM 去除（通过 .NET UTF8Encoding(false) WriteAllText） |
| 4/5/6 | 流程图 Gate-0/4/5 的 `├──→` 箭头对齐（原来偏右约30空格，现在紧贴 ──┐ 末端） |
| 7 | 案例产物 `01_需求拆分.md` h1 "需求拆分任务规划"→"任务拆分"；`02_需求拆解.md` h1 "任务需求拆解完善"→"需求完善" |

**P2（优化级）：**
| # | 修复 |
|---|------|
| 8 | `7_生成短视频大纲.md` Gate-4 确认门文案 "短视频大纲 + 广告植入方案" → "短视频大纲{{如有广告则含广告植入方案}}"（条件式模板）

验证通过项：11步骤文件完整性✓ / 知识库52文件全存在✓ / S2-S11引用全匹配✓ / 零绝对路径✓ / 上下游依赖链无断裂✓