V3SP3R 完全解析：如何给 Flipper Zero 装上 AI 大脑，一句话操控硬件黑客工具

V3SP3R（内部代号 Vesper）是一款开源的 Android 应用，它为Flipper Zero 硬件黑客工具装上 AI 大脑：通过蓝牙连接设备，再用自然语言一句话完成 SubGHz 信号发射、红外遥控、BadUSB 脚本生成等复杂操作。无需翻菜单、无需背协议，语音、拍照、文字三种输入方式都能驱动你的"口袋硬件实验室"。

为什么 Flipper Zero 需要 AI 大脑？

Flipper Zero 是功能最全面的口袋级硬件黑客工具之一，但它的使用门槛并不低：

• 🎛️菜单深：SubGHz、红外、NFC、iButton、BadUSB……每个子系统都有独立界面
• 📚协议多：遥控频率、编码格式、IR 协议需要自己查资料
• 🔁操作碎：建文件、改频率、发信号，往往要手动点十几步

V3SP3R 的解法很直接：用大语言模型当"翻译官"。你对手机说人话，AI 读取设备状态、生成结构化命令、经过风控校验后下发到 Flipper，几秒内回报结果。整个 AI 能力模块位于 app/src/main/java/com/vesper/flipper/ai/。

一句话理解：V3SP3R = 手机 App + AI 大模型 + 蓝牙通道 = 会听话的 Flipper Zero

核心功能一览：V3SP3R 能帮你做什么？

信号相关的两个进阶实验室界面源码分别在 AlchemyLabScreen.kt 和 PayloadLabScreen.kt，对 UI 实现感兴趣可以一读。

工作原理：三层架构让 AI"只会说、不能乱碰"

很多新手担心：把硬件交给 AI，安全吗？V3SP3R 的核心设计原则是——AI 只负责"出题"，Android 负责"验收"。大模型永远不直接接触蓝牙或设备底层，它只能通过一个统一的execute_command命令接口下发结构化操作，命令的完整定义见 execute_command_schema.json。

架构分为三层（详见 docs/architecture.md）：

对话总指挥是 VesperAgent.kt，它负责把"你要的"翻译成"设备能执行的"。

风险分级流程：四级闸门

每一条 AI 命令在执行前都要过一道"风控闸"，由 RiskAssessor.kt 完成分级：

此外还有两个"保险丝"：写文件前强制 Diff 预览、所有操作全部进审计日志。AI 想搞破坏？先过这四道关。

快速上手：V3SP3R 安装与配置最快 5 步走

准备清单

一键安装步骤

第 1 步：准备 Flipper

1. 给设备充满电
2. 通过官方桌面工具更新固件
3. 在 Flipper 上开启：设置 → 蓝牙 → 开

第 2 步：获取 AI API Key

在 OpenRouter 官网注册后，进入 Keys 页面创建并复制密钥（sk-or-...格式）。

第 3 步：克隆项目并构建 APK

git clone https://gitcode.com/gh_mirrors/v3s/V3SP3R cd V3SP3R ./gradlew assembleDebug

APK 输出位置：app/build/outputs/apk/debug/app-debug.apk，用 USB 调试或直接传到手机安装。

第 4 步：首次启动

1. 授权蓝牙、位置（安卓 BLE 扫描必需）、通知权限
2. 设置页粘贴 OpenRouter API Key
3. Device 标签页 → Scan → 点击你的 Flipper 完成配对
4. 切到 Chat 标签页，开口说话吧 🎉

推荐 AI 模型

一句话操控实战：新手最常用的 8 句话

不用背任何协议知识，下面这些"人话"直接说就行：

• 📁 "显示我的 SubGHz 捕获列表"
• 🔋 "现在电池还剩多少？"
• 💾 "把所有红外遥控器做一份备份"
• ⌨️ "生成一个能打开终端的 BadUSB 脚本"
• 📡 "把 garage.sub 里的频率改成 315MHz"
• 📸 "（拍一张电视遥控器的照片）帮我识别它的红外码"
• 📱 "帮我找找有没有能读门禁卡的 App"（FapHub 搜索）
• 🚀 "启动 Pwnagotchi"（按名称直接拉起任意 Flipper 应用）

背后对应的动作清单（共 27 种）完整列在 README.md 的 Supported Actions 表格中，从文件操作到硬件发射全覆盖。

⚠️法律提醒：只在你自己的设备或有明确授权的范围内测试，遵守当地法律法规。项目定位于教育与合法安全研究。

进阶玩法：五种操作模式与智能眼镜

操作模式：像切档位一样切换策略

V3SP3R 内置 5 种 操作模式，不同模式会改变应用行为：

智能眼镜免提操控（可选）

佩戴 Mentra 智能眼镜后，语音转录直接流入 Vesper，AI 还能通过眼镜摄像头"看"到你看到的东西。桥接服务是独立 Node.js 项目，位于 mentra-bridge/：

cd mentra-bridge npm install && npm run build && npm start

然后在设置中启用 Smart Glasses 并填入桥接地址即可。

常见问题排查（Troubleshooting）

更多细节见 SECURITY.md 与 CONTRIBUTING.md。

写在最后

V3SP3R 证明了"AI + 硬件"结合的一个优雅范式：大模型负责理解意图，风控引擎负责守住底线，蓝牙通道负责落地执行。对新手而言，它把 Flipper Zero 的学习曲线从"啃协议手册"降到了"开口说话"；对老玩家而言，风险分级、审计日志和可视化信号合成器让复杂工作流真正可信赖。

装上这颗 AI 大脑，你的 Flipper Zero 就不再只是工具，而是一个听懂人话的搭档 🚀