mcn-short-video/.workbuddy/memory/MEMORY.md

# MCNVideo AI 项目长期记忆

## 环境判定两步模型 + 三技能统一产出结构（08-26 定稿）
- **两步判定**：第一步查本机 `D:\AgentSkill` 是否存在——**无=③用户环境**；有→第二步看技能路径——**在 `D:\AgentSkill\` 下=①开发机（源技能）**、**含 `.dsh`=②dsh 部署环境**（如 `C:\Users\maidou\.dsh\skills\`）。单一 `.dsh` 锚点会把用户环境误判为开发机（P0 已修复）
- **产出落盘**：①③同构=**桌面 `MCNSkill项目/{账号名}/`**（账号层直挂，无技能文件夹层）；②dsh=**`D:\dshworkspace\` 主工作区优先**
- **三技能结构**：①③ 三技能共用一个账号文件夹（账号分析产出 `{账号名}账号设定.md`/`账号数据分析.md`/`短视频表格.xlsx`/`视频分析\{标题}_标签1_标签2\` 直挂；脚本=`脚本{编号}\`；分镜=`提示词{编号}\` 继承上游编号）。② dsh 分目录：`创作任务\{账号名}\`（脚本/分镜平级）与 `解析任务\{达人昵称}\` 分开
- **废弃**：`DSHSkill项目\` 根、`MCNSkill项目/脚本创作/`、`/分镜提示词/` 技能层、旧 dsh 根 `MCNSkillCase/`
- 现状：dsh 解析任务已符合定稿；桌面 `MCNSkill项目/账号分析/{小咪橘座,旧梦留声机,王微斯}` 用户选"现有先不动"；账号分析/脚本创作技能配置尚未同步两步判定（待办）
- 产出路径唯一权威=`references-add/路径配置.md`（运行时优先于 SKILL.md）；用户自定义路径 > 默认路径

## 核心技能
- **短视频脚本创作** `project/短视频脚本创作/{V1.0,Lite1.0}/`：11步流程+知识库12分类（66文件）；V1.0 含 MCP/Dify 接口，Lite1.0 去全部接口、模型自带 WebSearch。**同步策略（08-26 用户定）**：只改 V1.0 源技能+dsh 副本两处；Lite1.0 默认不动
- **MCN工作台（08-27，仅 V1.0）** `project/短视频脚本创作/V1.0/mcn-work-shop/`（server.js+public/，零依赖 Node，端口8899自动避让）；触发「打开工作台」→ 启动服务+内置浏览器打开。hash 路由：首页+📈账号周榜/👥热门账号/账号详情/视频详情/AI写脚本/AI写作复盘（读自有 mcn-plugin.db 副本+dshworkspace 榜单 JSON）+📁产出浏览（桌面 MCNSkill项目/ 账号层直挂）+❓帮助页。**首页顶部数据预览条（08-31，参考 dsh-plugin-mcn 首页 stats 移植）**：`/api/dsh/stats` 5 项=热门账号(accounts)/视频解析(analyses)/AI写脚本(rewrites)/AI写作复盘(reviews type='ai')/AI写作评分(writingScore=最新20条AI复盘平均分)，条带=7%品牌蓝底+数值26px粗体+右分隔线（样式在 style.css .home-stats）；**AI 任务触发（08-27 定版；归 mcn-workshop 空间）**：数据页按钮→`confirmRun()` 确认弹窗→`executeTask()` `POST /api/run` 写 `~/.workbuddy/workbuddy.db` automations（once+now，cwds=`D:\AgentSkill\mcn-workshop`）→WorkBuddy 自动执行创建会话→左侧会话栏 mcn-workshop 空间可见；轮询 `GET /api/run/status?id=`（读 automations/automation_runs/automation_runtime_state：running=IN_PROGRESS/running、done=DONE/COMPLETED/SUCCESS、error=ERROR/CANCELLED；5s 间隔 30min 上限）→done/error 恢复按钮（.btn-busy「执行中…」）；**用户明确不同步 dsh/Lite**（刻意 divergence）；AI脚本选题（08-28）：关注账号「创作」→「AI脚本」`confirmAiScript` 选题 textarea→`POST /api/ai/topics`（查库带账号摘要→S5 方法论 prompt→Dify chat-messages recall 即时返回约50s）；Dify key 内置 `scripts/MCN_CYLG_API.py` 的 `DEFAULT_CYLG_KEY`（env `DIFY_MCN_CYLG_KEY` 优先；key=app-0vRaxPhvVOqzFQIa5eFzFdjD），`DIFY_URL` 默认 mydify.youmanvideo.com/v1、model 默认 gemini、curl 中文被 CDN 拦推荐 Python、search 易超时用 recall
- **抖音账号分析 mcn-dou-analysis（主版本 08-27）**：源=`project/短视频脚本创作/V1.0/subskill/mcn-dou-analysis/`；dsh 副本=`C:\Users\maidou\.dsh\skills\mcn-dou-analysis\`；旧路径 `project/短视频账号分析/case_1/` 已废弃。**六大功能（08-31 加 F6）**：F1账号信息/F2视频列表(13列Excel)/F3提炼账号设定(人设卡12段)/F4分析视频数据(逐条→汇总两段式)/F5解析视频(单视频MCP)/**F6生成账号设定卡片**（SVG 长图 680×~1716，模板=旧梦留声机样例）。红线：达人账号表15列(仅用户要求增改)、TOP6筛选(点赞+分享降序，权威参数在SKILL.md)、≥60条停止滚动、29赛道枚举、源技能只读单向同步、技能边界(脚本必须切脚本创作技能)、浏览器9223调试实例+标签页复用。**F6 卡片配色分两系（08-31 定型）**：**深色系（深色长图风，深沉/浓郁调性，如旧梦留声机）**=深棕红渐变底 #2B0F0A→#1A0805 + 浅米卡 #FAEEDA + 深色字 + 珊瑚红强调；**浅色系（浅色甜宠风，明快/甜美/治愈调性，如王微斯·定稿玫瑰金）**=玫瑰金渐变底 #D6A3A9→#9A5563 + 白卡 #FFFFFF + 粉边 #E8C9DC + 深粉字 #7B2D5E + 粉强调 #C0457F→#E876A9；背景上直接书写的文字随背景深浅提亮（玫瑰金底：模块标题 #FDE8EC/注释 #EAC6CE/版权 #DDBCC4）；更浅可回退浅粉紫 #F8EDF6→#F1E0EE；底色决定色系，**同一账号必须固定色系**，跨账号可不同；禁跨系混用。模块名统一为「叙事结构」「内容标签」「**内容基因·TOPn（n=实际解析条数，几个视频就是TOP几，如王微斯4条→TOP4；不足6条按实际条数，非固定6）**」。**F6 触发场景处理（07情况表+三问判定链）在 06 文档。**MCP 安装检测触发时机（08-31 定稿）：**账号分析保持「执行工作流前（视频解析前）检测」原状**（不随创作技能扩）；**创作技能 V1.0 = 首次触发必做动作**——会话首次交互（问功能/发起任务无论问什么）先检查 `myai-mcp-production` 可用性（查可用工具列表或读 `~/.workbuddy/mcp.json`），未安装轻量提醒（可跳过不打断创作）；规则落点=SKILL.md MCP 依赖章节安装引导行 + MCP 规范 3 节触发时机/检测方法 + 帮助文档 MCP 服务说明。**browser-harness 依赖检测（08-31 加）**：功能一/二（浏览器抓取）执行前必检——检测可执行文件（Windows `~/.local/bin/browser-harness.exe` / macOS/Linux `~/.local/bin/browser-harness`）或命令探测（Windows `where` / macOS `command -v`）→ 未装提醒（可跳过，换三方API/MCP兜底）→ 同意则 `uv tool install --python 3.12 --upgrade --force browser-harness` → `browser-harness doctor` 验三要素（工具/daemon/Chrome）；技能体 `~/.dsh/skills/browser-harness/` 随 dsh_MCNProject 分发。规则落点=SKILL.md 红线行「browser-harness 依赖」+ 浏览器规范 5.0（检测/安装）。**环境检查系统分流（08-31 用户要求）**：browser-harness 代理清理（Win PowerShell Remove-Item / mac unset）、Chrome 启动（Win `chrome.exe` / mac `/Applications/Google Chrome.app/...`）、端口探测（Win Invoke-WebRequest / mac curl）、MCP mcp.json 路径（Win `%USERPROFILE%\.workbuddy\mcp.json` / mac `~/.workbuddy/mcp.json`）、npm 缓存权限检查仅 macOS 高发（Windows 跳过）。**功能三→功能六自动联动（08-31 固化）**：功能三产出 `{账号名}账号设定.md` 后**自动生成设定卡**（无需用户开口，删除 06 文件即禁用自动）；**设定 md ↔ 卡片 SVG 双向联动维护**——改设定→卡片同步（内容级重生成/单点改 SVG）、改卡片→设定同步、术语改名→两边一起改（历史案例：内容路线→叙事结构、核心气质→内容标签），交付前 grep 校验关键术语两文件一致；规则固化于 SKILL.md（功能三 Step7/功能六自动触发）+ 03 文档 Step7 + 06 文档触发场景/双向联动维护
- **短视频分镜脚本** `project/短视频提示词生成/`（08-27 去 V1.0 层）：4功能 F1反推图片/F2反推视频/F3生成图片/F4生成分镜；三层引用架构 参考skills→references/→references-add/（运行时优先；开发机不启用 references-add/，dsh/用户环境启用）；知识库15维度（01-12用户+13音效+14构图+15风格）；F4输出=主题+导演阐述+代码块（>5s时间戳分段/≤5s单段）；提示词模板类型分档（A剧情/B单人Vlog/C旁白知识/D产品展示/E纯氛围）+4层×5类型适配表；公式只留时间预算表等内部环节，提示词正文只写时长结论；seedance25 时间测算体系（语速6公式+动作14+运镜7+帧级换算+超调6级）；dsh 副本无独有内容需回流（唯一独有项 `name: storyboard-prompt` 环境保留）

## 创作技能关键规则（权威源：SKILL.md 关键规则 + references/创作流程规范.md）
1. 三态创作：⚡自动(默认)=静默执行+只落最终交付物；🤝共创=+每确认门询问；🛠️开发=+每步全落盘。7确认门不可合并；角色边界（分析不做创作）
2. 内容总监兜底所有质量检查点；文件 `scripts/{视频标题}/XX_阶段名.md`
3. 人设卡片 `{账号名}人设卡片.md` 账号层共用（dsh=`D:\dshworkspace\创作任务\{账号名}/`，①③=桌面 `MCNSkill项目/{账号名}/`）；模板=账号设定(定位6字段+内容怎么做5章节)+达人设定6章节+账号类型三分类+广告植入偏好(可选)；**内容规则=账号级"如果…则…"事前约束，非事后验收清单**
4. 产物链铁律(P0)：`05_故事选题`→`06_短视频框架`→`07_短视频大纲` 顺序产出禁跳步；「产出与传递」永不省略
5. 硬编码禁止(P0)：标准库禁账号名角色名；产出目录全允许
6. references-add 增量优先（冲突以 references-add 为准，references/ 加⚠️）；路径配置以 `references-add/路径配置.md` 为权威
7. 三层分离：S6情绪规划→S7结构搭建→S9情绪演绎；S6情绪设计卡集中完成，S7只引用；S9分行切镜；闪回≤2次/条；花字/字幕每场≤2条
8. 叙事驱动4类：事件/对白/旁白/混合；剧情类禁旁白驱动；S6必须明确选择
9. 情感铺垫分级：强=剧情类(四功能位+蓄力释放+七问自检)；中=Vlog/探店；弱=知识/美妆/吃播/三农/户外
10. 广告植入：`知识库/11_广告植入/广告植入方法论.md` L1-L4四级20小节；`L#-#`命名与S8字面匹配；L4评估归S11
11. MCP：myai-mcp-production(正式)/myai-mcp-test(测试)，10工具；首次提问检测提醒安装；飞书登录每天检查
12. 分镜只能从S9生成，可选步骤🔶，默认流程结束于S9
13. 知识库09_脚本诊断=三件套(AI检查+人工检查+自动清单八类32项)；12_爆款拆解=反推复刻方法论；知识库总数65个
14. 技能边界(08-26 固化三副本)：分析技能止步于五类账号分析侧交付物；凡生成/改写脚本必须切换脚本创作技能走S1-S11（含S11数字账取证/开场钩子铁律/编导终审验收），禁止会话内直接手写脚本。开场钩子=绝对时长3-7秒硬上限10秒，不看占比；数值校验必须取证列链、禁心算
15. 交付物输出边界(08-26 固化三副本)：**验收口径=执行约束，不是输出内容**——铁律/时长占比/数字账取证禁在S9/S10交付物正文展开自证（禁秒级节拍分段/生成链路块/映射表/S11诊断记录）；交付物只含输出模板定义字段；固化于 `创作流程规范.md`「交付物输出边界」+`9_生成短视频脚本.md`输出模板「输出边界」块

