创建 Agent 工作区与安装 Rootfs · 从零开始建立 Linux 容器

工作区创建三步走

第一步：创建工作区空壳

1. 打开 设置 → 扩展管理 → 工作区
2. 点击右下角 + 按钮新建工作区
3. 输入英文名称（不支持中文、空格、特殊字符）
4. 点击保存

工作区名称只能用英文字母、数字、连字符（如 ai-tasks、coding、writing）。这是 proot 的要求，RikkaHub 在保存时会校验。

创建完成后，工作区列表里会出现一张卡片，显示名称和状态（此时还没有 Rootfs，不能真正使用）。

第二步：安装 Rootfs（"装上操作系统"）

Rootfs = Root Filesystem（根文件系统），是 Linux 容器运行所需的基础文件。安装 Rootfs 相当于"给工作区装上操作系统"。

1. 在工作区管理页，点击刚创建的工作区卡片
2. 进入详情页后，点击 安装 Rootfs 按钮
3. 等待下载和安装完成（几百 MB，取决于 Rootfs 大小）
4. 安装完成后，工作区状态变为"就绪"

Rootfs 安装需要网络连接。文件大小取决于选择的发行版（Debian / Ubuntu / Alpine）。

第三步：绑定到助手

创建好的工作区需要绑定到一个助手才能使用：

1. 打开聊天页面
2. 点击聊天栏的 + 按钮（附件 / 扩展）
3. 找到 工作区 卡片
4. 点击并选择一个工作区
5. 绑定成功后，这个助手在对话中就有了工作区能力

一个助手只能绑定一个工作区。

常用术语速查

安装成功后做什么

进入终端

点击工作区详情页右上角的终端图标，打开内置命令行。你可以手动输入：

apt update
apt install -y curl unzip zip git jq

手动安装一些常用工具。但大多数情况下不需要手动安装——在对话中给 AI 下达任务时，AI 会根据需要自行安装依赖。

管理文件

点击工作区详情页底部的文件标签页，可以：

• 导入文件到工作区
• 导出工作区中的文件
• 直接分享到其他应用

系统文件管理器里会出现一个名为 "RikkaHub" 的磁盘，进入后按工作区名称找到文件夹，可以直接复制、移动、删除——和普通文件夹一样。

场景案例

详见后续章节：

• 克隆仓库并翻译文件
• 用工作区制作 PPT

创建多个工作区

你可以创建多个工作区，每个独立运行：

每个工作区有自己独立的文件系统和已安装的软件包。互不干扰。

删除工作区

在工作区详情页或列表页找到删除按钮。删除是永久性的——Rootfs、文件、已安装的软件包全部清除。建议删除前先导出重要文件。

常见问题

工作区安装 Rootfs 时网络失败

Rootfs 下载需要稳定的网络。可以重试，或换个网络环境。

存储空间不够

工作区 Rootfs + 软件包会占用几百 MB。删除不需要的应用、清理存储空间后重试。

工作区里能不能跑 GUI 程序

不能。工作区是命令行环境，只能运行 CLI 工具（git、python、node、apt 等）。如果任务需要 GUI（比如用浏览器抓网页），需要换一种方式——比如用 curl + HTML 解析，或通过 MCP 的网页搜索工具。