CVAT Task 命名規則 + 廠商代號對照

產出 2026-05-22(v12 · FOX/弗克司 §3 場域補建:新增 zone TC-1(projects.db zones project_id=12,name_zh『TC-1(場域待確認)』)。來源 ISMS 盤點——弗克司 2 隻鏡頭 cameraCode TC-1-102 / TC-1-124,同一台 NVR;siteCode 全 MAIN 非場域線索,TC-1 場域語意待確認。)· 機器版:spec.json
🤖 AI 摘要 1 命名格式 2 廠商代號 3 場域 4 Fallback 5 Pool 待修正 6 未登錄代號 7 完整範例

🤖 給 AI / Claude agent 的摘要

這頁很長。若你是 agent,請只讀本區塊,或改讀完整機器版 spec.json —— 不要逐段爬整頁(容易漏)。本頁其餘部分是給人看的展開版。
完整機器可讀版(結構化 JSON、可整份讀完):
· 線上:https://cvat-reports.pages.dev/naming_spec/spec.json
· 本機(Claude Code 直接讀此檔,免連網,內容等同 spec.json):C:\reports_maker\_naming_spec_data.json

命名格式

<廠商>_<場域>_<鏡頭>_<日期>_<編號>

必讀規則(完整版見 spec.json)

  1. 格式:<廠商>_<場域>_<鏡頭>_<日期>_<編號>,例 SINON_151_CH12_20260321_001。所有 CVAT task 一律套用此格式(下游 reports_maker / cvat-reports fetch 階段以此 regex 解欄位)。
  2. 廠商:全大寫英文代號,權威來源 = projects.db 的 code 欄,目前 12 筆。合法特例只有 PUBLIC(開源資料)與 UNKNOWN(資訊不明)。
  3. 場域:全大寫英文/數字/短碼,權威來源 = projects.db zones 表(per project)。各廠商規則見 zones.groups。
  4. 鏡頭:CH + 2 位零填補(CH01 不是 CH1)。無分類/結構性無編號 → CH00(注意:鏡頭欄不明也是用 CH00,不是 UNKNOWN)。
  5. 日期:YYYYMMDD,拍攝/生成日優先,無 metadata 才退回上傳日。
  6. 編號:3 位零填補,同四元組(廠商+場域+鏡頭+日期)從 001 遞增。
  7. Train/Val/Test:不進 task 名 → 走 CVAT 既有 subset 欄位。若刻意拆成 3 個獨立 task → 用編號 001/002/003 區分。不要把 _Train/_Val/_Test 當後綴加在名後(舊格式)。
  8. Fallback:任一欄位不明 → 填 UNKNOWN;唯一例外是鏡頭欄不明仍用 CH00。
  9. 不確定真實廠商/場域時填 UNKNOWN,不要造詞(如 INTERNAL、RAIVISION-當-內部彙整)—— 造詞會讓未來 trace 死路、汙染統計。
  10. 舊格式 task 一律不改名(避免 break 引用);需搬運時建新舊對照檔。
  11. Pool task(多廠商混合訓練池)目前命名 <source>_part<NN>of<MM> 屬已知偏離規格,不是有效的第二格式,待修正。
  12. 別名:iSeek / p10 task name 用小寫 jujia,廠商欄一律寫大寫 JUJIA。
  13. 未登錄代號禁止直接使用:付費客戶要先寫入 projects.db,非付費/結構性混合走特例處理。

合法範例

⚠ 命名規範以本檔為準。projects.db / ~/.claude memory 內的命名相關內容可能 stale —— 不要憑記憶裡的舊代號回答,先讀本檔或 spec.json。

⚠ 本頁為舊規範(5 段格式)· 新規範見 naming_spec_v2

自 2026-06-02 起改用新格式 <廠商>_[<ISMS鏡頭名稱>]_<日期>_<編號>(鏡頭名稱方括號框住、直接取 ISMS cameraCode;廢除每廠商場域/鏡頭對照表,場域改由 ISMS join 取回)。新規範:https://cvat-reports.pages.dev/naming_spec_v2/ (本機 C:\reports_maker\_naming_spec_v2_data.json)。本頁 5 段格式過渡期保留,供既存 task 解析與 ISMS join 場域對照參考;既存 task 全面遷移後本頁移除。新建 task 一律用新格式。

DB / Memory 已同步(2026-05-11)

~/.claude/memory/reference_vendor_map.md 表已對齊 projects.db:寶佳 = JUJIA、Rai Vision type=internal。

Memory 漂移待修(自 v7 起)

