From bf8347d2ea78ebb91e0e1a9db53b80e53b9065a0 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Fri, 21 Aug 2026 10:32:12 +0800
Subject: [PATCH] docs: document Windows launcher workflow (#14)

---
 Local-Development-and-Verification.-.md | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/Local-Development-and-Verification.-.md b/Local-Development-and-Verification.-.md
index adbb0f7..e6fcdc7 100644
--- a/Local-Development-and-Verification.-.md
+++ b/Local-Development-and-Verification.-.md
@@ -134,7 +134,15 @@ go-admin AutoMigrate 不进入以上标准流程。如确需对照固定提交
 MVP-0 不开放注册。使用可重复、不会在日志输出密钥的种子命令建立测试用户、默认 prompt template、Provider 和 ProviderModel。默认先连接 mock HTTP 上游，覆盖文本、图片、429、5xx、超时、连接错误、400、401 和内容策略拒绝。
 
 真实 Provider 的连通性检查只能由操作者明确触发一次低成本请求，并核对审计与冷却；不能作为自动测试或反复调试方式。
-本地 mock 协议服务可单独启动，用于 curl 或协议调试：
+本地 mock 协议服务可单独启动，用于 curl 或协议调试。Windows 推荐通过受管启动脚本运行：
+
+```bat
+scripts\chorus-dev.bat start-mock
+```
+
+脚本默认读取仓库外的 `D:\OPC\chorus-tools\chorus-test.env.ps1`，也可把其他可信环境文件作为带引号的第二个参数传入。`start-mock` 只启动 mock 协议服务，不启动 worker，也不会放宽生产安全 Client 的 SSRF 规则。进程状态与日志保存在 `%LOCALAPPDATA%\Chorus\dev`。
+
+前台调试仍可直接运行：
 
 ```powershell
 $env:CHORUS_MOCK_ADDR = "127.0.0.1:18080"
@@ -147,6 +155,21 @@ go run ./cmd/chorus-mock-provider
 
 ### 5. 启动 portal（MVP-0）
 
+Windows 本地开发优先使用仓库自带脚本：
+
+```bat
+scripts\chorus-dev.bat start
+scripts\chorus-dev.bat status
+scripts\chorus-dev.bat restart
+scripts\chorus-dev.bat stop
+```
+
+`start` 会校验环境文件、本地 MySQL TCP 连接和监听端口，构建临时可执行文件，在后台启动 portal，并检查 `/login`。重复启动不会创建第二个 portal；`restart` 只重启 portal；`stop` 只停止由脚本记录且可执行文件路径匹配的 portal 和 mock 进程。脚本不会执行迁移、GORM AutoMigrate、seed 或创建测试账号。
+
+脚本默认读取仓库外的 `D:\OPC\chorus-tools\chorus-test.env.ps1`；也可把其他可信环境文件作为带引号的第二个参数传入，例如 `scripts\chorus-dev.bat start "D:\tools\chorus local.env.ps1"`。日志、PID 状态和临时可执行文件位于 `%LOCALAPPDATA%\Chorus\dev`。
+
+需要在当前终端观察输出时，仍可运行：
+
 ```powershell
 go run ./portal
 ```