云真助手 · Alpha 版操作说明 · 数字飞行家

产品简介

云真助手（CloudTruth Seeker，CTS-DP） 是一款专为飞行操作员设计的数字飞行副驾，基于大语言模型提供专业、实时的飞行建议。它能够分析飞行态势、解释系统故障、推演风险，并严格遵循“只建议、不操控”的安全原则。支持在线（DeepSeek API）与离线（Ollama 本地模型）两种模式，内置 7 种机型知识库，覆盖从通用航空到深空探索的全场景。

安装与启动

环境准备

操作系统：Windows 10/11（推荐），macOS/Linux 亦可运行。
Python：3.10 及以上版本。
API Key：在线模式需 DeepSeek API Key，免费注册获取。
Ollama（可选，用于离线模式）。
SPAD.neXt（可选，用于接入模拟飞行实时数据）。

快速启动

克隆或下载项目

git clone https://gitee.com/cokin2011/cts-dp.git
cd cts-dp

创建虚拟环境并安装依赖

python -m venv venv
venv\Scripts\activate        # Windows
source venv/bin/activate     # macOS/Linux
pip install -r requirements.txt

配置环境变量

在项目根目录创建 .env 文件，写入：

DEEPSEEK_API_KEY=你的API_Key

该文件已被 .gitignore 保护，不会上传到仓库。

启动服务

python app.py

终端会显示本地及局域网访问地址，例如：

👉 本地访问: http://127.0.0.1:5000
📱 移动端访问: http://192.168.x.x:5000

浏览器会自动打开控制台。

可选组件

离线模式：安装 Ollama 并下载模型（ollama pull deepseek-r1:7b），启动 ollama serve，无网络时自动切换。
实时飞行数据：安装 SPAD.neXt，连接模拟器，开启 Remote Control TCP（端口 18082），EFB 的「实时」标签即可显示飞行参数。

界面概览

界面分为左侧仪表/EFB区和右侧交互/控制区，手机与桌面自适应布局。

左侧面板

飞行状态：航向、高度、空速、垂直速率。
发动机参数：N1、N2、油压、燃油、温度、风向、俯仰/滚转角等。
EFB 电子飞行包：多标签页切换（航路、气象、性能、检查单、NOTAM、实时数据、故障库）。
飞行计时器：正计时/倒计时，声音提醒。

右侧面板

标题栏：应用版本、机型下拉菜单、专家模式按钮。
自动驾驶控制：AP主控、航向、高度、垂直速度、NAV、进近（当前为示例控件）。
目标调节：HDG、ALT、SPD、VS 的数值显示与步进调节。
云真 AI 副驾驶：聊天日志（含复制按钮）、输入区域（麦克风、TTS按钮、文本输入框、发送、清除、诊断按钮）。
状态栏：显示模拟器连接状态，dpilot.com 链接。
页脚：内测说明链接。

基础对话

文本输入

在底部输入框键入问题，按回车或点击发送按钮。AI 会依据当前选择的机型和专家模式给出回复。示例：“空客 A320 发动机滑油泄漏”、“双发停车，高度3200英尺，距离最近机场4.5海里，请求建议”、“赛斯纳发动机功率损失”。

清除对话

点击清除按钮可清空聊天记录并重置上下文。

自动诊断

点击🩺 诊断按钮，系统会发送“自动诊断”指令，触发 AI 针对当前连接状态和可能的故障进行快速评估。

复制回复

每条 AI 回复下方都有一个 📋 按钮，点击即可将全部文字复制到剪贴板。

语音交互

开启麦克风

点击 🎤 按钮（初始为灰色），浏览器会请求麦克风权限。允许后按钮变为红色，输入音柱（左右声道）会随声音跳动。此时直接说话即可，无需唤醒词。

首次使用

打开麦克风后，直接说出你的问题（例如“核热推进发动机失效”），系统会自动识别、发送，并在聊天区显示结果。

后续唤醒