cvat-ops/reference_vendor_zone_conventions.md 尚未同步:仍寫 SINON CH01~CH16、JUJIA 各棟 CH 範圍,且 SANITATION/HSINTUNGYANG/GUANXI 仍列在「Pool 偽 vendor」段。本規範以本檔(_naming_spec_data.json)+ projects.db 為權威,那份 memory 不可信。

type=internal 說明

type=internal 標示為自家公司資料,非付費客戶;但在 task 命名上仍當廠商代號使用以維持 schema 一致性。

1. Task 命名格式

<廠商>_<場域>_<鏡頭>_<日期>_<編號>

適用範圍:所有 CVAT task 一律套用本規則。理由:下游 cvat-reports / reports_maker fetch 階段以此 regex 解欄位,多格式並存會讓報表解析爛掉。

欄位規則範例
廠商全大寫英文代號(權威來源 projects.db 的 code 欄)SINON / GREENIDEAS / CPC
場域全大寫英文 / 數字 / 短識別碼。權威來源:projects.db zones 表(per project)。固定特例見各廠商場域頁MINJING / 151 / AIGEN
鏡頭CH + 2 位零填補。無分類 / 結構性無編號 → CH00。各家規則見各廠商場域頁CH01 / CH16 / CH00
日期YYYYMMDD(拍攝/生成日優先,無 metadata 退回上傳日)20260423
編號3 位零填補;同四元組遞增 001 起001 / 002 / 003

Train / Val / Test 拆分

2. 廠商代號對照

2.1 DB 正式條目 2026-05-21 · 12 筆

主 DB:C:\Users\User\.claude\data\projects.db table projects(欄位 id, name, code, type, stage, notes)

中文代號TypeStageNotes
中油CPCclientactive
興農SINONclientactive
思維GREENIDEASclientactive
西門子SIEMENSclientactive
寶佳JUJIAclientactive別名 jujia(iSeek / p10 task name),廠商欄統一寫 JUJIA
宏全HONCHUANclientactive
火化場CREMATORYclientactive
愛烙達IRODAclientactive2026-05-12 加入;zone WAREHOUSE、GASFILL
清潔隊SANITATIONclientactive2026-05-12 升 DB;zone CHANGHUA
新東陽HSINTUNGYANGclientactive2026-05-12 升 DB;zone GUANXI(解開 GUANXI 之謎)
弗克司FOXclientactive2026-05-21 加入;2026-05-22 補 zone TC-1(ISMS 盤點)
Rai VisionRAIVISIONinternalactive自家公司產生的資料,非付費客戶;命名上仍當廠商代號使用以維持 schema 一致性

2.2 別名 / 系統內部代號

別名對應廠商用法
jujia寶佳iSeek 系統內 + cloud p12 / raicvat5090 p10 task name 用 jujia 字樣;廠商欄寫 JUJIA(保留原命名語料)。Confirm 來源:使用者 2026-04-29

2.3 特例(不進 DB)

中文代號用法
公開資料PUBLIC開源 / open dataset;非付費廠商,不入 projects 表
未知UNKNOWNtask 命名欄位資訊不明時填,非廠商實體

2.4 已入 DB 的命名規則備註 2026-05-12

既有命名規則資訊(DB 欄位無法完整表達的部份):

廠商Task name 形式CH 規則SITEfiresmoke 8005 cam 對應
SANITATION
清潔隊
<序號>號AI智慧工安辨識與火災預警系統_*序號零填補:一號→CH01、二號→CH02CHANGHUA(彰化)cam 221/222 是 8005 server 另一套編號,與 CVAT task name 無關,不寫入命名規則
HSINTUNGYANG
新東陽
ch<N>_<YYYYMMDD>_<NNN> 純鏡頭號鏡頭號零填補:ch6→CH06、ch24→CH24GUANXI(關西)cam 132/137/138/146 是 8005 server 另一套編號,與 CVAT task name 無關,不寫入命名規則

2.5 待整理(DB 未登錄)

目前無待整理項目(v6 的 SANITATION / HSINTUNGYANG 已升 DB)。

Vendor 代號使用規則 2026-05-06

3. 場域代號(依廠商)

權威來源:projects.db → zones 表,schema:id, project_id, code, name_zh, aliases, parent_zone, notes, stage。每廠商一段;尚未建 zones 的廠商顯示空白佔位,往後逐步補進。

分段跳轉:GREENIDEAS · SINON · JUJIA · CPC · IRODA · SANITATION · HSINTUNGYANG · SIEMENS · HONCHUAN · CREMATORY · FOX · RAIVISION · 通用特例 · 未登錄盤點

GREENIDEAS · 思維 — 場域

