> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rikka-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 工作区

> 为 AI 提供轻量级 Linux 环境，支持文件操作、制作 PPT 等 Agent 任务。

工作区为 AI 提供了一个轻量级的 Linux 系统环境，AI 可以在其中操作文件，完成编辑文件、制作 PPT 等任务。
一个助手可以绑定一个工作区。

## 快速开始

<Steps>
  <Step title="创建工作区">
    1. 点击**设置** → **扩展管理** → **工作区**，进入工作区管理页面。
    2. 点击右下角加号按钮新建工作区，输入名称完成创建。
    3. 点击刚创建的工作区卡片进入管理页面，点击**安装 Rootfs** 为工作区安装系统文件。

    <Note>
      工作区名称需要使用英文。
    </Note>
  </Step>

  <Step title="管理和配置工作区">
    在工作区管理页面，你可以：

    * 配置工作区提供的工具是否需要用户审批才能执行
    * 点击**文件**标签页管理工作区文件，支持导入和导出
    * 点击右上角图标进入终端界面
  </Step>

  <Step title="在聊天中使用">
    回到聊天页面，点击聊天栏的加号按钮，即可看到绑定工作区的卡片，点击绑定到目标工作区。

    绑定后，当你给 AI 下达任务时，AI 即可通过工作区完成各种操作。
  </Step>
</Steps>

## 术语解释

| 术语         | 说明                                                                            |
| ---------- | ----------------------------------------------------------------------------- |
| **工作区**    | Rikka 为 AI 提供的一个隔离的 Linux 运行环境。每个工作区独立运行，拥有自己的文件系统和软件包，互不影响。                  |
| **终端**     | 工作区内置的命令行界面，你可以在其中直接输入 Linux 命令来管理文件、安装软件或调试问题。                               |
| **Rootfs** | Root Filesystem（根文件系统）的缩写，是工作区运行所需的基础系统文件。安装 Rootfs 相当于为工作区"装上操作系统"，之后才能正常使用。 |

## 安装常用软件包

工作区默认使用 `apt` 包管理器。你可以通过终端手动安装，也可以直接让 AI 在任务中自行安装所需的软件包。

<Tabs>
  <Tab title="基础工具">
    | 软件包             | 用途              |
    | --------------- | --------------- |
    | `curl`          | 发送 HTTP 请求、下载文件 |
    | `unzip` / `zip` | 解压和压缩 ZIP 文件    |
    | `git`           | 版本控制、克隆仓库       |
    | `jq`            | 解析和处理 JSON 数据   |

    ```bash theme={null}
    apt update && apt install -y curl unzip zip git jq
    ```
  </Tab>

  <Tab title="Python">
    ```bash theme={null}
    apt update && apt install -y python3 python3-pip
    ```
  </Tab>

  <Tab title="Node.js (nvm)">
    通过 nvm 安装 Node.js，方便管理多个版本：

    ```bash theme={null}
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
    ```

    安装完成后，重新加载环境并安装 Node.js：

    ```bash theme={null}
    source ~/.bashrc && nvm install --lts
    ```
  </Tab>
</Tabs>

<Tip>
  大多数情况下你不需要手动安装这些软件包——在聊天中给 AI 下达任务时，AI 会根据需要自动安装所需的依赖。
</Tip>

## 文件导入导出

你可以通过以下两种方式管理工作区中的文件：

<Tabs>
  <Tab title="App 内管理">
    进入工作区管理页，点击底部的**文件**菜单按钮切换到文件管理页。在这里你可以：

    * 导入文件到工作区
    * 导出工作区中的文件
    * 直接分享文件到其他应用
  </Tab>

  <Tab title="系统文件管理器">
    打开系统自带的文件管理器，你会看到一个名为 **RikkaHub** 的磁盘。进入后可以看到以工作区名称命名的文件夹，里面就是对应工作区的文件，可以直接进行复制、移动、删除等操作。
  </Tab>
</Tabs>

## 场景案例

以下是一些案例用法供参考

### 克隆仓库并编辑文件

绑定工作区后，你可以让 AI 克隆一个 Git 仓库并对其中的文件进行编辑。例如，发送以下消息：

> 克隆 [https://github.com/user/repo](https://github.com/user/repo) 这个仓库，然后把 README.md 翻译成中文

AI 会在工作区中依次执行以下操作：

1. 安装 `git`（如果尚未安装）
2. 克隆目标仓库到工作区
3. 读取 `README.md` 的内容
4. 将内容翻译为中文并写回文件

完成后，你可以通过文件管理导出修改后的文件，或者push到远程仓库。

### 制作 PPT

1. 前往**扩展管理** → **Agent Skills**，安装 [pptx skill](https://github.com/anthropics/skills/tree/main/skills/pptx)。
2. 在聊天页面点击加号，进入扩展管理，启用该 Skill。
3. 发送你的需求，例如让 AI 搜索资料并制作 PPT。
4. AI 会逐步搜索资料，并调用工作区内的 Python / Node.js 环境生成 PPT 文件。
5. 完成后，进入工作区管理页，导出或分享生成的 PPT 文件。