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

# MCNVideo AI 项目长期记忆

## 环境判定两步模型 + 三技能统一产出结构（08-26 定稿）
- **两步判定**：①本机无 `D:\AgentSkill`=③用户环境；有→②技能路径在 `D:\AgentSkill\` 下=①开发机（源技能）、含 `.dsh`=②dsh 部署环境。单一 `.dsh` 锚点会把用户环境误判为开发机（P0 已修复）
- **产出落盘**：①③同构=桌面 `MCNSkill项目/{账号名}/`（账号层直挂）；②dsh=`D:\dshworkspace\` 优先。三技能共用账号文件夹（分析产出直挂；脚本=`脚本{编号}\`；分镜=`提示词{编号}\` 继承上游编号）。废弃：`DSHSkill项目\`、`MCNSkill项目/脚本创作/`、`/分镜提示词/` 技能层、旧 dsh 根 `MCNSkillCase/`
- 产出路径唯一权威=`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，**端口=8900，server.js 默认 PORT_BASE，可 argv 指定；8899 为错误旧值勿再引用**）；触发「打开工作台」→ 启动服务+内置浏览器打开。hash 路由：首页+📈账号周榜/👥热门账号/账号详情/视频详情/AI写脚本/AI写作复盘+📁产出浏览+❓帮助页。**首页数据预览条（08-31，参考 dsh-plugin-mcn）**：`/api/dsh/stats` 5 项=热门账号/视频解析/AI写脚本/AI写作复盘/AI写作评分（最新20条AI复盘平均分），7%品牌蓝底+数值26px粗体+右分隔线。**AI 任务触发（08-27 定版；归 mcn-workshop 空间）**：按钮→`confirmRun()`→`executeTask()` `POST /api/run` 写 `~/.workbuddy/workbuddy.db` automations（once+now，cwds=`D:\AgentSkill\mcn-workshop`）→客户端调度器建会话→左侧会话栏可见；轮询 `GET /api/run/status?id=`（running/done/error；PENDING_REVIEW→review「待确认」08-31 加）。**★09-01 调度机制完整结论（详见工作台 `自动化任务调度机制.md`，实测定稿）**：①调度器按 `next_run_at` 扫描，工作台直写必须显式写 next_run_at（08-31 P2 去列判断错误，已纠正为 +5s 显式写）；②scheduled_at 必须未来且留足余量（+60s 稳、+17s 失败——update 有往返延迟）；③客户端后台自动化并发上限≈3，超出 QUEUED 排队（meta.queuedPosition）；④立即执行参数不存在（argv/settings 均无，无 CLI），工作台 +5s 已是最快路径（实际开始 5~35s）；⑤runs 状态机 QUEUED→IN_PROGRESS→ACCEPTED（meta 含 conversationId/sessionId/resultState）；⑥改 server.js 必须重启服务才生效（taskkill /PID 后重启）**。**用户明确不同步 dsh/Lite**（刻意 divergence）。AI脚本选题（08-28）：`/api/ai/topics`（S5方法论→Dify recall 即时返回约50s）；Dify key 内置 `scripts/MCN_CYLG_API.py` 的 `DEFAULT_CYLG_KEY`（env `DIFY_MCN_CYLG_KEY` 优先），`DIFY_URL` 默认 mydify.youmanvideo.com/v1、model 默认 gemini、curl 中文被 CDN 拦推荐 Python、search 易超时用 recall。**AI脚本诊断（08-31）**=#/reviews 复盘页，复盘/对比按钮 prompt 明确「按 mcn-script-review（脚本复盘）技能执行」（评分式复盘+AI脚本vs源脚本对比三段式）
- **抖音账号分析 mcn-dou-analysis（主版本 08-27）**：源=`project/短视频脚本创作/V1.0/subskills/mcn-dou-analysis/`（**09-02 主技能 subskill 目录更名 subskills**）；dsh 副本=`C:\Users\maidou\.dsh\skills\mcn-dou-analysis/`。**六大功能（08-31 加 F6）**：F1账号信息/F2视频列表(13列Excel)/F3提炼账号设定(人设卡12段)/F4分析视频数据/F5解析视频(单视频MCP)/F6生成账号设定卡片（SVG 长图 680×~1716，模板=旧梦留声机样例）。红线：达人账号表15列、TOP6筛选(点赞+分享降序，SKILL.md 权威)、≥60条停止、29赛道枚举、源技能只读单向同步、技能边界(脚本必须切脚本创作技能)、浏览器9223调试实例+标签页复用。**账号数据来源红线（08-31）**：账号表任何字段（含身份标识 sec_uid/抖音号/地址）禁止从数据库回填——工作台库 `hot_accounts` 表=MCP 内部账号库本地副本，读其数据=违反红线；登记只占位 账号ID+昵称，身份标识留空待浏览器回填；MCP 调用严格限定 TC-05。**F6 卡片配色两系（08-31）**：深色系（深沉浓郁调性，如旧梦留声机）=深棕红渐变 #2B0F0A→#1A0805+浅米卡 #FAEEDA+珊瑚红强调；浅色系（明快甜美治愈，如王微斯·玫瑰金定稿）=玫瑰金 #D6A3A9→#9A5563+白卡+粉边 #E8C9DC+深粉字 #7B2D5E+粉强调 #C0457F→#E876A9；背景文字随背景深浅提亮。**调性优先于赛道标签**：明快/欢乐/爽文/暖心→浅色系，深沉/催泪/怀旧/悲情→深色系；「治愈」双义必须回读情绪锚点（俊希=明快欢乐治愈爽文→浅色系暖橙 #F5D0A4→#DE9A5E，非深焦糖）。模块名统一「叙事结构」「内容标签」「内容基因·TOPn（n=实际解析条数，非固定6）」。**F3→F6 自动联动（08-31）**：功能三产出设定后自动生成卡片（删 06 文件即禁用）；设定 md↔卡片 SVG 双向联动维护（改一边另一边同步、术语改名两边一起改，交付前 grep 校验）。**MCP 检测触发时机（08-31）**：账号分析保持「执行工作流前检测」原状；创作技能 V1.0=首次触发必做动作（会话首次交互先查 `myai-mcp-production`，未装轻量提醒可跳过）。**browser-harness 依赖（08-31）**：功能一/二执行前必检（Win `where`/mac `command -v` 或可执行文件存在性），未装提醒+`uv tool install --python 3.12 --upgrade --force browser-harness`+doctor 验三要素。**★产物入库机制（09-01）**：技能产出只落盘文件不入库（dsh 插件导入机制开发机未接通=俊希全0根因）→ 工作台 `POST /api/import/account` 直写 `mcn-plugin.db`（`视频分析/*/analysis.json`→`account_video_analysis`、`content.json`→`account_video_source`、`{昵称}账号设定.md`→`account_persona`、`{昵称}账号数据分析.md`→`account_analysis`、`短视频表格.xlsx`→`account_videos` upsert；xlsx 权威映射=`scripts/export_video_map.py`）；**aweme_id 匹配红线**：标题规范化必删全角标点（xlsx 带「！」「”」而文件夹无，4/6 失败根因）+下划线转空格，幂等删旧保新+清 null 脏数据；**选题 `/api/ai/topics`（08-28）读最新 3 条视频解析 JOIN account_videos 拼 prompt【该账号最近视频解析】=选题真实基于视频内容**
- **短视频分镜脚本** `project/短视频提示词生成/`（08-27 去 V1.0 层）：4功能 F1反推图片/F2反推视频/F3生成图片/F4生成分镜；三层引用架构 references→references-add/（运行时优先；开发机不启用）；知识库15维度；F4输出=主题+导演阐述+代码块（>5s时间戳分段/≤5s单段）；模板分档 A剧情/B单人Vlog/C旁白知识/D产品展示/E纯氛围 +4层×5类型适配表；seedance25 时间测算体系；dsh 副本无独有内容需回流

