Progress Review · Cross-team Handoff · 2026-06-25

Data Horizon - KOL 动态画像进展

这份文档给没有 Data Horizon 和 KOL 动态画像背景的人阅读:先解释为什么做,再解释静态画像和动态画像分别负责什么,最后说明 R1/R2/R3 已完成哪些生产验收、静态画像低样本补齐第一阶段已完成什么、R4 当前由 Trading Matrix 侧推进哪些任务,以及 Data Horizon 如何配合验收。

80/80启用 KOL 静态画像和摘要缺口为 0
341authenticated Open API smoke 返回候选数
8 条R4 第一批 TM 小批量验证候选
R4当前进入 Trading Matrix 小批量验证

零背景摘要

先把业务目的讲清楚,再看实现细节。

一句话

「KOL 动态画像」让团队不用逐条阅读某个 KOL 的所有原始消息,也能看懂这个 KOL 最近正在表达什么观点、使用什么交易思路、是否提到实盘操作、证据从哪里来,以及是否值得交给 Trading Matrix 验证。它不替代静态画像;静态画像说明长期基线,动态画像说明近期变化。

给团队成员看

从 Dashboard 下钻到单 KOL

看完全量 KOL 的“上帝视角”后,可以点进某个 KOL,直接看当前动态画像和证据链。

给 Dashboard 用

提供跨 KOL 汇总原料

Dashboard 需要全局聚合,但每个聚合结论都要来自单 KOL 的近期状态和证据。

给 Trading Matrix 用

支持验证、赛马和策略蒸馏

Trading Matrix 可以按 KOL 风格、策略线索、交易逻辑、标的和周期做回测、模拟和后续策略沉淀。

术语说明

文档后面尽量不用黑话;不可避免的词先在这里解释。

术语含义
KOL团队跟踪的交易员、分析师、博主或信息源。
Data HorizonFinTec AI Ecosystem 的感知层,负责采集消息、抽取结构化信息、生成证据和状态。
Trading Matrix交易验证和执行系统,负责回测、模拟、实盘前验证、赛马和策略运行。
KOL 总控室Data Horizon 里集中查看 KOL 情报的产品区域。
DashboardKOL 总控室里的全局视图,看全量 KOL 的总体趋势、机会、风险和排行。
KOL 工作台KOL 总控室里的单 KOL 视图,看一个 KOL 的长期画像、当前动态、证据链和 Trading Matrix 交接状态。
静态画像一个 KOL 的长期历史特征,例如长期关注标的、常见风格和长期策略偏好。
动态画像一个 KOL 的近期状态,例如最近观点变化、当前策略线索、操作提法、可信度、新鲜度和证据。
静态画像自动化把长期画像从人工定期分包全量跑,改成新 KOL 建档、低频复核、动态漂移触发重评和摘要读模型自动刷新。
证据链支撑结论的原始消息、抽取事件、支持证据和反向证据。
冒烟测试最小验证脚本,用来证明接口和关键保护逻辑能跑通。
反馈账本Trading Matrix 把验证结果写回 Data Horizon 时保存的独立记录表。
策略蒸馏把 KOL 的策略逻辑总结、验证、沉淀成可长期运行的策略或 Agent。
PRPull Request,代码合并请求。本文列出 PR 链接是为了让 Review 成员追溯代码讨论和合并记录。
BranchGit 分支。本文列出分支链接是为了让 Review 成员追溯每个阶段的代码范围。
CommitGit 提交。本文列出提交链接是为了让 Review 成员定位具体变更。
state_id / state_version / state_hashData Horizon 给每份 KOL 动态状态生成的身份信息。Trading Matrix 写回验证结果时必须带回这些值,防止把旧状态的验证结果写到新状态上。
feedback_idTrading Matrix 每次写回验证结果时提供的唯一编号,用来防止同一结果被重复写入或被不同内容覆盖。

产品形态和边界

KOL 动态画像不是孤立页面,而是 KOL 总控室里 KOL 工作台的一部分。

原始消息

KOL 的原始发言、转发、频道消息和来源信息。

证据事件

Data Horizon 把消息抽取成观点、方向、操作和反向证据。

动态画像

按 KOL 汇总成当前状态,供工作台和 Dashboard 使用。

候选信息

整理成 Trading Matrix 可批量读取的标准信息。

