企业官网建设流程全解析

Hybrid Mount 是一款面向 KernelSU 与 APatch 的混合挂载元模块，可在开机时为每个模块自动选择 OverlayFS、Magic Mount 或 VFS 后端。它的 WebUI 内置 MD3（Material Design 3，默认）与 Miuix 两套完整界面，让你无需编辑配置文件，就能查看挂载状态、调整默认策略、为单个模块和路径定制规则。本文将用 8 个核心操作带你快速上手这个双主题控制台。

先认识一下：WebUI 里的 4 个标签页 🧭

打开 Hybrid Mount 模块的 WebUI 后，你会看到底部导航栏的 4 个页面：状态、配置、模块、关于（对应 webui/src/ui/md3/App.vue 中注册的 4 个页面）。两个界面共享同一套数据逻辑，只有"皮肤"不同：

• MD3 界面：webui/src/ui/md3/，默认启用，顶部标题栏 + 底部图标导航，卡片式布局；
• Miuix 界面：webui/src/ui/miuix/，小米风格的 TopBar + 底部导航，支持 Monet 取色。

两套界面都支持左右滑动切页，滑动距离超过阈值即翻页，边缘还带阻尼手感，逻辑统一在 webui/src/ui/useSwipePager.ts 中实现。

8 个核心操作，一次玩明白 👇

操作 1：刷新并查看挂载状态总览

进入"状态"页，页面会自动加载设备信息。你可以看到：

• 后端策略：本次启动实际使用的挂载后端（Overlay / Magic / VFS 组合）；
• 模式占比条：三种后端各自挂载的模块数与挂载点数量；
• 系统详情：机型、Android 版本、内核版本、SELinux 状态，以及当前活动挂载点列表。

数据加载失败时，页面顶部的错误横幅会明确提示原因，而不是显示过期数字（见 webui/src/ui/md3/pages/status.vue）。

操作 2：读懂"后端策略"，确认本次启动是否正常

状态页最醒目的卡片是后端策略。如果你只想快速体检，看这一项即可：它列出本次启动真正生效的后端，并配合下方占比条核对模块分布。若顶部出现"出现问题"横幅，说明某个启动步骤未按预期完成，按提示结合模块页日志排查后点击刷新即可。

操作 3：一键切换 MD3 与 Miuix 界面 🎨

在"配置"页顶部的WebUI 卡片里，选择UI 风格：Material Design 3 或 Miuix，切换即时生效，无需重启（实现见 webui/src/lib/stores/uiStore.ts）。你的选择会被记住，下次打开自动沿用。喜欢干净克制的选 MD3，偏爱小米风质感与动态取色的选 Miuix。

操作 4：切换界面语言

同一张卡片中的语言下拉框支持 13 种语言，包括简体中文、繁體中文、English、日本語、Русский 等，词表文件位于 webui/src/locales/。切换后所有按钮、提示与错误信息即时翻译。

操作 5：修改全局默认挂载策略

"配置"页的主体是全局设置：

这里只决定"没有专门规则的模块"走哪条路线；单个模块和路径仍可在模块页单独指定，路径规则 > 模块规则 > 全局默认。

操作 6：为单个模块和路径定制规则 📁

"模块"页是精细调度的主战场（见 webui/src/ui/md3/pages/modules.vue）：

1. 用顶部搜索框按名称、ID 或作者过滤，或用筛选器只看已挂载 / 某后端的模块；
2. 点击模块卡片展开，先选模块级默认模式（继承、Overlay、Magic、VFS、忽略）；
3. 在"路径"区域添加路径级规则，例如把某个模块的system/etc/hosts单独指定为 Overlay；
4. 点击保存，规则即写入配置（对应 module/config.toml 的 rules 段）。

若某模块挂载失败，卡片会显示错误信息；顶部出现失败横幅时可一键清空错误标记。

操作 7：运行时加载、重载或卸载模块 ⚡

展开模块卡片后，最上方就是运行时控制区（MD3 实现见 webui/src/ui/md3/components/Md3RuntimeControls.vue）：

• 模块未激活：点击"加载"立即挂载，不用等重启；
• 模块已激活：可"重载"应用修改，或"卸载"临时下线；
• 状态圆点实时显示激活/未激活，执行中会显示忙碌提示。

这是调整规则后立刻验证效果的最快方式。

操作 8：保存配置并重启生效 🔄

改完配置后，回到"配置"页点击右下角保存（出错会有 Toast 提示）。由于全局规则在开机管线中生效，建议最后一步：点击状态页或顶栏的重启按钮，确认对话框后设备重启，所有修改即刻生效。

"配置"页还提供重置按钮，可一键恢复出厂默认配置，改乱了也不怕。

关于页：顺手做一次健康自检 🔍

"关于"页（webui/src/ui/md3/pages/info.vue）展示版本号和一组安装状态自检项：二进制、Overlay 支持、tmpfs 支持、VFS 支持及其来源（LKM / 内核内置）、sysfs 隐藏能力等，均以 ✓/✗ 直观呈现。排查"某个后端选项为什么没出现"时，先来这里看。

写在最后

Hybrid Mount WebUI 的价值在于把原本要手改 TOML 的混合挂载配置，变成了"状态总览 → 调策略 → 定规则 → 重启生效"的可视化闭环；MD3 与 Miuix 双界面则让不同审美偏好的用户都能获得一致的操作体验。8 个操作掌握后，你可以完全脱离配置文件管理你的模块挂载。更多架构细节可参阅 docs/ARCHITECTURE.md 与 docs/RUNTIME.md。