赛马看板 × KOL 动态画像集成协同需求
本文给 Data Horizon 负责人、Trading Matrix 团队和相关 Agents 共用，目的是把"KOL 动态画像如何驱动 Trading Matrix 赛马看板"拆成可执行的跨团队任务、接口契约和验收标准。
本文承接 Data Horizon 信源候选与样本交付任务书，在其基础上聚焦动态画像与赛马看板的实时集成阶段：DH R1/R2/R3 生产部署完成后，Trading Matrix 需要什么、DH 需要提供什么、双方各自负责什么。
1. 核心结论
DH 动态画像为 TM 赛马看板提供三类持续服务：候选推荐（谁值得进入验证）、实时状态（正在赛马的 KOL 信源是否仍在活跃）、外部验证证据展示（TM 回测结果在 DH 工作台可见）。
TM 负责消费 DH 数据、运营决策、执行验证，并把验证结果通过 R3 接口写回给 DH 作为外部证据。
两条数据回路必须严格区分：
- 回路 A（R3 写回）：TM 决策结果和验证结论 → DH 反馈账本。受 DH R3 的 6 项保护机制约束，不改变 DH 画像可信度排序，由 DH 静态画像团队人工消费。
- 回路 B（TM 本地漏斗）：TM 计算的 Event 漏斗指标（信号方向准确率、端到端命中率等）完全在 TM 内部消费，不写回 DH，保持 DH 画像独立性。
2. 分工边界
| 事项 | Data Horizon 负责 | Trading Matrix 负责 |
|---|---|---|
| KOL 候选推荐 | 维护动态状态、输出候选列表接口、提供候选类型和不适合原因 | 拉取候选列表、运营决策（推进 / 观察 / 暂缓）、写回 admission 类 R3 |
| 信源实时状态 | 维护 lifecycle_status、direction_distribution、data_sufficiency 等动态字段 | 在赛马看板展示状态、触发 W3/W5 预警 |
| KOL 静态画像 | 维护策略风格、持仓偏好、决策驱动等长期特征 | 在赛马看板 Drawer 展示画像摘要、用于验证参数建议 |
| 原始 event 列表 | 暴露 KOL 原始信号 event 列表接口（见 DH-7） | 拉取后在 TM 本地计算 Event 漏斗，不回传 DH |
| 验证结果展示 | 在 DH 工作台把 R3 写回内容展示为外部证据 | 不改写 DH 的画像可信度排序 |
| 画像迭代 | 按周 / 月人工评估 R3 外部证据，决定是否迭代画像 | 提供 R3 验证结论，不主动要求 DH 更新画像 |
| signal 漏斗指标 | 不参与方向准确率计算 | TM 本地计算（使用 DH event 列表 + TM 价格库），不写回 DH |
| 回测 / 模拟 / 实盘 | 不负责 | 负责验证运行、账户、风控和结论 |
DH 的评分是"信源质量与状态评分"，TM 的评分是"策略验证表现评分"。两者必须分开，不能相互覆盖。
3. 工作包
DH-7 原始 event 列表接口
目的：让 TM 可以在本地计算单 KOL 的 Event 漏斗（信号方向准确率、端到端命中率等），而不依赖 DH 完成计算。
任务：
- 暴露 KOL 原始 event 列表能力，选型三选一：
- 新增独立接口
GET /v1/open/kol/signal-events?kol_id=X&since=T - 在现有
candidate-list接口返回中扩展signal_events字段 - DH 定期推送 event 增量给 TM（push 模式）
- 新增独立接口
- 每个 event 至少包含：
kol_id、source_id、direction（看多 / 看空 / 中性）、symbol、ts（信号发布时间） - 不要求 DH 计算方向准确率；TM 用
direction字段 + TM 本地价格库自行比对
待确认：接口形式三选一由 @DH maintainer 选型确认，期望 T+7 天内回复（对应 clabs PRD §6.3 Q-D5）。
验收标准：
- TM 可以通过接口拉取某 KOL 近 N 天的原始 event 列表
- 每个 event 有稳定
event_id、direction、symbol、ts字段 - 不要求 DH 对方向进行正确性判断
DH-8 R3 反馈账本生产就绪
目的：让 TM 可以把运营决策（admission 类）和验证结论（validation_completed 类）写回 DH。
任务：
- DB 权限成员执行迁移，在生产库创建
dn_kol_candidate_validation_feedback表- 迁移文件：
server/deploy/migrations/create_kol_candidate_validation_feedback_table.sql
- 迁移文件：
- 配置
KolCandidateValidationFeedback.ApiKey（即X-TM-Validation-Key），通过安全渠道下发给 TM - DH maintainer 完成 6 项 R3 冒烟测试：只读 / 写入 / 错误密钥 / 过期状态 / 重复写入 / 字段契约
待确认：DB 权限成员的迁移窗口 T+3 天内确认；密钥下发渠道 T+5 天内确认（对应 clabs PRD §6.3 Q-DB / Q-KEY）。
验收标准：
- 生产库中
dn_kol_candidate_validation_feedback表存在且字段与迁移文件一致 - 6 项 R3 冒烟测试全部通过
- TM 持有有效密钥可成功调用写入接口
DH-9 TM 在 DH Provider 配置中心注册
目的：让 TM 在 DH 外部能力治理框架中有正式身份，并受 DH Provider 配置中心统一管理。
任务：
- DH Provider 配置中心管理员把 TM 纳入"下游推送 / TM"和"Open API Consumer"双身份治理
- 配置 TM 的
X-API-Key额度策略，满足候选列表 5 分钟轮询频率 - 定义密钥轮换流程，确保 TM 收到 401 时有协调渠道
待确认：DH Provider 配置中心管理员确认注册流程（对应 clabs PRD §6.3 Q-KEY）。
DH-10 画像评估周期承诺
目的：让 TM 知道 R3 写回的验证结论何时会被 DH 侧评估，避免双方期望错位。
任务：
- DH 静态画像负责人给出评估周期承诺（周 / 月 / 季度）
- 明确评估结论的回写位置（是否会更新
candidate_type、lifecycle_status等字段） - 明确"TM 反馈→DH 画像迭代"的决策由 DH 人工判断，不自动触发
待确认：DH 静态画像负责人 T+7 天内确认（对应 clabs PRD §6.3 Q-EVAL）。
4. 接口契约摘要
4.1 TM 消费 DH 的接口（上行）
| 接口 | 说明 | 认证 | 当前状态 |
|---|---|---|---|
POST /v1/open/kol/dynamic-state/candidate-list | 拉取 KOL 候选列表，含动态状态和推荐等级 | X-API-Key | 已上线（R2） |
GET /v1/open/kol/profile | 拉取单 KOL 静态画像摘要 | X-API-Key | 已上线（R1） |
| event 列表接口（待定） | 拉取 KOL 原始 event 列表（DH-7 选型） | X-API-Key | 待确认 |
4.2 TM 写回 DH 的接口（下行，R3）
feedback_type | 触发时机 | validation_status | 说明 |
|---|---|---|---|
candidate_admitted | 运营点击「推进验证」 | received | 记录 TM 接入决策 |
observation_deferred | 运营点击「标记观察」 | unresolved | 附带复查时间 |
admission_deferred | 运营点击「暂不接入」 | unresolved | 必填拒绝原因 |
validation_completed | 回测/实盘验证周期结束 | pass / fail / unresolved | 附带 realized_style_drift、win_rate、sample_trade_count |
validation_completed | 推进后 60 天无结果（超时兜底） | fail | reject_reason=validation_timeout |
认证：需同时提供 X-API-Key（DH Open API Key）和 X-TM-Validation-Key（候选验证专用写入密钥）。
4.3 写回边界声明
以下 TM 内部指标不进入 R3 写回，DH 不需要处理：
- Event 漏斗 5 口径（信号方向准确率 / 信号采纳率 / 报单成功率 / 执行胜率 / 端到端命中率）
- W7 信号质量异常预警
- §4.7 画像质量面板的 TM 端评估结论
这是本方案刻意设计的边界，保持 DH 画像评估独立性。
5. 推进节奏
| 阶段 | 前置条件 | DH 交付 | TM 动作 |
|---|---|---|---|
| P1 候选管理上线 | R10 完成 + DH-8 就绪 + DH-9 完成 | 候选列表接口可用；密钥已下发；冒烟测试通过 | 候选段 + 三个操作动作 + R3 admission 写回 |
| P2 验证回流上线 | P1 稳定 + validation_completed 写回接入 | DH 接收 validation_completed，工作台展示 | 验证结果回流；漂移列；W6 预警 |
| P3 Event 漏斗上线 | DH-7 接口确认 + P1 稳定 | event 列表接口可用 | 单 KOL Event 漏斗；W7 预警；飞轮 KPI |
| P4 画像质量闭环 | P2 + 60 天数据积累 | DH 画像迭代周期承诺落地 | DH-TM 一致性面板；飞轮 KPI 稳态期 |
6. 总体验收标准
| ID | 标准 | 负责方 |
|---|---|---|
| AC-D1 | TM 可通过 candidate-list 接口获取候选，字段含 lifecycle_status、candidate_type、data_sufficiency、direction_distribution | DH |
| AC-D2 | dn_kol_candidate_validation_feedback 表在生产存在，6 项 R3 冒烟测试全部通过 | DH + DB 权限成员 |
| AC-D3 | TM 写回 admission 类和 validation_completed 类，DH 返回 accepted=true | TM + DH |
| AC-D4 | event 列表接口可用，每个 event 有 direction、symbol、ts | DH |
| AC-D5 | TM 的 realized_style_drift 未出现在 DH 画像可信度排序字段中 | DH + TM |
| AC-D6 | DH 工作台把 R3 写回内容展示为外部证据，不影响 DH 原有信源可信度列 | DH |
| AC-D7 | DH 静态画像团队可在 DH 工作台看到 validation_completed 记录，作为月度评估输入 | DH |
7. 待确认事项
以下事项尚未闭环，各方需在 PRD 评审通过后 N 天内回复：
| 编号 | 问题 | Owner | 期望回复 |
|---|---|---|---|
| Q-D5 | event 列表接口选型：新增 endpoint / 扩展 candidate-list / DH→TM 推送，三选一 | DH maintainer | T+7 天 |
| Q-DB | R3 反馈账本表的生产迁移窗口 | DB 权限成员 | T+3 天 |
| Q-KEY | X-TM-Validation-Key 通过哪种渠道下发给 TM（secret manager / 环境变量 / 配置中心） | DH Provider 配置中心管理员 | T+5 天 |
| Q-EVAL | DH 静态画像团队的评估周期（周 / 月 / 季度）及结论回写位置 | DH 静态画像负责人 | T+7 天 |
8. 参考文档
| 文档 | 位置 |
|---|---|
| TM 赛马看板 × KOL 动态画像集成 PRD v1.2 | clabs/requirement/归因追踪/赛马看板-KOL画像集成PRD.md |
| DH KOL 动态画像进展复盘（2026-06-23） | https://labs-fintecai-gov.topquant.org/review-artifacts/data-horizon/kol-dynamic-profile-progress-2026-06-23/ |
| DH Provider 配置中心方案（2026-06-22） | https://fin-tec-ai.up.railway.app/projects/data-horizon/implementation/provider-config-center-review-2026-06-22/ |
| Data Horizon 信源候选与样本交付任务书 | ./data-horizon-source-candidate-work-package.md |
| AI Trading Matrix 战略白皮书 | ../strategic-whitepaper.md |