验证反馈

Trading Matrix 写回验证结果,只作为外部证据展示。

Dashboard

回答“全量 KOL 现在有什么重要机会、风险和变化”。

KOL 工作台

回答“这个 KOL 现在是什么风格、说了什么、策略和操作有什么变化”。

Trading Matrix

负责回测、模拟、实盘前验证、赛马和策略运行,不改写 Data Horizon 的原始证据可信度。

静态画像和动态画像当前机制

这部分回答团队最近讨论最多的四个问题:静态画像是否还要人工跑、是否还要维护、动态画像多久刷新、Trading Matrix 是拉取还是被推送。

问题当前事实建议口径
是否还需要像以前一样人工分包跑静态画像不建议继续把人工分包全量跑作为日常机制。当前已上线两类自动化:KolProfileSummaryRebuildJob 从已有 dn_kol_profile 重建摘要读模型;KolStaticProfileCoverageJob 为启用但无画像且样本不足的 KOL 自动补 D 级占位。它仍不会自动生成完整 A/B/C 静态画像。静态画像应继续自动化:新 KOL 建档触发完整画像生成,重要 KOL 低频复核,动态画像发现长期漂移时触发重评,并保留人工复核入口。
是否还需要维护静态画像需要。静态画像仍是长期基线,动态画像不能替代它。维护频率不应与动态画像一样高;应按 KOL 重要性、活跃度、漂移程度和 TM 验证反馈触发。
动态画像当前多久更新KolDynamicSignalRebuildJob 服务启动后立即跑一次,并由 cron 每 5 分钟跑一次;每次以最新原始消息时间为锚点,向前计算 24 小时滚动窗口。对外说明为“5 分钟级自动刷新、24 小时滚动窗口的近实时读模型”,不是全历史重算。
Trading Matrix 如何消费动态画像当前是 TM 通过 Open API 主动拉取候选包,并把验证结果写回;Data Horizon 不会在每次动态画像更新后主动推送完整候选给 TM。R4 继续使用 TM 拉取模式;后续如需自动化,可先做“有新候选可取”的通知,不直接触发执行。

R1/R2/R3 到底是什么

R1、R2、R3 是同一完整方案的三个落地阶段,不是三套不同方案。

R1

先让人看懂单 KOL 当前状态

把动态画像放进 KOL 工作台,让团队成员可以看当前观点、策略线索、操作提法、证据和可信度。

R2

再让 Trading Matrix 批量读取候选信息

把“给人看的画像”整理成“给系统读的标准字段”,用于回测、模拟、赛马和后续策略蒸馏。

R3

最后接收 Trading Matrix 验证结果

Trading Matrix 把验证结果写回 Data Horizon,工作台展示为外部证据,但不改变 Data Horizon 的可信度和排序。

三个阶段合起来是什么

R1 + R2 + R3 构成“Data Horizon 感知和画像 → Trading Matrix 验证 → Data Horizon 展示外部验证结果”的闭环。

R1:KOL 工作台动态画像

目的:先解决团队成员能不能看懂一个 KOL 的当前状态。

解决的问题

  • 团队不想逐条读原始消息。
  • 静态画像只能说明长期特征,不能说明最近变化。
  • Dashboard 需要能下钻到单 KOL。

完成内容

  • 在 KOL 工作台加入动态画像展示。
  • 将长期画像、近期动态、证据链、Trading Matrix 状态分区展示。
  • 明确 R1 不承诺对外机器接口。
类型链接
BranchDH-WP-002/kol-dynamic-profile-r1
PR无独立 PR,分支已推送。
Closeout commit8327b272 Close KOL dynamic profile R1 loop

R2:Trading Matrix 候选信息交接

目的:让 Trading Matrix 可以用机器方式读取 KOL 动态画像形成的候选信息。

解决的问题

  • Trading Matrix 需要按风格、策略线索、标的、周期和证据质量分批验证。
  • Data Horizon 需要把给人看的画像整理成给系统读的标准字段。
  • 后续策略蒸馏需要可追溯候选种子。

完成内容

  • 新增候选列表接口:POST /v1/open/kol/dynamic-state/candidate-list。
  • 输出 KOL 风格、近期动态、证据、候选类型和策略种子。
  • 明确候选信息不是已验证策略资产。
