Turbo IO · 雷鸟 iO / RayNeo iO 非官方 SDK

面向开发者的智能眼镜 SDK 与 App 扩展研究项目：iOS、Android，以及新增的原生鸿蒙 HarmonyOS 客户端。自有模型、搜索、录音研究、Agent 与眼镜导航。不是给小白直接安装的成品 App。

原创代码仅供学习、研究与非商业使用，沿用 PolyForm Noncommercial 1.0.0，未经授权不得商用或收费分发。发布源码与明确列出的依赖，另在 Release 提供下述原厂砸壳 IPA 作为 iOS 扩展输入。不提供已合并 Turbo IO 的 IPA / APK / HAP 成品包、个人预签名 App、签名证书、个人密钥或测试账号。需要自行配置、编译和签名。

iOS 原厂砸壳 IPA 下载

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

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

版权归雷鸟及相关权利人所有。 该 IPA 是二进制应用副本，不是官方应用源码；本仓库的源码许可证不适用于该 IPA。附件不含维护者个人 Apple 开发者签名、描述文件、服务密钥或账号数据，也不是为你的设备预签名的安装包。

文件：RayNeo_AI_1.0.5_201_decrypted_original.ipa
版本 / Build：1.0.5 / 201；Bundle ID：com.rayneo.venus.pub
SHA-256：39d12aff8f2b312dc3b40ce784a444e52c536e61378434005255177548df966a
普通 App Store 加密 IPA 仍不能直接合并；未知版本必须通过兼容性检查。项目不提供代砸壳或代签名服务。

先选开发路线

| 路线 | 适合什么需求 | 使用文档 | | --- | --- | --- | | iOS 独立 SDK（V1） | 自己配对、连接眼镜，研究完整客户端 | 本页快速开始 | | iOS 官方 App 扩展（V2） | 保留官方连接/ASR，加入模型、导出、新闻、导航 | iOS 扩展教程 | | Android 官方 App 扩展 | 保留 Android 官方流程，加入模型、TinyFish、录音导出、真实/模拟导航 | Android 编译、配置与导航教程 | | 原生鸿蒙 HarmonyOS SDK / 客户端 | 鸿蒙 HarmonyOS 6.1 实测：直接连接眼镜，自有 ASR/模型、天气、待办、自定义卡片与导航 | 鸿蒙 HarmonyOS 从源码安装与配置 |

别混用配对说明： V1 与鸿蒙独立客户端首次切换前，要先在官方 App 解绑、在原手机系统蓝牙忽略设备；iOS / Android 官方扩展运行在宿主内，沿用宿主连接，不需要为扩展反复解绑。不能同时让独立客户端和官方宿主争抢连接。

各端功能对比

更新于 2026-09-17。比较的是本仓库各条开发路线，不是官方 App 的完整功能清单。

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

