Open Island 状态管理内幕SessionState 纯 Reducer 如何成为会话数据的单一可信源【免费下载链接】open-vibe-islandNative macOS control center for AI coding agents — monitor sessions, approve actions, and jump back instantly.项目地址: https://gitcode.com/gh_mirrors/op/open-vibe-island如果你同时运行多个 AI 编程 AgentClaude Code、Codex、Gemini CLI……Open Island 帮你把分散在各终端里的会话收拢到 macOS 刘海处统一监控与审批。它的核心秘密之一是 SessionState.swift 里一个纯 Reducer 结构体——所有会话状态变更都经由同一个apply(event)入口成为会话数据的单一可信源Single Source of Truth。本文将用最少代码讲清楚这套状态管理模式。为什么需要一个「单一可信源」AI 编程 Agent 的会话信息来自多个信号源Hooks 事件、进程轮询、终端跳转解析、心跳信号……如果每个信号源各自维护一份状态很快就会出现面板里显示运行中进程其实已经退出权限审批弹窗和实际会话阶段不一致不同 UI 入口面板、通知、右键菜单看到的数据互相打架Open Island 的解法很直接所有可变状态收进一个SessionState结构体所有写操作必须经过它的方法UI 层只读不写。数据流从 Agent 事件到纯 Reducer整个数据流在 docs/architecture.md 中有完整描述Agent Hooks ──stdin JSON──▶ OpenIslandHooks CLI ──Unix Socket──▶ BridgeServer │ ▼ AppModel ──▶ state.apply(event) ──▶ SwiftUI 刷新关键角色只有三个角色职责文件AgentEvent描述发生了什么的不可变事件AgentEvent.swiftSessionState纯 Reducer事件 旧状态 → 新状态SessionState.swiftAppModel唯一持有状态的Observable把事件喂给 ReducerAppModel.swift13 种事件驱动全部状态迁移AgentEvent是一个枚举覆盖了会话生命周期的每种变化sessionStarted、activityUpdated、permissionRequested、questionAsked、sessionCompleted、jumpTargetUpdated、各工具专属的xxxSessionMetadataUpdated、sessionHeartbeat、actionableStateResolved。每个事件都携带稳定的会话 ID 时间戳并实现Codable与Sendable——这意味着事件可以跨进程通过 Unix Socket 以 JSON 传输也可以在单测里直接构造重放。纯 Reducer 到底纯在哪看 SessionState.swift 的apply(_:)方法它是一个大switch每种事件对应一段确定性的状态迁移逻辑。这种设计带来三个关键性质✅ 确定性相同输入必得相同输出apply内部没有任何随机数、没有读时间时间戳来自事件本身、没有发网络请求、没有触碰 UI。给定同一个SessionState和同一串事件序列结果永远一致。这是它能成为可信源的前提。✅ 无副作用状态变更全部收敛在结构体内部内部只有一个私有写入口private mutating func upsert(_ session: AgentSession) { sessionsByID[session.id] session }所有迁移最终都通过upsert落到sessionsByID字典上不存在绕道修改状态的旁路。✅ 防御式编程乱序事件不会把状态搞坏针对不存在会话 ID 的事件 → 直接guard return静默丢弃Agent 已回到running但仍挂着未审批的权限请求 →保留可操作状态不被覆盖SessionState.swiftPi 会话的 heartbeat 到达时如果会话已丢失 → 自动用 payload 里的recoverySession重建后再应用SessionState.swift这种幂等 容错正是事件驱动架构能扛住 Hooks 乱序、重复、丢失的关键。用户操作也走同一套 Reducer值得强调的是你在面板上点允许或回答问题不是 UI 直接改数据而是转成对 Reducer 的一次调用审批权限 → AppModel.swift 调用state.resolvePermission(...)回答问题 → 调用state.answerQuestion(...)周期性的进程存活轮询 → 调用state.markProcessLiveness(...)连续两次轮询未见进程才判定会话结束避免ps瞬时波动造成闪烁不可见会话清理 →state.removeInvisibleSessions()用户操作、系统轮询、Hooks 事件——三类输入全部汇入同一个状态机UI 各入口因此永远看到一致的数据。读侧派生状态全部是计算属性SessionState上暴露的sessions按更新时间排序、runningCount、attentionCount、activeActionableSession等全部是基于sessionsByID实时计算的派生值不额外存储。想要什么统计就地派生杜绝了计数器没同步这类经典 bug。会话可见性规则isVisibleInIsland见 AgentSession.swift同样是纯函数演示会话恒可见 → 等待审批/回答恒可见 → 进程存活才可见。规则一目了然。可测试性纯 Reducer 的红利正因为apply是纯函数测试不需要启动 App、不需要真实 Agent直接构造事件序列即可验证。SessionStateTests.swift 里大量用例就是这种写法连发两次markProcessLiveness(aliveSessionIDs: [])断言 Codex CLI 会话被正确判定结束依次apply权限请求 → 提问事件断言attentionCount与activeActionableSession.phase的迁移符合预期模拟 Claude Desktop 场景验证 hook 管理会话的存活语义此外 scripts/replay-bridge-scenarios.py 还支持在真实场景下重放 Bridge 事件序列等于给 Reducer 做录像回放式回归。这套模式能给你的项目什么启发 事件与状态分离用枚举 payload 描述发生什么AgentEvent.swift而不是让各处代码直接改共享对象。单一写入口所有迁移收敛到apply(_:)一个方法审计和调试都只盯一处。纯函数 免费的可测试性无 I/O 的 Reducer 让单测零成本、可重放。派生不存储统计值用计算属性现算天然一致。设计文档先行docs/session-state-refactor.md 记录了 Open Island 从复杂附着状态模型重构到进程存活即可见的完整推演过程是理解这套状态机演化背景的最佳阅读材料。想深入了解完整架构与数据流可以继续阅读 docs/architecture.md 与 docs/hooks.md。【免费下载链接】open-vibe-islandNative macOS control center for AI coding agents — monitor sessions, approve actions, and jump back instantly.项目地址: https://gitcode.com/gh_mirrors/op/open-vibe-island创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考