mcn-short-video/project/短视频脚本创作/V1.0/subskills/mcn-dou-analysis/references-add/README.md

references-add（增量库）—— 机制说明

三环境判定（两步判定，与 SKILL.md 一致）：第一步查本机是否存在 D:\AgentSkill——无 = ③ 用户环境（技能无论装在哪、什么路径）；有 → 第二步看技能路径——在 D:\AgentSkill\ 下 = ① 开发机（源技能）、含 .dsh = ② dsh 部署环境（如 {主目录}/.dsh/skills/）。

references-add 机制只服务 ③ 用户环境：① 开发机 / ② dsh 环境标准库 references/ 可正常修改（新增内容直接并入标准库对应位置），本目录可仅保留本说明（机制文档）；③ 用户环境部署后标准库 references/ 永远不变，新增/修改内容统一写入本目录。

用途

当本技能（MCNDouAnalysis）被部署到③ 用户环境（本机没有 D:\AgentSkill）时，本技能的标准库 references/（含自有知识库 知识库/账号设定/ + 知识库/视频拆解/）在部署后永远不变。用户在使用过程中新增/修改的流程、方法论、分析方式、铁律等内容，统一整理到本文件夹。

核心原则

目录	定位	内容来源	修改策略
references/	原始标准库（内置）	开发时固化（含从源技能按两步法重组的账号设定知识库 + 视频拆解知识库）	部署后永远不变
references-add/	动态增量库	③ 用户环境中用户对话中积累	随使用持续增长

目录结构

references-add/                 ← 增量库（与标准库 references/ 结构镜像对齐）
├── README.md              ← 本说明（机制文档）
├── 路径配置.md            ← 🔴 产出路径唯一权威配置（用户自定义路径在此记录）
├── feature/               ← 功能级增量（对应标准库 references/feature/，删除即禁用该功能）
│   ├── 01_获取账号信息.md ← 功能一增量
│   ├── 02_获取视频.md     ← 功能二增量
│   ├── 03_提炼账号设定.md ← 功能三增量
│   └── 04_分析视频数据.md ← 功能四增量
├── 知识库/                ← 方法论增量（对应标准库 references/知识库/，含「账号设定」「视频拆解」两个分类）
│   ├── 账号设定/          ← 生成设定（功能三）方法论增量
│   └── 视频拆解/          ← 账号数据分析（功能四）拆解知识库增量
└── 铁律避坑规则/          ← 铁律和避坑（含 账号数据分析执行避坑.md）

四大功能对应关系

功能	标准库（references/）	增量库（references-add/）
1. 获取账号信息	references/feature/01_获取账号信息.md + 浏览器搜索抖音账号操作规范.md	feature/01_获取账号信息.md
2. 获取视频列表	references/feature/02_获取视频.md + 浏览器搜索抖音账号操作规范.md	feature/02_获取视频.md
3. 提炼账号设定	references/feature/03_提炼账号设定.md + 人设卡生成方法.md + 知识库/账号设定/ + 解析结果格式规范.md（功能四仍启用时需保留）	feature/03_提炼账号设定.md + 知识库/账号设定/
4. 分析视频数据	references/feature/04_分析视频数据.md + 账号数据分析方法.md + 知识库/视频拆解/	feature/04_分析视频数据.md + 知识库/视频拆解/

功能启用/禁用判定：标准库与增量库中该功能的 feature/*.md 都不存在时，该功能禁用（只删标准库、增量库仍存在时功能仍启用）。

引用优先级

运行时按以下顺序同时检索：

references/（标准库） + references-add/（增量库） → 取并集

1. 标准库内容优先，增量库作为补充
2. 两处都存在时以 references/ 为准（增量不覆盖标准）
3. 唯一例外：路径配置。路径配置.md 中用户自定义的产出路径覆盖标准库默认路径

修改规则（区分场景，判定标准与 SKILL.md 一致）

场景	判断依据（两步判定）	生成设定调用的文件	修改方式
① 开发机	本机有 D:\AgentSkill 且技能路径在 D:\AgentSkill\ 下（源技能）	调用源技能对应文件	源技能只读，禁止修改；只能从源技能单向同步到本技能：按两步法（① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库）同步到 references/知识库/；标准库 references/ 可正常修改（开发机直接改标准库，不使用增量库机制）
② dsh 环境	本机有 D:\AgentSkill 且技能路径含 .dsh（如 {主目录}/.dsh/skills/）	调用源技能对应文件	源技能只读，禁止修改；只能从源技能单向同步到本技能：按两步法（① 从源技能定位相关文件 → ② 重组为本技能自有流程/知识库）同步到 references/知识库/；标准库 references/ 可正常修改，增量内容直接并入标准库对应位置
③ 用户环境	本机没有 D:\AgentSkill（技能装在哪、什么路径都是用户环境）	调用本技能 references/（标准库，含账号设定 + 视频拆解自有知识库）	不修改 references/，新增/修改内容写入 references-add/ 对应目录

③ 用户环境启用流程（如未来部署）

1. 把 references/路径配置.md、references/铁律避坑规则/ 移回 references-add/ 对应位置
2. 删除标准库中③ 用户环境不需要的增量内容
3. 按本文件「修改规则」维护增量库