DH-WP-002 KOL总控室需求文档
1. 背景
Data Horizon 第一阶段已经形成一批 KOL 静态画像，团队可以查看每个 KOL 的长期风格、交易逻辑、市场覆盖、标的偏好和画像报告。下一步需要把这些画像组织成一个可日常使用的后台工作区，让团队不必逐个打开 KOL，也能快速判断当前 KOL 群体正在关注什么、观点如何分布、哪些标的和策略值得优先跟进。
KOL总控室 是 Data Horizon 管理后台面向运营、研究和交易协同团队的一级模块。它把 KOL 画像、观点、策略、标的、情绪、证据质量和观察动作组织成一个连续工作流：先看群体级情报，再下钻到 KOL 子集，最后阅读单个 KOL 的画像详情和证据。
2. 当前数据基线
当前需求基于 Data Horizon 线上生产数据核验形成。Release 1 以已经可用的静态画像和原始消息覆盖作为交付基础，动态观点、实时信号和 Trading Matrix 反馈在后续 Release 接入。
| 数据对象 | 当前用途 |
|---|---|
dn_kol | KOL 基础记录和全量列表基础。 |
dn_kol_profile | 第一阶段静态画像、简介报告、完整报告和画像维度。 |
dn_raw_news | KOL 原始消息和最近活跃时间来源。 |
dn_kol_profile_summary | Release 1 新增画像摘要读模型，服务 Dashboard 聚合、工作台筛选、排序和表格摘要。 |
dn_kol_signal_event | 后续接入实时观点、策略、操作、情绪和持仓事件。 |
dn_kol_dynamic_state | 后续接入 KOL 当前动态状态。 |
dn_kol_validation_feedback | 后续接入 Trading Matrix 回测、模拟和实盘反馈。 |
Release 1 页面需要清楚表达当前数据状态：静态画像可用，动态观点和实时信号正在接入。界面显示的群体总结必须来自后端读模型或聚合接口，前端只负责渲染和交互。
3. 用户与任务
核心用户包括 Data Horizon 运营成员、研究团队、交易协同团队和后续 Trading Matrix 验证团队。
主要任务：
| 任务 | 用户问题 | 系统能力 |
|---|---|---|
| 群体判断 | 当前这批 KOL 整体怎么看市场？ | Dashboard 展示群体摘要、共识、分歧、热点标的、策略倾向和数据质量。 |
| 快速定位 | 哪些 KOL 讨论某个市场、标的、策略或方向？ | Dashboard 指标点击进入 KOL工作台，并自动带入筛选上下文。 |
| 全量扫描 | 上百位 KOL 当前状态如何快速浏览？ | KOL工作台提供高密度表格、服务端分页、筛选、排序和搜索。 |
| 个体理解 | 某个 KOL 长期风格和当前摘要是什么？ | 点击 KOL 名称或画像按钮打开画像详情，展示简介报告、完整报告和维度表。 |
| 团队跟进 | 哪些 KOL 需要持续观察？ | 观察清单记录用户关注对象和来源上下文。 |
| 后续验证 | 哪些观点可以进入 TM 回测、模拟或实盘验证？ | 后续把动态状态、证据事件和 TM 反馈接入同一工作台。 |
4. 信息架构
Data Horizon 后台新增一级模块：
KOL总控室
一级模块下包含两个二级页面：
| 页面 | 角色 | 默认入口 |
|---|---|---|
Dashboard / KOL情报中心 | 群体级情报大屏，负责展示当前 KOL 群体的汇总判断。 | 点击 KOL总控室 默认进入。 |
KOL工作台 | 个体级工作界面，负责全量 KOL 浏览、筛选、排序、画像详情和观察动作。 | 从 Dashboard 下钻或二级 Tab 进入。 |
KOL画像 作为 KOL工作台的详情能力存在。用户在 KOL工作台点击 KOL 名称或画像按钮时，打开画像详情层，继续读取现有画像能力中的简介报告、完整报告和维度内容。
5. Dashboard 需求
Dashboard 的核心目标是让团队在一个界面里看到当前 KOL 群体的高密度情报总结。
首屏应包含：
| 区域 | 内容 |
|---|---|
| 状态栏 | KOL 总数、已画像数、画像覆盖率、画像批次、最新原始消息时间、动态接入状态。 |
| 群体摘要 | 当前市场一句话总结、主要共识、主要分歧、风险提示和样本量。 |
| 方向与标的 | 多空 / 中性 / 观望分布，热门标的，市场与资产类别分布。 |
| 策略与周期 | 策略风格、持仓周期、短线 / 日内 / 波段 / 中长期分布。 |
| 情绪与质量 | KOL 情绪、社区情绪、数据覆盖、新鲜度、证据质量、需复核状态。 |
| 优先关注 | 按评级、画像完整度、新鲜度、风险或命中原因排序的 KOL 队列。 |
Dashboard 中的数字、标的、策略、方向、KOL 队列项都应能生成 FilterContext。前端将该上下文写入 URL query，并进入 KOL工作台。
示例：
| Dashboard 点击项 | 进入工作台后的筛选 |
|---|---|
BTC / 偏多 / 22 位 | symbols=BTC、direction=long |
高频交易 / 15 位 | strategyStyles=high_frequency |
画像完整 / 59 位 | profileStatus=profiled |
需复核 / 8 位 | dataQuality=needs_review |
6. KOL工作台需求
KOL工作台承载全量 KOL 的列表浏览、筛选、排序、比较和画像阅读。它需要支持上百位 KOL，并为未来更多 KOL 和公开讨论社群保留扩展空间。
6.1 筛选与搜索
常用筛选默认展示在页面上方，两行内完成：
- KOL 名称
- 角色
- 评级
- 活跃度
- 持仓周期
- 资产类别
- 交易市场
- 方向
- 标的
- 画像状态
- 动态接入状态
高级筛选以折叠区呈现：
- 风险偏好
- 策略风格
- 决策驱动
- 语言区域
- 来源类型
- 新鲜度
- 证据质量
从 Dashboard 进入时，工作台顶部显示来源上下文，例如 来自 KOL情报中心：热点标的 BTC + 偏多。用户可以清除单个筛选条件，也可以清除来源上下文回到全量列表。
6.2 表格字段
默认分页 50 行，可切换 20 / 50 / 100。左侧固定 KOL 列，右侧固定 操作 列。
| 字段 | 说明 |
|---|---|
| ID | KOL 主键或序号。 |
| KOL | 名称、来源或组织信息。 |
| 角色 | 职业交易员、职业分析师、社群、混合型等。 |
| 评级 | 当前画像评级。 |
| 活跃度 | 高频、中频、低频或动态接入后的近期活跃。 |
| 持仓周期 | 短线、日内、波段、中长期、混合。 |
| 风险偏好 | 稳健、中性、激进等。 |
| 资产类别 | 加密、美股、A 股、期货、跨市场等。 |
| 交易市场 | 现货、合约、期权、组合等。 |
| 一句话画像 | 从静态画像提炼的高密度摘要。 |
| 当前观点 / 策略 / 标的 | Release 1 显示静态画像摘要和接入状态；后续接入动态状态。 |
| 新鲜度 | 画像批次或动态消息时间。 |
| 证据质量 | 样本量、证据状态、需复核提示。 |
| 操作 | 画像、加入观察清单。 |
表格支持服务端分页、筛选和排序。一句话画像 两行截断，可通过详情层继续阅读。标的、策略和方向以可点击 token 呈现，点击后形成二次筛选。
6.3 画像详情
点击 KOL 名称或 画像 按钮打开画像详情。详情层优先使用宽弹窗，也可以在大屏下使用右侧详情面板，但必须保证报告阅读宽度和信息密度。
画像详情包含：
| 区块 | 内容 |
|---|---|
| 标题 | 画像详情 - {KOL名称}，展示画像状态和更新时间。 |
| 简介报告 | 概要高亮、元信息标签、画像维度表、决策心智。 |
| 完整报告 | 现有 report_md 的 Markdown 报告正文。 |
| 本次命中原因 | 从 Dashboard 或筛选上下文进入时展示命中标的、方向、策略、证据数和来源模块。 |
| 证据片段 | Release 1 展示画像证据摘要；动态事件上线后展示消息级证据。 |
画像维度表至少包含：活跃度、持仓周期、资产类别、交易市场、决策驱动、交易方法、风险偏好、擅长标的、表达形式、结构完整度。
7. 后端能力需求
后端需要为前端提供稳定的读模型和聚合接口。
Release 1 能力：
| 能力 | 说明 |
|---|---|
| 画像摘要解析 | 从 dn_kol_profile.profile_json 和 report_md 生成结构化摘要。 |
| Dashboard 聚合 | 基于 KOL、静态画像、画像摘要和原始消息时间生成群体情报。 |
| Workbench 查询 | 支持分页、排序、筛选、facet count 和来源上下文。 |
| 画像详情 | 返回简介报告、完整报告、维度表和命中原因。 |
| 观察清单 | 支持用户级 KOL 关注列表。 |
| 数据状态 | 对动态接入中、画像缺失、证据不足、数据过期等状态给出明确字段。 |
后续能力：
| 能力 | 说明 |
|---|---|
| 实时事件抽取 | 从原始消息中抽取观点、策略、操作、情绪、持仓和置信度。 |
| 动态状态聚合 | 把事件折叠为 KOL 在某市场 / 标的 / 周期下的当前状态。 |
| 证据链服务 | 串联 Dashboard 结论、KOL 状态、事件和原始消息。 |
| 情报模块注册 | 后端持续新增数据挖掘模块，前端按模块 manifest 渲染 Widget。 |
| TM 反馈协同 | 接入回测、模拟、实盘反馈，形成验证闭环。 |
8. 前端需求
前端需要复用 Data Horizon 当前后台体系，包括现有路由、权限、主题、Ant Design Vue、VxeGrid 和全局 token。
核心要求：
KOL总控室作为一级菜单。- 默认进入 Dashboard。
- Dashboard 和 KOL工作台共享同一筛选上下文语言。
- URL query 作为页面状态真相源，支持刷新恢复和分享。
- KOL工作台支持 100+ KOL 的高密度列表。
- 画像详情保留现有
KOL画像弹窗的信息密度。 - light / dark 模式完整可读。
- 加载、空结果、错误、数据过期、样本不足和接入中状态都有明确表达。
9. 验收标准
Release 1 验收：
- 点击
KOL总控室默认进入 Dashboard。 - Dashboard 显示 KOL 总数、已画像数、画像批次、动态接入状态和群体级摘要。
- Dashboard 任一聚合项可进入 KOL工作台，并带入可见的来源上下文。
- KOL工作台显示全量 KOL，支持分页、筛选、排序和搜索。
- 点击 KOL 名称或画像按钮可打开画像详情。
- 画像详情完整展示简介报告、完整报告和画像维度表。
- 动态状态未上线时，页面用
接入中等状态表达数据边界。 - light / dark 模式下，表格、标签、弹窗、图表和状态组件均可读。
Release 2 验收：
- 实时观点、策略、操作、情绪和持仓事件进入 Dashboard 与工作台。
- Dashboard 聚合结论可以追溯到 KOL、事件和原始消息。
- Widget manifest 支持后端持续注册新情报模块。
- Trading Matrix 反馈可以作为 KOL 信号质量和验证结果进入工作台。