Prechádzať zdrojové kódy

docs:统一第三阶段启动方式

yangxiaolong 1 mesiac pred
rodič
commit
8ae4296455
1 zmenil súbory, kde vykonal 10 pridanie a 20 odobranie
  1. 10 20
      README.md

+ 10 - 20
README.md

@@ -109,9 +109,15 @@ macOS / Linux:
 ./scripts/dev.sh
 ```
 
-启动脚本会检查端口、启动前后端、等待三个服务全部就绪,并在退出时统一清理子进程。
+这是第三阶段唯一需要执行的日常启动命令。启动脚本会统一完成以下工作:
 
-`zbt-serve` 是跨平台后端主管进程,会分别启动 FastAPI 和退款 Worker。正常情况下不需要再执行 `zbt-refund-worker`。
+- 启动 H5;
+- 启动管理后台;
+- 启动 FastAPI;
+- 启动并监管退款 Worker;
+- 等待所有服务就绪,并在退出时统一清理子进程。
+
+不需要另外启动退款 Worker,也不要在 `dev.ps1` 或 `dev.sh` 运行期间重复启动 Worker。
 
 运行地址:
 
@@ -126,25 +132,9 @@ macOS / Linux:
 - 运营人员:`operator01 / zaq1XSW@`
 - 审核人员:`reviewer01 / zaq1XSW@`
 
-## 退款 Worker
-
-退款涉及资金副作用,因此 Worker 默认启用 Redis 单实例锁,避免本地误启动多个主动执行者。`zbt-serve` 启动后会同时监管 API 和 Worker;任一进程异常退出时,主管进程会停止另一个进程,避免后端处于部分可用状态。
-
-只有调试 Worker 时才单独运行:
-
-Windows PowerShell:
-
-```powershell
-.\scripts\run-refund-worker.ps1
-```
-
-macOS / Linux:
-
-```bash
-./scripts/run-refund-worker.sh
-```
+## 退款 Worker 运行说明
 
-如果已有 Worker 持有单实例锁,新进程会进入待命或退出,不能同时领取退款任务。管理端“退保工作台”可以查看 Worker 在线状态、退款尝试和失败原因。
+退款涉及资金副作用,因此 Worker 默认启用 Redis 单实例锁,避免多个主动执行者重复领取任务。统一启动命令会通过 `zbt-serve` 同时监管 FastAPI 和 Worker;任一进程异常退出时,主管进程会停止另一个进程,避免后端处于部分可用状态。管理端“退保工作台”可以查看 Worker 在线状态、退款尝试和失败原因。
 
 ## LangSmith