sp replay diff

When agents use this: Deep dive on a failed case — diff bodies, compare JSON. For correlated logs use sp logs.

Subcommands

Subcommand	Description
diff get <diffId>	Base vs test messages (artifact)
compare	Full-link compare result
mock-tree <replayId>	Mock tree for replay
noise query	Query noise rules
noise exclude	Exclude noise (-f + --confirm)
realtime …	Real-time replay queue (see below)

Examples

sp replay diff get diff-abc --out-dir .sp-work --json
sp replay compare --trace-id t1 --replay-id r1 --out-dir .sp-work --json
sp logs --trace-id <trace-id> --since 2026-06-27T10:00:00Z --until 2026-06-27T10:05:00Z --json
sp replay mock-tree replay-uuid --json

JSON output (diff get)

{
  "ok": true,
  "command": "replay diff get",
  "data": {
    "artifact": ".sp-work/diff-abc.json",
    "summary": {
      "diffId": "abc",
      "diffResultCode": 1,
      "categoryName": "ResponseBody"
    }
  }
}

Artifact contains decoded baseMsg and testMsg (JSON when parseable).

REST mapping

Subcommand	Method	Path
diff get	GET	/api/report/queryDiffMsgById/{id}
compare	POST	Schedule /api/compareCase + report APIs
mock-tree	GET	/api/storage/replay-mock-tree/{replayId}
noise query	GET	/api/queryNoise
noise exclude	POST	/api/excludeNoise

Real-time replay

Subcommand	Path
realtime create	POST /api/createRealTimePlan
realtime queue pause <planId>	GET /api/queue/control/pause?planId=... (--confirm)
realtime queue resume <planId>	GET /api/queue/control/resume?planId=... (--confirm)
realtime log	POST /api/realtime/log/query

Replaces sp_api

sp_api	sp
diff_detail	sp replay diff get
compare_result	sp replay compare
replay_log_overview	sp logs --trace-id …
download_replay_logs	sp logs --trace-id … → 落盘后 grep

Related

• Output contract
• Diagnose replay failure