FR-122 AI 閘道與檔案沙箱

三支 AI 功能（小幫手、動態儀表板、證據自動分類）改走共用 AI 閘道 jedi-ai-gateway； 不可信檔案改在無金鑰、不出網的沙箱容器拆解；分類長工作搬到獨立的背景工作行程 （RUN_MODE=worker）。全案分三階段：第一階段資安地基（21 張子任務）、第二階段 補強（租戶出境政策、供應商揭露等）、第三階段成本（原廠金鑰的美金額度與次數、用量頁）。原則是「有輪子不 自造」——偵測機敏、判讀注入、轉接各家 AI 供應商都用開源套件（LiteLLM、Presidio、 Prompt Guard 2），自寫只留產品專屬的部分。

整體狀態：已出貨 1.22.0，STG／POC／190 三環境同包（內部測試包，PROD 簽章鑰交客戶前必補）。 收口見 handoff/2026-09-30-arc-SUMMARY.md。 功能規格已寫進 SPEC 站（AI 小幫手、AI 儀表板、證據分類覆核、AI 用量、AI 額度、落地版維運手冊），落地版記憶體最低 16 GB、建議 24 GB。

細節見 design.md §6 拆分、handoff/FR-122-STATE.md 逐棒現況、Notion 母卡 CM-2293。

給客戶端維運人員：守門規則與 AI 指示怎麼調（放寬／收緊主題、改門檻、加自家機敏格式、升級保留、改壞怎麼救）→ AI 守門調整手冊（隨產品交付；docs/user-manual/ 內同名檔是它的連結）。

• 決策者提出需求：AI 小幫手呼叫 AI API 完全沒有內容過濾，擔心被用來攻擊系統或造成資安風險，要求參考 OWASP 與 EU AI Act 做防範；同樣問題也存在於 AI 動態儀表板、證據自動分類。要求：先解資安面、再解成本問題；機敏資料外洩風險要處理；要有完整可稽核紀錄（人事時地物、原始輸入、調整後內容、送出內容、回應內容、token 用量、供應商）；要能暫停功能；做成共用模組、DDD＋六邊形、不被舊設計綁死；有輪子不重造輪子。
• 設計定案：D1～D11 與成本三題全部拍板，三個角色（AI 閘道／檔案沙箱／背景工作行程）、三個階段分工，拆為第一階段 6 子需求 × 21 子任務。

一句話：產品內建兩個離線的安全檢查模型，在資料送出前先過濾；真正的 AI 分析仍由 客戶選擇的供應商提供。

三個模型分工：

• spaCy 小模型（約 15MB）——辨識文字裡的人名、地名，幫忙找出機敏資料。
• Prompt Guard 2（86M 參數）——判斷一段文字像不像在對 AI 下指令（防止有人藏惡意指令）。
• 外部大語言模型（Anthropic／OpenAI／Google）——真正做分析與回答，資料才會送出去。

前兩個模型跑在本機、不連網、不花錢；只有第三個會把內容送到外部、依用量計費。

業界對照：與 Salesforce Einstein Trust Layer（遮蔽個資、零資料留存、稽核軌跡、 用量計量）、Microsoft 365 Copilot 走同一套思路；本案額外多做檔案沙箱，因為分類功能 需要打開客戶上傳的檔案本體。

誠實的限制：兩個離線模型都會有漏判與誤判，對客戶不可承諾「個資全遮」「完全阻擋 提示注入」，只能講「多層防護＋拿不準就交給人工複審＋每一筆呼叫都可稽核」。

授權標示：產品「關於」頁與文件會標示「Built with Llama」（Prompt Guard 2 使用 Llama Community License，可再散布，月活躍使用者 7 億以下免費）。

完整技術細節見 design.md §5.17 元件說明與運維須知。

• discussion.md — 需求討論稿（定稿），含流程圖、資安問題總表、市面對照
• cost-quota-discussion.md — 第三階段花費控管討論稿（已裁），含市面方案盤點與 mockup
• design.md — 設計文件，D1～D11 與成本三題落地規格、套件結構、資料表、拆卡
• handoff/FR-122-STATE.md — 交接現況（living）
• handoff/FR-122-LOG.md — 逐棒紀錄（append-only）

以下全部由 build 掃資料夾產生，新增檔案重 build 即自動出現。標題連結指向渲染後的 HTML，md 連向源檔。

說明與手冊

需求與討論

設計

其他文件

mockups/（2 份）

其他文件

交接與收口時間軸（handoff/，3 份）

由新到舊。每份是某一棒次交接當下的完整現況快照，看某個時間點「當時知道什麼」請從這裡進。

其他檔案：notion-cards-spec.json、notion-cards.json

卡片內容（決策紀錄、驗收條件）以 Notion 為準，本頁只記座標。