本卡屬 FR-192(母卡 FR-192 母案(同清單上一張)),卡 P-1,批 1。只改 jedi-python-package。依賴:無。
這張卡寫下 Agent 與主系統之間「回饋怎麼傳」的約定:端點路徑、每筆帶哪些欄位、動作有哪三種(新增/修改/刪除)、一次最多幾筆,以及設定通道多兩類(類別選項、這台送出的回饋現況)。放在零相依的契約套件 jedi-agent-protocol,之後 Agent 與主系統都從這裡 import 常數,不各自硬寫字串。版號 0.5.3 → 0.6.0。
extend:照 tasks.py 既有 LOCAL_RUNS_PATH 與 config.py 既有 KIND_* 常數形狀加項,不另開檔
repo:~/Projects/Jedicogy/module/jedi-python-package
改既有:jedi-agent-protocol/jedi_agent_protocol/tasks.py(FEEDBACKS_PATH、FEEDBACK_OPS、FEEDBACK_ITEM_KEYS、FEEDBACK_FILE_KEYS、FEEDBACKS_MAX_BATCH)
改既有:jedi-agent-protocol/jedi_agent_protocol/config.py(KIND_FEEDBACK_LABELS、KIND_FEEDBACKS 進 ALL_KINDS)
改既有:jedi-agent-protocol/jedi_agent_protocol/__init__.py(export)
改既有:jedi-agent-protocol/pyproject.toml
jedi_agent_protocol/tasks.py:照 LOCAL_RUNS_PATH 旁加 FEEDBACKS_PATH = "/api/1.0/agents/feedbacks"、FEEDBACK_OPS = ("create","update","delete")、FEEDBACKS_MAX_BATCH = 50、FEEDBACK_ITEM_KEYS(local_uid/op/title/description/type_label_uid/created_by/created_at/updated_at/base_cloud_updated_at/files/remove_file_uids)、FEEDBACK_FILE_KEYS(agent_file_uid/file_name/size/mimetype/sha256)。jedi_agent_protocol/config.py:加 KIND_FEEDBACK_LABELS = "feedback_labels"、KIND_FEEDBACKS = "feedbacks",進既有的全部設定類清單。__init__.py export;tests/ 補鏡像測試(既有 test_mirror.py 形狀);pyproject.toml 0.6.0。不發版。套件 tests 綠;python -c 'from jedi_agent_protocol import FEEDBACKS_PATH, FEEDBACK_OPS; from jedi_agent_protocol.config import KIND_FEEDBACKS' 過;版號 0.6.0
~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-192-2611-agent-console-feedback/design.md §3 決策定案、§5 詳細設計(本卡那節)、§6 拆卡表本卡那列、§8 風險;討論稿 discussion.md §4 只在想知道「為什麼這樣裁」時看~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-192-2611-agent-console-feedback/prototype/index.html(純畫面,只取結構與資訊順序;文案依 i18n 重寫)guidant_agent/scan/app/local_runs.py(本機先存+同步欄位)、sync/app/outbox.py(待回傳佇列)、console/api/runs_routes.py(清單/404/resend)、files/app/blob_ops.py(附件存本機);主系統 api/source_scan/routes/agent_manual_scan_route.py(Agent 收單端點先例)、infra/upload_file/remote_agent_adapter.py(Agent 檔參照)、core/plugins/_agent_config_sections.py+_agent_config_notify.py(設定通道)、core/plugins/issue.py(jedi-issue 接線);jedi-issue app/feedback/service/feedback_service.py、api/routes/feedback_route.py、plugin/contract.py(SchemaExtensions);jedi-remote-agent app/service/local_run_service.py(ingest 形狀)、migrations/011-remote-agent-offline-operators.sql(RLS/GRANT 先例);FE src/views/feedback/system/SystemFeedbackForm.vue、console/views/Runs.vue、console/views/Logs.vue(Dialog)、src/views/source-scan/SourceFilePicker.vue(拖放)docs/system-design/system-integration/04-Agent到主系統API.md、05-主系統到Agent指令.mddocs/claude/domain-capabilities.md、FE docs/claude/frontend-overview.md §4。三擇一、預設不新增:reuse → extend → 確認沒有才新增。回寫列出本卡 reuse 了哪些、新增了哪些、為什麼不能 reuse。