跳到主要内容

接入工作空间与机器

Helix 的所有能力都围绕「工作空间」展开:AI 读取文件、运行命令、修改代码,都需要先知道它应该在哪台机器、哪个目录里工作。

这一篇先完成最关键的准备:把 Helix 连接到本地目录、远程服务器或 VM 工作空间,并确认连接真的可用。

先看总览

工作空间启动台与添加工作空间弹窗总览

左侧是工作空间启动台,右侧是添加工作空间的入口和连接面板。下面按实际操作顺序走一遍。


第 1 步:打开添加入口

在左侧快捷操作区点击 添加工作空间

左侧快捷操作区中的添加工作空间入口

你会进入工作空间启动台,并看到用于创建或连接工作空间的弹窗。


第 2 步:选择工作空间类型

在弹窗中先选择工作空间类型。常见选择有三种:

  • 本地工作空间:项目就在当前电脑上
  • 远程工作空间:项目在 SSH 服务器上
  • VM 工作空间:项目运行在 Helix 管理的虚拟机里
添加工作空间弹窗中的服务器地址和项目目录输入区

如果选择远程接入,先填写服务器地址并完成连接,再继续选择项目目录。


第 3 步:确认机器已经连上

连接成功后,服务器卡片会切换到已连接状态,项目目录也会出现在同一个弹窗里。

工作空间连接成功后的目录选择界面

这里不要只看弹窗有没有打开,要重点确认两件事:

  1. 机器状态已经显示为已连接
  2. 目标项目目录可以被看到或选中

第 4 步:回到列表里核对工作空间

回到工作空间列表后,你应该能看到当前 workspace、连接方式,以及最近使用的项目。

工作空间列表与连接方式视图

如果列表里能正常显示,并且再次进入时可以打开对应项目,说明工作空间已经准备好了。


完成后你应该得到什么

完成这一篇后,你应该拥有一个可用的 Helix 工作空间:

  • Helix 知道要操作哪个项目目录
  • AI 后续可以读取这个目录里的文件
  • 终端会自动进入这个工作空间
  • 后面的模型配置、对话和 Manager 任务都有真实落点

下一步

接下来去看 认识 Helix 界面,先把主界面里的几个关键区域认清楚。