30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# 日常运维手册
|
|
|
|
## 常用命令
|
|
|
|
```powershell
|
|
gyxx list --json
|
|
gyxx scripts list --json
|
|
gyxx doctor --json
|
|
gyxx acceptance status --json
|
|
gyxx run shop.metrics.weekly --date 2026-07-27
|
|
gyxx backfill shop.metrics.weekly --from 2026-07-21 --to 2026-07-27
|
|
gyxx scripts run shop_intelligence:runners/run_shop.py --date 2026-07-27
|
|
```
|
|
|
|
`run`、`backfill`、`scripts run` 默认 dry-run。`--execute` 才启动本地迁入脚本；
|
|
Task Scheduler 使用 `--scheduled`，按 Asia/Shanghai 当日执行。
|
|
|
|
## 数据与证据
|
|
|
|
- `var/runs/.../<run_id>/run.json`：步骤、尝试、退出码和 trace
|
|
- `var/state/ops/run-index/`：按 run_id/workflow/date/status 查询
|
|
- `var/state/ops/effects/`：生产 Sink 幂等回执
|
|
- `var/state/ops/outbox/messages/`：外部写入消息
|
|
- `var/logs/`、`var/data/evidence/`：日志和截图证据
|
|
- `var/state/profiles/`：浏览器 Profile
|
|
- `var/state/locks/`：工作流、Profile 和共享资源锁
|
|
|
|
effect 为 `ambiguous` 或长时间 `in_progress` 时，先人工核对外部系统；不要删除回执
|
|
或强制重跑。手工脚本执行同样会产生统一 run journal 和 effect 记录。
|