| 功能 | iOS 独立 SDK · V1 | iOS 官方扩展 · V2 | Android 官方扩展 | 原生鸿蒙 HarmonyOS | | --- | --- | --- | --- | --- | | 应用形态 / 连接 | 实测：独立配对，复用厂商通信库 | 官方：保留登录、配对与连接 | 官方：保留登录、配对与连接 | 实测：原生独立配对、认证、初始化 | | 免越狱 / 免 Root | 非越狱 iPhone 已验 | 非越狱 iPhone 已验，需兼容未加密输入 | 非 Root 设备已验，需兼容 APK | 无需 Root；Mate X5 已验，无需官方包 | | 语音识别 ASR | 自有阿里流式 ASR / 云 VAD | 沿用官方 ASR | 沿用官方 ASR | 自有阿里流式 ASR / 云 VAD | | 自有模型 → 镜片回答 | 实测：支持流式显示 | 实测：支持流式显示 | 实测：支持流式显示 | 实测：当前非 SSE，取回后分段显示 | | 插话 / 回答后自动关闭 | 实测 | 部分：有研究实测，依赖官方会话事件 | 实测：研究设备通过 | 部分：退出已验；WB14 插话改动待复验 | | TinyFish 联网搜索 | 未接专用工具 | 实测：需自有 Key | 实测：需自有 Key | 待验：工具代码已接，默认关闭 | | Codex / 知识库 | 实测：发任务、查结果、完成通知 | 待验：只读服务/Tools 已有，公开版全链路未验全 | 待验：查询/状态适配代码已有 | 未接 | | 录音与文字导出 | 部分：短录音接收、手动 ASR 通过；长录音/完整分享待验全 | 部分：本机音频分享、转写整理；不保证完整官方历史 | 部分：本机录音选择/分享已验，不重建完整智记 | 部分：眼镜起录可用；手机起录及完整导出待验 | | 全天智记 | 部分：限时协议实验，非完整全天产品链 | 部分：开启保存后的片段导出，不补历史音频 | 未完整移植 | 未完成完整链路 | | 待办下发 / 双向同步 | 部分：新增/发送可用，眼镜完成回传仍有问题 | 部分：自然语音创建已验，网页全链路双向未验全 | 官方待办；扩展双向未完整移植 | 部分：下发镜片已验，反向完成待验 | | 提词器 / AI 新闻 | 部分：传稿、TXT/EPUB 书稿；未接新闻生成 | 部分：新闻长稿滚动已验，重启准备/速度未验全 | 官方提词；AI 新闻未完整移植 | 已知问题：眼镜菜单未知错误，列表握手未齐 | | 天气 → 眼镜首页 | 部分：自有天气已接，部分镜片验收 | 官方，不算独立天气移植 | 官方，不算独立天气移植 | 部分：模拟天气镜片已验，实时服务需配置/复验 | | 地图搜索 / 算路 | 未接本仓库导航模块 | 部分：地图搜索、三种模式入口；逐模式未验全 | 实测：地图/搜索，三种模式规划返回路线 | 部分：POI/步行算路已验；手机底图白屏 | | 导航 → 眼镜持续指引 | 未接 | 部分：模拟镜片已验，4 分钟保护 | 部分：真实路线文字已验；新增模拟模式待验，4 分钟保护 | 部分：步行模拟镜片已验，骑行/驾车待验 | | 真实外场 / 长期后台导航 | 未接 | 未完整验收，不作为已完成能力 | 未完整验收，前台研究指引 | 未完整验收，离页/后台停止导航 | | 主动自定义文字通知 | 实测：手动及 Codex 完成通知；非 APNs | 扩展主动推送未完成；APNs 未接 | 扩展主动通知未完整移植 | 待验：手动指令与总开关已接 | | 其他 App 系统通知转发 | iOS 系统共享通知，需用户授权 | 沿用官方/系统权限；不保证重签后官方推送 | 沿用官方通知能力与权限 | 未实现：需受限订阅权限、扩展和用户授权 | | Web 显示观察 | 实测：USB 状态观察＋样式预览，非像素投屏 | 不把 V1 观察能力直接套用 | 未迁移 V1 观察接口 | 未迁移 V1 观察接口 |

四端都不支持任意替换眼镜固件 UI；有限卡片/通知布局不等于自由绘制整个系统。Claude Code、Hermes、WorkBuddy、OpenClaw 也不能仅凭下拉选项视作已接通。

详细证据与使用限制：iOS V1 · iOS V2 · Android · 鸿蒙 HarmonyOS。各端都需自己的服务配置与签名，不提供已集成 Turbo IO 的成品安装包或个人签名包；上方原厂砸壳 IPA 仅作为 iOS 宿主输入。

通知与权限，先看这里

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

让 Claude Code / Codex 帮你接入

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 宿主合并流程。

V1：独立 SDK 与示例客户端

先看项目定位：这是给开发者用的非官方 SDK，不是给小白下载安装就能用的成品 App。

> 仓库中的 iOS App 是 SDK 的示例客户端与研究调试工具，用于演示和验证眼镜连接、语音、录音、通知及 Agent 接入，方便开发者二次开发。使用者需要自行编译、签名、配置 API，并具备基本的开发与调试能力。

> 不提供 V1 成品 IPA、代签名或开箱即用服务；上方原厂砸壳 IPA 不是 V1 客户端。不熟悉开发、只想直接使用眼镜功能的用户，请使用雷鸟官方 App。 部分功能仍在研究和验收，欢迎开发者一起完善。

仅供学习、研究与非商业使用，未经授权不得商用或收费分发。 当前原创内容采用 PolyForm Noncommercial 1.0.0，不再以 MIT 提供新版本。未经授权的商用可能侵犯相关权利，权利人保留依法追究法律责任的权利。第三方组件仍遵循各自许可，详见许可说明。

