首页界面

项目列表页面

打开 OOMOL Studio 后，首先看到的就是项目列表页面。

你可以在这里查看本地的所有项目，也可以创建、导入和删除项目。

左侧是首页导航栏，点击不同选项可以切换到不同页面。下面会依次介绍这些页面的作用。

左下角显示的是当前账户的 OOMOL 积分 信息，你可以看到积分使用情况、剩余数量，以及进入积分管理页面。

信息

OOMOL 积分主要用于代码补全、AI Agent、AI API 等能力的调用。

由于使用的 AI 来自于不同渠道，所以我们使用通用的积分来计量。

关于积分价格可以参考价格页面。

当鼠标移动到右上角个人头像时，会弹出一个菜单，可以在这里管理你的账户信息和 APP 设置。

右侧的导入按钮用于导入项目。你可以选择本地项目文件夹，也可以选择本地 .oomol 文件进行导入。

信息

.oomol 文件是 OOMOL Studio 的项目文件格式，包含了项目的所有信息和数据（不包括密钥）。你可以在项目界面对其进行导出。

社区页面

你可以在这里浏览社区分享的项目和 Flow，也可以直接搜索。

你也可以使用任意浏览器打开: https://hub.oomol.com/

关于更多的社区介绍可以参考社区。

密钥页面

在这个页面中，你可以统一管理所有密钥，包括创建、删除、更新，以及查看详细信息。

我们预设了一些常用的密钥类型，方便你快速创建相关密钥，而不必手动输入所有键名，如图所示：

空间页面

在这个页面中，你可以查看、删除和新增磁盘挂载。这些挂载都会体现在项目的虚拟环境中。

信息

“磁盘” 是 OOMOL Studio 里的一个概念，表示暴露给虚拟环境的存储挂载点，类似容器中的 Volume。

点击右上角的挂载磁盘按钮后，会弹出一个对话框，让你选择要挂载的目录。“宿主机目录”表示你电脑上的本地目录，“容器目录名”则是它在虚拟环境中的显示名称。

为了保证不同系统之间的兼容性，“容器目录名”必须以小写字母或数字开头，只能包含小写字母、数字、点、下划线和连字符，且最长为 215 个字符。

为了安全起见，我们默认情况下只会挂载下列目录到虚拟环境中:

• ~/oomol-storage -> /oomol-driver/oomol-storage
  • 项目数据的存储根目录，用户可以在运行 Flow 前，选择此目录或者其下的目录作为数据存储目录。
• ~/.oomol-studio/sessions -> /oomol-driver/sessions
  • 每次运行时的会话目录，每次运行 Flow 时，OOMOL Studio 都会在这个目录下创建一个新的嵌套目录，作为当前运行的会话目录。
  • 其创建的嵌套规则为: /oomol-driver/sessions/{project_name}/{flow_name}/{timestamp}，其中 project_name 为项目名称，flow_name 为 Flow 名称，timestamp 为当前时间戳。
  • 作为 Flow 的开发者，你可以通过使用 context.sessionDir 来获取当前会话目录的路径。适用于在本次运行时共用数据的场景。
• ~/.oomol-studio/oocana-tmp-root -> /oomol-driver/oocana-tmp-root
  • 用于调试的临时目录，每次运行时，OOMOL Studio 都会在这个目录下创建一个新的目录，作为当前运行时的临时目录，这个目录具备以下性质: 运行失败时不会自动删除，运行成功时会自动删除。
  • 作为 Flow 的开发者，你可以通过使用 context.tmpDir 来获取当前运行时的临时目录的路径。

设置页面

在这个页面中，你可以配置 OOMOL Studio 的基础设置，包括主题、语言、镜像源和代理等。

在 Windows 系统中，这里将会新增一个 “OVM 文件夹”，这用于修改: OVM 数据存放位置，因为 OVM 数据会随着使用时间的增加而增大，所以我们建议将其放在一个大一点的磁盘中。默认情况下，OVM 数据会存放在 C:\Users\{username}\.oomol-studio\ovm 目录下。

信息

关于 “OVM 文件夹” 迁移，可以见 这里