diff --git a/BENCHMARK_BASELINE.md b/BENCHMARK_BASELINE.md index 96deab55..11ade3d5 100644 --- a/BENCHMARK_BASELINE.md +++ b/BENCHMARK_BASELINE.md @@ -87,8 +87,7 @@ unary_ops 271.73 0.318 271.415 370002 mem_map_retain 原生盒边持有：Map 持 20000 组字符串键 + 对象值 mem_set_retain 原生盒边持有：Set 持 20000 个对象（各带 payload 字符串） mem_string_rope 拼接 rope 链留存：重复二元拼接形成深 Cons 链（账目按逻辑长度计，数值高于实际足迹） -口径：Peak B/Ret B 为 session 堆账目（对象头 + 堆数据 + 存活串/BigInt）；epoch arena -的临时驻留不计入字节账目（数量见 JSON 的 epoch_objects）。Peak B 为顶层指令 -边界采样的 session arena 高水位；单指令内瞬态与 epoch 高水位不计。Ret B 为 workload 后 -晋升 + 完整 GC 的真存活集，至多含一份引擎内部副本：逃逸屏障留 epoch 原件且顶层 -寄存器根不回写时，测量时晋升会把原件再克隆一份（object_graph 见留存锚测试）。 +口径：Peak B/Ret B 为 session 堆账目（对象头 + 堆数据 + 存活串/BigInt）；JSON 的 +`epoch_objects`/`epoch_bytes` 为恒零锚字段（epoch 分配器退役后保留 schema 兼容）， +不计入字节账目。Peak B 为顶层指令边界采样的 session arena 高水位；单指令内瞬态 +不计。Ret B 为 workload 后强制完整 GC 的真存活集。 diff --git a/README.md b/README.md index 3fff48aa..d152583c 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ Rust Platform Engine - test262 + test262

