快照與變更日誌

引數快照

每個已釋出的版本都會儲存一個引數快照：程式和測試集引數按照固定的、有版本的架構進行捕獲，因此一個版本包含其內部的完整結構化內容。每個版本還有一個 README 檔案，以可讀形式呈現該快照。

一個版本包含兩個快照檔案：

• parameters/recipe/<version>.json — 程式快照
• parameters/testset/<version>.json — 測試集快照

兩者都帶有一個 schema_version，用於描述該檔案的結構（當前為 1.1）。欄位使用下述點路徑表示；[] 表示列表，因此 blocks[].type_config.labels[].name 表示每個模型中每個標籤的 name。

程式快照

parameters/recipe/<version>.json

欄位	型別	含義
schema_version	string	此檔案的架構結構版本。
extracted_at	string	快照生成時間。
recipe_name	string	程式名稱。
description	string | null	程式描述。
plc_recipe_id	integer | null	PLC 程式 ID。
meta_version	integer	程式後設資料版本。
database_version	integer	程式資料庫版本。
software_version	string	程式軟體版本。
imaging.preview_image.sha	string	預覽影象的 SHA。
imaging.preview_image.path	string	預覽影象的路徑。
imaging.exposure	integer | null	曝光時間。
imaging.gain	number | null	感測器增益。
imaging.brightness	integer | null	亮度。
imaging.gamma	integer | null	伽瑪值。
imaging.focal_length	number | null	焦距。
imaging.focus	number | null	對焦。
imaging.focus_distance	number | null	對焦距離。
imaging.rotation_mode	integer | null	影象旋轉模式。
imaging.acq_mode	integer | null	採集模式。
imaging.hdr_mode_enabled	boolean | null	HDR 模式開/關。
imaging.led_mode	integer | null	LED 照明模式。
imaging.led_gain	integer | null	LED 增益。
imaging.led_strobe_mode	boolean | null	LED 頻閃開/關。
imaging.lens_correct	boolean | null	鏡頭畸變校正開/關。
imaging.photometric_enabled	boolean | null	光度校正開/關。
imaging.photometric_mode	integer | null	光度模式。
imaging.awb_red	integer | null	自動白平衡紅色通道。
imaging.awb_green	integer | null	自動白平衡綠色通道。
imaging.awb_blue	integer | null	自動白平衡藍色通道。
imaging.awb_op	boolean | null	自動白平衡啟用狀態。
imaging.calibration_pixels_per_unit	number | null	校準比例（每單位畫素數）。
imaging.calibration_unit	string | null	校準單位。
imaging.trigger_debounce	integer | null	觸發去抖動。
imaging.trigger_delay	integer | null	觸發延遲。
imaging.raw	object	完整未解析的影象源。
blocks[].block_type	string	模型型別（alignment、classification、segmentation、measurement、ocr、unsupervised）。
blocks[].uuid	string	穩定的模型標識。
blocks[].name	string	模型名稱。
blocks[].status	string	模型狀態。
blocks[].is_enabled	boolean	模型是否執行。
blocks[].has_model	boolean	是否附加了已訓練的模型。
blocks[].search_area.search_area_id	integer | null	搜尋區域 ID。
blocks[].search_area.search_area_bbox	list of number | null	搜尋區域邊界框。
blocks[].search_area.roi_regions[].bbox	list of number	ROI 邊界框。
blocks[].search_area.roi_regions[].angle	number	ROI 旋轉角度。
blocks[].type_config	object	特定型別配置（見下文）。
blocks[].model_ref.sha	string	已訓練模型檔案的 SHA。
blocks[].model_ref.path	string	已訓練模型檔案的路徑。
blocks[].model_ref.file_extension	string	已訓練模型檔案的副檔名。
aligner_reference_image.sha	string	對齊參考影象 SHA。
aligner_reference_image.path	string	對齊參考影象路徑。
aligner_reference_image.full_repo_path	string	對齊參考影象在倉庫內的路徑。
node_red_flow.basic_mode	boolean	流程是否處於基本模式。
node_red_flow.basic_flow_id	string | null	基本模式流程 ID。
node_red_flow.basic_flow_metadata	object | null	基本模式流程後設資料。
node_red_flow.nodes[].id	string	節點 ID。
node_red_flow.nodes[].node_type	string	節點型別。
node_red_flow.nodes[].name	string	節點名稱。
node_red_flow.nodes[].x	integer | null	節點畫布 X 位置。
node_red_flow.nodes[].y	integer | null	節點畫布 Y 位置。
node_red_flow.nodes[].wires	list of list of string	輸出連線（每個輸出對應的目標節點 ID）。
node_red_flow.nodes[].func	string | null	函式節點程式碼。
node_red_flow.nodes[].raw	object	完整未解析的節點源。

模型配置

blocks[].type_config 下的欄位取決於 blocks[].block_type。

