diff --git a/docs/market-regime-control-plan.md b/docs/market-regime-control-plan.md index 26fc625..9151be1 100644 --- a/docs/market-regime-control-plan.md +++ b/docs/market-regime-control-plan.md @@ -1,14 +1,5 @@ # Market Regime Control Design Plan - -## 中文摘要 - -- 完整中文版见 [`market-regime-control-plan.zh-CN.md`](market-regime-control-plan.zh-CN.md)；本节保留在英文文件顶部，方便从当前文件直接找到中文入口。 -- 用途：本文档围绕 `Market Regime Control Design Plan`，用于理解 `QuantStrategyPlugins` 的配置、运行、部署、研究或验收边界。 -- 主要覆盖：`Goals`、`Component Responsibilities`、`Arbitration Order`、`Strategy Consumption`、`Indicator Tiers`。 -- 阅读顺序：先确认边界、输入输出和权限要求，再执行文档里的命令、CI、dry-run、发布或切换步骤。 -- 风险提示：涉及实盘、密钥、权限、Cloud Run、交易所或券商 API 的变更，必须先在测试环境或 dry-run 验证；不要只凭示例直接修改生产。 -- 英文正文保留更完整的命令、字段名和配置键；如果摘要和正文不一致，以正文中的实际命令和配置为准。 [简体中文](./market-regime-control-plan.zh-CN.md) This document records the current design boundary, arbitration order, strategy diff --git a/docs/market-regime-control-plan.zh-CN.md b/docs/market-regime-control-plan.zh-CN.md index aee3200..a1da87b 100644 --- a/docs/market-regime-control-plan.zh-CN.md +++ b/docs/market-regime-control-plan.zh-CN.md @@ -1,15 +1,5 @@ # Market Regime Control 统一插件方案 - -## English summary - -- Full English version: [`market-regime-control-plan.md`](market-regime-control-plan.md). This summary keeps an English entry point in the Chinese file. -- Purpose: this document covers `Market Regime Control 统一插件方案` for `QuantStrategyPlugins`. -- Main topics: `目标`, `组件职责`, `仲裁优先级`, `策略消费方式`, `版本管理`. -- Read the boundaries, inputs, outputs, and permission requirements before running commands, CI jobs, dry-runs, releases, or runtime switches. -- For live trading, secrets, Cloud Run, exchange, or broker API changes, validate in test or dry-run mode first and do not change production only from examples. -- If this summary differs from the detailed Chinese body, follow the concrete commands, configuration keys, and constraints in the body. - [English](./market-regime-control-plan.md) 本文档记录 `market_regime_control` 的当前设计边界、信号优先级、策略消费方式和回测结论。 @@ -38,7 +28,9 @@ - `crisis_response_shadow` 负责硬危机防守。`true_crisis` 和泡沫脆弱性触发后，统一插件输出 `risk_off` / `defend`，仓位目标交给策略侧 opt-in 执行。 - `macro_risk_governor` - 负责宏观降杠杆。它看价格趋势、实现波动、VIX 和信用 ETF 相对压力，输出 `risk_reduced` 或 `risk_off`。HY OAS、金融压力指数、Fear & Greed、put/call、safe-haven demand、VVIX、SKEW、MOVE、收益率曲线、美元压力、市场宽度、AAII/NAAIM 和五角大楼比萨指数默认只作为 watch-only 证据，先用于通知和回测观察；只有显式研究开关 `external_stress_actionable` 开启后，外部压力字段才允许进入可执行分数。 + 负责宏观降杠杆。它看价格趋势、实现波动、VIX 和信用 ETF 相对压力，输出 `risk_reduced` 或 `risk_off`。 + HY OAS、金融压力指数、Fear & Greed、put/call、safe-haven demand、VVIX、SKEW、MOVE、收益率曲线、美元压力、市场宽度、AAII/NAAIM 和五角大楼比萨指数默认只作为 watch-only 证据，用于通知和回测观察。 + 只有显式研究开关 `external_stress_actionable` 开启后，外部压力字段才允许进入可执行分数。 - `taco_rebound_shadow` 负责 TQQQ 事件反弹通知。它输出人工复核通知和本地 veto 线索，不直接提高仓位。 @@ -100,7 +92,7 @@ strategy，不允许进入策略 runtime metadata，也不能影响仓位，避 当前观察指标分层： - 已可执行打分：价格趋势、63/252 日回撤、实现波动、VIX 水平/尖峰、信用 ETF 相对压力。 -- 已接入 watch-only：HY OAS、金融压力指数、五角大楼比萨指数、Fear & Greed、put/call、safe-haven demand、VIX/VIX3M 期限结构、VVIX、SKEW、MOVE、IG OAS、资金压力利差、10Y-2Y/10Y-3M 曲线、DXY 21 日压力、50/200 日市场宽度、新高新低、涨跌线回撤、AAII bearish-bullish spread、NAAIM exposure。 +- 已接入 watch-only：HY OAS、金融压力指数、五角大楼比萨指数、Fear & Greed、put/call、safe-haven demand、VIX/VIX3M 期限结构、VVIX、SKEW、MOVE、IG OAS、资金压力利差、10Y-2Y/10Y-3M 曲线、DXY 21 日压力、50/200 日市场宽度、新高新低、涨跌线回撤、AAII bearish-bullish spread 和 NAAIM exposure。 - 未进入自动仓位：所有 watch-only 指标。它们只用于通知、证据归档和后续历史回测。 - 研究开关：`external_stress_actionable = true` 可让 HY OAS、HY OAS 63 日扩张和金融压力指数进入可执行分数；默认固定为 `false`。