2026-08-25 09:34:39 +08:00
|
|
|
|
# references-add/ — 用户部署后新增沉淀地（增量库）
|
|
|
|
|
|
|
|
|
|
|
|
本目录是用户部署到电脑后，新增的流程、方法、知识库的沉淀地，作为对 `references/`（默认标准库）的补充和扩展。
|
|
|
|
|
|
|
|
|
|
|
|
## 目录结构
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
references-add/
|
|
|
|
|
|
├── README.md ← 本文件
|
2026-08-26 17:28:21 +08:00
|
|
|
|
├── 路径配置.md ← 产出路径唯一权威（dsh 环境优先 `D:\dshworkspace\创作任务\`、无主工作区时桌面 DSHSkill项目/；开发机/用户环境 桌面 MCNSkill项目/{账号名}/提示词{编号}/ 账号层直挂，运行时必读）
|
2026-08-25 09:34:39 +08:00
|
|
|
|
├── 制作流程/ ← 新增/变更的制作流程文件
|
|
|
|
|
|
├── 接口调用/ ← 新增的 API 接口文档与平台规范
|
|
|
|
|
|
└── 知识库/ ← 新增知识（15 维度，与 references/ 结构对应）
|
|
|
|
|
|
├── 01_主体描述/ ← 人/物/场景，含外貌细节与微表情系统
|
|
|
|
|
|
├── 02_动作行为/ ← 主体动作、姿势、互动、物理连贯性
|
|
|
|
|
|
├── 03_场景描述/ ← 背景、环境、时间、天气、空间锚定
|
|
|
|
|
|
├── 04_镜头类型/ ← 景别（特写→远景）+ 四维编码 Z 轴
|
|
|
|
|
|
├── 05_运镜方式/ ← 摄像机运动方式与节奏 + 四维编码运动维度
|
|
|
|
|
|
├── 06_焦距视角/ ← 镜头焦段、拍摄角度 + 四维编码 Y/X/F 轴 + 焦段心理学
|
|
|
|
|
|
├── 07_光线时间/ ← 光源类型、方向、强弱 + 光影三层
|
|
|
|
|
|
├── 08_氛围天气/ ← 情绪氛围、天气条件
|
|
|
|
|
|
├── 09_色彩后期/ ← 调色、滤镜、电影质感 + 冷暖色调对比系统
|
|
|
|
|
|
├── 10_后期细节/ ← 磨皮、锐化、运动模糊、胶片颗粒 + 有机瑕疵
|
|
|
|
|
|
├── 11_特效渲染/ ← 光效、散景、粒子、GI/SSS/体积光 + 深度美学约束
|
|
|
|
|
|
├── 12_画质分辨率/ ← 输出规格 + 反塑料感宣言
|
|
|
|
|
|
├── 13_音效音频/ ← 空间声学、材质拟声、音色控制
|
|
|
|
|
|
├── 14_构图布局/ ← 构图法则、版式、画面布局、极简先锋构图
|
|
|
|
|
|
└── 15_视觉风格/ ← 导演风格参数化映射 + 艺术流派/渲染风格
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 三层引用架构
|
|
|
|
|
|
|
|
|
|
|
|
| 层级 | 目录 | 定位 | 读写 |
|
|
|
|
|
|
|:---:|:---|:---|:---|
|
|
|
|
|
|
| 1 | `参考skills/` | 外部参考技能（方法论来源，三大技能） | 只读 |
|
|
|
|
|
|
| 2 | `references/` | 默认引用文件地址（出厂自带标准库） | 开发环境可编辑；部署环境只读 |
|
|
|
|
|
|
| 3 | `references-add/`（本目录） | 用户部署后新增沉淀地 | 可读写，持续增长 |
|
|
|
|
|
|
|
|
|
|
|
|
### 部署环境检测
|
|
|
|
|
|
|
2026-08-26 17:28:21 +08:00
|
|
|
|
根据**两步判定模型**判断当前环境（第一步查本机 `D:\AgentSkill` 是否存在；有 → 第二步看技能自身路径）：
|
2026-08-25 09:34:39 +08:00
|
|
|
|
|
|
|
|
|
|
| 环境 | 判定条件 | 增量机制 | 新增内容写入位置 |
|
|
|
|
|
|
|:---:|:---|:---|:---|
|
2026-08-26 17:28:21 +08:00
|
|
|
|
| **①开发机** | 本机有 `D:\AgentSkill` 且技能路径在 `D:\AgentSkill\` 下 | 不启用 references-add/ | `references/` 对应子目录 |
|
|
|
|
|
|
| **②dsh 部署环境** | 本机有 `D:\AgentSkill` 且技能路径含 `.dsh` | 启用 references-add/（本目录） | `references-add/` 对应子目录 |
|
|
|
|
|
|
| **③用户环境** | 本机无 `D:\AgentSkill`（技能无论装在哪、什么路径） | 启用 references-add/（本目录） | `references-add/` 对应子目录 |
|
2026-08-25 09:34:39 +08:00
|
|
|
|
|
|
|
|
|
|
### 冲突检测与修复
|
|
|
|
|
|
|
|
|
|
|
|
用户在对话过程中新增方法、流程、知识库后：
|
|
|
|
|
|
|
|
|
|
|
|
1. **比对检测**：将新增内容与 `references/` 中同类内容逐一比对（同名文件、同主题内容）
|
|
|
|
|
|
2. **无冲突**：直接写入 `references-add/` 对应子目录
|
|
|
|
|
|
3. **有冲突**：以**新增内容为主**（写入 `references-add/`），同时在 `references/` 对应文件中加 ⚠️ 注释标注冲突点及正确规则，不删除或覆盖原始内容
|
|
|
|
|
|
|
|
|
|
|
|
### 运行时引用优先级
|
|
|
|
|
|
|
|
|
|
|
|
技能执行时同时加载 `references/` 和 `references-add/`，两者内容冲突**以 references-add/ 为主**：
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
参考skills/（方法论源） → references/（默认标准库） → references-add/（用户增量，冲突时以此为准）
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
> 完整规则详见 `SKILL.md`「动态增量管理」节。
|
|
|
|
|
|
|
|
|
|
|
|
## 文件命名规则
|
|
|
|
|
|
|
|
|
|
|
|
| 新增类型 | 归入目录 | 文件命名 | 示例 |
|
|
|
|
|
|
|:---|:---|:---|:---|
|
|
|
|
|
|
| 制作流程 | `制作流程/` | `{阶段号}_{制作环节}.md` | `3_素材审验标准.md` |
|
|
|
|
|
|
| 接口/平台规范 | `接口调用/` | `{接口名称}.md` | `Seedance_平台限制.md` |
|
|
|
|
|
|
| 提示词维度知识 | `知识库/{维度}/` | `{日期}_{知识主题}.md` | `20260820_景别选择指南.md` |
|
|
|
|
|
|
|
|
|
|
|
|
## 通用规则
|
|
|
|
|
|
|
|
|
|
|
|
- **防重复：** 写入前先搜索 `references/` 和 `references-add/` 中是否存在相似内容
|
|
|
|
|
|
- **格式要求：** 每个文件包含知识来源（用户对话）和结构化提炼，非原始对话日志
|
|
|
|
|
|
- **维度归档：** 知识库按 15 维度对号入座，非维度类内容归入 `制作流程/` 或 `接口调用/`
|
|
|
|
|
|
- **词汇分布：** 各维度词汇表归入对应维度文件夹，不设独立词汇库
|
|
|
|
|
|
|
|
|
|
|
|
## 运行时加载规则
|
|
|
|
|
|
|
2026-08-26 17:28:21 +08:00
|
|
|
|
**仅非开发机环境生效**（②dsh 部署环境/③用户环境，即本机无 `D:\AgentSkill` 或技能路径含 `.dsh` 时）。同时加载 `references/` 和 `references-add/` 的内容，两者冲突时**以 references-add/ 为主**：
|
2026-08-25 09:34:39 +08:00
|
|
|
|
|
|
|
|
|
|
| 维度 | 加载规则 |
|
|
|
|
|
|
|:---|:---|
|
|
|
|
|
|
| **制作流程** | 先查 `references/制作流程/`，再查 `references-add/制作流程/`，同名文件以 references-add/ 为主 |
|
|
|
|
|
|
| **知识库** | 先搜 `references/知识库/{维度}/`，再搜 `references-add/知识库/{维度}/`，两目录共同参与检索，冲突时以 references-add/ 为主 |
|
|
|
|
|
|
| **接口调用** | 先查 `references/接口调用/`，再查 `references-add/接口调用/`，冲突时以 references-add/ 为主 |
|
