本卡屬 FR-188（母卡），D1、D2、D4、D6 的 Agent 端。依賴 M-1、M-4 合回（通知形狀以合回的為準），U-1。嚴重度：高。

問題是什麼（白話）

Agent 執行紀錄的「回傳主系統」只要紀錄送到就標「已回傳」，主系統其實可能失敗；失敗了只能「重新執行」重掃。主系統處理完的 PDF 也沒地方收。版本說明只有中文。

在哪裡

/Users/chouraymond/Projects/Billows/Audit-Manager/evidence-agent/guidant_agent/scan/adapters/local_runs_repo.py:60   synced_at／sync_error 欄
/Users/chouraymond/Projects/Billows/Audit-Manager/evidence-agent/guidant_agent/scan/app/local_runs.py              終態與入列
/Users/chouraymond/Projects/Billows/Audit-Manager/evidence-agent/guidant_agent/console/api/runs_routes.py:59       resend（立即重試）
/Users/chouraymond/Projects/Billows/Audit-Manager/evidence-agent/guidant_agent/sync/app/command_pull.py            收長輪詢指令
/Users/chouraymond/Projects/Billows/Audit-Manager/evidence-agent/guidant_agent/files/api/commands.py:87            既有 fetch_file 處理
/Users/chouraymond/Projects/Billows/Audit-Manager/evidence-agent/scripts/build/gen_agent_manifest.py:70            read_release_notes

怎麼修

• extend 狀態三態（D1）：執行紀錄加主系統最終結果（建議 cloud_result：null＝已送出處理中、ok、failed＋原因）。收到 M-1 的通知時更新。API 回給主控台的欄位照新三態給，F-2 依此顯示。
• new 重傳報告（D2）：主控台 API 加「重傳報告」：只對 cloud_result=failed 的第三方元件手動掃描開放；把同一筆紀錄重新入列送出（主系統 S-1 會把 failed 那筆重排取檔），不重跑掃描。跟既有「立即重試」（送佇列裡還沒送的）分開，不要合成一支。
• extend 收 PDF（D4）：收到通知帶的 PDF file_uid 時，把它加進該筆的報告清單（kind 用 PDF，主控台預覽既有支援 PDF）。
• extend 版本說明（D6）：RELEASE_NOTES.md 每版段落加英文子段（格式與 R-1 一致）；gen_agent_manifest.py 產中英兩份 notes，英文進 U-1 的新欄位；舊格式照常解析。版本說明怎麼寫的段落補英文寫法。

要寫測試

• 收到 ok／failed 通知 → 狀態正確；重傳只對 failed 開放（突變：拿掉 failed 條件要紅）；舊格式 RELEASE_NOTES 解析結果不變。

手測（首腦在 123＋DEV）

• 123 跑第三方元件掃描：處理中顯示已送出 → 主系統成功後顯示已回傳、報告清單多 PDF。DEV 停 worker 讓它失敗 → 顯示主系統處理失敗＋原因 → 起 worker 按重傳報告 → 變成功。

紀律

• branch feature/FR-172，不切 branch；顯式 git add <檔名>、禁 -am；只 add 自己改的檔。commit 不等令，push 由決策者做。
• 做完 commit → 本卡 append 白話回寫（做了什麼、commit hash、驗證、手測清單）→ 狀態改 修正待驗證。卡住也 commit 已完成部分並回寫卡在哪，狀態維持 In progress。
• 檔案內註解只寫「為什麼」與「陷阱」（一到兩行），「做了什麼／哪一棒／等發版」進 commit message，不進檔案。
• 不重複造輪子：要寫任何新函式前先按行為 grep 既有程式碼，三擇一 reuse → extend → 確認沒有才 new。回寫列出 reuse 了哪些、新增了哪些、為什麼不能 reuse。
• 資安規範：BE 動到 api/／app/／infra/ 時 .claude/rules/security/ 自動載入，照著做；從 BE 開的 session 跨 repo 改 FE，FE 規則 .claude/rules/security/frontend.md 不會自動載入，動手前自己讀。回寫列出對到哪幾條、怎麼滿足。