docs: clarify custom WebUI development approach with fork option

2026-05-29 11:56:35 +08:00
parent d607305f9c
commit f954b3946a
1 changed files with 9 additions and 1 deletions
@@ -44,8 +44,16 @@

 ## 开发自定义前端

-你可以使用 React, Vue, Angular 或任何纯静态 HTML/JS 技术来开发自定义的白虎面板前端。
+白虎面板的前端架构是完全解耦的。你可以选择以下两种方式之一来定制专属前端：

+### 方式一：基于现有代码二次开发（推荐）
+如果你只是想修改部分样式、布局，或者在原有功能基础上增加新特性，最简单的方式是 **Fork `baihu-panel` 项目**。
+1. Fork 本项目并克隆代码到本地。
+2. 直接在项目的 `web/` 目录下，对现有的 Vue3 源码进行修改与定制。
+3. 修改完成后，利用项目自带的 Makefile 打包命令（见下方说明）一键将你的修改编译为独立的 WebUI 资源包。
+
+### 方式二：从零开始全新开发
+如果你想用自己熟悉的技术栈（如 React, Angular，或者是纯静态的 HTML/JS）完全重写整个面板，这也是完全支持的！你只需要按照下方的核心规范进行开发和打包即可。
 ### 1. 核心校验规则
 白虎面板后端提取并启用前端资源时，会执行以下强校验：
 1. **压缩包根目录下必须包含 `index.html`**：作为单页应用 (SPA) 的静态入口文件。