mcn-short-video/project/短视频脚本创作/V1.0/references-add/变更日志.md

变更日志（主 SKILL.md frontmatter last_change 历史归档，09-04 起）

用途：SKILL.md frontmatter last_change 字段的历史明细归档处（该字段仅保留最近一次变更的一行摘要，完整明细按日期记于此）。 维护规则：每次变更 SKILL.md 时——① 在下方按日期追加一条（新在上）；② frontmatter last_change 更新为当次一行摘要。 本文件位于 references-add/（运行时与标准库取并集加载，不影响创作执行逻辑，仅供维护追溯）。

---

2026-09-24（执行：素材层切换 WeKnora + 方法层接线）

• 触发：用户「按照方案执行」，执行《技能接入WeKnora实施规范_V1.0》《极致事件素材接入创作流程方案_V1.1》。定性经用户两轮收口 —— ① 驱动关系由素材驱动改为方法驱动；② 素材动作不叫「扩容」叫切换（素材载体：本地 md → WeKnora）。
• 新建调用契约：接口调用/WeKnora_极致事件检索.md —— MCP hybrid_search（服务 weknora）+ FAQ 容器 MCN极致事件素材库；kb_id 用库名（禁写死 UUID）；match_count=3；vector_threshold=0.5 显式传；不传 keyword_threshold（FAQ 恒为纯向量召回）；禁用 chat/agent_chat（会摘要化卡片，丢失原话/微反应/铺垫量级）。含镜像式五要素问法、返回判据（success=true 且 data=null = 零命中而非调用失败；同卡内容重复三份、只读 chunk_metadata.answers[0]）、复筛 ≤2 条/节点、取材不取形转译、降级矩阵、上下文成本控制（match_count=3 + 按需检索 + 读后即弃）。
• 方法层接线（治「方法层 0 调用」）：创作流程/7_生成短视频大纲.md「极致触点节点布位」表新增「候选创作方法」列（钩子型→极致行为四分类；留人型→预期反转四载体 / 冲突叙事套路；转粉型→克制 / 荒诞化 / 抽象化；传播型→无厘头 / 专属符号型），并明定调用方向自上而下：方法定手法 → 类型定判定 → 检索取素材，禁止素材驱动。
• S7 检索环节：新增「极致触点素材检索」小节（布位定完 → 事件展开之前，按需触发：已有桥段的节点跳过，通常一视频 1–3 次）+ {material_content} 注入格式定死（机制来源 / 落差结构 / 手法与铺垫量级 / 拍摄参考 / 本账号转译，不含原卡人物名与台词）+ 新增极致触点机制自检（每个 L1 节点须写得出 [期待A] —被X打破→ [结果B]，写不出则降级为普通情节、不计入 L1 密度）；输入章节「素材库」改为双层源（主源 WeKnora 检索 / 源与降级 md 文件，md 永不删除）；System Prompt 与禁止行为同步（禁跳方法列、禁搬卡原文、禁零命中编造）。
• SKILL.md：MCP 依赖章节新增「WeKnora 检索层（极致事件素材 · 可选增强）」含降级口径；S7 小节补全调用链 + 输出增「极致触点机制自检」+ 新增检索契约引用行；frontmatter updated_at → 2026-09-24。
• S9/S11 配套：S9 输入增 {material_cards}（可选）+ 新增「台词毛边三档参考」（原话 / 微反应 / 意外，只借范式不借句子、不得影响「说什么」）；S11 类1「爆点贯穿」升级为爆点溯源 4 判据（次数 / 可溯源 / 落差三件套 / 转译合规），知识库/09_脚本诊断/脚本质量自动检查清单_八类35项.md 类1 同项同步。
• 索引修正：索引_知识素材库.md 修正 03/05/06/07/08/11 六个库的定性（实为字段结构模板、尚无实素材条目 —— 原描述「生活仪式化行为选型」「穿搭方案选型」等承诺了不存在的内容）；素材库章节补双层源说明 + 新增「极致事件素材（事件类 · 主源在 WeKnora）」行；新增「三、接口调用」章节。
• 6 个方法文件各补「素材供给」块（极致标签 / 定库 / 问法「② 打破方式」填法）：极致行为创作法（不映射标签、横切未定、按事件标签跨库找载体）、预期反转（反差·反常识·价值观冲击；铺垫 中 3-10s）、荒诞化 / 抽象化 / 无厘头（自嘲反差·反差）、错位化-反常化（反常识·反差）。
• 未执行（留待后续，见方案 §六）：① 6 个空壳库的字段结构并入 分块定义/ 后原文件退役；② 21 条载体素材补问答对入库；③ 清理 15 条泛化磁铁卡 + 6 条标签污染；④ 240 条卡补「方法归属」字段。

2026-09-23（执行：极致事件卡片层治本 —— 10 固定字段硬规则 + 「极致触点」三义裁决 + 横切定库）

