content-find-agent-new/tech_documents

技术文档导航

本文档目录按“长期职责”组织，避免架构、代码蓝图、开发计划和字段合同混在一起。

1. 架构设计

路径：架构设计/

用途：说明 ContentFindAgent 为什么这样分模块、各模块 owner、写入边界、核心运行链路、规则包与游走策略边界、关键 ADR。

不承担：字段清单、DB schema、阶段开发顺序。

2. 工程落地

路径：工程落地/

用途：说明 V1 代码结构、P0 DB 与 Service 边界、待决策总台账、阶段开发计划和阶段验收清单。

不承担：长期架构原则、字段合同。

3. 数据接口与来源

路径：数据接口与来源/

用途：说明 DemandAgent、平台、外部接口和数据来源如何进入 CFA。

机器可读入口：数据接口与来源/external_data_sources_registry.json，用于按外部数据源查询接入状态、环境变量名、输入输出、runtime / DB 落点和当前缺口。

不承担：Pattern 回扣全链路细节。

4. Pattern 回扣与分类树

路径：Pattern回扣与分类树/

用途：说明 PG Pattern V2 exact mode、分类树反查、CFA 发现内容回扣、前置坑和 FAQ。

不承担：普通接口总览或代码阶段计划。

5. 数据库字段总览

路径：数据库字段总览/

用途：统一登记 DB 表、字段、runtime 文件、raw payload、字段晋升规则和 registry 校验。

6. 命名规范

路径：命名规范/

用途：统一标准名、禁用旧词、允许例外和命名检查规则。

权威来源

• 字段命名以 命名规范/ 为准。
• DB 表、字段、runtime 和 raw payload 以 数据库字段总览/ 为准。
• 架构原则以 架构设计/ 为准。
• 代码结构和阶段执行以 工程落地/ 为准。