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

# 沙箱规格参考

> 托管智能体云沙箱的操作系统、预装运行时和工具、文件系统、访问权限及网络访问规则。

托管智能体的每个会话（Session）都使用独立的 **云沙箱**，智能体（Agent）在其中执行代码和读写文件。本页汇总沙箱的规格与使用边界，供你设计智能体时参考。如需配置预装依赖、网络访问策略和初始化脚本，请参阅 [执行环境（Environment）](/docs/hosted-agents/environments)。

<Info>
  每个会话使用独立沙箱，不与其他会话共享文件和进程状态。
</Info>

## 操作系统与预装软件

沙箱基于 **Debian 12（bookworm）** 镜像构建，预装常用的语言运行时、系统工具，以及文档和数据处理软件。

### 语言运行时

| 运行时 | 版本 | 附带的包管理工具 |
| - | - | - |
| Python | 3.12 | `pip`、`uv` |
| Node.js | 24 | `npm` |
| .NET | SDK 8.0 | `dotnet` |
| Go | 1.26 | `go` |
| Rust | 1.97 | `cargo` |

<Note>
  上表列出的是主要版本，具体小版本号可能随镜像更新而变化。你也可以通过 [执行环境](/docs/hosted-agents/environments) 的 `packages` 字段，使用对应的包管理器安装额外依赖。
</Note>

### 系统工具

| 类别 | 预装工具 |
| - | - |
| 常用命令行 | `git`、`curl`、`wget`、`jq`、`tmux`、`vim`、`zip` / `unzip`、`rsync`、`tree` |
| 文档与 Office | LibreOffice、`pandoc`、`qpdf`、poppler-utils（`pdftotext` 等）、`wkhtmltopdf`、Tectonic（LaTeX 排版） |
| 媒体处理 | `ffmpeg`、Tesseract OCR（含英文识别包） |
| 浏览器 | Chromium（无头模式，供 PDF 渲染、图表截图等工具链使用） |
| 字体 | Noto CJK 等中英文字体，可直接用于文档和图片渲染 |

### Python 包

<Accordion title="数据科学与可视化">
  `numpy`、`pandas`、`scipy`、`scikit-learn`、`statsmodels`、`lightgbm`、`sympy`、`networkx`、`matplotlib`、`plotly`、`seaborn`
</Accordion>

<Accordion title="文档与 PDF 处理">
  `python-docx`、`python-pptx`、`openpyxl`、`xlrd`、`xlsxwriter`、`pdfplumber`、`pypdf`、`pymupdf`、`pikepdf`、`reportlab`、`pdf2image`、`markitdown`、`beautifulsoup4`、`lxml`、`markdownify`
</Accordion>

<Accordion title="图像与视觉">
  `pillow`、`opencv-python-headless`、`scikit-image`、`imageio`、`pytesseract`、`onnxruntime`
</Accordion>

<Accordion title="地理空间与其他">
  `geopandas`、`shapely`、`pyproj`、`requests`、`jinja2`、`yfinance`、`backtrader`，以及 Jupyter 内核（`ipython` / `ipykernel`）
</Accordion>

### 通过 npm 全局安装的工具

`docx`、`pptxgenjs`、`pdf-lib`、`pdftk`、`md-to-pdf`、`@mermaid-js/mermaid-cli`（命令为 `mmdc`，Mermaid 图表渲染）、`sharp`（图像处理）等，可用于生成文档和幻灯片。

如果需要确认实际安装的版本，可以让智能体在沙箱中运行版本检查命令。常用命令包括 `python3 --version`、`node --version` 和 `pip list`。

## 文件系统布局

沙箱内 `/mnt` 下的挂载点按来源划分，访问权限各不相同：

| 路径 | 内容 | 访问权限 |
| - | - | - |
| `/mnt/agents/` | **工作目录**：智能体在会话中默认使用的目录，用于保存代码、中间文件和产出文件 | 读写 |
| `/mnt/agents/upload/` | 通过会话资源挂载的上传文件 | 只读 |
| `/mnt/agents/memories/<name>/` | 绑定的 [记忆库](/docs/hosted-agents/memory)（Memory Store），每个记忆库一个目录 | 绑定时可选 `read_only` / `read_write` |
| `/mnt/agents/skills/<name>/` | 智能体声明的 [技能](/docs/hosted-agents/skills)（Skill），随会话创建自动挂载 | 只读 |
| `/mnt/agents/plugins/<name>/` | [插件](/docs/hosted-agents/plugins)（Plugin）包含的技能与脚本，随会话创建自动挂载 | 只读 |

### 只读与读写边界

**工作目录**：`/mnt/agents/` 是智能体在会话中默认使用的目录，用于保存代码、中间文件和产出文件。写入该目录的文件会同步到当前会话的持久化工作区；沙箱实例重建后，平台会重新挂载这些已同步的文件。不同会话之间不会共享工作目录。实例退出前尚未完成同步的最新写入可能丢失。会话结束后如需保留关键产物，请通过 [会话文件接口](/docs/hosted-agents/files) 取回，或使用 `save_artifact` 显式交付为不可变版本。

**只读挂载**：上传文件、技能和插件都以只读方式挂载。其中，技能和插件的内容在创建会话时确定；上传文件还可以在会话创建后通过 `POST /v1/sessions/{id}/resources` 追加挂载，详见[文件](/docs/hosted-agents/files)。智能体不能修改这些只读内容，也不应将产出写入相应目录。

**记忆库**：以 `read_write` 模式绑定记忆库后，智能体可以在对应目录中新增、修改和删除记忆文件，之后绑定同一记忆库的其他会话也能访问这些内容。以 `read_only` 模式绑定时，智能体不能修改记忆库内容。

<Warning>
  `/mnt/agents/upload/` 为只读目录。应让智能体把处理结果写入 `/mnt/agents/` 工作目录，而不要尝试直接修改上传文件。
</Warning>

## 沙箱网络边界

沙箱进程的出站网络访问由所属 [执行环境](/docs/hosted-agents/environments) 的 `networking` 配置决定。具体的网络模式、允许访问的主机和代理配置请参阅 [执行环境](/docs/hosted-agents/environments)。该配置只影响沙箱内进程，不影响平台层工具，例如 Web Search 和 Fetch。

## 相关资源

<CardGroup cols={3}>
  <Card title="执行环境" icon="layer-group" href="/docs/hosted-agents/environments">
    配置预装依赖、网络访问策略和初始化脚本。
  </Card>

  <Card title="文件" icon="file" href="/docs/hosted-agents/files">
    上传文件、挂载到会话并取回智能体产出。
  </Card>

  <Card title="记忆库" icon="database" href="/docs/hosted-agents/memory">
    以读写方式挂载记忆库，跨会话保存知识。
  </Card>

  <Card title="凭据库（Vault）" icon="key" href="/docs/hosted-agents/vaults">
    安全托管凭据，并按匹配规则注入或替换。
  </Card>

  <Card title="技能" icon="wand-magic-sparkles" href="/docs/hosted-agents/skills">
    管理技能版本，并以只读方式挂载技能。
  </Card>
</CardGroup>