| name | wasde-ingestor |
| description | 下載並解析 USDA 每月發布的 WASDE 報告，擷取所有主要商品（穀物、油籽、棉花、畜產品、糖）的供需平衡表。輸出標準化、可版本化的資料集，作為即時預測（nowcasting）的錨定基準。 |
<essential_principles>
WASDE Ingestor 核心原則
1. 商品範圍
WASDE 涵蓋三大類商品，每類有不同的表格結構與單位：
| 類別 | 商品 | US 單位 | World 單位 |
|---|
| Grains | Wheat, Corn, Rice, Barley, Sorghum, Oats | million bushels / cwt | million metric tons |
| Oilseeds | Soybeans, Soybean Oil, Soybean Meal | million bushels / pounds | million metric tons |
| Cotton | Upland, Pima | million 480-lb bales | million 480-lb bales |
| Livestock | Beef, Pork, Poultry, Eggs, Dairy | million lbs / dozen / lbs | - (US only) |
| Sugar | Sugar | 1,000 short tons | - (US + Mexico only) |
2. 表格結構一致性
所有供需表遵循相同的平衡公式：
Ending Stocks = Beginning Stocks + Production + Imports - Total Use - Exports
3. 版本控制
- 每月報告可能修正前期數據
- 使用
content_hash 追蹤數據變化
- 保留
revision_flag 標記修正值
4. 解析優先級
- PDF 結構化解析（優先）
- HTML 表格解析（fallback）
- TXT 固定寬度解析（legacy）
</essential_principles>
**您想要執行什麼操作？**
- Ingest - 抓取並解析最新或指定月份的 WASDE 報告
- Backfill - 批量回補歷史 WASDE 數據
- Validate - 驗證現有數據與最新報告的一致性
| Response | Workflow | Description |
|-----------------------------------------|------------------------|---------------------|
| 1, "ingest", "fetch", "parse", "latest" | workflows/ingest.md | 抓取解析 WASDE 報告 |
| 2, "backfill", "historical", "batch" | workflows/backfill.md | 批量回補歷史數據 |
| 3, "validate", "check", "verify" | workflows/validate.md | 驗證數據一致性 |
| 4, "configure", "config", "setup" | workflows/configure.md | 配置參數 |
