# SHWRP-2026-028 公開重現資料包

《股市崩盤會推高糧價嗎？金融壓力透過匯率、能源與國際商品市場傳遞至臺灣糧食價格的非對稱效應——2002–2026年事件研究與時間序列分析》版本1.0的公開研究檔案。

- 作者：周秉漢 / CHOU, BING-HAN
- ORCID：0009-0000-7018-5096
- 文件編號：SHWRP-2026-028
- DOI：10.5281/zenodo.21695654
- 公開日期：2026-07-30
- 資料期間：2002-01至2026-06
- 狀態：公開工作論文；未經外部同儕審查
- 網頁：https://bento24235111.com/research-journal/stock-crash-food-price-transmission
- Zenodo：https://zenodo.org/records/21695654

## 研究定位

本研究使用294個月官方月資料，以TAIEX尾端變動作為共同金融壓力代理，描述國際穀價、進口穀價及臺灣零售物價的條件關聯。事件研究、局部投影與分散落後模型不識別結構因果；匯率、能源與國際價格是可檢驗的理論通路，不是已證明的中介。

## 作者可授權內容

- `paper.md`、`paper.pdf`：作者原創分析與論述；
- `acquire_data.py`、`analysis.py`：取得、轉換與分析程式；
- `paper-content.json`、`paper-metadata.json`：網站結構化內容；
- `outputs/*.csv`：研究者衍生結果；
- `outputs/figures/*.png`：作者原創圖表；
- `data/monthly-analysis-panel.csv`：必要衍生月面板；
- `data/drawdown-episodes.csv`：研究者依公開指數計算的回撤門檻事件；
- 來源、驗證、授權及引用檔案。

除另有標示外，作者有權授權的原創內容以CC BY 4.0公開。

## 第三方來源資料

中央銀行與行政院主計總處資料依政府資料開放授權條款第1版使用；FAO資料依其Statistical Database Terms使用；EIA美國政府資料原則屬公有領域，仍有第三方例外及來源標示要求。第三方資料、名稱、商標、網址與學術文獻不因列入本資料包而概括改以作者的CC BY 4.0授權。詳見`source-log.csv`及`RIGHTS-NOTICE.txt`。

## 不公開的原始資料

官方原始下載檔存放於`tmp/research-028-source-cache`，不納入Git、網站靜態目錄、公開ZIP或Zenodo資料包。公開包不包含API token、Cookie、完整第三方HTML、網頁全文、文章全文、整頁截圖、圖片二進位、客戶姓名、電話、地址、電子郵件或精確座標。

## 可公開衍生資料

`data/monthly-analysis-panel.csv`只保留重現分析所需的月資料與研究者衍生欄位；原始檔案的SHA-256、擷取日期、來源網址及使用範圍記錄於`source-log.csv`。發布衍生資料不代表資料提供機關參與、贊助、認可或背書本研究。

## 重現

若要重新連線取得當日官方檔並重建：

```text
python acquire_data.py
python analysis.py
python build_artifacts.py
python validate.py
python package_release.py
```

若只重跑既有公開面板，不需執行`acquire_data.py`：

```text
python analysis.py
python build_artifacts.py
python validate.py
```

資料提供者可能更新格式或修訂數值；重新取得日與版本1.0不一致時，應保留新版本紀錄，不覆寫已發布結果。

## 主要檔案

- `data/monthly-analysis-panel.csv`：294個月必要衍生分析面板。
- `data/drawdown-episodes.csv`：五個樣本內24月回撤門檻事件。
- `data/acquisition-summary.json`：取得與完整性摘要。
- `outputs/tail-event-months.csv`：十個聚類事件起點與同期變數。
- `outputs/local-projection-results.csv`：兩種模型、六個結果與13個期距。
- `outputs/event-definition-robustness.csv`：五種事件定義的敏感度。
- `outputs/asymmetric-distributed-lag-results.csv`：正確符號對稱檢定。
- `analysis-results.json`：機器可讀主要結果。
- `source-log.csv`：來源、擷取日期、授權與雜湊。
- `validation-report.json`：自動驗證結果。

## 更正

資料有誤、已更新或缺乏必要脈絡時，請附具體來源寄至handson0102@hotmail.com。作者核實後依網站版本與更正政策修訂並保留紀錄。
