Capsule 沙箱运行时

这个 Agent 能做什么，适合哪些场景？

Capsule 是一个用于执行不可信代码的运行时，提供 Rust CLI、Python SDK 和 TypeScript/JavaScript SDK。开发者可用 Python 的 @task 装饰器或 TypeScript/JavaScript 的 task() 包装器定义任务，并通过 capsule run 或 SDK 的 run() 启动工作流。运行时将代码编译为 WebAssembly 模块，让每个任务在独立沙箱中运行，并可配置 CPU 燃料、内存、超时、重试、文件、网络域名和环境变量访问。每次执行返回包含结果、错误和执行指标的 JSON 结构。它面向本地项目和宿主程序集成；README 未描述托管服务或云端部署。

使用 capsule run main.py 或 capsule run main.ts 读取入口文件，将其编译为 WebAssembly，并在隔离沙箱中执行名为 main 的任务。任务可接收参数、访问显式允许的目录和环境变量，并向 allowed_hosts 中的域名发起 HTTP 请求；默认不允许出站请求。可通过 compute、ram、timeout 和 max_retries 设置执行资源与失败重试策略。capsule build 可预编译任务，capsule exec 可执行导出的 .wasm 文件；CLI 的 --mount 或 SDK 的 mounts 可将项目目录挂载到沙箱路径。执行结果包含任务返回值、错误状态、耗时、重试次数、燃料消耗、内存用量和宿主请求记录。

1. 需要在 WebAssembly 隔离环境中执行用户提交代码的平台团队，可用任务级资源限额控制执行。
2. 用 Python 编写数据处理任务的开发者，可通过 @task 定义任务并用 CLI 运行。
3. 使用 TypeScript/JavaScript 的工程团队，可通过 npm SDK 将沙箱任务接入现有 Node.js 程序。
4. 需要让任务读取输入目录并写入输出目录的工作流，可分别设置只读和读写权限。
5. 需限制任务外联的应用，可通过 allowed_hosts 配置域名白名单并查看宿主请求记录。

如何安装或部署这个 Agent？

Python 快速开始需要 Python 包和 Capsule CLI。TypeScript/JavaScript 快速开始安装全局 CLI 和 SDK。README 未说明需要 API 密钥或付费服务。

如何使用这个 Agent？

Python 安装与首次运行：

pip install capsule-run

from capsule import task

@task(name="main", compute="LOW", ram="64MB")
def main() -> str:
    return "Hello from Capsule!"

capsule run hello.py

TypeScript/JavaScript 安装与首次运行：

npm install -g @capsule-run/cli
npm install @capsule-run/sdk

import { task } from "@capsule-run/sdk";

export const main = task({
  name: "main",
  compute: "LOW",
  ram: "64MB"
}, (): string => {
  return "Hello from Capsule!";
});

capsule run hello.ts

如需从宿主代码启动任务，可在 Python 中导入 run，或在 TypeScript/JavaScript 中从 @capsule-run/sdk/runner 导入 run；TypeScript/JavaScript runner 还要求项目依赖中包含 @capsule-run/cli。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.8.10 2026-04-27
   发布说明摘录

   Improvements TypeScript SDK Polyfills - Add more built-in methods to fs - Add a real Wasi‑based stats system for files and folders - Add support for symlinks inside sandboxes

   在 GitHub 查看 ↗
2. v0.8.9 2026-04-22
   发布说明摘录

   Improvements Rust Core - Fix cache issues for multi-language projects - Improve task reporter to have better logs Typescript SDK - Fix worker process issue for run() command - Fix absolute path issue for fs polyfills Python SDK - Fix worker process issue for run() command

   在 GitHub 查看 ↗
3. v0.8.8 2026-04-17
   发布说明摘录

   Smaller Python bundle, worker mode, and path fixes Improvements Core - Worker mode: Added a capsule worker to reduce child process overhead when using the run() function. - Trace rebuild fix: Fixed trace rebuild for projects using both Python and TypeScript sandboxes. SDKs - Smaller Python bundle: Only import the necessary built-ins, reducing the overall size. - TypeScript path fixes: Resolved absolute path issues with fs polyfills.

   在 GitHub 查看 ↗

常见问题