完整指南Remodex核心桥接服务剖析看懂phodex-bridge如何编排Codex、Git与桌面IPC【免费下载链接】remodexRemote Control for Codex.项目地址: https://gitcode.com/gh_mirrors/re/remodexRemodex 的核心桥接服务就藏在phodex-bridge/这个 Node.js 包里它运行在你的 Mac 上一端通过安全会话连接 iPhone 上的 Remodex 移动应用另一端驱动本地 Codex 运行时同时拦截 Git 命令、把工作区操作和桌面 IPC 实时同步一并编排起来。换句话说phodex-bridge 就是让你用手机远程遥控 Codex的总调度中心。本文带你用通俗视角读懂它的架构、关键模块与数据流向。一图看懂phodex-bridge 的中枢定位官方架构图把三方关系画得很清楚iPhone 应用通过 WebSocket 桥接 Mac 上的 remodex 桥接服务桥接服务再通过 stdin/stdout 的 JSON-RPC 与codex app-server对话本地 Codex IPC 总线和~/.codex/会话目录则负责与 Codex 桌面端的互通见 README.md┌──────────────┐ Paired session ┌───────────────┐ stdin/stdout ┌─────────────┐ │ Remodex iOS │ ◄────────────────────► │ remodex (Mac) │ ◄──────────────────────► │ codex │ │ app │ WebSocket bridge │ bridge │ JSON-RPC │ app-server │ └──────────────┘ └───────────────┘ └─────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ Codex.app │ ◄─── persisted fallback ─│ ~/.codex/ │ │ (desktop) │ disk on navigate │ sessions │ └─────────────┘ └─────────────┘从入口文件就能看出它对外暴露的能力版图启动桥接、重置配对、恢复/监听线程、以及 macOS 后台服务launchd管理全部汇总在 phodex-bridge/src/index.js。最快上手remodex up一条命令启动桥接在 Mac 上全局安装后只需运行remodex up桥接服务就会拉起codex app-server子进程或连接已有 WebSocket 端点把 Mac 桥接接入你配置的 relay双向转发 JSON-RPC 消息打印配对二维码供 iPhone 首次信任握手在 macOS 上注册launchd后台服务关掉终端也保持运行核心编排逻辑集中在 phodex-bridge/src/bridge.js——它同时引入 git 处理器、桌面 IPC、语音、推送、rollout 监听等十余个模块是整个桥接服务大脑。如果你要从源码本地运行也可以git clone https://gitcode.com/gh_mirrors/re/remodex cd remodex ./run-local-remodex.sh启动器会自建一个本地 relay 并打印配对二维码完整自托管教程见 Docs/self-hosting.md。Codex 传输层spawn 与 endpoint 两种接入方式桥接服务如何抓住 Codex答案在 phodex-bridge/src/codex-transport.js。它抽象出两种传输模式模式触发条件行为spawn默认直接派生codex app-server子进程通过 stdin/stdout 传 JSON-RPCendpoint设置REMODEX_CODEX_ENDPOINT连接一个已存在的 Codex WebSocket 实例适合远程 Codex值得一提的是spawn 模式还内置双保险启动计划当 launchd 这类守护环境里找不到 PATH 中的codex命令时会自动退而尝试捆绑的桌面二进制保证 macOS 后台服务能稳定拉起codex-transport.js。Git 命令拦截手机上的 11 个git/*方法在哪执行在手机上点Commit Push之后命令并不是发给某个远端服务而是被桥接服务拦截并在本地 Mac 执行。入口是 phodex-bridge/src/git-handler.js它解析 JSON-RPC 消息只要方法名以git/开头就接管否则放行给 Codex。常见方法一览方法作用git/status分支、跟踪信息、脏状态与 diffgit/commit/git/push/git/pull提交、推送、拉取冲突自动中止git/branches/git/checkout/git/createBranch分支管理git/stash/git/stashPop暂存工作区改动git/resetToRemote硬重置到远端需确认工程细节也很贴心Node 默认 1 MiB 输出缓冲会被大仓库 diff 撑爆git-handler 直接把执行缓冲提到 50 MiB并为长流程预留了进度回调sendNotification让手机端能实时看到 git 操作进展git-handler.js。工作区的撤销 AI 改动能力则由 phodex-bridge/src/workspace-handler.js 负责workspace/revertPatchPreview先干跑反向补丁确认干净后才由workspace/revertPatchApply真正应用且配套 checkpoint 快照机制避免误伤无关改动。桌面 IPC手机会话如何活在 Codex 桌面端Remodex 与 Codex 桌面端Codex.app / VSCode的实时互通是 phodex-bridge 最精巧的部分核心角色分工如下协议翻译层desktop-ipc-conversation-adapter.js把 app-server 的 JSON-RPC 流量转译成 Codex 桌面端认识的conversationState结构——时间线、审批、归档状态、标题、token 用量都能呈现。流拥有者传输层desktop-ipc-owner-transport.js桥接服务以Desktop 流拥有者身份加入本地 IPC 总线如果总线路由器不存在Codex 没开着它会自己起一个兼容路由器让会话数据先落地。显式移交desktop-handler.js处理desktop/*RPC例如 iPhone 里点的hand-off按钮会在 Mac 上打开对应线程。rollout 文件监听rollout-watch.jsCodex 会话以 JSONL 格式持久化在~/.codex/sessions这个模块轮询监听文件增长是桌面刷新与用量回退的共享基础设施。数据流因此形成双向闭环手机端发起的线程会作为桌面兼容的conversationState广播到本地 IPC 总线桌面端随时可以跟读反之桌面端正在跑的线程也会被桥接镜像回手机。磁盘上的 JSONL 历史则始终作为兜底详见 README.md 的桌面集成章节。安全与韧性端到端加密配对 自动重连端到端加密通道配对二维码携带连接 URL、会话 ID 与桥接身份公钥握手时双方交换 X25519 临时密钥用 Ed25519 身份密钥互相签名验证再用 HKDF-SHA256 派生 AES-256-GCM 会话密钥应用消息带单调计数器防重放。传输层只能看到连接元数据看不到提示词、工具调用与 git 输出明文。断线自愈会话掉线后桥接以指数退避1s → 5s 上限自动重连安全重连后还会补发本地缓冲中遗漏的加密消息Codex 进程在瞬时重连期间保持存活。macOS 后台服务launchd托管的轻量服务让可信 Mac 自动重连无需每次扫码remodex status/remodex restart可管理其生命周期。文件地图核心模块速查模块职责src/bridge.js桥接主服务编排全部子系统src/codex-transport.jsCodex 传输抽象spawn / endpointsrc/git-handler.jsgit/*JSON-RPC 本地执行src/workspace-handler.js工作区预览、读取与补丁回滚src/desktop-ipc-*.jsCodex 桌面端 / VSCode IPC 同步src/rollout-watch.jsJSONL rollout 文件查找与监听src/secure-device-state.js设备身份与可信配对状态relay/可自托管的传输层与推送服务测试覆盖也很扎实phodex-bridge/test/下数十个用例覆盖了 git 处理、桌面 IPC、rollout 监听与传输安全运行npm test即可验证。小结phodex-bridge 的设计哲学非常清晰Codex 运行时、Git 与工作区操作全部留在 Mac 本地桥接服务只做三件事——安全会话编排、JSON-RPC 双向转发、桌面 IPC 同步。理解了这个中枢你就理解了 Remodex 为什么既能做到端到端加密又能让手机、Mac 桌面端与 Codex 三方实时同屏。接下来可以深入 CodexMobile/CodexMobile/Services/ 看看 iOS 侧的CodexService如何与这座桥握手。【免费下载链接】remodexRemote Control for Codex.项目地址: https://gitcode.com/gh_mirrors/re/remodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
