container2wasm

本项目固定使用 container2wasm 0.8.4，把精简 Alpine Linux 镜像转换为浏览器可加载的 WebAssembly。

镜像里的 Linux 用户空间通过虚拟机运行。浏览器加载预先构建的 WASM 与静态分片，不在页面内启动 Docker 服务，也不在用户点击启动时重新构建镜像。

构建链

Dockerfile
  → linux/riscv64 容器镜像（Shell PowerShell 使用 linux/amd64）
  → container2wasm
  → runtime.wasm
  → 10 MiB 原始切片
  → gzip + SHA-256 + manifest

为什么选择 RISC-V 64

Lang 与 Shell 基础环境选择 RISC-V 64；Shell PowerShell 延续既有 AMD64 容器方案。页面严格核对清单里的运行时身份和指定架构，拒绝加载另一个目标的资产。

镜像原则

每个语言镜像只安装 Alpine 基础命令和一套语言工具链。没有明确 LTS 的语言使用 Alpine 当前受支持稳定线，实际版本由构建后的 manifest 记录。

构建与接入入口

• Lang 镜像与工具链配置位于 runtimes/lang/，由 build-lang-runtimes.yml 手动构建。
• Shell 镜像位于 runtimes/shell/{base,multi,powershell}/，由 build-shell-runtimes.yml 手动构建。
• 两类构建复用 scripts/package-runtime.js，生成带版本、架构、分片字节数和 SHA-256 的清单。

运行时目录记录实际体积与工具版本。浏览器接入与排障说明分片加载、Worker/PTY、跨域隔离及其他项目的复用方法。