hm-webui
Hybrid Mount WebUI（Vue 3 + TS + Vite）开发与后端通信：pnpm 脚本、kernelsu.exec JSON 命令协议、持久化文件与构建注入。
来源信息
- 仓库
- Hybrid-Mount/meta-hybrid_mount
- 最近来源活动
- 2026年9月14日 10:25
- 检测到的 SKILL.md 语言
- 中文
- 星标
- 1,648
- 分支
- 85
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- hm-webui
- description
- Hybrid Mount WebUI（Vue 3 + TS + Vite）开发与后端通信：pnpm 脚本、kernelsu.exec JSON 命令协议、持久化文件与构建注入。
- whenToUse
- 修改 webui/、对接 Rust 二进制命令、调试 WebUI 与控制端通信，或构建 WebUI 产物时。
# WebUI 开发
`webui/` = Vue 3 + TypeScript + Vite，包管理器 pnpm 11.22，Node >= 24（见 `webui/package.json`）。
## 脚本
```bash
cd webui
pnpm install --frozen-lockfile
pnpm dev # vite --host，默认 http://localhost:5173
pnpm build # 构建产物；打包时由 xtask 负责 MODULE_ID 注入
pnpm lint # eslint . && prettier --check .
pnpm lint:fix
pnpm test # vitest run && vue-tsc -b
pnpm typecheck # vue-tsc -b
```
## 与 Rust 后端通信
WebUI 通过管理器提供的 `kernelsu.exec`（`kernelsu` npm 包）调用**同一个** Rust 二进制，
以 JSON 交换数据。命令见 `src/cli.rs`：
| 命令 | 用途 |
| --- | --- |
| show-config | 读取当前配置 |
| save-config | 保存配置（**写入后需重启生效**） |
| gen-config | 生成配置模板 |
| modules | 模块列表快照 |
| status | 运行状态 |
| version | 版本 |
| install-state | 安装状态 |
| clear-mount-errors | 清除挂载错误 |
| emulated-soft-reboot | 模拟软重启（仅 linux/android） |
持久化文件：
- `/data/adb/hybrid-mount/config.toml`
- `/data/adb/hybrid-mount/run/state.json`
- `/data/adb/hybrid-mount/scan.ret`
约定：CLI 的 JSON 只走 stdout，诊断日志走 log/stderr，前端解析不要混入日志行。
## 构建产物与注入
- `cargo xtask build` 会先 `pnpm build`，再通过 Vite 注入 `MODULE_ID`，输出到 `module/webroot`。
- `webui/dist/`、`module/webroot/` 均为生成物，不要手改或提交。
## 修改 WebUI 的推荐流程
1. 改 `webui/src/`；
2. `pnpm lint && pnpm test`；
3. 需要真实交互时 `pnpm dev`，设备侧数据仍来自真机 kernelsu.exec；
4. 最终用 hm-verify 的 WebUI 段验证 lint / test / build。
在 GitHub 查看