Documentation

DeepTask Sandbox 文档

一个安全的本地优先沙盒，将您的 AI 助手连接到您的环境。
2 min read
Updated Jan 26, 2026

DeepTask Sandbox 是一个本地优先的桌面应用程序，为您的 AI 助手提供安全、可脚本化的环境。通过自然对话（通过 MCP），您的助手可以运行脚本、访问已批准的本地功能，并可靠地编排工作流程——当任务真正需要真实页面时，可选择使用浏览器支持的执行。

核心原则

  • 隐私优先：所有自动化都在本地运行。您的数据永远不会离开您的机器。
  • 助手就绪：原生支持模型上下文协议（MCP）。与 Claude、Cursor 等无缝协作。
  • 可脚本化沙盒：运行轻量级 Javascript 逻辑，仅在需要时选择使用浏览器支持的运行时（Puppeteer）。
  • 内置防护：调度、任务历史、资源限制、域名白名单以及加密的设置/凭据。

01. 快速开始

启动和运行只需不到五分钟。

步骤 1：安装桌面应用

下载并运行适合您操作系统的安装程序。

下载 DeepTask Sandbox

步骤 2：连接您的助手

DeepTask 使用**模型上下文协议（MCP）**与您的 AI 通信。按照您喜欢的环境的说明进行操作：

操作系统 安装类型 命令路径
Windows 系统（默认） C:\Program Files\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
Windows 用户 C:\Users\<user>\AppData\Local\Programs\deeptask-sandbox\resources\mcp\deeptask-mcp.exe
macOS 标准 /Applications/DeepTask Sandbox.app/Contents/Resources/mcp/deeptask-mcp
Linux 标准 /opt/deeptask-sandbox/resources/mcp/deeptask-mcp

示例配置块（Claude Desktop）：

{
  "mcpServers": {
    "deeptask": {
      "command": "在此粘贴命令路径"
    }
  }
}

步骤 3：您的第一个脚本

连接后，只需要求您的助手在沙盒中创建并运行一个小脚本。

尝试此提示：

"使用 DeepTask，编写一个小的 javascript 脚本，获取 https://example.com 的标题并将其作为结构化输出返回。"

02. 脚本指南

DeepTask 脚本功能强大、类型安全且易于构建。您的 AI 可以为您生成这些脚本，或者您可以自己编写它们。

脚本结构

每个脚本由两部分组成：元数据（配置）和主函数（逻辑）。

export const metadata = {
    name: "web-scraper",
    type: "puppeteer", // 纯逻辑使用 "javascript"，需要真实浏览器时使用 "puppeteer"
    description: "从网页提取基本信息（浏览器支持，可选）",
    networkEnabled: true,
    domainsAllowed: ["example.com"],
    inputSchema: {
        type: "object",
        properties: {
            url: {type: "string", format: "uri"}
        },
        required: ["url"]
    }
};

export async function main({url}) {
    const page = await browser.getPage();
    await page.goto(url, {waitUntil: "networkidle0"});

    const title = await page.title();
    return {
        content: [{type: "text", text: `已抓取: ${title}`}],
        structuredContent: {title},
        isError: false
    };
}

高级功能

文件上传

您可以定义接受文件（PDF、图像等）的输入，这些文件以 Base64 字符串的形式传递给您的脚本。

inputSchema: {
    properties: {
        document: {
            type: "string",
                contentEncoding
        :
            "base64",
                contentMediaType
        :
            "application/pdf",
                description
        :
            "上传 PDF 进行分析"
        }
    }
}

加密设置

安全地存储敏感配置。用户在 UI 中被提示输入这些值，并且它们在静态时被加密。

settingsSchema: {
    properties: {
        apiKey: {
            type: "string",
                format
        :
            "password",
                title
        :
            "OpenAI 密钥"
        }
    }
}
// 通过以下方式访问：const { apiKey } = browser.currentScript.settings;

03. 专业功能

智能调度

使用内置的 Cron 支持自动化您的工作流程。

  • 每日报告：0 9 * * *（每天早上 9 点）
  • 每周清理：0 0 * * 0（每周日午夜）

安全与隔离

DeepTask 为企业而建：

  • 域名白名单：除非您明确允许特定域名，否则脚本无法访问互联网。
  • 资源限制：每个脚本可配置的 CPU（50-100%）和 RAM（64MB-2GB）上限。
  • 超时保护：通过自动脚本终止防止失控进程。

04. API 和工具参考

全局 API

API 描述
browser.getPage() （仅 Puppeteer）返回活动页面对象。
browser.scripts.run(name, params) 执行另一个已安装的脚本。
browser.downloads.download({url, filename}) 将文件保存到本地计算机。
browser.currentScript.settings 访问脚本的配置设置。

助手的 MCP 工具

您的 AI 助手可以使用以下标准工具与 DeepTask 交互：

  • install_script / uninstall_script
  • list_scripts / get_script_info
  • run_script
  • update_script_settings

支持与资源