• 触发：用户「按照方案优化」，执行同日《极致事件卡片优化方案_V1.0》全部 10 项（P0 3 / P1 4 / P2 3）；三项待确认按方案建议选项落地（库位 → B 跨库横切；触点治理 → A 加裁决条款不改名；存量卡 → A 按 V1.3 重出）。
• 口径单源（治「极致触点」一词三义）：知识库/05_极致事件/01_极致类型-素材标签映射表.md 第四节新增 4.5 条款 —— 摊开 A 布位层（爆点节点）/ B 卡片层（击中原因）/ C 8 库层（内容描述）三义 + 一句话判据（「说画面里有什么」= C /「说用户为什么被击中」= B /「说它在第几秒引爆」= A）；明确 C = 极致事件「极致内容」字段的等价物；硬规则：极致事件类必须写满 10 固定字段，不得退回 8 库口径。节标题「四条」→「五条边界裁决条款」。
• 横切定库（治 D2 + 缺口 1）：同文件第二节新增「定库列怎么读」说明 —— 极致事件 = 跨库横切类别，「定库」为选定的检索入口库、可为空（—（横切未定））；「极致行为」行补注定库口径；表头变更行登记。不做新增「行为/情境」类库、不做同一事件多库复制。
• 模板层（素材库/分块定义/00_模板-各库分块模板.md §极致事件，升 V1.2 → V1.3）： ① 新增两条头注 —— 10 字段硬规则 + 卡片头元信息行 > 所属库：{NN 库名 ｜ 横切未定}（不占字段位）； ② 「极致内容」补两条要求（人物语言保留原话不概括 + ≥1 处真实毛边）； ③ 「内容含义」补时间跨度型写法（成长/蜕变类 [长期期待 A] —经 X 过程→ [结果 B]）； ④ 「极致触点」四子项收敛为效果侧两项（用户心理 / 共鸣），机制侧「反差 / 猎奇」归还「事件标签 / 极致类型」+ 效果词不得复用标签词； ⑤ 「创作手法」补子项 铺垫量级：短 ≤3s / 中 3–10s / 长 >10s； ⑥ 「事件标签」补自检 下限 ≥2 值 + 「（主）」记法（主标签 = 定库依据）； ⑦ 专属段说明补「横切未定则省略本段」；专属说明 5 条 → 6 条。
• 顺带修正模板内自相矛盾：§三 总表 ※2 字段数 9 + 10 = 19 → 10 + 10 = 20（落 03 库 10 + 5 = 15；横切未定只写 10）；※3 末尾「同名升级」处补 4.5 指针（闭合原文「是否同步见第四节」的悬空指针）；「事件标签位于卡片末位」→ 第 4 位（专属说明 4 同步）。
• 评估标准（知识库/05_极致事件/03_极致事件评估标准.md）：第一节补「翻车 / 失败 / 未达预期也是合法的极致」 —— 豪言后翻车同等入库，但须写清被打破的期待落点（否则是流水账、不入库）；与「步骤 5 真实性校验」不冲突（须真实发生）。
• 存量卡重出（极致事件提取_多类别样本_20260922.md，仓库根）：§二 12 张卡由旧口径 9 字段迁移为 V1.3 的 10 固定字段 + 元信息行 —— 原「极致标签」→ 事件标签（第 4 位）；原「极致触点」→ 极致内容（第 1 位）；原「表现形式」→ 内容含义（第 2 位）；新增效果侧 极致触点（原卡无此字段，按 V1.3 补写、依据原描述推断、不含新事实）；创作手法 补铺垫量级；补卡片头 > 所属库：…。事件内容与判据一字未改。 同文件同步修正：§一 定库列（7 处 ⚠️ 见 §四 → —（横切未定））、§3.1 类型分布（错位 2→1、补 品质 1 —— 原表把 F1 误记为错位）、§3.2 标签分布（按 §一 总览重算；零命中实为 4 个）。
• 新自检暴露（重要实证）：重出后按「事件标签 ≥2 值」自检，12 张卡中 6 张为单标签（P1 / P2 / P3 / C1 / C2 / C3）—— 保留实测原判、逐条标 ⚠️、不追补，作为该条款必要性的实证（与 D5 判断一致）。
• 明确不做（保持原判）：卡片内嵌 Prompt 模板（越层）／卡内嵌评分字段（与模板说明 2 冲突）／「黄金组合」字段（用法非素材属性）／标签层加「一级心理刺激」（违反 4.4 红线）／「用户需求层」（选题层职责）／8 库「极致触点」字段改名（沿用 4.1「只加裁决、不全量改名」原则）。
• 核对：模板 / 映射表 / 评估标准三文件口径一致；00_模板 内旧字段数 9 + N 零残留；12 张卡全部含 10 固定字段 + 元信息行。

2026-09-23（追加·执行：治本 11 的「信息密度」一词二义 → 更名「展开深度检查」）

• 触发：上一轮（三级留人点体系）留的两项「未同步项」之一，用户回复「按照建议执行」。
• 问题：创作流程/11_脚本检查和诊断.md 里「信息密度」一词二义 —— 「二、信息密度检查」= 展开深度静态数量（具名物品/对话组/步骤链/环境细节），四维度表里那条 = 时间轴频率（已更名「留人密度」）。同名共存，读法不稳定。
• 处置（改名而非加注，消除同根）：
  1. 11_脚本检查和诊断.md：「二、信息密度检查」→ 「二、展开深度检查」（业务逻辑头、模块标题、四维度弱情感铺垫行、System Prompt 第 2 项/审核规则/知识指针、输出模板章节标题共 7 处）；原「命名区分（防混淆）」改为「命名沿革」，保留两口径不互相替代的说明；「改为检查信息密度…」同步为「留人密度」。
  2. 连带引用：SKILL.md（能力清单行）、创作流程/7_生成短视频大纲.md:178（大纲校验项更名，与「展开深度标准」同名归一）。
  3. 频率义引用统一为「留人密度」：创作流程/9_生成短视频脚本.md（弱情感铺垫「留人密度优先」+ 赛道标准指针）、创作流程/6_生成短视频框架.md（弱情感铺垫等级行、三问自检 3 处、赛道标准指针、模板 A 侧描述）。
  4. 症状名去同根：03_框架节奏/04_节奏控时（2.2 节奏信号行、七、误区「信息密度过低」→「留人点过疏」）；03_框架节奏/01_标准爆款结构模板（误区行「中段信息密度过低」→「中段留人点过疏」）。
  5. 子技能副本同步：mcn-dou-analysis/references/知识库/视频拆解/框架04_节奏控时.md（2 处）、框架01_标准爆款结构.md（1 处）。
