iPhone App
已上傳 TestFlight，等待開放測試體驗。手機端設置 API URL、Token、Face ID、連線測試等必要資訊。
TestFlight Uploaded + Self Hosted Relay
用 iPhone 接續 Mac 上的 Codex
CodexMobile iOS 測試版已上傳 TestFlight，正在等待開放體驗。產品以可安裝的 iPhone App、Mac 菜單欄客戶端與 VPS Relay 交付， 默認使用客戶自己的 VPS；沒有 VPS 或不想維護服務器時，可以購買托管 Relay，由服務方提供 API URL 與 Token。
TestFlight
iPhone 測試版已提交，等待 TestFlight 處理完成後即可邀請測試者安裝體驗。
默認自托管
客戶使用自己的 VPS、域名與 Token，連線權限掌握在自己手上。
兩端配置
Mac 菜單欄負責服務與配對，手機端只需要填 API URL 和 Token。
可付費托管
沒有 VPS 的用戶可聯繫服務方，購買托管 Relay 連線資訊。
Installable Clients
交付安裝包，不要求客戶看源碼
Mac 菜單欄客戶端
以 `.dmg` 或 `.pkg` 交付，負責啟動本機服務、自動重連、防止待機、生成手機配對 QR 與管理桌面端參數。
VPS Relay 部署包
客戶有 VPS 時，部署 App API、Relay、Nginx HTTPS 與 systemd 服務，手機從外網安全轉回 Mac。
托管 Relay 服務
客戶沒有 VPS 時，由服務方提供托管 API URL 和專屬 Token。適合不想維護服務器、只想安裝後使用的客戶。
Default Path
默認流程：客戶使用自己的 VPS
1
部署 VPS Relay
在客戶 VPS 上部署 CodexMobile App API，配置 HTTPS 域名與 `CODEXMOBILE_APP_API_TOKEN`。
→
2
安裝 Mac 客戶端
在 Mac 菜單欄填 API URL、App Token、Mac Service Token 與專案根目錄，再啟動本機服務和桌面橋接。
→
3
手機掃碼配對
Mac 菜單欄生成 QR，iPhone 掃描後自動填入 API URL 和 Token，再測試連線。
Configuration
參數放在客戶端設置裡
手機端設置
- API URL：自托管 VPS 或托管 Relay 地址，可由 Mac 配對 QR 自動寫入。
- Token：`CODEXMOBILE_APP_API_TOKEN` 或托管服務分配的用戶 Token。
- Face ID：可選開啟，每次重新打開 App 時驗證後再查看內容。
- 測試連線：保存前確認手機能連到 Relay 並通過認證。
Mac 菜單欄設置
- 手機連線 API URL。
- 手機 App Token 與 Mac 本機服務 Token。
- 專案根目錄：手機端看到和新建項目的默認桌面位置。
- 開機自啟、自動連線、保持 Mac 醒著、重新連線。
Managed Relay
沒有 VPS 的客戶，可以購買托管連線
你提供 API URL 和專屬 Token，客戶只需要配置兩端客戶端
托管 Relay 適合不懂 VPS、沒有域名、不想維護 HTTPS 和 systemd 的客戶。服務方負責 Relay 可用性， 客戶在手機端與 Mac 菜單欄填入你提供的 URL、Token，即可連回自己的 Mac。
建議服務邊界保持清晰：Relay 只做認證與轉發，盡量不長期保存客戶代碼、截圖和對話內容。
客戶自己有 VPS
你提供部署包和安裝說明，客戶自己保存服務器、域名和 Token。
客戶沒有 VPS
你按月或按年收費，提供可用的 Relay URL、Token 和基礎支持。
最小化數據
托管模式應明確說明 Relay 的日誌、保存範圍、Token 失效和撤銷方式。
Architecture
手機、VPS、Mac 三段式連線
iPhone
CodexMobile App
查看桌面會話、補充需求、處理審批、上傳附件、接收桌面截圖。
→
VPS
Relay / App API
驗證手機 Token，轉發請求到 Mac，提供外網可訪問的 HTTPS API。
→
Mac
Menu Bar + Desktop Bridge
維持本機服務、反向隧道與 Codex Live 會話，讓手機接續同一個 thread。
Next Step
先安裝兩端客戶端，再決定自托管或托管
已有 VPS 的客戶走自托管部署；沒有 VPS 的客戶可聯繫服務方購買托管 Relay。兩種方式的手機端和 Mac 端操作保持一致。