gyxx-flow/docs/operations.md

日常运维手册

常用命令

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 记录。