Newshot

我逆向工程了一款廉价 AI 徽章,让你能把任意 AI 装进去

Translation(model translation, not the source's own text)
ZNP Z01 徽章,圆形屏幕上显示一张紫色人脸
ZNP Z01 徽章,圆形屏幕上显示一张紫色人脸

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 回答、操作、对话模式、语言、后台模式,以及 Z01 上的语音回答
Milo 的设置:Claude 回答、操作、对话模式、语言、后台模式,以及 Z01 上的语音回答

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 / AE02JieLi 质询-响应,通过反射徽章自身的质询来求解
按钮按下← AE02RCSP op FF , FF F7 F1 00
打开麦克风→ AE01RCSP op 04 , 02 10 00
语音← AE02RCSP op 01 , Opus packets, 16 kHz mono, 20 ms
关闭麦克风→ AE01RCSP op 05 , 00
屏幕→ AE01RCSP op FF , FF F7 F1 02 replying, 03 listening, 04 thinking
文本→ DF9888 88 11 01 … , 2 characters per frame, acked on DF99
电池→ AE01RCSP 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 的看法仅代表我们自己。使用风险自负。

License

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by HN AI
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