☁️ 云真助手 · Alpha 版 操作说明

📖 起源

在低空经济的浪潮席卷全球之际，飞行器正从稀有的交通工具变为日常。但一个根本问题始终未解：当天空日益拥挤，谁来守护每一次航行的安全？

我们意识到，所有的雷达、通信、导航网络，最终都需要一个“灵魂”——一个能在关键时刻为飞行操作员提供冷静、专业、可靠建议的数字副驾。

理念的诞生，需要名字来赋予生命。我们翻遍了诗篇与散文，从守常先生“守常”的恒心，到徐志摩笔下“云游”的诗意。经历了“云索”、“云常”的辗转推敲，最终在一个深夜，当“云真”二字跃然纸上时，所有人都沉默了。

“云”，是飞行，是徐志摩的空灵与自在。“真”，是执念，是守常先生对真理的不屈探索。

云真，就这样诞生了。它是一个基于语言的建议生成器，输出仅限于飞行分析、解释和建议。它永远不会碰你的驾驶杆。

🎯 项目定位

云真助手（CloudTruth Seeker，简称 CTS-DP） 是一个基于大语言模型的数字飞行副驾系统。

核心信条

⚙️ 技术特性

特性	说明
🌐 在线模式	调用 DeepSeek API 快速推理
📡 离线模式	自动切换本地 Ollama 模型，无需网络
🛡️ 双重安全护栏	正则匹配 + 意图检测，严格拦截操控指令
🎤 语音输入	浏览器语音识别（需 Chrome/Edge）
🔊 TTS 语音播报	AI 回复自动朗读
📋 EFB 电子飞行包	航路、气象、性能、检查单、NOTAM、实时数据
🔧 故障知识库	多机型故障定义与处置建议
⏱️ 飞行计时器	正计时/倒计时，倒计时结束声音提醒
📱 全响应式	手机、平板、桌面自适应

🚀 快速开始

环境要求

• Python 3.10+
• DeepSeek API Key（在线模式需要）
• Ollama（离线模式需要，可选）
• SPAD.neXt（实时飞行数据需要，可选）

克隆仓库

安装依赖

配置环境变量

编辑 .env 文件（如果没有则创建）：

启动应用

浏览器会自动打开 http://127.0.0.1:5000

🛠️ 可选组件配置

启用离线模式（本地 Ollama）

接入实时飞行数据（SPAD.neXt）

• 安装 SPAD.neXt（https://www.spadnext.com）
• 连接模拟器（MSFS/X-Plane）
• 在 SPAD.neXt 设置中开启 Remote Control TCP 服务器（端口 18082）

📋 功能清单

功能	状态	说明
AI 对话（在线）	✅	DeepSeek API 驱动
AI 对话（离线）	✅	Ollama 本地模型
安全护栏	✅	正则 + 意图双重过滤
多机型知识库	✅	A320/B737/C172/H145
EFB 航路	✅	示例数据
EFB 气象	✅	AviationWeather.gov 实时 METAR
EFB 性能	✅	示例数据
EFB 检查单	✅	示例数据
EFB NOTAM	✅	示例数据
EFB 实时数据	✅	通过 SPAD.neXt 接入模拟器
EFB 故障库	✅	多机型故障定义
语音输入	✅	Web Speech API
TTS 语音播报	✅	Web Speech Synthesis
飞行计时器	✅	正计时/倒计时 + 声音提醒
响应式布局	✅	手机/平板/桌面
打包为 exe	✅	PyInstaller

⚠️ 重要提醒

• API Key 保护：.env 文件已被 .gitignore 排除，请勿将真实 Key 提交到公开仓库。
• 安全护栏不完美：当前过滤可拦截大部分操控指令，但对抗性攻击仍需持续优化。
• 离线模型性能：7B 模型在 CPU 上推理较慢，低配电脑建议使用 deepseek-r1:1.5b。
• 语音识别依赖网络：Web Speech API 在离线环境下不可用。

🗺️ 路线图

已完成	规划中
在线/离线 AI 对话	真实航路 API（SimBrief）
安全护栏	故障模拟联动（自动生成训练数据）
多机型知识库	Electron 桌面应用
EFB 电子飞行包	机组协作模式
语音输入 + TTS 播报	声纹识别
PyInstaller 打包

🙏 致谢

徐志摩 — 给予“云”的灵感与诗意

守常先生 — 赋予“真”的执着与信念

DeepSeek — 提供强大的 AI 推理能力

FlyByWire — A320 开源模拟的卓越贡献

SPAD.neXt — 模拟飞行数据桥接

云中求索，逼近真知。在人与AI之间，最终的决定权，永远在人。