🏰 城戰沙盤
│
│ 🖥️ 本機模式 尚未進入房間
📊 Excel 協作
＊用 Excel 批次填寫城池/路線資料 → 另存 CSV → 上傳；或直接從 Excel 複製表格貼上。
📡 Firebase 即時連線（進階）
顯示給同房間的其他玩家，最多 12 字。
創建房間時系統會隨機產生；加入房間時輸入盟友提供的 6 位數字。
未連線
👥 在線盟友
尚未連線
☁️ 雲端同步
從上次成功上傳起算。設為 0 可停用定時上傳。
⚡ 觸發時機
⚔️ 隊數分級計算
＊每城「總隊數」由各級人數自動計算。
＊分級門檻與每人隊數可自訂。
📊 分級規則
級別 1（≤ 級） 每人 隊
級別 2（≤ 級） 每人 隊
級別 3（≤ 級） 每人 隊
級別 4（> 級別 3 上限） 每人 隊
⚙️ 選項
⚙️ 戰鬥參數
🕐 時間與節奏
從防守開始時間起算，超過此時間戰鬥強制結束。
進攻/協防部隊從母城到目標城所需時間。戰敗後亦需此時間才能回母城。
⚔️ 消耗與攻城
🎲 戰敗比例鉗制
🗺️ 地圖關聯規則
勾選後，只能在地圖內建立兩城之間的路線。
勾選後，只能對同地圖的城池宣戰。
🎯 宣戰規則
勾選後，只有與出兵城有地圖路線接觸的敵方城池才能被進攻。預設不勾選。
勾選後，宣戰可跨越戰區邊界。預設不勾選。
🤖 AI 佈兵參數
📊 戰力比分段建議
🔧 修正係數
🤝 參戰盟清單
＊拖曳左側把手 ⠿ 可調整順序（滑鼠 / 觸控皆支援）
盟名稱 陣營 總人數 總戰力 平均戰力 操作
尚無同盟資料
➕ 新增參戰盟
億
快速選擇盟徽：
📊 盟對盟獨立消耗比例矩陣
＊單元格 = (X軍平均戰力 / (X軍 + Y軍平均戰力)) × 每分鐘總消耗隊數
尚無同盟資料
📊 沙盤統計
🏰 城池
0
🤝 同盟
0
🗺️ 戰區
0
🛣️ 路線
0
⚔️ 宣戰
0
🎯 快速入口
📊 各盟兵力分佈
🏰 各陣營城池數
🗺️ 戰區管理
＊戰區隸屬於地圖，影響推演範圍選擇。
＊點 ✏️ 可編輯名稱，點 ✕ 可刪除。
🏰 城池清單
🗺️ 地圖 戰區 所屬盟 陣營 城池編號 城池名稱 等級 人數 總戰力 總隊數 均戰 操作
尚無城池資料
📊 城對城獨立消耗比例矩陣
＊單元格 = (X城平均戰力 / (X城 + Y城平均戰力)) × 每分鐘總消耗隊數
尚無資料
⚔️ 宣戰清單
＊定義「誰打誰」與「誰協防誰」。
＊可於 ⚙️ 參數設定開啟「宣戰限制同地圖」開關。
➕ 新增宣戰指示
＊「自動新增」會依序找下一個未建立的組合（含所有方向）。
🎯 出兵清單
＊由宣戰指示衍生，設定各路線派兵 %。
📏 距離計算
＊計算兩城之間的距離。路徑只能經過「同盟城」或「NPC 城」。
→
請選擇起點與終點後點「計算」
🛣️ 地圖路線管理
＊定義兩城之間是否有「接觸」。無向圖（A-B 等同 B-A）。
＊可於 ⚙️ 參數設定開啟「路線限制同地圖」開關。
⚡ 快速新增
—
＊選擇兩城後按「新增」，或按 Enter 快速建立。
📋 佈兵總覽
＊此頁面為純查閱用途。
📊 尚未推演。
請至「🏰 城池數據」Tab → 點「⚡ 一鍵模擬到結束」。
🗺️ 地圖
＊滾輪縮放、拖曳平移、拖曳節點
📈 動態戰報表（路線級）
尚未推演
時間點進攻方行動防守方本分鐘消耗 進攻方剩餘進攻方待復活 防守方剩餘防守方待復活 城牆剩餘
尚未推演
📜 文字戰報
等待推演指令...
未連線
👤 我的個人沙盤
—
—
—
📊 個人沙盤清單
檔案名稱擁有者城池同盟 戰區更新時間操作
載入中...
📡 共享沙盤清單
＊共享沙盤由管理員建立與編輯。
＊可下載共享沙盤到個人沙盤（不影響共享）。
＊超管可上傳個人沙盤覆蓋共享沙盤。
沙盤名稱地圖城池同盟 版本更新時間操作
載入中...
👤 我的帳號
👤
—
@—
—
⚙️ 帳號設定
👥 帳號管理
帳號顯示名稱角色 密碼 狀態建立時間最後登入操作
載入中...
📖 城戰計算規則（v9.0.0）