• 保留边界（未动）：「信息密度」作为通用描述语 / 关键指标 / 方法论原文 / 文件标题的用法一律保留（如 01_标准爆款结构模板:289「关键指标：信息密度高」、08_对话风格/高信息密度Vlog创作法、创作流程/3_对标视频账号拆解「每30秒信息增量」）—— 本次只治「作为阈值口径名或模块名」的义项，不做全量替换。
• 核对：全树扫 信息密度检查 → 有效规则零残留（剩余命中全部为 8 库方法论原文 + 第三方参考技能 + 本日志自身）。

2026-09-23（方案·未执行：极致事件卡片优化方案 V1.0）

• 触发：用户指出「对于极致事件卡片，没有什么优化的建议和方案」。本方案为卡片层专项，与上一轮「留人点」（流程侧）并行、互不改口径。
• 核心结论：卡片主体不需重构（三字段分工 事实/机制/效果 成立，外部评审亦认可）；真问题是三条结构性问题 —— ① 存量卡两套口径并存（同日 极致事件卡_癫婆_模板版 为 V1.2 的 10 字段；极致事件提取_多类别样本 12 条仍为旧口径 9 字段，全部用「表现形式」、且无新口径的「极致触点」）； ② 「极致触点」一词三义（布位层 = 爆点节点 / 卡片层 = 击中原因 / 8 库层 = 内容描述）； ③ 10+N 的 N 不可见（卡内无「所属库」标注，致本地缺口 1「12 个事件里 7 个定库无处可落」无法落地）。
• 外部 9 条建议判定：采纳 1（双轴体系 → 用本地方案落地：卡片加归属标注 + 映射表「定库」列改可空）；改造 4（事件强度评分 → 把已在使用但未定义的「主/辅」标注正式化，不新增字段；失败样本 → 不建新库，判定处补准入一行；真人细节 → 「极致内容」补「原话不概括」+「≥1 处真实毛边」；节奏字段 → 只取「铺垫量级」，出现位置与情绪曲线分别归 S7 布位、07_情绪共鸣）；否决 3（卡片内嵌 Prompt 模板 = 越层；黄金组合字段 = 组合是用法非素材属性；标签三级分层之「一级心理刺激」= 违反 4.4 条款「情绪效果不设标签」红线；用户需求层 = 选题层职责）。
• 4 个外部「盲区」核实：3 个已被现有体系覆盖 —— 成长/蜕变 → 反差 + 期待铺垫 + 「内容含义」时间跨度变体；挑战规则 → 极致行为·强度拉满 + 难度极限；关系变化 → 预见式服务标签，定义原文即「对方还没开口就已经做好」。仅「悬念/信息差」属标签层挤压（对应本地缺口 2），非新类型。
• 产出：极致事件卡片优化方案_V1.0_20260923.md（仓库根，含 D1–D6 缺口、P0–P2 改动清单、明确不做清单、3 项待确认）。技能文件零改动。

2026-09-23（中段留人机制治本：新增「三级留人点体系」，合并 35 项两条口径打架的密度项）

• 触发：用户提出「能否提升中间留人的吸引力，10 秒左右一个吸引点抓住用户注意力」。只读审计后发现瓶颈不在阈值松紧，而在中段留人在技能里没有被定义成可产出、可自检的东西。
• 审计发现（4 项）：
  1. 三条密度线口径打架：A 信息密度 每10秒（9_生成短视频脚本.md:151/441、35项:73、04_节奏控时:48/91/106、01_标准爆款结构模板:246、06_编导终审:71）＝下限防腐；B 钩子密度 每15秒（35项:72）全技能无定义、无来源、无产出格式，悬空；C 极致触点 每15-20秒（7_生成短视频大纲:66/159、05_极致事件/03:17/41）＝上限爆点，资源有限不可能也不应 10 秒一个。
  2. 产出粒度太粗：S6「本场钩子」是场级（一场 15-25s → 15-25s 才一个留人设计）；S7 只有 4 个极致触点布位、非窗口化 → 「每10秒一个吸引点」在全部产出物里没有字段。
  3. 校验强度倒挂：S7 里 L1 极致触点是硬闸门，中段留人（原 L162-163）只是"参见知识库"软引用；而 L165-171 硬检查全是静态数量（具名物品≥12/对话≥4组/故事细节≥50），与时间轴无关。
  4. 命名口径分化：钩子类型存在 4 套并存的枚举（五类留人机制 / 01_标准爆款结构模板:143-149 的「数据冲击·违背常识」/ 04_爆款开场 10 种开场方式（CSV）/ 04_爆款开场 8 个旧钩子文件口径）。
