
一、程序介绍Cloud PC 用于联通自己的多台设备让 LLM 拥有调用其他设备的能力。同时提供远程 LLM 对话界面方便在手机或其他电脑上继续对话、查看回复和任务执行状态。例如LLM 运行在 Linux 主机上开发环境和文件在 Windows 电脑上用户通过安卓手机让LLM完成一个Windows编译任务并在手机上查看任务进度并继续发送指令。主要功能访问从机共享目录上传和下载文件。向从机提交命令获取执行结果。转发消息到设备上的其他本地服务。查看设备、截图和主机操作记录。远程使用 Codex、DSH、OpenCode选择已有会话或创建新会话查看任务状态。LLM 需要由用户提前在主机上安装、登录和配置。程序不包含模型本身也不会自动为任意 LLM 添加设备操作能力跨设备操作需要让 LLM 的工具或执行环境调用程序提供的接口。源码地址qingfeng666666/cloud_pc下载地址GitHub Releases二、怎么安装程序分为主机程序从机程序管理界面。不要求所有程序安装在一台设备上主机只有一个从机可有多个管理界面不能单独安装必须在安装了主机或从机的设备上。所有设备需要处于可互相访问的局域网或通过 WireGuard 等方式接入虚拟局域网。Windows下载CloudPC-Windows-1.0.0.zip解压到可写目录按需双击运行文件用途CloudHost.exe主机程序CloudSlave.exe从机程序CloudManagement.exe管理界面发布版无需另外安装 Python。EXE 当前未做 Authenticode 签名系统可能提示未知发布者请从项目发布页面下载并核对校验值。Linux下载cloud-pc-linux-1.0.0.zip并解压按 README 安装对应模块的 Python 和系统依赖然后按需运行bash启动主机.shbash启动从机.shbash启动管理界面.sh每个需要持续运行的程序请在独立终端启动。Linux 发布包是 Python 运行源码加启动脚本管理界面需要 GTK3/PyGObject 等系统组件。如果直接使用源码将仓库目录命名为cloud_pc在其父目录按需执行python3-mcloud_pc.host_program.main--headlesspython3-mcloud_pc.shared_components.slave.main python3-mcloud_pc.management_ui.mainAndroid下载并安装cloud-android-slave-1.0.0.apk安卓从机。cloud-management-1.0.0.apk安卓管理界面。打开安卓从机需要 VPN 时填写自己的 WireGuard 配置并点击“启动 WireGuard”按系统提示授权然后点击“启动从机”。不需要 VPN 时直接启动从机即可二者独立启停。安卓目前不提供主机程序。已安装测试版时请先备份配置再卸载测试版并安装正式版。三、怎么使用1. 启动并配置从机在需要接入的设备上启动从机记录其局域网或 VPN IP默认通信端口为9527。Windows/Linux 从机通过slave.json设置共享目录slave.json会在首次运行后在运行目录生成或者你实现手动写一份。例如{root:F:\\project,port:9527,name:Windows电脑,log_level:INFO}JSON 中 Windows 路径的反斜杠需要写成\\。只共享实际需要的目录避免直接开放整个磁盘。安卓的可访问范围还受系统授权和应用沙箱限制。2. 让主机连接设备首次启动主机后会自动生成host.json。在已有文件的slaves列表中填写从机地址例如slaves:[192.168.1.20:9527,192.168.1.30:9527]将示例 IP 替换为实际地址保留其他配置字段。手工修改后重启主机使设置生效。也可以在管理界面的从机设置中增加或移除设备并同步到主机配置。3. 打开管理界面如果管理界面安装在主机电脑上选择主机角色通过本机服务使用。如果安装在从机设备上先确保该设备的从机已启动再在管理界面选择从机角色设置主机 IP 并连接。手机上需要同时运行安卓从机和管理界面主机也需要能够访问手机的从机地址。连接后从机列表由主机提供可以选择设备界面、查看主机操作记录或进入 LLM 对话。截图能力因平台而异当前桌面截图后端面向 WindowsLinux 从机尚未提供原生截图实现不应将截图查看理解为所有设备都具备完整远程桌面能力。4. 使用远程 LLM 对话先在主机上安装、登录并配置 Codex、DSH 或 OpenCode再在管理界面操作进入“LLM 对话”。选择 Codex、DSH 或 OpenCode。选择已有会话继续或新建会话。在输入框填写内容并发送。查看回复、工作计时和任务执行状态需要时停止任务。执行过程中也可以追加输入具体处理方式按后端能力实现。界面可显示哪些状态取决于后端 API 提供的事件不保证三个后端表现完全相同。远程对话调用的是 LLM 接口不依赖电脑上的终端窗口一直处于前台。5. 保存与修改设置配置文件用途host.json主机连接目标、管理连接和日志等设置slave.json从机名称、端口、共享目录等设置management.json管理界面角色、主机地址和最近对话等设置首次启动自动生成之后读取已有设置。Windows 发布版配置在对应 EXE 同目录Linux 发布版在启动脚本同目录源码运行默认在仓库根目录安卓保存在各应用自己的文件目录。手工修改后重启对应程序。6. 使用注意只接入可信设备跨网络访问建议使用 WireGuard 等 VPN不要直接将操作端口暴露到公网。程序不提供公共 VPN 服务器WireGuard 配置由用户自行准备。私人配置、VPN 私钥、令牌和运行日志不要公开上传。任务请求超时不代表远端命令已停止不要直接重复提交有副作用的命令。遇到问题时先确认程序已启动、IP 正确、网络可达再查看 README 中的日志说明。当前正式版本为1.0.0。项目自身代码采用MIT许可证WireGuard 等第三方组件保留原有许可证发布页面提供相关材料。完整操作与开发者接口说明项目 README。