mirror of
https://github.com/pjh456/OxideJS.git
synced 2026-10-23 18:21:13 +08:00
docs: 对齐 README 与基准基线文档的 epoch 退役后口径
This commit is contained in:
@@ -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 的真存活集。
|
||||
|
||||
@@ -7,7 +7,7 @@
|
||||
<img alt="Rust" src="https://img.shields.io/badge/Rust-1.80%2B-orange?style=for-the-badge&logo=rust" />
|
||||
<img alt="Platform" src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows%20And%20More-blue?style=for-the-badge" />
|
||||
<img alt="Engine" src="https://img.shields.io/badge/JS%20Engine-Non--Wrapper-success?style=for-the-badge" />
|
||||
<img alt="test262" src="https://img.shields.io/badge/test262-83.34%25-purple?style=for-the-badge" />
|
||||
<img alt="test262" src="https://img.shields.io/badge/test262-78.10%25-purple?style=for-the-badge" />
|
||||
</p>
|
||||
</div>
|
||||
|
||||
@@ -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<KernelCore>` 引用同一份永久共享数据。
|
||||
@@ -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
|
||||
|
||||
@@ -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],
|
||||
|
||||
Reference in New Issue
Block a user