docs: document Windows launcher workflow (#14)

ila
2026-08-21 10:32:12 +08:00
parent 51c1fd8470
commit bf8347d2ea
+24 -1
@@ -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
```