# 快速上手

## 給終端使用者（只想用，不想裝東西）

### Windows

1. 拿到 `bot_rates.zip`
2. 對 zip 按右鍵 → 「解壓縮全部」
3. 雙擊 `bot_rates.exe`

完成。不用裝 Python，不用裝任何 runtime，單一檔案執行。

### macOS

1. 拿到 `BotRates.app`（整個資料夾）
2. 雙擊打開

若跳出「無法驗證開發者」：

```bash
xattr -cr /path/to/BotRates.app
```

或在「系統設定 → 隱私權與安全性」按「仍要打開」。

## 怎麼用

| 欄位 | 說明 |
|------|------|
| 左側 | 幣別、代碼、即期賣出匯率（例如 `美元 USD 31.6200`） |
| 中間 | 輸入外幣金額（預設 100，可自由修改） |
| 右側 | 台幣換算結果（例如 `NT$ 3,162.00`） |
| 複製 | 按下複製純數字（`3162.00`）到剪貼簿，可直接貼 Excel |
| 重新整理 | 右下角按鈕，重新抓最新匯率 |

---

## 給開發者（想改程式或重新編譯）

### 先決條件（一次性）

```bash
# Rust 本體（已有可略）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 交叉編譯到 Windows 用的 linker
brew install mingw-w64
rustup target add x86_64-pc-windows-gnu
```

### 編譯

```bash
cd bot_rates_rs

# macOS 版
RUST_MIN_STACK=16777216 cargo build --release

# Windows 版（在 macOS 交叉編譯）
RUST_MIN_STACK=16777216 cargo build --release --target x86_64-pc-windows-gnu
```

### 部署

```bash
# mac 版複製進 .app bundle
cp target/release/bot_rates ../BotRates.app/Contents/MacOS/BotRates
xattr -cr ../BotRates.app

# Windows 版複製到專案根目錄並壓 zip
cp target/x86_64-pc-windows-gnu/release/bot_rates.exe ../bot_rates.exe
cd .. && zip -9 bot_rates.zip bot_rates.exe
```

### 常見修改點

| 想改什麼 | 改哪裡（`src/main.rs`） |
|----------|------------------------|
| 新增幣別 | `TARGETS` 常數，加一行 `(代碼, 中文名)` |
| 換成即期買入 | `fetch_rates` 裡把 `cols[13]` 改 `cols[3]` |
| 視窗大小 | `main` 裡的 `with_inner_size` |
| 預設輸入金額 | `App::new` 裡的 `"100".to_string()` |
| 配色 | `update` 開頭的 `bg` / `card` / `rate_color` 等常數 |

### 欄位對照（台銀 CSV）

| index | 欄位 |
|-------|------|
| 0 | 幣別 |
| 3 | 本行即期買入 |
| 13 | 本行即期賣出 ← 目前使用 |