面向雷鸟 iO（RayNeo iO）AI 眼镜的非官方 SDK 研究项目，附带 iOS 示例客户端：眼镜语音 → 自己的 ASR/模型，录音 → 本地归档与手动转写，Codex → 电脑任务与结果通知。

V1 发布源码与明确列出的构建依赖，不发布 V1 成品 IPA、个人预签名 App 或开发者服务密钥。用户自行配置、签名与编译。 现阶段是研究驱动的开发版，不是所有设备/固件都已验收的通用 SDK。

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 使用明确标注的样式演示数据。不是眼镜像素截图，也不表示截图时已经连接眼镜。

Turbo IO 雷鸟 iO 非官方客户端，iOS 模拟器设备首页 Turbo IO 雷鸟 iO 工具箱，显示观察与 Agent 工具入口

Web 显示预览与观察台

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

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

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

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

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

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

!雷鸟 iO Web 对话预览：绿色镜片模板，演示文字，非实时画面

!RayNeo iO Web 菜单预览：每页一个应用图标，当前为录音

可以做什么

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

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

Agent 接入：已实现与可扩展

| Agent | 当前状态 | 接入思路 | | --- | --- | --- | | Codex | 已实现，有眼镜发起任务、查询结果及完成通知的实测记录 | 手机工具调用 → 本项目 HTTP bridge → Codex app-server → 任务事件 → 眼镜 | | Claude Code | 未实现适配、未测试 | 可研究通过 Claude Agent SDK 或 CLI 子进程实现电脑侧适配 | | Hermes Agent | 未实现适配、未测试 | 可研究其程序化入口/消息网关，转换为手机侧统一任务与事件接口 | | OpenClaw | 未实现适配、未测试 | 可研究 Gateway 协议适配，包括认证、任务、事件与权限处理 | | WorkBuddy | 理论上可研究接入，未测试 | 需先确认其可用 API / 扩展或自动化入口，不能保证当前已有可用接口 |

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

不可以做什么

为什么不像 Android 眼镜那样自由定制？

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

因此，当前主要是通过协议给眼镜自带模板填入内容和发送控制指令，而不是上传一套新 UI。限制来自当前固件和可用通信接口，不能简单归结为 BES2800 完全没有图形能力。 恒玄对 BES2800 系列的定位也是超低功耗可穿戴计算平台；系列不同型号的可选规格不代表这副眼镜全部具备。芯片背景见恒玄官方介绍。

当前边界

不能替换眼镜固件内置 UI，也不是刷机/自定义桌面工具。 除自定义通知外，研究中已验证有限 A2UI 仪表盘文字/布局卡片；鸿蒙当前验证到短文字卡。不能据此宣称支持任意页面、HTML、Canvas 或第三方 App 渲染。
对话、待办、提词器、天气等可以修改或下发内容，但只能使用眼镜自带的 UI 模板，不能自由改变模板排版与交互。Web 预览样式也不会变成镜片固件 UI。
不能与官方 App 同时连接同一副眼镜。 使用 Turbo IO 时停止官方 App 的连接；切换客户端需正确处理已有绑定，不要同时抢连接。
不能保证完整离线录音、任意长度的无损补传、长期后台永不掉线、强退后可靠推送或所有固件都兼容。
不提供官方历史数据迁移、镜片像素级截图、语音自动批准高风险电脑操作；NAS / Obsidian 自动入库尚未完成。

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

快速开始

用 Codex / Claude Code 技能引导安装

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

DISABLE_TELEMETRY=1 npx --yes [email protected] 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 后端适配。完整说明与手动安装。

连接前必读：先解绑，再忽略蓝牙设备

首次使用 Turbo IO，或从官方 App 切换过来时，务必先完成以下步骤，再尝试连接：

在雷鸟官方 App 内对这副眼镜执行“解绑”，确认解绑完成；仅关闭官方 App 不等于解绑。
打开手机“设置 → 蓝牙”，找到对应的雷鸟眼镜，进入设备详情并选择“忽略此设备”，清除旧配对记录。
让眼镜重新进入配对状态（长按按钮约 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 配置见配置与启动。

配置后怎么使用

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

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

能力与边界