欄位	型別	含義
blocks[].type_config.angle_tolerance_left	number | null	對齊 — 左角度容差。
blocks[].type_config.angle_tolerance_right	number | null	對齊 — 右角度容差。
blocks[].type_config.confidence_score_threshold	number | null	對齊 / 分割 / 無監督 — 匹配/置信度閾值。
blocks[].type_config.sensitivity	number | null	對齊 / 無監督 — 靈敏度。
blocks[].type_config.version	integer | null	對齊 — 配置版本。
blocks[].type_config.scale_invariant	boolean | null	對齊 — 尺度不變匹配開/關。
blocks[].type_config.inference_mode	string | null	對齊 — 推理模式。
blocks[].type_config.dl_performance_mode	integer | null	對齊 — 深度學習效能模式。
blocks[].type_config.skip_block	boolean | null	對齊 — 跳過此模型。
blocks[].type_config.template_image_id_path	string | null	對齊 — 模板影象引用路徑。
blocks[].type_config.labels[].name	string	分類 — 標籤名稱。
blocks[].type_config.labels[].confidence_threshold	number | null	分類 — 每個標籤的置信度閾值。
blocks[].type_config.labels[].is_positive	boolean | null	分類 — 該標籤是否計為透過。
blocks[].type_config.labels[].inspection_type	integer | null	分類 — 檢測型別。
blocks[].type_config.labels[].color	string | null	分類 — 顯示顏色。
blocks[].type_config.segmentation_type	string | null	分割 — 分割型別。
blocks[].type_config.classes[].class_name	string	分割 — 類別名稱。
blocks[].type_config.classes[].mask_pixel_value	integer | null	分割 — 掩膜畫素值。
blocks[].type_config.classes[].color	string | null	分割 — 顯示顏色。
blocks[].type_config.classes[].mask_sha	string | null	分割 — 掩膜檔案 SHA。
blocks[].type_config.classes[].mask_path	string | null	分割 — 掩膜檔案路徑。
blocks[].type_config.measurement_regions[]	object	測量 — 測量區域。
blocks[].type_config.min_text_area	integer | null	ocr — 最小文字區域。
blocks[].type_config.text_segmentation_threshold	number | null	ocr — 文字分割閾值。
blocks[].type_config.unclip_ratio	number | null	ocr — unclip 比率。
blocks[].type_config.unclip_ceiling	number | null	ocr — unclip 上限。
blocks[].type_config.unsupervised_type	string | null	無監督 — 方法型別。
blocks[].type_config.epochs	integer | null	無監督 — 訓練輪數。
blocks[].type_config.encoder	string | null	無監督 — 編碼器。
blocks[].type_config.learning_rate	number | null	無監督 — 學習率。
blocks[].type_config.downsampling_ratio	number | null	無監督 — 下采樣比率。
blocks[].type_config.tiled_mode	boolean | null	無監督 — 平鋪模式開/關。
blocks[].type_config.min_blob_area	number | null	無監督 — 最小 blob 面積。
blocks[].type_config.max_blob_area	number | null	無監督 — 最大 blob 面積。
blocks[].type_config.hyperparameters	object	分類 / 分割 / 測量 / ocr / 無監督 — 訓練超引數。

測試集快照

parameters/testset/<version>.json

欄位	型別	含義
schema_version	string	該檔案的 Schema 形態版本。
extracted_at	string	快照生成時間。
name	string	測試集名稱。
description	string | null	測試集描述。
author	string | null	測試集作者。
image_count	integer	影象數量。
images_with_ground_truth	integer	具有真實標籤的影象數量。
search_area_ids[]	string	測試集引用的搜尋區域 ID。
per_class_distribution[].class_name	string	類別名稱。保留欄位；當前始終為空（視為"分佈不可用"）。
per_class_distribution[].count	integer	該類別的影象數量。保留欄位；當前始終為空。
images[].image_id	string	影象 ID。
images[].ground_truth_fingerprint	string | null	影象真實標籤的指紋。
images[].has_ground_truth	boolean	影象是否具有真實標籤。

README

每個版本還帶有已提交的 README.md，以可讀形式呈現快照。其章節包括：

• Imaging Settings — 影象引數的表格。
• Aligner Reference Image — 對齊參考影象及其 SHA-256（僅當程式中包含該影象時）。
• Inspection Blocks — 每個模型一個子章節，標題為 <name> (<block type>)，包含該模型的 UUID、狀態和啟用標誌，隨後是特定型別的部分 — Classification Labels、Segmentation Classes、OCR Parameters、Unsupervised Parameters、Alignment Parameters，或測量區域數量。
• Node-RED Flow — 基本模式標誌、節點數量以及節點表格（ID、型別、名稱）。
• Test Set — 名稱、描述、作者、影象數量、具有真實標籤的影象數量以及搜尋區域。

更新日誌

釋出某個版本時，會將其引數快照與上一版本的快照進行比較，以生成更新日誌。該比較是結構化的 — 按上述 schema 逐欄位比較，其中列表（模型、標籤、類別、Node-RED 節點）透過穩定的標識而非位置進行匹配，因此重新排序不會顯示為變更。程式和測試集分別獨立比較，更新日誌根據已提交的快照按需生成，因此可用於任意兩個版本之間的比較。

變更按與快照相同的章節分組，某個章節只有在其中發生變化時才會出現。無差異的版本會被相應標記，而第一個版本則顯示完整的初始資訊，而非差異對比。