Android / iOS 双端源码已公开。 面向开发者的雷鸟 iO 智能眼镜 SDK、手机 App 扩展与眼镜端应用研究项目：自有 AI、音乐、阅读、导航、番茄时钟，以及可自定义的仪表盘和小应用 SDK。不是给小白刷机即用的成品。原生鸿蒙 HarmonyOS 已停止更新，保留历史源码供参考。

头图为 AI 生成的宣传示意，不是实机截图，不代表官方背书。本文“公开/开源”指列出的原创扩展源码可获取；具体权利以非商业许可证和各第三方许可为准，并非无限制商用授权。

原创代码仅供学习、研究与非商业使用，沿用 PolyForm Noncommercial 1.0.0，未经授权不得商用或收费分发。除源码及明确列出的依赖，Release 提供原厂砸壳 IPA 作为 iOS 扩展输入，以及下述 Android 1.0.5 非官方完整插件 APK / 高风险实验固件。原厂部分版权仍归各自权利人，不因分发修改包而重新许可。不提供个人密钥、Cookie、账号、签名私钥，亦不提供合并后的 IPA / HAP；第三方服务由用户自行配置。

文档更新：2026-09-30 · 日期表示文档整理或所注明的实测记录，不代表当天全量回归。

Android APK / 固件下载 · Android 安装与刷机 · iOS 源码与构建 · ☕ 自愿支持项目

• 小白不要刷，日常使用请保留官方固件。 本轮新增的眼镜端原生应用、自定义图形仪表盘与小应用运行时，都需要对应的实验固件；仅安装手机插件不会把这些能力加进原厂固件。已有模型接入、部分字幕等手机侧功能不因此要求刷机。已有匹配运行时后，导入兼容卡片/应用包不必每次重刷。
• 刷机风险由使用者自行评估和承担。 本项目按现状提供，无稳定性、回滚、救砖或售后保证；掉电、中断、错包和缺陷可能导致数据丢失或设备损坏。在适用法律允许的范围内，作者不承担由此造成的损失或责任。一次实测成功不代表你的设备安全，更不构成“不会刷死”的承诺。
• 鸿蒙 HarmonyOS 不再更新。 保留既有研究源码和历史验收，不再移植新功能、适配新固件或承诺修复现有问题；新功能以 iOS / Android 各自说明为准，不保证双端完全等同。
• 微信读书、网易云音乐的登录及服务权限请自行解决。 不提供账号、Cookie、Key、会员权益、代登录或风控绕过；公开版微信读书不含网页正文适配，登录成功也不代表能通过本项目读取所有正文。
• 觉得好用，再自愿打赏。 不要在打赏前私信要求作者先增加某项功能，也不要把打赏当作功能定制或交付条件。建议可在 Issues 讨论，但不承诺采纳、排期或一对一支持；打赏后同样不产生这些义务。微信二维码在文末。

Android 新发行：完整插件 APK + TAP1-TEST-01 固件 · 从安装到刷写的逐步教程。Fold3 / Android15 的官方升级路径已实刷成功；公开APK移除微信读书网页正文适配，保留书架和TXT阅读。刷后必须只读回查并解除结果保护，否则安卓官方功能仍会被拦截。 实验用品，非开发者请勿刷，不保证不会损坏设备。

原厂固件备份：Strix OS 1.0.4.12 原厂负载归档 · 如何恢复原厂／什么时候不能恢复。原厂负载与清单未修改，ZIP 重新封装；不是服务器原始 ZIP、整机备份或救砖保证。优先走官方提供的兼容更新；当前公开 APK 不支持直接导入此归档进行同版本恢复，不要绕过候选校验。

开发者新入口：仪表盘与小应用 SDK 完整教程 · 20 个 MCP 应用模板 / ZIP · 自托管 API · Agent 开发 Skill

MCP 在用户自己的 Server 上运行，眼镜不运行 MCP、浏览器或任意 JS。后端取数 → SDK 生成卡片或有界原生应用 → 手机确认 → 眼镜显示。公开模板均为离线示例，不附带账号、Key 或已授权在线服务；真机需要匹配的 TCE1/TAP1 运行时，旧 FOCUS-04 不自动兼容。

BIG STEP · 从功能，到生态。 不止使用我们做好的功能：把你自己的数据源，变成眼镜里的仪表盘和原生小应用。本次更新与价值 · 从第一个模板开始

选择平台 · 近期更新 · 功能对比 · AI 帮你接入 · V1 快速开始 · Web 预览 · Roadmap · 许可与隐私

先按目标选，不必从 V1 源码开始。 想使用已打包的 Android 研究功能、自己构建 iOS 插件、开发卡片/小应用，是三种不同入口。普通日常用户请使用官方 App 和原厂固件，不要把实验包当作官方更新。

要不要刷固件？ 模型接入、TTS、部分字幕等手机侧扩展可沿用原厂显示能力；新增的眼镜原生应用、图形仪表盘与四槽小应用需要对应实验运行时。已有兼容运行时后，导入兼容卡片/ZIP 不必每次重刷。安装 APK ≠ 安装眼镜固件；iOS / Android 的 OTA 门禁和候选也不能混用。 查看平台与固件差异。

连接与安装： iOS / Android 扩展沿用宿主配对，不需要为插件反复解绑；Android 重签名 APK 不能直接覆盖签名不同的旧 App，先导出数据再按教程处理。只有切换到 V1 / 鸿蒙独立客户端时，才按对应流程解绑旧宿主、在原手机系统蓝牙忽略设备，不能让多个客户端争抢连接。Android 刷完还必须完成只读回查与解除结果保护。