@@ -17,8 +17,6 @@ OxideJS 是一个基于 Rust 的轻量级 JavaScript 执行引擎，擅长短时 当前项目聚焦于实用 ECMAScript 子集，并通过 [test262](https://github.com/tc39/test262) 持续验证兼容性。我们的最终目标是提供一个小型、可检查、跨平台、启动成本可预测、benchmark 可复现的 JavaScript runtime。 -演示视频链接: https://pan.baidu.com/s/11gvBV5G_rLrNTS0sb863Qg?pwd=pr7n 提取码: pr7n - ## 2. 特性概览 - **Rust 实现**：使用 Cargo workspace 组织 parser、compiler、VM、runtime、CLI 和 test runner。 @@ -61,7 +59,7 @@ OxideJS 采用经典的 parse -> compile -> execute 流水线，同时使用 ** |----------------| |----------------| |----------------| | registers | | registers | | registers | | call frames | | call frames | | call frames | - | Epoch Arena | | Epoch Arena | | Epoch Arena | + | session objects | | session objects | | session objects | | JsString GC | | JsString GC | | JsString GC | +-------+--------+ +-------+--------+ +-------+--------+ | | | @@ -92,7 +90,7 @@ Per request pipeline: 1. **Parser 前端**：通过 `oxide_parser` 将源码解析为 AST。 2. **字节码编译器**：将 AST 降低为 OxideJS 字节码、常量池和寄存器布局。 -3. **寄存器式 VM**：`oxide_vm` 读取字节码并使用固定寄存器文件执行；每个 VM 持有自己的寄存器、调用栈、Epoch Arena 与 JsString GC。 +3. **寄存器式 VM**：`oxide_vm` 读取字节码并使用固定寄存器文件执行；每个 VM 持有自己的寄存器、调用栈与 session 对象空间（SessionGc 原地清扫回收）。 4. **值系统**：`JsValue` 通过 NaN-boxing 紧凑表示 JavaScript 运行时值；`JsString` 由 VM 内的标记清扫 GC 管理。 5. **对象模型**：对象通过 Shape ID 描述属性布局。 6. **运行时 Kernel**：`KernelCore` 保存进程级永久共享状态 (`PermInterner` 等), `KernelSession` 保存可重建的会话级状态 (`BuiltinWorld` / global object); 多个 VM 通过 `Arc` 引用同一份永久共享数据。 @@ -125,7 +123,8 @@ project-root/ │ ├── oxide_cli/ # 命令行工具 │ └── oxide_test262/ # test262 兼容性测试运行器 └── tests/ - └── test262/ # 本地 test262 测试套件 + ├── test262/ # 本地 test262 测试套件 + └── stress/ # bench 语料（oxide bench js 消费） ``` ## 5. 构建与日常验证 @@ -159,18 +158,30 @@ cargo clippy --all-targets cargo run --release -p oxide_cli -- eval "1 + 2" ``` +`eval` 与 `run` 均支持 `--trace`：逐指令 trace，每条指令向 stderr 写一行 pc + opcode + 操作数。 + ### 执行文件 ```bash -cargo run --release -p oxide_cli -- run examples/demo.js +cargo run --release -p oxide_cli -- run tests/stress/arith_ops.js ``` +`run` 支持 `--repeat N`（缺省 1）：同一文件连续执行 N 次，失败即终止并传播退出码。 + ### 打印编译后的字节码 ```bash cargo run --release -p oxide_cli -- compile -e "1 + 2" ``` +### 性能基准（bench） + +```bash +cargo run --release -p oxide_cli -- bench js +``` + +`bench` 是性能主入口，语料为 `tests/stress/`：`mode` 缺省 `js`，`--filter` 按用例名筛选，`--warmup` 缺省 2，`--iterations` 缺省 10，`--update-baseline` 将本次结果写回基线。 + ### 启动 REPL ```bash @@ -211,12 +222,14 @@ runner 会输出： - 失败类别统计与 FAIL 清单（按测试文件路径）； - 按目录拆分的结果（取决于 runner 版本）。 +当前口径锚：全量 53598 文件通过率 78.10%（2026-10-03 全量跑，pass 41860 / fail 4313 / skip 7425）。 + 兼容性数字属于开发过程指标。发布正式 benchmark 或兼容性结论前，应基于当前 checkout 的 test262 版本重新生成结果。 ## 8. 主要使用的开源项目 - [oxc](https://github.com/oxc-project/oxc) — JavaScript 源码解析，因为这不是我们的工作中心，所以没有自己构建该系统 -- [bumpalo](https://github.com/fitzgen/bumpalo) — Bump allocator，构成 `Epoch` arena 内存系统的底层分配器 +- [bumpalo](https://github.com/fitzgen/bumpalo) — Bump allocator，`oxide_types` 的 `Epoch` 封装体（run 内高频分配）与 bench 分配对比用例的底层分配器 - [dashmap](https://github.com/xacrimon/dashmap) — 并发 HashMap，用于 `CodeForge`、`ShapeForge`、`PropForge` 跨 VM 缓存共享 ## 9. License diff --git a/crates/oxide_vm/src/vm/mod.rs b/crates/oxide_vm/src/vm/mod.rs index ab585670..d814266b 100644 --- a/crates/oxide_vm/src/vm/mod.rs +++ b/crates/oxide_vm/src/vm/mod.rs @@ -160,7 +160,7 @@ pub(crate) struct PendingAsyncEscape { /// 基于寄存器的 JS 虚拟机：持有执行状态、寄存器文件、调用栈与 session 内存。 /// /// 执行入口为 [`Vm::run`]（见 `vm_runtime` 模块）；内存模型为统一入口分配 + -/// session 对象（可被 `SessionGc` 移动式回收）+ session 字符串。多数内部字段为 +/// session 对象（可被 `SessionGc` 原地清扫回收，不搬移、地址稳定）+ session 字符串。多数内部字段为 /// `pub(crate)`，对外提供统计与内省 getter。 pub struct Vm { pub(crate) regs: [JsValue; 256],