ResearchArtifact 结构化研究产物

ResearchArtifact 是报告的结构化版本，用于后续 Dashboard、个股研究页、监控中心、自选股和 Copilot 复用同一份研究结论。

目标

首版解决三个问题：

• 把报告结论沉淀为 thesis，而不是只依赖 Markdown。
• 每份结构化报告必须带 invalidation_conditions，明确什么时候需要推翻或重新评估。
• 证据项统一带 freshness 与 quality_level，让页面能展示数据新鲜度和可信度。

字段

顶层结构：

• schema_version：固定为 research-artifact-v1。
• artifact_id：稳定产物 id，优先使用 report:<source_report_id>；尚未持久化时使用 report:<stock_code>:<query_id>，避免批量分析中多个股票共享 query id 造成碰撞；无 query id 时回退为 report:<stock_code>。
• source_report_id：历史报告主键。
• source_query_id：分析任务 query id。
• created_at：报告创建时间。
• subject：标的。
• thesis：结构化观点。
• evidence：证据列表。
• invalidation_conditions：失效条件，至少一条。
• next_actions：下一步动作。
• data_quality：输入质量摘要。
• metadata：低敏扩展字段。

Thesis

thesis 包含：

• direction：bullish / bearish / neutral / unknown。
• summary：核心观点。
• confidence：由情绪分换算的置信度。
• score：原始情绪分。
• action / action_label：结构化建议动作。
• reasons：支持理由。
• risks：主要风险。

Evidence

evidence 包含：

• source_type：例如 analysis_context、news、fundamental、market_structure。
• freshness：fresh / stale / unknown。
• quality_level：good / usable / limited / poor / unknown。
• source、as_of、url、metadata 等低敏扩展字段。

首版适配器会从 analysis_context_pack_overview.blocks、新闻摘要、财报、分红和市场结构中提取证据。

Invalidation

每份 ResearchArtifact 必须包含至少一条 invalidation_conditions。

首版默认来源：

• strategy.stop_loss 生成价格失效条件。
• strategy.take_profit 生成止盈复核条件。
• 数据质量限制生成 data_quality 失效条件。
• 新闻缺失披露生成 evidence 失效条件。
• 如果没有显式条件，生成 manual:thesis_reassessment 兜底复核条件。

兼容边界

AnalysisReport 新增可选字段：

structured_report?: ResearchArtifact | null

旧报告可以继续不返回该字段；Web 类型和后端 schema 都按可选字段处理。

本 PR 只定义 schema、类型和确定性 fallback helper，尚未把 helper 接入报告持久化或历史详情返回链路；该接线作为 #2278 的后续阶段完成。

实现入口

后端：

• Schema：api/v1/schemas/research_artifact.py
• Helper：src/services/research_artifact_service.py
• 测试：tests/test_research_artifact_service.py

Web：

• 类型：apps/dsa-web/src/types/researchArtifact.ts
• AnalysisReport.structuredReport：可选消费入口

后续接入

1. 报告生成链路在持久化时写入 structured_report。
2. 个股研究页直接读取 thesis、evidence 和 invalidation_conditions。
3. 监控中心把失效条件转成可编辑规则。
4. Dashboard 的 What Changed 可以比较两份 ResearchArtifact 的 thesis 与 evidence 差异。