文档目录

系统

跨端

计算与环境分开;远端工作区;在另一台电脑上执行 PowerShell 或 Bash。

计算与环境

一个会话有两个「在哪」,建会话时定下,之后不变:

名字 是什么
计算 会话的 Harness 在哪台 Client 上启动
环境 会话干活的地方:一台 Client 和它上面的一个目录
会话 计算 环境
工作流步骤的作者、评审者 角色绑定的 Client 运行的 Repo 所在的 Client,目录是 Repo 的主检出
你直接开的会话 你选的那台 Client 上的 Harness 你选的 Client 与文件夹

两者在同一台时是本机会话,不在同一台时是远端工作区。对引擎、界面和 Router 来说,两种会话是同一个 Worker。

所以没装 Harness 的电脑也能放要干活的仓库。别人的电脑上只装了一个 Harness 时,把一个角色绑到那台上,Desk 就能异步地驱动它干活。

远端工作区

计算那台上放一份环境目录的镜像。Agent 用 Harness 自带的工具读、搜、改镜像里的文件;命令(测试、构建、Git)经 ail shell 在环境那台执行,执行前后自动同步两边的文件。

选镜像而不是「每个文件都经网络读写」,是因为读、搜、改都在本机:延迟再大,也只有几次命令过网络。

非交互执行

ail shell 在某个 Client 上跑一条 PowerShell 或 Bash 命令。发起方把请求交给 Desk,Desk 鉴权后转给目标 Client 的 Daemon 执行,结果原路返回。

ail shell --target home-server --shell bash "uname -a"

含引号、$、换行的命令经标准输入传,逐字节送达:

ail shell --target home-server --shell bash --stdin <<'EOF'
df -h / | tail -1
EOF

请求的字段:

字段 含义
target 目标 Client 的 id。不写时是发起会话的环境所在的 Client
shell powershell 或 bash
command 命令文本,原样交给 shell
cwd 可选,目标机上的工作目录
timeout_s 可选,默认 30,上限 600

结果的字段:

字段 含义
ok 请求是否被执行了。命令自己失败(非 0 退出码)时仍是 true
exit_code 退出码,超时是 124
stdout、stderr UTF-8 文本,各自最多 64KB
duration_ms、timed_out、truncated 耗时、是否超时、是否截断过

执行的规则:

命令行最多等 8 秒。命令没结束时返回 pending,命令在目标机上照常跑完,结果用 ail op 取。

谁可以对哪台 Client 用哪种 shell,由 Desk 上的授权规则决定,默认拒绝。

交互式控制台

你在创建会话页选 Client、文件夹和 PowerShell 或 Bash,得到一个终端页签。Daemon 在本机开伪终端,字节流经 Desk 转给浏览器。只有你能开控制台;Agent 只有非交互执行。