3.4 KiB
3.4 KiB
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/对应文件加 ⚠️ 注释标注，不删除或覆盖原始内容