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

一、資料模型

盟（Alliance）：固定總戰力、固定總人數。
城（City）：輸入人數、總戰力、總隊數、等級；平均戰力自動計算。
盟餘下戰力 = 總戰力 − 該盟所有城池總戰力。
地圖路線：兩城之間的「接觸」（無向圖）。

二、戰力單位

輸入單位：億（例：輸入 2 = 2 億）
顯示單位：
・盟 / 城總戰力：億（2 位小數，如 2.00 億）
・平均戰力：萬（無小數，如 150 萬）
儲存：完整數字（億 × 10⁸）
舊資料：值 < 10⁶ 視為舊資料，載入時自動 × 10⁸。

三、對戰節奏

每 30 秒結算一次對撞，每分鐘抽取一次消耗值。
消耗抽取：每條路線獨立，在 [最小, 最大] 之間抽取。
機率偏向：戰力越接近 → 越易抽到最小值；戰力差距越大 → 越易抽到最大值。

四、城池輸入

  • 城池名稱：必填
  • 所屬戰區：可留空
  • 所屬盟：預設 NPC
  • 所屬陣營：預設本方
  • 等級：1~10（可留空，預設 1）
  • 人數 / 總戰力（億）/ 總隊數：可留空
  • 防守開始時間：由宣戰推算（不再手動輸入）

五、行軍模型

  • 戰敗後行軍回母城，抵達時才開始冷卻。
  • 冷卻結束後，再行軍至目標城參戰。
  • 防守方原地留守，不受行軍影響。

六、城牆與淪陷

  • 城牆每 30 秒結算一次，由「未分配到守方兵力的攻方兵力」造成傷害。
  • 城牆歸零 → 城池淪陷，所有相關路線立刻終止。

七、地圖路線

  • 定義：兩城之間是否有「接觸」，無向圖。
  • 建立方式：快速新增 / 就地編輯 / Modal 編輯 / 地圖拖曳 / Excel 匯入。
  • 匯入格式：城池A-城池B（一行一條）。

八、宣戰清單

  • 進攻：不需路線接觸（可用參數開啟）。需指定「開始時間」= 目標城防守開始時間。
  • 協防：需與出兵城同一盟、且路線上必須有接觸。
  • 去重：每個方向（A→B）只能一種宣戰類型。
  • 新增方式：手動（選出兵城 / 類型 / 目標城）或自動（找下一個未建立組合）。
  • 防守開始時間推算：以所有進攻該城的宣戰中，最早的「開始時間」為準。
  • v8.6.2 跨戰區限制：預設只能同戰區宣戰（可於 ⚙️ 參數設定開啟）。開啟後可跨戰區。

九、出兵清單

  • 由宣戰衍生，設定各路線的戰前% / 復活% / 順序。

十、距離計算

  • 可通行規則：起點盟的城 + NPC 城（NPC 需佔領才能通過）。
  • 演算法：BFS 最短路徑。
  • 顯示模式：距離 / 路徑 / 地圖高亮。
  • v8.6.2：路徑若跨戰區，會顯示跨戰區警告。

十一、地圖戰區過濾（v8.6.2）

  • 地圖工具列可選擇要顯示的戰區。
  • 單戰區模式：只顯示該戰區城池，不畫戰區框。
  • 跨戰區宣戰：以半截虛線箭頭指向可見邊緣，末端標註「→ 目標城名」。
  • 選擇記憶於 localStorage。

十二、戰區管理（v8.6.4）

  • 編輯名稱：戰區列表 → 點 ✏️ → 輸入新名稱。
  • 名稱限制：不可為空、最多 20 字、不可與其他戰區重複。
  • 更名不影響關聯：城池的 zoneId 指向戰區 ID，更名不影響任何連結。
  • 批次修改戰區：城池清單勾選多座 → 選擇新戰區 → 套用。
  • 可將城池設為「（清除戰區 / 未分配）」。

十三、消耗比例矩陣

  • 盟對盟：單元格 = (對手盟均戰 / (我方盟 + 對手盟均戰)) × 每分鐘總消耗隊數。
  • 城對城：單元格 = (對手城均戰 / (我方城 + 對手城均戰)) × 每分鐘總消耗隊數。

十四、協作模式

  • 個人雲端沙盤（v8.6.7 定時上傳）：
    ・登入時無條件下載雲端沙盤（覆蓋本機）
    ・雲端空、本機有 → 自動上傳本機
    ・定時自動上傳（預設 5 分鐘）
    ・重要操作立即上傳
    ・切換分頁 / 最小化時上傳
    ・關閉頁面時上傳
    ・雲端保留最近 20 筆歷史版本，可還原
  • 房間雲端沙盤：房主/幹部+手動上載（與個人沙盤獨立）。

十五、網路中斷保護（v8.6.6）

  • 偵測到離線 → 全螢幕遮罩，暫停操作。
  • 恢復連線 → 自動解除遮罩，繼續操作。

十六、雲端同步狀態（v8.6.7）

  • 狀態指示：模式欄左側顯示同步狀態。
  • 狀態種類：⚪ 未登入 / 🟢 已同步 / 🟡 待上傳 / ⏳ 同步中 / 🔴 失敗。
  • 點擊狀態：開啟雲端歷史版本 Modal。
  • 上傳觸發：定時 / 重要操作 / 切換分頁 / 關閉頁面 / 手動。

十七、帳號與權限

  • 超級管理員：最高權限。
  • 管理員：可停用帳號、修改 extraPerms。
  • 幹部：可創建房間、執行推演、上載沙盤。
  • 成員：本機推演、加入房間、管理自己帳號。

十八、快取策略

  • 由 _headers 控制，改版不用手動換戳記。
  • HTML：max-age=0, must-revalidate（每次驗證 ETag）。
  • CSS / JS：max-age=60（最長快取 60 秒）。