中文
本次发布将 Android 客户端从基础远程聊天扩展为更完整的 Codex 会话移动端控制工具。
新增
- 聊天输入栏新增协作模式、会话目标、模型、推理强度、沙盒和 Token 状态控制。
- Android 支持上传图片和发送多图消息,并可鉴权查看、缩放、复制和保存会话图片。
- 支持鉴权下载会话文件、预览图片、打开或保存二进制文件,并提供 APK 安装引导。
- 支持 Markdown 和受限的静态 HTML 预览,可切换源码与渲染视图,并解析相对图片路径。
- 新增后台、跨会话、审批、连接失败和任务完成通知。
- 支持显示北京时间消息时间,并持久化相关设置及纳入备份恢复。
- 新建会话时支持浏览和选择远程项目目录。
优化与调整
- Bridge 会优先选择可用的最高版本 Codex 二进制,同时保留显式
--codex-bin配置的最高优先级。 - 缩小会话列表响应体积,支持按时间范围筛选历史会话,并可在打开侧边栏时自动刷新。
- 桌面端 rollout 监控改为增量读取追加内容,可处理不完整行、文件截断与轮转,并对实时事件去重。
- Android release 构建在本地 Maven 缓存可用时会自动复用缓存。
修复
- 修复新建、切换、刷新和恢复会话时模型、推理强度、沙盒选择与当前会话状态不同步的问题。
- 即使后端线程摘要尚未更新,也会持久化成功发送消息时使用的模型和推理强度。
- 恢复聊天输入框的回车换行能力。
- 稳定用户消息标识,使实时投影能够与权威会话快照正确对账。
- 持久化并展示 Codex 后端连接失败,附带可操作的网络排查提示。
发布产物
- Android debug APK:
android/app/build/outputs/apk/debug/codex-remote-control-v0.2.0-debug.apk - Android release APK:
android/app/build/outputs/apk/release/codex-remote-control-v0.2.0-release.apk
注意事项
- 已安装的旧版本必须继续使用同一份
android/release.keystore和android/release-signing.properties,才能原地升级。 - Android 13 及以上版本需要先授予通知权限,才能显示后台通知。
- 当前 WebSocket 生命周期仍由 Activity 管理,后台消息为尽力送达;详见
docs/android-background-connection.md。
English
This release expands the Android client from basic remote chat into a more complete mobile companion for active Codex sessions.
Added
- Collaboration mode, thread goal, model, reasoning effort, sandbox, and token status controls in the chat composer.
- Image upload and multi-image message sending from Android, plus authenticated image rendering, zooming, copying, and saving.
- Authenticated file downloads with image preview, binary file open/save support, and APK installation guidance.
- Markdown and restricted static HTML previews with source/rendered view switching and relative image support.
- Background, cross-session, approval, connection-failure, and task-completion notifications.
- Optional Beijing-time message timestamps with persisted and backup-aware settings.
- Remote project directory browsing and selection when starting a new session.
Changed
- The bridge now prefers the highest available Codex binary version while preserving an explicit
--codex-binoverride. - Session list payloads are smaller, support configurable history windows, and can refresh automatically when the drawer opens.
- Desktop rollout monitoring now reads appended data incrementally, handles incomplete lines and file rotation, and deduplicates realtime events.
- The Android release build can reuse a populated local Maven cache when available.
Fixed
- Kept model, reasoning effort, sandbox selection, and current-session status synchronized across session creation, switching, refresh, and restore.
- Persisted the model and reasoning effort used by successful sends even when backend thread summaries lag behind.
- Restored newline entry in the chat composer.
- Stabilized user-message identifiers so realtime projections reconcile cleanly with authoritative session snapshots.
- Persisted and surfaced Codex backend connection failures with actionable network guidance.
Release Artifacts
- Android debug APK:
android/app/build/outputs/apk/debug/codex-remote-control-v0.2.0-debug.apk - Android release APK:
android/app/build/outputs/apk/release/codex-remote-control-v0.2.0-release.apk
Notes
- Existing installations must continue using the same
android/release.keystoreandandroid/release-signing.propertiesto upgrade in place. - Android 13 and newer require notification permission before background notifications can be shown.
- Background delivery remains best effort with the current activity-owned WebSocket lifecycle; see
docs/android-background-connection.md.
校验 / Verification
- Release APK SHA-256:
215d669904b8fda2b80fb4022ce589d8683cd246fea6eede035a2c905e24d3d5 - Git commit:
538d65f67e34907789237fc71f56e8ca95d9f3cb