如何用 mobile-flow 把手机作为电脑编程 Agent 的安全遥控器？

MobileFlow 是一套开源的手机远程 AI 编程客户端，可以从 Android 手机控制电脑上的 Claude Code、OpenAI Codex、Aider、Gemini CLI、GitHub Copilot、Kiro CLI 和其他终端工具。电脑端 Agent 管理 AI CLI、文件系统、PTY 终端、Git 与开发服务器，手机端是 Flutter 控制界面；代码和真正执行仍留在电脑。

快速部署分三步：从官方发布页安装对应平台的 MobileFlow Agent，在 Android 手机安装 APK，然后输入电脑地址、端口 9600 和配对密码。安装目标 AI CLI 后，即可从手机发起对话、浏览文件、运行命令、查看 diff、管理 Git 和预览本地 Web 应用。

“安全遥控器”不能只理解为传输加密。MobileFlow 提供局域网直连、远程中继和自建 WSS 隧道三种连接方式，各自的数据路径不同；手机还能运行完整终端命令、提交和推送 Git，因此必须结合独立开发账户、受限仓库、最小凭据和明确审批范围。

MobileFlow 的组成

电脑端是 Python Agent，负责启动和连接 AI 编程工具，提供文件、终端、Git 和开发服务器能力。手机端是 Flutter App，呈现聊天、代码编辑、文件浏览、终端、提交历史和预览页面。两端通过加密 WebSocket 通信。

AI 工具通过 ACP，也就是 Agent Client Protocol 接入。对支持的 Claude Code、Codex、Aider、Gemini CLI、GitHub Copilot 和 Kiro CLI，手机可以使用统一界面发送任务和查看会话。普通本地 CLI 也能通过 PTY 终端控制，但不一定具有同样的结构化事件。

项目并不是手机 IDE。源代码没有复制到一个独立移动开发环境，手机只是访问电脑上的能力。电脑关机、Agent 退出或网络不可达时，手机无法继续执行。

支持哪些 AI 编程工具

Claude Code 已列为支持，可以从手机对话、发送编程任务、查看代码变化和批准文件修改。使用前要在电脑端安装并登录 Claude Code，让 MobileFlow Agent 的运行账户能够找到其命令。

OpenAI Codex CLI 同样受支持。手机可以提交提示、查看生成进度和管理会话。Codex 的认证、沙盒和本机权限仍由电脑端配置决定，MobileFlow 不替代这些安全边界。

Aider 支持结对编程会话，可以添加文件到上下文、发送指令并审查生成提交。Gemini CLI、GitHub Copilot 和 Kiro CLI 也位于已支持列表。Cline 仍属于计划能力，不能因为同属 AI 编程工具就假定已经可用。

任何终端工具都可通过完整 PTY 运行，用户能查看输出并发送 Ctrl+C。通用终端兼容性很强，但也意味着手机拥有接近 Shell 的能力，风险高于只提供只读任务卡片的应用。

安装前怎样准备电脑

先为远程编程准备具体 Git 仓库，不要直接开放用户主目录。检查仓库状态，提交或妥善保留现有修改。首次测试使用无敏感数据的临时项目，避免误触真实业务代码。

以普通开发账户运行 MobileFlow Agent，不使用管理员或 root。生产云密钥、个人文档和其他项目不应对该账户可读。Agent 能运行任意终端命令时，操作系统权限是最后一道边界。

检查目标 AI CLI 是否已安装并认证。可以在电脑普通终端运行版本或帮助命令，确保 PATH 正确。后台 Agent 使用的环境可能不同，必要时明确配置可执行路径。

电脑端 Agent 怎样安装

官方发布页提供 Windows、macOS 和 Linux 文件。Windows 使用对应可执行文件，macOS 与 Linux 选择各自 Agent 包。下载后核对仓库发布、文件名和版本，不使用第三方转存。

也可以从源码运行，要求 Python 3.10 或更高版本。进入 agent 目录安装为可编辑包，再启动模块：

cd agent
pip install -e .
python -m mobileflow_agent

从源码运行适合开发和审查，不等于更安全。仍要检查依赖、锁定版本并使用虚拟环境。生产工作站不要在全局 Python 环境随意安装。

启动后系统托盘会显示电脑地址和配对密码。默认服务端口为 9600。不要把截图发送到公开渠道，密码只应在自己手机配对时使用。

Android App 怎样安装

从同一官方发布页下载 APK。Android 提示允许未知来源安装时，只为可信下载入口临时授权，完成后关闭。核对应用版本和包来源，避免安装名称相似的第三方客户端。

