# 模块业务契约

## 1. 模块一：证据收集 Harness

### 原理

负责完整接收和保存每天变化的事实，不负责判断最终需求。不同维度保持正交，缺失、冲突和迟到数据都有明确语义。

### 输入

- 内外部需求词和原始表达；
- 外部热度、平台持续热度、去年同期热度、近期热度；
- 上游提供的关联关系；
- 内容、视频和语言证据；
- 真实 ROV/VOV 等后验反馈；
- 人和寻找 Agent 的反馈；
- 数据质量、样本量和统计周期信息。

### 处理规则

- 原始数据只追加、不改写；
- 没有数据不等于数值为零；
- 冲突数据全部保留；
- 只保存上游明确给出的关系语义；
- 重复可以标记，但保留每个来源和出现次数；
- 迟到数据形成更正版本；
- 后验首先关联具体内容和需求，再参与汇总。

### 输出

每日证据包。每条证据拥有可引用标识、来源、时间、维度、原值、质量状态和关联对象。

### 你定义

来源清单、维度字典、有效周期、样本要求、反馈类型和质量报警原则。

### 系统执行

采集、格式统一、去重标记、质量检查、来源记录、快照封存和异常隔离。

## 2. 模块二：需求认知与智能汇总 Harness

### 原理

将零散表达组织为可搜索、可执行的平台需求，同时完整保留原始表达和判断过程。

### 三层对象

```text
原始需求表达 → 标准需求词 → 平台需求
```

- 原始表达保留上游原文。
- 标准需求词统一别名和同义表达。
- 平台需求形成面向内容寻找的业务意图。

### 处理规则

- 识别别名、重复、歧义和同义表达；
- 依据数据决定合并或拆分；
- 平台需求可以宽泛，例如“战争”，只要能够在外部平台搜索并具有内容意义；
- “表象、转发”等没有独立内容意图的词不成为正式需求；
- 需求可挂靠一个或多个分类节点；
- 全局树保持父子骨架，横向关系形成图；
- 上游关联保持原样；
- 新增语义关系标注为推断关系，并附 reason 和置信度；
- 推断关系不能单独证明需求成立。

### 输出

每条平台需求包含稳定 ID、当日版本、名称、说明、层级、多条挂靠路径、原始词、搜索扩展、关系、证据、reason、认知置信度和跨日变化。

### 你定义

需求定义、层级含义、合并拆分、多挂靠、关系类型、reason 要求和人工复核边界。

### 系统执行

候选识别、别名统一、合并拆分、多点挂树、关系解释、reason 生成、版本比较和冲突标记。

## 3. 模块三：需求评估与供给分配 Harness

### 原理

评估模块只决定需求当日如何被使用，不删除需求事实和历史。

### 两个核心结果

#### 需求成立度，0～1

回答“这个需求本身有多大概率真实成立”。依据先验信号、来源覆盖、数据一致性、后验验证、跨日稳定性、数据质量和风险。

#### 局部供给优先级，0～1

回答“它在所属主题或树分支中，今天应该获得多少寻找和供给资源”。依据局部冷热、近期变化、供需缺口、已有供给、周期窗口和探索价值。

### 指标规则

- 四项先验和真实 ROV/VOV 分别保留；
- 所有面向人的展示分数归一化到 0～1；
- 无后验不按后验为零处理；
- 后验经过内容质量、曝光、时间、供给量和样本量归因；
- 关系推断只提供低权重增益；
- 综合判断可展开到每项贡献、扣减和 reason；
- 全局冷不等于没有局部供给价值。

### 五类行动层

| 行动层 | 业务含义 | 当日处理 |
|---|---|---|
| 保供 | 已验证且持续成立 | 必须保留并持续寻找内容 |
| 优先 | 当前机会明确 | 重点下发给两个下游 |
| 定向验证 | 可能成立但缺少关键证据 | 下发明确验证任务 |
| 探索 | 低分、新需求或冷区机会 | 按分支和配额随机保留 |
| 抑制 | 持续不支持或明显过供 | 暂停主动供给，保留并等待再激活 |

探索按树分支、新老需求、数据来源、有无后验、冷热区域和需求粒度分层抽样，避免大分支垄断探索额度。

### 你定义

评价维度、后验有效条件、行动层原则、主题额度、探索比例、风险和时间衰减原则。

### 系统执行

每日全量评价、表现归因、跨日稳定处理、行动分层、探索抽样和变化 reason。

## 4. 模块四：发布、可视化与反馈入口 Harness

### 原理

把当日决策变成两个下游可执行、可理解、可反馈的业务产品，而不是只展示一张热力图。

### 标准输出

唯一的每日需求任务包，包含需求 ID、版本、自然语言解释、层级、全部挂靠路径、关系、成立度、局部优先级、行动层、搜索要求、证据、评分过程、已有内容、真实表现、待验证问题和反馈动作。

### 寻找 Agent 视图

明确寻找什么、用什么词、去哪里找、排除什么、什么算命中、验证什么，以及结果关联哪个需求。

### 人的视图

说明需求是什么、为什么值得关注、全局与局部位置、挂靠路径、支持与反对证据、行动层原因、已有内容和证据缺口。

### 可视化尺度

1. 全局冷热图：完整展示热区和冷区，保留树层级。
2. 局部分支下钻：保持祖先路径与子树结构，观察分支内部冷热。
3. 单条需求路径：展示全部挂靠点、父节点、祖先和横向关系。
4. 决策解释：展示证据、认知、评分、行动和下游任务的完整过程。

颜色主要表达 0～1 的局部供给优先级；面积表达需求或证据规模，不能同时混用为热度。

### 你定义

两个下游的发布范围、主题额度、主展示指标、reason 深度、反馈权限和异常提示。

### 系统执行

生成任务包、双下游视图、热力图、需求路径、决策解释和反馈事件。

## 5. 横向模块：业务协作与策略控制 Harness

### 原理

让你通过对话定义、提问、查询、分析和调整整个系统，同时保证修改受控、可预览、可追溯。

### 核心能力

- 回答“为什么 XX 是需求”；
- 回答“为什么 XX 不是需求”；
- 查询原始数据、树节点、评分过程、内容、真实表现和历史批次；
- 自动分析冷热变化、先验后验冲突、证据缺口和策略影响；
- 展示当前业务定义；
- 将自然语言修改转成结构化定义草案；
- 使用历史数据预览影响；
- 经你确认后形成新策略版本。

### 约束

- 查询默认只读；
- 无法从数据回答时明确说明证据不足；
- 临时分析不能自动变成正式规则；
- 定义修改必须确认后生效；
- 历史版本不能被覆盖；
- 保存成功、拒绝、未决和异常的全部业务过程。
