From 9323963dd4e511659d48f2866e34ee6338ba8b13 Mon Sep 17 00:00:00 2001
From: thzxx <1440196015@qq.com>
Date: Mon, 24 Aug 2026 22:07:48 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20dev:web=20=E7=BA=AF=E6=B5=8F=E8=A7=88?=
 =?UTF-8?q?=E5=99=A8=E5=BC=80=E5=8F=91=E9=80=9A=E9=81=93(=E7=BB=95?=
 =?UTF-8?q?=E5=BC=80=20Electron=20=E7=AA=97=E5=8F=A3/Tabbit=20localhost=20?=
 =?UTF-8?q?=E5=8A=AB=E6=8C=81)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

【背景】npm run dev 构建链全绿正常;但用户环境 Tabbit 浏览器后台 node 劫持 localhost 端口段
(5173/5179 全 502)——非我们 dev 故障
【方案】vite.web.config.ts:root=src/renderer+react 插件+port 5179+host 0.0.0.0;
package.json scripts.dev:web=vite --config vite.web.config.ts
【用法】WSL:npm run dev:web → Windows 浏览器:http://<WSL_IP>:5179(设备 localhost 不可用场景)
window.api(导出/导入/MOD 扫描)不存在时自动跳过——其余全功能等价(存档走浏览器 OPFS)
【验证】Windows 侧 curl http://192.168.1.225:5179/ = 200
---
 package.json       |  3 ++-
 vite.web.config.ts | 11 +++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)
 create mode 100644 vite.web.config.ts

diff --git a/package.json b/package.json
index 2f0f913..6af3750 100644
--- a/package.json
+++ b/package.json
@@ -15,7 +15,8 @@
     "package": "npm run build && electron-builder",
     "verify": "node scripts/verify-release.mjs",
     "verify:package": "node scripts/verify-release.mjs --package",
-    "gen:art": "node scripts/gen-art.mjs"
+    "gen:art": "node scripts/gen-art.mjs",
+    "dev:web": "vite --config vite.web.config.ts"
   },
   "dependencies": {
     "@metona-team/metona-sqlark": "0.7.4"
diff --git a/vite.web.config.ts b/vite.web.config.ts
new file mode 100644
index 0000000..f1e03c7
--- /dev/null
+++ b/vite.web.config.ts
@@ -0,0 +1,11 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// 纯浏览器开发调试（无需 Electron 窗口）：
+// npm run dev:web  →  浏览器打开 http://localhost:5173 直接游玩
+// 差异说明：window.api（存档导出/导入、MOD 扫描）不存在时自动跳过——其余全功能等价。
+export default defineConfig({
+  root: 'src/renderer',
+  plugins: [react()],
+  server: { port: 5179, strictPort: true, host: '0.0.0.0' }
+})