立项原因：市面上的 AI 能力（语音输入、AI 对话、AI 写作）都很强，但触达路径太长——要用一次语音输入，得先切窗口、点按钮、再点开始，等它准备好的时候说话的兴致已经没了。本项目要解决的正是这个问题：把「调用 AI」这件事压缩成一个物理按键，让 AI 能力和手之间的距离只剩一次敲击。
行业场景 / 业务背景：智能硬件与 AI 外设领域，面向「带屏、带固件、需要上位机与云端配套」的消费电子产品。这类产品的真实门槛不在单个环节，而在软硬件一体：固件要能 OTA、设备要能量产登记、用户要有桌面端改配置、企业要有后台管版本。典型场景包括 AI 输入外设、智能控制面板、IoT 终端、需要配套管理后台的量产硬件。
一、设备端固件模块。34 键矩阵扫描（物理 5 行 × 7 列），支持单击、双击、长按、组合键多事件检测；按键支持任意重映射，提供禁用、单键、任意组合键、文本、快捷指令、动作六种按键类型，Command、Ctrl、Alt、Option、Shift 可自由组合，不绑定任何一家软件，任何「一个快捷键能触发」的 AI 工具都能配置上去；USB 有线与蓝牙无线双模连接，兼容 macOS、Windows、Linux，开机即用无需驱动，蓝牙支持多设备配对切换；LCD 屏支持出厂文案分屏轮播与中文显示，字库支持动态字形下发，自定义任意中文不缺字；WS2812 RGB 灯效可作为「功能完成或失败」的视觉反馈通道；固件支持 OTA 升级，自定义 .aikeyfw 固件格式带 64 字节头与 CRC32 校验，USB 与蓝牙双通道均可升级，升级过程全程留痕可追溯。
二、桌面客户端模块。基于 Tauri 2 与 React 19 的跨平台桌面端，通过 USB 直连设备，提供按键映射可视化配置、LCD 自定义文案写入、固件升级、设备信息读取；配套产线质检工具，支持设备登记、序列号管理与出厂检测。
三、云端服务模块。官网支持中英日韩德法西七种语言，含下载中心（多平台多格式安装包、更新日志、历史版本）；管理后台提供固件版本管理与发布、软件多资产发布、设备从生产到售出再到退役的全生命周期登记、升级日志查询；内容系统支持文章多语言翻译发布，以及公众号、视频号、抖音、B 站等多渠道素材改写；对象存储接入腾讯云 COS，密钥在线配置热生效。
我负责任务：整体架构设计与技术选型；固件核心模块开发，含按键矩阵扫描、HID 报告、LCD 渲染与字形管理、RGB 驱动、Flash 存储、OTA 校验；USB 通信协议与自定义 opcode 设计；桌面端与服务端架构搭建及核心编码；Bootloader 分区方案；量产质检工具与管理后台；项目整体推进与交付。
技术栈：嵌入式用 CH583M（BLE 加 RISC-V），早期以 STC89C52RC 验证矩阵与协议，PlatformIO 与 Makefile 构建，协议层与硬件抽象层分层，便于换平台复用；桌面端 Tauri 2（Rust）加 React 19、Vite、TypeScript；服务端 Go（Gin 加 GORM 加 goose）配合 React 19、Vite、Tailwind、Semi UI，MySQL 存储，蓝绿部署；上位机 Python 命令路由，支持蓝牙监听与键盘重映射。
亮点难点：一、LCD 中文字形随内容下发到设备 Flash，配流式 CRC 校验，内存占用从 5.4KB 压到 320 字节索引加 64 字节缓冲，解决 RAM 溢出；二、固件升级分块传输，必须收满全部数据块才校验，防半包卡死写入状态机；三、服务端固件上传自动解析版本号并做 CRC 校验，拒绝损坏包与重复版本。
评论