文档 · 01

快速开始。

打开工作台,打开一个项目,运行你的第一次仿真。十分钟,无需安装任何东西。

CommandAGI 是什么

CommandAGI 是一个工作台,人与智能体在这里规划、仿真并运行真实的机器。它的一切都建立在四个概念之上:

  • 设备。 设备定义把一类机器描述为一组通道——一条 G-code 线路、一条舵机总线、一路视频流、一个 shell。CNC 铣床、激光机、打印机、机械臂、无人机、手机、相机和计算机都是设备。
  • 世界。 世界把设备作为单元放置在一个空间中,并给出位置。世界要么是 physical(连接真实硬件),要么是 simulation(每个通道都在模拟器中运行)。
  • 运行。 设备所做的事被记录为运行中的数据流:每次运行一个文件夹,每个单元的每个通道一条数据流,全部基于同一个时钟。
  • 授权。 智能体或人只有在某个账户给予的长期授权范围内,才能操作物理硬件。

这一切都是你所选文件夹中的普通文件。

打开工作台

访问 commandagi.com。工作台会立即打开——你不需要账户。

  • 以访客身份,你的项目保存在当前浏览器自己的存储中。你可以随时把一个文件夹导入进来,或把它导出为 zip。
  • 登录后,你的项目可以存放在云端,在不同设备之间跟随你。在左侧停靠栏底部注册或登录。
  • 在桌面应用中,同一个工作台内置了本机的主机,因此可以打开磁盘上的任意文件夹,并连接 USB 和局域网上的机器。参见下载。

打开一个项目

你打开的文件夹就是项目。使用左侧停靠栏顶部的项目菜单:

  • 打开文件夹…——你电脑上的一个文件夹(在支持 File System Access API 的浏览器中,或在桌面应用中);
  • 此浏览器中的项目——访客项目;
  • 将文件夹导入此浏览器… 和 导出此浏览器中的项目(.zip)。

新建标签页(+,或 Mod+T)会列出推荐文件、最近文件,以及你可以打开的存储位置:云端、本地文件夹、本地文件、当前浏览器,以及你已配对的任何主机。

工作台附带一些只读的示例项目供你探索:LED 指示板(eda)、一个机械项目、一个生物工作单元、一个仿真库,以及一个仪表盘模板库。

熟悉界面

窗口中央是分成若干窗格的标签页,四周有三个区域:左侧(导航和资源管理器)、右侧(所选内容的详情)和底部(运行、事件、终端和日志)。你最近使用的窗格获得焦点,并决定各区域显示什么。

  • Mod+Shift+P 打开命令面板。所有操作都在这里。
  • Mod+P 按名称打开文件。
  • Mod+Enter 最大化当前焦点窗格。

创建一个世界

在命令面板中运行 新建世界(模拟)…。仿真世界把每个通道绑定到模拟器,因此其中的任何东西都无法触及硬件。

单元列在世界的 world.json 中。在 3D 视图或列表中选择一个单元,然后在右侧的详情标签页中编辑它的位置、旋转和设备。要添加单元,请把它们加入 world.json——参见文件格式。

运行一次仿真

  1. 打开世界,在设备视图中对某个单元的通道选择仿真。
  2. 连接后会在该世界中开启一次会话运行(或加入已经打开的那一次)。每条命令和状态在发生时都会写入运行记录。
  3. 指定了仿真文件的世界还提供力拖拽:抓住一个物体推动它。这个力会连同你的名字一起被记录。
  4. 完成后使用关闭运行。

仿真世界会在屏幕上明确说明:通道只在模拟器中运行;这里的任何东西都不会触及硬件,仿真结果永远不能算作物理证据。 在只读示例中不会记录运行——打开你自己的文件夹才能保留它们。

回放与分叉

每次运行都可以在窗口底部的时间轴上回放,速度从 0.25× 到 8×,也可以实时跟随。

  • Mod+Alt+P 播放或暂停 · Mod+Alt+L 跳到实时 · Mod+Alt+, 和 Mod+Alt+. 前后步进五秒。
  • 底部区域的运行记录标签页列出一个世界的所有运行。
  • 分叉从播放头处开始一次新的仿真运行——同一时刻,不同的未来。

下一步

准备好接入真实硬件时,请阅读连接一台机器。要让智能体来驱动它,请阅读智能体与长期授权。