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/subskill/mcn-dou-analysis/；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 连接需清空
• 生成网页必参考设计技能(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须未来时间)