← 回到主页 USER WORKSPACE

连接你的执行环境

通过 Agent 使用设备,集中查看设备与执行记录。

还没有账号?。密钥丢了请联系管理员重新生成。

管理员入口 →

添加设备

直接接入现有整机环境,按启动用户的权限执行命令和访问文件,不提供目录或进程隔离。设备无需运行 Docker 或 VM。

  1. 安装
  2. 配对
  3. 启动
  4. 完成

安装整机接管端(graft-execd)

在执行环境终端运行:

支持 ARMv7、原生 ARM64 和 x86_64。Android 使用已有的 sh;若 PATH 中没有可写目录,可保存脚本后用 sh install-execd.sh /data/local/tmp/graft/bin 指定安装目录。

这个执行环境以前配对过?不用再配对。

用 provider 配对码配对

点击「生成并复制」,然后到执行环境终端粘贴命令(配对码只能用一次,3 分钟内有效):

graft-execd pair --code <配对码>

启动 graft-execd

前台运行:适合先试一下。终端窗口要一直开着,按 Ctrl-C 停止。

graft-execd serve

后台运行:关掉终端或断开 adb 后继续运行,日志写到 graft-execd.log。这条命令会先停掉已在运行的 graft-execd,重复执行也只有一个在跑。

看日志:tail -f graft-execd.log;停止:pkill -x graft-execd。同一执行环境只能运行一个 graft-execd serve。命令默认在启动时所在目录执行。环境重启后需重新启动;配对被撤销后使用新配对码,不要删除 identity.key。

完成

接入端连接成功后,会在「设备」列表显示在线。ADB 接入端代表跳板机上的 ADB 入口;具体设备的连接状态由 Agent 运行 devices 查询。下一步:接入 Agent。

通过 graft-cli 接入 Agent

  1. 准备 CLI
  2. 配对码
  3. 完成

把这段话发给 Agent

复制提示词给 Agent,它会检查所在执行环境的 CLI 和配对状态,按需通过 Skill 脚本下载对应平台的 CLI,再向你索要配对码。支持 Linux/WSL amd64 和 Windows x64。

查看完整提示词

Agent 要配对码时,生成一个发给它

仅在 Agent 确认需要配对时生成新的配对码。已有有效配对可跳过,不重复使用配对码。

点击「生成并复制」,然后粘贴发给 Agent(配对码只能用一次,3 分钟内有效):

完成

Agent 配对成功后,该执行环境会出现在「Agent」列表里。将设备卡片拖到它上面建立绑定,再告诉 Agent 要做什么,例如“查看设备的系统版本”。

Agent 运行 graft-cli 时如果请你批准,可以选择总是允许 graft-cli,以后就不用每次批准。