
ZNP-RE
ZNP Z01 AI 徽章,逆向工程。完整的蓝牙协议以及可用的 iOS 和 Android 代码,让你能用自己的 app、自己的功能和自己的 AI 模型打造自己的徽章助手。
我们将它与 Claude 配合使用,但你也可以接入任何模型。
按下徽章 ─▶ 说话 ─▶ 你的手机 app ─▶ Claude ─▶ 答案显示在徽章屏幕上
└▶ 并从徽章扬声器播放
Z01 只是一个麦克风和一个扬声器
在“AI”标签之下,Z01 是一个麦克风、一个扬声器、一块小圆屏、一个按钮和一个蓝牙芯片。零件与廉价智能手表相同,芯片也来自同一家族。
里面没有 AI。徽章录下你的声音,通过蓝牙发送到手机 app,然后显示或播放返回的任何内容。谁控制了这个 app,谁就控制了徽章,而这个仓库把这份控制权交给你。
你可以在 AliExpress 上买到它。
原厂 app 不太好用
Z01 出厂时附带一个叫 BagiBagi 的 app,它浪费了硬件。
- “添加 GIF”上传的是单张冻结帧。我们解码了徽章真正的动画格式,所以你可以把动起来的人脸推送到屏幕上。
- 你无法选择 AI 模型、语音或个性。
- 它只能聊天。没有电子邮件、日历、音乐或导航。
- 你的声音会经过他们的服务器。
- 它是闭源的。
认识 Milo
Milo 是我自己的助手,基于本仓库中的协议构建。它在我自己的 Z01 上替代了 BagiBagi。
我用它来做一些小事,否则这些事就得解锁手机。我双击徽章,问“我明天的日历里有什么?”或“放点舒缓的音乐”,答案就会显示在徽章上,并通过它的扬声器播放。

