docs: update README for 16-module architecture

- Sync directory tree with new th_01 ~ th_16 file listing
- Update module descriptions and line counts
- Update load order and manifest count (5 -> 16)
- Update deployment notes
This commit is contained in:
root
2026-04-20 12:11:11 +08:00
parent c7e9b92322
commit e375f7d7ba

View File

@@ -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 提示拆分