fix: 修复 WebUI 源码缺失、环境检测路径及文档说明

- 调整 .gitignore,避免误忽略 webui/src/lib/ 和 webui/src/components/env/
- 补齐 WebUI 缺失的 lib 工具函数、API 封装及环境检测组件
- 修复 /api/env/check 使用相对路径导致启动目录不同时检测失败的问题
- 更新中/英/西三语 README 的 WebUI 开发调试与生产构建说明
This commit is contained in:
程序员阿江(Relakkes)
2026-07-01 23:32:10 +08:00
parent 92c98e658e
commit 076dcba978
9 changed files with 528 additions and 28 deletions
+28 -4
View File
@@ -157,14 +157,38 @@ uv run main.py --help
MediaCrawler proporciona una interfaz de operación visual basada en web, permitiéndole usar fácilmente las funciones del rastreador sin línea de comandos.
#### Iniciar Servicio WebUI
#### Desarrollo (recomendado)
Para el desarrollo, debe iniciar tanto el servicio API backend como el servidor de desarrollo Vite frontend:
```shell
# Iniciar servidor API (puerto predeterminado 8080)
# Terminal 1: iniciar servidor API (puerto predeterminado 8080)
uv run uvicorn api.main:app --port 8080 --reload
# O iniciar usando método de módulo
uv run python -m api.main
# Terminal 2: iniciar servidor de desarrollo frontend
cd webui
npm install
npm run dev # se inicia en el puerto 5173 por defecto y redirige /api a 8080
```
Después de iniciar exitosamente, visite `http://localhost:5173/` para abrir la interfaz WebUI.
> En el primer inicio, se realiza una verificación de entorno (llama a `/api/env/check`), así que asegúrese de que el servicio backend esté en ejecución. Si la verificación falla, puede hacer clic en "Omitir verificación" para omitirla temporalmente.
#### Construir para Producción
Si desea que el servidor API sirva directamente los recursos estáticos de WebUI, construya el frontend primero:
```shell
cd webui
npm install
npm run build # salida en api/webui/
```
Luego inicie solo el servidor API:
```shell
uv run uvicorn api.main:app --port 8080 --reload
```
Después de iniciar exitosamente, visite `http://localhost:8080` para abrir la interfaz WebUI.