按日期倒序整理；每项单独标注公开范围与验收边界。

自定义固件是试验用品，非开发者请勿刷。 AP 改动仍可能导致无法启动或失去 OTA；不要混用不同候选的固件、手机门禁或授权。原厂回滚不是救砖保证。实机成功不等于生产稳定版。

修复开启官方「全天智记」后，导航、音乐、读书、番茄、滴滴和小应用可能无法从眼镜菜单进入的问题。不关闭智记、不重写原厂录音，只调整六个扩展的共存判断；相对 TGR1 的 AP 增加 192 字节。 原厂前台占用与助手活动检查保留，不包含 TBL1 亮度实验补丁。

源码、复现与刷写说明 · 下载 TLC1 固件 / SHA-256 / 审计

用户已确认智记开启时其他应用可进入，并在升级保护收尾说明后确认本轮音乐显示正常；持续采集、音频共存、反复抬头和长期稳定性仍需测试。确认眼镜升级完成、自然回首页后，必须彻底退出重开手机雷鸟 App，结束本次进程内升级保护，否则音乐等内容可能无法同步。升级未完成或状态不明时不可强停。

实验固件，非开发者不要刷，回滚不保证救砖。只改 AP 内容，但仍为完整 OTA；其他 13 个负载不变。提供定向源码与 iOS OTA 参考，不提供私用 IPA、凭据或新的 TLC1 Android APK；旧 GUARD-07 APK 不能直接刷本包。TGR1 的 Watch 全局翻页已知问题不因此解决。

imagegen 生成的横版概念图，不是实机截图；示意界面不代表已完成全局输入验收。

把 Watch 作为眼镜的输入端：经配对 iPhone 的雷鸟插件中转，支持表冠上一项/下一项、屏幕确认/返回、两套手势映射，以及 10 分钟或始终开启的手机授权。源码、构建与接入 · TGR1 协议与验收边界

下载 TGR1 实验 OTA / SHA-256 / 审计报告 · 兼容条件、校验与风险

实验源码与固件，不是稳定遥控交付。 TGR1 虽已有用户刷入完成反馈，但“翻页翻不了”仍未闭环；本次上传的是原样归档包，没有重新编译或新真机验收。全局输入需要配套 TGR1，原厂固件与已发布 TAP1/FOCUS-04 不自动支持；旧版公开 APK 的固定候选门禁也不能直接导入本包。不发布私人 IPA、签名材料或个人配置；始终开启也不保证 Watch/手机后台可达。非开发者请勿刷，回滚不保证救砖。

下载完整 APK / TAP1-TEST-01 / 校验文件 · 完整安装与刷机教程 · 公开范围与源码构建

横版更新说明由 imagegen 生成，不是实机截图，也不能代替完整教程。公开 APK 不含微信读书网页正文适配或私人配置；公开派生包尚未再次实机刷写。眼镜自然重启后，必须按教程只读回查并解除结果保护；更新未结束或状态不明时不能释放。

AI 生成的开发者生态效果示意，不是镜片实拍；图中数据与界面为示例，音乐模板不播放音频。开放的是开发接口与有界组件能力，不是无限系统权限。配套 TAP1 实验固件于 09-27 单独发布，见顶部下载入口。

这次的价值，是把“我们替你做功能”推进到“你也能为眼镜开发功能”。 在匹配运行时支持的组件范围内，新增信息卡或小应用可以通过数据和 ZIP 完成，不必为每个页面重新修改 AP。需要新系统能力、底层协议或运行时之外的组件时，仍需固件开发；不是任意网页或 JS 都能装进眼镜。

更新清单： 应用广场整理为三个入口；进入“我的应用”自动查询四槽（受连接、忙碌和升级保护限制）；新增 20 个可下载 ZIP 与来源说明；补齐仪表盘/小应用后端开发教程、12 个 MCP 工具及 Agent Skill。手机配套研究版还加入了仪表盘草稿预览列表；本 PR 的公开仪表盘范围是模型与后端接口参考，未包含该完整编辑器 UI。

应用广场分为 我的应用 / 应用广场 / 开发指南。保留四个基础示例，新增天气、降雨、通勤、余票、航班、日程、待办、知识便签、阅读摘记、代码与服务状态等 20 个可修改的离线模板。每个都有图标、内容、接入要求、ZIP 和可复制 Agent 提示词。眼镜最多安装四个小应用、一次运行一个，广场条目不会自动全部安装。

npx skills add Turbo1123/Turbo-IO --skill turboio-developer -g

把需求与选中的模板提示词交给 Agent，让它连接你自己的 Server / MCP，保留最少展示字段，生成并验证小包；密钥始终留在服务端。手机、仪表盘、应用包的开发与打包细节统一放在开发教程，避免主 README 堆积命令。

• 仪表盘 SDK：256×194 卡片，文字 / 图标 / 图片 / 进度条 / 柱图 / 折线；后端草稿、revision、发布、手机批准与回执。
• App SDK：540×180，最多四页，JS 仅用于开发电脑构建；ZIP 解压预算 20 KiB。眼镜使用有界原生组件，不执行 ZIP 中的代码。
• 独立后端：HTTP API、Python SDK、12 个 MCP 工具，无作者私有服务依赖。

