| name | ota_trend_analysis_brief |
| description | 三工具 tool_analyze_after_close / before_open / opening_market 的契约、report_meta、daily_report_overlay、落盘目录、trend_analysis_plugin 配置；盘前 A50-HXC 边界与 after_close_basis；叙事只引用返回字段。 |
OTA：趋势分析三工具（盘前 / 盘后 / 开盘）
何时使用
- 调用或解释
tool_analyze_after_close、tool_analyze_before_open、tool_analyze_opening_market 的返回结构、落盘路径、配置开关。
- 用户问「为什么盘前又跑了一遍盘后」「A50 / 金龙失败影响谁」「
report_meta 和 overlay 是什么」。
OpenClaw：建议勾选的 Agent id
与本仓库片段 config/snippets/openclaw_agents_ota_skills.json 一致，下列 Agent 的 skills 中应包含 ota_trend_analysis_brief（name: 为下划线，与目录 ota-trend-analysis-brief 不同）：
Agent id | 原因 |
|---|
etf_main | 总编排、多工作流入口；需统一解读三工具与 after_close_basis。 |
etf_analysis_agent | 白名单含三工具；定时盘后/盘前/开盘与融合链路。 |
etf_business_core_agent | 信号 + 风控 + 融合；常并列引用趋势结论。 |
etf_notification_agent | 晨报/分析推送需按 report_meta、overlay 边界叙事，避免臆造字段。 |
不勾选：etf_data_collector_agent（仅采集）、ops_agent、code_maintenance_agent（角色无关趋势契约）。若本机另有自定义 Agent 暴露了 tool_analyze_* 或负责转述其 JSON，应同样加入该 Skill。
工具与数据源边界
| 项 | 说明 |
|---|
| 盘后 | src.trend_analyzer.analyze_daily_market_after_close；插件附加 daily_report_overlay（北向、全球现货、关键位、板块、可选 ADX）与 report_meta。 |
| 盘前 | analyze_market_before_open。隔夜富时 A50 与纳斯达克中国金龙（HXC）仅在本流程拉取；盘后、开盘不调用 fetch_a50_futures_data / fetch_nasdaq_golden_dragon。A50 样本不足或 HXC yfinance 限流只影响盘前隔夜合成，见 overnight_overlay_degraded；可降级为仅靠盘后结论。 |
| 盘后复用 | 未传入盘后 dict 时，先读落盘 after_close（自当日起向前最多 10 个自然日），再决定是否现场跑盘后；返回 after_close_basis：passed / disk / computed。 |
| 开盘 | 优先 analyze_opening_market；失败且 trend_analysis_plugin.fallback.use_simple_opening 为 true 时 _simple_opening_analysis。 |
返回结构（外层）
三工具均返回：success、message、data（分析主体）、llm_enhanced（仅当上游已注入 llm_summary）。
data 内统一扩展
report_meta（必有）：analysis_type、timestamp、market_sentiment_score、trend_strength_label、key_metrics、overlay（镜像 daily_report_overlay，无则为 {}）。daily_report_overlay（仅盘后且插件 enabled）：不要假设盘前/开盘也有此键。
盘前 key_metrics.after_close_basis 标明盘后结论来源。
落盘（save_trend_analysis）
analysis_type | 目录（相对 data_dir，见 合并后配置 → system.data_storage.trend_analysis，域文件：config/domains/platform.yaml） |
|---|
after_close | after_close_dir |
before_open | before_open_dir |
opening_market | opening_dir（与 before_open 分离，避免同日覆盖） |
配置键
trend_analysis_plugin（顶层）：enabled、overlay.*、fallback.*（见 get_default_config；合并后配置域文件：config/domains/analytics.yaml）。- 存储路径：
system.data_storage.trend_analysis（含 opening_dir）。
叙事约束（与 ota_openclaw_tool_narration 一致）
- 只引用 工具返回的
data 中实际字段（含 report_meta、daily_report_overlay、data_stale_warning、after_close_basis 等）；不得编造 ADX、北向、全球指数数值。
- 非交易日可能出现指数日线「最新 bar 日期 ≠ 当日」类提示（
data_stale_warning），应说明「结论基于最近可用交易日」而非断言插件故障。
- 开盘模式下
market_sentiment_score 与 trend_strength_label 若看似不一致，因后者在无 overlay 时可能默认 neutral；可优先引用 summary 强弱家数或各指数 strength。
权威文档与代码
相关 Skill
- 通用工具叙事：
ota_openclaw_tool_narration
- 技术指标（盘后 overlay 中 ADX）：
ota_technical_indicators_brief
