hm-webui
Hybrid Mount WebUI（Vue 3 + TS + Vite）开发与后端通信：pnpm 脚本、kernelsu.exec JSON 命令协议、持久化文件与构建注入。
Informações da origem
- Repositório
- Hybrid-Mount/meta-hybrid_mount
- Última atividade na origem
- 14 de setembro de 2026 às 10:25
- Idioma detectado do SKILL.md
- chinês
- Estrelas
- 1.648
- Forks
- 85
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- 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。
Ver no GitHub