## 创作技能关键规则（权威源：SKILL.md + references/创作流程规范.md）
1. 三态创作：⚡自动(默认)=静默执行+只落最终交付物；🤝共创=+每确认门询问；🛠️开发=+每步全落盘。7确认门不可合并；角色边界（分析不做创作）
2. 内容总监兜底所有质量检查点；文件 `scripts/{视频标题}/XX_阶段名.md`
3. 人设卡片 `{账号名}人设卡片.md` 账号层共用；内容规则=账号级"如果…则…"事前约束，非事后验收清单
4. 产物链铁律(P0)：`05_故事选题`→`06_短视频框架`→`07_短视频大纲` 顺序产出禁跳步；「产出与传递」永不省略
5. 硬编码禁止(P0)：标准库禁账号名角色名；产出目录全允许
6. references-add 增量优先（冲突以 references-add 为准）；路径配置以 `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交付物正文展开自证；交付物只含输出模板定义字段

## 其他项目
- **AI创作平台toc** `project/AI创作平台toc/case_1/`；**内容创作产品规划** `project/内容创作产品规划/`（短剧知识库五层分类×三层标签×12维度；短视频知识库V2.0 三级分类27赛道×8叙事形态+13维度）；**ljg-skills** `.workbuddy/skills/ljg-skills/`

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

## 工作方式约定
- **治本原则(09-01 用户明确)**：如无明确要求，解决问题一律从根因入手——定位根因→修复机制→**重新执行验证效果**；禁止补数据/临时绕过（补数据仅限用户明确要求时）
- **改完必重开页面(08-28；09-01 强化，用户明确要求记下)**：MCN工作台等网页改动完成后，最后一步必须用 present_files 重新打开对应页面（带 hash 定位）；内置浏览器无刷新按钮、无 CDP 调试端口无法模拟 F5，**用户无法自行刷新，重开页面是唯一刷新方式**——每次改完页面必须主动重开，不能等用户发现看不到效果；静态资源已带 Cache-Control: no-store 防 HTTP 缓存，重开即最新。**★重开 URL 必须带版本参数（09-01 实测定）**：`http://localhost:8900/?v=20260901#/hash`——同 URL 再次打开会被 WorkBuddy 内置浏览器**复用旧标签/缓存不真正重新加载**（实测：Chrome 一个滚动条 vs 内置浏览器仍两个），带 `?v=` 版本参数视为新地址强制全新加载，这是内置浏览器唯一可靠的刷新手段。**排查顺序（09-01 实测定）**：用户反馈「没变化/不一致/没生效」时，**先重开页面（带 ?v=）排除旧 JS/CSS 缓存，再判断是否真需改代码**（「选题/赛道标题大小」=旧 analysisToMd 缓存、「账号定位换行」=旧 CSS、「双层滚动条」=内置浏览器旧标签，均重开即好）
- **逐条修复**：审计修复必须读一条→改一条→验证一条→再进下一条，禁止批量读取
- **技能版本标签(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处环境差异
- **git(09-01 改)**：**2 小时 push 一次**（不要改一点就推；2026-08-31 原定「半天一次」，09-01 用户改为 2 小时）；本地可随时 commit，push 攒到 2 小时统一推；push 前先 fetch 确认无分叉；Windows 下 PowerShell Stop-Process 关后台 node；全局代理 socks5 会破坏 git 连接需清空
- **沙箱代理(09-01)**：Bash 会话环境有 `HTTP_PROXY/HTTPS_PROXY=http://127.0.0.1:7505`（sandbox-cli.exe 监听，WorkBuddy 沙箱注入，非用户系统配置）——**curl 本地 localhost 服务必须加 `--noproxy '*'`**，否则走代理转发失败（502/连接拒绝）；工作台服务用 `node server.js` + Bash run_in_background 启动（`(cmd &)` 子 shell 方式进程会被回收）
- **Chrome 不主动关闭(09-02 用户明确)**：已开启的 Chrome（9223 调试实例/用户手动开启的 Chrome/daemon 连接的实例）一律**不主动关闭**（taskkill/Stop-Process/kill），除非用户明确要求；任务结束/失败都保留——承载登录态/授权记忆/标签页复用，关闭后需重新启动+授权且可能打断用户操作；仅可自行回收「本次任务自己启动的临时实例」；已固化 mcn-dou-analysis `references/浏览器搜索抖音账号操作规范.md` 5.7 与两侧 SKILL.md 红线
- **生成网页必参考设计技能(08-27 强约束)**：先读 `.workbuddy/skills/` 下 taste-skill 与 impeccable 再动手

## 历史事件（摘要）
- 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 格式修正+工作台改写弹窗 UI 迭代；08-31 工作台数据预览条/改名/AI脚本诊断技能关联/俊希全流程TC-01~11/调度器根因确认(scheduledAt须未来时间)