Innei/lody-ios

Independent iOS client for Lody — native chat, sessions, and coding-agent collaboration on iPhone

Lody iOS – 它是什么

Lody iOS 是一款开源且由社区维护的 iPhone 客户端，专为 Lody AI 助理平台设计。它让您可以将远程 Lody 服务（即“代理”）连接到原生 iOS 应用程序，查看并流式传输聊天消息、浏览远程工作区的目录树，以及查看代码差异——同时保持与一般 iOS 应用程序相同的使用体验。

为什么存在

官方 Lody 客户端并非 iOS 原生应用，因此本项目通过 Swift 支持的 React Native UI 填补了这一空白，并遵循 Apple 的人机界面准则 (Human Interface Guidelines)。
它展示了复杂的 AI 驱动协作工具可以通过混合架构快速构建（从原型到 TestFlight 仅需一周）。

核心技术组件

组件	功能	实现方式
UI 层	声明式界面、导航、主题	React Native 0.86 搭配 Expo Router；使用原生堆栈进行导航与表单
原生套件 (LodyKit)	高性能聊天列表、Markdown 渲染、代码差异查看、键盘处理	Swift 6 模块，将 UIKit/UICollectionView、CoreText 与自定义视图暴露给 RN
流式聊天	实时 AI 生成文字逐字显示，60/120 fps	Swift `UICollectionView` + CoreText `CTRunDraw` 淡入动画
CRDT 同步引擎	保持本地会话状态与远程 Lody 工作区同步	离屏 `WKWebView` 运行 Loro/Flock WASM CRDT 核心；由 Swift 看门狗监控
目录树与差异查看器	浏览远程项目文件、查看单词级差异	原生目录树 UI + 托管 `@pierre/diffs` 的 vendored Expo DOM WebView
实时预览 / 模拟器查看器	在应用程序内显示远程 iOS 模拟器画面	使用 baguette 服务器将 H.264 帧流式传输至 `AVSampleBufferDisplayLayer` 并回传触摸事件
安全性	安全存储凭证	iOS Keychain + 标准 OAuth 设备流程验证

您可以用它做什么

与 Lody 代理聊天 – 消息实时流式传输，Markdown（表格、代码、LaTeX）原生渲染。
检查代码变更 – 每次对话可总结文件编辑；点击开启全屏差异查看。
浏览远程工作区 – 在连接的 Mac 或服务器上查看目录与文件、预览代码或开启 Quick-Look。
实时预览开发服务器 – 当代理报告本地开发 URL 时，“预览芯片”可直接在 Safari 或应用程序内视图开启隧道服务网站。
运行远程 iOS 模拟器 – 观看 Mac 托管模拟器的实时视频并从手机与其互动。

如何开始

加入 TestFlight 测试版 – https://testflight.apple.com/join/1rR6Ku8f (需要 iOS 26+)。

本地构建 (macOS Sequoia+, Xcode 26.5+, Node ≥ 22, pnpm 11):

git clone https://github.com/Innei/lody-ios.git
cd lody-ios
pnpm install
cd apps/mobile && bundle install   # CocoaPods
pnpm ios   # 生成 Xcode 项目并启动模拟器

运行应用程序 – 首次原生构建后，pnpm start 将启动 React Native 打包器以进行热重载。

项目健康与维护

活跃开发 – 仓库记录了“一日原型，一周发布”的故事，且 main 分支更新迅速。每次推送都会自动发布构建版本至 TestFlight。
测试 – 包含 TypeScript 检查、UI 基线验证、模拟器自动化测试以及完整的测试套件 (pnpm test)。
授权 – 仅限 AGPL-3.0，这意味着任何网络服务的修改也必须开源。
社区 – README 提醒这是一个第三方客户端；问题应在此处提出，而非上游。

谁会觉得这很有用？

iOS 开发者：想要原生外观的 AI 助理客户端，并对混合 RN/Swift 架构感到好奇的人。
研究人员或爱好者：探索实时 AI 聊天流、基于 CRDT 的协作或移动设备远程模拟器交互的人。
使用 Lody 的团队：需要 iPhone 优先体验且不想等待官方客户端的人。

总结

Lody iOS 是一款真正且技术精良的开源 iOS 客户端，专为 Lody AI 协作平台打造。它结合了 React Native UI 与 Swift 级别的性能，实现了聊天流、Markdown 渲染、CRDT 同步与远程工作区交互，并在 AGPL-3.0 授权下通过 TestFlight 发布。