本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 7.24.4 · SDK 2.6.7。英文原文

執行證據

狀態：現行範圍：現行狀態上次審閱：2026-08-25 負責人：AX Code runtime

每一個 AX Code 工作階段都會在執行時被記錄。本頁說明把該記錄變成可審閱、比較、匯出與還原的指令。

代理程式結束後，若你需要回答：它做了什麼、風險有多高、與另一次嘗試相比如何，以及如何回到原狀，就使用本頁。

記錄了什麼

執行期間，AX Code 會寫入兩件各自獨立的東西：

有型別的事件日誌 — 路由決策、模型活動、步驟邊界、工具呼叫與工具結果。這是 graph、replay、compare、trace 與 audit 的來源。
檔案快照 — 擷取到位於你的儲存庫之外、AX Code 資料目錄下的 Git 物件存放區，使用 refs/snapshots/<hash>。你的工作樹與專案的 .git/ 不會為了存放它們而被修改。

兩者都在本機。不會上傳任何東西。

重建一次執行

ax-code graph <sessionID>

把工作階段重建為執行圖：持續時間、風險摘要、token 數、使用的代理程式，以及每一步及其工具呼叫與計時。

## Session ses_01H8XK

Duration: 9m 54s | Risk: HIGH (53/100) | Tokens: 167,650 in / 18,494 out
Agents: architect

### Step 1 (8s) | tokens: 12263/587

- read: api.ts → ok (5ms)
- grep: rateLimit → ok (12ms)

--format 會選擇替代輸出，包括 Mermaid 與拓撲檢視，供你在其他工具中使用該圖。

請注意，這是工作階段執行圖——代理程式做了什麼。它不是儲存庫程式碼圖；那是 ax-code index 與程式碼智慧層。

比較兩次執行

ax-code session compare <sessionA> <sessionB>
ax-code session compare <sessionA> <sessionB> --deep

報告風險差、變更的檔案、工具失敗次數、每次執行採取的決策路徑，以及各事件類型的計數。--deep 透過重播比較加入步驟層級的分歧分析。

這比較的是執行，不是原始碼。它回答「第二次嘗試得分較差——它在哪裡分歧」，而不是「給我看程式碼 diff」。

典型用途是為同一項工作在兩種策略之間做決定：

  Risk Comparison
  ----------------------------------------
  Score: 53 → 93 (+40) ↑
  Level: HIGH → CRITICAL
  Files: 8 → 25
  Failures: 0 → 15

檢查已記錄的事件日誌

ax-code session replay <sessionID> --mode summary
ax-code session replay <sessionID> --mode verify
ax-code session replay <sessionID> --mode reconstruct
ax-code session replay <sessionID> --mode export

verify 檢查已記錄日誌的一致性。reconstruct 從事件重建步驟串流。export 寫出可攜的重播套件。

**重播是重建；它不會重新執行。**它不會重跑模型、重新叫用工具，或重現外部狀態。execute 模式會準備重建的串流，供程式化地與原始串流比較，用意是測試，不是重新執行工作。

閱讀風險訊號

ax-code risk <sessionID>
ax-code risk <sessionID> --explain
ax-code risk <sessionID> --json

分數是從已記錄訊號導出的決定性啟發式：包括變更了多少檔案、變更是否跨越多個頂層區域、多少工具呼叫失敗、是否執行了驗證、是否存在 diff 快照、受影響的 API 表面有多大、執行如何結束（被阻擋的完成閘門，或步驟上限／停滯的結束，兩者都會加權），以及是否碰觸了對安全性敏感的路徑。每一個有貢獻的驅動因素都會連同權重列出，並附建議的緩解。

它是審閱輔助。它不是機率、校正過的信心，或程式碼安全的陳述。未驗證變更上的 LOW 分數仍然表示該變更未經驗證。

精確還原

檔案快照可在 Git 儲存庫與一般專案目錄中運作，前提是已安裝 Git 且 snapshot 已啟用。AX Code 把快照 Git 存放區放在你的專案之外；它不會建立專案 .git 目錄。忽略規則與不支援路徑的排除仍然適用。

TUI Revert 會還原訊息與已擷取的檔案變更。使用 snapshot: false 時，或對於從未擷取基線的較舊回合，它只能還原訊息；檔案編輯仍留在磁碟上。現在啟用快照不能重建較早的檔案內容。已擷取但沒有檔案變更的回合也沒有可還原的內容。

ax-code session rollback <sessionID> --list      # show recoverable points
ax-code session rollback <sessionID> --dry-run   # show what would change
ax-code session rollback <sessionID> --step 4    # restore one step
ax-code session rollback <sessionID>             # restore the whole session

--list 結合持久的步驟事件與執行圖細節，因此你可以針對特定步驟，而不是還原整次執行。--dry-run 使用與套用相同的回滾規劃器，並列出檔案帳本有貢獻於結果的任何受委派工作階段。

當巢狀子工作階段寫入父層的確切工作目錄時，回滾會跟著它們。它會還原邊界之後的檔案變更，同時保留它們的逐字稿。在另一個工作樹或目錄中執行的後代會被排除；若任何被納入的工作階段仍在執行，回滾會以失敗關閉。

**在依賴它之前值得知道的邊界：**回滾從執行期間取得的快照還原。從未被快照的檔案——因為它在工作階段之外被變更，或當時不處於可回復狀態——不能用這個方式還原。對任何重要的東西，請先使用 --dry-run。

嘗試不同策略

ax-code session branch <sessionID>
ax-code session branch <sessionID> --from <messageID>

分叉工作階段已儲存的狀態，使第二次嘗試從選定的點開始，而不是從頭開始。

這分叉的是工作階段狀態——訊息與目標。它不是 Git 分支，也不是工作樹。若要隔離的 Git 候選，請見已驗證的多模型變更。

診斷

ax-code session trace <sessionID>
ax-code session trace <sessionID> --logs

以重播為後盾的診斷，帶有風險評分的時間軸。--logs 改用舊有的日誌檔分析，而不是重播事件；當你在調查營運問題、而不是審閱變更時，這很有用。

匯出證據

ax-code audit export --all --since 2026-08-01     # JSON Lines
ax-code audit export --all --risk HIGH            # filter by minimum risk
ax-code audit report <sessionID>                  # Markdown report
ax-code audit otlp <sessionID>                    # OpenTelemetry spans
ax-code audit prune --days 90                     # delete old events

JSONL 與 OTLP 讓執行記錄可以被你自己的審閱或可觀測性管線使用。Markdown 報告是給人看的，用來把證據附在 PR 或變更記錄上。

瀏覽

ax-code run-report                 # latest session
ax-code run-report --index         # session index

在瀏覽器中開啟本機執行報告，包含執行摘要、時間軸、變更、驗證狀態、風險細節、分支資訊與回滾點。伺服器只綁定迴路。

目標保證 — 長目標的可執行接受檢查與來源新鮮度
為何選擇 AX Code — 這層證據的用途
已驗證的多模型變更 — 產生值得比較的候選
語意層 — 圖與 LSP 回答上的來源信封
執行報告 — 工作區層級檢視與各工作階段報告