diff --git a/README.md b/README.md
index 19769d2..5e68a7a 100644
--- a/README.md
+++ b/README.md
@@ -11,11 +11,22 @@
 shortx.getShortXDir()/
 ├── ToolHub/
 │   └── code/
-│       ├── th_1_base.js
-│       ├── th_2_core.js
-│       ├── th_3_panels.js
-│       ├── th_4_extra.js
-│       └── th_5_entry.js
+│       ├── th_01_base.js
+│       ├── th_02_core.js
+│       ├── th_03_icon.js
+│       ├── th_04_theme.js
+│       ├── th_05_persistence.js
+│       ├── th_06_icon_parser.js
+│       ├── th_07_shortcut.js
+│       ├── th_08_content.js
+│       ├── th_09_animation.js
+│       ├── th_10_shell.js
+│       ├── th_11_action.js
+│       ├── th_12_rebuild.js
+│       ├── th_13_panel_ui.js
+│       ├── th_14_panels.js
+│       ├── th_15_extra.js
+│       └── th_16_entry.js
 └── ToolHub/logs/
     └── init.log
 ```
@@ -25,11 +36,22 @@ shortx.getShortXDir()/
 ToolHub/
 ├── ToolHub.js          # 入口文件（粘贴到 ShortX 任务）
 └── code/
-    ├── th_1_base.js
-    ├── th_2_core.js
-    ├── th_3_panels.js
-    ├── th_4_extra.js
-    └── th_5_entry.js
+    ├── th_01_base.js
+    ├── th_02_core.js
+    ├── th_03_icon.js
+    ├── th_04_theme.js
+    ├── th_05_persistence.js
+    ├── th_06_icon_parser.js
+    ├── th_07_shortcut.js
+    ├── th_08_content.js
+    ├── th_09_animation.js
+    ├── th_10_shell.js
+    ├── th_11_action.js
+    ├── th_12_rebuild.js
+    ├── th_13_panel_ui.js
+    ├── th_14_panels.js
+    ├── th_15_extra.js
+    └── th_16_entry.js
 ```
 
 ---
@@ -72,7 +94,7 @@ chown 1000:1000 ToolHub/code
 
 入口文件启动时会自动完成以下操作：
 
-1. **缺失自检**：检查 `ToolHub/code/` 下的 5 个模块文件，缺失则从 git raw URL 自动下载
+1. **缺失自检**：检查 `ToolHub/code/` 下的 16 个模块文件，缺失则从 git raw URL 自动下载
 2. **权限保障**：目录不存在时自动创建并设置 `chmod 700` + `chown 1000:1000`
 3. **权限判断**：通过 `stat` 命令精确检查 uid/gid/mode，不正确才修复
 4. **单次检查**：一次启动中只检查一次目录权限，避免重复 shell 开销
@@ -135,18 +157,29 @@ am broadcast -a shortx.wm.floatball.CLOSE
 
 | 文件 | 职责 | 线数参考 |
 |------|------|---------|
-| `th_1_base.js` | 基础工具函数、Logger、崩溃处理、进程信息获取 | ~1300 |
-| `th_2_core.js` | 浮窗管理器、Shell 执行器、ContentProvider 读取器、图标缓存 | ~4700 |
-| `th_3_panels.js` | 面板配置工厂、按钮构建器、对话框、文本查看器 | ~2900 |
-| `th_4_extra.js` | 额外面板：设备信息、网络状态、快捷操作 | ~1600 |
-| `th_5_entry.js` | 入口面板定义、广播接收器注册、启动流程 | ~300 |
+| `th_01_base.js` | 基础工具函数、Logger、崩溃处理、进程信息获取 | ~1300 |
+| `th_02_core.js` | FloatBallAppWM 构造函数、基础工具方法（dp/now/clamp） | ~124 |
+| `th_03_icon.js` | 图标缓存/LRU、悬浮球图标加载（PNG 文件） | ~170 |
+| `th_04_theme.js` | 屏幕/旋转、UI 样式辅助、莫奈动态取色、主题检测 | ~800 |
+| `th_05_persistence.js` | 面板/位置/配置持久化、设置面板 schema 与编辑缓存 | ~298 |
+| `th_06_icon_parser.js` | 快捷方式图标解析、resolveIconDrawable、图标文件路径 | ~485 |
+| `th_07_shortcut.js` | 内置快捷方式选择器（合并 shortcuts.js）、分组过滤 | ~1175 |
+| `th_08_content.js` | ContentProvider URI 解析、通用 query、统一入口 | ~209 |
+| `th_09_animation.js` | 动画/视图管理、吸边停靠、屏幕监控、重建悬浮球 | ~662 |
+| `th_10_shell.js` | Shell 智能执行（Action 优先 + 广播桥兜底） | ~33 |
+| `th_11_action.js` | 按钮动作执行（点击/长按/双击） | ~320 |
+| `th_12_rebuild.js` | 改大小后安全重建悬浮球 | ~76 |
+| `th_13_panel_ui.js` | 设置面板 UI 组件（SectionHeader、SettingItemView 等） | ~375 |
+| `th_14_panels.js` | 面板配置工厂、按钮构建器、对话框、文本查看器 | ~2957 |
+| `th_15_extra.js` | 额外面板：设备信息、网络状态、快捷操作 | ~1598 |
+| `th_16_entry.js` | 入口面板定义、广播接收器注册、启动流程 | ~324 |
 
 ---
 
 ## 模块加载容错
 
-- `for` 循环加载 5 个模块，单模块失败记录日志但不阻断后续加载
-- `th_5_entry.js` 失败时直接抛异常（启动必备）
+- `for` 循环加载 16 个模块，单模块失败记录日志但不阻断后续加载
+- `th_16_entry.js` 失败时直接抛异常（启动必备）
 - 错误信息落盘到 `ToolHub/logs/init.log`，便于实机排查
 
 ---
@@ -154,6 +187,6 @@ am broadcast -a shortx.wm.floatball.CLOSE
 ## 注意事项
 
 - 入口文件通过 `loadScript()` 动态加载子模块，`var` 声明通过间接 `eval` 挂到全局作用域
-- 子模块加载顺序不可更改：base → core → panels → extra → entry
+- 子模块加载顺序不可更改：base → core → icon → theme → persistence → icon_parser → shortcut → content → animation → shell → action → rebuild → panel_ui → panels → extra → entry
 - 调试请查看日志文件，不通过返回 JSON 暴露内部细节
 - 单个模块建议不超过 200KB，超过时启动日志会记录 WARN 提示拆分