fix(devdoc): Windows 合法资源路径 + 本地启动 bat 与说明

- 将误用 Markdown 语法的截图路径重命名为 截图1-占位说明图.png

- 新增 scripts/本地启动.bat；测试 README 补充 Windows 启动方式

- 新增 开发文档/Windows-资源命名与拉取.md

Made-with: Cursor

scripts/test/README.md

@@ -22,7 +22,10 @@ pip install -r requirements-test.txt
 pytest -v
 ```
 
-联调前请先执行 `scripts/本地启动.sh` 启动 soul-api 与 soul-admin。
+联调前请先启动 soul-api 与 soul-admin：
+
+- **macOS / Linux**：`bash scripts/本地启动.sh` 或 `./scripts/本地启动.sh`
+- **Windows**：双击或在仓库根目录执行 `scripts\本地启动.bat`（需已安装 Go、pnpm，且 Windows 10+ 自带 `curl` 用于健康检查）
 
 ---
 

scripts/本地启动.bat

@@ -0,0 +1,30 @@
+@echo off
+setlocal EnableExtensions
+cd /d "%~dp0.."
+set "ROOT=%CD%"
+
+echo ===== 1. 启动 soul-api（端口 8080）=====
+if not exist "%ROOT%\soul-api\soul-api.exe" (
+  echo 未找到 soul-api.exe，正在编译...
+  pushd "%ROOT%\soul-api" || exit /b 1
+  go build -o soul-api.exe .\cmd\server
+  if errorlevel 1 popd & exit /b 1
+  popd
+)
+
+start "soul-api" /B cmd /c "set APP_ENV=development&& set PORT=8080&& cd /d ""%ROOT%\soul-api""&& soul-api.exe"
+echo soul-api 已以后台窗口启动，本脚本继续检查健康状态…
+timeout /t 3 /nobreak >nul
+
+curl -sf http://localhost:8080/health >nul
+if errorlevel 1 (
+  echo soul-api 启动失败，请检查数据库连接与本机是否已安装 Go
+  exit /b 1
+)
+echo soul-api 健康检查通过
+
+echo.
+echo ===== 2. 启动 soul-admin（端口 5174）=====
+echo 访问 http://localhost:5174  默认账号 admin / admin123
+cd /d "%ROOT%\soul-admin" || exit /b 1
+pnpm dev