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

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

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

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

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

编程块初始化时自动命名：中文主控为 `XFEAMS系统`，英文主控为 `XFEAMS System`，其它类型为 `XFEAMS-` 加本节点的“编号”。更改编号并重新编译后，名称随生效配置更新；命名不改变通信身份，也没有额外的名称或角色参数。

硬件参数放在对应角色实际使用的节中；此表是名称对照，不表示每个参数能放入任意节。常用配置及部署步骤见 [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` |
| `优先矿种` | `PriorityOres` |
| `检出增量阈值` | `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` |

## 周转与对接参数含义

`[货物] 起飞载荷上限=0.05` 和 `载荷返航阈值=0.95` 只统计矿机本体货仓、钻头、连接器的容量与占用；`OreAmount`、`Empty` 及卸货状态也只统计这些库存中的待卸矿物。设 `起飞载荷上限=0` 时要求待卸矿物清空。运输库存中的非矿物补给保留并计入占用；反应堆、制气机等功能库存供料不计为载荷或待卸矿物，主控不会主动抽取。`[飞行] 起飞质量=0` 的自动称重仍包含本机全部方块与全部库存质量。

`[对接] 等待点距离=80` 是各实际泊位开口 `Forward` 方向的首排等待距离基础值，至少放在该连接器入口再向外一个 `等待点间距` 的位置。主控按连接器实体 ID 稳定排序，用持久保存的 `WaitingSlot` 对应泊位；超过泊位数量后进入下一排，沿同一方向再增加 `等待点间距=20`。连接器绕开口轴旋转不改变等待队列的横竖布局，实际贴合姿态仍匹配连接器自身上方向。泊位组和配置不变时，清理离线名单和重载不改变已有等待位置。

主控收到进港请求时立即登记并分配可用连接器，不等待定时调度或母舰运动稳定窗口；同一连接器保持独占，不同连接器可同时分配进出港。矿机收到位姿后自行检查遥测时效和母舰运动，决定何时实际接近。主控不对进出港整条航道、未来接近线或停泊船球形包络设置封锁。实际相对轨迹预计进入两机船体包络，且预计接触时间已进入包含反馈响应和遥测延迟的避险范围时，才随机选择一方让行；触发后侧移或等待都会加强制动，仍受实际推力限制。一次遭遇保持随机优先顺序，每步侧移最多2米、速度1.5m/s，恢复原方向已无接触风险就解除。近泊位侧移保持姿态，侧移和等待都跟随母舰对应点速度；侧移终点不得跨过按船体半径留出的连接器净空面，前方仍有余量时允许朝接口挪动，已在净空面内则不能继续深入。侧移仍扫描母舰等实际障碍。正式贴合也可短暂停航或执行带扫描的侧移，正常轴向贴合仍免扫描。

主控 `[对接] 接近距离=30` 是起始对接距离的基础值。连接器按实体编号稳定打乱顺序，逐个增加10米，形成30、40、50米等不同入口距离；顺序不随每帧变化，当前分配的距离随存档保留。矿机收到分配后采用该距离，至少保留两倍自身半径；旧遥测没有此字段时才回退本机配置。`航道净空距离`（`LaneClearance`）保留旧参数名，仅控制离港后沿连接器开口方向直飞的基础距离，同样按连接器序号增加10米，并保证飞出入口范围；它不再参与航道冲突判断。

## 页面值

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

## 字体值

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

## 矿种值

`[采矿] 目标矿种=` 默认留空，表示采集全部矿物，包括石头；填写列表则只对列表内的已确认矿物扩挖。此列表是筛选条件，排列顺序不影响优先级。

`优先矿种=铁,钴,镍,硅` 决定已知矿藏的调度顺序，越靠前越优先，未列出的目标矿种同等普通优先。优先矿种仍受目标矿种筛选约束；清空优先列表则所有目标矿种同等优先。矿机实测到的其它矿物仍会记录在扫描图中，穿过表层时挖到的石头等副产物也会正常卸货。已有自定义数据保持原值，需要空目标时手动清空原列表并对接后重新编译；旧任务也会按当前目标和优先配置重新排序。

初始配置注释按常用需求到稀有用途列出全部矿种：铁、钴、镍、硅、冰、镁、银、金、铂、铀，以及石头、废料。支持自定义矿物时也可填写其游戏内部矿种名称。

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

## 对接末段速度

`[对接] 最终接近速度`（`[Dock] FinalSpeed`）默认 `0.5` m/s，有效范围 `0.5`–`1`；旧配置 `0.2`、`0.3` 等低值自动按 `0.5` 执行。已标定矿机在最后 3 m 内确认连续 2 秒稳定对准，最终低速用于最后 1 m，此前随距离逐步减速。正常闭合在对准后保持这一最低指令速度；姿态未稳定、实际障碍、近距让行、遥测或运动条件无效时仍会减速或停航。首次未标定对接仍在至少 6 m、且不小于两倍矿机半径的范围内低速捕获；连接器一旦可连接就立即尝试锁定。

`[显示] 离线判定秒数` 也用于识别整个矿机重建后沿用原编号的情况。旧登记超过该时限未更新、没有采矿任务或孔道占用，新矿机没有任务且正在返航或等候时，可以重新登记并接收泊位分配。仅更换编程块而连接器不变时，可直接确认同一矿机并更新地址。旧采矿占用继续受保护；旧编号仍在线时拒绝第二台同编号矿机。

## 布尔值与别名

| 中文 | 原英文 |
| --- | --- |
| `是` | `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]`。例如 `页面 配置` 显示配置页，`页面 +` 翻子页，`页面 停止` 暂停轮播。