Milo 的功能:
- 用 Claude 回答,逐词流式显示到徽章屏幕上并朗读出来
- 发送电子邮件、读取和添加日历事件、拨打电话、播放音乐,并用它自己的键盘替我打字
- 在对话模式下,每次回答后继续倾听
- 用一个小型设备端模型即时运行常见命令
- 在徽章上显示逐向导航,例如 << LEFT 200 m
- 通过锁屏卡片移交给其他 app(Maps、Waze、Spotify)
- 使用自定义的倾听屏幕和动画人脸
- 没有账号,没有服务器。在语言允许时,语音在 iPhone 上转写,并且从不使用 iPhone 自己的麦克风
本仓库包含什么
- PROTOCOL.md。完整的 BLE 协议,逐字节说明。
- HOW-WE-DID-IT.md。用通俗语言讲述的逆向工程过程。
- FILE-FORMATS.md。用于屏幕的图片和动画人脸。
- examples/ios。一个 Swift 包(Z01Kit)以及一个接入 Claude 的小型 SwiftUI app。
- examples/android。用 Kotlin 实现的相同内容。
- tools/z01_probe.py。用 Python 从你的笔记本电脑驱动徽章。
为什么要自己构建
用你自己的 app,徽章就能做到你手机能做的任何事。一个口袋助手、一个翻译器、一个记事器、一个智能家居遥控器。
Meta 的 Charm 钥匙扣——一款你佩戴的 AI——计划于 2026 年 12 月出货。一个 Z01 加上这个仓库,今天就能让你得到同样的想法,用你的模型、你的功能和你的数据。
| BagiBagi | 你的 app | |
|---|---|---|
| AI 模型 | 固定 | Claude、其他提供商,或本地模型 |
| 功能 | 聊天 | 任何你能写成工具的功能 |
| 动画 | GIF 会冻结 | 真正的动画人脸 |
| 隐私 | 厂商的服务器 | 徽章 → 你的手机 → 你选择的模型 |
| 代码 | 闭源 | 开源,MIT |
在其上构建也很容易:
- 无需刷机。固件保持原厂,所以你不会把徽章变砖。
- 音乐持续播放。麦克风以数据形式通过 BLE 传输,而不是作为电话通话。
- 任何语音都可用。扬声器是一个名为“Z01”的普通蓝牙音频输出。
文章标题:我逆向工程了一块廉价 AI 徽章,让你能在里面装进任何 AI
正文:
- 文本实时流式传输。模型还在生成时,答案就已经显示在屏幕上。
从你的笔记本电脑上试试
打开徽章,并关闭手机上的原厂 app,因为同一时间只能有一个 app 占用徽章。然后,在仓库文件夹中执行:
python3 -m venv .venv
.venv/bin/python -m pip install --upgrade pip
.venv/bin/pip install bleak
.venv/bin/python tools/z01_probe.py --text "Hello from my laptop"
徽章会连接、解锁并显示你的文本。加上 --listen,按下徽章按钮并说话,探测脚本就会保存徽章听到的内容。
在 Mac 上,先像上面那样单独升级 pip。macOS 自带的 python3 有一个旧版 pip,会尝试编译 pyobjc-core,并以 Cannot locate a working compiler 失败。被询问时,请为你的终端允许蓝牙访问。
构建你自己的 app
iOS。参照 examples/ios。在 Xcode 中创建一个 app,添加 Z01Kit 包,复制 examples/ios/QuickStart 中的五个 Swift 文件进去,粘贴你的 Anthropic API key 并运行。核心循环如下所示。
import Z01Kit
let badge = Z01()
let listener = Listener() // speech to text, QuickStart/Listener.swift
let claude = Claude(apiKey: myKey) // streaming client, QuickStart/Claude.swift
badge.onEvent = { event in
switch event {
case .buttonPressed: // 1. the wearer presses the button
listener.start { _ in }
badge.startMic()
case .micAudio(let pcm): // 2. the badge streams what it hears
listener.append(pcm)
default:
break
}
}
badge.start()
// 3. when they stop talking (the QuickStart app waits for 1.2 s of silence)
func answer() async throws {
badge.stopMic()
badge.setScreen(.thinking)
let question = listener.stop()
badge.beginReply()
for try await piece in claude.stream(system: "Answer in one short spoken sentence.",
messages: [.init(role: "user", text: question)]) {
badge.appendReply(piece) // 4. the answer appears on the badge as it's written
}
}
Android。参照 examples/android。Kotlin 中的结构相同,使用官方 Anthropic Java SDK。
其他任何方式。它是纯 BLE,所以 Flutter、React Native、Raspberry Pi 或 ESP32 也能驱动这块徽章。从 PROTOCOL.md 和 Python 探测脚本开始。
协议一览
| 通道 | 字节 | |
|---|---|---|
| 解锁 | AE01 / AE02 | JieLi 质询-响应,通过反射徽章自身的质询来求解 |
| 按钮按下 | ← AE02 | RCSP op FF , FF F7 F1 00 |
| 打开麦克风 | → AE01 | RCSP op 04 , 02 10 00 |
| 语音 | ← AE02 | RCSP op 01 , Opus packets, 16 kHz mono, 20 ms |
| 关闭麦克风 | → AE01 | RCSP op 05 , 00 |
| 屏幕 | → AE01 | RCSP op FF , FF F7 F1 02 replying, 03 listening, 04 thinking |
| 文本 | → DF98 | 88 88 11 01 … , 2 characters per frame, acked on DF99 |
| 电池 | → AE01 | RCSP op 03 , FF FF FF FF |
| 扬声器 | 经典蓝牙 | 一个名为 Z01 的普通音频输出 |
时序和注意事项在 PROTOCOL.md 中。
状态
| 连接、解锁、按钮、麦克风、屏幕、文本 | 在真实徽章上可用 |
|---|---|
| 图片和动画包 | 在真实徽章上可用,已在此记录,尚无示例代码 |
| iOS Z01Kit | 已做单元测试,从我们的 iOS app 在真实徽章上运行的代码中裁剪而来 |
| iOS QuickStart app | 可针对 iOS SDK 编译 |
| Android 快速入门 | 一个移植版本,尚未编译或未在徽章上试过 |
开放问题列在 PROTOCOL.md 的末尾。
贡献
欢迎提交 issue 和 pull request,尤其是来自其他固件版本的抓包、对开放问题的解答、Android 测试以及其他平台的移植。
免责声明
这是一个由该设备拥有者发起的独立互操作性项目,与 ZNP、JieLi、Anthropic 或 Meta 无关联。未修改任何固件,也未提取任何密钥或加密。关于原厂 app 的看法仅代表我们自己。使用风险自负。