跳至主要內容

審查錄影證據

具備權限的觀察員可以審查已完成的船舶錄影、查看已接受的 AI 證據，並在來源時間軸上維護 草稿觀察員標記。

審查錄影​

  1. 開啟 Human Analysis。
  2. 選擇有權限存取的船舶。
  3. 選擇包含已完成錄影的日期或日期範圍。
  4. 從 review session 清單開啟一段錄影。
  5. 使用時間軸查看 AI event 與追蹤觀測。
  6. 依需要建立或更新包含物種、處理方式、生命狀態、長度、重量、數量與備註的草稿標記。
  7. 如果標記是從 AI 證據判斷而來，請連結對應的 AI event。
  8. 重新整理 session，確認時間軸與標記編輯器內容一致。

AI overlay 只會在實際證據時間範圍內顯示。在目前播放時間之外選取 event，不會在影片上顯示 容易誤解的偵測框。

判讀視覺證據​

新版 Edge 候選事件可附帶第 1 版 visionEvidence。Edge 先考量影像可見度，再考量偵測分數， 選出具代表性的觀測影格，同時保留實際追蹤觀測供人工檢視。選中影格的偵測分數是尚未校準的 工程分數，不是魚種判斷的正確機率。speciesStatus: not_assessed 與 requiresHumanReview: true 明確表示尚未判定魚種，而且必須人工審查。fish 等偵測標籤 代表候選類別，不代表已確認魚種或正式漁獲計數。

影像品質可能標示細節不足、過暗、過亮、目標過小或被畫面邊緣截斷。measured 且沒有旗標， 只表示這些啟發式規則沒有觸發，不保證影像足以辨識魚種。unavailable 一律不含旗標，表示 未能量測品質。舊事件省略 visionEvidence；沒有量測結果時不可呈現為品質良好。

selectedTimestampSec 保留主要來源攝影機片段的秒數，多鏡頭候選事件也遵循相同規則。 審查封存影片可能採用不同播放起點，導覽應使用 API 已換算的事件 timestampSeconds，不可 直接拿來源秒數跳轉封存影片。API 會在本機與雲端儲存中保留證據，並提供給具權限的審查及 即時畫面客戶端。

啟用 prototype 升級​

  1. 先發布可以接受並保留 visionEvidence 的 API。
  2. 再發布支援證據卡片與舊事件顯示方式的 Web。
  3. 更新 Edge，確認 API 接受新合約後才啟用 INFERENCE_VISION_EVIDENCE_UPLOAD_ENABLED。 inference 與 uploader 都必須套用此設定並重新啟動；若使用 Compose，需以新設定重建容器。 此開關預設停用，讓舊版 API 部署仍可接收事件。
  4. 以新分析事件驗證審查與即時 API response，確認仍要求人工審查，且魚種尚未判定。

每次重試會檢查 uploader 已載入的設定；只修改環境檔，不會讓執行中的服務自動重新載入。 回退時停用開關並以新設定重新啟動，佇列中的事件即可使用舊版上傳格式，不必刪除錄影或 偵測觀測。啟用開關不會回填舊佇列中已省略的證據欄位，請在兩個服務重啟後驗證新分析的事件。

權限​

讀取 session 需要擁有船舶的審查資料權限；新增、更新或刪除標記需要觀察員審查權限。每個 request 都會重新檢查船舶存取權。

觀察員只能編輯符合條件的草稿標記。人工修正標記時，已完成的來源影片與已接受的 AI 證據 不會被修改。

相關 API​

Observer review API 可以列出 session、開啟可播放的 session，以及新增、更新或刪除草稿 標記。欄位 schema 與錯誤 response 請參考 API Reference。