它不是
- 远程桌面的缩小版
- 多租户协作平台
- 企业级零信任公网系统
- 桌面 CLI 的 100% 完整替代品
PRODUCT STORY
项目介绍
这一页专门讲清楚 rCodex 到底是什么、解决什么问题、由哪些部分组成、为什么它不是一页套壳聊天工具， 以及它更适合什么用户，不适合什么方向。
POSITIONING
它是一套面向个人远程开发的控制台，不是“移动端远控一切”
rCodex 的核心定位非常明确：让已经跑在另一台机器上的 Codex CLI， 通过移动端获得可读、可控、可继续的远程工作流。它不追求把手机变成桌面 IDE， 而是把最关键的状态、审批、输入、诊断和版本入口整理成一条更适合移动端接管的链路。
它更像是
- 个人 Codex 会话控制台
- 主机侧执行与移动端接管的中间层
- 带版本发布闭环的实用工具链
- 专门为“离开电脑也要掌控任务”设计的产品
SYSTEM PARTS
项目由三层组成，每一层都只做它该做的事
这三层拆分是 rCodex 能长期维护的基础。如果所有复杂度都塞进 App， 会变成难以阅读、难以升级、难以验证的混合体。
01 / App
移动端负责阅读体验与操作入口
App 负责登录、会话列表、聊天流、审批弹层、输入请求、诊断页、 版本状态和应用内文档阅读。移动端的职责不是理解所有底层协议， 而是把真正有意义的状态与动作清晰地呈现给用户。
- 查看任务列表和运行状态
- 阅读结构化会话输出，而不是直接吞原始终端
- 处理审批、输入请求、诊断和版本说明
02 / Gateway
Gateway 负责收敛协议和边界，而不是做一个薄转发层
Gateway 负责认证、状态聚合、会话托管、协议桥接、审批回传、历史落盘、 目录白名单与版本聚合。真正困难的地方不在“把数据传过去”， 而在于把底层行为稳定地组织成面向产品的状态模型。
- 桥接 `thread/start`、`thread/resume`、`turn/start`、`interrupt`、`steer`
- 统一输出 HTTP API 与 WebSocket 消息
- 把底层执行细节转成 App 能读懂、用户能操作的模型
03 / Release
发布链路也是产品的一部分
很多项目只演示功能，不经营发布。rCodex 把 App 版本、Gateway 版本、 `version.json`、更新说明、升级文档、APK 路径和运维日志放在同一条链路里。 这让它在对外分发和后续回滚时更可控。
- 安装包命名、版本说明和升级文档联动
- Gateway 镜像 tag 与对外版本保持一致
- 过程日志和运维日志可以追溯每次调整
REAL FLOW
真实使用时，用户不会关心你有什么技术栈，只关心事情能不能顺畅地继续下去
手机上创建新会话或导入已有 thread
不是每次重新开局，而是能把本机已有上下文带进移动端。
主机继续执行，App 负责实时阅读和接管
用户看到的是消息流、授权流和诊断状态，而不是一堆原始 JSON 或终端噪音。
审批、输入、插话和中断在移动端闭环处理
这一步决定了远程开发是否真的可用，而不只是能“看一眼”。
回到桌面时，上下文和历史还在
会话索引、历史事件、审批和输入请求会被持久化，避免刷新即失忆。
DEVICE DEMO
真机演示图
下面这些截图展示了 App 的真实交互界面， 方便你直接查看首页任务列表、会话详情、设置面板和体验偏好这些核心页面。
首页任务列表
展示连接状态、新建会话入口、任务筛选和可继续会话，是用户进入 App 后最先接触的主入口。
会话详情与继续追问
展示真实聊天流、状态栏、模型与用量信息，以及移动端继续追问输入区的交互效果。
设置面板
展示网关连接、服务诊断、版本与升级、体验偏好和授权规则等实际已发布的设置入口。
体验偏好
展示关键状态提示音、后台守候和详细原始事件等可配置能力，反映已落地的阅读与提醒体验。
RELEASED CONTENT
这里提供产品介绍、真机演示和部署入口
你可以在这里快速了解产品能力，查看 App 界面示例， 并进入升级文档、部署说明与 Docker 使用指引。