Qoder CLI移动端适配需五步：一启用远程控制模式扫码同步会话；二配置守护进程支持手机主动发起任务；三开启触控增强层优化交互；四强制横屏双栏布局并同步差异预览；五启用离线缓存机制保障弱网操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装Qoder CLI并希望在移动设备上实时跟进、审批或调试代码任务，但发现界面错位、操作延迟或交互异常，则可能是由于移动端未正确适配屏幕尺寸、触摸事件未启用或远程会话未同步所致。以下是解决此问题的步骤：
一、启用移动端远程控制模式
该模式通过二维码建立手机与本地CLI会话的实时映射，确保终端输出、输入光标、确认弹窗等状态在手机端完整还原，适用于已在电脑启动任务后需外出继续操作的场景。
1、在已启动Qoder CLI的项目目录终端中，输入 /remote-control 命令。
2、终端将显示一个动态刷新的二维码，使用Qoder Mobile扫描该码。
3、扫描成功后，手机端立即加载当前CLI会话的完整终端视图，包括滚动缓冲区与光标位置。
4、在手机上点击任意可交互区域（如Approve按钮、选项编号），操作将实时反馈至电脑端CLI进程。
二、配置守护进程模式实现主动发起任务
该模式使Qoder CLI以系统后台服务形式持续监听手机端指令，支持在无电脑前置会话的情况下，直接从手机新建开发任务，所有代码生成结果自动落盘至本地项目目录。
1、在终端中执行 qodercli remote-control CLI 命令，启动常驻守护进程。
2、确认终端输出中出现 Remote control daemon started on port 8080 字样。
3、打开Qoder Mobile，进入「新建任务」页面，选择目标项目路径（需提前通过Qoder IDE或CLI绑定本地文件夹）。
4、输入自然语言需求（例如：“为pages/index/index.vue添加暗色模式切换按钮”），点击提交，任务即刻推送到本地守护进程。
三、优化移动端触摸交互体验
默认终端渲染未针对触控屏优化，易出现误触、长按无响应或虚拟键盘遮挡等问题。需手动启用Qoder Mobile内置的触控增强层，以适配手势操作与焦点管理。
1、在Qoder Mobile设置页中，开启 Touch-Optimized Terminal 开关。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、返回会话页面，双指张开缩放终端字体至16px以上，确保字符清晰可辨。
3、点击输入框时，手机自动调起Qoder定制软键盘，其中 Tab、Ctrl+C、Enter 键均独立可见且响应可靠。
4、执行长命令前，先点击屏幕顶部状态栏中的 Expand Input Area 按钮，展开全屏编辑面板。
四、强制适配平板横屏布局
平板设备在横屏状态下默认采用双栏布局，左侧显示终端流，右侧显示任务上下文与代码差异预览，但需显式触发布局重绘才能生效。
1、将平板旋转至横向模式，等待Qoder Mobile自动检测方向变更。
2、在终端界面左上角点击 Layout 图标，选择 Split View (Terminal + Diff)。
3、点击右侧预览区顶部的 Sync with Current Line 按钮，使差异高亮与终端光标所在行实时对齐。
4、在终端中执行 git diff --cached 后，右侧立即渲染结构化代码变更对比，支持逐块批准。
五、启用离线调试缓存机制
当手机处于弱网或临时断连状态时，Qoder Mobile仍需保障关键调试动作不丢失。该机制将用户操作暂存于本地IndexedDB，并在网络恢复后自动重放至CLI会话。
1、进入Qoder Mobile「设置」→「网络」，开启 Offline Operation Cache。
2、断开Wi-Fi或关闭蜂窝数据，尝试在终端中触发 /review 指令并点击「Approve All」。
3、重新联网后，观察终端日志是否出现 Replayed 1 offline action: APPROVE_ALL 提示。
4、检查本地项目目录下 .qoder/cache/offline_actions/ 是否存在带时间戳的JSON记录文件。
