01 安装与升级
- 退出 X-Plane 和旧控制台；不要在模拟器仍运行时覆盖插件。
- 保持“一键安装器.EXE”和“本体文件”同级，启动安装器。
- 选择包含 Resources 文件夹的 X-Plane 根目录。安装器识别 XP11/XP12 并复制对应 XPPython3。
- 等待累计进度到 100%；旧版本会被覆盖，授权和用户档案保留在 AppData。
- 先进入驾驶舱，再启动桌面上的控制台。
卸载按钮移除本插件和桌面快捷方式，但不会擅自删除其他插件共享的 XPPython3。
从“填什么”到“为什么这样填”的完整文档
下面不是功能简介，而是可查询的操作手册。所有主要数字都给出单位、有效范围、用途、推荐起点和实际修改位置。
显示 15 个章节
02 连接与更新
| 阶段 | 表示什么 | 失败时检查 |
|---|---|---|
| 0–25% | 等待内部插件在 127.0.0.1:49091 响应 | XPPython3Log.txt |
| 25–55% | 读取基础故障目录 | 确认内部/外部版本一致 |
| 55–90% | 分页读取高级 DataRef | 等待分页完成，不要反复点重连 |
| 90–100% | 同步随机、条件、计划与快捷槽 | 检查本地档案格式 |
“检查更新”会读取官网稳定版号并显示本机/官网版本；失败只影响更新查询，不会改变 X-Plane 连接。
03 故障与修复
简单模式用于按现象选择，例如“发动机起火”；说明列解释可能看到的效果。高级模式用于按系统或 DataRef 精确选择。双击会立即触发，培训时更建议单击选中后再点“立即触发”，避免误操作。
- 修复所选：只把当前目标写回正常值。
- 修复全部：修复插件能发现和跟踪的标准故障；深度机模的私有系统可能仍需机模面板复位。
- 建议首次使用默认机型验证，再测试第三方机型兼容性。
04 随机故障
| 模式/数值 | 单位与意义 | 示例 |
|---|---|---|
| 最短/最长间隔 | 秒；每次触发后在两者之间重新抽取等待时间。最短必须 ≤ 最长。 | 300 / 900 = 5–15 min |
| 固定间隔 | 秒；严格按同一间隔重复抽取。 | 600 = 10 min |
| 指定飞行时间 | 秒；从本次计划计时开始后的绝对时间。 | 1200 = 20 min |
| 到达高度/空速 | 高度为 ft，空速为 kt；从未达到到达到时触发一次。 | 10000 ft / 180 kt |
应用随机计划会把自动训练模式切换为“随机”；条件与计划配置不会删除，只会暂停。
05 条件变量
| 变量 | 单位/范围 | 适合用途 |
|---|---|---|
| 气压/无线电高度 | ft | 爬升门槛 / 近地进近窗口 |
| 指示空速/地速 | kt | 高速中断起飞 / 滑跑 |
| 垂直速度 | ft/min | 快速下降或爬升 |
| 马赫数 | 0–1+ | 高速巡航场景 |
| 航向、俯仰、坡度 | deg | 转弯或姿态条件 |
| 过载 | G | 颠簸或大机动后触发 |
| 襟翼位置 | 0–1 | 0=UP, 1=FULL |
| 燃油 | kg | 低燃油级联 |
| 起落架/接地 | 0 or 1 | 进近构型 / 地面触发 |
between 使用“数值”为下限、“上限”为上限，并包含边界。例如 700 与 1600 表示 700≤变量≤1600。 == 不适合连续浮点量，优先用于 0/1 状态。
06 计划步骤
在 1.0.0 中，单击或双击步骤会把名称、触发、条件、概率、动作、目标、备注和环境快照全部回填到编辑区。修改后点“更新所选步骤”；“添加步骤”始终新建。
| 触发方式 | 时间字段如何解释 | 条件行为 |
|---|---|---|
| 计划开始后指定时间 | 从计划启动计算的绝对秒数 | — |
| 上一动作后延时 | 上一步完成后再等待的秒数 | — |
| 等待条件满足 | 时间框不决定触发 | 持续检查，满足后进入下一步 |
| 指定时间执行判定 | 到该绝对秒数只判断一次 | 不满足则跳过，不继续等待 |
第二判定勾选后，AND 要求两条都成立，OR 只需任意一条。概率 100 表示必然执行，65 表示条件通过后仍有 35% 概率跳过，0 用于暂时禁用但保留步骤。
动作可触发、修复指定、修复全部、显示提示；环境版另有“应用环境变化”和“恢复计划前环境”。环境动作保存的是当时环境页中已勾选值的快照。
07 完整计划例子
例：低能见进近 + 风切变 + 仪表异常
- 步骤 1：建立环境 — 等待无线电高度 between 2200–2800 ft AND 空速 ≥130 kt；应用能见度 2 km、雨量 80%、云底 700 ft、风切变 25 kt、湍流 5。
- 步骤 2：教员提示 — 上一步后 3 秒显示“观察风向与能量趋势”。
- 步骤 3：概率故障 — 上一步后 12 秒，以 60% 概率触发皮托异常。
- 步骤 4：到点判定 — 计划 180 秒时判断无线电高度 <800 ft AND 垂直速度 <-900 ft/min；若满足，显示复飞训练提示，否则跳过。
- 步骤 5：恢复 — 上一动作后 45 秒修复所选故障，再过 5 秒恢复计划前环境。
事故案例仅用于模拟训练设计，不是事故参数的逐秒复刻，也不能替代 QRH/SOP。
08 档案管理
| 格式 | 保存内容 | 何时使用 |
|---|---|---|
| .xpfault | 随机池、条件、计划、快捷槽、环境编辑值、悬浮窗、语言和说明 | 整套课程迁移或备份 |
| .xpplan | 一个或多个动作组及步骤 | 分享场景脚本 |
| .xpenv | 数值、勾选状态、风层、云层、立即提交 | 复用低能见、侧风或湿跑道 |
“查看”只读摘要；“加载”替换当前配置；“合并”保留现有内容并添加新规则，适合把两个课程组合。合并后务必检查重复触发。
09 环境参数总表
只有左侧勾选的参数会写入。风层 1 是最低风层；XP12 最多 13 层，XP11 兼容接口最多 3 层。云层只有 1–3。
| 字段 | 单位/允许值 | 实际效果与填写建议 |
|---|---|---|
| 能见度 | 0.05–160 km | 地平与目标可视距离。0.3=浓雾，2=低能见进近，10=一般薄雾，40+=良好。 |
| 海平面气压 | 870–1085 hPa | 影响高度表基准和性能。标准值 1013.25；不要把机场高度填在这里。 |
| 海平面温度 | -80–60 °C | 影响密度高度与结冰环境。-8 可用于冬季结冰，42 用于高温性能训练。 |
| 降雨强度 | 0–100% | 0 无雨，30 小雨，70 强雨，100 极端训练雨量；通常配合云量和能见度。 |
| 风速 / 风向 | 0–250 kt / 0–360°T | 风向是真方位的来向。270 表示风从西吹来；按所选风层写入。 |
| 风切变增量 / 方向 | 0–120 kt / 0–360° | 表示该层中的速度与方向变化，不等于稳定风。10–20 中等，30–45 严重；应与湍流结合并先在高空验证。 |
| 湍流 | 0–10 | 0 平稳，2–3 轻度，4–6 中度，7–8 严重，9–10 极端模拟值。 |
| 云类型 | 0/1/2/3 | 0 卷云、1 层云、2 积云、3 积雨云；云量决定覆盖程度。 |
| 云量 | 0–100% | 0 晴空，25 少云，50 疏云，75 多云，100 满天；低云雾通常用 100。 |
| 云底 / 云顶 MSL | 0–60000 ft | 都是海平面高度，不是离地高度。云顶必须高于云底；机场标高 500 ft、云底 AGL 700 ft 时应填约 1200 ft MSL。 |
| 热气流升速 | 0–3000 ft/min | 主要影响轻型机和滑翔机；0 关闭，300–800 温和，1200+ 强对流训练。 |
| 海浪高度 / 方向 | 0–15 m / 0–360° | 影响水面场景和水上飞机；普通陆地飞行可不勾选。 |
| 跑道状况 | 0–15 | 0 干；1–6 从潮湿到积水；7–15 从雪到严重结冰。用于制动/方向控制训练。 |
| 天气随机变化 | 0–100% | 0 完全稳定，10 轻微，50 明显，90 高度多变；会降低场景可重复性。 |
| 天气趋势 | 0–7 | 0–2 不同速度好转，3 稳定，4–6 不同速度恶化，7 实时天气。训练预设强制使用 3，避免实时天气覆盖。 |
10 天气生效与排错
- 使用“浓雾/暴雨”预设时，软件自动勾选趋势=3，先切换为手动静态区域天气。
- 所有数值一次写完后提交，约 0.8 秒再提交一次，给 XP12 天气引擎完成云、雾和降雨重建。
- 若第三方天气插件持续写入，它仍可能覆盖本软件。暂停该插件或关闭实时天气后再测试。
- 云底/云顶用 MSL。填错成 AGL 会让云层出现在意外高度，看起来像“未生效”。
11 悬浮窗
| 设置 | 范围与用途 |
|---|---|
| 透明度 | 30–100%；75% 是平衡可读性与遮挡的推荐值。 |
| 宽度 / 高度 | 330–1200 px / 240–1000 px，也可拖动右下角。 |
| 字号 | 8–18；高分辨率屏幕建议 11–13。 |
| 主题与颜色 | 深海夜航、高对比、暖色教员、柔和浅色；也可输入 #RRGGBB 自定义背景、面板、正文、强调和警示色。 |
右键任意位置可打开设置或关闭；顶部自绘区域拖动。字段可单独隐藏，包括随机、条件、计划、当前故障、飞行数据与事件。
12 授权与版本
免费版可用简单故障、随机、快捷槽和前四个条件变量，但不能保存/加载档案。高级版开放高级目录、全部条件、计划和档案。高级+环境版再开放环境页、环境档案与计划环境动作。授权与设备绑定；覆盖升级保留。有效期内换码必须先联网取消当前授权。
13 新飞行清场
检测到机型重新载入或本次飞行计时明显回退时，插件修复可发现故障、清空当前故障与最近事件、把计划退回第 1 步，再按保存的自动模式重新布防。暂停或切换视角不会清场。
14 综合排错
控制台无法连接
确认已进入驾驶舱；检查 Resources/plugins/XPPython3/XPPython3Log.txt 中是否加载 PI_AdvancedFailures.py；确认 49091 没被安全软件阻止；重新运行安装器覆盖不匹配版本。
计划步骤不触发
确认动作组启用、点过“保存并同步计划”、顶部自动模式为“计划故障”；检查 between 上下限、AND 的两条条件和概率是否为 0。
环境后看似掉线
天气重建可能让一两次轮询延迟；软件不会立刻判断线。等待约 2 秒，若仍失败再点重新连接，并查看运行日志的具体 DataRef 失败项。
15 作者与反馈
作者：Fly飞飞；协作制作：Fly飞飞 With Chat GPT；QQ：2168688790。 访问 B站主页.
反馈时请提供软件版本、XP11/XP12、机型、复现步骤、控制台日志末尾和 XPPython3Log.txt 相关行；不要公开完整授权码。