常见问题

Woodox 的运行方式和限制

本页回答安装、连接、设备管理、版本和公网中转服务相关问题。操作步骤见对应使用文档。

Woodox 是远程桌面吗?

不是。Woodox 不传输整个 Windows 桌面,也不是普通 SSH 客户端。它用于查看和操作代码 Agent 会话、历史、终端与确认请求。

手机端可以单独使用吗?

不可以。先在 Windows 电脑安装并运行 Woodox,再安装 Android App。手机本身不运行 Codex、Kimi Code 或 Qwen Code。

为什么必须保持电脑在线?

Agent 进程、项目文件、命令执行和登录状态都在电脑。电脑关机、休眠、断网或后台服务停止时,公网中转服务无法代替电脑继续任务。

Agent 和项目实际运行在哪里?

Agent CLI 通常运行在 Windows 的 WSL2 / Ubuntu 环境中,项目位于用户选择的 Windows 目录或 Ubuntu 文件系统。手机只显示和发送交互。

公网中转服务起什么作用?

它为手机提供 HTTPS 入口,并把请求转入电脑主动建立的反向 SSH 隧道。中转服务不运行代码 Agent,也不提供云端开发环境。

中转服务会保存项目文件吗?

当前架构不会把完整项目目录作为公网中转服务的业务数据上传保存。但请求内容会经过中转反向代理,服务端在技术上可以接触转发内容,并可能记录访问与故障元数据。

如何批准新设备?

手机首次发起连接后会显示等待电脑确认。回到 Windows 客户端的“设备管理”,核对设备名称和标识,再点击“允许”;不认识的设备应拒绝。

手机丢失后如何撤销设备?

在电脑端“设备管理”撤销对应手机。撤销后该设备不能继续访问;还可以永久删除已撤销记录,或在怀疑完整连接信息泄露时轮换全部连接凭据。

为什么 Windows 和 Android 版本号不一致?

两个平台独立发布。Android 可以更频繁地单独更新;Windows 安装器会记录它构建时实际内嵌的 APK 版本,因此无需强行对齐编号。

Windows 为什么提示未知发布者?

当前 Windows 安装器尚未配置 Authenticode 商业代码签名。只从官网下载,并核对文件名、大小和 SHA256;来源或校验值不一致时不要绕过 SmartScreen。

Codex、Kimi Code 和 Qwen Code 的支持能力完全一样吗?

不一样。Codex 可读取 app-server 的结构化 Thread 历史和工具信息;Kimi Code 与 Qwen Code 主要使用电脑端保存的终端时间线。三者均可查看输出、发送输入和切换终端。

电脑断网或休眠后会发生什么?

手机连接会中断。电脑恢复联网并重新建立隧道后,客户端会重连、读取历史并用当前状态校正遗漏;电脑休眠期间 Agent 是否继续执行取决于电脑是否实际暂停。

是否支持自建公网中转服务?

支持。项目包含账户中心、受限 SSH 租户、Nginx/Caddy 与反向 Unix Socket 的部署流程。自建者需要负责域名、TLS、服务器更新、日志、备份和访问权限。

当前是否免费?

安装文件可直接下载;正式收费方案尚未公布;共享公网中转服务的免费范围与后续收费尚未公布;设备数量、流量和使用时长的正式限制尚未公布。Codex、Kimi Code 和 Qwen Code 的会员、API 与模型费用不包含在 Woodox 中。