↑ 需求首頁 ⌂ 需求中心

FR-039 接手 Prompt（貼給下個 session）

你接手 FR-039 分散式檔案 Agent（證據檔案落地客戶端、雲端不託管 binary）。動工前依序讀完這四份，缺一不可：

  1. 需求/設計：docs/features/FR-039-2606-distributed-file-agent/design.md
  2. 進度表：docs/features/FR-039-2606-distributed-file-agent/handoff/2026-06-18-FR039-progress.md
  3. 交接文件：docs/features/FR-039-2606-distributed-file-agent/handoff/2026-06-18-FR039-handoff.md（自包含，含部署 runbook + 踩雷表 + 測試座標）
  4. 本 prompt

讀完先答交接文件 §0 的三題冷接自檢（為什麼 binary 不落雲端 / 雲端怎麼選 agent / 預覽轉檔在哪做），答得出再開工。

§1

你接手時的狀態（2026-06-18 晚）

  • branch：BE + evidence-agent 都在 feature/FR-039-evidence-agent，未 push。
  • Phase 0~3 + registry 後端 + deploy 資產 + demo 測試踩到的兩個 bug 都已 commit。
  • demo 已大致跑通（102 上傳→121 MinIO、下載、預覽出 PDF 全 OK）。就差三件收尾（見下）。
  • 最新進度看 2026-06-18-FR039-progress.md「2026-06-18 晚更新」表。
§2

你最可能要做的（依序）

  1. 中文字型：agent 轉檔後中文變空白 → Dockerfile 已加 fonts-noto-cjk，重 build amd64 image（--platform linux/amd64）+ docker save 送 121 + load + docker compose up -d → 再預覽驗中文。（build/ship 指令見交接文件 §4）
  2. 驗 Bug 1（刪除）：BE 程式已改好但要 重啟 BE → 前端刪一個程序書 → 去 121 MinIO console 看物件真的不見了。
  3. 部署 122、雙客戶都驗（交接 §3.2）。
  4. 把 jedi-file-upload 兩個未 commit 套件改動（mapper checksum + minio shutil.move，在套件 working tree）發版或 dev path-dep → 防竄改 + EXDEV 根治才在 pin 版 live。
  5. （後補）registry 管理 UI（交接 §3.4）。

測完還原 102 config（共用 dev tenant，SQL 在交接文件 §3.1）。

§3

紀律

  • 服務由 user 自己起（只說「請重啟 BE」，別附啟動指令、別替他起）。
  • 改 BE service 層 code 後必提醒 user 重啟（沒 hot reload）。
  • 不切 branch；各 repo 分開 commit、顯式 git add、push 等 user 明示。
  • 動 jedi-* 套件走 path-dep dev、發版等 user 明示。
  • 遵守交接文件 §8 不變式（binary 不落雲端 / agent 不連雲端 DB / 不 fork 套件 / 整性信任根是雲端）。