雛形・假資料・不接後端|FR-167 線上更新:系統發現新版先通知,管理員確認後才下載;就緒後有「系統更新」權限的人按一下或選時間;每步有時限,失敗、卡住、斷電都自動退回;任何版本都不自動裝;授權過期仍可升同主版號最新版;主機上不多常駐程式、不開新的埠 ⓪有新版通知 · ①更新中心 · ①b 下載中 · ①c 已就緒・按更新 · ②維護頁(停機中) · ③已自動退回 · ④完成與 Agent · ⑤跨版兩段 · ⑥例外狀態 · ⑦更新站後台(原廠)
Guidant AI
王大明(系統管理員)
首頁

儀表板

(原本的首頁內容,不變)

畫面 ⓪ 說明

系統每天凌晨向原廠更新站問一次,只拿幾 KB 的版本資訊,不下載。跟 iPhone 一樣:先通知,按了才下載安裝。

Guidant AI
王大明(系統管理員)
系統設定 / 更新中心

更新中心

系統每天向原廠確認一次有沒有新版本。你按「下載」後才會下載並驗證;就緒後按「立即更新」或選排程時間,其餘全自動。升級每一步都有時限,失敗、卡住、斷電都會自動退回,資料不會遺失。
目前版本
1.24.1
安裝日期
2026-08-02
授權
有效至 2027-06 · 1.x (授權過期仍可升 1.x 最新版,功能依授權鎖;2.0 要重新授權)
Agent
3 台,皆為 1.24.1
最新版本
可以更新・尚未下載
1.27.0
大小
2.9 GB
可直升起始版
1.22.0 以上 本機符合
預計停機
約 10 到 20 分鐘
發現時間
今天 03:00 · 每日檢查
1.27.0 版本說明
  • 線上更新:管理員可在畫面上完成更新
  • 跨框架控制項對照:同層控制項可對照、證據可沿用
  • 修正:稽核計畫頁在無控制項時白畫面
  • 安全修正 證據檔案解析元件漏洞(CVE-2026-xxxxx)。影響範圍:惡意構造的 docx 可能讓解析程序當掉,不影響既有資料。建議動作:盡早更新;更新前不建議接收外部來源的 docx 證據
預檢 (現在跑一次,開始更新前再跑一次)
  • ✔硬碟剩餘 42 GB,需要 8 GB(更新包 2.9 GB + 資料庫複本 0.7 GB + 新映像 3.5 GB + 保留空間)
  • ✔版本路徑:1.24.1 → 1.27.0 可直升,中間沒有必經版本
  • ✔資料庫連線正常;資料庫 650 MB,複製約 1 分鐘,預計停機 10 到 20 分鐘
  • -目前有 2 件證據分類在跑;升級開始時會先停止接新工作,等它們做完才停服務(不會強制中斷)
下載更新包

下載時服務照常。下載完會自動驗簽名與雜湊,通過後這裡會出現「立即更新」與「排程」,並寄通知給你。

更新期間系統暫停服務約 10 到 20 分鐘。升級每一步都有時限,失敗或卡住會自動退回 1.24.1;開放使用之後若有問題,請聯絡原廠發修正版。
離線更新 (主機連不到外網時用)
把原廠提供的 guidant-ai-<版號>.tar.gz 拖到這裡,或點此選檔
上傳後立刻驗簽名與雜湊,驗不過的檔不會保留;通過後跟線上下載走同一條路
更新紀錄
時間版本來源結果耗時下載人按更新的人
2026-10-04 22:001.24.0 → 1.24.1 含安全修正線上下載成功8 分王大明 wang.dm
10-03 10:02 按下載
王大明 wang.dm
10-03 10:10 排程 22:00
診斷包
2026-08-02 22:001.23.1 → 1.24.0線上下載成功14 分王大明 wang.dm
08-02 09:12 按下載
王大明 wang.dm
08-02 09:15 排程 22:00
診斷包
2026-08-01 22:001.23.1 → 1.24.0線上下載已退回11 分王大明 wang.dm
07-31 17:40 按下載
李小華 lee.sh
07-31 17:45 排程 22:00・22:11 自動退回
看原因
2026-06-20 21:301.22.0 → 1.23.1離線上傳成功12 分王大明 wang.dm
06-20 21:28 上傳
王大明 wang.dm
06-20 21:30 立即
診斷包
Guidant AI
王大明(系統管理員)
系統設定 / 更新中心
下載 1.27.0 中
服務照常運作 · 1.1 GB / 2.9 GB · 約 4 分鐘
確認人
王大明 wang.dm · 2026-10-29 09:05
下載完後
自動驗簽名與雜湊,通過才算就緒;斷線會自動續傳
沒下載完不會顯示就緒,升級指令也會拒絕用不完整的包開始。
Guidant AI
王大明(系統管理員)
系統設定 / 更新中心
1.27.0 已就緒
下載人 王大明 wang.dm · 2026-10-29 09:05 · 簽名與雜湊 09:20 驗證通過 · 預檢通過
  • ✔預計停機 10 到 20 分鐘(資料庫 650 MB,複製約 1 分鐘)
  • ✔更新期間打開本系統網址會看到進度
  • -服務停掉之前隨時可以取消,什麼都不動;服務停掉之後沒有取消鈕,每一步有時限,失敗或卡住會自動退回 1.24.1
