reai-vibe-board

ReAI Vibe Board

AI-Board-01 机械键盘的 HID 监控和音频捕获工具 — Rust + Vue 3 + Tauri v2。

当前状态: V2 重构中（refactor/v2-architecture 分支）

V2 架构

Tauri 原生进程内架构，消除 Sidecar：

• Rust 逻辑合并到 Tauri 进程：#[tauri::command] + AppHandle::emit() 替代 HTTP + WebSocket
• 跨平台抽象：4 个平台 trait（HID/Audio/TextInsert/Permissions），macOS + Windows 同步实现
• 状态分解：5 个聚焦的子状态替代 21 字段 god object
• 音频统一：AudioSession enum 统一 USB/BLE 音频路径
• SQLite 存储：rusqlite bundled 替代 JSON 索引文件

功能特性

设备与 HID

• 按键监听 — 实时监控 12 个按键事件（支持同时键盘输入）
• 模式切换 — 检测 CHAT / YOLO / PLAN 三种模式
• 按键配置 — 读取和设置按键功能（多媒体键 / 键盘组合键 / AI 语音 / 禁用）
• 热插拔 — 自动检测 USB/BLE 连接、断开、自动重连、USB 插入自动切换

音频处理

• USB Audio — UAC 1.0 USB 音频输入（cpal 驱动，16kHz f32 PCM）
• BLE mSBC — HID mSBC 帧采集 + ffmpeg 解码
• AudioSession — 统一 USB/BLE 音频输出，上层逻辑不感知连接类型

语音识别 (STT)

• 多引擎 — SenseVoice / Moonshine / Zipformer（Sherpa-ONNX）
• 模型管理 — 在线下载（断点续传 + SHA256 校验）、切换、删除
• VOICE 键语音输入法 — 按一下 VOICE 键开始录音 → STT → 直接注入当前焦点应用

前端界面（4 页面精简方案）

• Dashboard — 设备状态、音频、STT、语音管线、系统信息
• Settings — 权限管理、环境检测、STT 设置、录音设置
• Keyboard — AI-Board-01 键盘可视化 + 按键配置
• Debug — 7 通道事件监听 + 命令测试

系统托盘

• 关闭窗口 → 隐藏到托盘
• 托盘图标反映设备连接状态和语音输入状态

设计文档

完整的 V2 重构设计文档在 docs/refactor/：

文档	主题
00-overview.md	重构总览
01-architecture.md	新架构设计
02-tauri-integration.md	Tauri 原生集成
03-cross-platform.md	跨平台 4 trait
04-audio-unification.md	音频统一
05-state-events.md	状态分解 + 事件
06-stt-integration.md	STT 集成
07-code-standards.md	代码规范
08-migration-roadmap.md	迁移路线图
09-communication-protocol.md	通信协议
10-hotplug-auto-detect.md	热插拔
11-data-storage.md	数据存储
12-environment-check.md	环境检测
13-frontend-design.md	前端设计
14-logging.md	日志系统
15-system-tray.md	系统托盘
16-development-guide.md	开发指南

技术栈

层	技术
后端	Rust, Tauri v2, hidapi, cpal, sherpa-onnx, rusqlite
前端	Vue 3, TypeScript, Tailwind CSS v4, Pinia
平台	macOS (arm64/x86_64), Windows (x86_64)

项目目录

ai-vibe-board/
├── docs/refactor/     # V2 设计文档 (00-16)
├── backup/            # V1 旧代码归档（仅供参考）
│   ├── src-v1/        # 原 Rust 后端
│   ├── src-tauri-v1/  # 原 Tauri sidecar
│   ├── web-v1/        # 原前端
│   └── docs-v1/       # V1 文档
├── web/               # Tauri 桌面 app 前端（Vue 3 + Vite）
├── landing/           # 早鸟价预售落地页（Vue 3 + Vite + Supabase，跟 web/ 完全独立）
├── .cargo/            # Cargo 配置
├── .github/           # CI workflows
├── CLAUDE.md          # Claude Code 项目指引
└── README.md          # 本文件

子项目：早鸟价预售落地页

landing/ 是一个独立的 Vue 3 + Vite + Tailwind 4 + Supabase 静态落地页，与桌面 app 完全隔离，只是共用 repo。

• 用途：发售前收集邮箱蓄水池，分两批名额（限量第一批 + 不限量第二批，后端原子判定）
• 详见 landing/README.md

License

Private / Internal