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' }
+})