指令执行完毕后，系统会进入“空闲”状态，并启动唤醒词监听。此时只需说 “你好云真”（注意是“云真”），听到提示音后，再说出新的问题即可，无需再次点击麦克风。唤醒词会打断当前 TTS 播报，立刻进入聆听模式。

关闭麦克风

再次点击红色的麦克风按钮，麦克风关闭并释放资源，音柱消失。

TTS 语音播报

点击 🔊 按钮开启语音播报，AI 回复会自动朗读。播报时右侧输出音柱会模拟跳动。新问题或新回复会打断当前朗读。

注意事项

语音识别依赖网络（Web Speech API），离线不可用。
建议使用 Chrome / Edge 浏览器。
若麦克风无法获取，请检查系统设置和浏览器权限。

机型与专家模式

切换机型

在标题栏右侧的机型下拉菜单中选择需要的机型：通用、A320、B737、C172、H145、Astro One、DP-X 深空。

专家模式

点击 📚 按钮切换专家模式。激活后按钮变为紫色发光，AI 将优先使用所选机型的知识库，严格遵循官方故障定义和处置动作，避免编造内容。如果用户在对话中提及特定机型（如“Astro One 电池过热”），系统会自动识别机型并开启专家模式，无需手动切换。

EFB 电子飞行包

右侧的 EFB 面板提供 7 个标签页：🛫 航路、🌤️ 气象、⚡ 性能、✅ 检查单、📢 NOTAM、📡 实时、🔧 故障。各标签页功能详见操作手册，实时数据需 SPAD.neXt 接入模拟器。

飞行计时器

位于左侧面板底部，提供正计时和倒计时功能。支持键盘快捷键：F1 开始、F2 暂停、F3 复位。

控制面板（自动驾驶与目标调节）

当前版本为前端示意，未与模拟器实际联动。AP 主控、目标调节通过步进按钮调整，完整 AP 逻辑需结合模拟器 SDK 二次开发。

故障注入与训练

在 EFB 的「故障」标签中可查看当前机型的所有定义故障，点击提问或使用随机故障按钮进行训练。专家模式下 AI 强制匹配官方处置动作。

高级功能

键盘快捷键

按键	功能
F1	开始计时
F2	暂停计时
F3	复位计时
F5	聚焦输入框
F6	切换 TTS 语音播报
F7	切换专家模式
Esc	停止语音播报
空格	开始/停止录音

PWA 安装（手机端）

在移动浏览器中打开服务地址，点击“添加到主屏幕”即可像 App 一样全屏运行。

打包为 Windows exe

pip install pyinstaller
pyinstaller cloudtruth.spec

生成的 dist/云真助手/云真助手.exe 可直接运行。

运行日志查看

点击“📄 运行日志”按钮可下载最新的聊天日志文件。

常见问题

问题	解决方法
语音唤醒没反应？	使用 Chrome/Edge；允许麦克风权限；确保网络正常。
在线模式提示 402 错误？	DeepSeek API 余额不足，请充值或更换 Key。
离线模式回复很慢或报错？	检查 Ollama 是否启动；确保模型已下载；低配电脑建议使用 deepseek-r1:1.5b。
AI 回复编造了不存在的手册章节？	开启专家模式并选择正确机型。
手机访问不了？	确认同一 WiFi，检查防火墙允许 5000 端口。
如何彻底关闭麦克风？	点击红色麦克风按钮变灰即关闭。

注意事项与安全

禁止操控指令：云真助手是“建议生成器”，任何企图诱导其输出物理操控指令的行为都会被安全护栏拦截。
最终决定权：AI 的建议仅供分析参考，所有飞行操作必须由具备资质的驾驶员根据实际情况和官方手册做出最终决策。
API Key 保护：.env 文件已被排除在版本控制之外，切勿将真实 Key 提交到公开仓库。
软件用途：本软件当前为 Alpha 测试版，主要用于模拟飞行训练与航空知识研讨，不得替代真实飞行程序或适航认证设备。

云中求索，逼近真知。最终决定权，永远在你。

✧ dpilot.com

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