Layer2 Research Digest

---
name: layer2-research-digest
description: "当用户明确询问研报内容或分析师/机构观点时——如'最近茅台有哪些研报''券商怎么看白酒''最近策略研究在关注什么'。主角是研究观点和报告共识，不是行情或新闻综述（那用 stock-brief 或 industry-brief）。"
---

Use when:
- 需要最近研报的结构化摘要
- 需要从多篇研报里提炼共同点
- 需要把研报和市场数据放在一起看
- 用户用灵感页口吻问“券商最近都在说什么”“机构怎么看这个行业/公司”“这些研报普通人该怎么看”
- 典型场景：
  - 上市公司简析（研报辅助）
  - 行业简析（研报辅助）
  - 近期消息面意义及影响（研究视角）

Depends on:
- `layer1-doc-search`
- `layer1-fin-data`
- `layer1-same-boat`（可选，用于同舟观点 / 分析师观点补充）

Workflow:
1. 明确目标是公司研报、行业研报、策略/宏观研报，还是同舟/分析师观点。
2. 如果是公司研报，先用 `search_security` / `get_security_profile` 确认 `company` 和 `ticker`，再调用 `search_research_reports(company=..., ticker=..., time_window="1y", limit=...)`；不要把公司名只放进 `query` 再配长时间窗。
   - 港股、美股和英国市场要保留解析出的标准市场代码，并显式传 `market`、`scope="listing"`；精确上市地结果为空时只说明当前来源与窗口未命中，不得静默去掉 `ticker`。
   - 只有用户要求发行人整体覆盖时，才另行使用 `company`、`scope="issuer"` 检索，并明确标为更宽的发行人范围。如果行情身份工具未覆盖该市场，不要猜证券代码或把公司名结果冒充精确上市地结果。
3. 如果是行业研报，调用 `search_research_reports(industry=..., content_type="行业研究", time_window="3m", limit=...)`；如果是策略/宏观研究，必须传 `content_type` 或 `source_name` 并保持短窗口，不要做 query-only 长窗口泛搜。
   - 用户一次询问多个公司时，按公司/上市地拆成独立调用，不把 `A OR B`、逗号分隔公司或 ticker 列表塞进单次研报检索。
   - 做多年样本判断前可调用 `get_research_coverage`，用总数、首末日期和年度样本数说明覆盖，不用示例数字补齐空年份。
4. 搜索结果先作为候选清单展示。只有用户明确选中某篇，或一个关键结论需要更强复核时，才对所需的 `1-3` 篇调用 `get_document`；返回内容按“研报详情摘要 / 可见观点片段”使用，不代表完整研报或 PDF 全文。
5. 如果是公司研报，调用 `get_security_profile` 与 `query_data/get_latest_snapshot` 补充市场背景。
6. 如果是行业研报，可补充调用 `search_documents(doc_type="news", industry=...)` 获取近期新闻。
7. 如果用户问同舟观点、分析师观点或机构观点横向对比，可先用 `search_research_sectors` / `list_research_sectors` 获取 `sector_id`，再用 `list_market_viewpoints` / `list_sector_viewpoints`；需要详情时必须使用返回的 `viewpoint_id`，不要猜 ID。
8. 先判断主源：用户说“研报/券商/报告原文”时主源必须是 `doc-search` 的 `search_research_reports`；用户说“同舟怎么看/分析师观点/行业观点分数”时主源可以是 Same Boat 观点。不要用 Same Boat 观点替代券商研报样本。
9. 如果结构化研报或同舟观点链路不可用，要明确降级，不要假装拿到了研报或观点。
10. 如果用户要求 HTML、灵感样张或“做同款”，把结果整理成 WorkBuddy 证据包：
   - 研报样本边界：公司/行业/策略口径、时间窗口、样本数量、是否命中公司专属研报
   - 观点清单：报告标题、机构/来源、发布时间、研究对象、可跳转源头（如返回）
   - 3 个共同观点：只从样本中提炼，不把同舟观点混成券商共识
   - 主要分歧：需求、价格、成本、竞争、政策、估值或时间节奏
   - 关键假设：研报成立需要哪些前提
   - 小白解释：这些观点翻译成人话意味着什么
   - 引用限制：样本不足、窗口过短、来源不可用或只命中行业周报
11. 组织成“券商最近都在说什么”输出。

Rules:
- 不直接替代分析师做结论，只提炼可见共识和差异。
- 研报列表建议按时间倒序展示。
- 只摘短摘要，不堆长段正文。
- `get_document` 返回的是经过清洗和截断的研报详情摘要，不是完整研报、完整 PDF 或文章级源链接；不得写“已读取完整研报”“已阅读全文”。
- 详情为空或字段不全时保留标题、机构、日期等已返回元数据并说明缺口，不得用模型记忆补齐。
- 如果用户问的是“有没有公司研报”，优先保证公司维度准确，不要把行业周报误写成公司深度。
- 公司研报必须是 scoped `company`/`ticker` 检索。`INVALID_BROAD_TIME_RANGE`、`MISSING_RESEARCH_FILTERS` 或其他参数/范围错误不是“未命中研报”，应修正参数后重试；只有 scoped 检索成功且结果为空，才可说明“本次未命中公司级研报样本”。
- `MULTI_ENTITY_RESEARCH_UNSUPPORTED` 表示调用参数包含多个公司/上市地；应拆分后分别检索和标注，不能把它写成无研报。
- 海外公司精确上市地检索必须保留 `ticker`、`market` 和 `scope="listing"`；发行人范围只能通过单独且明确标注的 `scope="issuer"` 检索获得，不能作为静默回退。
- 如果当前只能拿到行业周报，要明确标注“行业研究”而不是“公司专属观点”。
- 如果研报链路报错，要明确说明“当前研报源暂不可用”，并建议改用新闻、公告和行情做临时替代。
- 同舟观点、市场要闻和结构化研报是不同来源。不要用同舟观点替代券商研报，也不要把同舟观点写成全市场机构共识。
- 如果同时引用 Doc Search 研报和 Same Boat 行业观点，输出中必须拆成“券商研报样本”和“同舟/分析师观点”，不要合并成一个共识池。
- 不直接暴露研报 chunk 原文、内部文档 `id`、排序得分或底层索引来源细节。
- 如果研报是行业周报而非个股深度，要明确标注，不要误写成“公司专属观点”。
- 如果用户是小白语境，先翻译结论，再放研报术语；不要把“景气、弹性、估值切换、预期差”直接当标题。

Suggested output template:
1. 最近有哪些研报
2. 这些研报主要在说什么
3. 是否存在明显分歧
4. 当前市场背景
5. 当前可参考度说明
6. 一句话总结

WorkBuddy HTML handoff:
1. 页面标题建议用“券商最近都在说什么：{公司/行业/主题}”
2. 首屏给样本边界、3 个共同观点和最大分歧
3. 中段固定展示“报告样本 / 共同观点 / 分歧在哪里 / 关键假设 / 普通用户怎么读”
4. 文末必须有信源复核、样本限制和非投资建议

Examples:
- `最近有哪些茅台研报`
- `帮我总结一下白酒行业最近的研报`
- `最近策略研究都在关注什么`
- `券商最近都在说 AI 算力产业链什么`