try2love / codex-mobile-bridge

# Codex Mobile Bridge · 多客户端远程工作台
> **v2.1.2 正式版**：发布页 · 完整更新说明 · 手机安装说明。改善终端直接输入、OpenCode 类终端 CLI 的触摸滚动、断线恢复与跨平台显示，补齐 Windows 终端组件。
简体中文 · English
**双语介绍与使用演示 ↗** · **下载桌面与手机 App**
从手机 App 或浏览器继续电脑上的 **Codex、Claude Code / Cowork、DeepSeek Harness** 会话。三个客户端保留独立聊天列表、账号和工作区；在当前应用下创建会话、查看回复、发送附件、切换可用模型与推理强度、处理权限请求。
任务继续在原电脑执行，Codex 的 SSH 任务继续在原服务器执行。网关复用原客户端的会话、认证和执行环境，不让手机重新运行一套 Agent。手机无需登录相同的模型账号，使用网关登录或可撤销的扫码配对即可接入。
## 待发布：Mermaid 图表阅读
当前开发版已加入以下功能，已发布的 v2.1.2 安装包尚不包含这些改动：
- 聊天正文与文件列表中打开的 `.md` 文档，可将完整的 `mermaid` 代码块显示为图表，支持中文和浅色、深色主题。
- 点击“源码”查看原文，点击“复制源码”复制 Mermaid 文本；点击图表或“全屏查看”进入大图阅读。
- 手机支持双指缩放、放大后拖动与双击；电脑支持滚轮、拖动和加减按钮。“适应屏幕”恢复完整视图，全屏内也可切换源码。
- 未完成的流式代码先保留源码；后续文字更新复用未变化图表，不打断当前全屏和缩放。图表无法显示时仍可查看、复制源码。
使用时更新网关并刷新页面；iOS 还需配套更新 App，以修复图表子页面被拦截的问题。详见待发布说明。
## v2.1.2 更新
- **终端直接输入**：手机与宽屏 Web 默认直接输入，改善中文输入、光标与焦点恢复，新增 Enter；保留可选的“编写后发送模式”和分阶段 Tab 路径补全。
- **交互与连接**：改善 OpenCode 类终端 CLI 的触摸滚动、鼠标选择与退出后的布局；减少网络往返造成的额外等待，临时断线后自动恢复仍有效的终端。
- **显示与兼容性**：终端字号独立调节为 6–24px，修复小字号、中文混排与背景边界；Windows 完整携带 ConPTY 组件，修复鼠标事件丢失和安装器漏装组件。
- **阅读设置**：主题与语言移到设置顶部，正文字号扩为 10–32px，代码字号扩为 8–28px。
### v2.1.1 更新
- **账号与模型**：三个客户端统一账号卡片与模型选择；模型目录缓存优先，按电脑、账号与接入隔离，显示更新时间，支持手动及 12 小时更新。
- **草稿与文件**：跨聊天和电脑保留未发送草稿；定位文件平滑滚动并高亮，左上角直接返回聊天列表；支持工具截图预览。
- **日常体验**：修复快速滑动回跳、列表与模型重复加载，优化 iOS 通知跳转；网关和手机可跳过当前更新，修改密码可选择保留有效手机绑定。
### v2.1.0 更新
- **CLI 与文件阅读**：从手机或 Web 阅读、显式恢复 Codex / Claude Code CLI 会话；源码、PDF 和自包含 HTML 有专门的阅读预览。
- **连接与列表**：接入已有 HTTPS 穿透或反向代理；Codex 列表逐主机呈现，Claude 混合列表按日期排序，来源标签持续可见。
- **跨平台体验**：改善 Windows 连续终端与 Claude 初始化、DSH 主机识别、iOS Safari 输入时的视区和滑动布局；所有客户端停用后仍可管理网关。
### v2.0.3 更新
- **Android 更新**：在 App 内下载并安装新版，自主选择手机下载或电脑下载；下载完成后可继续安装或导出 APK。详见手机安装与升级。
- **第三方通知**：手机与 Web 可选择 Bark（iPhone）、ntfy（Android）或 PushPlus（微信），配置、保存并测试，与电脑网关共用设置。
- **搜索与布局**：搜索框保留「搜索 / Search」，筛选按内容分配宽度；改善英文、横屏和平板列表，支持 Claude/DSH 下拉刷新，恢复后清除旧错误提示。
- **连接与工作台**：手机安全保留有效绑定并尝试恢复登录，改善 Claude 重连与初始化；设置入口和文件传输保存文案更清晰，关闭工具标签时保留仍有内容的分屏。
## 文件阅读与预览
- **定位与返回**：聊天文件链接可平滑定位并高亮目标 3 秒。左上角返回直接回聊天列表；文件区上级目录按钮与系统返回仍支持层级导航，全屏的系统返回先退出全屏。
- **源码阅读**：常见代码显示语法高亮和行号；点击“自动换行”让长行适合屏幕，或切回“原始行宽”。复制代码保留原文，不带行号；这是只读预览，不修改文件。未知语言与较大文本使用纯文本。
- **PDF 阅读**：手机滑动翻阅、双指缩放，电脑浏览器保留翻页和缩放按钮。有文本层时可选择文字，扫描件不提供 OCR；不同尺寸的页面分别适配宽度。快速缩放时先保留原画面，再替换完成的新画面，减少闪烁。
- **HTML 阅读**：在“预览 / 源代码”之间切换。自包含 HTML 的内联交互和动画可运行；外部资源、CDN、后端请求、弹窗和表单提交不受支持。预览与网关登录信息、父页面和手机原生接口隔离。
- **Mermaid 图表（待发布）**：Markdown 文件与聊天使用相同的图表、源码和全屏阅读入口，见图表阅读说明。
- **紧凑操作与全屏**：下载、复制或预览操作位于文件描述右侧；下载旁可展开全屏。全屏进出保留 PDF 位置和 HTML 状态；切换文件标签后返回 PDF 仍保留位置，HTML 则重新加载。
PDF 在线阅读最大 **20 MiB**，且不超过当前普通点击下载限额；源码和 HTML 为 **512 KiB 以内的 UTF-8 文本**。超限或不支持的文件可下载后打开。完整使用本轮改进需配套更新网关与手机 App；浏览器用户更新网关后刷新即可。
## CLI 会话（v2.1.0 正式版）
现有 CLI 会话可在手机和 Web 中发现、阅读；点击“继续会话”后可接入或恢复原 CLI 会话，原终端无需保持打开。若 Codex App 已接续该聊天，网关会复用经核验的现有执行连接；未发现该连接时，仅会在显式操作时接入或启动已安装的原生托管 daemon。连接后支持模型与推理强度、Skill、普通/计划模式、权限切换，以及兼容本机/SSH 原生 CLI 运行时的 Goal 操作。设置中的“SSH 连接诊断”可查看本机与远端状态、复制摘要或导出脱敏文件；旧版手机 App 需更新后才能导出。详见 CLI 接入说明。
Codex 与 Claude CLI 接入分别在各自账号管理中配置；本机 CLI 同步需主动启用，并分别显示桌面与 CLI 核验结果，SSH 保留各服务器配置。Claude 可从已有本机或 SSH 项目创建 CLI 聊天，保留所选配置与工作目录。来源标签始终显