binance-api/docs/ops/RUNBOOK.md

运行手册（pm2/启动参数/回滚/健康检查）

— 准备 —

• Node 18+、pnpm/yarn、pm2；
• .env（见 docs/accounts/ENV_VARS.md）。

— 启动（示例） —

pm2 start --name pacifica-smoke --interpreter node -- tsx examples/pacifica_test.ts
pm2 start --name pacifica-ws   --interpreter node -- tsx examples/pacifica_ws_example.ts
pm2 start --name aster-order   --interpreter node -- tsx examples/aster_order_test.ts

— 常用命令 —

pm2 logs pacifica-ws --lines 200
pm2 restart pacifica-ws
pm2 delete pacifica-ws
pm2 save && pm2 startup   # 自启动

— 环境与参数 —

• 通过 .env + pm2 ecosystem 文件管理；必要参数见各接入文档与 ENV_VARS.md。

— 健康检查 —

• WS：每 30s ping；无 pong/连接断开即重启（可用 pm2 的重启策略）。
• REST：周期探针（如 orderbook/info），失败计数超阈触发告警与重启。

— 回滚与灰度 —

• 版本标记（Git tag/commit）；
• 新脚本先以独立 pm2 进程灰度；稳定后替换主进程；
• 保留上一个稳定版本的 pm2 进程文件。

— 日志与脱敏 —

• 仅打印签名前缀与订单摘要；
• 禁止输出完整私钥/签名/Headers。