40 lines
11 KiB
Markdown
40 lines
11 KiB
Markdown
# MCNVideo AI 项目长期记忆(09-10 四次压缩;权威源=SKILL.md+references,此处仅索引+红线)
|
||||
|
||||
## ★仓库路径(09-10 迁移)
|
||||
|
|
- **本地路径:`D:\AI技能\mcn-short-video`**(原 `D:\AgentSkill\mcn-video-script`,`D:\AgentSkill` 已不存在);远程 `[email protected]:maogeigei/mcn-short-video.git`
|
|||
|
|
- 技能软链 `C:\Users\maidou\.workbuddy\skills\短视频工作台` = junction → `D:\AI技能\mcn-short-video\project\短视频脚本创作\V1.0`
|
|||
|
|
|
|||
|
|
## 环境判定 + 产出落盘(09-10 判据重构 v2 · 仓库特征判定)
|
|||
|
|
- **两步**:①技能路径含 `.dsh` 路径段 → ②dsh 部署环境;②不含 `.dsh` → `git -C {技能目录} rev-parse --show-toplevel` 返回仓库根 = ①开发机、失败 = ③用户环境(无 git 兜底向上找 `.git`)。**必须 `.dsh` 先判**(`~/.dsh` 自身是 git 仓库)。**锚点禁写死盘符**(原 `D:\AgentSkill` 锚点随仓库迁移失效,曾致开发机误判为用户环境)
|
|||
- 产出:①③=桌面 `MCNSkill项目/{账号名}/`;②dsh=`D:\dshworkspace\`。权威=`references-add/路径配置.md`(运行时优先)
|
||||
|
||||
|
||||
## 核心技能
|
||||
- **短视频工作台**(09-03 由「短视频脚本创作」更名,对外统一名)源=`project/短视频脚本创作/{V1.0,Lite1.0}`(**repo 目录保留旧名**,改的只是注册/显示名);V1.0 name=短视频工作台 含 MCP/Dify,Lite1.0 name=短视频工作台 Lite 去接口。**★软链事实(09-10 更新)**:`C:\Users\maidou\.workbuddy\skills\短视频工作台`=junction→`D:\AI技能\mcn-short-video\project\短视频脚本创作\V1.0\`(09-10 因仓库迁移重建;同一文件 md5 一致,改源即自动同步;**所有 SKILL_HINT_*/skills 参数用新注册名**)。**★09-03 junction 两次失效**:被替换成空目录(11:11,疑似宿主扫描/迁移)致 SKILL_HINT_* 加载失败;征兆=技能加载失败先查此路径 children==0;修法=node `unlinkSync` 删旧链/空目录 → PowerShell `New-Item -ItemType Junction`(目标路径必须已不存在否则 exit 1;junction 不能用 rmdir,报 Not a directory)。**同步策略(09-10 更新)**:只改 V1.0 源;Lite1.0 默认不动,如需同步由用户发起(09-10 用户授权同步了环境判定口径 + dou-analysis 依赖修正);**★Lite1.0 目录下无 `subskills/`(实测)→ 未内置 mcn-dou-analysis**;dsh 技能副本(short-video-script)**项目不存在(09-07 用户确认),已废弃,勿再考虑**。🧹清理自动化按 `references/接口调用/自动化任务清理规范.md`(禁 recurring/未来/running/QUEUED,走宿主软删)
|
||||
|
|
- **MCN工作台(Web 品牌=短视频工作台;09-04 由 R43 曾用名 MCN热点雷达 改回)**(仅 V1.0)`V1.0/mcn-work-shop/`(零依赖 Node,**端口 8900**,argv 可指定;8899 旧值错误)。AI 任务=`POST /api/run` 写 automations(once+显式 next_run_at+5s)→轮询 `/api/run/status`;调度实测=工作台 `自动化任务调度机制.md`(scheduled_at 须 +60s、并发≈3 QUEUED、改 server.js 须重启)。**★创作/改写类 prompt 必须带 SKILL_HINT_CREATE 前缀**(漏=模型跳步直出;新增入口必查)。**★UI 规范文档=`mcn-work-shop/docs/工作台UI规范.md`**(09-10 梳理:设计 token/布局/8 页面路由/12 类组件/9 条已知坑;UI 迭代先查此文件)。关键铁律:`main#view` 高 `calc(100vh-55px)`(写 54 会溢出 1px 触发第二层滚动条)、榜单表格必须 `table-layout:fixed`、榜单三 tab 行高统一(表格 42px/预览 40px)、两套同名 `.tabs/.tab`(数据页下划线式覆盖顶栏胶囊式)、`.modal-mask[hidden]` 须显式 `display:none`、数值列 `tabular-nums`、`.ic` 的 `vertical-align:-0.18em`。AI选题 `/api/ai/topics`(Dify recall~50s;key 内置 `scripts/MCN_CYLG_API.py`;curl 中文被 CDN 拦用 Python)。复盘页 prompt 按 mcn-script-review。UI 改完必重开页面带 `?v=YYYYMMDDx`。**★配置收敛(09-10)**:端口/DB名/产出根/榜单目录单源化到 `mcn-work-shop/config.json`,代码层统一经 `load-config.js`(唯一入口+默认值)读,改设定只改 config.json;前端 data-pages.js 用 `location.origin` 动态取回调地址(前端读不到 server 端 config.json);start.bat 经 `get-port.js` 读端口(`for /f` 内嵌 node -e 会被 cmd 截断,必须走独立脚本);**start.bat 的 managed node 用 `for /d` 遍历 versions 自动探测**(写死版本号会随升级失效)。**坑1**:`.cjs` 的 `require('./x')` 无扩展名会 MODULE_NOT_FOUND → 配置模块须 `.js`。**坑2**:静态资源是根映射 `/data-pages.js`,`/public/xxx` 一律 404-config 读端口。**坑**:`.cjs` 文件 `require('./load-config')` 无扩展名会 MODULE_NOT_FOUND(Node 不把 .cjs 当无扩展 require 目标)→ 配置模块须用 `.js` 扩展名
|
|||
- **mcn-dou-analysis** 源=`V1.0/subskills/mcn-dou-analysis/`、dsh 副本同构。F1信息/F2视频表(13列xlsx)/F3设定/F4分析/F5解析/F6设定卡片SVG。红线:达人表15列、TOP6(点赞+分享降序)、≥60条停、29赛道枚举、浏览器 9223 调试实例+标签页复用、**身份标识禁从 DB 回填**(留空待浏览器回填)、源技能只读单向同步。F6 配色按调性分深浅两系(深=深沉催泪;浅=明快甜美如玫瑰金 #D6A3A9→#9A5563;「治愈」回读情绪锚点)。browser-harness 执行 F1/F2 前必检。**★产物入库(09-01)**:落盘后须 `POST /api/import/account` 直写 mcn-plugin.db(analysis.json→account_video_analysis、content.json→account_video_source、设定/分析 md→account_persona/account_analysis、xlsx→account_videos);aweme_id 匹配删全角标点+下划线转空格、幂等删旧保新;选题读最新 3 条解析拼 prompt
|
||||
- **mcn-data-insight(09-03)**:纯 11 个红狐系数据获取子技能包;`dou-analysis/subskills/nuwa-skill-main/` 是另一账号方法论勿混。**榜单即查即缓存落盘**(红狐计费+同日快照→先 ls 命中免 API);桌面 `MCNSkill项目\三方数据\红狐数据\抖音榜单\`、dsh=`D:\dshworkspace\抖音榜单\`;文件名不加数据源前缀。**★红狐周期规则(09-10 实测,code=3203 原文)**:日榜每日 20:00 后可查昨日、**周榜每周一 20:00 后可查上周**、月榜每月 1 号后可查上月 → 账号周榜(week,`fetch_rank.py`)最新可用期恒为上一周,本周须等下周一 20:00,故"刷新拿最新周期"得到上周**属正常非 bug**。热榜/点赞榜(hot/likes,`fetch_week_ranks.py`)为另一套作品榜 API,**未结束的周也能返回 50 条滚动值**(`--date <本周一>` 可取,明天再取会变);脚本 `last_full_week()` 默认统一回退一期是为与账号榜对齐、避免"同期不同期号",**勿随意改默认**
|
||||
- **短视频分镜脚本** `project/短视频提示词生成/`:F1反推图/F2反推视频/F3生图/F4分镜(>5s 时间戳分段;模板 A剧情/B Vlog/C旁白/D产品/E氛围)
|
||||
|
||||
## 创作红线(权威=SKILL.md+references/创作流程规范.md)
|
||||
|
|
- 三态:⚡自动(默认静默只落最终物)/🤝共创(+确认门)/🛠开发(+全落盘);产物链 05选题→06框架→07大纲 禁跳步;硬编码禁止(P0);references-add 增量优先
|
|||
|
|
- **技能边界**:生成/改写脚本必须切脚本创作技能走 S1-S11(S11 数字账取证/开场钩子绝对时长 3-7s 硬上限 10s/编导终审),禁会话内直写;验收=执行约束非内容,S9/S10 正文禁自证
|
|||
|
|
- MCP:myai-mcp-production(正式)/test;飞书登录每天检查
|
|||
|
||||
## 工作方式红线
|
||||
|
|
- 治本原则:从根因修机制→重执行验证;禁补数据/临时绕过
|
|||
- **★锚点禁写死盘符(09-10)**:环境/路径判定一律用**仓库特征**(`.dsh` 路径段、git 检出),禁用 `D:\AgentSkill` 类盘符地标;「允许项」≠不会坏,仓库/环境迁移时须主动复核豁免写法
|
||||
|
|
- **盘点类任务**:先确认扫描范围无遗漏(09-10 首轮 `skipDirs` 误含 `references` → 漏扫 24 处);下「违规」结论前必先读对应规范文件按规范分类(09-10 曾把 37 处豁免锚点误报为违规)
|
|||
- 改完必重开(`?v=` 防缓存);排查顺序=先重开排除旧缓存再改代码
|
||||
|
|
- 逐条修复:读一条→改一条→验证一条,禁批量读;批量后复查式修复
|
|||
|
|
- git:2h push 一次本地随时 commit;push 前 fetch;代理 socks5://127.0.0.1:10800 破坏连接需清 local proxy;杀 node 用 PowerShell `Stop-Process`;push 后 origin 跟踪引用可能被沙箱吞需重建 refs/remotes;**★`git rm -r` 大范围被 SIGTERM 中断=只删盘不写索引+index.lock**→删 lock+checkout 恢复+纯 `rm -rf`+`git add -A -- 精确路径`
|
|||
|
|
- 同步时清 tmp(mcn-work-shop/tmp/+仓库根 tmp/;**禁清 .workbuddy/tmp/**);先杀自启测试 Chrome 再删
|
|||
- 沙箱代理 HTTP(S)_PROXY=127.0.0.1:7505——curl localhost 必须 `--noproxy '*'`;服务 run_in_background 起
|
||||
- **Chrome 不主动关闭**(9223/用户 Chrome/daemon 连接保留;只回收自启临时实例)
|
||||
|
|
- .dsh 单向只读:禁反向写回(除非用户明确授权)
|
|||
|
|
- 三层沉淀:治本(技能文件)→失误(append 日志)→记忆;日志 append-only;frontmatter updated_at/last_change
|
|||
- **★清理「XX已废弃」类废话的判据(09-10)**:环境/规则废弃后,prompt 与规则正文里"何时废弃、曾有几个分支、路径已不存在"这类历史叙述=噪音→**全删**(执行者只需"现在怎么做");代码注释里的变更动作叙述→删,只留定稿日期;"无 X 分支"这类陈述不存在事物的→删。**保留两类**:①文末「变更记录」历史区/变更日志(append-only 归档);②禁止性护栏(精简为"禁止做什么",去掉日期与下线经过)。例:dsh 环境废弃后清理 16 文件 18 处(注意 `/api/dsh/*` 是工作台 API 命名空间,与 dsh 环境无关,不可动)
|
||||
- 生成网页必先读 taste-skill 与 impeccable
|
||||
|
||||
## 历史事件(摘要)
|
||||
07-17 大炮方法;07-29 短剧库 V5.0;07-30 短视频库 V2.0;08-11/12 素材库扁平化+产物链铁律;08-16 赛道 8→27;08-17 三态创作;08-20 分镜落库;08-21 Lite1.0;08-22 .dsh 只读;08-25 更名 mcn-video-script;08-26 路径重构+两步模型;08-27 dou-analysis+分镜解耦+工作台;08-31 数据预览条/调度器结论;09-01 产物入库+清理规范;09-02 AI创作弹窗 v2-v4+Chrome 不关红线;09-03 data-insight 瘦身、软链事实+junction 二次失效修复+git rm 坑、技能更名「短视频脚本创作→短视频工作台」(repo 路径不变);09-04 主 SKILL.md 子技能索引(6 子技能相对路径)+browser-harness 环境修复+**全量路径审计**:源技能 maidou/MCNVideo AI/废弃目录名(当前规则行)零残留;豁免三类=禁止性规则示例行、变更记录历史行、references-add/路径配置.md;dsh short-video-script SKILL.md 为刻意差异化(324 行无 subskills)不同步;**09-10 仓库迁移至 `D:\AI技能\mcn-short-video`+软链重建+环境判定锚点重构为「仓库特征判定」(21 文件统一口径)+工作台 cwd/BROWSER_LOCK 改 ROOT 动态推导 + `SESSION_CWD_PATTERN` 放宽为 `%mcn-work%` + Lite1.0 dou-analysis 依赖修正(Lite 无 subskills,未内置)+**dsh 部署环境废弃(三环境→两环境,判据 v3 一步 git 检出,20+ 文件去 dsh 分支)+工作台配置收敛(config.json 单源化,端口/DB/目录经 load-config.js 统一读取)**
|