配置收敛:
- 端口/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.4 KiB
5.4 KiB
references-add/ — 用户部署后新增沉淀地(增量库)
本目录是用户部署到电脑后,新增的流程、方法、知识库的沉淀地,作为对 references/(默认标准库)的补充和扩展。
目录结构
references-add/
├── README.md ← 本文件
├── 路径配置.md ← 产出路径唯一权威(开发机/用户环境同构:桌面 MCNSkill项目/{账号名}/提示词{编号}/ 账号层直挂。运行时必读)
├── 制作流程/ ← 新增/变更的制作流程文件
├── 接口调用/ ← 新增的 API 接口文档与平台规范
└── 知识库/ ← 新增知识(15 维度,与 references/ 结构对应)
├── 01_主体描述/ ← 人/物/场景,含外貌细节与微表情系统
├── 02_动作行为/ ← 主体动作、姿势、互动、物理连贯性
├── 03_场景描述/ ← 背景、环境、时间、天气、空间锚定
├── 04_镜头类型/ ← 景别(特写→远景)+ 四维编码 Z 轴
├── 05_运镜方式/ ← 摄像机运动方式与节奏 + 四维编码运动维度
├── 06_焦距视角/ ← 镜头焦段、拍摄角度 + 四维编码 Y/X/F 轴 + 焦段心理学
├── 07_光线时间/ ← 光源类型、方向、强弱 + 光影三层
├── 08_氛围天气/ ← 情绪氛围、天气条件
├── 09_色彩后期/ ← 调色、滤镜、电影质感 + 冷暖色调对比系统
├── 10_后期细节/ ← 磨皮、锐化、运动模糊、胶片颗粒 + 有机瑕疵
├── 11_特效渲染/ ← 光效、散景、粒子、GI/SSS/体积光 + 深度美学约束
├── 12_画质分辨率/ ← 输出规格 + 反塑料感宣言
├── 13_音效音频/ ← 空间声学、材质拟声、音色控制
├── 14_构图布局/ ← 构图法则、版式、画面布局、极简先锋构图
└── 15_视觉风格/ ← 导演风格参数化映射 + 艺术流派/渲染风格
三层引用架构
| 层级 | 目录 | 定位 | 读写 |
|---|---|---|---|
| 1 | 参考skills/ |
外部参考技能(方法论来源,三大技能) | 只读 |
| 2 | references/ |
默认引用文件地址(出厂自带标准库) | 开发环境可编辑;部署环境只读 |
| 3 | references-add/(本目录) |
用户部署后新增沉淀地 | 可读写,持续增长 |
部署环境检测
根据**一步判定模型(仓库特征判定)**判断当前环境(看技能是否处于源技能 git 检出内):
| 环境 | 判定条件 | 增量机制 | 新增内容写入位置 |
|---|---|---|---|
| ①开发机 | 技能处于源技能 git 检出内(git -C {技能目录} rev-parse --show-toplevel 返回仓库根) |
不启用 references-add/ | references/ 对应子目录 |
| ②用户环境 | 技能不在任何 git 检出内(技能无论装在哪、什么路径) | 启用 references-add/(本目录) | references-add/ 对应子目录 |
冲突检测与修复
用户在对话过程中新增方法、流程、知识库后:
- 比对检测:将新增内容与
references/中同类内容逐一比对(同名文件、同主题内容) - 无冲突:直接写入
references-add/对应子目录 - 有冲突:以新增内容为主(写入
references-add/),同时在references/对应文件中加 ⚠️ 注释标注冲突点及正确规则,不删除或覆盖原始内容
运行时引用优先级
技能执行时同时加载 references/ 和 references-add/,两者内容冲突以 references-add/ 为主:
参考skills/(方法论源) → references/(默认标准库) → references-add/(用户增量,冲突时以此为准)
完整规则详见
SKILL.md「动态增量管理」节。
文件命名规则
| 新增类型 | 归入目录 | 文件命名 | 示例 |
|---|---|---|---|
| 制作流程 | 制作流程/ |
{阶段号}_{制作环节}.md |
3_素材审验标准.md |
| 接口/平台规范 | 接口调用/ |
{接口名称}.md |
Seedance_平台限制.md |
| 提示词维度知识 | 知识库/{维度}/ |
{日期}_{知识主题}.md |
20260820_景别选择指南.md |
通用规则
- 防重复: 写入前先搜索
references/和references-add/中是否存在相似内容 - 格式要求: 每个文件包含知识来源(用户对话)和结构化提炼,非原始对话日志
- 维度归档: 知识库按 15 维度对号入座,非维度类内容归入
制作流程/或接口调用/ - 词汇分布: 各维度词汇表归入对应维度文件夹,不设独立词汇库
运行时加载规则
仅非开发机环境生效(②用户环境,即技能不在任何 git 检出内时)。同时加载 references/ 和 references-add/ 的内容,两者冲突时以 references-add/ 为主:
| 维度 | 加载规则 |
|---|---|
| 制作流程 | 先查 references/制作流程/,再查 references-add/制作流程/,同名文件以 references-add/ 为主 |
| 知识库 | 先搜 references/知识库/{维度}/,再搜 references-add/知识库/{维度}/,两目录共同参与检索,冲突时以 references-add/ 为主 |
| 接口调用 | 先查 references/接口调用/,再查 references-add/接口调用/,冲突时以 references-add/ 为主 |