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:
71
README.md
71
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 提示拆分
|
||||
|
||||
Reference in New Issue
Block a user