Mirage 纯前端 WebAssembly 代码隔离执行环境

Mirage 纯前端 WebAssembly 代码隔离执行环境

@strukto-ai/mirage·v1.1.0·sandbox

运行于现代浏览器 Web Worker 与 WebAssembly 之上的极速代码沙箱。无需昂贵的后端容器支持,在客户端零延迟安全运行 Python、JavaScript 与 SQLite,零服务器算力开销。

WASM沙箱 · 纯前端执行 · 数据隐私 · 零云端成本

GitHubNPM
快速安装与集成
bash
manager:
$ pnpm add @strukto-ai/mirage

架构解析

「Mirage Sandbox」将安全的代码执行能力直接搬到了用户的浏览器前端。在传统的方案中,为用户提供代码运行环境往往需要常驻庞大的 Docker 服务器集群,不仅架构昂贵复杂,还面临高昂的运维成本与安全攻击面。 本插件通过深度集成 Pyodide 与 WebAssembly 技术,使智能体能够在用户的浏览器标签页内原地执行代码。无论是让模型分析一份 CSV 电子表格、绘制交互式数据图表,还是运行复杂的算法单元测试,均在纯前端内存沙箱中毫秒级完成,兼顾了极致的隐私安全性与零云端算力账单。

核心特性

01

纯前端客户端本地运行:零后端容器开销,无需搭建任何远程 Docker 执行集群

02

绝无数据外泄风险:用户本地数据在浏览器沙盒内直接闭环处理,隐私零泄漏

03

毫秒级冷启动速度:免去传统虚拟机长达数秒的开机时间,代码随写随测

04

完整支持主流科学计算库:内置 Numpy、Pandas、Matplotlib 等标准 Python 生态

核心机制

01

Web Worker 隔离实例化

在独立浏览器线程中派生 Web Worker,挂载虚拟内存文件系统。

02

WASM 运行时即时加载

动态载入 Pyodide 或 QuickJS WebAssembly 虚拟机内核与标准库。

03

安全沙盒指令求值

执行模型生成的 Python/JS 逻辑,严密屏蔽 DOM 与主线程内存访问。

04

标准输出与图元回传

捕获执行打印内容与生成的图表 Base64/SVG 图像,回传至对话会话。

配置参数参考 (YAML / JSON)

参数名类型默认值说明
runtimeLanguagestringpython沙箱默认执行语言虚拟机 (python / javascript / sqlite)
executionTimeoutMsnumber10000前端代码防卡死强行终止时限(毫秒)
preloadStandardLibsbooleantrue是否在后台静默预热并载入常用核心科学计算库