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

MCNVideo AI 项目长期记忆（09-03 压缩整理）

环境判定两步模型 + 产出落盘（08-26 定稿）

• 两步判定：①本机无 D:\AgentSkill=③用户环境；有→②技能路径在 D:\AgentSkill\ 下=①开发机（源技能）、含 .dsh=②dsh 环境。单一 .dsh 锚点会把用户环境误判为开发机（P0 已修）
• 产出落盘：①③=桌面 MCNSkill项目/{账号名}/；②dsh=D:\dshworkspace\ 优先。三技能共用账号文件夹。权威=references-add/路径配置.md（运行时优先于 SKILL.md）

核心技能

• 短视频脚本创作 project/短视频脚本创作/{V1.0,Lite1.0}：11 步流程+知识库；V1.0 含接口、Lite1.0 去接口模型自带 WebSearch。★软链事实（09-03 实测）：C:\Users\maidou\.workbuddy\skills\短视频脚本创作 → 软链 /d/AgentSkill/mcn-video-script/project/短视频脚本创作/V1.0（同一文件）——改源即改 WorkBuddy 技能无需单独同步；dsh 副本 C:\Users\maidou\.dsh\skills\short-video-script\ 是唯一需手动同步的独立副本。同步策略（08-26 用户定）：只改 V1.0 源+dsh 副本；Lite1.0 默认不动（用户刻意 divergence）。🧹后台任务清理：触发「后台执行什么/清空没用的任务」→ 按 references/接口调用/自动化任务清理规范.md 执行；红线=只清过期/错误失败 once（ACCEPTED 或 PENDING_REVIEW/result_success=0/last_error/从未运行），禁清 recurring/未来/running/QUEUED；删除走宿主 automation_update 软删置 deleted_at，禁 SQL 直改库
• MCN工作台（仅 V1.0）V1.0/mcn-work-shop/（server.js+public，零依赖 Node，端口 8900，argv 可指定；8899 为错误旧值勿引用）。触发「打开工作台」→启动服务+内置浏览器。AI 任务触发：POST /api/run 写 ~/.workbuddy/workbuddy.db automations（once+now，cwds=D:\AgentSkill\mcn-workshop）→客户端调度器建会话；轮询 GET /api/run/status?id=。★调度机制实测定稿（详见工作台 自动化任务调度机制.md）：显式写 next_run_at(+5s)、scheduled_at 须留 +60s 余量（+17s 失败）、并发上限≈3 超出 QUEUED、runs 状态机 QUEUED→IN_PROGRESS→ACCEPTED、改 server.js 必须重启进程才生效。★创作任务 prompt 必须带 SKILL_HINT_CREATE 前缀（data-pages.js L386 弹窗/L711/L920 详情页改写；根因=漏前缀致模型跳步一步直出成品）——新增创作/改写入口必须检查。AI脚本选题 /api/ai/topics（Dify recall ~50s；key 内置 scripts/MCN_CYLG_API.py DEFAULT_CYLG_KEY，env DIFY_MCN_CYLG_KEY 优先；curl 中文被 CDN 拦用 Python；search 易超时用 recall）。AI脚本诊断=#/reviews 复盘页（prompt 明确「按 mcn-script-review 执行」）
• mcn-dou-analysis 源=V1.0/subskills/mcn-dou-analysis/，dsh=C:\Users\maidou\.dsh\skills\mcn-dou-analysis/。F1账号信息/F2视频列表/F3账号设定(人设卡)/F4分析数据/F5解析单视频/F6账号设定卡片(SVG 长图)。红线：达人表15列、TOP6筛选(点赞+分享降序)、≥60条停止、29赛道枚举、浏览器 9223 调试实例+标签页复用、账号表禁从 DB 回填（工作台 hot_accounts=MCP 内部库副本；身份标识留空待浏览器回填）、源技能只读单向同步、脚本必须切脚本创作技能。F6 配色两系（深色系深沉调性/浅色系明快甜美，如玫瑰金 #D6A3A9→#9A5563），调性优先于赛道标签，「治愈」双义须回读情绪锚点（俊希=浅色系暖橙非深焦糖）；模块名统一「叙事结构」「内容标签」「内容基因·TOPn(n=实际条数)」；F3→F6 自动联动（删 06 文件禁用；md↔SVG 双向维护，交付前 grep 校验）。browser-harness：功能一/二执行前必检，未装→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；映射=scripts/export_video_map.py）；aweme_id 匹配必删全角标点+下划线转空格，幂等删旧保新+清 null。选题 /api/ai/topics 读最新 3 条视频解析 JOIN account_videos 拼 prompt
• mcn-data-insight（抖音数据获取技能集，09-03 定稿）：源=V1.0/subskills/mcn-data-insight/+dsh=C:\Users\maidou\.dsh\skills\mcn-data-insight/（09-03 部署 diff=0）。纯 11 个红狐系数据获取子技能（account-diagnosis/daily-hot/hot-trend/works-crawler/ai-feed/prohibited-word/content-surge/weekly-surge/search/top-account/playlet-douyin-feed），非数据获取技能不再放此包（nuwa-skill 已删、multi-copywrite-alchemy 移至桌面）；无 .workbuddy。注意 mcn-dou-analysis/subskills/nuwa-skill-main/ 是另一份账号分析方法论组件（保留勿混）。原 D:\AgentSkill\mcn-data-insight 源已剩 SKILL.md+references 壳。★榜单查询「即查即缓存」落盘（09-03 定稿，commit 4c18e7e）：红狐 API 按调用计费+榜单=同日期固定快照→强制落盘免重复花钱；桌面 MCNSkill项目\ 顶层分业务账号/三方数据，三方数据统一 三方数据\{数据源}\（当前=红狐数据 → 三方数据\红狐数据\抖音榜单\，后续每数据源一文件夹），文件名不加数据源前缀（保 抖音周榜_ 开头兼容 dsh RANKING_DIR 正则）；②dsh=D:\dshworkspace\抖音榜单\；查询前先 ls 命中免 API（同榜名+赛道+数据日期全机器仅 1 次 API 调用）；固化于主 SKILL.md「榜单数据落盘规范」+抖音数据规则 §2.1/2.2/2.4+三榜单子技能
• 短视频分镜脚本 project/短视频提示词生成/（去 V1.0 层）：F1反推图/F2反推视频/F3生图/F4生成分镜；三层引用 references→references-add（运行时优先）；F4 输出=主题+导演阐述+代码块（>5s 时间戳分段/≤5s 单段）；模板分档 A剧情/B Vlog/C旁白/D产品/E氛围 +4层×5类型；dsh 副本无独有内容需回流

