青鸾云步 — AI 智能导盲助手

面向视障人士的智能导盲机器人 Android APP，支持离线语音识别 + AI 大模型对话 + 高德步行导航。

功能

• 障碍物语音预警 — 蓝牙连接 ESP32 机器人，实时播报障碍物方向与距离，立体声蜂鸣定位
• AI 自然对话 — 接入 DeepSeek 大模型，语音问答、路况分析、安全建议
• Vosk 离线语音识别 — 中文模型内嵌 APK，无需联网即可语音输入
• 高德步行导航 — GPS 实时定位，步行路线规划，逐段语音引导
• 无障碍设计 — 全语音交互，深色大字体 UI，无需看屏幕

技术栈

层级	技术
框架	Apache Cordova 12
语音识别	Vosk Android SDK + 中文 small 模型
语音合成	Android TTS / Web Speech API
AI	DeepSeek V4 (OpenAI 兼容)
地图	高德 Web 服务 REST API
定位	cordova-plugin-geolocation (GPS)
蓝牙	cordova-plugin-ble-central

快速开始

1. 克隆项目

git clone https://github.com/NQLOVELSJ/QLYB_APP.git
cd qingluan-cloud-step

2. 配置 API Key

# 复制配置模板
cp config.example.json config.json

# 编辑 config.json，填入你的 API Key
# - deepseekKey: DeepSeek API Key (https://platform.deepseek.com)
# - amapKey: 高德 Web服务 Key (https://lbs.amap.com)

config.json 已被 .gitignore 排除，不会提交到 Git。

3. 安装依赖

npm install
npx cordova platform add android
npx cordova plugin add cordova-plugin-tts
npx cordova plugin add cordova-plugin-ble-central
npx cordova plugin add cordova-plugin-geolocation

4. 构建 APK

npx cordova prepare android
cd platforms/android
./gradlew assembleDebug
# APK 输出: app/build/outputs/apk/debug/app-debug.apk

配置说明

API Key 获取

• DeepSeek: 注册 https://platform.deepseek.com → API Keys → 创建
• 高德地图: 注册 https://lbs.amap.com → 控制台 → 创建应用 → Web服务

语音模型

Vosk 中文模型 (vosk-model-small-cn-0.22) 已内嵌在 APK 的 assets 目录中，首次启动自动解压到本地存储，无需额外下载。

蓝牙连接

APP 上电后自动搜索名为 GuideRobot 的 BLE 设备。ESP32 端需配置：

• BLE 服务 UUID: 12345678-1234-1234-1234-123456789abc
• 数据特征 UUID: 87654321-4321-4321-4321-cba987654321
• 每秒推送 JSON: {"distance":85.3,"direction":"left","direction_cn":"左前方",...}

项目结构

├── www/index.html        # 整个 APP (HTML+CSS+JS 单文件)
├── config.xml            # Cordova 配置
├── config.example.json   # API Key 模板
├── package.json          # 依赖声明
└── build-extras.gradle   # Android 构建配置

License

MIT