2026-08-25 09:34:39 +08:00
|
|
|
|
# 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/` | 用户部署后新增的流程/方法/知识库沉淀地 | 可读写，持续增长 |
|
|
|
|
|
|
|
|
|
|
|
|
### 部署环境检测
|
|
|
|
|
|
|
2026-09-10 18:28:42 +08:00
|
|
|
|
根据**一步判定模型（仓库特征判定）**判断当前环境（看技能是否处于源技能 git 检出内）：
|
2026-08-25 09:34:39 +08:00
|
|
|
|
|
|
|
|
|
|
| 环境 | 判定条件 | references/ 权限 | 新增内容写入位置 |
|
|
|
|
|
|
|:---:|:---|:---|:---|
|
2026-09-10 18:28:42 +08:00
|
|
|
|
| **①开发机** | 技能处于源技能 git 检出内（`git -C {技能目录} rev-parse --show-toplevel` 返回仓库根） | 可直接编辑 | `references/` 对应子目录 |
|
|
|
|
|
|
| **②用户环境** | 技能不在任何 git 检出内（技能无论装在哪、什么路径） | 只读 | `references-add/` 对应子目录 |
|
2026-08-25 09:34:39 +08:00
|
|
|
|
|
|
|
|
|
|
### 冲突检测与运行时优先级
|
|
|
|
|
|
|
|
|
|
|
|
- **冲突检测**：用户新增内容后，与 `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/` 对应文件加 ⚠️ 注释标注，不删除或覆盖原始内容
|
