# 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 / 預覽轉檔在哪做），答得出再開工。

## 你接手時的狀態（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 晚更新」表。

## 你最可能要做的（依序）

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）。

## 紀律

- **服務由 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 套件 / 整性信任根是雲端）。