选项参考(Options Reference)

主控件按部分分组。通过 Plugins -> NextATC -> Options 打开。

本页是参考手册。关于「如何操作」的内容,请参阅各主题 FAQ 页面。

Assign keys in X-Plane 提示下方的小语言按钮可切换菜单和选项语言。 该设置会应用到 Options、Traffic Options 和完整的 NextATC 插件菜单,并会保存所选语言。

更新#

• 自动检查更新 —— 启动时检查新版本。
• 发布通道 —— Stable 仅接收稳定版；Beta 接收 beta 和稳定版；Alpha 接收 alpha、beta 和稳定版。若未保存偏好，alpha 或 beta 版本会一次性选择对应通道并通知用户。Alpha 需要已连接且具备支持者权限的 Patreon 账户，否则通道会恢复为 Beta。
• Patreon Alpha access —— Connect Patreon 会在浏览器中通过 Patreon 登录，以获取支持者权益和 Alpha 版本；Disconnect 会移除该连接；My Bug & Feature Reports 会在网站上打开您的报告。状态行会显示 Logged in as，后接您的名称和访问权限。Beta 和 Stable 更新无需连接 Patreon。
• Navigraph 导航数据 Downloader —— 连接 Navigraph 帐户、立即下载 AIRAC、重置已保存登录或启用启动时下载。

常规#

• Autostart on X-Plane startup —— 在启动时自动开启 ATC。
• 启动画面 —— 在插件启动时显示启动画面。
• 为首次飞行计划请求自动调谐 COM1 —— 开始提交飞行计划时，将 COM1 调至首个有效的 Delivery/Ground/Tower 频率。
• Random flight on start —— 在插件启动时选择一个随机起飞机场并提交一份随机飞行计划。
• Region filters —— 六个复选框(Europe、North America、South America、Africa、Asia、Oceania),将随机航班选择器限制为所选区域的并集。
• Export GeoJSON files —— 导出航路几何文件以便检查。
• Enable Debug —— 为错误报告输出详细日志。
• GUI animations —— 启用或禁用界面动画。
• 提示音 —— 切换 Radio Log 动作按钮出现时播放的提示音；关闭会禁用它，选中的 提示音会立即预览。

NextATC 窗口显示器#

强制将插件窗口及覆盖层显示在指定显示器上。Auto / Primary 是默认值,适用于单显示器设置。

屏幕显示#

• OSD flash messages —— 屏幕上叠加的简短状态闪信。

主题#

切换界面强调色。当前主题:Yellow、Blue、Green、Cyan。同一区域还有语言按钮、 插件界面缩放 和 文字样式（无、Outline、Drop Shadow、Thick Outline 或 Shadow + Outline）。

如果文字在你的显示器或驾驶舱背景上不够清晰，请尝试其他文字样式，提高插件文字 界面缩放，并选择对比度更高的主题。

字体渲染#

字体配置选择内置的界面/运行文本组合：Red Hat、Atkinson Hyperlegible、IBM Plex、JetBrains Console、Cascadia Terminal（默认）、Source、Geist、Intel One Mono 或 Google Sans Code。插件界面缩放在 100%～200% 间切换。字形按 X-Plane 表面的物理分辨率重新栅格化；窗口、间距、控件、点击区域、无线电消息、帮助/手册和初始教程同步缩放。屏幕空间不足时内容会换行、重新排列或滚动；地图缩放和地理几何保持不变。

AA立即生效并保存：均衡（默认）使用带轻度微调的灰度抗锯齿；清晰使用较强微调，通常适合 Windows 或低 DPI；平滑不使用网格微调，通常适合 Retina/高 DPI 或较大缩放；像素关闭抗锯齿。请在实际的操作系统和 X-Plane 缩放比例下比较。所有模式在受支持的 XP11 与 XP12 中使用相同的可移植实现，并且只影响 NextATC 文本。由于 X-Plane 合成、VR、显示缩放和 RGB/BGR 像素顺序无法可靠保留效果，因此不提供 RGB 子像素渲染。

文本转语音（TTS）#

NextATC 的 Kokoro 和 Piper 语音在下载后直接于插件内运行，不需要 X-ATC-Chatter 所使用的独立 VoiceBox 应用。

