references-add/ — 用户部署后新增沉淀地（增量库）
本目录是用户部署到电脑后，新增的流程、方法、知识库的沉淀地，作为对 references/（默认标准库）的补充和扩展。
目录结构
references-add/
├── README.md ← 本文件
├── 创作流程/ ← 新增/变更的创作流程文件
├── 接口调用/ ← 新增的 API 接口定义与调用文档
└── 知识库/ ← 新增的短视频分镜创作知识和方法
├── 01_美学风格约束/ ← 渲染品质/冷暖色调/构图法则
├── 02_镜头四维编码/ ← Z/Y/X/F 坐标系统
├── 03_剪辑节奏公式/ ← 六套剪辑公式 + AI素材对策
├── 04_图片生成规范/ ← 角色卡/首帧图/关键帧图
├── 05_创意策略库/ ← 爆款模式/Hook设计
├── 06_平台规范/ ← Seedance限制/文件上限/合规
├── 07_词汇库/ ← 运镜词/风格词/修饰词
├── 08_案例库/ ← 实验案例/项目案例
├── 09_分镜驱动方法/ ← N宫格拆解/D-1/D-2模式
└── 10_长视频策略/ ← 分段拼接/25格流水线
三层引用架构
| 层级 | 目录 | 定位 | 读写 |
|---|---|---|---|
| 1 | 参考skills/ |
外部参考技能（方法论来源，三大技能） | 只读 |
| 2 | references/ |
默认引用文件地址（出厂自带标准库） | 开发环境可编辑；部署环境只读 |
| 3 | references-add/（本目录） |
用户部署后新增沉淀地 | 可读写，持续增长 |
部署环境检测
根据技能根目录的绝对路径判断当前是否已部署到用户电脑：
| 环境 | 判定条件 | 增量机制 | 新增内容写入位置 |
|---|---|---|---|
| 开发环境 | 路径含 MCNVideo AI\project\短视频分镜创作 |
不启用 references-add/ | references/ 对应子目录 |
| 部署环境 | 路径不含上述开发特征 | 启用 references-add/（本目录） | references-add/ 对应子目录 |
冲突检测与修复
用户在对话过程中新增方法、流程、知识库后：
- 比对检测：将新增内容与
references/中同类内容逐一比对（同名文件、同主题内容） - 无冲突：直接写入
references-add/对应子目录 - 有冲突：以新增内容为主（写入
references-add/），同时在references/对应文件中加 ⚠️ 注释标注冲突点及正确规则，不删除或覆盖标准库原始内容
运行时引用优先级
技能执行时同时加载 references/ 和 references-add/，两者内容冲突以 references-add/ 为主：
参考skills/（方法论源） → references/（默认标准库） → references-add/（用户增量，冲突时以此为准）
完整规则详见
SKILL.md「动态增量管理」节。
文件命名规则
| 新增类型 | 归入目录 | 文件命名 | 示例 |
|---|---|---|---|
| 创作流程 | 创作流程/ |
{步骤号}_{功能名称}.md |
5_转场设计.md |
| 接口调用 | 接口调用/ |
{接口名称}.md |
Kuaishou_Video_API.md |
| 创作知识 | 知识库/{分类}/ |
{日期}_{知识主题}.md |
20260728_运动镜头设计.md |
通用规则
- 防重复： 写入前先搜索
references/和references-add/中是否存在相似内容 - 格式要求： 每个文件包含知识来源（用户对话）和结构化提炼，非原始对话日志
- 分类归档： 知识库按 01-10 标准分类对号入座
运行时加载规则
仅部署环境生效（路径不含开发特征时）。同时加载 references/ 和 references-add/ 的内容，两者冲突时以 references-add/ 为主：
| 维度 | 加载规则 |
|---|---|
| 创作流程 | 先查 references/创作流程/，再查 references-add/创作流程/，同名文件以 references-add/ 为主 |
| 知识库 | 先搜 references/知识库/{分类}/，再搜 references-add/知识库/{分类}/，两目录共同参与检索，冲突时以 references-add/ 为主 |
| 接口调用 | 先查 references/接口调用/，再查 references-add/接口调用/，冲突时以 references-add/ 为主 |