## 其他项目
- **AI创作平台toc** `project/AI创作平台toc/case_1/`：ToC 个人创作者，输入→分析→脚本3版本→对话修改
- **内容创作产品规划** `project/内容创作产品规划/`：短剧知识库五层分类×三层标签×12维度；短视频知识库V2.0 三级分类(27赛道S01-S27×8叙事形态F01-F08)+13维度+极致事件双重类型
- **ljg-skills** `.workbuddy/skills/ljg-skills/`：ljg-is/think/rank/structure + ljg-mcn(6种共鸣类型+具象场景+细微情绪=强共鸣，禁下钻神经科学)

## 分析方法论
- **跨技能借鉴/同步判断**：两步独立判断——①数据流验证(信息从哪来→落到哪→下游谁读，断点=缺口)②字段形态决策(直接搬/改造/承接)；禁止用②覆盖①；先画数据流再定形态
- **信息链路缺口识别**：Step 有方法论≠Step 能承接账号级信息；通用方法论管"怎么做"，账号级信息管"怎么做才像它"，不可互替

## 工作方式约定
- **改完必重开页面(08-28 用户强调)**：MCN工作台等网页改动完成后，最后一步必须用 present_files 重新打开对应页面（带 hash 定位，如 `http://localhost:8899/#/rewrites`）；内置浏览器无 CDP 调试端口无法模拟 F5，重开页面是唯一刷新方式
- **逐条修复**：审计修复必须读一条→改一条→验证一条→再进下一条，禁止批量读取
- **技能版本标签(08-26)**：frontmatter 存 `updated_at`+`last_change`+`deployment`；源=`source`+`created_at`+`updated_at`，副本=`dsh`+`updated_at`+`deployed_at`；副本 deployed_at<源updated_at=滞后
- **.dsh 单向只读(08-22 强约束)**：`.dsh` 副本只能「读取→回流源技能」，禁止反向写回（除非用户明确授权）；允许1处环境差异
- **dsh 差异方向判定(08-26)**：以「08-22 回流后 V1.0=.dsh 完全一致」为基准线+当日日志字面描述判定，不靠内容新旧直觉
- **生成网页必参考设计技能(08-27 强约束)**：先读 `.workbuddy/skills/` 下 taste-skill（Anti-Slop，适用于 landing/作品集，不适用 dashboard）与 impeccable（完整界面设计/评审工程，dashboard/product UI 主参考其 Operate 模式）再动手

## 历史事件（摘要）
- 06-25 营销号风格清理；07-17 大炮创作方法136文件；07-20 知识库重组；07-29 短剧知识库V5.0；07-30 短视频知识库V2.0
- 08-11→12 素材库扁平化(8类型+四维标签)+去硬编码(30处)+产物链铁律；08-12 人设卡片V2.1；08-16 知识库赛道8→27；08-17 三态创作模式定稿；08-20 分镜标准库落库+seedance25提炼；08-21 Lite1.0 新增；08-22 .dsh 单向只读确立；08-25 仓库更名 mcn-video-script
- 08-26 路径重构+环境判定两步模型+三技能统一产出结构定稿；08-27 mcn-dou-analysis 定主版本、短视频提示词生成去 V1.0 层、工作台新增；08-28 S9 格式修正（A格式独立动作叙述去括号）+ 工作台改写弹窗 UI 迭代