手机应启用锁屏、生物识别、系统更新和远程擦除。MobileFlow 能操作文件、终端与 Git，一部已连接手机不仅能看聊天，还可能修改和推送代码。

局域网首次配对

让手机与电脑连接同一可信网络。在 App 中输入电脑显示的 IP、端口 9600 和配对密码。首次连接应验证显示的项目与电脑一致，不要在公共无线网络完成初始配对。

项目说明称密码只在配对阶段使用一次，成功后改用会话令牌。连续三次失败会锁定 60 秒，用于降低简单暴力猜测。锁定并不能替代高强度密码和网络隔离。

首次测试只连接临时仓库，让手机执行只读目录查看，再修改一个测试文件。检查电脑上的真实结果与手机显示是否一致，确认无意外目录暴露。

三种连接模式怎样选择

局域网模式适合同一 Wi-Fi，延迟最低。文档标注使用 AES-256 配对加密，消息即使在局域网也会加密。直连时不需要第三方服务器，但仍应使用可信网络和系统防火墙。

远程中继适合手机与电脑不在同一网络，使用 NaCl SecretBox 提供端到端加密，典型延迟高于局域网。此模式存在中继基础设施，不能把直连模式的“零第三方服务器”描述套用过来；应区分内容加密和连接元数据。

自建隧道使用 WSS 与 Bearer Token 认证，适合需要掌握入口和网络路径的团队。自建者需要维护证书、令牌、限流、日志脱敏和升级。TLS 只保护传输链路，不能限制已认证用户能运行的本机命令。

端到端加密声明怎样理解

README 描述了 AES-256 与 NaCl SecretBox，并称每条消息加密、代码留在电脑。局域网和中继模式使用的表达不同，部署者应以当前版本代码和远程连接指南为准。

算法名称不能单独证明完整安全性。还要检查密钥生成、设备认证、重放保护、令牌撤销和更新机制。项目页面没有替代独立安全审计，敏感组织应自行评估。

加密不等于沙盒。手机发送的终端命令在电脑上执行，可能读取当前账户可访问的资源。系统账户隔离、容器和最小凭据仍是必要措施。

如何配置目标 AI CLI

在电脑端安装需要的工具。例如使用 npm 安装 Claude Code、Codex 或 Gemini CLI，Aider 可以用 Python 包管理器安装。安装后分别完成登录，并在目标仓库直接运行一次。

不要一次安装所有工具。只启用日常使用的 provider，减少依赖和凭据数量。每个 CLI 的授权模型不同，MobileFlow 统一界面不代表权限完全一致。

怎样从手机与 Agent 对话

选择目标项目和 Agent 后发送任务。提示应包含目标、修改范围、禁止操作、验证命令和停止条件。移动端不适合多轮澄清，首次描述越清楚，越不容易出现越界修改。

查看实时输出时关注实际工具动作。Agent 反复读取相同文件、重复测试或开始修改无关目录时，用 Ctrl+C 中断并要求总结。不要让无进展循环持续消耗资源。

斜杠命令可以从聊天菜单调用，例如 review 或 compact，但是否支持取决于具体 CLI。执行前确认命令含义和当前会话，不要把一个工具的命令习惯照搬到另一个工具。

文件浏览和编辑怎样使用

App 支持文件浏览、搜索和多种语言语法高亮，也能直接编辑。手机编辑适合修正小段文本、配置和注释，不适合大型重构。保存前确认文件路径与项目。

不要将 Agent 根目录设为包含多个仓库的上级目录。文件能力可能让手机访问整个范围。敏感环境应通过操作系统权限和专用账户限制实际可见文件。

外部附件和仓库文档可能包含诱导 Agent 执行危险动作的文本。把它们视为数据，涉及上传、删除或权限改变时需要人工确认。

完整 PTY 终端有什么风险

PTY 支持运行构建、安装依赖、查看日志和中断进程，体验接近电脑终端。它也意味着连接者可能执行任意 Shell 命令。不要仅依赖 App 层提示控制风险。

为远程账户设置最小权限，不授予无密码提权。生产发布、数据库管理和云控制命令使用独立凭据，平时不加载。高风险操作回到电脑复核。

手机输入法可能替换引号、空格和符号，复杂命令容易出错。优先运行仓库内经过审查的短脚本，不在小屏拼接删除或重定向命令。

Git 管理怎样使用

MobileFlow 支持查看 diff、暂存、提交、推送、拉取、切换分支和浏览历史，也支持多仓库。开始前检查当前分支和用户已有修改，不要把 Agent 与用户改动混入同一提交。

