From 9da825e845c658de5d5b620fa4c6b422709ccd1e Mon Sep 17 00:00:00 2001
From: pjh456 <147148383@qq.com>
Date: Sat, 26 Sep 2026 09:49:36 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=AD=A3=20test262=20?=
 =?UTF-8?q?=E5=85=A8=E9=87=8F=E7=A4=BA=E4=BE=8B=E4=B8=BA=E7=9B=91=E7=9D=A3?=
 =?UTF-8?q?=E5=BC=8F=E5=B9=B6=E8=A1=A5=E6=97=A5=E5=B8=B8=E5=BE=AA=E7=8E=AF?=
 =?UTF-8?q?=E6=8C=87=E5=BC=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 37 ++++++++++++++++++++++++++++---------
 1 file changed, 28 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index cd8d9b71..3fff48aa 100644
--- a/README.md
+++ b/README.md
@@ -128,20 +128,29 @@ project-root/
     └── test262/           # 本地 test262 测试套件
 ```
 
-## 5. 构建
+## 5. 构建与日常验证
 
 ### 构建全部 crate
 
 ```bash
-cargo build --release
+cargo build --workspace
 ```
 
-### 运行单元测试
+### 按 crate 运行单元测试
 
 ```bash
-cargo test
+cargo test -p <crate>
 ```
 
+### 格式与 lint 自查
+
+```bash
+cargo fmt --all -- --check
+cargo clippy --all-targets
+```
+
+验收口径：构建通过、单测通过、零新增 clippy 告警。test262 子集回测与全量回测命令见第 7 节。
+
 ## 6. CLI 使用
 
 ### 执行源码片段
@@ -170,18 +179,29 @@ cargo run --release -p oxide_cli
 
 ## 7. test262 兼容性测试
 
-OxideJS 包含独立的 test262 runner：
+OxideJS 包含独立的 test262 runner，套件位于 `tests/test262`（git 子模块）。
+
+### 运行子集（日常）
 
 ```bash
-cargo run --release -p oxide_test262
+# 按目录筛选
+cargo run -p oxide_test262 -- tests/test262/test/language/expressions/addition
+
+# 按路径关键词筛选
+cargo run -p oxide_test262 -- tests/test262/test "literals/string"
 ```
 
-运行指定子目录：
+### 全量运行（监督式）
 
 ```bash
-cargo run --release -p oxide_test262 -- tests/test262/test language/expressions
+OXIDE_TEST262_SUPERVISORS=16 OXIDE_TEST262_WINDOW=3300 \
+  cargo run -p oxide_test262 -- --supervise tests/test262/test
 ```
 
+- `--supervise` 为单 worker 子进程窗口模式，带单测超时与断点续跑；并发窗口数缺省 16（`OXIDE_TEST262_SUPERVISORS`）；
+- `--supervise` 可与位置参数路径筛选组合（筛选在子进程窗口内逐测试生效）；
+- 含 `built-ins/` 的回测必须加 `--supervise`：非监督模式无单测超时，单个测试可无界增长拖死宿主。
+
 runner 会输出：
 
 - 发现的测试文件总数；
@@ -189,7 +209,6 @@ runner 会输出：
 - 全量通过率；
 - 实际执行样本通过率；
 - 失败类别统计与 FAIL 清单（按测试文件路径）；
-- 监督式窗口运行（`--supervise`）：心跳文件断点续跑、单测超时判定；
 - 按目录拆分的结果（取决于 runner 版本）。
 
 兼容性数字属于开发过程指标。发布正式 benchmark 或兼容性结论前，应基于当前 checkout 的 test262 版本重新生成结果。