边界： 本版小应用使用版本化快照与手机手动导入，自动后台刷新、按钮回传 Server 和队列恢复尚未接通。20 个模板不是 20 项联网成品；公开 API/打包工具可以独立运行，手机模块是集成源码，不是签名安装包。私用匹配运行时的基础安装已有用户实测反馈，但本次不发布新的可刷固件，也不把模拟器测试当镜片验收。

开放开发能力，不取消安全边界： 最多四个已安装应用、一个前台实例、每包最多四页、每页最多 12 个组件；解压后总预算 20 KiB，ZIP 上限 24 KiB。保留手机确认与协议校验，眼镜不运行 MCP 或任意脚本；API Key、Cookie、签名证书和私用安装包不随源码发布。先在电脑运行模板与后端测试，再处理匹配手机和固件集成。详见公开范围与兼容前提。

20 个模板及来源 · API 与安装步骤 · 手机集成边界

查看应用广场界面

隔离模拟器运行截图，不是镜片实拍，也不代表已连接上游 MCP。

1. 菜单重构：眼镜菜单四项同屏，明显选中框，左上角时间与电量；详情页不再残留菜单滚动指示器。
2. 修复遗留固件问题：优化音乐旋钮轻触误切歌、文字边距、微信读书长按返回/退出与番茄页面重叠。
3. 新增原生番茄时钟应用：眼镜第十二项菜单，手机双向控制，短按暂停/继续、长按停止；息屏继续计时、到时空闲提醒，避免长期亮屏打扰。
4. Turbo IO 插件 UI 焕新：首页眼镜动效、音乐/微信读书/导航/番茄卡片，整理内页与设置；只改自己的插件，不重做官方 App。

FOCUS-04 固件与构建校验 · 配套手机构建和使用 · 下载实验固件

基于 Strix OS 1.0.4.12，仅 AP 内容变化，其他 13 个固件负载不变；AP 9,558,216 字节，低于 9,600,000 字节限制。2026-09-25 用户实刷并确认此版正常；仍是试验用品，不代表全场景稳定、不会变砖或可保证救砖。配套宿主为雷鸟 AI iOS 1.0.5（201），不可与旧包/门禁混用。

完整更新长海报。界面效果示意，不是镜片实拍；微信读书公开版正文需自行合法导入。

查看首页、番茄时钟与音乐单独效果图

首页为模拟环境界面；番茄与音乐为设计效果，不作为实机像素一致性或完整验收证据。

公开 Apple 本地翻译、Hy-MT2 文字翻译和 Parakeet 英语离线 ASR，支持手机/系统可用的蓝牙麦克风、快速预译、原文与译文同步眼镜。运行在 iPhone，无需服务 Key、无需刷眼镜固件；是独立字幕入口，不是全面替换官方翻译所有功能。iOS 26+ 可选构建，首次需自行准备模型与系统语言包，不提供签名 IPA 或权重包。

下载、构建、签名与使用教程 · 模型及第三方许可证 · 验证与限制。英语识别不是多语言 ASR；眼镜专有前方/四周定向收音尚未接入，前台采集、20分钟保护，无自动云端兜底。公开源码已编译并做离线测试，完整公开包与镜片仍需使用者验收。

新增第十一项“微信读书”研究菜单：四本封面书架、原生文本窗口与手动/自动滚动。 已公开原创 AP / 手机模块、构建与协议说明，以及 TWR1 实刷实验固件。源码重建 AP 与实刷版本一致，仅 AP 改变，其他13个负载不变。旧 TWR1 的长按返回问题在 09-25 FOCUS-04 中加入修复，旧 Release 不变。非开发者请勿刷，不保证回滚或救砖。

手机模块公开书架/统计、封面处理、TXT/EPUB 导入及阅读传输，不含网页正文适配、Cookie、Key 或私用 IPA，也尚未接入主仓库默认构建及 TWR1 OTA 打包入口；没有自己的匹配手机集成时先别刷。这不是“下载源码就能直接读取所有微信读书正文”的声明。书架/统计参考 Tencent/WeChatReading，网页阅读可自行研究 AGPL 项目 finlater/weread.koplugin。架构思路与许可范围

上述集成限制针对历史 TWR1；09-25 新增的 FOCUS-04 可选集成版已提供匹配的构建与 TFP1 打包入口。网页正文适配仍未公开，本机 TXT/EPUB 导入范围不变。

界面效果示意（用户提供）：展示菜单、同步提示、四本书架与阅读布局，不作为实机验收证据；图中书籍、文字、页码和速度仅为示例，具体交互以研究说明为准。

2026-09-23 研究机实测通过：配套 iOS 播放器有声音、封面和歌词；眼镜显示旋转专辑封面与五行歌词，当前句始终在中间高亮，暂停/继续、切歌、拖动进度同步正常。手机发起播放与眼镜反向请求均有代码支持；不保证 App 被系统终止后能自动拉起。

• 新增第十项音乐菜单，保留原七项、第八项 Turbo Display/ANIM60 和第九项原生导航。
• 手机负责获取可播放歌曲、封面和歌词以及播放音频；眼镜 AP 原生绘制，不持续传整屏截图。可选常亮 / 30秒 / 60秒显示。
• 旧 TMU1 已知问题：轻碰旋钮可能误切歌。09-25 FOCUS-04 已加入输入过滤与去抖，旧 Release 不变。 扫码登录可能报“环境异常”，本次用未登录可播放歌曲验收，不绕过风控、会员或版权限制。
• 适配 雷鸟 AI iOS 1.0.5（201）+ Strix OS 1.0.4.12，Android / HarmonyOS 暂未接入此音乐播放器。

