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取消选择、空格 + 拖动平移。