# SOURCE_OF_TRUTH.md

> 本文件是 `内容结构化系统` 的数据权威索引。
> 当需要定位来源、判断处理状态、确认主单元、解决重复冲突时，先读本文件。

---

## 一、系统快速查找

| 要找什么 | 权威位置 | 备注 |
| --- | --- | --- |
| 系统规则总入口 | `AGENTS.md` | 处理流程、目录职责、禁止事项 |
| Claude 侧说明 | `CLAUDE.md` | 给 Claude Code 的仓库说明 |
| 处理流程总入口 | `00-规则与索引/process-flow.md` | 系统级处理步骤与入口说明 |
| 内容单元关系规则 | `00-规则与索引/content-unit-relationship-rules.md` | 第一期开启的关系类型与方向 |
| 内容单元去重与版本规则 | `00-规则与索引/content-unit-dedup-version-rules.md` | 合并与版本升级规则 |
| 内容单元字段规范 | `00-规则与索引/content-unit-field-standard.md` | 公共字段与类型字段 |
| 来源命名规范 | `00-规则与索引/source-naming-standard.md` | `SRC-*` 的生成与使用规则 |
| 新增文稿处理流程 | `00-规则与索引/new-draft-ingestion-process.md` | 单篇新素材进入系统的标准顺序 |
| 内容单元模板 | `04-模板/` | 5 类内容单元模板 |
| 主题地图主库 | `05-主题地图/` | 主题层重组入口与跨单元组织层 |
| 选题装配主库 | `06-选题装配/` | 文章 / 视频 / 选题的重组骨架 |
| `Obsidian` 链接补全脚本 | `07-脚本与工具/fill-obsidian-links.js` | 把正文中的文件编号补成 `[[文件名]]` |
| 关系索引脚本 | `07-脚本与工具/generate-link-map.js` | 重建关系明细与关系总览 |
| 去重候选索引脚本 | `07-脚本与工具/generate-duplicate-candidates.js` | 重建去重候选、审计与总览 |
| 系统总览脚本 | `07-脚本与工具/summarize-system.js` | 输出当前内容单元、主题地图、装配稿数量 |
| 样本抽取脚本 | `07-脚本与工具/extract-sample-units.js` | 从样本文稿抽取第一批内容单元草稿 |
| 原始素材副本 | `01-原始素材区/` | 从旧目录复制而来，只做来源保留 |
| 内容单元主库 | `02-内容单元库/` | 结构化后的有效单元 |
| 处理状态 | `03-处理状态/处理状态总览.md` | 当前范围、已完成事项、下一步 |
| 来源注册表 | `03-处理状态/来源注册表.csv` | 已分配来源 ID 的权威表 |
| 批量来源注册候选表 | `03-处理状态/来源注册表_批量生成候选.csv` | 脚本生成的待人工确认来源表 |
| 原始素材索引重建脚本 | `07-脚本与工具/rebuild-processing-ledger.js` | 重新生成 `原始素材索引.csv` 与 `待处理清单.csv` |
| 已处理清单 | `03-处理状态/已处理清单.csv` | 已进入结构化处理链的素材 |
| 抽取日志 | `03-处理状态/抽取日志.md` | 每次抽取的操作记录 |
| 样本计划 | `03-处理状态/第一批样本计划.md` | 样本范围与当前状态 |
| 关系明细索引 | `03-处理状态/关系索引.csv` | 内容单元之间的显式关系明细 |
| 关系总览 | `03-处理状态/关系总览.md` | 当前关系数量、类型分布与校验结果 |
| 去重候选索引 | `03-处理状态/去重候选索引.csv` | 同类型内容单元的近似重复候选清单 |
| 去重与冲突审计 | `03-处理状态/去重与冲突审计.csv` | 冲突回写与分层关系校验明细 |
| 去重与冲突总览 | `03-处理状态/去重与冲突总览.md` | 当前去重候选数量与冲突处理说明 |

---

## 二、目录职责

| 目录 | 放什么 | 不放什么 |
| --- | --- | --- |
| `00-规则与索引/` | 系统规则、字段、关系、去重、模板规范 | 原始文稿、结构化结果 |
| `01-原始素材区/` | 原始文稿副本、原始索引、原始参考材料 | 加工后的内容单元 |
| `02-内容单元库/` | 可复用、可追溯的内容单元 | 未筛选的整篇文稿 |
| `03-处理状态/` | 处理进度、样本计划、冲突与日志 | 内容正文资产 |
| `04-模板/` | 内容单元模板 | 具体业务内容 |
| `05-主题地图/` | 主题层组织文件、跨单元重组入口 | 单个内容单元正文、原始文稿 |
| `06-选题装配/` | 面向发布的装配稿、表达骨架、重组路径 | 原始素材副本、规则文档 |
| `07-脚本与工具/` | 索引重建、补链、去重、总览等辅助脚本 | 业务内容正文主库 |

---

## 三、原始素材权威规则

1. `01-原始素材区/` 中的内容都是从旧目录复制而来的副本
2. 原始副本不得直接改写；如需清洗、提炼、重写，必须在 `02-内容单元库/` 完成
3. 同一原始素材如在多个来源出现，以信息更完整、时间更明确、上下文更完整的版本为准
4. 已正式进入处理链的原始素材，必须先登记到 `03-处理状态/来源注册表.csv`

---

## 四、内容单元权威规则

1. `02-内容单元库/` 中 `canonical: true` 的文件视为当前主单元
2. 同一语义内容如出现多个近似版本，以主单元为当前有效引用对象
3. `source_documents` 是内容单元的来源追溯权威字段
4. `relationships` 是内容单元之间关系的权威字段
5. `version` 表示当前有效版本，历史变更交给 Git

---

## 五、重复与冲突规则

1. 只有 `完全重复` 与 `同义重复` 默认合并
2. `近似重复` 不合并，保留独立单元
3. 判断相反或适用边界不同的内容单元不合并，用 `冲突` 关系处理
4. 同一案例多次讲述时，默认并入主案例，除非叙述角度已经变化成新案例

---

## 六、当前范围边界

当前系统优先处理以下内容：

- 用户本人已发布内容
- 用户本人未发布但结构成熟的稿件
- 外部研究素材

如果后续进入其他类型内容，先结合方法论和用户沟通结果再决定是否纳入。

