diff --git a/crates/oxide_builtins/src/array/common.rs b/crates/oxide_builtins/src/array/common.rs
index c09c5bc4..d0eec36f 100644
--- a/crates/oxide_builtins/src/array/common.rs
+++ b/crates/oxide_builtins/src/array/common.rs
@@ -1,3 +1,5 @@
+//! Array 族共享助手：`this`/类数组解析、长度与回调校验，以及 `array_ptr` 族宏。
+
 use oxide_kernel::shape_forge::EMPTY_SHAPE_ID;
 use oxide_types::object::{JsObject, MAX_DENSE_PROPS};
 use oxide_types::value::JsValue;
diff --git a/crates/oxide_builtins/src/array/element.rs b/crates/oxide_builtins/src/array/element.rs
index 5f2ccfb5..c97432a2 100644
--- a/crates/oxide_builtins/src/array/element.rs
+++ b/crates/oxide_builtins/src/array/element.rs
@@ -1,3 +1,5 @@
+//! Array 元素变更与查找方法（push/pop/slice/splice/concat/join/indexOf 等）。
+
 use oxide_types::object::JsObject;
 use oxide_types::value::JsValue;
 
diff --git a/crates/oxide_builtins/src/array/from.rs b/crates/oxide_builtins/src/array/from.rs
index cb361fac..ec345e81 100644
--- a/crates/oxide_builtins/src/array/from.rs
+++ b/crates/oxide_builtins/src/array/from.rs
@@ -1,3 +1,5 @@
+//! Array 构造器与静态方法（constructor / isArray / of / from）及 species 构造辅助。
+
 use oxide_kernel::shape_forge::EMPTY_SHAPE_ID;
 use oxide_types::object::{JsObject, PropAttributes, MAX_DENSE_PROPS};
 use oxide_types::private_key::make_well_known_symbol_key;
diff --git a/crates/oxide_builtins/src/array/immutable.rs b/crates/oxide_builtins/src/array/immutable.rs
index 04635a07..c3b092b9 100644
--- a/crates/oxide_builtins/src/array/immutable.rs
+++ b/crates/oxide_builtins/src/array/immutable.rs
@@ -1,3 +1,5 @@
+//! Array ES2023 不可变方法族（toReversed/with/toSorted/toSpliced）。
+
 use oxide_types::value::JsValue;
 
 use oxide_runtime_api::{NativeResult, VmHost};
diff --git a/crates/oxide_builtins/src/array/iterate.rs b/crates/oxide_builtins/src/array/iterate.rs
index 449c8091..ad4aec1a 100644
--- a/crates/oxide_builtins/src/array/iterate.rs
+++ b/crates/oxide_builtins/src/array/iterate.rs
@@ -1,3 +1,5 @@
+//! Array 高阶迭代方法（for_each/map/filter/reduce/find/some/every/flatMap 等）。
+
 use oxide_types::value::JsValue;
 
 use oxide_runtime_api::{NativeResult, VmHost};
diff --git a/crates/oxide_builtins/src/array/mod.rs b/crates/oxide_builtins/src/array/mod.rs
index 52e2f0f4..cd540116 100644
--- a/crates/oxide_builtins/src/array/mod.rs
+++ b/crates/oxide_builtins/src/array/mod.rs
@@ -1,3 +1,8 @@
+//! Array 内置对象实现（constructor、静态方法与全部 Array.prototype 方法）。
+//!
+//! 按职责分 `common` 共享助手（含 `array_ptr` 族宏）、`from` 构造器与静态方法、`element` 元素变更与查找、
+//! `iterate` 高阶迭代、`sort_iterator` 排序与迭代协议、`immutable` ES2023 不可变方法族；各族经本模块重导出。
+
 mod common;
 pub(crate) use common::*;
 
diff --git a/crates/oxide_builtins/src/array/sort_iterator.rs b/crates/oxide_builtins/src/array/sort_iterator.rs
index 07e68793..d7168463 100644
--- a/crates/oxide_builtins/src/array/sort_iterator.rs
+++ b/crates/oxide_builtins/src/array/sort_iterator.rs
@@ -1,3 +1,5 @@
+//! Array 排序方法与迭代协议（sort/values/entries/keys/iterator_next 及迭代器构造）。
+
 use oxide_kernel::shape_forge::EMPTY_SHAPE_ID;
 use oxide_types::object::JsObject;
 use oxide_types::value::JsValue;
diff --git a/crates/oxide_builtins/src/lib.rs b/crates/oxide_builtins/src/lib.rs
index 3ea92a92..18ea5708 100644
--- a/crates/oxide_builtins/src/lib.rs
+++ b/crates/oxide_builtins/src/lib.rs
@@ -8,7 +8,7 @@
 //! 架构性延后的特性（Proxy、WeakMap、WeakSet、WeakRef、FinalizationRegistry、
 //! SharedArrayBuffer、Atomics）在 `stubs` 中仅提供占位实现，调用时抛 TypeError。
 
-/// Array 内置对象实现（constructor 与全部 Array.prototype 方法）。
+/// Array 内置对象实现（目录模块：common 共享助手、from 构造器与静态方法、element 元素变更、iterate 高阶迭代、sort_iterator 排序与迭代协议、immutable ES2023 不可变方法族）。
 pub mod array;
 /// ArrayBuffer 内置对象实现（字节缓冲区与 byteLength/slice/isView）。
 pub mod array_buffer;