宏觀狀態
使用時機
當使用者想要查詢達卡證券交易所的宏觀狀態時啟用:「市場狀態如何?」、「這是風險偏好環境嗎?」、「利率和儲備如何影響風險?」、「給我一個宏觀乘數」。此為宏觀代理(PRD-002 REQ-020)。其風險乘數供下游 signal-synthesizer(用以調整綜合分數)和 risk-manager(用以調整部位規模)使用。
功能說明
讀取共享合約的 macro 區塊,並計算單一風險乘數,範圍在 [0.5, 1.2],從 1.0(中性)開始,根據每個因子調整:
- 政策利率 — 緊縮貨幣(>=9%)降低乘數;寬鬆貨幣提高乘數。
- 通貨膨脹 — 高於 8% 降低乘數(實際報酬侵蝕、緊縮風險)。
- 外匯儲備趨勢 —
下降降低乘數(進口覆蓋壓力、BDT 壓力);上升提高乘數;穩定為中性。 - 政治局勢 —
危機/緊張降低乘數;穩定提高乘數。 - 監管環境 —
價格地板/緊縮降低乘數;正常為中性。
調整後的乘數對應到一個狀態標籤和一個標準化的 score,範圍在 [-1, +1]。輸出為一張思考卡片(請參閱套件 README)。
執行方式
python3 scripts/regime.py --input data.json --pretty
cat data.json | python3 scripts/regime.py
讀取 macro(必要)以及可選的 mode/ticker/as_of。回傳 score(-1..+1)、confidence、rating(狀態標籤)、key_metrics.risk_multiplier、各因子 drivers、易懂的 reasoning 與 flags。
立即使用共享測試資料試試看:
python3 scripts/regime.py --input ../_fixtures/sample_input.json --pretty
輸出解讀
rating:risk_on(乘數 >=1.05)、neutral(0.85–1.05)、cautious(0.70–0.85)、risk_off(<0.70)。key_metrics.risk_multiplier是下游技能用以乘入其風險預算的值 — 例如 risk-manager 會以base_risk * risk_multiplier來設定部位規模。flags:當一個或多個macro欄位缺失時會出現stale_macro,信心水準會相應調降 — 絕不會默默忽略。
備註
因子權重、乘數到狀態的對應表、分數對應表,以及下游技能如何使用乘數,都記錄在 references/REGIME.md 中。輸出僅供教育分析之用,絕不構成財務建議。