這張卡做什麼(白話)
落地版客戶的機房常常完全沒有外網(air-gap)。目前登入頁有 Cloudflare Turnstile 真人驗證——內網連不到 Cloudflare 會讓登入直接失敗。本卡把 Turnstile 做成落地版預設停用(後端+前端一對開關),並把「本產品所有可能對外連線」完整盤點一輪,成文收進客戶手冊素材。
具體實作內容
- Turnstile 一對開關:BE 驗證端+FE 顯示端(
VITE_TURNSTILE_SITE_KEY,與 T-1.3 定值連動)——先查清現況哪端已有開關、補齊缺的那端;落地版預設停用
- 完整外連盤點:全 codebase 掃一輪對外連線點——已知:Turnstile(本卡停用)、License Center 在線回報(已 best-effort 離線自洽)、AI API/Google Drive(功能模組不啟用即不外連)——逐項確認並補漏
- 產出「本產品可能外連清單與停用法」文件素材(T-4.1 手冊收錄)
易踩雷提醒
- 開關必須是「一對」——只關 FE 顯示、BE 還在驗 token 就變成永遠登不進;只關 BE、FE 還在載 Cloudflare script 就 air-gap 卡載入
- LC 在線回報保持 best-effort,不要因盤點順手改成硬依賴
- 盤點涵蓋 jedi-* 套件(外連可能藏在套件層)
驗收條件
- air-gap(無外網)環境下登入不失敗
- 外連清單成文
依賴
已完成修正(2026-08-17,BE commit 3f17ff1b+FE commit 85c8bf2)
白話:做了什麼