| name | detect-shanghai-silver-stock-drain |
| description | 以公開交易所庫存資料為核心，量化上海白銀庫存耗盡的方向、速度與加速度，並將其轉成可交易的供給緊縮訊號。 |
<essential_principles>
**庫存耗盡三維度量化**
庫存分析的三維框架：
- 方向（Direction）：庫存是上升還是下降
- 速度（Speed）：每週流出量
drain_rate(t) = -Δ1(t)
- 加速度（Acceleration）：流出速度的變化
Δ2(t) = drain_rate(t) - drain_rate(t-1)
當 drain_rate > 0 且 Δ2 > 0 時，表示「庫存正在流出，且流出速度在加快」——這是晚期供給訊號的核心特徵。
**Z 分數標準化判斷**
使用歷史視窗（建議 3~5 年）計算 Z 分數：
z_drain(t) = (drain_rate(t) - mean) / stdz_accel(t) = (Δ2(t) - mean) / std
門檻判定：
| 指標 | 門檻 | 意義 |
|---|
| z_drain | ≤ -1.5 | 流出速度顯著大於常態 |
| z_accel | ≥ +1.0 | 流出正在加速 |
| level_percentile | ≤ 0.20 | 庫存處於歷史低檔 |
**三段式晚期訊號判定**
把推文敘事轉為可執行規則：
| 條件 | 描述 | 單獨成立 | 組合效果 |
|---|
| A. Level | 庫存水位 < 20% 歷史分位 | WATCH | - |
| B. Speed | z_drain ≤ -1.5 | WATCH | B+C → MEDIUM |
| C. Acceleration | z_accel ≥ +1.0 | WATCH | A+B+C → HIGH |
訊號分級：
HIGH_LATE_STAGE_SUPPLY_SIGNAL：A+B+C 同時成立- ：(B+C) 或 (A+B) 成立
**資料來源與口徑**
監控上海白銀庫存（SGE + SHFE）的耗盡狀態：
需要進行什麼操作？
| Response | Action |
|--------------------------------|--------------------------------------------|
| 1, "快速", "quick", "check" | 執行 `scripts/drain_detector.py --quick` |
| 2, "分析", "analyze", "full" | 閱讀 `workflows/analyze.md` 並執行 |
| 3, "更新", "fetch", "data" | 閱讀 `workflows/fetch-data.md` 並執行 |
| 4, "驗證", "validate", "cross" | 閱讀 `workflows/cross-validate.md` 並執行 |
| 5, "學習", "方法論", "why" | 閱讀 `references/methodology.md` |
| 提供日期參數 | 閱讀 `workflows/analyze.md` 並使用參數執行 |