完整教程：构建、签名、试刷、播放与协议 · 下载 TMU1 实测固件 Pre-release。发布源码、精确实测固件及校验工具，不提供合并 IPA、个人签名、Key、账号或 Cookie。

试验用品，仅供开发者非商业学习研究，非开发者请勿刷！ 仅 AP 内容改变、其他13项保持原厂字节，清单更新 AP Size/MD5；不代表 OTA 只写 AP，也不保证不会变砖。断电、中断、错误固件可能导致无法启动或失去 OTA，原厂回滚不是救砖保证。实测通过不等于生产稳定版。普通 SDK/App 开发无需刷固件。

这次不只是“把导航测试文字发到眼镜”，而是在眼镜端增加了独立的导航应用页面。 Turbo Display 保留为开发者的传图／显示测试工具，不是面向日常使用的显示应用；新增导航则是拥有独立菜单入口、布局和运行状态的应用页面。两者定位不同。

• 独立入口与生命周期：眼镜菜单中有“导航”；手机开始后可主动打开，不必每次先去官方字幕或提词器操作一遍。
• 眼镜端原生绘制：内置转向图标、文字与路线示意图。手机只发导航数据，单次完整快照最多 328 B，减少旧传图方案的带宽负担；这不是无延迟保证。
• 高德提供路线，眼镜呈现指引：手机支持步行、骑行、驾车的规划/导航入口；路线示意图不是高德完整地图底图，也不是路口实景。
• 显示与退出管理：实现了停止/实体返回收尾、无有效更新约60秒息屏、按键唤醒及可选常亮；各分支仍需扩大验收，不承诺绝不熄屏。
• 后台导航已修复立即退出问题：配套 iPhone Air 版收到用户正常反馈；真实导航按授权使用后台定位，模拟后台仅短时测试。见后台行为与限制。

这里的“应用级别”指集成在固件 application 内、拥有独立菜单和交互的原生应用页面，不再借用旧测试界面；并不是已经开放 Android 式 APK 安装、任意第三方 App 加载或整个系统 UI 替换。

实机进展（2026-09-22）：Turbo Display 完整图和局部更新已有镜片反馈；TNV1 已刷入并进入独立导航页，手机发起导航及后台修复获用户初步正常反馈。新增应用不等于生产稳定版，长期运行、全部模式、低电量和异常恢复仍需专项验证。

TNV1 匹配版本已公开： 下载高风险固件 Pre-release · 完整源码、构建与手机合并 · 升级、导航与传图测试说明。此包保留 Turbo Display 测试工具并新增独立原生导航应用，含配套 iOS 1.0.5（201）源码与后台修复；仅 AP 内容变化，另13项不变。使用自己的配置和签名，不提供合并后 IPA。旧 R3 Release 不含这两项，不能混用。非开发者请勿刷；实机成功不代表不会变砖或保证救砖。

ANIM60 是基于相同 Strix OS 1.0.4.12 的另一份实验 AP：复用第八项 Turbo Display，内置 12 帧素材、在眼镜端定时绘制，手机无需逐帧传输。2026-09-22 研究机已刷入，用户确认动画播放，30 秒结束计数 1799 次提交；这是约 60 次/秒的提交计数，不是物理面板 60 FPS 的测量，也未证明长期热稳定或全部情形无丢帧。它不是 GIF 上传器或面向普通用户的动画 App。

查看素材预览、实测边界、AP 校验值与离线重建 · ANIM60 高风险实验固件 Pre-release。ANIM60 与 TNV1 是不同固件候选，不能混用升级授权或手机端门禁；公开源码目前不提供 ANIM60 专用手机 OTA 操作入口。普通 SDK/App 开发不需要刷固件。

仅限开发者的非商业学习研究，有风险，不是日常导航产品。 不在驾驶、骑行或过马路时操作/测试；可能出现断连、延迟、旧指引或熄屏。使用自定义固件还可能无法启动或失去 OTA，原厂回滚不是救砖保证。普通 SDK/App 开发不需要刷固件。

雷鸟 AI iOS 1.0.5（201）原厂砸壳 IPA。

提供的是原厂应用的砸壳（解密）版本，未合并 Turbo IO 扩展，不是修改功能后的版本。砸壳是对原应用二进制解除加密，不代表整个文件与 App Store 原始加密包逐字节相同。下载该 IPA 不会直接获得 Turbo IO 功能；需按 iOS 扩展教程 自行合并、配置并使用自己的签名安装。

下表比较当前公开的内容与接入方式，不把“有源码”“已打包”和“真机全量通过”混为一谈。V1/V2 是架构路线，1.0.5 是官方宿主版本；GUARD-07、FOCUS-04、TAP1 则是不同扩展/固件标记，不是同一组版本号。

共同限制： 自备模型/地图等配置；微信读书、网易云登录与服务权限自行处理；无私人凭据、代登录或风控绕过。云服务、系统权限、长时后台和其他机型不保证一致，不能用某一端的成功证明另一端已验证。

不是固件越新就可以随便升级。 FOCUS-04 与 TAP1-TEST-01 均基于 Strix OS 1.0.4.12，系统版本数字可能不变；必须核对 Release 名、SHA-256、宿主和门禁，不只看“1.0.4.12”。所有自定义固件均是高风险实验包，不保证回滚或救砖。

以下为 2026-09-24 历史对照，保留以便追溯，不用于判断当前 Android 是否已移植。当前范围以本节上表及各模块文档为准；鸿蒙已停止更新。