思維 / project_id=3 · 12 筆 zones · iSeek 系統來源

Zones

Code中文類型備註
MINJING民景企業點位iSeek 系統
SHIQIANG石墻活動中心點位iSeek
XUANWANG宣王宮點位iSeek,廟宇
SHANGAN山柑社區點位iSeek,社區
WUZHUOLIU吳濁流點位iSeek
WENNEI23塭內23號點位iSeek,含門牌號
DASDdasd待釐清iSeek 系統,疑似測試名
HSINCHUXIANGSHAN新竹香山上層集合多鏡頭混和
TOUFEN2頭份工業區2上層集合
MIAOLI苗栗上層集合
MIAOLIMOBILE苗栗移動車移動車移動車載鏡頭
TAINAN台南點位2026-05-21 ISMS 盤點新增

鏡頭規則

Legacy 命名拆解

⚠ parent_zone 欄位 schema 預留但 11 筆皆 NULL;『上層集合』目前僅在 notes 描述

SINON · 興農 — 場域

興農 / project_id=2 · 6 筆 zones

Zones

Code中文類型備註
151興農151分區iSeek 鏡頭群組編號 151
152興農152分區
153興農153分區
154興農154分區
155興農155分區
MAIN彙整不分區彙整桶不分區彙整桶

鏡頭規則

Legacy 命名拆解

JUJIA · 寶佳 — 場域

寶佳 / project_id=6 · 4 筆 zones · 別名 jujia(iSeek / p10 task name)

Zones

Code中文類型備註
A寶佳A工區A 工區/棟;iSeek 命名 jujia_A<N>
B寶佳B工區B 工區/棟;iSeek jujia_B<N>
C寶佳C工區C 工區/棟;iSeek jujia_C<N>
ALL多場域彙整彙整桶多場域彙整桶

鏡頭規則

Legacy 命名拆解

CPC · 中油 — 場域

中油 / project_id=1 · 2 筆 zones · 工安類別分場域

📌 新建 task 命名通則(強制)

CPC_HEIGHT_CH00_YYYYMMDD_NNN     # 高處作業
CPC_CONFINED_CH00_YYYYMMDD_NNN   # 侷限空間

Zones

Code中文類型備註
HEIGHT高處工安類別高處作業場景
CONFINED侷限工安類別侷限空間場景

Legacy 既存代號(待清理)

下列代號在既存正規 task 散用 — 不改名,但屬待修正歷史,不灌進 zones DB:

Legacy 命名拆解

IRODA · 愛烙達 — 場域

愛烙達 / project_id=9 · 5 筆 zones · 2026-05-12 新增

Zones

Code中文類型備註
WAREHOUSE倉庫場域倉庫場域;CH04 / CH05
GASFILL1樓灌瓦斯區場域灌瓦斯(gas filling)作業區;CH11
GASLEAK1樓漏瓦斯區場域2026-05-21 ISMS 盤點新增;對偶於 GASFILL;CH10
PRODUCTION2樓生產區場域2026-05-21 ISMS 盤點新增;CH09
CORRIDOR3F3樓走道場域2026-05-21 ISMS 盤點新增;含後方走道與走道+貨梯;CH15 / CH16

鏡頭 → 場域對應

使用者指派的鏡頭位置(2026-05-12 起)。CH = 頻道號零填補(頻道4→CH04、頻道11→CH11)。其他 CH 對應位置待補。

CH場域位置
CH04WAREHOUSE倉庫進料區
CH05WAREHOUSE倉庫大門口
CH09PRODUCTION2樓生產區
CH10GASLEAK1樓漏瓦斯區
CH11GASFILL1樓灌瓦斯區
CH15CORRIDOR3F3樓後方走道
CH16CORRIDOR3F3樓走道+貨梯

Legacy 命名拆解

⚠ 正規 task 命名規則尚未拍板,目前 legacy 形式仍在使用

SANITATION · 清潔隊 — 場域

清潔隊 / project_id=10 · 1 筆 zone · 2026-05-12 升 DB

📌 新建 task 命名通則

SANITATION_CHANGHUA_CH<NN>_YYYYMMDD_NNN

Zones

Code中文類型備註
CHANGHUA彰化據點清潔隊據點所在地

Legacy 命名拆解

⚠ firesmoke 8005 server 端 cam 221/222 是另一套編號,與 CVAT task name ch 不相關,不寫入命名規則

HSINTUNGYANG · 新東陽 — 場域

新東陽 / project_id=11 · 2 筆 zones · 2026-05-12 升 DB ·「新東陽」官方英文 Hsin Tung Yang 全大寫

