跳轉到

Guidant AI v1.23.0 Release Note

項目 內容
版本 1.23.0（功能版號；主軸＝AI 服務使用模型設定——小幫手、儀表板、證據分類三支 AI 功能改依租戶設定選供應商與模型，碼表進選單管理不必重 build；Anthropic 改 5.5 世代；租戶可自填金鑰且自帶鑰計入自己額度）
發布日期 2026-10-01
上一版本 1.22.0（2026-09-30）
涵蓋區間 2026-10-01（BE 62a864e62..4953b03f7，18 commits：feat 6／fix 3／chore 2／docs 7；FE 3826339..6dd3912 9 commits）
涵蓋需求 FR-122 後續（CM-2364 AI 服務使用模型設定、CM-2365 spec 快照肥大根治）
規模 jedi-* 套件升版 3 支（ai-bot 1.5.0、ai-dashboard 1.6.0、evidence-classification 1.6.0）；主線 DB migration 新增 3 支（全部資料類、冪等，不進出貨基線）；無新服務、無結構變更
適用部署 188 STG → 189 POC（install.sh --upgrade）；仍為 --skip-prod-key-check 內部測試包
部署性質 服務組成不變；三支資料類 migration 隨 migrate 輪套；沙箱 image 因分類套件升版重 build

0. 發版前回歸 gate

比照 v1.22.0，本版不跑 site-regression 自動回歸（重整仍在排隊）。把關方式：每項改動決策者在 DEV 逐項手測（租戶自填金鑰、使用模型下拉、分類批次預設模型、選單位置）；三支 jedi 套件改吃 Nexus 新版後跑各自測試；BE 相關測試 182 綠。

1. 概述

v1.22.0 把三支 AI 功能收到同一道閘道後面，但「用哪家、哪個模型」仍寫死在程式裡。本版把這件事交給設定：

  • 「AI 服務設定」頁多一區「AI 服務使用模型」，平台管理員設全站預設、各租戶可覆寫，小幫手、儀表板、證據分類共用同一份。
  • 可選的供應商與模型是「選單管理」的碼表（類別「AI 服務使用模型」），加型號、下架型號在畫面上改，不必重出 image。
  • Anthropic 改用 Claude Opus 5.5 與 Sonnet 5.5。
  • 租戶管理員可以自填自家 AI 金鑰；用自己金鑰的呼叫計入自己租戶的額度。

2. 使用者可見變更

2.1 AI 服務設定頁（系統設定）

  • 租戶管理員可進入並自填金鑰（原本只有平台管理員）。自填的金鑰只影響自己租戶；沒填就沿用平台的。
  • 新區塊 AI 服務使用模型：供應商下拉只列本租戶自己已設定金鑰的供應商，模型下拉吃碼表；顯示目前生效值與來源（本租戶／全站預設／系統內建）；清除即改沿用上一層。選了沒金鑰的供應商存檔會被擋。
  • 各供應商卡片不再顯示「可用模型」提示字；Google 供應商拿掉（頁面上沒它的金鑰卡片）。

2.2 AI 小幫手與 AI 儀表板

  • 每次呼叫先問租戶的「使用模型」設定，設定改完下一句就生效，不必重啟。
  • 儀表板前端不再寫死 claude／fast；速度參數不再影響模型。

2.3 證據自動分類

  • 批次分類的可選模型改吃同一張碼表；分類設定視窗的預設模型帶「使用模型」設定（正式環境使用者不另挑模型，拿掉「僅系統管理員可見」說明）。
  • 「支援讀圖」由碼表每列的「公開」欄決定（1 支援、0 不支援），不讀圖的型號遇到圖片證據會標「此模型不支援圖片」。

2.4 AI 額度

  • 租戶自帶金鑰的呼叫也計入該租戶額度（原本只計原廠金鑰）。額度頁「不計入」提示只在租戶只用不需金鑰的供應商時出現。
  • 「AI 額度」頁改名「AI 額度設定」。

2.5 左側選單

  • 「AI 用量」「支援」從系統設定搬到系統管理（排最後）。
  • 「AI 服務設定」「AI 額度設定」留在系統設定，相鄰排列。

