SparkSandbox

Mon, 31 Aug 2026 00:00:00 +0800

SparkSandbox 是 Linux 上的隔离执行 HTTP 服务，不是对外 SDK。任意语言发 HTTP 完成编译与运行，HMAC 验签由调用方实现。响应含 stdout、stderr、资源用量与执行状态；支持多测例、checker、interactive pipeline、文件仓与 SSE。仓内 Python 仅供本仓测试。当前版本 0.1.1，MIT。

OJ、在线 IDE、作业评测把「跑用户代码」交给本服务；AC / WA 留在业务侧。ACOJ 判题执行即对接此服务。

flowchart TB client["OJ / IDE / 作业系统"] http["HTTP + HMAC"] orch["FastAPI 编排"] engine["C++20 sparksandbox"] iso["namespace / cgroup / seccomp"] client --> http --> orch --> engine --> iso

特性

双层实现：引擎负责隔离与状态分类；编排负责语言表、worker 池、CompileCache、FileStore、多测例并行
执行状态：succeeded、compile_failed、runtime_error、time_limit_exceeded、memory_limit_exceeded、output_limit_exceeded、security_violation、internal_error；stage 区分 compile / run
语言表：默认 C11、C++17、Python 3、Java 17、Go、Node.js；镜像另开 Rust 与 SQLite；YAML 可声明 SQL 客户端语言
评测形态：多测例、checker、interactive、文件仓、SSE
容器：toolchain base 与 server 分层；--privileged --cgroupns=host

flowchart LR compile["compile"] run["run"] ok["succeeded"] fail["compile_failed / runtime_error"] limit["TLE / MLE / OLE"] sec["security_violation"] compile --> run compile --> fail run --> ok run --> fail run --> limit run --> sec

技术栈

引擎：C++20 · namespaces · cgroup · seccomp
编排：Python 3.10+ · FastAPI
交付：Docker 双层镜像

Voxel

Thu, 01 Oct 2026 00:00:00 +0800

Voxel 是一组按同一领域分层重建的全栈脚手架系列：Portal 与 Admin 独立后端、独立前端，目录、坐标与包名统一为 voxel-* / io.github.jiangbyte.voxel。后端对齐 Java（Spring Boot）、Python（FastAPI）、Go（Gin）；前端对齐 Vue 3 管理端、React 门户与 uni-app。另有七层纯骨架与带账户竖切的充实模板，供对照学习，不作业务拷贝范本。协议 Apache License 2.0。

相对「一份单体里切 admin/portal」，端隔离：Admin 只挂管理 API，Portal 只挂门户 API，前端互不引用对方源码。相对单语言脚手架，同一七层在三种运行时对齐。

flowchart TB subgraph fronts ["前端"] vue["voxel-admin Vue3"] react["voxel-portal React"] uniA["admin-uniapp"] uniP["portal-uniapp"] end subgraph backends ["后端 · Admin / Portal"] ja["Java 8000 / 8001"] py["FastAPI 8100 / 8101"] go["Gin 8200 / 8201"] end subgraph tpls ["模板"] skel["ddd-lite-strcut"] lite["ddd-lite"] end vue --> ja react --> ja uniA --> ja uniP --> ja vue --> py react --> py vue --> go react --> go lite -.-> ja skel -.-> lite

特性

端分离：Admin / Portal 各仓各端口
DDD 七层：types · api · domain · infrastructure · case/cases · trigger · app
依赖方向：Trigger → API → Case → Domain ← Infrastructure
Java：Maven 多模块 {project}-types … -app
FastAPI：仓库根扁平包，无 src/ 包装层
Gin：internal/{types,api,domain,infrastructure,cases,trigger} + cmd/app
Web / 移动：Vue 3、React 19、uni-app 双端
模板仓：骨架默认注释中间件；充实模板含账户竖切，S3 / Milvus / Spring AI / MCP 注释接入（原 voxel-ddd-ai-lite 已合并）

flowchart TB trigger["trigger"] api["api"] cases["case"] domain["domain"] infra["infrastructure"] types["types"] app["app"] trigger --> api --> cases --> domain infra --> domain app --> trigger app --> infra types -.-> trigger

技术栈

后端：JDK 21 · Python 3.11+ · Go 1.25+
前端：Vue 3 · React 19 · uni-app
协议：OpenAPI / Apifox（docs/api/openapi）

系列仓库

后端

FastAPI on 撷时录

SparkSandbox

特性

技术栈

Voxel

特性

技术栈

系列仓库