| 能力 | 状态 | | --- | --- | | 独立 App 绑定/认证/连接恢复 | 厂商库复用路线有真机记录；非越狱设备已由用户实机验收通过 | | 云 ASR/VAD、DeepSeek 流式、持续插话 | 真机通过；新配置入口需在自己的服务验收，自有 TTS未完成 | | 普通录音→WAV、手动ASR→Markdown | 短录音真机通过；无线无损、长录音及完整离线开录不保证 | | 聊天时间轴、本机待办、TXT/EPUB | 已实现；不导入官方历史，系统提醒事项单向复制 | | 眼镜待办反向同步 | 当前有完成状态未回到 App 的问题 | | 提词、天气、通知 | 已接入，部分镜片验收；所有图标/旋钮/排版仍未全覆盖 | | Codex 发任务/查结果/主动提醒 | 有真机记录；无 APNs，语音自动批准未开放 | | 全天智记 | 限时实验，原包/电脑解码/ASR对照；非正式全天产品链 | | 显示观察 | 真实页面状态→USB→Web；不是镜片截图 | | NAS/Obsidian自动入库 | 未完成，已有本地导出基础 |

Roadmap

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

[ ] 优先完善现有链路：连接恢复与后台稳定性、待办完成状态回传、长录音接收和导出，扩展更多设备及不同固件的实测。
[x] Android 官方扩展源码：自有模型、搜索、音频分享、地图规划、镜片文字及模拟回放；详见独立教程中的验收分层。
[x] 原生鸿蒙研究版源码：独立连接、自有语音、天气/卡片/待办、原生高德导航入口；自行编译签名，不提供 HAP。鸿蒙说明
[ ] 鸿蒙下一步：地图白屏与外场导航、系统通知权限路径、插话/后台回归；录音与提词器继续研究，不将其列为全功能已验收。
[ ] Android 后续：扩大非 Root 机型与签名/地图配置覆盖、模拟导航镜片回归、户外跟随和稳定性；继续移植待办、提词器、全天智记。独立配对 SDK 仍待开发。
[ ] 更多 Agent 适配：继续完善 Codex，研究 Claude Code、Hermes Agent、OpenClaw；WorkBuddy 仍需先确认接入方式，以上新增适配均未测试。
[ ] 记录与知识库：完善录音/对话归档，研究 NAS、Obsidian 与用户自建服务的导出和同步。
[ ] 更丰富的手机 App：后续考虑完善书库/提词器、待办、天气、设备设置和配置体验；丰富的是手机端与业务内容，不改变眼镜内置 UI 的限制。
[ ] 开发者文档与验收：补充协议说明、适配示例、脱敏测试数据与功能验收记录，欢迎一起研究、提 Issue 或 PR。

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

怎么做出来的

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

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

源码布局

| 路径 | 内容 | | --- | --- | | android-addon | Android 官方 App 扩展、纯 Java 测试及本地合并工具 | | official-addon | iOS 官方 App 扩展、导航及本地构建/合并说明 | | harmony-sdk | 原生鸿蒙 HarmonyOS SDK、ArkUI 客户端、导航及自行签名安装教程 | | apps/RayNeoCompanion | SwiftUI客户端与测试，技术名称为兼容保留 | | core-probe/Sources | 当前设备版复用的研究通信/语音适配源码 | | rayneo-* | 纯Swift协议、会话、传输、显示、归档和容器检查模块 | | codex-bridge | 电脑端受限HTTP桥接与测试 | | display-observer | USB只读观察服务与Web预览 | | scripts/start.mjs | 开发工具检查、依赖预检、打开Xcode | | scripts/check-source.mjs | 不打印敏感值的发布候选扫描 | | docs | 启动、架构、发布边界 |

测试

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。

本次源码交付的编译与测试记录见交付验证。

隐私与许可

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

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

发布不包含个人录音、聊天、凭据、绑定数据库、原始日志、私有临时隧道配置、个人开发者签名或预签名 App。Release 中单独列出的原厂砸壳 IPA 不含 Turbo IO 扩展，也不适用本仓库原创源码许可证。详见源码发布说明；旧文档中“不提供 IPA”的一概表述，以本页明确列出的原厂 IPA 例外为准，其他隐私和签名边界保持不变。

请我喝杯咖啡 ☕

如果 Turbo IO 对你的研究和开发有所帮助，欢迎自愿捐赠，支持后续维护与探索。感谢支持！

捐赠不代表购买软件、技术支持或商业授权，也不改变本项目的非商业许可。

请我喝杯咖啡 · 自愿捐赠支持 Turbo IO