WebUI 介面導覽
WebUI 是 React + Vite 構建的控制台,通過 /api/v1/ws 與後端通信。它不直接操作遊戲,所有動作都轉化為排程器指令或配置寫入。

頁面地圖
| 頁面 | 路徑 | 用途 |
|---|---|---|
| 首頁 | / | 實例列表、啟動/停止、公告 |
| 總覽 | /i/<实例>/overview | 當前任務、資源、實時日誌、快捷操作 |
| 任務配置 | /i/<实例>/task/<任务> | 由配置 schema 自動生成的表單 |
| 統計 | /i/<实例>/statistics | 資源、出擊、大世界、委託、倉庫報表 |
| 交易所 | /i/<实例>/stock-exchange | 獨立的交易記錄模組 |
| 排程程序 | /i/<实例>/task/SchedulerProgram | 圖形化編排(原排程 / 增強 / 接管) |
| 心智計算器 | /i/<实例>/task/MindCalculator | 船塢掃描與心智單元費用 |
| 艦隊科技 | /i/<实例>/task/FleetTechnology | 科技點掃描與統計 |
| 已安裝配置 | /configs | 匯入、匯出、複製、刪除實例 |
| 設定 | /settings | 賬戶、遠端訪問、更新、介面 |
| 更新 | /updater | 拉取提交、應用更新 |
| 公告 | /announcement | 版本公告與提示 |
總覽頁
總覽把「現在在幹什麼」壓縮到一屏:
- 當前任務:排程器通過
set_task()推送的任務名與狀態。 - 資源:石油、物資、鑽石、行動力等,來自統計與截圖讀取。
- 日誌尾:worker 的實時日誌,按級別著色。
- 快捷操作:啟動 / 停止 / 重新啟動、立即執行某任務、打開截圖。
日誌裡的任務邊界形如:
text
[AzurPilot] 调度器: 开始任务
──────────────── 科研 ────────────────
[AzurPilot] 调度器: 结束任务任務配置頁
左側是任務分組(出擊、活動、大世界……),右側是當前任務的表單。表單由 argument.yaml 的類型定義動態渲染,不是手寫頁面。
表單結構
| 區塊 | 含義 |
|---|---|
| 任務說明 | 任務名旁的問號,來自 i18n 的 help |
| 排程設定 | 啟用、推送、下一次執行時間、成功/失敗間隔、敏感任務 |
| 任務參數 | 該玩法的具體選項,如關卡、艦隊、停止條件 |
| 存儲 | 該任務結果寫入哪張統計表 |
值的類型
| 控件 | 對應類型 | 注意 |
|---|---|---|
| 複選框 | checkbox | 布爾,儲存即生效 |
| 下拉選單 | select / option | 選項值可能是字符串或數字 |
| 輸入框 | input / textarea | 部分字段有正則校驗 |
| 時間 | datetime / time | 清空表示「立即到期」 |
儲存是異步的
編輯器會把修改排隊提交(config.patch),並用 revision 做衝突檢測。看到「已儲存」再離開頁面。多人同時編輯同一實例時,後提交者會收到衝突提示。
敏感任務
Scheduler.Sensitive 打開後,該任務出錯會停止整個實例而不是重新啟動遊戲。預設對 OpsiCrossMonth、OpsiObscure、OpsiAbyssal 生效,因為在這些環節反覆重新啟動可能造成數據損壞。
排程程序(自定義排程)
「任務配置 → 系統 → 自定義排程」提供一個節點畫布:
- 卡片左側是執行入口,右側是出口;方形連接埠控制順序,圓形連接埠傳數據。
- 支援框選、多選、複製粘貼、撤銷重做、全選、刪除連線。
- 常用參數(資源、任務、運算符、等待時間、變數)可直接在卡片上編輯,詳細參數在右側屬性面板。
- 應用前由後端校驗;執行中的實例在任務安全邊界生效。
三種模式:
| 模式 | 行為 |
|---|---|
| 原排程 | 保留既有優先級與時間表;額外支援通用設定裡的石油自動控制 |
| 增強排程 | 程序只能從「已啟用且已到期」的任務中選擇,並可設定本次參數 |
| 完全接管 | 程序決定業務任務,包括未在原配置中啟用的任務;系統恢復仍走現有通道 |
先模擬再應用
編輯器提供模擬器(scheduler.program.simulate),用模擬時間、資源與任務結果跑圖,不連接設備、不寫真實配置。打開編輯器或儲存草稿都不會啟用方案,必須點「應用方案」。
統計與資源
統計頁把 SQLite 總庫裡的記錄變成報表:資源曲線、出擊次數、掉落、大世界收益、委託、科研、倉庫。資源管理視圖額外提供桑基圖與石油控制線。
心智計算器與艦隊科技
- 心智計算器:掃描船塢識別艦船與等級,人工核對後計算心智單元費用,支援 JSON / CSV / XLSX 匯入匯出。
- 艦隊科技:獨立記錄艦船身份與等級,統計科技點,不按心智計費條件排除。
兩者都需要 MindCalculatorScan / FleetTechScan 任務產出數據。掃描會重置船塢篩選,完成前保留舊數據。
系統設定
| 分區 | 內容 |
|---|---|
| 賬戶 | 帳號保險庫:建立、解鎖、綁定 TPM / 本機密鑰、切換設定檔 |
| 遠端訪問 | Cloudflare Quick Tunnel 開關、配對碼、已授權客戶端、撤銷 |
| 更新 | 當前提交、可用提交、拉取與應用 |
| 介面 | 主題、語言、背景圖庫、佈局密度 |
| 配置管理 | 匯入匯出、刪除、複製實例 |
語言與主題
- 介面語言支援
zh-CN、zh-TW、ja-JP、en-US,以及一個彩蛋語言zh-MIAO。配置項的中文說明來自module/config/i18n/*.json。 - 主題跟隨部署設定或介面設定,支援亮色 / 深色。
- 移動端佈局會摺疊側邊欄,任務表單變為單列。
快速鍵與搜尋
- 頂部搜尋框可以搜尋配置項與任務名,支援
Ctrl/Cmd + K聚焦。 - 排程畫布內:
Ctrl/Cmd + Z撤銷、Shift + Z重做、Ctrl/Cmd + A全選、Esc取消選擇、空格 + 拖動平移。