什麼時候更新

按下後主系統只會在主機上寫一張更新單(版本、時間、誰按的),由主機上的系統服務到點執行升級;主系統本身沒有停服務、換版本的權限。

畫面 ①c 說明

只有具「系統更新」權限的帳號看得到這一區(預設給系統管理員,可另外授權)。IT 想在主機上手動執行 sudo guidantai upgrade 1.27.0 也可以,是備援,不是主路徑。

Guidant AI
系統維護中
更新中:1.24.1 → 1.27.0
已進行 7 分 40 秒 · 預計還要 5 到 10 分鐘 · 王大明 wang.dm 排程 22:00
  • ✓
    預檢
    空間、版本路徑、資料庫全部通過
    22:00:04 · 6 秒
  • ✓
    停止接新工作,等進行中的做完
    2 件證據分類已完成
    22:00:10 · 3 分 12 秒
  • ✓
    停服務、複製資料庫
    現在那份資料庫已封存不動;複本 650 MB
    22:03:22 · 48 秒
  • ●
    在複本上升級
    載入映像 5/5 完成 · 套用資料庫更新 31 / 47 支 · 目前:2026-10-14-fr162-mapping-index.sql(已跑 40 秒,超過 10 分鐘沒進度會自動退回)
    22:04:10 · 進行中
  • 5
    啟動新版、健康檢查
    上限 5 分鐘
  • 6
    開放使用 不可退回點
    之後若有問題由原廠發修正版
  • 7
    Agent 跟進(先 1 台,正常再推其餘 2 台)

這一頁只能看,沒有按鈕:服務已停,每一步都有時限,失敗或卡住會自動退回 1.24.1;斷電或重開機時,開機後會自動退回。關掉瀏覽器不影響更新。

Guidant AI
王大明(系統管理員)
已退回 1.24.1,服務正常
2026-10-31 22:16 · 退回耗時 38 秒 · 王大明 wang.dm 排程 22:00
  • ✓
    預檢
    6 秒
  • ✓
    停止接新工作
    3 分 12 秒
  • ✓
    停服務、複製資料庫
    48 秒
  • ✕
    在複本上升級
    第 32 支 2026-10-20-fr166-backfill.sql 超過 10 分鐘沒有進度,判定卡住
    10 分 30 秒
  • ↩
    自動退回
    丟棄複本 → 改接回更新前的資料庫 → 啟動 1.24.1 映像 → 健康檢查通過
    38 秒
資料完整性
  • ✔使用中的資料庫就是更新前那一份,更新過程沒有寫入
  • ✔證據檔案未被更動
  • ✔Agent 在停機期間的 4 筆檢測結果已補送完成
  • ✔進行中的工作都是做完才停服務的,沒有工作被中斷
下一步

請下載診斷包寄給原廠。診斷包包含更新進度紀錄、各服務 log、主機狀態,密碼與金鑰已自動遮掉。原廠確認原因後會提供修正版,或告知可以直接重試:更新包還在主機上,按「重試」從預檢重跑,不用重下載。

Guidant AI
王大明(系統管理員)
主系統 1.27.0,正常
2026-10-31 22:15 開放使用 · 全程 15 分 02 秒 · 王大明 wang.dm 排程 22:00
Agent 跟進

先推 1 台,正常後推其餘。任何一台失敗就自動暫停,其餘不會被推。Agent 版本不會比主系統新。

scan-tpe-01第 1 批1.27.0 正常 22:19 完成2 分 40 秒
scan-tpe-02第 2 批更新中 套用中
scan-khh-01第 2 批更新中 下載中 72%
只升 Agent,主系統不動同一套機制

兩種情況都走上面同一條路,主系統不停服務、不升自己:

  • -某幾台落後(新加的、上次暫停的、當時失敗的):在 Agent 區勾選那幾台按「推送」,先一台再其餘
  • -原廠只修 Agent(例如檢測工具有洞):更新站發 Agent 修正版 1.27.0-agent.1(幾十 MB),更新中心一樣通知、下載、驗簽名,就緒後按「推送給 Agent」。版本約束不變:Agent 的主線版號必須等於主系統現行版
開放使用之後若發現問題

這時不提供退回:退回會丟掉開放使用之後新增的資料。請下載診斷包聯絡原廠,由原廠發修正版。

Guidant AI
王大明(系統管理員)
系統設定 / 更新中心

需要先經過 1.22.0

本機是 1.20.0。1.27.0 只能從 1.22.0 以上直升,因為 1.22.0 那一版的程式負責把舊資料搬到新格式,跳過它資料就沒搬。

  • 1
    第一段:1.20.0 → 1.22.0
    尚未下載
    1.6 GB
  • 2
    第二段:1.22.0 → 1.27.0
    尚未下載
    2.9 GB