实测＝有对应路线的真机/镜片反馈；部分＝仅部分流程通过或仍有已知问题；待验＝已有代码，但尚未完成对应真机闭环；未接＝本路线未集成；官方＝沿用宿主能力，不代表扩展重写或重新验收。历史私用前身的反馈不能保证你自己编译的包、其他固件和机型全部可用。

默认原厂固件与自定义固件是两条路线： 原厂固件下的有限卡片/通知模板不等于自由替换系统 UI；自定义 AP 路线已发展到 Turbo Display 和独立导航应用，但需要匹配固件与手机实现，不能直接套到四端。Claude Code、Hermes、WorkBuddy、OpenClaw 也不能仅凭下拉选项视作已接通。

详细证据与使用限制：iOS V1 · iOS V2 · Android 当前发行 · 鸿蒙历史验收。Android 已提供独立研究签名的完整实验 APK；iOS 仍需自行合并、构建与签名，不提供合并 IPA，鸿蒙不提供 HAP。各端服务配置均由用户自行准备。

• 自定义测试通知：App 主动发送一段文字到眼镜，不等于读取微信等其他 App 的通知；需要眼镜连接并开启应用内通知总开关。
• iOS 系统通知：需允许系统蓝牙设备的“共享系统通知”，且来源 App 自身获准通知；具体以系统设置和对应客户端为准。
• 鸿蒙系统通知转发尚未实现：需要 ohos.permission.SUBSCRIBE_NOTIFICATION、符合要求的签名/证书授权、通知订阅扩展及用户授权。普通应用通知开关、蓝牙权限、在清单声明一行权限，都不等于已获得读取其他 App 通知的能力。不要为此盲目修改签名等级或 Root。 鸿蒙权限与已知限制

Android：雷鸟 AI Android 官方下载入口 · 完整 AI 接入说明

iOS：可使用上方 Release 提供的原厂 1.0.5（201）砸壳 IPA，或自行准备有权使用的兼容未加密副本。提供的 IPA 没有 Turbo IO 扩展，需自行合并和签名；普通 App Store 加密 IPA 不能直接合并。

Android 用户把官方下载入口 + 本仓库 + 下面的提示词一起交给电脑上的 Claude Code 或 Codex；iOS 官方扩展用户可同时提供上方原厂砸壳 IPA Release 链接，或自行准备合法兼容的未加密应用副本。原生鸿蒙 HarmonyOS 用户只需本仓库与提示词，不需要官方包。再让助手按所选路线检查环境、编译并引导配置；只有官方扩展需要合并宿主。不需要先弄懂所有脚本；但你仍需提供自己的签名、服务配置并完成手机授权和镜片验收。仅聊天、不能访问本机文件和终端的环境不能替你完成真机安装。

请帮我在这台电脑上接入 Turbo IO，仅用于个人非商业学习研究。
源码：https://github.com/Turbo1123/Turbo-IO
Android 官方 App 下载入口：https://rayneo.cn/commonPage/venus/appDownload/index_m.html
iOS 官方扩展原厂砸壳 IPA：https://github.com/Turbo1123/Turbo-IO/releases/tag/rayneo-ios-1.0.5-201
该 IPA 未合并 Turbo IO，需校验 SHA-256、版本和 UUID，再自行合并、配置并签名；也可使用我自行准备的合法兼容副本。
目标：[原生鸿蒙 HarmonyOS 客户端 / Android 官方扩展 / iOS 官方扩展 / iOS 独立 SDK / 仅 Web 预览]

先读取 README、docs/AI_SETUP.md 和目标平台文档，检查电脑环境、现有项目改动及设备状态。
没有源码时克隆到新的目录；使用仓库现成构建、测试和合并脚本，不要只给我操作教程。
官方下载页用于 Android 宿主，不保证当前下载版本兼容，需核对版本和 SHA-256；iOS 对自行准备的副本核对版本、UUID 及未加密 thin arm64 要求。原生鸿蒙不需要官方 APK/IPA，按 harmony-sdk/README.md 用自己的 DevEco 签名编译。
下载或输入不兼容时停止合并并说明缺什么，不修改校验、不绕过加密，也不索取第三方破解包。
先完成能独立验证的构建或预览，再引导我使用自己的签名；安装、卸载、重启或改变绑定前确认目标和数据备份。
Key由我在本机安全填写，不索取聊天明文、不复用维护者配置，不把私钥、安装包、录音和日志提交到GitHub。
官方扩展沿用官方连接；切换到V1或鸿蒙独立客户端才按文档解绑和忽略蓝牙。
完成后分别报告源码/编译/安装/登录/眼镜/模型的实际结果；未验收明确标注，不把构建成功当作全部可用。

• 原生鸿蒙 HarmonyOS：独立客户端已在 Mate X5（HarmonyOS 6.1）验证连接、自有语音和步行模拟导航镜片显示，无需 Root，也不需要官方 APK / IPA。使用 DevEco Studio、自有开发者账号和签名自行编译安装，服务 Key 自行配置；不提供 HAP 或签名包。系统通知转发尚未实现，其他限制见鸿蒙安装、权限与验收说明。
• Android：非 Root 设备已由用户实机验证可用；官方下载页用于取得 Android 宿主，输入仍需通过仓库校验，使用自己的签名与服务配置。见 Android 安装教程。
• iOS：从上方原厂砸壳 IPA 或自行准备的合法兼容副本提取未加密 Runner.app；仍需校验、合并与个人签名，官方下载/商店安装不等于取得可合并输入。只用 V1/Web 不需要官方包。见 iOS 扩展教程。

