故事始于一次关于“数字飞行家”的低语。
在低空经济的浪潮席卷全球之际，飞行器正从稀有的交通工具变为日常。但一个根本问题始终未解：当天空日益拥挤，谁来守护每一次航行的安全？
我们意识到，所有的雷达、通信、导航网络，最终都需要一个“灵魂”——一个能在关键时刻为飞行操作员提供冷静、专业、可靠建议的数字副驾。
理念的诞生，需要名字来赋予生命。我们翻遍了诗篇与散文，从守常先生“守常”的恒心，到徐志摩笔下“云游”的诗意。经历了“云索”、“云常”的辗转推敲，最终在一个深夜，当“云真”二字跃然纸上时，所有人都沉默了。
“云” — 是飞行，是徐志摩的空灵与自在。
“真” — 是执念，是守常先生对真理的不屈探索。
云真，就这样诞生了。它是一个基于语言的建议生成器，输出仅限于飞行分析、解释和建议。它永远不会碰你的驾驶杆。
云真助手（CloudTruth Seeker，简称 CTS-DP） 是一个基于大语言模型的数字飞行副驾系统，面向从通用航空到深空探索的全场景飞行操作支持。
飞行情境分析、态势解释、决策建议、风险研判
绝不输出任何物理操控指令
绝不代替飞行操作员做出最终决策
绝不输出任何机器控制代码
云真助手内置 7 种机型知识库，覆盖从通用航空到深空探索的全场景：
💡 智能识别：在问题中提及特定机型时，系统会自动切换机型并开启专家模式。
| 功能 | 说明 |
|---|---|
| 🌐 在线模式 | 调用 DeepSeek API 快速推理，1-5 秒回复 |
| 📡 离线模式 | 自动切换本地 Ollama 模型，无需网络 |
| 🛡️ 双重安全护栏 | 正则匹配 + 意图检测，严格拦截操控指令 |
| 🎤 语音唤醒 | 页面加载后自动监听，说"你好，云真"即可唤醒（需 Chrome/Edge） |
| 🔊 TTS 语音播报 | AI 回复自动朗读，解放双眼 |
| 📋 EFB 电子飞行包 | 航路、气象、性能、检查单、NOTAM、实时飞行数据、故障库 |
| 🔍 智能机型识别 | 根据问题自动切换机型并开启专家模式 |
| 📚 专家模式 | 强制优先使用知识库内容（可手动切换或自动触发） |
| ⏱️ 飞行计时器 | 正计时/倒计时，倒计时结束声音提醒 |
| ⌨️ 键盘快捷键 | F1-F7 控制计时、TTS、专家模式等 |
| 📱 全响应式 | 手机、平板、桌面自适应 |
编辑 .env 文件：
浏览器会自动打开 http://127.0.0.1:5000
当没有网络时，云真助手会自动切换到本地 Ollama 模型。
💡 低配电脑建议使用 deepseek-r1:1.5b，修改 .env 中 OLLAMA_MODEL 即可。
接入后，EFB 的“📡 实时”标签将显示真实的飞行参数。
| 按键 | 功能 |
|---|---|
| F1 | 开始计时 |
| F2 | 暂停计时 |
| F3 | 复位计时 |
| F5 | 聚焦输入框 |
| F6 | 切换 TTS 语音播报 |
| F7 | 切换专家模式 |
| Esc | 停止语音播报 |
| 空格 | 开始/停止录音 |
| 问题 | 解决方法 |
|---|---|
| venv\Scripts\activate 无法运行 | 执行 Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned |
| 语音唤醒无反应 | 使用 Chrome/Edge，允许麦克风权限，确保网络在线 |
| 在线模式无回复 | 检查 .env 中的 API Key 是否正确 |
| 离线模式调用失败 | 确认 Ollama 已启动（ollama serve），模型已下载（ollama list） |
| 离线模型回复超时 | 低配电脑建议使用 deepseek-r1:1.5b |
| 端口被占用 | 关闭其他云真助手实例 |
| 打包后程序无法运行 | 确保 templates/ 和 knowledge/ 文件夹与 exe 在同一目录 |
.env 文件已被 .gitignore 排除，请勿将真实 Key 提交到公开仓库。deepseek-r1:1.5b。徐志摩 — 给予“云”的灵感与诗意
守常先生 — 赋予“真”的执着与信念
DeepSeek — 提供强大的 AI 推理能力
FlyByWire — A320 开源模拟的卓越贡献
SPAD.neXt — 模拟飞行数据桥接
云中求索，逼近真知。
在人与AI之间，最终的决定权，永远在人。
📂 开源项目 · GPL-3.0 许可证