按下後兩個包都下載;就緒後按一次更新,兩段一次跑完,每段各自複製資料庫、各自健康檢查。第二段失敗時會停在 1.22.0,那是一個可以正常使用的版本。
Guidant AI
王大明(系統管理員)
系統設定 / 更新中心 / 例外狀態

更新中心的其他狀態

預檢不通過無法開始
  • ✕硬碟剩餘 3 GB,需要 6 GB。主機上有 12 GB 舊版映像可清除,清除舊映像

什麼都沒動,系統照常運作。

更新包驗證失敗已丟棄

簽名無法以原廠公鑰驗證,檔案可能損毀或不是原廠提供。線上下載會自動重下;離線上傳請重新取得更新包。

連不到原廠更新站無法檢查

最近一次成功檢查:2026-09-20。主機若本來就不能連外網,請改用「離線更新」上傳原廠提供的更新包;若應該可以連網,請確認防火牆放行更新站與下載網域的 HTTPS。

沒有「系統更新」權限的帳號只能看

看得到目前版本、有沒有新版、更新紀錄;看不到「下載」「立即更新」「排程」「取消」。要操作請找系統管理員,或由系統管理員授權「系統更新」。

排程時間到了但更新包已被刪除或驗證不過這次不更新

執行前會再驗一次簽名與雜湊,不過就什麼都不動,通知管理員重新下載。

授權已到期仍可更新,功能鎖著

授權於 2026-09-30 到期,系統目前唯讀。1.x 的新版(含 1.27.0)照常提供,可以下載、更新,升上去之後仍是唯讀、新功能依授權鎖;續約後功能即解鎖,不必重裝。

下一代 2.0 已發布需重新授權

你的授權是 1.x。2.0 要重新授權才看得到;1.x 之後若還有新版照常提供。請聯絡原廠。

進行中的工作超過 30 分鐘沒做完繼續等

還有 1 件檢測派送在跑(已 34 分鐘)。系統不會強制中斷它,會繼續等;服務還沒停,期間可以取消這次更新,什麼都不動。

排程時段結束還沒等到工作做完這次不更新

排程時選的時段到 23:30,那件檢測派送還沒完。這次沒有更新,已恢復接新工作,什麼都沒動;更新包保留,請重新選時間。

斷電後開機已自動退回

上次更新停在「在複本上升級」時主機重開。guidantai 開機檢查讀進度檔發現沒做完,已退回 1.24.1,資料完整。

docker 當掉,自動退回沒跑要 IT 出手

這是唯一要人登入主機的情況。請客戶 IT 用 SSH 執行 sudo guidantai recover,效果等同自動退回;要寄原廠判斷請加 sudo guidantai diag。用的是客戶本來就有的主機登入,系統沒有另外開門。

Agent 第一台更新失敗已暫停推送

scan-tpe-01 更新失敗,已自動退回原版本。其餘 2 台不會被推。主系統不受影響。

Update Center
決策者(原廠)
更新站 / 發行版
原廠這邊的畫面,客戶看不到。跑在 Cloudflare Worker(先用免費方案),檔案放 R2。CI 出完包自動登記成「草稿」,客戶查不到;草稿可以指定給幾台內部機器先裝(STG、POC);決策者在自己電腦用發布印章蓋章後才對外。這個後台只能看、撤回、指定內部機器、加拒絕名單,不能發布。
版本主版號可直升起始版大小狀態內部先裝已更新客戶保留到
1.28.01.x1.22.02.9 GB草稿STG、POC (1 / 2 已裝)—2036-11
1.27.0 含安全修正1.x1.22.02.9 GB已發布—3 / 5 · 1 筆已退回 · 含 1 家授權過期2036-11
1.22.01.x1.18.0 必經1.6 GB已發布—5 / 52032-06
誰拿得到

更新站只判三件事:本機授權檔是不是授權中心簽的、有沒有在拒絕名單、目標版本的主版號跟授權檔簽的一不一樣。不看授權到期日:過期客戶照樣能升 1.x 最新版(升上去是唯讀、功能鎖著),2.0 要重新授權。每一版都是修正加功能混著出,含安全修正的版本只是在更新說明多「影響範圍」「建議動作」兩段。每版包至少留 10 年。

# 決策者電腦
$ guidant-release publish 1.28.0
[發布] 取草稿 1.28.0 ..................... OK  sha256 9f3a…c21e
[發布] 內部先裝結果:STG 成功、POC 成功 ... OK
[發布] 解鎖發布印章 #2(主力)passphrase: ********
[發布] 蓋章、寫印章編號 .................. OK
[發布] 送回更新站 → 已發布 ................ OK
印章印章本體不在這裡,這裡只有印樣(公鑰)與狀態
編號狀態在哪客戶端認不認
#2主力決策者電腦1.26.0 起出貨的都認
#3備用・封存離線保存,不在任何電腦1.26.0 起出貨的都認
#1作廢—1.26.0 這版宣告作廢;停在 1.25 以下的客戶要先升 1.26.0(必經)

換印章只能藏在一次對章通過的更新裡:用客戶現在認的印章蓋一版、包裡印新印樣。更新站、R2、這個後台都換不了印樣。