类型链接
BranchDH-WP-002/kol-dynamic-profile-r2
PR无独立 PR,分支已推送。
Key commits d6933d8c, 059c7203, 09fe3a8c, aa5c0b42, 3214b981

R3:Trading Matrix 验证结果写回

目的:让 Trading Matrix 把验证结果写回 Data Horizon,并在 KOL 工作台展示为外部证据。

解决的问题

  • Trading Matrix 做完验证后,需要把结果和 Data Horizon 的候选信息对上。
  • Data Horizon 需要记录验证结果供团队查看。
  • 必须防止 Trading Matrix 的盈亏结果直接改变 Data Horizon 的可信度。

完成内容

  • 新增反馈账本表:dn_kol_candidate_validation_feedback。
  • 新增写入接口:POST /v1/open/kol/candidate-validation/feedback。
  • 接入 Open API Key 权限控制、过期状态保护和重复写入保护。

后续是否还有 R4/R5

有后续路线。R3 已通过生产读写冒烟后,可以进入受控小批量验证,但不能直接扩大到全量自动执行。

阶段目标前置条件
R3 验收闭环把 R3 从“代码已部署”推进到“Trading Matrix 可以可靠消费”。生产表、Open API 权限、只读/写入冒烟测试和 Woods 工作台人工回归均已通过。
R4:Trading Matrix 小批量验证选择少量 KOL 和候选信息,进入回测、模拟、实盘前验证和赛马。当前阶段:8 条 pilot candidates 已选出,Trading Matrix 需要接入读取、验证、写回和集成测试。
R5:策略蒸馏和策略资产化把验证通过的 KOL 方法沉淀为可长期运行的策略或 Agent。R4 有稳定样本,验证结果可解释,责任边界经过 Review。

当前状态

核心代码已经推进到 R3;生产动态画像基础数据可读;静态画像低样本补齐第一阶段已部署;R3 写回账本已创建,且生产读写冒烟测试已通过。

项目状态证据解释
代码主线已推送Data Horizon main 和 R3 分支已推送;R3 PR #8 已合并R3 Open API 命名、权限和 smoke 脚本已同步。
静态画像机制第一阶段已上线启用 KOL 80 个,dn_kol_profile 80 条,dn_kol_profile_summary 80 条,缺画像和缺摘要均为 0当前解决低样本 D 级占位和摘要覆盖;完整 A/B/C 静态画像自动生成仍是第二阶段。
动态画像基础数据生产有数据dn_kol_dynamic_state 363 条状态;dn_kol_signal_event 3118 条事件;dn_kol_intelligence_snapshot 2809 条快照每个 KOL 的近期状态数据在生产中持续产生;当前快照没有真实 action 候选。
候选读取接口已通过2026-06-25 authenticated smoke 返回候选总数 341,并输出 OK: read-only R3 contract smoke passedTrading Matrix 可以读取 R3 候选包。
反馈写入接口已通过POST /v1/open/kol/candidate-validation/feedback 返回 accepted=trueTrading Matrix 验证结果可以写回 Data Horizon。
反馈账本已创建并写入dn_kol_candidate_validation_feedback.id=1,backtest_window=smoke这条 smoke 记录是链路验收证据,不是正式回测结论。
R4 pilot batch已选出8 条候选,覆盖 7 个 KOL、7 个明确标的、4 条风险候选和 4 条观察候选Trading Matrix 可以从这批样本开始,不需要先做全量 KOL 自动验证。

生产验收证据

R3 现在的核心问题不再是 DB 阻塞,而是把已通过的生产证据沉淀给团队和 Trading Matrix。

R3 生产读写链路已跑通