• 方案（路线 A 合并升级，非新增第 4 条平行线）：三级留人点体系 —— L1 极致触点（15-20 秒，稀缺性保护，不动）/ L2 留人点（每 10 秒 ≥1，由 A 升级 + B 归并）/ L3 增量点（3-5 秒，知识库已有，落成字段）。L2 判据＝观众产生一个明确的「为什么」（抛问题/打破预期/说到自己/给承诺，类型名沿用五类留人机制，不新造枚举）；可自检换算＝本场最少留人点数 = ⌈本场时长 ÷ 10⌉；分赛道分档＝剧情/知识/口播/搞笑 10 秒、Vlog/美食/亲子/情侣 10-15 秒、沉浸/治愈/慢生活 15 秒。
• 改动（11 个文件）：
  • 口径单源：references/知识库/03_框架节奏/04_节奏控时叙事套路.md 新增 1.3「三级留人点体系」（定义/阈值/判据/换算/分档/禁止混层）；1.2 后各节与 2.2 节奏信号、七、误区、八、自查清单同步对齐（删「每15秒一个新信息」，情绪峰值 20 秒→15-20 秒）。
  • 知识库对齐：03_框架节奏/01_标准爆款结构模板.md（钩子类型表加五类口径说明，数据冲击/违背常识 归入反差画面；中间主体 ⑤ 与误区、自查清单指向 1.3）；03_框架节奏/06_编导终审验收标准.md（「增量密度」→「留人密度」，中段不疲加「极致触点空档 ≤ 20 秒」，Step 4 与返工归因同步）。
  • 创作流程产出与闸门：创作流程/6_生成短视频框架.md（「本场钩子」列加 10 秒窗口粒度 + ⌈时长÷10⌉；新增「本场钩子 ≠ 极致触点」提示；场次结构输出模板占位符与校验行同步；模板A/B 与三段式速查表口径同步）；创作流程/7_生成短视频大纲.md（新增「留人点布位」表 + 禁止混层/不计入留人点三类说明；校验规则新增硬闸门「留人点数 ≥ ⌈本场时长÷10⌉，不达标打回 S6」+ 类型覆盖 ≥2 类；原两条软引用改为指向 01_标准爆款结构模板；大纲输出模板各场新增留人点字段；开场钩子类型枚举改为五类）。
  • 质检层：创作流程/9_生成短视频脚本.md（L151/L441「信息密度」→「留人密度」）；创作流程/11_脚本检查和诊断.md（类4 两项更名、四维度「信息密度」条目→「留人密度」并给出分档判据、输出模板行同步、弱情感铺垫评分项改为留人密度达标；「二、信息密度检查」（展开深度静态数量）加命名区分注，避免与新留人密度混淆）；知识库/09_脚本诊断/脚本质量自动检查清单_八类35项.md 类4「钩子密度+信息密度」合并为「留人密度」、腾出槽位新增「留人点类型覆盖」（类4 仍 3 项、总数仍 35 项）。
  • 极致事件层：知识库/05_极致事件/03_极致事件评估标准.md（密度校验加「不计入彼此」说明；第四节分工表新增 03_框架节奏 行，明确「极致触点 ≠ 留人点，禁止互相替代」防爆点稀释；文件头加 09-23 变更行）。
  • 钩子机制映射：知识库/04_爆款开场/00_开场方式全量覆盖分析.md 新增第五节「五类留人机制 ↔ 开场方式 ↔ 中段复用」映射表 + 两条红线（中段选型不受 S5 限制、中段复用≠重放开场话术）。替代原计划新建 5 篇中段方法论文件——五类机制的方法论本就在本库 10 篇开场方式文件里，新建属重复建设。
  • 子技能副本同步：subskills/mcn-script-review/SKILL.md 与 references/脚本复盘流程.md（框架节奏维、爆款开场维「中间留人钩子」、中段不疲、评分总表行）；subskills/mcn-dou-analysis/references/知识库/视频拆解/框架04_节奏控时.md（含 2.1 与节奏控制信号）。
  • 版本标签：SKILL.md frontmatter updated_at/last_change 更新（version 保持 1.0，与既往惯例一致）。
• 残留核对：全树扫描 钩子密度/每15秒/每10秒至少1个新信息——有效规则零残留；剩余命中仅在 subskills/mcn-video-prompt/参考skills/script-writing-studio/（第三方参考技能，禁改）2 处。
• 遗留项（同日追加批次已解决其一）：11_脚本检查和诊断.md 内「二、信息密度检查」与新增「留人密度」共用「信息密度」词根的一词二义问题 —— 已于 2026-09-23 追加批次更名为「展开深度检查」（连带 10 文件同步，见上方「追加·执行」条）。仍未做：赛道分档阈值（剧情 10 秒 / Vlog 10-15 秒 / 沉浸 15 秒）为推定值非实测，建议跑 3-5 条真实脚本后按落选/留存数据回调。
• 关联产出：中间留人机制诊断与留人点体系方案_V1.0_20260923.md（仓库根，含 8 项改动点清单与证据索引 文件:行号）。

2026-09-10（工作台配置收敛：端口/DB/目录单源化，代码层统一引用 config.json）

