# 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. 按本文件「修改规则」维护增量库