| name | ota_equity_factor_screening_brief |
| description | 解读 tool_screen_equity_factors / tool_finalize_screening_nightly：universe、因子、success/quality_score/degraded/config_hash、申万映射与熔断；与旧 tool_quantitative_screening 的迁移说明。 |
OTA：tool_screen_equity_factors 多因子筛选口径
何时使用
- 调用或解释
tool_screen_equity_factors（主实现：openclaw-data-china-stock → plugins/analysis/equity_factor_screening.py，助手经 plugins/analysis/equity_factor_screening.py 动态加载）。
- 夜盘收尾、落盘与观察池：
tool_finalize_screening_nightly（src/screening_ops.py），门禁见 config/data_quality_policy.yaml → screening 与 src/screening_quality_gate.py。
- 用户问「震荡选股」「A 股多因子」「申万行业动量」「观察池」。
与旧工具的差异（迁移）
| 旧 | 新 |
|---|
tool_quantitative_screening（candidates、status success/error） | tool_screen_equity_factors（success 布尔、universe、factors、regime_hint） |
| 动量/波动/流动性/估值四因子 | 默认 reversal_5d / fund_flow_3d / sector_momentum_5d（震荡模板权重在插件内） |
| 无统一质量分 | 返回 quality_score、config_hash、sw_mapping（申万映射覆盖率） |
旧规程 Skill ota_quantitative_screening_brief 已 deprecated，请改用本 Skill。
返回契约（要点）
- 成功：
success: true，data: 列表，元素含 symbol / score / factors。
- 失败：
success: false，message。
- 必看：
quality_score、degraded、degraded_notes、elapsed_ms、plugin_version。
熔断与观察池
config/weekly_calibration.json：regime: pause 时收尾工具跳过观察池写入。data/screening/emergency_pause.json：由 tool_set_screening_emergency_pause 或工作流 screening_emergency_stop.yaml 维护。- 审计落盘：
data/screening/YYYY-MM-DD.json（含完整 screening 副本与门禁结果）。
权威路径
- 插件：
openclaw-data-china-stock/plugins/analysis/equity_factor_screening.py
- 助手收尾：
etf-options-ai-assistant/src/screening_ops.py
- Manifest：
config/tools_manifest.yaml → tool_screen_equity_factors、tool_finalize_screening_nightly
证据表（可复现）
| 字段 | 证据来源 |
|---|
success / quality_score / degraded / config_hash | 原始 tool_screen_equity_factors 或等价别名 tool_screen_by_factors 返回 JSON（两者信封一致） |
| 夜盘落盘路径 | tool_finalize_screening_nightly 返回中的 artifact_path |
| 估值/代码口径（若叙事涉及 PE/PB 等） | tool_l4_valuation_context / tool_l4_pe_ttm_percentile 或 Chart /api/semantic/l4_* 映射的落盘视图 |
叙事中不可出现「正文独有的数值」却无任何工具 JSON 与之对应。