• 触发：用户问「这些设定能否用配置，所有文件和脚本都引用，避免有调整时到处修改」。确认范围：只收敛代码层（不动文档/技能规范），配置放 mcn-work-shop/config.json。
• 目标：工作台散落在 server.js / dsh-data.js / 4 个辅助脚本 / 前端 data-pages.js / start.bat 里的硬编码设定（端口 8900、DB 名 mcn-plugin.db、产出根 MCNSkill项目、榜单目录），统一收进 config.json，代码层一律从配置读，调整只需改 config.json 一处。
• 新增：
  • mcn-work-shop/config.json：单一配置源（port / dbName / outputRoot / businessDataDir / extraRoots）
  • mcn-work-shop/load-config.js：配置读取唯一入口 + 默认值唯一来源（config 缺失/损坏回退 DEFAULTS）
• 改动：
  • server.js：require('./load-config') 取 CFG；PORT_BASE = argv[2] || CFG.port（argv 端口仍优先）；DEFAULT_ROOT / path.join(ROOT, CFG.dbName) 从 CFG 读；saveConfig 合并写盘保留其它字段；错误提示「mcn-plugin.db」→ CFG.dbName 动态
  • dsh-data.js：删本地 loadCfg，改用 loadConfig；DSH_DB = path.join(__dirname, CFG.dbName)；榜单目录 path.join(...CFG.businessDataDir)
  • build-create-prompts.cjs / submit-review-tasks.cjs / poll-create-tasks.cjs / poll-review-tasks.cjs：DB / API 端口 / prompt 内 dbName 字面量 → CFG 动态
  • public/data-pages.js：新增 const BASE = location.origin；SKILL_HINT_VIDEO_PARSE / SKILL_HINT_ANALYZE / saveHintOf 里的 http://localhost:8900 全部改 BASE 动态（前端读不到 server 端 config.json，用 location.origin 让回调地址端口自动跟随当前访问地址）
  • start.bat：端口从 config.json 读取（for /f + load-config），不再写死 8900
• 踩坑：load-config.cjs 用 .cjs 扩展名时，require('./load-config') 无扩展名解析会 MODULE_NOT_FOUND（Node 不会把 .cjs 作为无扩展 require 的解析目标）→ 重命名为 load-config.js（无 package.json，默认 CommonJS）后所有引用自动生效。node --check 只查语法不执行 require，此坑在运行时才暴露。
• 验证：8 文件 node --check 全通过；loadConfig() 正确读回 config.json 全字段；工作台重启 HTTP 200（端口 8900、产出根 MCNSkill项目 均从 config 正确读取）。

2026-09-10（dsh 部署环境废弃：三环境 → 两环境，判定简化为一步）

• 触发：用户确认「第一步 技能路径含 .dsh 路径段 ② dsh 部署环境 —— 没有这个环境了」。实测依据：~/.dsh/skills/ 不存在、~/.dsh/mcn-plugin.db 不存在、~/.dsh 下仅剩 profiles/、D:\dshworkspace 整个目录不存在。
• 判据 v3（一步 · 仓库特征判定）：删除 .dsh 路径段判定步骤，仅保留 git -C {技能目录} rev-parse --show-toplevel 返回仓库根 = ①开发机、失败 = ②用户环境（无 git 兜底向上找 .git）。环境模型由三环境精简为两环境。
• 产出结果不变：两环境（开发机/用户环境）产出本就同构（桌面 MCNSkill项目/），仅判定依据简化。
• 改动范围：
  • 判定层：V1.0/references-add/路径配置.md、Lite1.0/references-add/路径配置.md、subskills/mcn-dou-analysis/references/路径配置.md、subskills/mcn-video-prompt/references-add/路径配置.md（判定表/执行规则/解析规则/变更记录，v3）
  • SKILL 层：V1.0/SKILL.md（榜单读取 71/78、外部技能依赖 dsh 副本删除、产出路径表述）、Lite1.0/SKILL.md、subskills/mcn-dou-analysis/SKILL.md（42/44/51/52/58/59/82/95 行）、subskills/mcn-video-prompt/SKILL.md（502/505/531-539）、subskills/mcn-data-insight/SKILL.md（90-96/116 行）
  • 标准库：5 份 references/规则/路径引用规范.md（「三种机器」→「两种机器」）、references/创作流程规范.md、references/创作流程/{11_脚本检查和诊断,4_账号设定解析和确认}.md、references/接口调用/{MCP_工具调用规范,自动化任务清理规范}.md
  • 数据源层：subskills/mcn-data-insight/scripts/fetch_week_ranks.py（删 .dsh 分支代码）、mcn-work-shop/dsh-data.js（删 isDshDeploy 分支 + 注释）、mcn-work-shop/public/data-pages.js（SKILL_HINT_RANKING + 写库注释）、subskills/mcn-data-insight/subskills/{douyin-rise-ranking,douyin-weekly-surge,douyin-content-surge,douyin-daily-hot}/SKILL.md、references/规则/抖音数据规则.md
  • 账号分析层：references/账号数据分析方法.md、references/feature/{01_获取账号信息,03_提炼账号设定,04_分析视频数据,06_生成账号设定卡片}.md、references/铁律避坑规则/账号信息获取执行避坑.md（删「dsh 原库」）、references/浏览器搜索抖音账号操作规范.md（159/175 行 browser-harness dsh 部署环境）
  • README：references-add/README.md（两处）、subskills/mcn-dou-analysis/references-add/README.md、subskills/mcn-video-prompt/references-add/README.md、subskills/mcn-video-prompt/references/README.md
