From 1702aa905198d0cd542c6eb6f0c331c3b76979a5 Mon Sep 17 00:00:00 2001
From: pjh456 <147148383@qq.com>
Date: Wed, 16 Sep 2026 19:01:16 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20json=20reviver=20=E6=B3=A8=E9=87=8A?=
 =?UTF-8?q?=E5=8E=BB=E9=87=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 crates/oxide_builtins/src/json.rs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/crates/oxide_builtins/src/json.rs b/crates/oxide_builtins/src/json.rs
index 550b8a58..f8525659 100644
--- a/crates/oxide_builtins/src/json.rs
+++ b/crates/oxide_builtins/src/json.rs
@@ -32,7 +32,8 @@ pub fn json_parse<H: VmHost>(vm: &mut H, args: &[u8]) -> NativeResult {
 
     let mut result = value_to_jsvalue(vm, &parsed);
 
-    // 提供 reviver 时以后序遍历逐属性调用，重建解析后的值。
+    // reviver 遍历以 holder 包装对象为根：解析得到的根值存于空串键槽，
+    // 后序遍历自该槽展开，重建完成后以槽内最终值作为返回值。
     if args.len() > 2 {
         let reviver_val = vm.reg(args[2]);
         if reviver_val.is_object() {