一、資料模型

沙盤（Sandbox）：以「沙盤名稱」為單位，可包含多張地圖。
地圖（Map）：底圖 + 節點座標。
戰區（Zone）：隸屬於地圖。
盟（Alliance）：固定總戰力、總人數。
城（City）：含編號、人數、戰力、隊數。
地圖路線：兩城之間的接觸（無向圖）。

二、v9.0.0 共享沙盤 + 個人沙盤

共享沙盤：所有登入者自動載入，有權限者可編輯。
個人沙盤：完全個人化，只有自己能改。
切換：側邊欄或 mode-bar 可切換。
顏色區分：頂部彩色條（共享=藍 / 個人=黃）。
同步：共享模式每 5 分鐘自動同步。
歷史：共享沙盤保留 20 筆歷史備份。

三、資料版本管理

資料結構版本（dataVersion）：
・v8.x 為 0（無版本欄位）
・v9.0.0 為 1
自動遷移：讀取舊資料時，自動升級至最新版本。
失敗保護：遷移失敗不覆蓋本機，跳出警告。

四、戰力單位

輸入單位：億（例：輸入 2 = 2 億）
顯示單位：盟 / 城總戰力：億（2 位小數）；平均戰力：萬（無小數）

五、隊數分級

預設分級：≤17 級：每人 3 隊；18~20 級：每人 4 隊；21~24 級：每人 5 隊；≥25 級：每人 6 隊

六、地圖互動模式

三模式互斥：🛣️ 路線（藍框）、⚔️ 宣戰（紅框）、🏙️ 城池編輯（綠框）。

七、宣戰清單

  • 進攻：需指定「開始時間」= 目標城防守開始時間。
  • 協防：需與出兵城同一盟、且路線上必須有接觸。
  • 跨圖限制：預設只能同地圖宣戰。

八、Excel 匯入模式

🔄 合併 / ➕ 新增 / 💥 覆蓋

九、協作模式

  • 個人雲端沙盤：登入時下載、定時上傳、保留 20 筆歷史
  • 共享沙盤：所有登入者共用、5 分鐘同步、20 筆歷史
  • 房間雲端沙盤：房主/幹部手動上載

十、帳號與權限

  • 超級管理員：最高權限，可刪除共享沙盤、上傳覆蓋
  • 管理員：可新增共享沙盤、編輯所有共享沙盤
  • 幹部：可創建房間、執行推演、編輯地圖庫；共享沙盤需額外授權
  • 成員：本機推演、加入房間、檢視共享沙盤
  • v9.0.0：地圖庫：所有登入使用者皆可編輯

十一、安全架構

智譜 API Key 儲存於 Cloudflare Pages Functions 環境變數，前端完全接觸不到 Key。
所有 AI 請求經過 /api/ocr 代理。