• 残留核对：全树扫描 .dsh/dshworkspace/dsh 部署/dsh 环境/dsh_MCNProject/②dsh/③用户环境——当前有效规则零残留，剩余命中全部为豁免三类：①变更记录/变更日志历史行；②「09-10 起 dsh 环境已废弃」说明文字；③路径引用规范.md 用户级路径示例 {主目录}/.dsh/...（DSH 工具配置目录，非部署环境）。工作台重启验证 HTTP 200，dsh-data.js/fetch_week_ranks.py 语法校验通过。

2026-09-10（路径治本：环境判定锚点重构为「仓库特征判定」+ 全树写死路径清理）

• 触发：仓库本地路径由 D:\AgentSkill\mcn-video-script 迁移至 D:\AI技能\mcn-short-video，D:\AgentSkill 已不存在 → 全部以「本机是否存在 D:\AgentSkill」为锚点的环境判定失效，开发机被误判为「③ 用户环境」（产出落桌面、且误启用 references-add 增量分支）。同时发现技能目录 8 处真实读写路径写死盘符。
• 判据重构（新口径 v2 · 两步）：
  • 第一步：技能路径是否含 .dsh 路径段 → 含 = ② dsh 部署环境
  • 第二步：不含 .dsh 时，git -C {技能目录} rev-parse --show-toplevel 能返回仓库根 = ① 开发机（处于源技能 git 检出内）；命令失败 = ③ 用户环境。无 git 环境兜底：从技能目录向上逐级查找 .git
  • ⚠️ 必须 .dsh 优先判定——~/.dsh 自身也是 git 仓库，先查 .git 会把 dsh 环境误判为开发机
  • 产出根目录三环境结果完全不变，仅判定依据改变
• 改动范围（21 个文件）：
  • 规范层：references/规则/路径引用规范.md（允许项「锚点禁止用写死盘符」+ 禁令项示例 D:\MyRepo + 豁免表）；V1.0/references-add/路径配置.md、Lite1.0/references-add/路径配置.md（判定表/执行规则/解析规则/变更记录）；两份 references-add/README.md
  • 标准库副本（4 份 路径引用规范.md 同步）：subskills/{mcn-data-insight,mcn-dou-analysis,mcn-script-review,mcn-video-prompt}/references/规则/
  • 子技能判定节：subskills/mcn-dou-analysis/{SKILL.md,references/路径配置.md,references-add/README.md}、subskills/mcn-video-prompt/{SKILL.md,references-add/README.md,references-add/路径配置.md,references/README.md}
  • MCP 文档：references/接口调用/MCP_工具调用规范.md、subskills/mcn-dou-analysis/references/接口调用/MCP_工具调用规范.md（开发/非开发环境判定）
  • Lite1.0：SKILL.md 外部技能依赖段落（见下）
• 真实读写路径修复（B 类 8 处）：
  • mcn-work-shop/server.js：新增 BROWSER_LOCK_FILE = path.join(ROOT, '.browser-lock')、SESSION_CWD = ROOT；2 处 const cwd 与 BROWSER_LOCK 改用常量；SESSION_CWD_PATTERN 由 '%mcn-workshop%' 放宽为 '%mcn-work%'（同时兼容历史会话 mcn-workshop 与新建会话 mcn-work-shop，避免 6 小时清理对旧会话失效）
  • mcn-work-shop/build-create-prompts.cjs / submit-review-tasks.cjs：prompt 内 DB 绝对路径 → 改用文件内既有 DB 常量插值
  • V1.0/SKILL.md 第 5 条：文档里的运行时 cwds=["D:\AgentSkill\mcn-workshop"] → 改为 <工作台目录>（由 server.js 从 ROOT 动态推导）
• Lite1.0 外部技能依赖修正（09-02 结构变更补同步）：原段落仍写「三环境两步判定 + D:\AgentSkill\mcn-dou-analysis 外部路径」，既失效又未同步 09-02「mcn-dou-analysis 并入 subskills/」变更。修正为：Lite1.0 目录下无 subskills/（实测），未内置该技能；需要账号解析改用完整版「短视频工作台」V1.0，或先把技能同步进 Lite1.0/subskills/ 后按相对路径 subskills/mcn-dou-analysis/SKILL.md 调用；禁止盘符绝对路径定位。
• BROWSER_LOCK 契约同步：subskills/mcn-dou-analysis/references/浏览器搜索抖音账号操作规范.md 5.6 节锁文件路径由 8 处盘符硬编码 → 改为相对 .browser-lock（工作台触发的会话 cwd 即工作台目录），并注明以工作台注入的绝对路径为准。
• 残留核对：全树扫描 AgentSkill 剩 18 处（含本条目自身 5 处），全部为豁免类别——变更记录/变更日志行 11 处、frontmatter last_change 摘要 1 处、09-04/09-10 修正说明行 2 处、Lite 技能审计报告历史 2 处、路径引用规范修订脚注 1 处、本条目残留核对说明 1 处。当前规则行零残留。mcn-video-script 剩 1 处（变更记录行）、MCNVideo AI 剩 3 处（Lite 审计报告历史）。

2026-09-07（S1/S2 产物文件名改名：01_需求理解 / 02_需求补全）