AI创作弹窗 v2-v4（09-02 定稿；实现=data-pages.js + server.js + tmp/cdp-req-dialog-smoke.mjs）

• 单弹窗 confirmAiScript：REQ_FIELDS 10 项(idea/form/dur/mood/aud/plot/end/sym/ad/note)需求框常显+对话流+胶囊输入行；后端 /api/ai/clarify（同步 Dify chat-messages 100s；{accountName,turn,reqMd,history}→{answer}；强制「对话+==REQ==+10行需求」；query=人设摘要+reqMd+最近2轮+本轮）；AI 禁生成脚本正文
• v4 附件：/api/req/parse-attachment + scripts/attachment-parser.js（零依赖 node:zlib 解 .docx/.pdf，.doc 400）；提交拼【附件素材】段
• CDP 冒烟坑（9224）：同 URL navigate 不 reload→?v=Date.now() 强制；DOM 句柄跨连接失效→Runtime.evaluate+requestNode；setFileInputFiles 抛错→Uint8Array+DataTransfer 注入；单条持久 WebSocket 必需（新连接=新 session 句柄全失效）

创作技能关键规则（权威源=SKILL.md+references/创作流程规范.md）

• 三态创作：⚡自动(默认静默只落最终交付物)/🤝共创(+确认门)/🛠开发(+全落盘)；产物链铁律 05选题→06框架→07大纲 顺序禁跳步、「产出与传递」永不省略；硬编码禁止(P0)；references-add 增量优先；技能边界=凡生成/改写脚本必须切脚本创作技能走 S1-S11（含 S11 数字账取证/开场钩子铁律=绝对时长3-7s硬上限10s不看占比/编导终审），禁会话内直写脚本
• 交付物输出边界：验收口径=执行约束非输出内容，铁律/时长占比禁在 S9/S10 正文自证
• MCP：myai-mcp-production(正式)/myai-mcp-test；首次提问检测提醒安装；飞书登录每天检查

