From f954b3946a333c9ba64722e5eba2e8a74f6d7298 Mon Sep 17 00:00:00 2001
From: duorameng <2997944583@qq.com>
Date: Fri, 29 May 2026 11:56:35 +0800
Subject: [PATCH] docs: clarify custom WebUI development approach with fork
 option

---
 docs/guide/webui.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/guide/webui.md b/docs/guide/webui.md
index 875c7f2..aca2f2c 100644
--- a/docs/guide/webui.md
+++ b/docs/guide/webui.md
@@ -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) 的静态入口文件。