zcode connect 使用支持

支持邮箱：3141791843@qq.com。应用免费下载；电脑端模型或其他服务的费用依其提供方规则处理。

没有服务器：使用 ZCode 自带连接服务

1. 在自己的电脑上安装兼容的 ZCode 桌面端，登录并打开工作区。

2. 在桌面端左侧找到手机连接入口，显示连接二维码。

3. 打开手机 App，选择“扫描连接二维码”；无法扫码时展开粘贴链接入口。

4. 核对电脑和服务，确认连接，再选择工作区。

5. 保持电脑开机、联网且桌面端运行。手机不需要自己部署中转服务器，但仍然需要这台执行任务的电脑。

只有配对时才需要看到电脑上的二维码。不要把完整二维码或链接发到公开群聊。

已有常驻服务器：自建连接

进入 App 的“我有自己的服务器”指南，导出完整开发资料包。把 START_HERE.md 和 SELF_HOSTED_DEPLOYMENT.md 交给自己的 AI agent，先核对环境、桌面版本和域名，再部署并按 ACCEPTANCE.md 验证。资料包含中转服务、部署示例、桌面启动器、配对协议和恢复步骤。常驻中转服务器不能自动代替运行 ZCode 任务的电脑。

常见问题

电脑没有二维码： 核对桌面端是否提供手机连接功能、是否已打开工作区。官方安装包与开源自编译版本的能力可能不同。既有兼容证据覆盖官方 3.12.3 / 3.14.0；不能据此保证全部新版本。

链接无效： 重新从电脑端生成并复制完整链接，不要删改参数。普通连接入口不会把无效链接转换为手填 Token 表单。

显示另一台手机正在控制： 同一电脑可能只允许一个控制端。确认要切换后再连接；电脑上的任务不会因切换而删除。

离开家后无法连接： 核对电脑没有休眠、桌面端仍在运行；自建服务器还需核对域名、TLS、转发和防火墙。不要关闭证书验证来排障。

后台没有完成提醒： 当前是客户端收到事件后产生的本地通知，不保证长时间后台或退出 App 后收到。重新打开 App 可同步状态。

如何删除本地连接： 设置 → 连接 → 对应电脑 → 移除连接。草稿与电脑端内容的区别见隐私政策。

提交问题前

记录 App 版本、iOS 版本、电脑端版本、连接方式、发生时间、可复现步骤及已遮盖敏感信息的截图。不要提供配对密钥、完整连接 URL、模型 API Key 或私人对话。请发送邮件至 3141791843@qq.com。

官方桌面连接说明：https://zcode.z.ai/cn/docs/remote-control