# references/ — 默认引用文件地址（标准库）

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

## 目录结构

```
references/
├── README.md           ← 本文件
├── 创作流程/           ← 标准创作流程文件
├── 接口调用/           ← 标准接口定义与调用文档
├── _meta/              ← 辅助参考资料
└── 知识库/             ← 标准知识库（10 分类）
    ├── 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/` | 用户部署后新增的流程/方法/知识库沉淀地 | 可读写，持续增长 |

### 部署环境检测

根据技能根目录的**绝对路径**判断当前是否已部署到用户电脑：

| 环境 | 判定条件 | references/ 权限 | 新增内容写入位置 |
|:---:|:---|:---|:---|
| **开发环境** | 路径含 `MCNVideo AI\project\短视频分镜创作` | 可直接编辑 | `references/` 对应子目录 |
| **部署环境** | 路径不含上述开发特征 | 只读 | `references-add/` 对应子目录 |

### 冲突检测与运行时优先级

- **冲突检测**：用户新增内容后，与 `references/` 同类内容逐一比对；有冲突时以新增内容为主（写入 `references-add/`），同时在 `references/` 对应文件加 ⚠️ 注释标注，不覆盖原始内容
- **运行时优先级**：技能执行时同时加载 `references/` 和 `references-add/`，两者冲突**以 references-add/ 为主**

```
参考skills/（方法论源） → references/（默认标准库） → references-add/（用户增量，冲突时以此为准）
```

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

## 当前状态

当前 `references/` 各分类目录为空，标准方法论暂由 `参考skills/` 三大外部参考技能提供。本目录作为标准库位置预留，后续可将精炼后的标准引用文件填充至此。

## 与 references-add/ 的关系

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