• 决策：产物文件名 01_需求拆分.md / 02_需求拆解.md（旧步骤名「需求拆分任务规划 / 任务需求拆解完善」残留，两词同音近义、与现行步骤名对不上）→ 改名 01_需求理解.md（S1 产物=五板块状态表）/ 02_需求补全.md（S2 产物=归类+AI 补全）。命名口径：编号承担"属于哪步"（01=S1、02=S2），文件名承担"装了什么"（与 03_对标拆解~11_诊断报告 产物语义名体系一致；不采用对齐步骤名方案，避免与 references/创作流程/1_意图识别.md、2_需求完善.md 撞名）。

• 影响面（V1.0 内 9 处，运行时产物文件无需 mv）：创作流程规范 L49/L68（行文 01需求理解~08广告植入）、L78、落盘表 L426-427、L452（需求拆分/拆解→需求理解/补全）；1_意图识别 L83 User Prompt 引导语「完成需求拆分和任务规划」→「完成需求理解与信息完整度判定」（旧步骤名残留联动清理）；11_脚本检查和诊断 L241-243。

• 写入事故复盘（补入失误记录）：同文件多处 Edit 并行提交发生写竞态——前一个 replace_all 的成果被并发写覆盖丢失（L49/L68/L427 残留），串行补做后零残留。教训：同一文件多处修改必须串行，禁止并行 Edit；改后全量 grep 验证零残留。

• D·视觉脚本 → D·视觉短片（全量）：S9 格式列举（SKILL.md）、S6 内容形式映射表（F04 测评种草/F07 纯视觉短片）、S9 正文 6 处、创作流程规范 3 处、03_框架节奏/07_脚本格式选择指南 8 处——与工作台需求框/用户既定术语对齐，消除「纯视觉短片→D·视觉脚本」混用。

• 预设钩子 → 开场钩子（全量）：S5 选题方案字段（含 10 种开场方式引用）+ S7 大纲回扣语义 + 04_爆款开场/00_口径说明——对外统称「开场钩子」（=S6 场1 段名、工作台需求框 hook 字段同名同义），S5 阶段语义由「预设」改为直接以开场钩子表达。

• 需求框-技能衔接注明（mcn-work-shop/prompts/clarify.md）：内容形式 4 项为粗选方向，落创作时细化为 S6 口径（口播→教程/知识分享/盘点，视觉短片→测评/沉浸式）；故事框架四词（钩子前置/悬念反转/递进铺垫/先抑后扬）=达人倾向词，由 S6 用叙事形态 F01-F08 + 结构模板（三段式/五段式）定型。

• 规则沉淀（09-07）：新增 references/规则/概念分层与源头表述规范.md（先分层再落笔：策略/实现/容器各写源头正文；禁止 X=Y/括注跨文档打补丁，改源头正文；同族术语对外一个总称、改名一次全链路；含开场钩子家族案例）；SKILL.md 红线摘要区新增 🔴 索引行；项目级 技能审计检查清单.md 一致性维新增第 11/12 条（概念分层、源头表述自洽），编号重排 1→15，使用方法补层级先于枚举。

• 开场钩子分层表述源头化（5_选题 / 6_框架 / 04_爆款开场·00_）：三个源头正文自洽——开场方式（04_ 库 10 种标准分类）由 S5 依据用户要求/账号结构性符号/对标拆解(S3)选定并写入选题方案；S6 场次表「本场钩子」=五类留人机制（悬念提问/反差画面/直击痛点/身份共鸣/利益承诺），场1 的本场钩子用于把 S5 已选开场方式实现为镜头与台词。消除 S5「钩子类型」一词双指（表头改「开场方式」、方案字段行改为单一开场方式成分）；不再以对照式/括注维护，概念各归其位。

2026-09-07（S1/S2 五板块归一 + 台词风格降层 + 说话风格词族全链路）

• S1/S2 五维度 → 五板块（顶层集合归一）：1_意图识别 / 2_需求完善 顶层一律为 账号设定 / 选题 / 框架 / 大纲 / 广告Brief（与 S2/S3 板块名、S4 输入引用、下游产物链对齐）；S1 原「人设信息」行改名「账号设定」；「选题信息/框架信息」后缀去除；SKILL.md 步骤1 描述、创作流程规范落盘表说明（五板块状态表 + 02 容器不补全）同步。
• 台词风格顶层维度降层：S1 判定表删顶层「台词风格」行，语气/语速/口头禅/语言禁忌并入 账号设定·说话风格 子项（保留推荐级）；S2 补全策略 D「台词风格补全」并入 A「账号设定补全（含说话风格子层）」，E 重编号为 D；S2 大纲板块明确定位=草稿容器（承接用户已写段落，缺失正常由 S7 生成，不补全、不参与必补判定）。
• 语音层词族全链路统一为「说话风格」（对齐 S4 达人设定⑤说话风格权威字段名）：S3 拆解维度行与对标视频表列、S7 输入/自检 3 处、S8 广告植入 4 处、S9 输入与一致性检查 3 处、S11 检查轴 2 处（台词风格一致性→说话风格一致性）、人设设计参考选项十（台词风格设计用→说话风格设计用）；「语言风格」仅保留于 S4 卡模板内部作 ⑤说话风格 的子成分描述语（2-3 个形容词层），不再作为对外字段名。S1/S2 内与卡内层级词区分：需求层=板块/子项，卡内=达人设定维度①-⑨。
• S2 大纲板块下游断链修复：7_生成短视频大纲 输入段补「步骤2大纲草稿容器→大纲生成起点和约束」承接句式（对齐 S5/S6 既有模式）。
• 顺带修正：创作流程规范落盘表 05 行「钩子预设」→「开场钩子」（此前改名漏网变体）。

