# Flightdesk · 连接 X-Plane

下载与你电脑系统对应的版本。Mac 解压后打开 Flightdesk.app；Windows 解压后打开“安装-Flightdesk.cmd”，保持旁边的 resources 文件夹完整。

首次使用需要官方 Python 3.9 或以上版本，包含 Tcl/Tk：https://www.python.org/downloads/ 。缺少时启动入口会引导安装，不会静默安装系统软件。

## 只需一个安装窗口

1. 电脑运行 X-Plane 12.1.1+ 并载入航班。
2. iPad 网站登录 Max / 开发者账户，在巡航页面点击齿轮，生成 8 位配对码。
3. 在电脑安装窗口输入配对码，点击“安装并连接”。
4. “登录电脑后自动启动”默认勾选。安装完成后可关闭窗口，连接在后台继续。
5. 以后启动 X-Plane 会自动连接；重开网页也会恢复配对，不需要每次输入。

已配对时重新打开同一个安装窗口，可直接点击“启动连接 / 保存设置”。需要更换配对时在此输入新码；取消自动启动则取消勾选并保存。网站“断开并撤销配对”可撤销连接权限。

没有 Start、Re-pair、Enable、Disable 等独立操作入口。

## 如未连接

安装窗口会显示等待 X-Plane、接口禁止入站或网站同步失败等状态。请确认电脑与 iPad 均可联网。
X-Plane 的 Settings → Network 不要选择 Disable Incoming Traffic；默认接口端口为 8086。无需关闭防火墙或配置路由器端口转发。
Mac 如系统提示应用未验证，可用系统的“右键 → 打开”流程确认来源；此安装入口未签名 / 公证。不要关闭系统安全保护。
Mac 官方 Python 如提示证书错误，运行 Python 安装目录中的 Install Certificates.command，再重试安装。
Windows 安装 Python 时选择包含 Tcl/Tk，并勾选 Add Python to PATH。

安装组件及配对配置保存在当前电脑用户目录。自动启动是当前用户级别，无需管理员权限。电脑配对最长保存 180 天；Max 权限先到期时，以权限到期日期为准。主动撤销、换电脑或配对过期后需要重新配对。

## 数据

只读取模拟器位置、地速、高度、真航向、地面状态与最多 63 个 TCAS 目标位置；不控制飞机，不保存账户密码。
HTTPS 同步至 flightdesk.win。短码五分钟有效、使用一次即失效，自动交换的上传凭据保存到当前用户配置中；服务端只保存凭据哈希。不要分享配对码或 connection.json。
服务只保留最新快照，不记录航迹历史；超过十秒的快照不再作为实时数据。联飞 / AI 插件必须向 X-Plane 提供 TCAS 目标，组件不能推断未提供的交通。

已通过模拟接口和安装流程测试，Mac / Windows 实机环境仍需首次联调。

1.7 版：驾驶舱当前 HDG 优先读取 AHARS 仪表航向，未提供时读取电动航向仪，不读取 MCP 目标值；高度显示读取机长高度表指示高度。约 20 毫秒为采样目标，复用本地 HTTP 与云端 HTTPS，交通读取独立进行，不阻塞自身飞机数据。网页收到数据立即刷新仪表数字，地图按屏幕帧率平滑绘制真实采样间的移动，不外推未来位置。实际延迟仍取决于模拟器和网络，不承诺 20 毫秒端到端延迟。

短暂失去同步时保留最后位置并提示，连续 20 秒无新数据才切回设备定位。升级安装保留现有配对，不必生成新码。
升级时打开新版安装窗口，已记住的配对码栏保持空白，点击“启动连接 / 保存设置”；Mac 自动启动会更新后台组件，无需重新配对。
