Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 0 additions & 9 deletions docs/market-regime-control-plan.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
16 changes: 4 additions & 12 deletions docs/market-regime-control-plan.zh-CN.md
Original file line number Diff line number Diff line change
@@ -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` 的当前设计边界、信号优先级、策略消费方式和回测结论。
Expand Down Expand Up @@ -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 线索,不直接提高仓位。

Expand Down Expand Up @@ -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 spreadNAAIM 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 spreadNAAIM exposure。
- 未进入自动仓位:所有 watch-only 指标。它们只用于通知、证据归档和后续历史回测。
- 研究开关:`external_stress_actionable = true` 可让 HY OAS、HY OAS 63 日扩张和金融压力指数进入可执行分数;默认固定为 `false`。

Expand Down