2.6 選單管理

  • 新類別「AI 服務使用模型」：key 填 供應商:模型代號、名稱填顯示名、排序決定下拉順序（每家排最前的是該家預設）、公開＝支援讀圖。出廠五列：Claude Haiku 4.5、Claude Sonnet 5.5、Claude Opus 5.5、GPT-5.6 Luna、GPT-5.6 Terra。

2.7 文件站

  • 所有文件站首頁改 index.html（原 README.html），資安檢視總報告站獨立部署路徑修正。

3. Breaking Changes

無服務組成與結構變更。兩點行為變更要知道：

  • 租戶管理員現在看得到並能改「AI 服務設定」（原本鎖平台管理員）。要鎖回去改 BE AI_PROVIDER_CONFIG_PLATFORM_ADMIN_ONLY 與 FE AI_SERVICE_CONFIG_PLATFORM_ADMIN_ONLY 兩個常數（要重 build）。
  • 租戶自帶金鑰的花費開始計入額度；原本靠自帶鑰繞過額度的租戶，升級後會被額度管到。

4. DB Migration

主線（scripts/sql/manifest.tsv 新增 3 列，皆資料類、冪等）

檔案 內容
2026-10-01-cm2364-ai-model-menu.sql system_menus 新類別 AI_MODEL 五列（出廠碼表）
2026-10-01-cm2364-ai-model-menu-claude-5-5.sql 已套過前版 seed 的庫：Anthropic 型號改 5.5 代號、租戶 default_model 指到舊代號的跟著改
2026-10-01-cm2364-ai-menus-to-system-admin.sql 選單搬移與改名（只動 pid／sort／description）

出貨基線

三支都是資料類，不進 02-schema.sql／99-stamp.sql；新裝與升級都靠 migrate 輪套。99-stamp.sql 只因版號重生 marker。

5. 相依套件版本

套件 v1.22.0 本版 變了什麼
jedi-ai-bot 1.4.0 1.5.0 model_selector port：宿主依租戶決定 provider／model
jedi-ai-dashboard 1.5.0 1.6.0 同上；provider 改選填；fallback 對照表改 Sonnet 5.5
jedi-evidence-classification 1.5.0 1.6.0 model_catalog port：宿主注入碼表；內建碼表改 5.5

其餘 jedi 套件與第三方不變。檢測 Agent 不變（1.1.0）。

6. 部署順序

  1. 188 build 機：BE／FE／套件 clone git pull 到本版 commit，scripts/build/build_all.sh --all（沙箱 image 要重 build：分類套件變了），build_bundle.sh --skip-prod-key-check（PROD 簽章鑰仍未建）。smoke 連庫走 scripts/build/README.md「smoke 用臨時庫」SOP。
  2. 開包驗：BE image 內三包版號；init image 99-stamp.sql marker v1.23.0；manifest 含三支 2026-10-01。
  3. STG（188）：先 compose stop guidant-api guidant-socketio 再 install.sh --upgrade；驗 /api/1.0/version、兩個群組的選單位置、AI 服務設定頁「使用模型」區、選單管理「AI 服務使用模型」五列。
  4. 放行後 POC（189），同法。

7. 已知限制與 follow-up（不擋本版）

  • 證據分類在正式環境不開放使用者自選模型（決策者裁：有反應再開）。
  • 設定頁「選了沒金鑰的供應商要擋」在主機有環境變數金鑰時驗不到（解析器解得到），單元測試有釘。
  • 用量頁「金鑰來源範圍」篩選仍是原廠／全部，未加「本租戶」。
  • PROD 簽章鑰仍缺（交客戶前必補）；190 license 重匯與 Agent 重 enroll 未做；design §7.1-9 未驗。
  • spec-site 快照肥大已根治（CM-2365）：各版快照約 70 MB，git 歷史不重寫。

8. 相關文件

  • Notion：CM-2364（功能）、CM-2365（快照）、CM-2366（出包）
  • SPEC：system-admin/ai-quota、system-admin/ai-usage、collab/ai-assistant、reporting/ai-dashboard、evidence/evidence-classification-review、system-admin/system-menu-manage
  • 分析：docs/analysis/2026-09-30-fr122-nuitka-hidden-deps-and-nofollow-closure.md