quant-buddy-view

页面研究合同（WebAgent 正式投研）

制作活页时，必须先参考用户提问的背景、关键矛盾点和潜在需求，再决定模块结构与信息层级，搜索到的背景信息要落到页面中。

• 页面开头说明“本页回答什么问题、核心矛盾是什么”，不要直接进入数据表。
• 外部背景信息必须带来源与发布日期，并与 QBS 数据分区展示；查无实据时写明缺口。
• 复杂研究页先给维度清单，标注“已有数据 / 待补采 / 缺数据”，再展开各模块。
• 搜索、分析、建模、建页形成一条链：搜索结果要转化为结论、页面模块和数据需求。
• 用户明确要求纯文字时不要建页；最终回复不超过 1200 字，不使用多级标题，不附页面链接。
• 页面构建最多重试 2 次；第 2 次验证失败后降级到最简可交付版本，保留已验证数据和结论，不得无限循环。
• 快速通道页面（new_asset_page）必须在页面末尾附两个轻量模块：「背景与关注点」（3 句以内，有可靠来源带链接与日期，无来源则如实写外部语境缺失）和「边界与风险」（1–2 句，说明不构成投资建议与主要不确定性）。

页面构建策略（两类页面，两条路径）

路径一：研究分析页 → 用 upload 路径（自由 HTML 创作）

适用于：个股分析、行业研究、深度报告、对比分析、策略研究、供需因子分析等需要叙事结构和丰富视觉的场景。

• Agent 直接用 HTML + CSS + JS 写完整页面，自由设计布局和视觉，不受面板系统约束
• 在 HTML 中嵌入 Data Grant（grant_id + signature）或 Formula Package（package_id + signature）实现实时数据绑定
• 可使用 Chart.js、ECharts 等前端库画交互式图表（折线、柱状、雷达、热力图等）
• 设计原则：
  • 首屏决策：最重要的结论和最关键的数字必须在首屏可见，大字号高亮
  • 图文交替：标题 → 结论 → 图表 → 白话解读 → 图表 → 白话解读，避免连续 5 个表格
  • 每个图表配 1–2 句"怎么读这组数据"
  • 核心数字用大字号（≥28px）+ 高亮色；辅助信息用小字号灰色
  • 320px 不留横向滚动
  • 页面开头 2 句话说明"本页回答什么问题、核心结论是什么"
• 构建流程：先用 QBS 获取并验证数据 → 在本地写完整 HTML（含数据绑定标签）→ 用 upload 上传 → publish_verified 发布

路径二：数据面板页 → 用 new_page 路径（标准面板系统）

适用于：实时看板、排行榜、监控系统、多模块数据并排展示等标准化场景。

• Agent 提供数据面板（panels），build_dashboard 统一渲染卡片/表格布局
• 适合数据模块多、更新频繁、不需要复杂叙事的场景
• compose_page 降为备选：仅在需要复用已有复杂交互组件时使用，最多 1 次

路径选择规则

• 用户要求"分析""研究""报告""对比""怎么看" → 路径一（upload）
• 用户要求"看板""监控""排行榜""实时数据" → 路径二（new_page）
• 不确定时，默认路径一（upload），因为研究分析是最常见的场景
• new_asset_page（个股快页）仍走固定快速通道，不受此规则影响

多资产对比表格格式

• 多资产对比时，表格必须用"透视格式"：指标名为行、资产名为列并排展示。
• 禁止使用 API 原始返回的长表格式（每行=标的+指标+值）；如原始数据是窄表，必须转为宽表后再渲染。
• 大额金额自动缩写为"亿元"或"万元"，保留两位小数；百分比保留两位小数带 %。
• 差异列用 +/− 前缀标明方向；末尾可选加"差异对比"列，展示两值之差。

筛选零结果降级

• 筛选结果为 0 只时，自动按预设顺序放宽非核心条件（如市值从 100 亿降至 50 亿再降至 30 亿），每次只放宽一个条件，最多 3 次。
• 放宽条件必须在页面上标注"已放宽：市值从 100 亿降至 50 亿"。
• 交付非 0 名单按综合得分排序，不按代码排序。仍为 0 则交付空结果并解释原因。

港股与美股页面最低质量标准

• 港股/美股页面必须至少包含 2 张图表（如估值走势、区间表现、财务趋势），不得只用表格交付。
• 即使 QBS 港股维度比 A 股少，也要用已有数据画图（如 PE(TTM) 近一年走势、近 20/60/250 日区间表现柱图）；数据不足时画已有部分并标注缺口。
• 港股/美股页面必须绑定至少 1 个实时数据模块（如最新行情 Data Grant），不能全部为静态快照。
• 港股/美股的图表标题和轴标签必须标注货币单位（港元/美元），不得与 A 股人民币混用。