name: financial-early-warning slug: financial-early-warning version: 1.0.0 displayName: "A股財報異動預警 — 財務正在發生什麼變化" title: "financial-early-warning" summary: "A股財報異動預警引擎 v1.0.0 — 多資料來源、零Key門檻。基於多期三大報表檢測 9 類財務異動訊號（營收斷崖/利潤變臉/現金流惡化/應收暴增/商譽地雷/存貨異常/大額減值/行業偏離/存貸雙高），含趨勢確認（連續3期）+ 三級告警（🟡🟠🔴）+ 落盤報表（alert_list.csv / alert_detail.md / safe_list.csv）。主源 westock-data（免費npm包，無需Key），交叉校驗東方財富（免費HTTP），可選 i問財增強（行業均值，需配置 IWENCAI_API_KEY）。純財務預警，不碰估值/排雷/倉位。" description: "A-share financial early-warning engine v1.0.0. Multi-source, no API key required. Detects 9 financial anomaly signals from multi-period three financial statements (revenue cliff / profit turn / cashflow deterioration / receivable surge / goodwill bomb / inventory anomaly / large impairment / industry divergence / high cash-debt coexistence), with trend confirmation (3 consecutive periods) + 3-tier alert (🟡🟠🔴) + report output (alert_list.csv / alert_detail.md / safe_list.csv). Primary source westock-data (free npm, no key), cross-check EastMoney (free HTTP), optional iwencai enhancement (industry mean, needs IWENCAI_API_KEY). Pure financial alert — no valuation / filtering / position logic."

A股財報異動預警引擎

多資料來源、零 API Key 門檻，檢測"財務正在發生什麼變化"（防踩雷）。

定位與邊界紅線（嚴格遵守，不越界）

本引擎只回答一個問題：基於歷史財報，這家公司的財務是否正在出現惡化異動？

它不是"財務好不好"（那是估值/靜態評估的活）。因此明確不碰以下職責，避免與同體系其他 Skill 耦合：

本引擎是 A股Skill 體系規劃方案中的獨立 Skill 之一，可單獨呼叫，不自動串聯。

設計原理

多期三大報表（主源 westock + 東方財富校驗）
        │
        ▼
┌──────────────────────────────────────┐
│  9 條異動規則（每條獨立判定）            │
│  A1 營收斷崖 → A9 存貸雙高             │
└──────────────┬───────────────────────┘
               │ 每條規則：觸發? 級別? 趨勢確認?
               ▼
┌──────────────────────────────────────┐
│  三級告警彙總                            │
│  🔴危險 / 🟠警示 / 🟡關注 / 🟢安全     │
└──────────────┬───────────────────────┘
               │
               ▼
        控制台輸出 + 落盤報表

9 條異動規則

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

趨勢確認：A1–A4、A6–A8 類規則要求連續 trend_confirm（預設3）期同方向惡化才確認，避免單季噪聲誤報；A5/A9 等存量指標用最新期絕對值判定。

行業適配：金融類（證券/銀行/保險/信託）自動跳過 A4/A6/A9（科目性質不同，如"存貸雙高"為行業常態）；名稱與行業取自東方財富。

資料來源（多源搭配，免費優先）

L1 主源   westock-data (npx 免費包)
   → 完整多期三大報表，含商譽/有息負債/單季(_Q)欄位，覆蓋全部 9 規則欄位
   → 無需任何 API Key，僅依賴 Node.js（npx）
L2 交叉校驗 東方財富 DMSK (免費 HTTP)
   → 校驗主源營收/利潤/現金流一致性，檢測主源異常；提供股票名稱與行業
L3 可選增強 i問財 (需環境變數 IWENCAI_API_KEY)
   → 提供行業均值（A8 精確對比）+ 關鍵指標交叉校驗
   → 未配置 Key 時 A8 降級為"個股自身趨勢已覆蓋"，不強制觸發

零門檻釋出：預設開箱即用（westock + 東方財富均為免費源，無需任何 Key）。僅 A8 精確行業對比需可選配置 i問財 Key。

使用方法

# 單隻預警
python financial_early_warning.py 601162

# 批次預警（逗號分隔，支援 sh/sz 字首或純6位程式碼）
python financial_early_warning.py 601162,000100,600519

# 批次 + 生成結構化報表（CSV + MD）
python financial_early_warning.py 601162,000100,600519 --report --out ./report

# 關閉東方財富交叉校驗（僅主源，更快）
python financial_early_warning.py 000100 --no-verify

# 調整拉取期數（預設12期，滿足連續3期趨勢）
python financial_early_warning.py 601162 --num 8

輸出示例

==============================================================
  天風證券(sh601162)  —  🔴危險
==============================================================
  🔴 [A1] 營收斷崖：單季營收同比 -31.1%（閾值 -30.0%），連續3期下滑

==============================================================
  TCL科技(sz000100)  —  🟢安全
==============================================================
  ✓ 未觸發財務異動預警（僅基於已獲取欄位）

結構化輸出（--report）

配置說明

所有引數在 financial_early_warning.py 頂部的 CONFIG 字典中，按需調整：

已知限制

• 財報為季度披露，預警本質是財報釋出後掃描，非盤中即時。
• 主源 westock-data 依賴 Node.js（npx 呼叫免費包）；若環境無 Node，僅東方財富校驗源仍可執行（部分欄位缺失將降級）。
• A7 大額減值：主源無獨立資產減值損失欄位，採用"歸母−扣非差額異常"降級篩查；配置 i問財 Key 後可升級為精確減值對比。
• A8 行業偏離：免費模式下降級為個股趨勢覆蓋，精確行業對比需 i問財增強。
• 金融類（證券/銀行/保險）科目特性已做適配（跳過 A4/A6/A9），但仍建議結合行業常識研判。

許可

MIT License

⚠️ 風險提示與免責宣告 本工具生成的預警結果僅供參考，不構成任何投資建議。 所有結論基於公開歷史財報資料，不保證準確性、完整性、及時性。 財報存在滯後與粉飾可能，預警僅作風險排查輔助，非買賣依據。 股市有風險，投資需謹慎。據此操作，盈虧自負。

這款預警工具質量不錯，能檢測營收斷崖、利潤變臉、現金流惡化等9類財務異常訊號，介面友好、配置靈活。最大亮點是零成本即可使用，資料來源可靠。不過它只能基於已釋出的財報進行分析，存在天然滯後性；部分檢測規則精度有限，誤報率可能偏高；結果僅供參考，不能直接用於投資決策。