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

7.4 KiB
Raw Blame History

references/ — 默认引用文件地址(标准库)

本目录是技能的默认引用文件地址,存放出厂自带的标准制作流程、接口文档和知识库内容。

目录结构

references/
├── README.md           ← 本文件
├── 制作流程/            ← 标准制作流程(分镜提示词制作流程/长视频分段制作流程/图生视频与分镜板制作流程/多镜头剪辑节奏流程,共4文件)
├── 接口调用/            ← 标准接口定义与平台规范(Seedance限制/文件上限/合规/MCP调用)
├── _meta/               ← 辅助参考资料(案例库/术语表)
└── 知识库/              ← 标准知识库(15 维度,按提示词组成要素分类)
    ├── 01_主体描述/       ← 人/物/场景,含外貌细节与微表情系统
    ├── 02_动作行为/       ← 主体动作、姿势、互动、物理连贯性
    ├── 03_场景描述/       ← 背景、环境、时间、天气、空间锚定
    ├── 04_镜头类型/       ← 景别(特写→远景)+ 四维编码 Z 轴
    ├── 05_运镜方式/       ← 摄像机运动方式与节奏 + 四维编码运动维度
    ├── 06_焦距视角/       ← 镜头焦段、拍摄角度 + 四维编码 Y/X/F 轴 + 焦段心理学
    ├── 07_光线时间/       ← 光源类型、方向、强弱 + 光影三层(光源层/光行为层/色调层)
    ├── 08_氛围天气/       ← 情绪氛围、天气条件
    ├── 09_色彩后期/       ← 调色、滤镜、电影质感 + 冷暖色调对比系统
    ├── 10_后期细节/       ← 磨皮、锐化、运动模糊、胶片颗粒 + 有机瑕疵
    ├── 11_特效渲染/       ← 光效、散景、粒子、GI/SSS/体积光 + 深度美学约束
    ├── 12_画质分辨率/     ← 输出规格 + 反塑料感宣言(平台 UI 设置,非提示词废话词)
    ├── 13_音效音频/       ← 空间声学、材质拟声、音色控制(视频提示词 `音效:` 行)
    ├── 14_构图布局/       ← 构图法则、版式、画面布局、极简先锋构图
    └── 15_视觉风格/       ← 导演风格参数化映射(28+风格去名化)+ 艺术流派/渲染风格

维度分类说明

知识库按提示词组成要素(维度)分类,每个维度对应提示词中的一个组成部分。写提示词时按维度逐项组装,知识库文件提供该维度的词汇表、参数表、规则和示例。

编号 维度 说明 主要参考技能来源
01 主体描述 人/物/场景,含外貌细节与微表情系统 PromptSkill4image subject + ShotDesign 六要素 + ShotDesign micro-expressions
02 动作行为 主体动作、姿势、互动、物理连贯性 PromptSkill4image action + ShotDesign 六要素
03 场景描述 背景、环境、时间、天气、空间锚定 PromptSkill4image scene + ShotDesign 六要素
04 镜头类型 景别(特写→远景) seedance2.0 四维编码 Z 轴 + ShotDesign cinematography
05 运镜方式 摄像机运动方式与节奏 seedance2.0 四维编码运动维度 + ShotDesign 三级运镜
06 焦距视角 镜头焦段、拍摄角度 seedance2.0 四维编码 Y/X/F 轴 + ShotDesign 焦段心理学
07 光线时间 光源类型、方向、强弱 PromptSkill4image lighting + ShotDesign 光影三层-光源层/光行为层
08 氛围天气 情绪氛围、天气条件 PromptSkill4image mood
09 色彩后期 调色、滤镜、电影质感 PromptSkill4image color_scheme + ShotDesign 光影三层-色调层 + seedance2.0 冷暖色调
10 后期细节 磨皮、锐化、运动模糊、胶片颗粒 ShotDesign 有机瑕疵 + 史诗结构收束句 + PromptSkill4image material
11 特效渲染 光效、散景、粒子、GI/SSS/体积光 seedance2.0 美学约束 + PromptSkill4image render_quality + ShotDesign 品质锚定
12 画质分辨率 输出规格 ⚠️ 参考技能策略:分辨率/帧率在即梦平台 UI 设置,提示词中用物理材质词替代"4k/8k"等废话词(反塑料感宣言)
13 音效音频 空间声学、材质拟声、音色控制 ShotDesign audio-tags(视频提示词 音效: 行专用)
14 构图布局 构图法则、版式、画面布局 PromptSkill4image composition + ShotDesign 极简先锋构图法则
15 视觉风格 导演风格参数化映射 + 艺术流派/渲染风格 ShotDesign director-styles(28+风格去名化)+ PromptSkill4image style

词汇分布原则: 旧"07_词汇库"已取消独立分类,各维度词汇表归入对应维度文件夹内(如运镜词→05_运镜方式/,风格词→15_视觉风格/)。

三层引用架构

层级 目录 定位 读写
1 参考skills/ 外部参考技能(方法论来源,已提炼落库至本目录) 只读
2 references/(本目录) 默认引用文件地址(出厂自带标准库) 开发环境可编辑;部署环境只读
3 references-add/ 用户部署后新增的流程/方法/知识库沉淀地 可读写,持续增长

部署环境检测

根据**一步判定模型(仓库特征判定)**判断当前环境(看技能是否处于源技能 git 检出内):

环境 判定条件 references/ 权限 新增内容写入位置
①开发机 技能处于源技能 git 检出内(git -C {技能目录} rev-parse --show-toplevel 返回仓库根) 可直接编辑 references/ 对应子目录
②用户环境 技能不在任何 git 检出内(技能无论装在哪、什么路径) 只读 references-add/ 对应子目录

冲突检测与运行时优先级

  • 冲突检测:用户新增内容后,与 references/ 同类内容逐一比对;有冲突时以新增内容为主(写入 references-add/),同时在 references/ 对应文件加 ⚠️ 注释标注,不覆盖原始内容
  • 运行时优先级:技能执行时同时加载 references/ 和 references-add/,两者冲突以 references-add/ 为主
参考skills/(方法论源) → references/(默认标准库) → references-add/(用户增量,冲突时以此为准)

完整规则详见 SKILL.md「动态增量管理」节。

当前状态

标准库已填充完成(2026-07-28 从参考技能提炼落库;ShotDesign/seedance25 源文件已于 2026-08-21 移除,方法论已全部落库):

  • 制作流程/:4 个流程文件(分镜提示词制作流程 / 长视频分段制作流程 / 图生视频与分镜板制作流程 / 多镜头剪辑节奏流程)
  • 知识库/:15 个维度词库文件(01-15 各维度一个词库,含英文提示词可直接嵌入)

参考skills/ 仍保留为方法论源(只读,第一层),日常执行优先引用本目录文件;两者冲突时以本目录提炼版为准。

与 references-add/ 的关系

  • references/:默认标准库,出厂自带;开发环境可编辑,部署环境只读
  • references-add/:用户增量库,仅在部署环境启用,在对话中积累,随使用持续增长
  • 两者分类结构一一对应(制作流程 / 接口调用 / 知识库 15 维度)
  • 运行时同时加载,冲突时以 references-add/ 为主
  • 发现冲突时在 references/ 对应文件加 ⚠️ 注释标注,不删除或覆盖原始内容