企业官网建设流程全解析

IM.codes（The IM for agents，AI 编码代理的即时通讯与控制层）的**被控节点（Controlled Nodes）**功能，允许你将多台电脑注册为受限节点，由一个 AI agent 直接操作它们执行命令、传输文件和操控桌面应用；具备条件的 Windows 节点还能在浏览器里直接打开远程桌面，供人类查看或接管屏幕。本文详解这套"一个 AI 操作多台电脑"的机制、注册流程与安全边界。

为什么需要被控节点 🖥️

AI 编码 agent（Claude Code、Codex、Gemini CLI、OpenClaw、Qwen 等）通常只活在"一台机器"的终端里。真实工作却往往横跨多台设备：这台跑构建、那台跑服务、另一台存数据。

被控节点解决的正是这个问题：

• 一台 AI，多台电脑—— 注册多台机器后，让一个 agent（或一组 agent）在同一段对话里直接操作它们完成任务
• 真实的计算机操作—— 执行有作用域的命令、传输单个文件、通过类型化的 Computer Use 工具控制桌面应用
• 人类需要时接管—— 从浏览器或手机打开远程桌面，查看画面或直接接管
• 作用域受控、可随时撤销—— 每台节点独立凭证，执行能力由所有者开启，随时可收回

如何把电脑注册为被控节点

注册流程刻意做得很轻：目标机器不需要成为完整的 IM.codes 源服务器，只需下载安装包并注册即可。

1. 在 IM.codes 服务端为受支持的操作系统下载被控节点安装包（下载链接会过期，但已下载的安装包可以保留，重复用于注册多台机器）
2. 在目标机器上运行安装包，完成注册，机器即作为独立的被控节点加入你的看板
3. 注册后，该节点拥有独立凭证，与普通的 server/session 列表相互隔离——它不会混进你日常管理的服务器和会话里

相关能力由服务端下发与校验，核心逻辑见：

• 注册与安装包分发：enroll.ts
• 节点管理与能力协商：machines.ts
• 节点服务与升级策略：controlled-node-service.ts
• 节点安装包产物定义：controlled-node-artifacts.ts

一个 AI 如何操作多台电脑 ⚡

注册完成后，操作方式非常直接：

• 在输入框键入^弹出目标选择器，挑一台被控节点
• 或直接插入^^(name)标记指定某台机器
• 获得授权的 agent 就会在选中的机器上执行任务：运行有作用域的命令、传输单个文件、调用类型化 Computer Use 工具操作桌面应用

也就是说，你可以在同一段对话里让 agent 在 A 机器上跑测试、把结果文件搬到 B 机器、再在 C 机器上继续验证——这正是"操作一支电脑舰队"（operating a fleet of computers）的场景。

命令执行与桌面操控的服务端入口分别是：

• 命令执行：machine-exec.ts
• 桌面应用操控（Computer Use）：machine-computer-use.ts、computer-use.ts

浏览器远程桌面：查看与接管 📱

当人需要"看一眼"或"接过去"时，具备条件的Windows 被控节点会向授权的所有者与参与者提供浏览器远程桌面——打开网页即可，无需专用客户端：

• Control / View 双模式—— 控制模式完整操作桌面，观看模式只看不改
• 多屏与清晰度切换—— 在不同显示器和分辨率之间切换
• 多人协作—— 可邀请多个获授权用户同时查看或控制
• 移动端同样好用—— 手机端提供触控导航和虚拟鼠标，从手机或平板就能完整操控桌面

远程桌面会自动选择最优连接，直连不可用时自动降级回退，权限始终受控、可随时撤销。需要说明的是：远程桌面目前支持 Windows 节点；macOS 与 Linux 被控节点仍可使用命令、文件传输等其余节点能力，远程桌面支持在规划中。

其底层由 Windows 原生组件支撑，包括屏幕采集、H.264 编码、WebRTC 会话与虚拟显示器驱动：

• 远程桌面协议与会话管理：remote-desktop.ts、native/windows-remote-desktop/
• 虚拟显示器驱动（多屏场景）：native/windows-virtual-display/

安全与权限设计 🔐

被控节点的设计始终围绕"最小权限、可撤销"：

小结

被控节点让 IM.codes 从"管理 agent 会话的 IM"进一步变成"管理 agent 背后那台台电脑的控制层"：注册轻、操作强、权限收得回，再加上浏览器远程桌面这个兜底入口，人和 AI 都能以最低成本触达同一支机器舰队。如果你希望在同一个对话里协调多台电脑上的工作，这套机制值得重点体验。

更多细节可参考项目说明：README.zh-CN.md。