Files
mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-video-prompt/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.4 KiB
Raw Blame History

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/ 对应子目录

冲突检测与修复

用户在对话过程中新增方法、流程、知识库后:

  1. 比对检测:将新增内容与 references/ 中同类内容逐一比对(同名文件、同主题内容)
  2. 无冲突:直接写入 references-add/ 对应子目录
  3. 有冲突:以新增内容为主(写入 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/ 为主