手機接續 Mac Codex 會話
手機端可以連到 VPS，再回到 Mac 本機服務，查看目前專案與會話。
Project Journal
項目進度
這裡用非工程術語記錄 CodexMobile 目前做到哪裡、哪些能力已可用、哪些問題正在修，以及下一階段的優先級。 目標是讓使用者不需要翻開發記錄，也能快速理解項目狀態。
桌面端與手機端顯示一致性
正在處理 Codex app-server 不穩時，手機端 fallback 與桌面端顯示不一致的問題。
Codex app-server 高內存 / 超時
已確認這不是手機 UI 問題；目前採用短超時與本機降級，避免拖慢手機端。
Current Status
目前完成度
手機 App
Beta- 已支援專案列表、置頂專案、會話同步、附件、截圖預覽與停止按鈕。
- 模型、推理級別與訪問權限會跟隨桌面端狀態顯示。
- 目前仍在修正：折疊區內容歸類、文件變更統計、圖片保存與回退修改體驗。
Mac 菜單欄
可用- 已支援自動連線、停止連線、重新連線、查看狀態、打開專案資料夾。
- 後台服務已改成低常駐資源，不再讓 CodexMobile 自己長時間重壓 Codex。
- 下一步會補更清楚的錯誤提示，讓使用者知道是 VPS、Mac service 還是 Codex app-server 出問題。
外網 Relay
可用- 已支援手機從外網連回 Mac，並透過 Token 做基本保護。
- 具體對外操作說明暫不公開，等同步一致性穩定後再開放。
- 下一步會增加更完整的健康檢查、錯誤分類與對外發布說明。
會話同步
重點修正中- 正常情況下優先讀 Codex app-server，目標是和桌面端一致。
- app-server 超時時會走本機 rollout fallback，避免手機端完全空白。
- 目前主要差異來自 fallback 無法 100% 還原桌面端的折疊區與文件變更統計。
Timeline
近期進展
確認新版 Codex 26.422.71525 的 app-server 狀態
新版仍出現 app-server 初始化 timeout 與高內存風險。CodexMobile 目前採取「短超時嘗試 app-server， 失敗後走本機 fallback」的策略，避免手機端同步被拖死。
補強手機端發送、停止與回退修改流程
發送後不再長時間等待容易 timeout 的桌面 app-server；停止和回退修改改為更快返回，圖片附件也會一起保留到輸入框。
修正 snapshot 502 與文件變更卡片缺失
修掉本機服務中「未命名項目」造成的 snapshot 失敗，並補上 rollout fallback 解析，讓手機端至少能看到 timeline、 命令與文件變更卡片。
改善 Mac 截圖預覽與保存流程
手機端可以接收 Mac 桌面截圖並預覽；保存到相簿仍需要持續完善 iOS 原生保存流程與檔案路徑處理。
Known Issues
目前仍在處理的問題
手機端與桌面端折疊區不完全一致
桌面端有自己的會話渲染邏輯。當 app-server 可用時應以 app-server 為準；當 app-server 超時時，fallback 只能從本地 rollout 推斷，因此仍可能有折疊區差異。
文件變更統計仍可能和桌面端不同
若拿不到桌面端原始 fileChange，手機端只能從 diff 或文字摘要重建統計。下一步會優先保留桌面端明確返回的統計值， 減少重算造成的差異。
Codex app-server 超時或高內存
這是目前同步一致性的最大外部風險。CodexMobile 會避免長時間阻塞等待 app-server，但完全一致仍依賴 app-server 能穩定返回完整會話資料。
Next
下一階段優先級
- 優先讓 app-server 健康時的手機端顯示和桌面端完全對齊。
- app-server 不健康時，fallback 要明確標註「降級同步」，避免讓使用者誤以為與桌面端完全一致。
- 補齊文件變更統計、圖片保存、額度顯示、停止與回退修改的穩定性。
- 等核心體驗穩定後，再重新公開完整對外操作說明。