已有 turbo-io 技能也可使用，见技能安装与更新；选择鸿蒙时，应同时提供 HarmonyOS 安装教程，不要套用 iOS/Android 宿主合并流程。

近期功能按日期整理在更新区。以下保留各平台的历史适配记录，不代表本次重新验收。

模型 Key、搜索 Key、TTS 云端 Key、个人提示词与私有知识库由使用者自己配置；本机 TTS 不需要服务 Key。二进制例外仅限上方原厂砸壳 IPA，以及独立标注警告的 R3、TNV1、ANIM60、TMU1、TWR1 实验固件/原厂内容基线 Release；不提供合并后手机成品包或个人签名材料。固件中的原厂代码/资源版权不变，实验附件不是官方升级推荐；未知二进制版本不得跳过兼容检查。iOS 详细版本/UUID见 V2文档，Android输入校验见 Android文档。

iOS V1 配置 · Web 观察与预览 · Agent 接入 · Roadmap · 许可与隐私

以下主要介绍 iOS V1 独立 SDK，不能把其通知、Codex、录音等验收套到其他平台；Android 与鸿蒙请优先阅读上方各自教程。鸿蒙尚未接入 Codex 工具，不能因为 iOS 已接通就认为鸿蒙也可用。

V1 是非官方 SDK 的 iOS 示例客户端与研究工具，用于独立连接、语音、录音、通知及 Agent 接入。需要自行编译、签名、配置服务；不是直接安装的消费级 App。功能与其他平台独立验收，遵循本页开头的非商业许可及隐私边界。

An unofficial RayNeo iO smart glasses SDK for developers, with a sample iOS client—not a ready-to-install consumer app. Build, sign and configure your own services to explore voice AI, recordings, custom notifications, Codex integration and a read-only web display observer.

V1 独立客户端连接前务必先在雷鸟官方 App 内解绑，再到手机蓝牙设置中“忽略此设备”，然后重新进入配对模式连接 Turbo IO。 详见下方“连接前必读”。非越狱 iPhone 已由用户实机验收；Android 官方扩展另见上方路线表，Android 独立客户端仍待开发。

本项目仅面向懂 iOS 开发、签名、API 配置与基本调试的技术用户，用于互操作研究。如果希望开箱即用、不熟悉这些操作，请使用官方 App。部分功能仍在验证，欢迎一起研究和补充实测，不承诺替代官方 App 的全部功能。

以下为项目实际运行截图：手机使用无账号、无密钥的隔离模拟器页面；Web 使用明确标注的样式演示数据。不是眼镜像素截图，也不表示截图时已经连接眼镜。

源码包含浏览器端显示观察工具，方便研究雷鸟 iO 的页面状态与双向事件：

• 实时跟随：通过手机临时观察接口与 USB 转发读取真实页面/状态回报，区分眼镜回报和 App 已提交内容。
• 样式预览：首页、对话、单页应用菜单和通知模板；菜单支持逐页查看七个应用图标。
• 明确边界：这是协议状态重绘，不是镜片录屏或截图，不会修改眼镜 UI；切换预览样式不会给眼镜发控制指令。
• 隐私：本地只读观察，默认不含正文，文字观察需单独同意，临时接口会过期。不把断开前的旧快照冒充实时画面。

下图分别为对话与菜单样式；“观察接口失联”表示拍摄时没有连接手机，不影响查看演示布局。启动与 USB 配置见配置文档。

只看样式预览不需要手机、iproxy 或服务密钥：

node display-observer/server.mjs --no-proxy

打开 http://127.0.0.1:8790/，选择“首页样式 / 对话样式 / 菜单样式 / 通知样式”。实时跟随才需要手机的临时观察接口与 USB 转发。

以下能力表属于 V1 iOS 研究版；Android 官方扩展的范围与验收见 Android 文档。

• 使用自己的服务完成眼镜语音识别、流式 AI 回答与会话内插话；保存聊天文字时间轴。
• 接收眼镜录音、保存本机，手动触发云端转写，导出音频与文字。
• 下发待办、提词器内容和天气；导入 TXT / EPUB 作为本地书稿。
• 发送自定义通知，把电脑任务结果主动推到眼镜。
• 以眼镜作为 Agent 的语音输入与结果显示入口。目前实际打通的是 Codex，其他 Agent 需要开发适配器，状态见下表。
• 通过 USB + Web 观察协议回报的页面/状态，辅助研究双向交互；这不是眼镜截图。

扩展方向依据各项目公开入口提出，不等于本仓库已经内置或验证这些适配。参考：Claude Agent SDK、Hermes Agent、OpenClaw Gateway。各服务账号、权限、费用和适用条款由用户自行配置与确认；不能只把名称换成另一个 Agent 就直接运行。

本项目研究的雷鸟 iO 使用 BES2800 平台，走的是低功耗、轻量嵌入式固件路线，而不是完整的 Android 应用系统。可以把它理解为“随身输入与显示终端”：眼镜负责唤醒、音频和内置界面，手机/云端/电脑承担更复杂的识别、模型与 Agent 任务。它不是一台能随意安装 APK、替换 Launcher、运行任意 Android 界面的微型手机。

在原厂固件路线中，主要通过协议给眼镜自带模板填入内容和发送控制指令。自定义 AP 路线则已新增 Turbo Display 和原生导航，证明可以扩展眼镜端绘制与应用页面；两条路线的前提和风险不同。限制来自当前固件和可用通信接口，不能简单归结为 BES2800 完全没有图形能力。 恒玄对 BES2800 系列的定位也是超低功耗可穿戴计算平台；系列不同型号的可选规格不代表这副眼镜全部具备。芯片背景见恒玄官方介绍。

