本卡屬 FR-166(母卡 CM-母卡號(建完補)),卡 P2-2,階段 P2 離線能做事、批 4。只改 evidence-agent。依賴:P2-1。
手動掃描的 API:列工具、列清冊目標、拿表單定義、開跑、看進度、取消;第三方元件掃描走既有上傳口。
六端點、清冊與帳密兩道守門、第三方元件分流
extend:scan_input.py 多接受本機 session(不另開上傳口);帳密走既有 credential_resolver;表單定義走既有 tool_schemas
repo:~/Projects/Billows/Audit-Manager/evidence-agent
改既有:core/console/scan_routes.py(P1-4 已掛的空殼,填內容)
改既有:core/scan_input.py
細節在 design.md 對應段(~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-166-2610-agent-standalone-console/design.md §5,開 design.html 看導覽),本段只列本卡要做到的點:
scan_routes.py(P1-4 空殼填):六端點照 design §5.2;scope run-local-scan;清冊 check、credential_resolver、LocalSink。scan_input.py 驗票處加分支認本機 session;第三方元件走既有 sbom_scan connector,結果走 source_scans 標 source=agent_manual。GET tools 回八支含帳密狀態;POST runs 清冊外 403;未同步 403;sbom 走 PUT /scan-input 本機 session 成功;取消走既有 _RUNNING_TASKS
對照雛形:~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-166-2610-agent-standalone-console/prototype/index.html(上方「跟著走」)。
docs/claude/domain-capabilities.md 與 FE docs/claude/frontend-overview.md §4。三擇一、預設不新增:reuse → extend 加參數 → 兩邊都確認沒有才新增。既有的是 stub/壞掉 → 修它或回報,不另寫繞過。回寫列出本卡 reuse 了哪些、新增了哪些、為什麼不能 reuse。if source == ... 分支。紅旗:複製一段既有函式改兩行、開 XxxV2/XxxForAgent、同一行為兩條路徑各自演化——出現就停下先抽共用。回寫列出哪些 extend 了既有的、哪些 new 及為什麼不能 extend。api//app//infra//scripts/sql/ 時 .claude/rules/security/ 八支自動載入(總覽 docs/claude/secure-coding-rules.md);FE 規則在 FE repo .claude/rules/security/frontend.md;Agent 與套件 repo 沒有自動載入,動手前讀 BE 的八支。本案特別要守:四種登入失敗同一回應、body 上限、subprocess 不經 shell、CERT_NONE 禁用、新表 RLS、argon2id 不回雜湊、密碼欄進遮罩。design §5.7 與討論稿 §13.6 有逐條對照。回寫列出本卡對到哪幾條、怎麼滿足。