• Read ATC messages (TTS) —— ATC 朗读无线电通话。
• Speech engine —— 选择 Operating system、Microsoft Azure、Kokoro (offline) 或 Piper (offline)。Azure 需要提供密钥和区域；Kokoro 与 Piper 需要已下载的本地语音模型。
• Voice roles / Download... —— 打开所选引擎的语音控制面板。对于本地模型，先点击 Download，再按 Download selected，选择飞行员和 ATC 语音，最后点击 Save voice roles。详见 语音与一键通话(Push-to-Talk)。
• Volume % (Azure / Kokoro / Piper, 0-200) —— 调整对应引擎的音量。在 Windows 上，该字段为 Volume % (0-200)，并同样适用于操作系统语音。
• Radio voice effect (Azure / Kokoro / Piper) —— 配置音频过滤器并使用 Test 预览。在 Windows 上，该部分名为 Radio voice effect，并同样适用于操作系统语音；在 macOS 和 Linux 上，操作系统自带的语音不受此影响。
• Disable voice on readback —— 飞行员复诵时保持静音。
• Microsoft Azure TTS Stats —— 显示当前和上一个 UTC 自然月中仅 Azure 的请求数、估算字符数，以及已保存的 10～99% Free Tier F0 安全阈值。限制与免责声明请参阅 Azure 设置。

Push-to-Talk 识别（实验性）#

Whisper 识别飞行员的麦克风音频。Windows 上的 CUDA 和受支持 Mac 上的 Metal 可以加快处理速度，但不会生成管制员的 TTS 语音，也不保证使用相同模型时转写更准确。

所有语音识别、模型、GPU 和麦克风设置都集中在专用的 Speech 标签页；云端和本地 TTS 仍位于 Voice 标签页。

• AI Voice Recognition (Experimental) —— 启用或禁用语音识别。
• Talk Mode 按钮 —— 在 Talk Mode: Hold-to-Talk(说话时按住)和 Talk Mode: Toggle Talk(按一次开始、再按一次停止)之间循环。
• Auto-toggle guided prompts —— 在复诵流程打开时自动开始监听,无需按 PTT。
• Auto-submit after no new words [sec] (0=off, 1-10) —— 在切换模式下,N 秒静音后结束当前话语。
• Microphone 按钮 —— 选择输入设备。
• Voice Models —— 安装/刷新/选择识别模型;下方的状态标签显示安装进度和语言。
• 多语言模型支持（默认：英语） —— 将每个模型尺寸切换为单独下载的多语言 Whisper 版本。Whisper 会自动检测说话语言,但 NextATC 仍期待英语 ATC 复诵。
• 使用 GPU 加速 —— 使用复选框旁显示的后端：受支持的 Apple silicon Mac 使用 Metal，Windows 使用 NVIDIA CUDA。Windows 安装包包含 CUDA 模块，并使用 PC 上安装的 NVIDIA CUDA Toolkit 12.8 或 12.9。安装 Toolkit 后请重启 X-Plane。Steam 版和独立版使用同一个插件本地模块。启用语音识别时，如果后端可用，此复选框会自动选中；没有可用后端时，它仍会显示，但处于禁用的灰色状态，且下方显示具体探测失败原因。关闭此复选框可强制使用 CPU 识别。

此功能仍处于实验阶段。语音模型把麦克风音频转换为文本,然后插件把该文本与 ATC 流程当前期待的复诵或动作进行比对。它不是自由对话引擎。三个模型按钮选择不同的内置 Whisper 模型尺寸,速度、磁盘空间和 CPU 要求各不相同。英语版本为默认选项;多语言版本需要单独下载。请把 Whisper Base English 作为稳定基准;当你需要更好的口音处理并能接受更慢的本地转写时,再使用更大的模型。选择已安装的模型或完成模型下载后,语音识别会自动启用,并显示 push-to-talk 提示。

实用指南请参阅 语音与一键通话(Push-to-Talk)。

可恢复的 GPU 加载、模型初始化或推理错误将尝试通过内置的 CPU 路径重试。上游 GPU 运行时抛出的致命错误无法在进程内恢复。

对话生成和 AI（实验性）#

• NextATC —— 内置标准用语(默认)。
• AI - Gemini —— 云端 AI 驱动的语句变体,需要 API Key(按钮旁的文本字段)。
• 模型 —— 在 Gemini Flash 和 Gemini Flash-Lite 之间切换；NextATC 始终使用 Google 发布的各模型的最新版本。
• Gemini variation —— 在四种实验性推理风格之间切换,用于测试不同的改写行为。改变的是措辞风格,不是放行内容。
• AI - <model> (Local paused, Experimental) —— 列出了本地模型条目,但目前不可用,无法选择。
• Test AI ATC —— 通过当前后端运行一次快速放行,以便您验证 API 密钥。

AI 输出会经过校验。如果校验失败,插件会回退到内置语句,以确保放行准确。

请对当前 AI 对话模式保持较低预期。Gemini 不运行 ATC 逻辑,不选择放行内容,也不会发明运行决策。跑道、高度、频率、航路、应答机码、滑行指令和阶段仍由 C++ 流程计算。Gemini 只接收已经验证的模板,并尝试为同一条消息生成稍微自然一些的变体。

