| title | Codex Remote 文档仓库 | ||
|---|---|---|---|
| tags |
|
||
| aliases |
|
||
| status | active | ||
| updated | 2026-08-26 |
这是 Codex Remote 的产品、架构、协议和发布知识库。应用代码保持五个独立仓库：iphone-app、mobile-web、relay-server、mac-agent 和 admin-platform；Homebrew 分发另由 runtime-distribution 与 homebrew-tap 两个独立仓库维护。
Codex Remote 是独立开源项目，与 OpenAI 没有关联或背书关系。
[!success] 当前可用能力 Apple Silicon 本机已经可以启动完整 Runtime、生成一次性二维码，并在 iPhone Safari 单标签中完成配对、刷新恢复、真实会话、SSE、退出与 Mac 端撤销。详细真机证据以
mobile-web/docs/iphone-safari-acceptance.md为准。
[!warning] 发布状态 源码与架构文档采用 Apache-2.0 公开。已经发布的
0.2.0-beta.1至0.2.0-beta.3二进制仍保留其历史许可，且尚未完成 Developer ID 签名和 Apple 公证；公开源码不等同于生产就绪。
- [[Codex Remote - 项目首页]]：当前状态、仓库边界和下一步
- [[系统总体架构]]：当前组件、数据流和部署边界
- [[Mobile Web Gateway 与 Runtime 鉴权架构]]：局域网入口、配对与鉴权
- [[Mobile Web 前端视觉与动效规范]]：流式状态、执行轨迹和移动端视觉基线
- [[Run Server HTTPS 与 SSE 接口规范]]：用户侧 Runtime 契约
- [[Run Server JSON 轮询接口规范]]：非 SSE Runtime 事件契约（本地已实现）
- [[Runtime JSON 轮询传输架构]]：轮询传输、游标和资源边界（本地已实现）
- [[Runtime JSON 轮询实施与验收清单]]：跨仓库实施顺序和验证门槛
- [[0.2.0 Homebrew 发布候选]]：本地验收证据和公开发布阻塞项
- [[发布与版本策略]]：Runtime、iPhone 与 Admin 的独立发布规则
| 内容 | 唯一事实源 |
|---|---|
| Runtime 发布状态与组件 commit | [[0.2.0 Homebrew 发布候选]] 和 Runtime manifest |
| HTTP/SSE 接口 | relay-server/apifox/openapi.json 与 [[Run Server HTTPS 与 SSE 接口规范]] |
| JSON 轮询接口 | [[Run Server JSON 轮询接口规范]]（本地已进入 OpenAPI；公网硬化待完成） |
| Agent WebSocket | relay-server/protocol 与 [[MVP WebSocket 协议]] |
| 真机 Mobile Web 验收 | mobile-web/docs/iphone-safari-acceptance.md |
| 安装、修复与卸载 | runtime-distribution/README.md 和 docs/installation-troubleshooting.md |
| 架构取舍 | 05-架构决策/ 下的 ADR |
已完成的短期开发计划不继续承担状态汇总职责；完成证据进入发布记录、仓库 Changelog 或维护手册。历史 MVP 只保留一份范围定义，避免旧拓扑与当前 Runtime 并列成为实现入口。
本仓库采用 Apache License 2.0。贡献前请阅读组织级 贡献指南； 版权与项目名称说明见 NOTICE。