📌 新建 task 命名通則

HSINTUNGYANG_<SITE>_CH<NN>_YYYYMMDD_NNN

Zones

Code中文類型備註
GUANXI關西據點新東陽據點所在地
ZHONGXIAO1忠孝一店門市2026-05-21 ISMS 盤點新增;忠孝一店門市

Legacy 命名拆解

🔍 GUANXI 之謎已釐清(2026-05-12)

先前 raicvat5090 p2 (116 tasks) + p5 (3 tasks) 散用的偽 vendor GUANXI,其實是 HSINTUNGYANG 的 zone.code(關西)。舊 task 把 site 當 vendor 用屬命名錯置。既存不改名,新 task 一律 vendor=HSINTUNGYANG + site=GUANXI。

⚠ firesmoke 8005 server 端 cam 132/137/138/146 是另一套編號,與 CVAT task name ch 不相關

SIEMENS · 西門子 — 場域

西門子 / project_id=4
尚未建 zones(待 Q5 討論)。多 demo 案場性質(phone_safety / hatch / height ...),無固定地理場域。命名策略待議。

HONCHUAN · 宏全 — 場域

宏全 / project_id=7
未盤點。待有 task 出現再整理。

CREMATORY · 火化場 — 場域

火化場 / project_id=8
未盤點。待有 task 出現再整理。

FOX · 弗克司 — 場域

弗克司 / project_id=12 · 1 筆 zones · 2026-05-22 ISMS 盤點補建

Zones

Code中文類型備註
TC-1TC-1(場域待確認)場域2026-05-22 ISMS 盤點;弗克司 2 隻鏡頭 cameraCode TC-1-102(堆高機工安)/ TC-1-124(PPE),同一台 NVR;TC-1 場域語意未確認,暫以 cameraCode 前綴當代號

鏡頭規則

⚠ ISMS 端查無可讀場域名稱,TC-1 取自 cameraCode 前綴;語意確認後更新 zh / DB name_zh

RAIVISION · Rai Vision — 場域

Rai Vision / project_id=5 · internal 非外部廠商
全 UNKNOWN。自家測試資料,無場域概念。

通用特例

跨 project 通用固定代號(不掛 vendor)

Zones

Code中文類型備註
AIGENAI 生成 / 合成資料通用任何 project 皆可用

未登錄盤點

已盤點但未登錄至 projects.db / zones 的廠商或資料來源

水利署 / 河川分署系列(待 Q4 討論)

PUBLIC(開源資料集)

Pool task 偽 vendor(不再使用)

遇到 zones 表沒有的廠商新場域

INSERT INTO zones (project_id, code, name_zh, notes) VALUES (?, 'XXX', '中文名', '來源備註');

4. Fallback 規則

舊 task 處理

5. Pool task 命名待修正

狀態:偏離標準,不是有效的第二格式

訓練資料池 task(多廠商混合切 train/val/test)目前命名為 <source>_part<NN>of<MM> 屬已知偏離規格,僅作既存記錄,待後續設計修正方案。

既存 pool 命名形貌

<source>_part<NN>of<MM>

範例:raicvat_p9_part01of03 / cppe5_part02of03 / fall_p6_part03of03

為何要修正

處置

6. 既存未登錄代號盤點 (2026-05-06)

5090 p2 firesmoke 等舊 task 已散用以下未登錄 vendor 代號:

代號出現次數推測語意處置
INTERNAL670(5090 p2)內部彙整 / 多客戶混合不該當 vendor 用(屬 pool task);既存不改名,新 task 不再用
PURCHASED15(5090 p2)採購來的資料同 INTERNAL
GUANXI116(5090 p2)+ 3(5090 p5)HSINTUNGYANG 的 zone「關西」已釐清 2026-05-12;GUANXI 是 site 不是 vendor。舊 task 把 site 當 vendor 用屬命名錯置;既存不改名,新 task 一律 vendor=HSINTUNGYANG + site=GUANXI

7. 完整範例

GREENIDEAS_AIGEN_CH07_20260423_001   # 思維(廠商) AI生成(場域) 第7鏡頭 2026-04-23 第1筆
SINON_151_CH12_20260321_001          # 興農(廠商) 151區(場域) 第12鏡頭 2026-03-21 第1筆
SINON_151_CH12_20260321_002          # 同上第2筆
CPC_UNKNOWN_CH00_20260401_001        # 中油 場域不明 無鏡頭分類 2026-04-01 第1筆
PUBLIC_AIGEN_CH00_UNKNOWN_001        # 開源 AI合成 無鏡頭 日期不明 第1筆