• 日常 SDK/App 不能通过普通协议任意替换眼镜固件内置 UI，也不是刷机/自定义桌面工具。 除自定义通知外，研究中已验证有限 A2UI 仪表盘文字/布局卡片；鸿蒙当前验证到短文字卡。独立的自定义 AP 应用路线已实现传图与原生导航，但不等于 HTML/Canvas 运行时或通用第三方 App 安装。
• 原厂固件上的对话、待办、提词器、天气等主要通过已有模板下发内容；这不否定自定义固件中的新增绘制页面，但也不代表原厂所有模板均可任意修改。Web 预览样式也不会变成镜片固件 UI。
• 独立客户端不能与官方 App 同时抢连同一副眼镜。 V2 官方扩展在宿主中沿用连接，不要为了新增导航反复解绑。
• 不能保证完整离线录音、任意长度的无损补传、长期后台永不掉线、强退后可靠推送或所有固件都兼容。
• 不提供官方历史数据迁移、镜片像素级截图、语音自动批准高风险电脑操作；NAS / Obsidian 自动入库尚未完成。

未完成或仍有问题的功能会继续标注，不把成功回执当作镜片验收。欢迎提交脱敏日志、复现步骤和 PR；请勿上传自己的 Key、录音、聊天、设备标识或他人的私人数据。

已安装 Node.js 和相应编程助手的用户，可以用一行命令安装 turbo-io 技能（用户级，同时面向 Codex 与 Claude Code）：

DISABLE_TELEMETRY=1 npx --yes skills@1.5.24 add Turbo1123/Turbo-IO --skill turbo-io -g -a codex claude-code --copy

在安装器中确认目标后，新开助手会话，让它执行：“使用 turbo-io 技能，帮我以非商业学习用途安装并启动 Turbo IO，先跑不需要眼镜的 Web 预览。” Claude Code 可输入 /turbo-io，Codex 可在技能选择器中选中或显式提及技能。

技能会检查环境、获取源码、启动预览，再按需指导 iOS 编译、服务配置与 Codex bridge。一行安装的是技能，不是已签名 iPhone App：真机仍需自己的 Xcode 签名、配对和服务 Key。支持 Claude Code 使用技能，不等于已经实现眼镜的 Claude Code 后端适配。完整说明与手动安装。

仅针对 V1 独立客户端从官方 App 切换的首次配对；官方 App 扩展不需要为扩展解绑。使用 V1 前务必先完成以下步骤，再尝试连接：

1. 在雷鸟官方 App 内对这副眼镜执行“解绑”，确认解绑完成；仅关闭官方 App 不等于解绑。
2. 打开手机“设置 → 蓝牙”，找到对应的雷鸟眼镜，进入设备详情并选择“忽略此设备”，清除旧配对记录。
3. 让眼镜重新进入配对状态（长按按钮约 5 秒，确认蓝灯闪烁），再到 Turbo IO 内配对和连接。

不要让官方 App 与 Turbo IO 同时连接或抢连同一副眼镜。已经绑定到 Turbo IO 后的日常重连，不需要每次重复解绑、忽略或重置。只用模拟器预览的用户无需操作眼镜。

准备 macOS、Xcode、XcodeGen、Node.js 和一个可用模拟器，在源码根目录运行：

node scripts/start.mjs --local

选择 RayNeoCompanion + 模拟器，在 Xcode 点击 Run。这条路径不需要厂商库/眼镜/云 Key，可使用本机页面、文件、待办和书库。ZIPFoundation 0.9.20 已以本地源码依赖附带；Xcode/运行时由使用者安装。

实际连接眼镜使用：

node scripts/start.mjs --device

设备版所需的现有厂商 framework、Opus 静态库/头文件和 WebRTC VAD 编译源码已经随工程提供，版本清单见 DEPENDENCIES.json。脚本预检依赖并重新生成恢复接口声明模块；缺文件会明确列出。在 Xcode 选择 RayNeoCompanionDevice，设置自己的 Team，连接自己的 iPhone 编译运行。具体步骤与 API 配置见 配置与启动。

1. 从官方 App 切换时先完成上面的解绑、忽略蓝牙设备与重新配对；已绑定 Turbo IO 的眼镜在设备页重连/认证即可，别反复重置。
2. 在语音服务页填写自己的 ASR Host / Key 与 DeepSeek Key，再选择启用待命。
3. 唤醒后识别文字与模型回答流式显示，会话内有效新句可以插话。
4. 录音先保存本机，手动点转写才上传到自己的 ASR。聊天文字在“会话 → 对话时间轴”。
5. Codex、天气和 USB 观察分别按需配置；不要把另一项的 Key 当通用令牌。

源码无默认开发者租户或凭据；用户提供的服务必须支持当前已实现的协议/模型，不承诺随意换一个 API 名称就兼容。iPhone 当前目标 iOS16+，独立公共传输包需要Swift6.2+工具链。

• TWR1 阅读：完善长按返回、将无网页适配的手机模块接入公开构建与专用 OTA 门禁，再扩大镜片验收；目前公开的是可复现 AP 与手机源码模块，不是开箱应用。
• TMU1 音乐：降低旋钮误切歌，增加距离阈值/可配置控制；扩大后台、断连恢复和长时运行验收。本次发布保留当前实测行为，不宣称这些改进已完成。