工作方式约定（红线）

• 治本原则（09-01 用户明确）：解决问题从根因入手→修机制→重新执行验证；禁补数据/临时绕过
• 改完必重开页面：网页改动完成最后一步必须 present_files 重开，URL 必带 ?v= 版本参数（内置浏览器同 URL 复用旧标签不真加载；重开是唯一刷新方式）。排查顺序=先重开(?v=)排除旧缓存再改代码
• 逐条修复：读一条→改一条→验证一条，禁批量读全部文件（上下文压缩丢质量）；复查式修复：批量后多次「再检查之前要求」
• git：2 小时 push 一次，本地随时 commit；push 前 fetch 查分叉；代理 socks5://127.0.0.1:10800 破坏连接需清空（local http/https proxy ""）；杀 node 用 PowerShell Stop-Process -Id X -Force（Git Bash taskkill //PID 无效）；push 后 origin 跟踪引用可能被沙箱吞需重建 refs/remotes
• 同步时清 tmp（mcn-work-shop/tmp/ + 仓库根 tmp/，已 gitignore；禁清 .workbuddy/tmp/）；先杀自己启动的测试 Chrome（netstat+taskkill /T /F）再删
• 沙箱代理：HTTP(S)_PROXY=127.0.0.1:7505（沙箱注入非用户配置）——curl localhost 必须 --noproxy '*'；服务用 run_in_background 起，禁 (cmd &) 子 shell
• Chrome 不主动关闭（9223 调试实例/用户 Chrome/daemon 连接一律保留，除非用户明确要求；只回收自己启动的临时实例）——固化于 mcn-dou-analysis references/浏览器搜索抖音账号操作规范.md 5.7
• .dsh 单向只读：副本只能读取→回流源技能，禁反向写回（除非用户明确授权）
• 生成网页必先读 taste-skill 与 impeccable（08-27 强约束）
• 技能版本标签：frontmatter updated_at/last_change；dsh 副本 deployed_at<源 updated_at=滞后
• ★git rm 沙箱坑（09-03，2 次踩）：git rm -r 删大范围文件被 SIGTERM 中断=只删磁盘不写索引（全变 D 未暂存）+留 index.lock+范围失控半删除。修法：rm -f .git/index.lock → git checkout HEAD -- <路径> 恢复 → 纯 rm -rf 删磁盘 + git add -A -- <精确路径> 暂存（不经 git rm）
• 三层化沉淀：治本（改技能文件固化）→失误（append 日志）→记忆（MEMORY.md）；偏好 append-only 日志不改写历史

历史事件（摘要）

• 07-17 大炮创作方法；07-20 知识库重组；07-29 短剧知识库 V5.0；07-30 短视频知识库 V2.0
• 08-11/12 素材库扁平化(8类型)+去硬编码+产物链铁律；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 dou-analysis 主版+分镜技能解耦+工作台；08-31 数据预览条/AI脚本诊断/调度器根因(scheduledAt 须未来)；09-01 产物入库机制+自动化清理规范；09-02 工作台 AI创作弹窗 v2-v4+Chrome 不关红线；09-03 全树相对路径审计+路径引用规范.md 固化、mcn-data-insight 瘦身定稿（纯 11 数据技能）+dsh 部署、符号链接事实实测