手机可以处理小范围暂存和提交，但推送、强制操作、变基与冲突处理应回电脑。提交前运行测试并逐文件检查差异。应用显示成功不代表远端分支符合团队规则。

并行 Agent 使用独立工作树。多个会话同时切换同一分支可能覆盖索引和工作区。多仓库列表要使用清晰名称，防止误选。

如何预览本地 Web 应用

MobileFlow 能在手机直接预览电脑运行的本地 Web 应用，用于测试响应式布局，不必先部署。先通过运行配置启动开发服务器，再在 App 打开预览。

开发服务器只应受控接口，不要为预览改成对公网开放。应用如果依赖其他本地 API，需要同时处理路由与认证，不能关闭所有跨域限制。

预览适合界面检查，不适合使用真实生产数据。截图或日志可能包含用户信息，测试环境应脱敏。

运行配置怎样管理

可以保存开发服务器的启动、停止和坚控配置。命令应固定工作目录、端口和环境，避免接受未经校验的任意参数。不同项目使用不同端口，防止相互占用。

停止 Agent 不一定自动结束已经启动的服务器。任务结束后查看运行配置和系统进程，关闭不需要的服务。长时间暴露调试端口会增加攻击面。

断线与会话恢复

README 声明断线重连不会丢失 AI 对话上下文。测试时可以启动无害任务，切换手机网络并重新连接，确认历史和当前状态连续。不要在断线期间重复启动同一任务。

会话恢复不等于电脑重启恢复。电脑 Agent 或底层 CLI 崩溃时，仍要查看日志和 Git 状态。重要任务使用版本控制和可重跑测试保存进度。

如何降低端口 9600 的暴露风险

局域网模式下只允许可信网段访问端口 9600，公共网络配置为阻止。不要在路由器上直接映射该端口到公网。远程使用中继或受控隧道。

更改默认端口可以减少误冲突，但不是安全措施。真正保护来自加密、认证、防火墙和账号权限。发现连续失败锁定时检查来源，不要只延长锁定时间。

手机端零数据存储应怎样验证

README 将手机 App 描述为纯 UI 层和零数据存储。实际使用仍可能需要保存连接配置、会话令牌或系统缓存，因此敏感部署应结合代码、系统存储和卸载行为验证，不要只按宣传语推断。

手机截图、剪贴板、键盘和系统备份也可能留下内容。关闭敏感通知预览，不把密钥复制到剪贴板，设备转赠前清除应用数据和连接。

常见故障排查

手机无法连接电脑

确认 Agent 正在运行、IP 与端口 9600 正确、两端网络互通和防火墙允许。配对密码连续输错后等待锁定结束，不要持续重试。

连接成功但找不到 AI 工具

在电脑终端运行目标 CLI，检查安装与认证，再检查 Python Agent 的 PATH。后台进程可能没有加载 Shell 配置。

终端能用但结构化聊天异常

通用 PTY 与 ACP 集成是不同路径。确认目标工具在支持列表中、版本兼容，并查看 Agent 日志。不要因为终端能启动就假定所有 ACP 功能正常。

本地预览打不开

检查开发服务器是否运行、地址和端口是否正确。确认 App 的预览通道能访问该服务。不要临时关闭认证或公开端口。

Git 推送了错误内容

立即停止后续任务，检查分支和提交，按团队流程恢复。不要在手机进行破坏性历史重写。轮换意外提交的密钥。

怎样撤销和清理

手机遗失或怀疑泄露时，先停止电脑端 MobileFlow Agent，阻断会话。撤销令牌或重新配对，检查近期终端、Git 和文件操作。只卸载 App 不足以证明旧令牌失效。

不再使用时关闭后台服务和端口规则，删除移动连接配置，并确认没有遗留开发服务器。卸载前保存非敏感日志用于审计，但不要备份配对密码与令牌。

推荐的实际流程

首次部署在可信局域网和测试仓库完成，验证密码锁定、会话令牌、文件范围、PTY、Git、预览和断线恢复。外出访问前再选择中继或自建隧道，不直接开放本机端口。

日常任务在电脑建立干净分支和明确范围，手机负责观察、短指令和必要中断。复杂 diff、提交推送和生产操作回电脑。通过传输加密、本机隔离、最小凭据和版本控制共同构建安全边界。

MobileFlow 的优势是把 Agent、文件、终端、Git 和本地预览集中到手机，但功能越完整，移动凭据的权限也越高。明确三种网络模式的数据路径，并限制电脑执行账户，才能让手机成为安全遥控器，而不是无边界的远程 Shell。