以下是后续研究方向，不是已实现功能或交付时间承诺；顺序会随实测结果与社区贡献调整。

• 眼镜端应用研究进展：Turbo Display 显示测试工具与独立原生导航页面已在研究设备实现并取得初步反馈，详见顶部功能区。
• 发布 TDP1 / TNV1 匹配研究版：固定实测固件、可复现 AP 源码、手机协议/后台修复、默认锁定的 OTA 门禁及构建/操作文档；仍是高风险 Pre-release，不等于生产稳定版。
• ANIM60 动图实验源码与实测样本：眼镜端内置素材、目标 60 次/秒提交的定时绘制已获 30 秒研究机反馈；不宣称面板 60 FPS，也不提供通用动图上传/专用手机 OTA 门禁。
• iOS V2 回答同步朗读：官方与自有模型显示时可选 TTS，默认本机免 Key，云端由用户自配；云端私用版听感已验，本机版仍待单独听感与长对话验收。
• 优先完善现有链路：连接恢复与后台稳定性、待办完成状态回传、长录音接收和导出，扩展更多设备及不同固件的实测。
• Android 官方扩展源码：自有模型、搜索、音频分享、地图规划、镜片文字及模拟回放；详见独立教程中的验收分层。
• 原生鸿蒙研究版源码：独立连接、自有语音、天气/卡片/待办、原生高德导航入口；自行编译签名，不提供 HAP。鸿蒙说明
• 鸿蒙停止更新（2026-09-27）：保留既有源码；地图白屏、系统通知、后台、录音与提词器等遗留限制不再安排维护，也不跟进新固件。
• Android 后续：扩大非 Root 机型与签名/地图配置覆盖、模拟导航镜片回归、户外跟随和稳定性；继续移植待办、提词器、全天智记。独立配对 SDK 仍待开发。
• 更多 Agent 适配：继续完善 Codex，研究 Claude Code、Hermes Agent、OpenClaw；WorkBuddy 仍需先确认接入方式，以上新增适配均未测试。
• 记录与知识库：完善录音/对话归档，研究 NAS、Obsidian 与用户自建服务的导出和同步。
• 更丰富的手机 App：后续考虑完善书库/提词器、待办、天气、设备设置和配置体验；原厂固件路线继续使用已有模板；自定义固件路线单独推进显示与导航应用，不混淆两者的风险。
• 开发者文档与验收：补充协议说明、适配示例、脱敏测试数据与功能验收记录，欢迎一起研究、提 Issue 或 PR。

项目仍建议开发者按自己的需求编译、改造和研究使用，不以面向普通用户的开箱即用产品为当前目标。不熟悉开发与调试的用户，建议继续使用官方 App。

先分析官方 App 结构和真实交互，区分连接认证与业务消息；复用通信核心快速打通独立客户端，再把可确定逻辑拆成 protocol、session、transport、display、archive 等 Swift 包。眼镜做输入/显示，手机做连接/音频/状态，云端做识别和模型，电脑执行 Codex。

眼镜端应用路线则只修改 AP：Turbo Display 接收像素，TNV1 接收导航数据并在眼镜侧绘制，ANIM60 在 AP 内置帧并本地定时绘制，以不同方式扩展显示能力；未修改其余13个固件负载，但官方完整OTA仍可能写入未变化的负载。

完整解释及踩坑：实现思路 · Turbo Display 与原生导航。它说明证据如何建立、为什么不能把发包成功当镜片显示成功，以及为何当前不急于把通信底层全部重写。

node --test codex-bridge/bridge.test.mjs display-observer/*.test.mjs
xcrun swift test --package-path rayneo-protocol
xcrun swift test --package-path rayneo-session

更多步骤见配置文档。本地通过、普通签名、真实镜片与非越狱验收分别记录；不使用含开发者录音或账号的fixture。

已有源码交付的编译与测试记录见 交付验证；本次 README 整理未重新执行各平台编译与真机测试。

自己的Key保存在自己的iOS钥匙串；云对话会上传音频/识别文字，录音转写由用户手动触发。音频/Markdown留在自己的App容器，不覆盖原件，不自动上传NAS。Hash/CRC不是加密，也不构成全程端到端加密承诺。

当前有权授权的原创内容采用 PolyForm Noncommercial 1.0.0，用于非商业学习研究；未经授权不得商用或收费分发。历史 MIT 权利不追溯撤销，详见许可说明。第三方组件及厂商通信库不因随工程使用而变更许可，具体归属见 第三方说明。本工程与设备厂商无官方隶属关系。

发布不包含个人录音、聊天、凭据、绑定数据库、原始日志、私有临时隧道配置或个人签名私钥。Android Release 的完整修改 APK 使用独立研究发行签名；单独列出的原厂砸壳 IPA 不含 Turbo IO 扩展，原厂部分也不适用本仓库原创源码许可证。详见源码发布说明；旧文档中“不提供安装包”的一概表述，以本页明确列出的发行例外为准。仍不提供合并 IPA / HAP，其他隐私边界不变。

如果 Turbo IO 对你的研究和开发有所帮助，觉得好用，欢迎自愿打赏。感谢支持！请不要在打赏前私信要求作者先加功能，也不要用“做完某功能就打赏”作为交换条件；功能建议欢迎在 Issues 讨论，不承诺采纳或排期。

打赏完全自愿，不代表购买软件、功能定制、技术支持、售后或商业授权，不产生交付义务，也不改变本项目的非商业许可。