Files
mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-dou-analysis/references-add/README.md
T
maogeigei c48902f063 09-10 工作台:配置收敛、复盘字段契约修复、原创选题分镜支持、榜单期号区间显示
配置收敛:
- 端口/DB名/产出根/榜单目录单源化到 mcn-work-shop/config.json,代码层统一经 load-config.js 读取
- 新增 get-port.js 供 start.bat 读端口(bat 内嵌 node -e 会被 cmd 截断,读到的是兜底值)
- start.bat 修复失效的 managed node 路径(原写死 22.22.2 已不存在),改为遍历 versions 自动探测

复盘诊断页(真 bug 修复):
- 问题清单严重度全部显示成绿色 + 修改建议不显示:模型输出 {sev:'high',fix} 与前端读取 {severity:'高',suggestion} 字段名与取值均不匹配
- 前端新增 normIssue 归一化,兼容 sev/severity/level 与中英取值,并回补所属维度显示
- 在 submit-review-tasks 与诊断/复盘 prompt 中固化 issues_json 字段契约,从源头防 schema 漂移

分镜提示词:
- 原创选题(video_id 为空)原本无生成入口(分镜按 video_id 查询)
- listStoryboards 支持按 rewrite_id 查询,前端放开入口、切版本重查,并补落库指令(此前入库靠模型自由发挥)

榜单展示:
- 期号改为显示区间「08/31 ~ 09/06」,避免被误读为单日(期号=该周周一)
- 后端新增 collectRanges,从落盘文件读真实 dateStart/dateEnd 随 API 返回(日榜 start=end 不显区间)

其他:
- 清理 dsh 环境废弃后的历史叙述类废话(16 文件约 18 处),文末变更记录区保留
- 新增 docs/工作台UI规范.md(设计 token / 布局 / 8 页面路由 / 12 类组件 / 9 条已知坑)
2026-09-10 18:28:42 +08:00

5.2 KiB
Raw Blame History

references-add(增量库)—— 机制说明

两环境判定(一步判定 · 仓库特征判定,与 SKILL.md 一致):判断技能是否处于源技能 git 检出内(git -C {技能目录} rev-parse --show-toplevel 返回仓库根)——在 = ① 开发机(源技能)、不在 = ② 用户环境(技能无论装在哪、什么路径)。

references-add 机制只服务 ② 用户环境:① 开发机标准库 references/ 可正常修改(新增内容直接并入标准库对应位置),本目录可仅保留本说明(机制文档);② 用户环境部署后标准库 references/ 永远不变,新增/修改内容统一写入本目录。

用途

当本技能(MCNDouAnalysis)被部署到② 用户环境(技能不在任何 git 检出内)时,本技能的标准库 references/(含自有知识库 知识库/账号设定/ + 知识库/视频拆解/)在部署后永远不变。用户在使用过程中新增/修改的流程、方法论、分析方式、铁律等内容,统一整理到本文件夹。

核心原则

目录 定位 内容来源 修改策略
references/ 原始标准库(内置) 开发时固化(含从源技能按两步法重组的账号设定知识库 + 视频拆解知识库) 部署后永远不变
references-add/ 动态增量库 ② 用户环境中用户对话中积累 随使用持续增长

目录结构

references-add/                 ← 增量库(与标准库 references/ 结构镜像对齐)
├── README.md              ← 本说明(机制文档)
├── 路径配置.md            ← 🔴 产出路径唯一权威配置(用户自定义路径在此记录)
├── feature/               ← 功能级增量(对应标准库 references/feature/,删除即禁用该功能)
│   ├── 01_获取账号信息.md ← 功能一增量
│   ├── 02_获取视频.md     ← 功能二增量
│   ├── 03_提炼账号设定.md ← 功能三增量
│   └── 04_分析视频数据.md ← 功能四增量
├── 知识库/                ← 方法论增量(对应标准库 references/知识库/,含「账号设定」「视频拆解」两个分类)
│   ├── 账号设定/          ← 生成设定(功能三)方法论增量
│   └── 视频拆解/          ← 账号数据分析(功能四)拆解知识库增量
└── 铁律避坑规则/          ← 铁律和避坑(含 账号数据分析执行避坑.md)

四大功能对应关系

功能 标准库(references/) 增量库(references-add/)
1. 获取账号信息 references/feature/01_获取账号信息.md + 浏览器搜索抖音账号操作规范.md feature/01_获取账号信息.md
2. 获取视频列表 references/feature/02_获取视频.md + 浏览器搜索抖音账号操作规范.md feature/02_获取视频.md
3. 提炼账号设定 references/feature/03_提炼账号设定.md + 人设卡生成方法.md + 知识库/账号设定/ + 解析结果格式规范.md(功能四仍启用时需保留) feature/03_提炼账号设定.md + 知识库/账号设定/
4. 分析视频数据 references/feature/04_分析视频数据.md + 账号数据分析方法.md + 知识库/视频拆解/ feature/04_分析视频数据.md + 知识库/视频拆解/

功能启用/禁用判定:标准库与增量库中该功能的 feature/*.md 都不存在时,该功能禁用(只删标准库、增量库仍存在时功能仍启用)。

引用优先级

运行时按以下顺序同时检索:

references/(标准库) + references-add/(增量库) → 取并集
  1. 标准库内容优先,增量库作为补充
  2. 两处都存在时以 references/ 为准(增量不覆盖标准)
  3. 唯一例外:路径配置。路径配置.md 中用户自定义的产出路径覆盖标准库默认路径

修改规则(区分场景,判定标准与 SKILL.md 一致)

场景 判断依据(一步判定:看是否处于源技能 git 检出内) 生成设定调用的文件 修改方式
① 开发机 技能处于源技能 git 检出内(源技能) 调用源技能对应文件 源技能只读,禁止修改;只能从源技能单向同步到本技能:按两步法(① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库)同步到 references/知识库/;标准库 references/ 可正常修改(开发机直接改标准库,不使用增量库机制)
② 用户环境 技能不在任何 git 检出内(技能装在哪、什么路径都是用户环境) 调用本技能 references/(标准库,含账号设定 + 视频拆解自有知识库) 不修改 references/,新增/修改内容写入 references-add/ 对应目录

② 用户环境启用流程(如未来部署)

  1. 把 references/路径配置.md、references/铁律避坑规则/ 移回 references-add/ 对应位置
  2. 删除标准库中② 用户环境不需要的增量内容
  3. 按本文件「修改规则」维护增量库