價格說話時，缺口早已成形。
台灣蛋價是協商出來的：2010 年以來 5,794 個交易日只調過 393 次。我們量的不是明天幾元，是價格還沒說出口的供需壓力。
393
調整次數
13
間隔中位數（日）
已發生
進行中
計畫
CH1
壓力讀數
蛋價採議價制，價格是協商結果，非即時供需。5,794 個有批發價交易日（2010-10-07 起）僅調整 393 次，間隔中位數 13 日；等價格開口，缺口已成形。2023 缺蛋、2024 價崩；2026 年 8 月每台斤 42.5 元，上次更高是 2023-10-30 的 43.5 元。供給訊號（熱緊迫、入雛量、疫情撲殺）散落於 API、統計表與圖片檔。本案不預測明日價格，而是量測價格還沒說出口的供需壓力。
5,794
有批發價交易日
42.5
2026 年 8 月每台斤（元）
43.5
上次更高 2023-10-30（元）
CH2
實證通道
A民眾端任務測試
計畫
招募 5–10 位民眾完成三項任務：該不該囤蛋、看懂燈號、看懂節慶說明。每則回饋給編號，對應一個改版 commit，10/14 前完成。
尚未開始。規格：決賽情報/Opus工作包/O20_輔導團Brief網站.md §一-2
B蛋農端試用
計畫
規劃透過中華民國養雞協會引介 3–5 位蛋農試用兩週。約訪信已擬稿、尚未寄出；協會屬洽談中單位，不列為隊員或合作方。
草稿：決賽情報/機關材料/01_養雞協會_約訪信.md（檔頭註明待定稿寄出）
C資料協力需求
已發生
八項資料需求已於 2026-09-21 00:22 循官方確認表提出，由工作小組轉機關；八項全部待回覆——尚未收到資料，機關亦未同意。
Gmail 寄件備份 2026-09-20 16:22 UTC（台北 2026-09-21 00:22）；commit dc4411c
D主管機關拜會
計畫
擬 10 月拜會農業部畜牧司家禽產業科說明資料缺口。簡報已備妥，時間未約成故不列日期；畜牧司屬洽談中單位。
材料草稿：決賽情報/機關材料/02_畜牧司_科長簡報.md
E作法與驗證紀律
已發生
現有 24 張契約資料表、14 個 API 端點、8 步日更管線；每接一個資料源就重跑 walk-forward、留一列對照表，不利數字照列。
eggwatch/data/ 24 個 CSV；api/main.py 14 個 @app.get；commit 0a7d957→e772898
CH3
時序紀錄
2026已發生節點附 commit 前 7 碼或版本標籤；計畫節點為暗格。
09-17
v0.1.0
入選 20 強，凍結基準
09-21
8343043
repo 上線，存入選前快照
09-21
dc4411c
附件 3 八項需求寄出
09-21
0a7d957
v1.0 歷史回溯至 2010
09-21
ed73067
v1.1 四源接入
09-21
57697b5
v1.2 政策事件日曆
09-21
e71bbae
v1.3 災害層
09-21
053cfab
v1.4 週報判讀
09-21
e772898
v1.5 外部層
09-21
bd65f08
T15 存活模型，未優於既有
09-21
4cfe7cf
T14 SHAP 成因分解
09-21
fafbc30
停用不具鑑別力的提前量指標
09-22
0e384ef
閘門補強至 198 項測試
今日 09-23
09-30
計畫
公開 API 與回饋表上線
10-08
計畫
繳交簡報與影片講稿
10-14
計畫
工作坊，桌次 11
10-31
計畫
回饋改版
11-10
計畫
留痕截止
11-11
計畫
決審簡報
CH4
人員配置
陳泓光
黃經堯
賴佳莘
李心如
黃柏瑋
顏呈宇
黃育德
陳亮魁
洽談中單位：農業部畜牧司家禽產業科、中華民國養雞協會。尚未同意合作，不列姓名、不列為隊員或合作方。
DEEP
深層讀數
模型與驗證對照表9
| 版本 | 特徵 | 指標 | 結果 | 證據 |
|---|---|---|---|---|
| v1.0 歷史延伸 | 蛋價、ERA5 溫濕度、節慶回溯至 2010-10-07 | 調價事件樣本自 149 增為 393（漲 199／跌 194），重跑 walk-forward | 校準後 up14：2024 AUC 0.574 對規則 0.472；2025 AUC 0.498 近似隨機、對規則 0.464；2026 AUC 0.662 對 0.503，但 recall 0.220 低於規則 0.311（說得準但說得少） | commit 0a7d957、fdc1b33；data/model_runs.csv run_id m2t4_up14_eac66c8919c19839 |
| v1.1 已抓未接四源 | 飼料月價 501 列、在養季報 805 列、蛋種雞 100 列、辦公日曆 4,017 列 | 成本通道 feed_z、產能基底、產區權重、節慶前置天數 | 僅接資料層與展示層；是否進入模型特徵由各任務卡對照表決定，避免未經驗證即改變壓力指數定義。飼料實用範圍僅 2008-05 起，上游落後約 3 個月 | commit ed73067；docs/CONTRACTS.md §2 |
| v1.2 政策層 | 農業部新聞 151 則候選，兩輪覆核得 21 則 verified | 政策衝擊標記（解釋層，非主特徵） | 其餘 137 列僅憑標題判定，為已知的召回率上限，不是完整母體 | commit 57697b5 |
| v1.3 災害層 | 颱風海警 1,481、陸警 866、高溫燈號 2,151，合計 4,498 列 | 縣市日災害旗標與落遲項 | 實測推翻偵察記載：高溫實際涵蓋 2019 年起而非 2014 年起；陸警覆蓋率上限 68.5%；颱風來源無地理資訊，不編造產區關聯 | commit e71bbae |
| v1.4 A01 週報判讀 | 雞蛋產銷週報圖判讀 89 列（high 76／low 13） | 週頻供給流量；入中雞為供給端唯一公開領先指標（雛雞至開產約 20 週） | 稀疏不規則（89 列僅 82 個唯一日期），不建議直接進模型；若當特徵須剔除 low 且不得前向填補。上游另有重複檔與標註誤植 | commit 053cfab |
| v1.5 外部層 | 國際價格 8,735 列、替代品 8,263 列、國際禽流感 98 列 | 進口成本上游、替代品比價、區域疫情領先 | 日本 JA 序列 272 列因來源明文禁止轉載而移除；巴西 CEPEA 為 CC BY-NC 4.0 僅限非商業。WAHIS 台灣 33 件與場級 1,609 筆口徑不同，未嘗試對齊 | commit e772898 |
| T15 存活模型 | 離散時間 hazard（any／up／down）與條件幅度回歸 | hazard、存活機率、expected_days、precision@10% | 整體未優於既有模型：precision@10% 六格只贏兩格、Brier 輸五格、AUC 三勝三敗（down14 2026 為 0.566 對 0.776）；expected_days 三年皆輸給常數基準 9 日。幅度預測標記 reliable=false，不進自動決策；僅作並列對照，不取代既有主幹 | commit bd65f08；model_runs t15_hazard_any／up／down、t15_magnitude |
| T14 SHAP 成因分解 | TreeExplainer 逐 walk-forward 折計算 | shap_daily 37,164 列；/v1/policy/explain 回當日前五大特徵貢獻 | 只解釋模型怎麼算，不得詮釋為因果；每筆解釋強制並列該折 AUC | commit 4cfe7cf |
| 機制訊號（跨季對照，附但書） | 調漲前 14 日壓力指數均值，夏季對非夏季 | 提案書送件值 56.4（n=27）對 20.5（n=48）；資料擴充後重算 54.7（n=66）對 17.7（n=133） | 但書：屬跨季比較、未排除季節混淆，不得單獨引用；方向一致不等於具備預測力 | 決賽情報/Opus工作包/O09_資料源擴充與SHAP.md 交付紀錄；00_決賽總綱.md §6 |
系統：畫面、端點、資料版圖6 / 11+3 / 7
畫面為 2026-08-29 版本。
11
v1 端點
3
open 端點
/docs
Swagger 路徑
| 分層 | 資料項 | 涵蓋 | 角色 |
|---|---|---|---|
| 核心日更 | 家禽交易行情、五產區 ERA5 溫濕度、氣象署七日預報、防檢署禽流感、節慶日曆 | 蛋價與溫濕度 2010 起；預報滾動七日 | 壓力指數與調價事件模型主特徵 |
| 成本與產能 | 飼料月價、在養季報、蛋種雞季報、溯源場址、辦公日曆 | 1981／2014／2012 起 | 成本通道、產能基底、產區權重 |
| 政策層 | 農業部產銷調節與價格穩定新聞事件 | 2019 起，覆核通過 21 則 | 政策衝擊解釋層，非主特徵 |
| 災害層 | 颱風海警與陸警、高溫燈號 | 颱風 1958 起；高溫 2019 起 | 縣市日災害旗標與落遲項 |
| 供給流量 | 雞蛋產銷週報 A01 圖判讀 | 2022-10 起，89 列 | 週頻供給流量，入中雞為領先指標 |
| 外部層 | WAHIS 國際禽流感、CEPEA 巴西蛋價、BLS 美國蛋價、毛豬與蔬菜日價 | 2005／2023／2017／2009 起 | 上游成本與替代品比價 |
| 待機關提供 | 附件 3 八項資料需求 | 已提出，待回覆 | 現以替代方案暫代，非長期解 |
資料協力需求清單8
| 單位 | 資料集 | 用途 | 狀態 |
|---|---|---|---|
| 農業部畜牧司（家禽產業科） | 雞蛋產銷週報 A01 機讀版（CSV 或 Excel，含週別、統計期間、產蛋雞隻數、入中雞、淘汰、強制換羽，全國並儘可能分區） | 這是目前唯一每週更新的供給面資訊，有逐週數字才能在缺蛋或價格波動形成之前看出產蛋雞群正在減少或回補。 | 待回覆 |
| 農業部畜牧司（家禽產業科）／財團法人中央畜產會 | 蛋雛雞（day-old）入雛量統計機讀版（CSV，週或月更新，可行時含孵化場縣市） | 雛雞進場到開始產蛋約需二十週，入雛量是最早能看見的供給訊號，可提前數月提示供給將增或減。 | 待回覆 |
| 交通部中央氣象署 | 彰化、雲林、嘉義、臺南、屏東五大產區地面測站歷史逐日資料（CSV 或可程式化介面，2019 年起，含日最高溫、日最低溫、日均相對濕度） | 熱緊迫指數需要各產區實際溫濕度紀錄，改用我國官方觀測資料，預警數值才能與國內氣象紀錄相互對照查核。 | 待回覆 |
| 農業部動植物防疫檢疫署 | 禽流感確診案例的正式開放資料端點與欄位說明文件（JSON 或 CSV，含研判日期、縣市鄉鎮、禽種、撲殺數量、場區類型，並載明更新頻率與歷史涵蓋範圍） | 有正式而穩定的來源，疫情警示才不會因網站改版中斷，民眾看到的預警也才有明確出處。 | 待回覆 |
| 財政部關務署 | 雞蛋及蛋品（稅則號列 0407）進出口統計月資料的批次存取管道（CSV 下載或應用程式介面，2003 年起） | 進口蛋是國內供給不足時的重要補充，納入後可說明某段期間的價格變化有多少來自進口調節，避免誤判市場情勢。 | 待回覆 |
| 農業部統計處 | 蛋雞在養場數與在養隻數季報機讀版（CSV，含統計季別、縣市，可行時含鄉鎮） | 在養規模是供給的基礎數字，用以校正各產區權重，讓不同地區的氣候與疫情影響被正確加權。 | 待回覆 |
| 農業部畜牧司（家禽產業科） | 歷年雞蛋產銷調節與價格穩定措施紀錄（2019 年起，CSV 或 Excel，含公告日期、措施類別、生效期間、數量或金額、公告出處） | 蛋價採議價制，政府措施會直接改變價格走向；有這份紀錄才能分辨價格變動來自市場供需或政策調節，也才能評估措施效果。 | 待回覆 |
| 農業部畜牧司（家禽產業科）／財團法人中央畜產會／農業部動植物防疫檢疫署 | 蛋用種雛與種蛋輸入數量統計（月，隻數或枚數，含來源國並區分蛋用與肉用），以及進口暨國內繁殖種雞統計表機讀版（CSV） | 種雞與進口種雛決定半年後蛋雛雞的供給上限，納入後可比入雛量更早看見供給的天花板。 | 待回覆 |