# XFE AMS 中文参数与命令对照

本表由 `Localization/parameters.zh-CN.json` 中的映射整理，覆盖当前支持的全部参数名称、枚举值和公开运行命令。中文版输入中文或原英文均可；英文版模板和命令使用英文。新增翻译时同步更新资源与本表。

配置格式仍为 INI，使用半角 `[]`、`=`，小数使用 `.`，矿种列表使用半角逗号。比例填写 0～1，例如起飞载荷上限 `0.05` 表示 5%。同一参数同时使用中英文且值不同会报告配置冲突，不会静默选择一个。已有自定义数据不自动改写。

脚本类型由主控、矿机、标点或看门狗文件固定决定，已删除 `角色` / `Role` 配置。旧字段仅作为兼容输入忽略，即使值错误或中英文值不同也不会阻止初始化；无需手工处理旧条目。

编号、舰队编号、主控编号、真实方块名称及方块组名称属于用户数据，保持原文。中英文舰队混用时必须填写完全一致的舰队编号与主控编号；默认“采矿舰队”和 `mining` 不等价，默认“主控”和 `base` 不等价。不要直接改 ID 来迁移旧存档。

硬件参数放在对应角色实际使用的节中；此表是名称对照，不表示每个参数能放入任意节。常用配置及部署步骤见 [README](../README.md)。默认 `[硬件] 自动标定=是`：硬件就绪的待机矿机自动请求接港，用实际连接器安装位置和朝向完成首次对接，真实连接后保存标定。设为 `否` 时，未标定矿机仍需人工接港并执行标定；主动暂停或交还控制不会被自动接港覆盖。`[飞行] 起飞质量=0` 自动测量；`[货物] 起飞载荷上限=0.05`。

中文版的两套默认组名互相兼容：找不到“采矿泊位”时查找 `AMS Docks`，找不到“基地货仓”时查找 `AMS Cargo`，反向同样适用。精确匹配的已有组优先，自定义组名不做替换；只收集选定组内的母舰本体方块，配置原文不变。

## 配置节

| 中文 | 原英文 |
| --- | --- |
| `系统` | `System` |
| `硬件` | `Hardware` |
| `飞行` | `Flight` |
| `采矿` | `Mining` |
| `探索` | `Survey` |
| `能源` | `Energy` |
| `货物` | `Cargo` |
| `对接` | `Dock` |
| `舰队` | `Fleet` |
| `显示` | `Display` |
| `看门狗` | `Watchdog` |
| `标点` | `Marker` |
| `屏幕` | `AMS.Screen` |

## 参数名称

| 中文 | 原英文 |
| --- | --- |
| `编号` | `Id` |
| `舰队编号` | `FleetId` |
| `主控编号` | `BaseId` |
| `方块组` | `Group` |
| `控制器` | `Controller` |
| `连接器` | `Connector` |
| `使用氢气` | `UsesHydrogen` |
| `自动标定` | `AutoCalibrate` |
| `钻尖偏移` | `DrillTipOffset` |
| `安全间距` | `Clearance` |
| `起飞质量` | `DepartureMass` |
| `悬停余量` | `HoverReserve` |
| `位置增益` | `PositionGain` |
| `速度增益` | `VelocityGain` |
| `最大角速度` | `MaxAngularRate` |
| `姿态增益` | `AttitudeGain` |
| `每帧扫描射线` | `RaysPerTick` |
| `巡航速度` | `CruiseSpeed` |
| `退钻速度` | `RetreatSpeed` |
| `钻头覆盖宽度` | `FootprintWidth` |
| `钻头覆盖高度` | `FootprintHeight` |
| `重叠比例` | `Overlap` |
| `孔道半径` | `HoleRadius` |
| `钻进速度` | `DrillSpeed` |
| `单趟进尺预算` | `SortieDepthBudget` |
| `入口高差上限` | `MaxEntryRelief` |
| `接近距离` | `ApproachDistance` |
| `目标矿种` | `TargetOres` |
| `检出增量阈值` | `DetectionAmount` |
| `入口净空距离` | `StandOff` |
| `旧版载荷返航阈值` | `CargoReturn` |
| `搜索半径` | `Radius` |
| `试钻深度` | `ProbeDepth` |
| `母舰安全间距` | `BaseClearance` |
| `采样间距` | `Spacing` |
| `扫描距离` | `ScanDistance` |
| `太空扫描射线` | `SpaceRays` |
| `扩挖宽度` | `ExpansionWidth` |
| `扩挖高度` | `ExpansionHeight` |
| `最大深度` | `MaxDepth` |
| `任务数量上限` | `MaxJobs` |
| `初始功率` | `InitialMW` |
| `初始氢气续航` | `InitialHydrogenEndurance` |
| `靠泊预留秒数` | `DockReserveSeconds` |
| `能源安全系数` | `ReserveFactor` |
| `紧急能源余量` | `EmergencyReserve` |
| `电量返航阈值` | `ReturnBattery` |
| `低电阈值` | `LowBattery` |
| `充电目标` | `ChargeTarget` |
| `低氢阈值` | `LowHydrogen` |
| `补氢目标` | `HydrogenTarget` |
| `载荷返航阈值` | `ReturnFill` |
| `起飞载荷上限` | `DepartureFill` |
| `母舰速度上限` | `MaxBaseSpeed` |
| `母舰角速度上限` | `MaxBaseAngularDeg` |
| `母舰加速度上限` | `MaxBaseAcceleration` |
| `遥测时效上限` | `MaxTelemetryAge` |
| `最终接近速度` | `FinalSpeed` |
| `平稳窗口秒数` | `StableSeconds` |
| `等待点间距` | `WaitingSpacing` |
| `等待点距离` | `WaitingDistance` |
| `航道净空距离` | `LaneClearance` |
| `等待预算秒数` | `WaitBudgetSeconds` |
| `泊位方块组` | `DockGroup` |
| `基地货仓组` | `CargoGroup` |
| `矿机数量上限` | `MaxMiners` |
| `屏幕标签` | `Tag` |
| `页面` | `Page` |
| `内置屏幕` | `BuiltIn` |
| `内置屏幕页面` | `BuiltInPage` |
| `字体` | `Font` |
| `离线判定秒数` | `OfflineSeconds` |
| `自动翻页` | `AutoPage` |
| `轮播间隔秒数` | `PageInterval` |
| `手动停留秒数` | `ManualHoldSeconds` |
| `每帧绘制屏数` | `ScreensPerTick` |
| `启用` | `Enabled` |
| `超时秒数` | `Timeout` |
| `业务编程块编号` | `BusinessId` |
| `摄像机` | `Camera` |
| `绑定矿机` | `Miner` |

