一、程序介绍
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 对话。
截图能力因平台而异：当前桌面截图后端面向 Windows，Linux 从机尚未提供原生截图实现，不应将截图查看理解为所有设备都具备完整远程桌面能力。
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。
