diff --git a/crates/oxide_builtins/src/lib.rs b/crates/oxide_builtins/src/lib.rs
index af24ec24..3ea92a92 100644
--- a/crates/oxide_builtins/src/lib.rs
+++ b/crates/oxide_builtins/src/lib.rs
@@ -54,7 +54,7 @@ pub mod reflect;
 pub mod regexp;
 /// Set 内置对象实现（值集合与 entries/values/keys 迭代）。
 pub mod set;
-/// String 内置对象实现（constructor 与全部 String.prototype 方法）。
+/// String 内置对象实现（目录模块：common 共享工具、basic 基础方法、regex 正则与匹配）。
 pub mod string;
 /// 未实现特性的占位 native 实现（统一抛 TypeError）。
 pub mod stubs;
diff --git a/crates/oxide_builtins/src/string/mod.rs b/crates/oxide_builtins/src/string/mod.rs
index 6846c2f1..e5ad2c29 100644
--- a/crates/oxide_builtins/src/string/mod.rs
+++ b/crates/oxide_builtins/src/string/mod.rs
@@ -1,3 +1,8 @@
+//! String 内置对象实现（constructor 与全部 String.prototype 方法）。
+//!
+//! 按职责分 `common` 文本通道、`basic` 基础方法族、`regex` 正则与匹配族，
+//! 三族经本模块 glob 重导出供绑定层与 `regexp` 模块按 `crate::string::` 消费。
+
 mod basic;
 mod common;
 mod regex;