配置收敛:
- 端口/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 条已知坑)
5.2 KiB
5.2 KiB
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/(增量库) → 取并集
- 标准库内容优先,增量库作为补充
- 两处都存在时以
references/为准(增量不覆盖标准) - 唯一例外:路径配置。
路径配置.md中用户自定义的产出路径覆盖标准库默认路径
修改规则(区分场景,判定标准与 SKILL.md 一致)
| 场景 | 判断依据(一步判定:看是否处于源技能 git 检出内) | 生成设定调用的文件 | 修改方式 |
|---|---|---|---|
| ① 开发机 | 技能处于源技能 git 检出内(源技能) | 调用源技能对应文件 | 源技能只读,禁止修改;只能从源技能单向同步到本技能:按两步法(① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库)同步到 references/知识库/;标准库 references/ 可正常修改(开发机直接改标准库,不使用增量库机制) |
| ② 用户环境 | 技能不在任何 git 检出内(技能装在哪、什么路径都是用户环境) | 调用本技能 references/(标准库,含账号设定 + 视频拆解自有知识库) |
不修改 references/,新增/修改内容写入 references-add/ 对应目录 |
② 用户环境启用流程(如未来部署)
- 把
references/路径配置.md、references/铁律避坑规则/移回references-add/对应位置 - 删除标准库中② 用户环境不需要的增量内容
- 按本文件「修改规则」维护增量库