From 9c8e6a85e1afa31130d36532e8f6fa36a7465131 Mon Sep 17 00:00:00 2001
From: pjh456 <147148383@qq.com>
Date: Wed, 16 Sep 2026 19:47:21 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=A2=E7=8A=B6=E6=A8=A1=E5=9D=97?=
 =?UTF-8?q?=E4=BD=BF=E7=94=A8=E8=8C=83=E5=9B=B4=E8=AF=B4=E6=98=8E=E4=B8=8E?=
 =?UTF-8?q?=20crate=20=E5=A4=B4=E4=B8=AD=E6=96=87=E5=8C=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 crates/oxide_types/src/lib.rs   | 2 +-
 crates/oxide_types/src/shape.rs | 7 +++++--
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/crates/oxide_types/src/lib.rs b/crates/oxide_types/src/lib.rs
index 531262fe..30b6df23 100644
--- a/crates/oxide_types/src/lib.rs
+++ b/crates/oxide_types/src/lib.rs
@@ -1,4 +1,4 @@
-#![doc = "OxideJS - Shared core types (JsValue, JsObject, Shape, P, Epoch)"]
+#![doc = "OxideJS 共享核心类型：ECMAScript 值、对象模型、形状存储、内存抽象与运行时错误类型。"]
 
 /// 运行时错误类型（[`JsError`] / [`JsErrorKind`]）。
 pub mod error;
diff --git a/crates/oxide_types/src/shape.rs b/crates/oxide_types/src/shape.rs
index 7b5d6739..3988ac69 100644
--- a/crates/oxide_types/src/shape.rs
+++ b/crates/oxide_types/src/shape.rs
@@ -2,8 +2,11 @@
 //!
 //! 形状表是对象属性布局的可共享描述：每次往对象添加一个命名属性就沿链增长一个
 //! shape。形状按 `(parent_id, prop_name)` 哈希一致化（hash-cons），使结构相同的
-//! 对象共享同一 shape，从而支持属性位置缓存（inline cache）。全局单例
-//! `SHAPE_STORE` 以互斥锁保护，见 `get_shape` 等自由函数。
+//! 对象共享同一 shape，从而支持属性位置缓存（inline cache）。
+//!
+//! 使用范围：本模块仅 `EMPTY_SHAPE_ID` 常量被外部引用（如 `oxide_runtime_api`）；
+//! `SHAPE_STORE` 全局单例与 `get_shape` 等自由函数目前仅本模块测试使用，运行时
+//! 跨 VM 共享的形状存储是 `oxide_kernel::shape_forge::ShapeForge`。
 
 use std::sync::{Arc, Mutex, OnceLock};