# 日常运维手册

## 常用命令

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