CPilot - 为 APOC 开发的集成性飞行客户端

CPilot 是一个功能完整的虚拟航空飞行客户端，支持 Microsoft Flight Simulator 2024 和 X-Plane 12，提供实时飞行数据记录、FSD 网络连接与上传、PIREPs 评分系统、语音通信等功能。

🌟 主要功能

虚拟航空网络

• FSD 连接 - 支持 VATSIM 协议的 FSD 服务器连接
• 密码认证 - 安全的飞行员身份验证
• 实时位置上报 - 自动上报飞行位置和状态
• 语音通信 - 集成语音频率调频功能

飞行记录与评分

• 实时飞行数据记录 - 记录 130+ 个飞行参数，每秒采样一次
• 智能 PIREPs 评分系统 - 基于 20+ 项规则的自动评分
• 详细飞行分析 - 最大高度、最大速度、燃油消耗等统计数据
• 飞行轨迹保存 - 完整的飞行路径和参数记录

飞行阶段识别

• 13 个飞行阶段自动识别
• 智能判定系统精准判断飞行状态

多模拟器支持

• Microsoft Flight Simulator 2024
• X-Plane 12
• 自动检测 - 全自动化检测模拟器数据

📋 系统要求

硬件要求

• 操作系统：Windows 10 / Windows 11
• 处理器：Intel Core i5 或更高
• 内存：8 GB RAM 或更高
• 存储：500 MB 可用空间

软件要求

• 模拟器：
  • Microsoft Flight Simulator 2024，或
  • X-Plane 12
• 运行库：
  • Qt 6.10.1
  • Visual C++ Redistributable 2022

🚀 快速开始

安装

1. 从 Releases 下载最新版本
2. 运行 CPilotSetup.exe 安装程序
3. 按照安装向导完成安装

基本操作

1. 连接模拟器
   - 自动检测已安装的模拟器
   - 或手动指定模拟器路径

2. 连接 FSD 服务器
   - 输入 CID 和密码
   - 选择语音频率

3. 开始飞行
   - 自动记录飞行数据
   - 实时显示飞行状态

4. 提交 PIREP
   - 飞行完成后自动评分
   - 查看详细的飞行分析

📊 PIREPs 评分系统

评分等级

等级	分数	说明
A+	95-100	完美飞行
A	90-94	优秀飞行
B+	85-89	良好飞行
B	80-84	及格飞行
C	70-79	一般飞行
D	60-69	较差飞行
F	0-59	不及格飞行

主要扣分项

• 着陆质量：坠机着陆 (-30分)、硬着陆 (-10分)、稍重着陆 (-2分)
• 速度违规：失速 (-10分)、超速 (-10分)、低空超速 (-3分)
• 飞行姿态：危险坡度 (-10分)、G力过大 (-5分)
• 发动机故障：双发失效 (-20分)、单发失效 (-10分)
• 其他违规：襟翼超速 (-8分)、起落架超速 (-8分)

详细规则请参考 PIREPs 评分规则文档

🎮 飞行阶段系统

系统自动识别以下飞行阶段：

准备阶段 → 滑行 → 起飞滑跑 → 起飞 → 爬升 → 巡航 
                                    ↓
                                  下降 → 进近 → 最终进近 → 着陆 → 着陆滑跑 → 停机

每个阶段都有对应的规则检查和事件记录。

🛠️ 开发指南

构建项目

# 使用 Qt Creator 打开项目
# 或使用命令行构建

mkdir build
cd build
cmake ..
cmake --build . --config Release

编译要求

• Qt 6.10.1 (MSVC 2022)
• CMake 3.20+
• Visual Studio 2022

代码规范

• C++ 标准：C++17
• 命名规范：
  • 类名：PascalCase
  • 函数名：camelCase
  • 成员变量：m_camelCase
  • 常量：UPPER_CASE

🐛 已知问题

• X-Plane 12 需要手动安装插件到正确的路径
• 某些网络环境下 FSD 连接可能不稳定
• 语音通信需要稳定的网络连接

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

提交 Issue

请包含以下信息：

• 问题描述
• 复现步骤
• 系统信息（OS、模拟器版本等）
• 错误日志

提交 PR

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

👥 作者

• JiangQian - 主要开发者
• SimpleFSD - 后端项目
• half_nothing - 提供项目支持

🙏 致谢

感谢以下项目和社区的支持：

• Qt Framework
• VATSIM
• X-Plane
• Microsoft Flight Simulator

📞 联系方式

• 官网：https://www.apocfly.com/
• 邮箱：niannian@apocfly.com
• Discord：ApocFly 社区

🗺️ 路线图

v1.4.0 (计划中)

• 支持更多虚拟航空网络
• 增强的飞行分析功能
• 多语言支持

v1.5.0 (计划中)

• 飞行回放功能
• 高级统计分析
• 社区飞行排行榜

📊 项目统计

• 代码行数：15,000+
• 支持的参数：130+
• 评分规则：20+
• 飞行阶段：13 个

---

最后更新：2025-01-24
当前版本：1.3.2