# SHWRP-2026-035 重現說明

這是公開研究工作論文，版本1.0。DOI：`10.5281/zenodo.21815201`。

建議引用：周秉漢（2026）。〈公開不等於可機器使用：臺灣電動車充電資料的匿名存取、詮釋資料完整性與可重現解析稽核〉。《上好味研究工作論文系列》，SHWRP-2026-035，版本1.0。https://doi.org/10.5281/zenodo.21815201

研究問題是：臺灣四個電動車充電相關官方資料集的公開詮釋資料，對無登入的自動化使用者揭露了哪些必要欄位；哪些欄位完整；本次隔離環境能否把宣告的資源位址轉成可解析回應？本研究稽核詮釋資料與存取邊界，不衡量充電設施涵蓋率、業者品質、機關績效或政策效果。

## 離線重現

需求為Python 3.11以上，以及`requirements.txt`列出的套件。固定快照已移除聯絡資料、地址、電話、座標與完整第三方內容。

```powershell
python analysis.py
python build_artifacts.py
python verify_reproducibility.py
python validate.py
python package_release.py
python validate_package.py
```

`analysis.py`只讀取`data/metadata-snapshot.json`與`data/local-resource-probe.json`，產生JSON、CSV與三張PNG。`build_artifacts.py`把`paper.md`轉為`paper-content.json`及具有可搜尋文字層的`paper.pdf`。`verify_reproducibility.py`在暫存目錄重跑前兩支程式並逐檔比較SHA-256。封裝採終止式設計：ZIP包含內容驗證與重現收據，但不包含ZIP本身、checksum或外層`package-validation-report.json`。

## 更新官方快照

`fetch_sources.py`可重新讀取四筆政府資料開放平臺公開GET端點，僅輸出白名單欄位及原始回應SHA-256。更新後的值可能因來源修訂而不同，屬新快照，不應期待與本版PDF位元一致。腳本不需要登入或金鑰，也不會保存完整回應。

## 權利與限制

作者：周秉漢／CHOU, BING-HAN；ORCID 0009-0000-7018-5096。CC BY 4.0只涵蓋作者有權授權的原創分析、文字、研究程式與原創圖表；第三方資料、名稱、商標、網址與其他內容仍依原來源條款。本包未經外部同儕審查，也沒有保存地址、電話或精確座標。