## 页面值

| 中文 | 原英文 |
| --- | --- |
| `舰队` | `fleet` |
| `矿机` | `miner` |
| `矿区` | `map` |
| `诊断` | `diagnostics` |
| `配置` | `config` |

## 字体值

| 中文 | 原英文 |
| --- | --- |
| `默认` | `Debug` |
| `等宽` | `Monospace` |

## 矿种值

| 中文 | 原英文 |
| --- | --- |
| `铁` | `Iron` |
| `镍` | `Nickel` |
| `钴` | `Cobalt` |
| `镁` | `Magnesium` |
| `硅` | `Silicon` |
| `银` | `Silver` |
| `金` | `Gold` |
| `铂` | `Platinum` |
| `铀` | `Uranium` |
| `石头` | `Stone` |
| `冰` | `Ice` |
| `废料` | `Scrap` |

## 布尔值与别名

| 中文 | 原英文 |
| --- | --- |
| `是` | `true` |
| `否` | `false` |
| `开启` | `true` |
| `关闭` | `false` |

## 运行命令

| 中文 | 原英文 |
| --- | --- |
| `初始化` | `init` |
| `诊断` | `diagnose` |
| `标定` | `calibrate` |
| `标点` | `mark` |
| `探索` | `survey` |
| `启动` | `start` |
| `暂停` | `pause` |
| `继续` | `resume` |
| `返航` | `return` |
| `全部返航` | `return-all` |
| `交还控制` | `release` |
| `重新扫描` | `rescan` |
| `清空任务` | `clear-tasks` |
| `清空全部任务` | `clear-all` |
| `清理离线矿机` | `clear-offline` |
| `清空离线矿机` | `remove-offline` |
| `释放航道` | `release-lease` |
| `页面` | `page` |
| `布防` | `arm` |
| `触发保护` | `trip` |

## 页面子命令

| 中文 | 原英文 |
| --- | --- |
| `下一页` | `next` |
| `上一页` | `prev` |
| `播放` | `play` |
| `停止` | `stop` |
| `自动` | `auto` |

## 新部署默认名称

| 中文 | 原英文 |
| --- | --- |
| `采矿舰队` | `mining` |
| `主控` | `base` |
| `矿机` | `miner` |
| `标点终端` | `marker` |
| `看门狗` | `watchdog` |
| `采矿泊位` | `AMS Docks` |
| `基地货仓` | `AMS Cargo` |
| `采矿屏幕` | `AMS Screens` |
| `[采矿屏幕]` | `[AMS LCD]` |

## 主控定向操作

在主控使用“命令 矿机编号”操作指定矿机，例如 `返航 深空工业1号`、`诊断 深空工业1号`、`继续 深空工业1号`。编号中含空格也可使用，动词后剩余文本作为完整编号。`全部`、`all`、`*` 可指定全部在线矿机。

不带目标的 `初始化` / `init` 会立即清空主控全部历史存档、任务、矿区、矿机名单、占用许可及运行缓存，保留自定义数据配置；旧格式不再迁移，正在恢复或恢复失败时也能清空。重置后暂停派工，在线矿机取消旧任务并安全返航。重新创建任务后运行 `启动`。

可定向或群控的命令：初始化、重新扫描、诊断、标定、启动、继续、暂停、返航、交还控制。其中 `初始化 矿机编号`、`初始化 全部` 仍只让目标矿机重扫硬件，不清空主控；不带目标的 `重新扫描` 重扫主控和在线矿机，不删除存档。不带目标的 `诊断` 仅显示主控。页面命令操作当前编程块管理的屏幕，不远程切换目标矿机屏幕。

“释放航道”对应原 `release-lease`，实际仅请求释放指定矿机的进出港通道；仍需新鲜的真实接港或已离开航道的证据，不能用于清除任意采矿任务。“清空任务”和“清理离线矿机”的安全占用规则见 README。看门狗“布防/触发保护”仍在独立看门狗执行。

屏幕配置可使用 `[屏幕]`、`[屏幕.1]`、`[屏幕.2]` 等，对应 `[AMS.Screen]`、`[AMS.Screen.1]`、`[AMS.Screen.2]`。例如 `页面 配置` 显示配置页，`页面 +` 翻子页，`页面 停止` 暂停轮播。