Data Horizon 使用 Open API Key 保护 /v1/open/* 接口。KOL 候选读取和 Trading Matrix 验证反馈写入均已通过生产冒烟测试。

2026-06-25 post-deploy 复核

静态画像覆盖已经补齐当前启用 KOL:启用 KOL 80 个,静态画像 80 条,画像摘要 80 条,缺画像和缺摘要均为 0。动态画像仍在持续刷新:dn_kol_dynamic_state 363 条,dn_kol_signal_event 3118 条,dn_kol_intelligence_snapshot 2809 条。使用 macOS Keychain 中的 approved Open API Key 复跑 authenticated read-only smoke,候选总数 341,并输出 OK: read-only R3 contract smoke passed。

80/80

静态画像覆盖

当前启用 KOL 的画像和摘要缺口均为 0;低样本账号自动补 D 级占位。

363

动态状态

dn_kol_dynamic_state 最新更新时间为 2026-06-25 12:48:20。

341

候选读取

authenticated Open API smoke 返回候选总数 341,R3 合同仍可用。

Smoke target:
KOL_ID=32
KOL 名称=Woods
candidate_id=ksc_83dbedada2c04ba3e185dc01ab4649b1aa45217b915c2ff0
state_id=kds_dcb91d0e3eb699f4cf55e05180a98ed2af8d5d1470aedd5a
symbol_bucket=BTC
lifecycle_status=conflicted
candidate_status=observe_only

Inserted feedback:
feedback_id=tm_r3_smoke_ksc_83dbedada2c04ba3e185dc01ab4649b1aa45217b915c2ff0_1782224595
validation_status=received
feedback_type=candidate_backtest_result
backtest_window=smoke
created_at=2026-06-23 22:23:16
1

表已存在

dn_kol_candidate_validation_feedback 已创建,索引齐全。

2

读写已通过

候选读取和验证反馈写入均通过线上 smoke。

3

工作台已回归

Woods 工作台已人工回归,R3 smoke 反馈按外部验证证据展示。

Trading Matrix 侧 R4 任务

R4 的主任务已经从 Data Horizon 后端开发转为 Trading Matrix 小批量验证。Data Horizon 负责提供接口、样本、字段解释、展示复核和问题协查;Trading Matrix 负责读取候选、执行验证、写回结果和形成是否进入 R5 的判断。

R4 的目标

证明 Trading Matrix 能稳定读取 Data Horizon 的 KOL 动态画像候选,保留身份字段,完成少量受控验证,写回人和系统都能理解的反馈。R4 不证明某个 KOL 策略已经可盈利,也不进入实盘。

R4 做什么

  • 读取候选列表接口。
  • 保存候选身份字段。
  • 对 8 条 pilot candidates 运行受控验证。
  • 写回真实非 smoke 反馈。
  • 补充过期状态、重复反馈和重试测试。
  • 和 Data Horizon 一起复核工作台展示。

R4 不做什么

  • 不做全量 KOL 自动赛马。
  • 不做实盘执行。
  • 不把策略种子直接升级为策略资产。
  • 不让 Trading Matrix 指标改写 Data Horizon 可信度、生命周期或排序。
  • 不用 R3 smoke 记录当真实验证结论。
顺序任务Owner通过标准
1接入候选读取接口Trading Matrix能用 approved Open API Key 读取候选列表,并识别 candidate_contract_version。
2持久化候选身份字段Trading Matrix完整保存 candidate_id、state_id、state_version、state_hash、kol_id、symbol_bucket。
3建立小批量验证 runnerTrading Matrix能对每条 pilot candidate 生成一个验证结果;不要求盈利,只要求结果可解释。
4写回非 smoke 验证反馈Trading Matrix正式反馈使用 tm_run_id 前缀 tm_r4_pilot_,并调用写入接口。
5补充集成测试Trading Matrix覆盖缺失/错误 Key、过期状态、重复 feedback_id 和网络重试。
6给出每条候选的验证解释Trading Matrixvalidation_result_summary 说明 TM 学到了什么,不能只写指标数字。
7复核工作台展示Data Horizon + Trading Matrix反馈只显示为外部验证证据,不显示为已可实盘或已成为策略资产。
8输出 R4 验收记录Data Horizon + Trading Matrix记录候选、运行编号、反馈编号、通过/未通过原因和是否进入 R5 的判断。

R4 第一批候选样本

这批样本来自生产只读快照,覆盖 7 个 KOL、7 个明确标的、4 条风险候选和 4 条观察候选。当前生产快照没有真实 action 候选,因此不应伪造 action 样本。

#KOLKOL ID标的类型状态证据数为什么选它
1所长11BTCriskconflicted4BTC 日内冲突样本,适合验证风险路径。
2Johnny24SOLriskconflicted10SOL 高证据风险样本,避免只测 BTC。
3Muzzagin29BTCriskconflicted22高冲突跨市场样本,适合验证分歧处理。
4Woods32ZECriskconflicted6复用 Woods 上下文,但不使用之前 BTC smoke 候选。
5P总47ETHobserveactive15ETH 高证据观察样本,验证正常消费路径。
6美股研究社55MSFTobserveactive2美股个股样本,验证非加密标的处理。
7美股投资网58SPYobserveactive2美股指数和宏观样本,验证周期和宏观范围处理。
8985学长71GOLDobserveactive3黄金样本,验证商品类标的处理。

R4 通过条件

Trading Matrix 能读取这 8 条候选,稳定保存身份字段,写回真实非 smoke 反馈或明确未完成原因;过期状态、重复反馈和网络重试有测试记录;Data Horizon 工作台展示仍保持“外部验证证据”边界;最后形成是否进入 R5 策略蒸馏的 go/no-go 判断。

各角色需要准备什么

这部分可以直接分发给对应成员或他们的 AI Agent。

静态画像负责人

  • 确认长期静态画像和近期动态画像的解释边界。
  • 参与定义新 KOL 建档、低频复核、漂移触发重评规则。
  • 提供 3-5 个典型 KOL 样本。
  • 检查风格、策略、交易逻辑等词是否可读。

Data Horizon maintainer

  • 维护 R3 验收记录。
  • 把 R4 计划和候选样本同步给 TM。
  • 启动静态画像自动化设计,但不要和 R4 TM 验收混成同一条件。
  • R4 真实反馈写回后复核工作台展示。

Trading Matrix

  • 从 8 条 pilot candidates 开始。
  • 读取候选列表并保存身份字段。
  • 跑受控验证并写回非 smoke 反馈。
  • 把策略种子当成待验证候选,不当成已验证资产。

DB 权限成员

  • 生产表已完成。
  • 配合复核表结构和索引。
  • 如团队要求清理 smoke 记录,按明确 feedback_id 删除。
  • 不暴露密钥。

验收路径

R3 可靠消费需要最小证据链,不只是代码已部署。

只读冒烟测试

DH_API_KEY="$(security find-generic-password -a "$USER" -s data-horizon-dh-api-key -w)" \
OPEN_API_BASE="https://dh-api.topquant.org" \
bash server/scripts/test_kol_dynamic_profile_r3_open_api.sh

2026-06-25 通过:候选总数 341,候选列表结构符合 Trading Matrix 读取要求。

写入冒烟测试

export DH_API_KEY='[redacted]'
export OPEN_API_BASE='https://...'
export KOL_ID=32
export SYMBOL_BUCKET=BTC
export LIFECYCLE_STATUS=conflicted
export DH_OPEN_API_WRITE_SMOKE=1
export ALLOW_NON_LOCAL_WRITE_SMOKE=1
bash server/scripts/test_kol_dynamic_profile_r3_open_api.sh

只能用于 staging 或生产预留测试对象。

必须通过的检查说明当前状态
反馈账本表存在生产有 dn_kol_candidate_validation_feedback已通过
只读冒烟测试候选列表能被读取和解析已通过;2026-06-25 返回 total=341
写入冒烟测试Trading Matrix 验证结果能写回已通过
错误密钥保护错误 X-API-Key 被 Open API 权限拒绝已通过
过期状态保护旧状态不会被写入DH 自动化覆盖;待 TM 集成复测
重复写入保护同内容幂等接受,不同内容拒绝DH 自动化覆盖;待 TM 集成复测
工作台展示验证结果只作为外部证据Woods 人工回归已通过;R4 真实反馈后再复核

Machine-readable Review Payload

供团队成员的 AI Agent 抽取当前状态和下一步动作。

{
  "title": "Data Horizon - KOL 动态画像进展",
  "audience": ["Data Horizon static profile owner", "Trading Matrix owner", "DB permission member", "review agents"],
  "purpose": [
    "single-KOL workbench consumption",
    "all-KOL dashboard snapshot support",
    "Trading Matrix validation and future strategy distillation",
    "static profile baseline automation"
  ],
  "phases": {
    "R1": {
      "goal": "Human-readable single-KOL dynamic profile in KOL Workbench",
      "branch": "https://github.com/Curvature-Lab/data-horizon/tree/DH-WP-002/kol-dynamic-profile-r1",
      "pr": null,
      "closeout_commit": "https://github.com/Curvature-Lab/data-horizon/commit/8327b272"
    },
    "R2": {
      "goal": "Candidate package for Trading Matrix systems",
      "branch": "https://github.com/Curvature-Lab/data-horizon/tree/DH-WP-002/kol-dynamic-profile-r2",
      "pr": null,
      "closeout_commit": "https://github.com/Curvature-Lab/data-horizon/commit/3214b981"
    },
    "R3": {
      "goal": "Trading Matrix validation feedback ledger and Workbench display",
      "branch": "https://github.com/Curvature-Lab/data-horizon/tree/DH-WP-002/kol-dynamic-profile-r3",
      "pr": "https://github.com/Curvature-Lab/data-horizon/pull/8",
      "current_commit": "https://github.com/Curvature-Lab/data-horizon/commit/9859843199ee8c5170854ead2d7f06bc81167187"
    },
    "R4": {
      "goal": "Trading Matrix small-batch validation over selected candidates",
      "owner": "Trading Matrix with Data Horizon support",
      "status": "pilot candidates selected; TM integration and real feedback pending"
    },
    "R5": {
      "goal": "Strategy distillation and strategy assetization after R4 evidence is sufficient",
      "owner": "Trading Matrix / FinBayes with Data Horizon evidence support",
      "status": "not started"
    }
  },
  "current_blocker": null,
  "static_profile_automation": {
    "current_state": "Phase 1 is deployed: enabled KOLs have full profile and summary coverage through summary rebuild plus deterministic D-tier placeholders for low-sample accounts. Full A/B/C profile generation is not yet automated as a scheduled pipeline.",
    "production_check_2026_06_25": {
      "enabled_kols": 80,
      "profile_rows": 80,
      "summary_rows": 80,
      "enabled_without_profile": 0,
      "enabled_without_summary": 0
    },
    "recommended_model": "new KOL onboarding, low-frequency review, dynamic drift triggered reprofile, full profile generation audit, manual review entry"
  },
  "r3_production_acceptance": {
    "read_smoke": "passed",
    "read_smoke_2026_06_25": "passed with total=341 using approved Open API Key from macOS Keychain",
    "write_smoke": "passed",
    "workbench_manual_regression": "passed on Woods",
    "feedback_table": "dn_kol_candidate_validation_feedback",
    "smoke_feedback_id": "tm_r3_smoke_ksc_83dbedada2c04ba3e185dc01ab4649b1aa45217b915c2ff0_1782224595",
    "smoke_kol_id": 32,
    "smoke_candidate_id": "ksc_83dbedada2c04ba3e185dc01ab4649b1aa45217b915c2ff0"
  },
  "dynamic_profile_production_check_2026_06_25": {
    "dynamic_state_rows": 363,
    "signal_event_rows": 3118,
    "intelligence_snapshot_rows": 2809,
    "latest_dynamic_state_update": "2026-06-25 12:48:20",
    "latest_signal_event_published_at": "2026-06-25 12:35:22",
    "latest_snapshot_generated_at": "2026-06-25 12:53:30"
  },
  "r4_tm_side_tasks": [
    "Integrate candidate-list read endpoint",
    "Persist candidate identity fields exactly",
    "Run controlled validation on the 8 pilot candidates",
    "Write real non-smoke feedback with tm_run_id prefix tm_r4_pilot_",
    "Add TM integration tests for auth, stale state, duplicate feedback, and retry behavior",
    "Write human-readable validation_result_summary for each candidate",
    "Review Data Horizon Workbench display after real feedback",
    "Produce R4 acceptance record and R5 go/no-go decision"
  ],
  "r4_pilot_batch": {
    "candidate_count": 8,
    "kol_count": 7,
    "symbols": ["BTC", "SOL", "ZEC", "ETH", "MSFT", "SPY", "GOLD"],
    "candidate_types": {"risk": 4, "observe": 4, "action": 0},
    "source": "docs/superpowers/specs/2026-06-23-kol-dynamic-profile-r4-pilot-candidates.md"
  },
  "remaining_closeout": [
    "Trading Matrix small-batch client integration",
    "TM duplicate and stale-state integration tests",
    "Real non-smoke TM feedback writeback",
    "Data Horizon Workbench review after real TM feedback",
    "R4 acceptance record",
    "decision whether to retain or delete smoke ledger row"
  ]
}