Przeglądaj źródła

docs(envs): 文档补充并列环境、多机寻址与按需执行说明

Samien 1 miesiąc temu
rodzic
commit
c4d6297e84
2 zmienionych plików z 10 dodań i 2 usunięć
  1. 1 1
      README.md
  2. 9 1
      docs/desktop-hosts.md

+ 1 - 1
README.md

@@ -16,7 +16,7 @@
 
 Bot 模式的“工具”菜单提供“自动化”和“已连接应用”两个独立入口。“已连接应用”统一管理应用连接与 MCP;“自动化”使用独立的日历、任务列表和运行日志页面。所有模式均可从底部菜单打开独立的“关于”对话框。这些页面不属于设置中心。
 
-远程桌面主机:其他 Mac 上的夭夭 App 启动时可选择「登录远程」或「进入本地」;登录远程用服务器地址加账号密码登录(与手机端一致的凭据方式),窗口直接使用远程服务器(15300)的夭夭界面,本机不运行 Web 服务;管理员账号登录同时把这台 Mac 注册为可远程控制的桌面主机,供服务器上的 Bot 操作。详见 [远程桌面主机](docs/desktop-hosts.md)。
+远程桌面主机:其他 Mac 上的夭夭 App 启动时可选择「登录远程」或「进入本地」;登录远程用服务器地址加账号密码登录(与手机端一致的凭据方式),窗口直接使用远程服务器(15300)的夭夭界面,本机不运行 Web 服务;管理员账号登录同时把这台 Mac 注册为可远程控制的桌面主机,供服务器上的 Bot 操作。每个机器人可并列启用 本地虚拟机 / 云端 / 多台 Mac 的本机控制,工具按在线情况同时可用。详见 [远程桌面主机](docs/desktop-hosts.md)。
 
 ## 运行
 

+ 9 - 1
docs/desktop-hosts.md

@@ -1,6 +1,14 @@
 # 远程桌面主机
 
-一台服务器集中运行 Web(15300)与 Hermes(9119),其他 Mac 安装夭夭 App 后作为“桌面主机”出站连接服务器,向服务器上的 Bot 提供自己的真实桌面(截图、键鼠、独立浏览器)。服务器自己机器上的 App 继续走本机回环通道,等同一台编号为 `local` 的主机。
+一台服务器集中运行 Web(15300)与 Hermes(9119),其他 Mac 安装夭夭 App 后作为”桌面主机”出站连接服务器,向服务器上的 Bot 提供自己的真实桌面(截图、键鼠、独立浏览器)。服务器自己机器上的 App 继续走本机回环通道,等同一台编号为 `local` 的主机。
+
+## 并列环境(envs)
+
+每个机器人拥有一组并列的环境开关(`agent.envs`):**本地虚拟机**、**云端 Grok Bot**、**本机控制**(所有已连接并授权的 Mac)、**仅浏览器**;全部取消即不启用任何环境。勾选的环境同时生效:工具目录是各环境工具的并集,bot 可在同一次任务里查看 A 机屏幕、读 B 机文件、在虚拟机里跑命令。旧机器人的单一 `computer` 选择按”auto→全开、显式选择保留”推导,首次在面板勾选后即迁移为 envs;`/api/app/agents` 仍下发投影后的单值字段,手机端不受影响。
+
+- **多机寻址**:`desktop_*` 工具(查看/操作/文件/命令/浏览器)接受可选 `host` 参数(电脑名称或编号);未指定时用绑定主机或唯一在线主机。每轮系统规则会列出当前在线的电脑名称。
+- **按需执行(Runner 视情况)**:只有勾选”本地虚拟机”且执行节点在线就绪时,会话才走 Runner/VM;节点离线或缺能力时该轮自动改用本机会话(桌面与云端工具照常),绑定与消息执行标记跟随实际执行方式。
+- **分后端接管**:`/api/app/agents/:id/computer` 系列接受可选 `backend=desktop|cloud|vm` 查询参数,三段路由按参数透传;缺省保持 desktop→cloud→vm 顺序(手机端契约不变)。Web 面板的云端/虚拟机按钮直达对应查看器。
 
 ## 启用流程