| name | detect-palladium-lead-silver-turns |
| description | 以鈀金的先行轉向作為確認條件，檢驗白銀短期漲跌是否獲得工業景氣與風險情緒的同步支持，並標記缺乏鈀金參與度的失敗走勢。 |
<essential_principles>
**跨金屬確認核心**
「鈀金領先白銀」的假說需要可量化驗證：
- 以 cross-correlation 估計最佳領先滯後（lead-lag）
- 當銀出現拐點時，檢查鈀金是否在確認窗口內先行或同步出現同向拐點
- 未被確認的拐點視為「失敗推動」的候選
Lead-Lag = argmax(cross_correlation(pd_ret[t-k:t], ag_ret[t:t+k]))
Confirmed = pd_turn exists within [ag_turn.ts - window, ag_turn.ts + window]
**拐點偵測三法**
| 方法 | 原理 | 適用場景 |
|---|
pivot | 左右 N 根K棒內的局部極值 | 結構明確的趨勢 |
peaks | scipy find_peaks + prominence | 自動化密度控制 |
slope_change | 趨勢斜率由正轉負或反之 | 平滑趨勢追蹤 |
建議從 pivot 開始，左右各 3-5 根K棒，再依需求調整。
**參與度判定**
鈀金是否「參與」銀的走勢，有多種衡量方式：
| 指標 | 定義 | 門檻建議 |
|---|
returns_corr | 報酬率滾動相關係數 | > 0.5 |
direction_agree | 同向漲跌的比例 | > 60% |
vol_expansion | 兩者波動同步擴張 | σ_pd / σ_ag > 0.8 |
breakout_confirm | 銀突破時鈀金也突破 | 同向突破 |
未達門檻時，銀的動作可能是「流動性噪音」而非趨勢確認。
**失敗走勢判定**
將「無鈀金參與的銀動作」落地為可回測的規則：
偵測「鈀金領先、白銀跟隨」的跨金屬拐點：
需要進行什麼操作？
| Response | Action |
|------------------------------------|--------------------------------------------------------|
| 1, "快速", "quick", "check" | 執行 `python scripts/palladium_lead_silver.py --quick` |
| 2, "回測", "backtest", "history" | 閱讀 `workflows/backtest.md` 並執行 |
| 3, "監控", "monitor", "alert" | 閱讀 `workflows/monitor.md` 並執行 |
| 4, "調校", "optimize", "tune" | 閱讀 `workflows/detect.md` 的參數調校部分 |
| 5, "學習", "方法論", "why" | 閱讀 `references/methodology.md` |
| 提供參數（如 timeframe, lookback） | 閱讀 `workflows/detect.md` 並使用參數執行 |