2026-09-07（S5↔S4 字段漂移修复：账号定位补「核心价值类型」7 字段）

• 根因：S4 账号定位重构为 6 字段时漏掉旧模板「②核心价值类型」字段，S5 约束提取仍按旧编号引用（维度①赛道/受众/差异化、维度②核心价值类型）——核心价值实为 S5 选题生成锚点（L304 推导依据）+ 选题方案必填输出字段（core_value_type），非可删引用。
• 修复（用户选方案 1 补字段）：S4 账号定位 6→7 字段（赛道定位后插入「核心价值类型：知识/情感/实用/娱乐/观点 选 1，细化参考 人设设计参考选项.md 五、主导价值」；确认清单①、输出模板表、P0 输入约束承接规则同步补行）；S5 约束提取 4 行去旧编号改指 S4 现行字段名 + 老卡缺字段兜底（由赛道定位+内容打法推导并回填）；参考选项五标注改「账号定位·核心价值类型」；SKILL.md 步骤 4 输出描述同步 7 字段。
• 影响面：仅技能层 4 文件；工作台账号设定为自由 md 无固定字段表单，不受影响；存量人设卡片零迁移（S5 读取兜底）。

2026-09-07（B项收尾：落盘表说明列修正 + 人设设计参考选项对齐 S4 卡模板 + dsh 副本废弃）

• 创作流程规范落盘表 04 行说明列修正：「账号设定 + 人设卡片」→「账号设定 + 达人设定」（04_人设卡片.md 内容 = S4 产出的账号设定+达人设定两个板块，原说明列自指文件名系笔误）。
• 人设设计参考选项.md 编号体系对齐 S4 人设卡片：删除全文旧版「达人维度③/④/⑥/⑧」「账号维度②」编号（源自旧 9 维模板，与 S4 现行「达人设定 6 章节：身份人设/性格人设/外在特质/价值观与底线/说话风格/行为决策 + 账号定位 6 字段」不同源，实锤错位）；各章标注改为指向 S4 现行字段（核心性格/气质/小瑕疵/情绪倾向→性格人设，三观→价值观与底线，语态细节→说话风格，专属符号→外在特质·记忆符号，传递感觉→账号定位·差异化定位，主导价值→账号定位·核心价值类型）；文件头用途行新增章节归属说明。dou-analysis 子技能知识库副本同文件同步（台词风格设计用→说话风格设计用）。
• 决策记录：dsh 技能副本项目经确认不存在，同步策略更新为「只改 V1.0 源；Lite1.0 默认不动、术语同步由用户手动发起」。

2026-09-04（R73/R74 技能树体量优化）

主 SKILL.md 压缩维护：frontmatter last_change 明细迁移至本文件（历史归档）；11 步流程 ASCII 总览图压缩为行式 Gate 链（S1→[G0]→…→[G6]）；文件底部新增「阅读分层」说明（🔑 导航行/🚫 红线/无标记正文三类）。

2026-09-04（子技能索引登记 + 外部依赖路径修正）

• 新增「子技能索引（subskills/）」章节：subskills 下 6 个子技能全部登记入主 SKILL.md（browser-harness/lieflat-charts/mcn-data-insight/mcn-dou-analysis/mcn-script-review/mcn-video-prompt），引用一律相对路径 subskills/<目录>/SKILL.md；目录树补 subskills/ 行。
• 修正外部技能依赖段落：mcn-dou-analysis 原「D:\AgentSkill 两步判定」规则废弃（独立仓库不存在，改 subskills/ + dsh 平级 ~/.dsh/skills 双描述）；browser-harness 可执行文件改技能自带 venv 相对路径（原 uv 工具安装已废弃）；lieflat-charts 路径改相对。
• 全文件旧绝对路径引用零残留。

2026-09-03（技能更名 + 触发条件补清理场景）

• 技能更名：短视频脚本创作 → 短视频工作台（用户定，对外统一名称；触发方式与引用结构不变）。
• 触发条件新增 🧹 后台任务清理场景：用户问后台任务/清理过期失败任务时按 references/接口调用/自动化任务清理规范.md 执行——只清过期或错误失败的一次性任务，禁清未来/周期/运行中任务，删除走宿主工具禁直改库。

2026-09-02（工作台 AI 任务契约与执行铁律）

• 工作台新增第 7 条「AI 任务入口技能契约(P0)」：所有 AI 会话任务入口须遵守功能入口×技能调用契约（prompt=技能前缀常量+业务正文+skills 参数级挂载），新增/修改入口前先读 mcn-work-shop/docs/AI会话任务输入输出对照.md（含新增入口检查清单 7 项）——防裸 prompt 跳步/技能声明混入业务串/BROWSER_HINT 误注入；原第 7/8 条顺延为 8/9。
• 工作台任务执行方式铁律固化：创作/改写/复盘必须走 POST /api/run + skills 参数，禁会话内手写草稿。
• 调度机制实测定稿 + 端口 8899→8900。

⚠️ 仅记录 2026-09-02 起的变更明细（本文件创建前，更早历史未归档——如确需追溯请查 git 提交历史）。