Lody iOS 是专为 iPhone 打造的独立开源客户端，通过轻量安全的方式连接远程 Lody 服务与本地工作区。
本项目采用 React Native + 深度定制 Swift 原生模块（LodyKit） 的混合架构，在保留跨平台声明式 UI 高效迭代优势的同时，关键交互（聊天长列表、流式文字渲染、代码差异高亮、文件树等）均使用原生 Swift 与 CoreText 深度打磨，提供极致纯正的 iOS 系统质感。
- 遵循人机交互界面指南：全面适配 iOS 系统语义色彩、自适应浅深色模式、SF Pro / SF Mono 动态字号（Dynamic Type）。
- 原生导航交互：采用 Expo Router 原生 Stack 与 NativeTabs，支持原生软滚边（soft scroll edge effects）、交互式侧滑返回手势，以及 UIKit 原生分组列表（
UICollectionViewListCell）。
- 虚拟化长列表：聊天视图由 Swift 原生
UICollectionView支撑，即便面对超长消息历史依然保持满帧流畅。 - CoreText Markdown 渲染：深度集成 MarkdownView 与 Litext，原生支持复杂表格、语法高亮代码块、任务列表、LaTeX 数学公式与系统级选词手柄。
- 逐字流式平滑淡入：结合均匀分批调度算法与底层
CTRunDraw字符透明度过渡，让 AI 思考输出过程平滑柔和、不突兀、不闪烁。 - 原生输入控件
ChatComposerView：与系统输入法软键盘像素级贴合避让，支持输入草稿本地持久化自动恢复，以及模型思考强度（Thinking Effort）实时调节。
- 代码变更一览：每轮对话活动自动汇总文件变更，支持一键进入整轮变更文件列表（Turn Changes）。
- 词级差异高亮：借助 YiTong 封装并在本地无感渲染 @pierre/diffs，提供精准的行内对比、语法高亮与虚拟化快速滚动。
- 远程工作区文件树：随时查阅远程 Mac / 服务器上的项目目录与文件，支持通过原生代码视图
LodyCodeView或系统 QuickLook 预览。
- 无感 CRDT 协同：在 Swift 托管的离屏
WKWebView中运行官方 Loro / Flock CRDT 增量同步核心与 Streams 客户端，彻底规避传统 React Native 打包 Node/CRDT/Zstd 底层依赖的兼容问题。 - 看门狗保障（Watchdog）：Swift 原生探活机制保障后台任务稳定运行，发生异常时支持无感热恢复。
- 多会话后台增量：本地 SQLite 展示快照保障首屏毫秒级加载，后台自动维持最近活跃会话的实时双向增量同步。
- 标准设备流认证：使用官方 Better Auth Device Flow 授权机制。
- 系统级 Keychain 托管：所有认证凭据与敏感通信密钥严格隔离保存在 iOS Keychain 中，不暴露在应用公共存储中。
flowchart TB
subgraph UI ["React Native 呈现层 (Expo Router)"]
direction TB
Tabs["NativeTabs / 原生 Stack 导航"]
Presentation["definePage / present() 页面呈现运行时"]
Screens["会话详情 / 文件树 / 差异查阅 / 设置"]
end
subgraph NativeKit ["本地原生模块 (modules/lody-kit)"]
direction TB
LodyKitModule["LodyKit NativeModule 门面"]
ChatView["LodyChatView (UICollectionView)"]
Markdown["MarkdownView & Litext (CoreText 逐字淡入)"]
DiffView["YiTong & @pierre/diffs 原生代码对比"]
Composer["ChatComposerView (原生输入与键盘避让)"]
end
subgraph DataEngine ["离屏数据引擎 (Swift 守护)"]
direction TB
OffscreenWV["离屏 WKWebView"]
Flock["Flock WASM / Loro Streams 增量核心"]
Watchdog["Swift 原生看门狗 (2s 探活 / 热重启)"]
SQLite["本地 SQLite 视图投影快照"]
end
subgraph External ["系统底层与云端通信"]
Keychain["iOS Keychain 凭据安全存储"]
CloudStreams["远程 Lody Cloud Streams / 机器 RPC"]
end
UI -->|"调用与事件订阅"| NativeKit
NativeKit -->|"状态变更与派发"| DataEngine
DataEngine -->|"只读增量投影"| UI
DataEngine -->|"加密信封请求"| CloudStreams
DataEngine -->|"快照持久化"| SQLite
NativeKit -->|"凭据操作"| Keychain
lody-ios/
├── apps/
│ └── mobile/
│ ├── src/
│ │ ├── app/ # Expo Router 路由与 Stack 声明
│ │ ├── presentation/ # definePage / present() 页面呈现机制
│ │ ├── features/ # 业务页面 (sessions, changes, files, settings)
│ │ ├── theme/ # Apple HIG 语义化设计令牌
│ │ └── ui/ # 共享 React Native 基础组件
│ ├── modules/
│ │ └── lody-kit/ # 第一方本地原生 Swift 模块 (LodyKit)
│ │ ├── ios/ # Swift / UIKit / CoreText 原生代码
│ │ ├── data-runtime/ # 离屏数据运行时 RPC 与适配脚本
│ │ └── src/ # 面向 React Native 的类型化原生组件入口
│ ├── plugins/ # 本地 Expo 编译插件 (如 cocoapods-spm 配置)
│ └── package.json
├── docs/ # 架构设计、演进文档与规格说明
├── package.json # Monorepo 根配置
└── pnpm-workspace.yaml
- macOS：推荐 Sequoia 或更高版本
- Xcode：16.0+（安装 Command Line Tools）
- Node.js：
>= 22.13 - pnpm：
11.10.0 - Ruby & Bundler：系统自带或 Homebrew Ruby（推荐安装
cocoapods和cocoapods-spm）
-
克隆项目并安装依赖：
git clone https://github.com/Innei/lody-ios.git cd lody-ios pnpm install -
生成原生工程并启动模拟器：
pnpm ios
[!TIP] 本项目通过
cocoapods-spm引入 SPM 静态库依赖。pnpm ios内部会自动生成工程并调用bundle exec pod install完成依赖拉取与符号挂载。 若已完成原生编译，后续仅修改 JavaScript 代码时直接运行pnpm start即可连接热重载服务。 -
原生资产更新：
若修改了
modules/lody-kit/data-runtime/中的运行时资源，可单独执行：pnpm --filter @lody-ios/mobile native:assets
pnpm check # 执行 TypeScript 类型检查与 Prettier 风格校验
pnpm test # 执行端到端会话逻辑测试 (基于 Node.js 22 内置测试执行器)
pnpm bundle # 验证 iOS Hermes JavaScript 生产包打包完整性Lody iOS 的实现离不开以下优秀的开源项目与创作者的支持：
- FlowDown：感谢 Lakr233 及其贡献者。Lody 的原生消息长列表、流式分批机制及动态测量缓存体系汲取了其架构灵感。
- MarkdownView & Litext：为本项目带来了兼具极致性能与高扩展度的 CoreText Markdown 渲染与文本排版能力。
- YiTong：感谢 onevcat 的优秀封装，使优雅高效的原生代码差异渲染在 iOS 上成为可能。
- @pierre/diffs：提供了出色的词级高亮差异算法与现代化 Web diff 体验。
- Loro：高效稳定的下一代 CRDT 状态协调技术。