AI 语句变体会刻意保持保守。变化可能很轻微,如果生成语句改变事实、丢失必要的 TTS 标记或加入不安全信息,很多都会被校验拒绝。这是预期行为。此时会使用内置语句。

通话用语与无线电#

• Radio procedure region —— 选择欧洲（默认）或美国；目前仅改变 Radio Check 的回复。
• Allow non-standard phraseology —— 允许较宽松的语句变体。
• ATC radio static effect —— 仅在带有原生静电效果的版本中可用。
• Release radio between dialogs —— 在消息组之间释放无线电。
• Point instead decimal in radio comms —— 用「point」代替 decimal。
• Check Squawk Code —— 当应答机代码与指派的 squawk 不一致时发出警告。

无线电日志#

• Enabled —— 显示 Radio Log。
• Max visible lines (1-8) —— 限制可见的历史行数。
• Auto-hide —— 一段时间无操作后隐藏日志。
• Auto-hide timeout [sec] (2-999, 0=never) —— 隐藏前等待的秒数。
• Show anchor dot when hidden —— 隐藏时保留一个小的可点击锚点。
• Use sim time for timestamps —— 使用模拟器时间而非真实时间。

Radio Copilot#

• 记住 Radio Copilot 状态 —— 插件重新加载后恢复当前 ON/OFF 状态。关闭后，下次 Radio Copilot 始终以 OFF 状态启动。
• Radio Log 中的 Radio Copilot · ON/OFF 控件用于控制当前会话。AutoFly 拥有无线电优先权，并会在工作期间将 Radio Copilot 显示为暂停。

SimBrief#

• SimBrief Pilot ID —— 您的 SimBrief 账户数字 ID。由 Fetch from SimBrief 使用。

雷达引导#

• Reduce heading vector calls —— 减少重复的修正指令。
• Precise heading —— 更严格的航向处理。
• Calculate wind correction angle —— 在航向值中计入风修正。

高度#

• 自动选择当地气压术语和单位 —— 根据已知的出发／到达机场国家规则，选择 QNH 或 altimeter，以及 hPa 或 inHg。默认关闭，Realistic 配置会将其启用。
• 手动设置 / 自动回退：QNH 和 hPa —— 在手动模式下或自动策略未知当地规则时使用 QNH/hPa。
• Altimeter [inHg] with decimal —— 将 inHg 朗读为小数值。
• Low altitude speed restriction —— 在低空超速时发出警告。
• Check ground elevation —— 包含地形检查。
• Respect SIDs and STARs restrictions —— 遵循程序高度区间。

飞行辅助#

• 航向指示器 —— 航向引导覆盖层。
• Draw taxi guide on ground —— 在滑行时绘制滑行引导。

交通#

Options 中的 Traffic 标签页包含以下交通相关部分：Traffic、Synthetic Traffic 和 Traffic 3D Labels。与之配套但位于 Options 之外(在 Plugins -> NextATC -> Traffic 子菜单)的控件,列在 交通(Traffic) 中。

交通（主开关）#

• Traffic engine —— 运行时开/关。与菜单切换项同步。
• Enable Traffic at startup —— 在重启间保留运行时开/关状态。
• Publish to X-Plane TCAS/map —— 通过 X-Plane 的 TCAS datarefs 发布合成飞机,使其他插件(Nav Display、第三方雷达屏)也能看到。
• Draw 3D aircraft —— 在 3D 世界中绘制合成交通(关闭后只在 TCAS/Nav Display 中保留,以提升性能)。

合成交通#

• Traffic amount —— 在 Low、Medium、High、Ultra High 和 Nuts 之间切换地面与空中合计的交通预算。机场配置和当地时间会调整实际数量；准确范围见 交通(Traffic)。

交通 3D 标签#

• Show breathing label over each aircraft —— 切换 3D 标签。
• Color R / G / B (0-255) —— 三个文本字段,每个对应一个通道。
• Alpha min (0.00-1.00) / Alpha max (0.00-1.00) —— 脉冲不透明度范围。
• Pulse period (ms, 100-30000) —— 脉冲速度,以毫秒计。
• Max distance (NM, 0.1-200) —— 超过此距离后隐藏标签。
• Content mode (0/1/2) —— 仅呼号、呼号 + 飞行高度层,或呼号 + 机型。

其他交通控件#

Bluebell CSL 安装和 Traffic 快速切换项位于独立的 Plugins -> NextATC -> Traffic 子菜单中 —— 参阅 交通(Traffic)。

另见#

• 语音与一键通话(Push-to-Talk)、AI 与 LLM 功能、Azure 设置、交通(Traffic) —— 实用指南页。
• 故障排查 —— 关于「我改了点东西现在出问题了」。