先说一个核心前提:想要实现手机与PC之间的顺畅协同,前提是PC端必须先启动并登录Qoder CLI,然后通过/remote-control指令生成二维码,再扫码完成绑定——这样才能做到双向实时同步。否则,二维码根本不会出现,连接自然也就无从谈起。

想象一下这个场景:你白天在办公室用PC启动QoderWake执行代码修复任务,通勤路上掏出手机查看思考链、批准关键节点,回到家后切换到另一台Mac继续调试。其实现实场景比这个复杂得多——需要的可不是简单的扫码,而是PC与手机之间建立一条稳定、低延迟、上下文完整的双向连接通道。
确认桌面端Qoder CLI已就绪并登录
这一步是移动端操作的关键前提。如果CLI没有运行或者未登录,会出现二维码无法生成、扫码后无响应、手机端显示“连接失败”等一系列问题。换句话说,跳过这一步直接打开手机App扫脸,你只会看到一个空白状态页。
具体操作:在电脑终端中进入任意项目目录,执行qodercli命令启动CLI界面。接着输入/login指令,按提示跳转至浏览器完成阿里云账号认证。当看到绿色✅Logged in as [your-email]出现时,就说明登录成功了。
这里有个小技巧:如果终端卡在“Waiting for auth…”超过90秒,不要干等。关闭浏览器授权页,重新执行/login,并确保弹出窗口没有被浏览器拦截。
启用远程控制模式并完成扫码绑定
这是实现PC与手机实时镜像的唯一路径。注意,守护进程模式适用于从手机端发起新任务,而不是延续已有会话。
操作起来分两种方式:
方法一:单次会话绑定。在CLI界面中输入/remote-control指令,屏幕中央会生成一个动态二维码(每60秒刷新一次)。然后打开手机Qoder App,点击首页右上角的+按钮,选择“扫描连接”,对准二维码完成绑定。
方法二:强制重连——适用于不小心断连后的恢复。手机端进入「已连接会话」列表,长按当前会话卡片,选择“重新同步上下文”,桌面端CLI会自动触发新一轮/remote-control指令并刷新二维码,再次扫码即可重建信道。
绑定成功后,手机端顶部状态栏会立刻显示“已连接 · 实时同步中”,同时电脑终端的光标会短暂闪烁一次——这是双向心跳已建立的信号。
在手机端展开思考链与处理待决事项
一旦成功连接,接下来的操作路径就很清晰了:
第一步:点击当前运行中的任务卡片,进入详情页。
第二步:向下滑动至“思考链(Chain of Thought)”模块,点击右侧▶图标展开首层推理步骤。
第三步:在任一推理步骤下点击“调用工具”标签,查看该步骤触发的工具名、输入参数快照以及返回结果摘要。
第四步:如果页面中部弹出半透明确认浮层,注意,必须在15分钟内操作。否则QoderWake会自动降级为安全模式,并暂停后续流程。
点击【批准执行】后,指令会毫秒级同步至本地QoderWake进程;如果点击【中止并反馈】,则需要输入文字说明,该内容会被存储到/memory/approval_rejections目录,供策略回溯时参考。
强制同步最新执行状态
手机端状态栏如果显示黄色或红色,说明存在延迟或连接中断,需要手动干预。
第一招:在移动端的「监控」页右上角点击「刷新」图标,观察顶部状态栏颜色变化。如果仍然是红色,赶紧检查电脑端是否显示Heartbeat: active。
第二招:长按屏幕任意空白处2秒,触发强制重载终端视图。这个操作会丢弃当前缓存,重新拉取完整的会话快照——相当于给连接打了个强心针。
完成上述步骤后,即可在手机端开始正常操作了:关注输入框以接住检索问题、编写回复和提交任务。
