Hướng dẫn sử dụng

Viết từng bước theo trình tự “ở trang nào → nhấn vào đâu → điền gì → thấy gì”, làm theo là đi được từ con số không đến triển khai. Toàn bộ quy trình chạy ngoại tuyến trên máy, ảnh và dữ liệu không rời khỏi máy tính của bạn (chỉ khi bạn chủ động dùng “Xuntong AI” để gán nhãn hỗ trợ thì ảnh mới được gửi tới nền tảng Xuntong AI).

01 Cài đặt và khởi động lần đầu

1.1 Tải và cài đặt

  1. Mở trang chủ https://wulabel.xiaowuiot.com, nhấn Tải xuống ở góc trên bên phải, hoặc tải từ trang Release trên GitHub.
  2. Windows: tải Wulabel_<phiên-bản>_x64-setup.exe, nhấp đúp và cài theo hướng dẫn. Cài xong, mở Wulabel từ menu Start hoặc màn hình nền.
  3. Mac: tải Wulabel_<phiên-bản>_universal.dmg, nhấp đúp để mở, rồi kéo Wulabel vào thư mục “Ứng dụng” (Applications).
  4. Linux (từ v0.4.0): tải Wulabel_<phiên-bản>_amd64.deb, chạy sudo apt install ./Wulabel_<phiên-bản>_amd64.deb trong terminal, cài xong thì mở Wulabel từ menu ứng dụng. Bạn cũng có thể tải .AppImage, chạy chmod +x Wulabel_<phiên-bản>_amd64.AppImage rồi nhấp đúp để chạy, không cần cài. Máy ARM (Phytium, Kunpeng) thì tải Wulabel_<phiên-bản>_arm64.deb hoặc Wulabel_<phiên-bản>_aarch64.AppImage (từ v0.4.2), cách dùng giống hệt.

1.2 Làm quen với giao diện chính

Mở phần mềm, bạn sẽ thấy trang Dự án trước tiên. Sau khi mở một dự án, bên trái là thanh điều hướng, từ trên xuống dưới gồm:

TrangDùng để làm gì
Dự ánTạo, mở, chuyển đổi dự án
Dữ liệuNhập ảnh / video / tập dữ liệu, quản lý ảnh, xuất tập dữ liệu
Gán nhãnVẽ khung, vẽ đa giác, chọn lớp, chấm điểm khóa, hỗ trợ AI và gán nhãn trước
Kiểm tra dữ liệuTìm ra các vấn đề như gán thiếu, gán sai, ảnh trùng lặp
Huấn luyệnChọn mô hình, chỉnh tham số, bắt đầu huấn luyện, xem lịch sử huấn luyện
Đánh giáXem chỉ số, ma trận nhầm lẫn, ca sai, ngưỡng đề xuất, kiểm thử báo nhầm, xuất báo cáo
Triển khaiKiểm thử trực tiếp, xuất mô hình, tạo gói dịch vụ suy luận, nhập dữ liệu hồi lưu từ hiện trường
Cộng tácCộng tác nhiều người thời gian thực: bật chia sẻ (mạng LAN / trực tuyến), thành viên, giao nhiệm vụ, thống kê tiến độ
Cài đặtCài môi trường huấn luyện, nguồn tải, Xuntong AI

Góc trên bên phải có nút Phản hồi và Đóng dự án.

02 Cài đặt: môi trường huấn luyện, nguồn tải, Xuntong AI

Nếu bạn chỉ gán nhãn, nhập và xuất dữ liệu mà không huấn luyện, có thể tạm bỏ qua chương này.

2.1 Cài môi trường huấn luyện một chạm

  1. Nhấn Cài đặt ở bên trái.
  2. Xem mục “Môi trường huấn luyện”:
    • Dòng GPU hiện GPU đã phát hiện, VRAM, driver và phiên bản CUDA được hỗ trợ. Nếu không có GPU NVIDIA sẽ báo “chỉ có thể huấn luyện bằng CPU (sẽ chậm hơn nhiều)”.
    • Ô chọn Phiên bản PyTorch sẽ tự chọn sẵn phiên bản khuyên dùng (có chữ “Khuyên dùng”), thường không cần đổi:
      • CUDA 12.8: GPU đời mới như dòng RTX 50;
      • CUDA 13.0: cần driver mới;
      • CUDA 11.8: GPU và driver đời cũ;
      • Bản CPU: không có GPU NVIDIA.
  3. (Không bắt buộc) Vị trí cài đặt: mặc định cài vào thư mục dữ liệu cục bộ trên ổ C. Nếu ổ C sắp đầy, nhấn chọn để chuyển sang ổ còn nhiều dung lượng, rồi nhấn Lưu.
  4. Nhấn Cài đặt một chạm. Bản GPU khoảng 3 GB, sẽ tự tải uv, Python 3.11, PyTorch, dưới thanh tiến trình có hiện thời gian còn lại. Chỉ cần cài một lần.
  5. Cài xong, trạng thái chuyển thành Sẵn sàng, bên dưới hiện “GPU khả dụng (cuda)”.

Môi trường huấn luyện là độc lập, không ảnh hưởng đến các bản Python khác trong hệ thống.

2.2 Nguồn tải

  1. Ở mục “Nguồn tải”, nhấn Đo tốc độ và đề xuất. Phần mềm sẽ tải thử vài MB từ nguồn chính thức và từ mirror Trung Quốc để đo tốc độ, rồi tự chọn nguồn nhanh hơn.
  2. Khi chọn “Mirror Trung Quốc”, các mô hình hỗ trợ như SAM, gợi ý bằng văn bản cũng sẽ được tải từ mirror Trung Quốc (hf-mirror.com).

2.3 Xuntong AI (không bắt buộc)

Bạn chỉ cần phần này khi muốn dùng mô hình của nền tảng Xuntong AI để tự động gán nhãn, tải mô hình lên, lấy ảnh cảnh báo về, hoặc dùng “Trung chuyển chính thức của Xuntong” để cộng tác trực tuyến:

  1. Ở mục “Xuntong AI”, nhấn Đăng nhập tài khoản Xuntong AI.
  2. Trình duyệt sẽ mở trang web Xuntong AI: nếu chưa đăng nhập thì đăng nhập trước (giống như khi bạn đăng nhập Xuntong bình thường), rồi đối chiếu mã xác nhận trên trang web với mã hiện trong Wulabel, thấy giống nhau thì nhấn Cho phép.
  3. Quay lại Wulabel, sau vài giây sẽ tự hiện Đã đăng nhập, tên tài khoản, gói dịch vụ và hạn mức còn lại, cùng các cách nhận diện có thể dùng (nhận diện theo lớp của dự án, mô hình chuyên dụng đã đăng ký trên nền tảng, nhận diện tổng quát bằng mô hình lớn). Không cần sao chép dán Key.
  4. Nếu trình duyệt không tự mở, nhấn Mở lại, hoặc sao chép địa chỉ trong hộp thoại rồi tự mở.
  5. Đăng xuất: Key trên máy tính này sẽ bị xóa, Key được tạo tự động khi đăng nhập cũng sẽ bị thu hồi trên nền tảng.

Nếu bạn đã có API Key, hoặc Xuntong được triển khai riêng (private), nhấn Nâng cao: nhập thủ công API Key, địa chỉ nền tảng triển khai riêng, điền xong thì nhấn Lưu và kiểm tra kết nối. Trạng thái kết nối sẽ luôn hiện trong mục này.

2.4 Dùng môi trường Python có sẵn (nâng cao)

Nếu bạn đã có môi trường Python cài sẵn PyTorch, có thể không cần tải lại:

  1. Mở rộng mục “Dùng môi trường Python có sẵn (nâng cao)”.
  2. Nhấn Chọn python.exe, chọn python.exe trong môi trường đó (ví dụ D:\envs\torch\Scripts\python.exe).
  3. Nhấn Lưu. Môi trường này cần có torch, torchvision, numpy, pillow; muốn xuất ONNX thì cần thêm onnx.
  4. Muốn quay lại môi trường của phần mềm: xóa trống đường dẫn rồi lưu.

2.5 Kiểm tra cập nhật

Mỗi lần khởi động, phần mềm tự kiểm tra một lần xem có phiên bản mới không; nếu có, góc dưới bên phải sẽ hiện thông báo. Nhấn Cập nhật ngay, phần mềm sẽ tải bản mới ở chế độ nền, kiểm tra xong thì tự cài, cài xong tự mở lại, bạn không phải nhấn nút nào (Windows chỉ hiện một thanh tiến trình cài đặt; trên Linux, nếu cài bằng .deb thì từ v0.4.2 cũng tự cập nhật được, khi cài có thể cần nhập mật khẩu hệ thống một lần). Dự án và dữ liệu đều được giữ nguyên (từ v0.4.1). Bạn cũng có thể nhấn “Tải xuống” để mở trang tải. Không muốn thấy thông báo của một phiên bản nào đó nữa thì nhấn “Không nhắc lại phiên bản này”. Trong mục “Giới thiệu & cập nhật” ở cuối trang Cài đặt, bạn cũng có thể nhấn Kiểm tra cập nhật thủ công.

Khi kiểm tra cập nhật, phần mềm chỉ gửi phiên bản phần mềm, loại hệ điều hành và một mã ẩn danh ngẫu nhiên, dùng để ước tính khoảng bao nhiêu người đang dùng; không có ảnh, dự án hay bất kỳ thông tin cá nhân nào. Không muốn kết nối mạng để kiểm tra thì tắt Tự động kiểm tra cập nhật khi khởi động trong “Giới thiệu & cập nhật”.

2.6 Ngôn ngữ, giao diện và công tắc Xuntong AI

Ở đầu trang Cài đặt, bạn có thể đổi các mục sau:

03 Tạo và mở dự án

Mỗi dự án là một thư mục: ảnh (bản sao chép vào), nhãn, mô hình, lịch sử huấn luyện đều nằm trong đó. Chép cả thư mục sang máy khác là mở được ngay.

Nếu là lần đầu dùng, phía trên trang “Dự án” có hướng dẫn cho người mới, dẫn bạn đi qua sáu bước: cài môi trường huấn luyện, tạo dự án, nhập ảnh, gán nhãn một ít, huấn luyện, gán nhãn trước và triển khai; bước nào làm xong sẽ tự được đánh dấu. Nhấn × ở góc trên bên phải để đóng, sau này nhấn “Hiện hướng dẫn cho người mới” để mở lại.

Thẻ của mỗi dự án trong “Dự án gần đây” hiện ảnh bìa, số ảnh, số ảnh đã gán nhãn (thanh tiến độ) và số lần đã huấn luyện, giúp bạn nhìn qua là biết dự án đang đến đâu.

3.1 Tạo dự án

  1. Ở trang Dự án, nhấn Dự án mới.
  2. Tên dự án: ví dụ “Phát hiện mũ bảo hộ ở công trường”.
  3. Vị trí lưu: mặc định là “Tài liệu/Wulabel”, cũng có thể nhấn Duyệt tệp để đổi sang thư mục khác, dự án sẽ được tạo bên trong thư mục này.
  4. Loại nhiệm vụ (không đổi được sau khi tạo):
    Nhiệm vụCách gán nhãnPhù hợp với
    Phát hiện đối tượngKhung chữ nhậtTìm vị trí mũ bảo hộ, xe cộ, khói lửa
    Phân đoạn đối tượngĐường viền đa giácCần hình dạng chính xác: vùng nước đọng, đống rác, vùng lỗi
    Phân loại ảnhMỗi ảnh một lớpẢnh “bình thường / bất thường”, phân loại cảnh
    Điểm khóaKhung đối tượng + chấm từng điểm theo mẫuTư thế người (ngã, leo trèo), các bộ phận quan trọng của vật thể
  5. Lớp (có thể để trống): ghi sẵn các lớp cần gán nhãn, phân cách bằng dấu phẩy hoặc xuống dòng, ví dụ “mũ bảo hộ, người, áo phản quang”. Để trống thì sau này thêm ở trang Gán nhãn lúc nào cũng được.
  6. Nhấn Tạo, sẽ hiện thông báo “Đã tạo dự án “…”” và dự án tự mở ra.

3.2 Mở dự án

04 Nhập dữ liệu

Nhấn Dữ liệu ở bên trái.

4.1 Nhập ảnh hoặc thư mục

  1. Trước tiên, chọn cách nhập ở đầu trang:
    • Sao chép vào dự án: ảnh được chép vào thư mục dự án, có thể mang cả dự án đi nơi khác (khuyên dùng);
    • Chỉ tham chiếu đường dẫn gốc: chỉ ghi lại vị trí gốc của ảnh, không tốn thêm dung lượng, nhưng không được di chuyển ảnh gốc.
  2. Nhập:
    • Nhấn Nhập thư mục, chọn một thư mục (sẽ tự tìm ảnh trong các thư mục con);
    • Hoặc nhấn Thêm cách nhập → Nhập tệp ảnh, chọn vài ảnh;
    • Hoặc kéo thả thẳng ảnh, thư mục vào cửa sổ, khi thấy “Thả chuột để nhập ảnh hoặc video” thì thả ra. Nếu kéo vào là tệp video, hộp thoại “Trích khung hình từ video” sẽ mở ra ngay (xem 4.2).
  3. Trong lúc nhập sẽ hiện tiến độ “Đã xử lý N / M ảnh (tính dấu vân tay, tạo ảnh thu nhỏ)”; chọn nhầm thì có thể nhấn Dừng, các ảnh đã xử lý vẫn được đưa vào dự án như thường. Xong sẽ báo đã thêm bao nhiêu ảnh, bỏ qua bao nhiêu ảnh trùng; nhấn Bắt đầu gán nhãn trong thông báo để chuyển thẳng sang trang Gán nhãn.

Khi nhập, phần mềm tự loại trùng theo nội dung (cùng một ảnh không bị nhập hai lần) và xoay đúng chiều theo thông tin EXIF của ảnh.

Ảnh mẫu cảnh tuần tra
Ví dụ: ảnh cảnh tuần tra đã nhập — xe đỗ chắn lối thoát hiểm, xe điện vào thang máy, không đội mũ bảo hộ, thú cưng đi vào, hút thuốc, khói và lửa…

4.2 Nhập video (trích khung hình)

  1. Nhấn Thêm cách nhập → Nhập video (trích khung hình), chọn một hoặc nhiều tệp video.
  2. Trong hộp thoại “Trích khung hình từ video”, thiết lập:
    • Mỗi N giây trích 1 khung hình: đối tượng thay đổi chậm thì đặt khoảng cách dài hơn, tránh ra một loạt ảnh gần như giống nhau;
    • Tối đa mỗi video N khung hình (0 = không giới hạn).
  3. Nhấn Bắt đầu trích khung hình. Lần đầu dùng sẽ tự tải ffmpeg (khoảng 90 MB), sau đó không cần tải lại. Đặt sai tham số thì có thể nhấn Dừng, các khung hình đã trích ra vẫn được nhập như thường.
  4. Các khung hình trích ra được chép vào dự án và tự loại trùng theo nội dung. Xong sẽ báo “Đã trích M khung hình từ N video: thêm mới K ảnh”.

4.3 Trích khung hình từ luồng video (RTSP / trực tiếp / phát lại)

  1. Nhấn Thêm cách nhập → Trích khung hình từ luồng video (RTSP / trực tiếp / phát lại).
  2. Điền địa chỉ: camera RTSP (rtsp://…), hoặc địa chỉ phát trực tiếp, phát lại, video theo yêu cầu dạng http(s) (mp4, m3u8, flv).
    • Hikvision: rtsp://<tài-khoản>:<mật-khẩu>@IP:554/Streaming/Channels/101 (luồng chính) hoặc 102 (luồng phụ)
    • Dahua: rtsp://<tài-khoản>:<mật-khẩu>@IP:554/cam/realmonitor?channel=1&subtype=0
  3. Nhấn Kiểm tra kết nối, sẽ hiện độ phân giải và cho biết đây là “Luồng trực tiếp (vô hạn, cần đặt giới hạn)” hay “Luồng phát lại · Thời lượng …”.
  4. Thiết lập:
    • Mỗi N giây trích 1 khung hình;
    • Trích tối đa N khung hình, Thu tối đa N phút (0 = không giới hạn, chỉ dùng cho phát trực tiếp). Phát trực tiếp là luồng vô hạn, phải đặt ít nhất một trong hai giới hạn này;
    • Chọn Bỏ qua khung hình gần như giống hệt: khi cảnh đứng yên sẽ đỡ lưu ảnh trùng.
  5. Nhấn Bắt đầu thu thập. Ảnh vừa thu vừa được đưa vào dự án, bạn sẽ thấy từng ảnh lần lượt xuất hiện ở trang Dữ liệu.
  6. Trong lúc thu, bạn có thể nhấn Thu nhỏ để làm việc khác, góc dưới bên phải sẽ hiện “Đang thu · đã trích N khung hình”, nhấn Mở rộng để quay lại; nhấn Dừng thu thập để kết thúc bất cứ lúc nào, ảnh đã thu vẫn được giữ lại.
  7. Ảnh thu được lưu trong thư mục images/stream_<địa-chỉ>_<thời-gian>/ của dự án, xong có thể nhấn Mở thư mục để xem.

Tài khoản và mật khẩu chỉ được dùng khi thu thập, phần mềm không ghi địa chỉ có mật khẩu vào tên thư mục dự án.

4.4 Nhập tập dữ liệu có nhãn

Nếu đã có dữ liệu được gán nhãn ở nơi khác, bạn có thể nhập cả nhãn vào:

  1. Nhấn Thêm cách nhập, chọn theo loại dự án:
    • Dự án phát hiện / phân đoạn: Nhập tập dữ liệu có nhãn (YOLO / COCO / VOC), hỗ trợ YOLO (kể cả seg), COCO (kể cả phân đoạn), VOC;
    • Dự án điểm khóa: Nhập tập dữ liệu có nhãn (YOLO-pose / điểm khóa COCO);
    • Dự án phân loại: Nhập tập dữ liệu phân loại (mỗi lớp một thư mục), mỗi thư mục con trong thư mục đã chọn là một lớp (cũng có thể có thêm một tầng train / val).
  2. Chọn thư mục gốc của tập dữ liệu, phần mềm tự nhận dạng định dạng.
  3. Xong sẽ báo “Đã nhập tập dữ liệu YOLO” hoặc tương tự, kèm các lớp mới được thêm.

4.5 Thao tác hàng loạt, hoàn tác, xóa, xóa sạch

Các thẻ thống kê ở phía trên trang Dữ liệu (Chưa gán nhãn, Đã gán nhãn, Đã bỏ qua) có thể nhấp vào: nhấp một lần để chỉ xem loại ảnh đó, nhấp lần nữa để trở về tất cả; các nút lọc bên dưới cũng vậy.

Tất cả nằm trong menu Quản lý:

Khi xóa, nhãn của ảnh cũng bị xóa theo và không khôi phục được; bản sao ảnh đã chép vào dự án sẽ bị xóa, ảnh gốc trên máy tính của bạn không bị ảnh hưởng.

4.6 Sàng lọc chất lượng ảnh

Ảnh mờ, quá tối, cháy sáng vừa khó gán nhãn, vừa dễ làm mô hình học lệch khi huấn luyện. Bạn có thể lọc chúng ra trước:

  1. Nhấn Quản lý → Sàng lọc chất lượng ảnh (mờ, quá tối, cháy sáng).
  2. Mặc định chọn sẵn Chỉ xem ảnh chưa gán nhãn; muốn kiểm tra tất cả thì bỏ chọn.
  3. Nhấn Bắt đầu sàng lọc.
  4. Kết quả được chia theo vấn đề: Mờ, Quá tối, Cháy sáng, Độ tương phản thấp; nhấp vào các nhãn phía trên để lọc. Dưới mỗi ảnh có giá trị độ nét, độ sáng, tỉ lệ cháy sáng, độ tương phản.
  5. Xử lý:
    • Xem từng ảnh: chuyển sang trang Gán nhãn để xem từng ảnh và tự quyết định;
    • Đặt thành bỏ qua: đánh dấu “Bỏ qua”, không dùng để huấn luyện (ảnh vẫn còn, sau này có thể hoàn tác);
    • Xóa: xóa luôn.

4.7 Lấy ảnh cảnh báo từ Xuntong AI

Sau khi mô hình được triển khai lên nền tảng Xuntong AI, ảnh chụp cảnh báo ở hiện trường (nhất là báo nhầm, bỏ sót) chính là dữ liệu đáng bổ sung nhất:

  1. Trước tiên cấu hình Xuntong AI trong Cài đặt (xem 2.3).
  2. Ở trang Dữ liệu, nhấn Thêm cách nhập → Lấy ảnh cảnh báo từ Xuntong AI.
  3. Chọn khoảng thời gian (1 / 3 / 7 ngày gần đây; nền tảng chỉ giữ ảnh cảnh báo 7 ngày, nhớ lấy về định kỳ), mô hình (tất cả hoặc một mô hình), Tối đa N ảnh. Chỉ tài khoản Xuntong đã cấu hình kênh đẩy thông báo mới có bản ghi cảnh báo.
  4. Mặc định chọn sẵn Dùng khung nền tảng nhận diện được làm nhãn trước: khớp theo tên lớp với các lớp trong dự án, lớp nào chưa có sẽ được tạo mới.
  5. Nhấn Bắt đầu lấy về. Ảnh được lưu trong thư mục images/xuntong_<thời-gian>/ của dự án, khung nhận diện hiện bằng nét đứt (nguồn “Xuntong”).
  6. Vào trang Gán nhãn để kiểm tra: xóa khung báo nhầm (ảnh không có đối tượng thì nhấn Enter để hoàn tất luôn, dùng làm mẫu âm), bổ sung chỗ bỏ sót, rồi huấn luyện lại.

05 Gán nhãn

Nhấn Gán nhãn ở bên trái.

5.1 Làm quen với trang Gán nhãn

Mọi thay đổi đều được tự động lưu, không cần lưu thủ công.

5.2 Thêm và quản lý lớp

  1. Trong khối “Lớp” bên phải, gõ vào ô “Tên lớp mới, nhấn Enter để thêm”, ví dụ “mũ bảo hộ”, rồi nhấn Enter.
  2. 9 lớp đầu có thể đổi nhanh bằng phím số 1–9, lớp hiện tại được tô sáng.
  3. Nhấn nút chỉnh sửa cạnh lớp để:
    • Đổi tên, đổi màu;
    • Điền từ gợi ý tiếng Anh (dùng cho tự động gán nhãn bằng “Gợi ý bằng văn bản”, có thể viết nhiều từ, cách nhau bằng dấu phẩy, ví dụ helmet, hard hat);
    • Điền mô tả nhận diện (dùng cho “Nhận diện theo lớp của dự án” của Xuntong AI: lớp này cụ thể là gì, trường hợp nào tính / không tính, ví dụ “người không đội mũ bảo hộ; đội mũ nhưng không cài quai cũng tính”);
    • Xóa lớp. Nếu lớp này đã có nhãn, có thể chọn một lớp khác trong “Gộp vào…”, các nhãn sẽ được đổi sang lớp đó, không bị mất (rất tiện khi gán nhầm lớp hoặc muốn gộp hai lớp làm một); không chọn thì xóa luôn, nhãn bị xóa theo.

5.3 Phát hiện đối tượng: vẽ khung

  1. Nhấn 1–9 để chọn lớp.
  2. Nhấn R (hoặc nhấn công cụ vẽ khung bên trái), rồi giữ chuột và kéo ra một khung trên đối tượng.
  3. Điều chỉnh: nhấn V để chuyển sang công cụ chọn, nhấp vào khung rồi kéo để di chuyển, kéo cạnh và góc để đổi kích thước.
  4. Xóa: chọn khung rồi nhấn Del hoặc Backspace; nhấn Esc để bỏ chọn.
  5. Đổi lớp: chọn khung rồi nhấn phím số, hoặc đổi trong “Đối tượng trong ảnh” bên phải.
  6. Nhấn H để ẩn / hiện tên lớp trên khung, tiện khi khung dày đặc.
Minh họa gán nhãn: vẽ khung và chọn lớp cho khung
Minh họa gán nhãn: vẽ khung trên ảnh, chọn lớp cho từng khung. Trong ảnh, một bức ảnh công trường được gán cùng lúc hai lớp “không đội mũ bảo hộ” (đỏ) và “mũ bảo hộ” (xanh lá).

5.4 Phân đoạn đối tượng: vẽ đa giác

  1. Chọn lớp, nhấn R.
  2. Nhấp từng điểm một dọc theo mép đối tượng.
  3. Nhấp đúp hoặc nhấn Enter để khép đa giác; nhấp nhầm thì nhấn Backspace để bỏ điểm vừa đặt.
  4. Chọn đa giác rồi kéo các đỉnh để tinh chỉnh.
  5. Cách nhanh hơn là nhấn S để dùng chọn thông minh SAM, nhấp một lần là tự ra đường viền (xem chương 6).

5.5 Phân loại ảnh: một phím một ảnh

  1. Xem ảnh, nhấn phím số 1–9 để chọn lớp. Góc trên bên trái khung hình hiện lớp hiện tại.
  2. Bật công tắc Chọn xong sang ảnh sau ở bên phải, nhấn phím số xong là tự chuyển sang ảnh sau, một phím một ảnh.
  3. Nhấn Del để xóa lớp của ảnh này; nhấn Ctrl+D để dùng lại lớp của ảnh trước.

5.6 Điểm khóa

  1. Trước tiên xem Mẫu điểm khóa ở bên phải. Mặc định là “COCO người 17 điểm” (mũi, mắt trái, mắt phải… mắt cá chân trái, mắt cá chân phải). Muốn đổi thì nhấn Chỉnh sửa:
    • Tên mẫu;
    • Tên điểm (mỗi dòng một tên, thứ tự điểm chính là thứ tự nhấp khi gán nhãn);
    • Đường nối (mỗi dòng một cặp số thứ tự, ví dụ 1-2, dùng để vẽ khung xương);
    • Cũng có thể nhấn Dùng COCO người 17 điểm để về mặc định.
    • Khi đã có nhãn điểm khóa thì chỉ đổi được tên và đường nối, không thêm bớt số điểm được.
  2. Chọn lớp, nhấn R để vẽ khung đối tượng.
  3. Vẽ khung xong, làm theo gợi ý để lần lượt chấm từng điểm khóa (dưới khung hình có gợi ý điểm cần chấm hiện tại, ví dụ “Nhấp Vai trái (6/17)”):
    • Nhấp bình thường: điểm nhìn thấy;
    • Shift + nhấp: điểm bị che khuất;
    • N: bỏ qua điểm không nhìn thấy;
    • Backspace: quay lại điểm trước;
    • Esc: kết thúc đối tượng này.
  4. Tinh chỉnh: chọn đối tượng rồi kéo trực tiếp các điểm khóa. Bên phải liệt kê trạng thái của từng điểm; nhấp vào tên để đặt lại riêng điểm đó; nhấp vào trạng thái để chuyển giữa “nhìn thấy / bị che khuất”.
  5. Chọn đối tượng rồi nhấn Đặt lại điểm khóa để gán lại từ điểm đầu tiên.

5.7 Sao chép ảnh trước, hoàn tác và làm lại

5.8 Xong, bỏ qua

Khi gán nhãn một mình thì không cần duyệt, ảnh đã gán đối tượng tự động tính là “Đã gán nhãn” và được dùng ngay để huấn luyện. Khối “Xong” bên phải:

Khi gán xong ảnh cuối cùng sẽ hiện thông báo “Đã gán nhãn xong đợt này”, cho biết số ảnh đã gán nhãn và chưa gán, có thể nhấn Đi huấn luyện hoặc Tiếp tục gán nhãn ảnh chưa gán.

Chọn bộ lọc “Đã bỏ qua” ở phía trên để tìm lại các ảnh đã bỏ qua mà xem lại.

Chỉ khi cộng tác nhóm (đã thêm thành viên hoặc bật cộng tác thời gian thực) mới có quy trình duyệt; khi đó khối này đổi thành “Duyệt”, các nút là Duyệt và ảnh sau, Trả lại, xem chương 9.

5.9 Khung hình video: nội suy khung hình chính, theo dõi về sau

Dùng cho dự án phát hiện và điểm khóa. Khung hình trích từ video (cùng một thư mục, sắp theo tên tệp) không cần vẽ từng khung hình một.

Nội suy khung hình chính (đoạn đối tượng di chuyển đều):

  1. Chuyển tới khung hình đầu đoạn, gán nhãn đủ các đối tượng (đây là một “khung hình chính”).
  2. Chuyển tới khung hình cuối đoạn, cũng gán nhãn các đối tượng đó.
  3. Ở khung hình cuối này, nhấn nút Nội suy khung hình chính bên trái.
  4. Phần mềm ghép các đối tượng ở hai đầu theo lớp và vị trí, rồi tự bổ sung các khung hình ở giữa. Sẽ báo “Đã nội suy M đối tượng trên N khung hình ở giữa”; đối tượng nào ở hai đầu không khớp sẽ được nói rõ riêng.

Theo dõi về sau (khi đối tượng di chuyển không đều):

  1. Gán nhãn đủ các đối tượng ở khung hình hiện tại.
  2. Nhấn nút Theo dõi về sau bên trái, trong cửa sổ nhỏ hiện ra điền Số khung hình (mặc định 30, tối đa 500), nhấn Theo dõi.
  3. Phần mềm bắt đầu từ các khung của khung hình này và theo dõi lần lượt từng khung hình. Đối tượng bị che hoặc bị mất dấu thì dừng; gặp khung hình phía sau đã gán nhãn thủ công cũng dừng, không ghi đè nhãn do người gán.
  4. Theo dõi xong sẽ tự chuyển tới khung hình cuối cùng theo dõi được. Khung nào lệch thì kéo lại cho đúng (khung đã kéo sẽ thành nhãn thủ công, khung hình đó trở thành khung hình chính mới), rồi nhấn Theo dõi về sau để theo dõi tiếp.

Khung tạo ra bằng nội suy và theo dõi hiện nguồn là “Nội suy”, “Theo dõi” trong “Đối tượng trong ảnh” bên phải. Nội suy hoặc theo dõi lại sẽ thay thế các khung này, khung gán thủ công không bị đụng tới.

Mẹo đỡ tốn công: gán nhãn tay một ít trước (vài chục đến một hai trăm ảnh), huấn luyện một mô hình bản đầu, rồi dùng nó gán nhãn trước các ảnh còn lại (chương 12), bạn chỉ cần sửa chỗ sai.

06 Gán nhãn có hỗ trợ AI

Kể cả khi chưa có mô hình của riêng mình, bạn vẫn có thể nhờ AI gán nhãn giúp.

6.1 Chọn thông minh SAM

  1. Chọn lớp, nhấn S (hoặc nhấn nút SAM bên trái).
  2. Lần đầu dùng cần cài thành phần và tải mô hình, có thể mất vài phút, trên khung hình hiện “Đang chuẩn bị SAM…”. Có GPU NVIDIA thì dùng SAM ViT-B, nếu không thì dùng SlimSAM gọn nhẹ.
  3. Nhấp một lần lên đối tượng, phần mềm tự chọn ra đường viền của đối tượng (bản xem trước).
    • Chọn thừa: Shift + nhấp vào phần thừa để loại trừ;
    • Chọn thiếu: nhấp tiếp vào phần chưa được chọn;
    • Nhấp nhầm thì nhấn Backspace để bỏ điểm cuối cùng;
    • Cũng có thể kéo một khung bao lấy đối tượng.
  4. Ưng ý thì nhấn Enter để nhận thành lớp hiện tại; nhấn Esc để bỏ.
  5. Kết quả: dự án phân đoạn nhận được đa giác, dự án phát hiện nhận được khung ôm sát, dự án điểm khóa nhận được một đối tượng mới (sau đó nhấn “Đặt lại điểm khóa” để chấm điểm).

6.2 Gợi ý bằng văn bản

Tự động tìm đối tượng trong ảnh theo tên lớp:

  1. Trong “Hỗ trợ AI” bên phải, chọn Gợi ý bằng văn bản.
  2. Mô hình chỉ hiểu tiếng Anh. Tên lớp tiếng Anh được dùng trực tiếp. Hơn một trăm tên lớp tiếng Trung thường gặp (như 安全帽, 人员, 电动车, 渣土车, 锥桶) sẽ tự động ứng với từ tiếng Anh và hiện sau tên lớp, ví dụ “安全帽 · helmet”; tên lớp tiếng Trung có chứa các từ này cũng được, ví dụ “红色安全帽” (mũ bảo hộ màu đỏ). Tên lớp bằng tiếng Việt hoặc ngôn ngữ khác, tên không khớp, hoặc muốn đổi thì điền từ gợi ý tiếng Anh trong phần chỉnh sửa lớp.
  3. Chỉnh Độ tin cậy: tìm ra quá nhiều thì tăng lên, không tìm thấy thì giảm xuống.
  4. Nhấn Gán nhãn ảnh này (P) để gán nhãn ảnh hiện tại, hoặc nhấn Gán nhãn trước hàng loạt để gán một loạt ảnh.
  5. Lần đầu dùng cần tải mô hình, mất vài phút. Dự án phân đoạn sẽ dùng thêm SAM để tạo đường viền.

6.3 Xuntong AI

(Cách dùng đầy đủ của Xuntong AI xem chương 16.)

  1. Trước tiên cấu hình Xuntong AI trong Cài đặt (xem 2.3).
  2. Trong “Hỗ trợ AI”, chọn Xuntong AI, rồi trong “Chọn mô hình nhận diện” chọn:
    • Nhận diện theo lớp của dự án (khuyên dùng): chỉ tìm các lớp trong dự án, tên lớp được giữ nguyên, làm theo mô tả nhận diện của từng lớp và quy tắc chung, không nhận ra thêm những thứ bạn không cần;
    • Mô hình chuyên dụng đã đăng ký trên nền tảng;
    • Nhận diện tổng quát bằng mô hình lớn: tìm theo các nhóm nguy cơ an toàn (phòng cháy, điện, vệ sinh môi trường…).
  3. Nhấn Gán nhãn ảnh này (P) hoặc Gán nhãn trước hàng loạt. Dùng mô hình chuyên dụng (ví dụ phân loại rác) để gán nhãn trước hàng loạt rất nhanh: mỗi lô 8 ảnh, gửi hai lô cùng lúc; mô hình lớn và nhận diện theo lớp của dự án thì xử lý từng ảnh một, chậm hơn.
  4. Xuntong AI tính 1 lượt gọi cho mỗi ảnh, sẽ trừ vào hạn mức gói dịch vụ của tài khoản bạn; trước khi chạy hàng loạt sẽ có thông báo.

6.4 Quy tắc nhận diện: nói với AI cách nhận diện

Chỉ có tên lớp thì AI chưa chắc biết bạn thực sự cần gì. Bạn có thể viết rõ quy tắc, hoặc trò chuyện trực tiếp với AI:

  1. Nhấn Quy tắc nhận diện cạnh tiêu đề “Hỗ trợ AI”, bảng quy tắc nhận diện sẽ mở ra ở bên phải.
  2. Trò chuyện với AI: nói bằng lời lẽ đơn giản cách bạn muốn nhận diện, ví dụ “đội mũ nhưng không cài quai cũng tính là không đội mũ bảo hộ”, “áo phản quang không tính”, “chỉ xem lối đi ở nửa dưới khung hình”, hoặc hỏi “vì sao người bên trái ảnh này không được nhận ra”.
    • Mặc định chọn sẵn Đính kèm ảnh hiện tại, AI sẽ thử nhận diện trên ảnh này theo quy tắc mới.
    • Sau khi AI trả lời, nếu nó đề xuất cập nhật quy tắc, sẽ hiện “AI đề xuất cập nhật quy tắc” cùng nội dung cụ thể; chỉ khi bạn nhấn Áp dụng các quy tắc này thì mới được lưu.
    • Khi nhận diện thử có kết quả, nhấn Thêm N khung nhận diện thử vào ảnh này để dùng luôn làm nhãn trước.
    • Ctrl+Enter để gửi. Mỗi lần trò chuyện sẽ dùng hạn mức Xuntong AI.
  3. Quy tắc hiện tại: có thể sửa trực tiếp Quy tắc chung (áp dụng cho mọi lớp) và Mô tả nhận diện cho từng lớp, rồi nhấn Lưu quy tắc.
  4. Từ đó trở đi, khi dùng “Nhận diện theo lớp của dự án” của Xuntong AI để gán nhãn trước, hệ thống sẽ làm theo các quy tắc này.
  5. (Không bắt buộc) Ở cuối “Quy tắc hiện tại”, nhấn Đồng bộ lên nền tảng Xuntong: lưu lớp và quy tắc lên nền tảng Xuntong. Mặc định không bật, không ảnh hưởng đến nhận diện hiện tại của nền tảng. Sau khi liên kết, mỗi lần lưu hoặc áp dụng quy tắc sẽ tự đồng bộ nội dung (không thay đổi trạng thái bật / tắt và cảnh áp dụng mà bạn đặt trong bảng điều khiển Xuntong).
  6. Muốn nhận diện của chính nền tảng Xuntong (trợ lý chụp ảnh, đẩy cảnh báo) cũng chỉ báo các lớp bạn cần, hãy bật Nhận diện trên nền tảng cũng dùng bộ quy tắc này. Lưu ý: sau khi bật, mọi nhận diện của cả tài khoản Xuntong sẽ làm theo các lớp của dự án này; cảnh áp dụng có thể điều chỉnh trong “Quy tắc nhận diện” ở bảng điều khiển Xuntong. Không muốn đồng bộ nữa thì nhấn Hủy liên kết (quy tắc trên nền tảng không bị xóa). Mỗi tài khoản Xuntong có tối đa 20 bộ quy tắc nhận diện.

Giới hạn: nhận diện theo lớp của dự án tối đa 30 lớp, tên lớp không quá 30 ký tự; quy tắc chung tối đa 1000 ký tự, mô tả nhận diện của mỗi lớp tối đa 500 ký tự.

Khi cộng tác, thành viên cũng có thể mở quy tắc nhận diện và trò chuyện với AI (nếu người chủ trì cho phép hỗ trợ AI, sẽ dùng hạn mức của người chủ trì); có được sửa quy tắc hay không thì theo công tắc “Thành viên có thể thêm, sửa lớp”.

6.5 Kiểm tra kết quả hỗ trợ

Khung và đa giác do AI gán hiện bằng nét đứt. Hãy kiểm tra một lượt: xóa cái sai, kéo lại cái lệch, bổ sung chỗ thiếu, rồi nhấn Enter (Xong và ảnh sau).

07 Kiểm tra dữ liệu

Nhấn Kiểm tra dữ liệu ở bên trái, một nhấn là tìm ra các vấn đề trong dữ liệu.

  1. Chọn cách kiểm tra:
    • Đã có mô hình huấn luyện xong: chọn “Kiểm tra bằng mô hình: tên mô hình · mAP50 …”, kiểm tra theo quy tắc kết hợp với mô hình;
    • Chưa có mô hình: chọn “Chỉ kiểm tra theo quy tắc (không dùng mô hình)”.
  2. Nhấn Bắt đầu kiểm tra dữ liệu.
  3. Kết quả được hiển thị theo loại vấn đề:
    Vấn đềÝ nghĩaCần mô hình
    Nghi là gán thiếuMô hình rất chắc chỗ này có đối tượng, nhưng chưa có nhãnCó
    Nghi là sai lớpVị trí khung khớp, nhưng lớp khác với phán đoán của mô hìnhCó
    Khung không chính xácCùng lớp, nhưng khung trùng khớp thấp với dự đoán của mô hìnhCó
    Nghi là khung thừaCó gán khung, nhưng mô hình không thấy gì ở vị trí nàyCó
    Khung quá nhỏCạnh ngắn dưới 8 pixel, mô hình gần như không học đượcKhông
    Khung trùng lặpHai khung cùng lớp trong cùng một ảnh gần như chồng khít lên nhauKhông
    Ảnh trùng lặpCác ảnh có nội dung gần như giống hệt, làm kết quả đánh giá cao ảoKhông
    Không có lớpKhung chưa có lớp, sẽ không được dùng để huấn luyệnKhông
  4. Với mỗi vấn đề, bạn có thể:
    • Đi sửa: chuyển sang trang Gán nhãn và tô sáng khung này;
    • Thêm thành nhãn: với nghi là gán thiếu, thêm luôn một khung theo phán đoán của mô hình;
    • Không phải lỗi: bỏ qua, những lần kiểm tra sau không báo nữa.

      Khi một loại vấn đề có rất nhiều mục, có thể dùng Thêm tất cả thành nhãn (nghi là gán thiếu) hoặc Bỏ qua tất cả để xử lý một lần. Các vấn đề đã bỏ qua có thể lấy lại bằng cách nhấn “Đã bỏ qua N mục · Khôi phục”.

  5. Ảnh đã sang trang Gán nhãn sửa, khi quay lại trang Kiểm tra dữ liệu sẽ được đánh dấu “Đã sửa” và mặc định thu gọn, không cần kiểm tra lại.
  6. Ảnh trùng lặp được hiển thị theo nhóm, trên mỗi ảnh có ghi trạng thái và số nhãn. Ảnh có khung xanh lá là ảnh sẽ giữ lại, mặc định giữ ảnh có nhãn đầy đủ nhất (đã duyệt > đã gán nhãn > nhiều nhãn hơn); nhấp ảnh khác để đổi, nhấp đúp để sang trang Gán nhãn xem. Nhấn Mỗi nhóm chỉ giữ một ảnh để xóa các ảnh còn lại, ảnh có nhãn sẽ không bị xóa nhầm.
  7. Phía dưới trang còn có Phân bố lớp (số khung · số ảnh) và Phân bố kích thước khung; khi lớp quá ít hoặc khung quá nhỏ sẽ có đề xuất. Dự án phân loại chỉ kiểm tra nghi sai lớp và ảnh trùng lặp.

08 Phiên bản tập dữ liệu

Lưu dữ liệu tại một thời điểm thành ảnh chụp nhanh, tiện để so sánh và quay lại.

  1. Ở trang Dữ liệu, nhấn Quản lý → Phiên bản tập dữ liệu (lưu ảnh chụp nhanh, so sánh, khôi phục).
  2. Điền tên phiên bản (ví dụ v1, bổ sung ảnh ban đêm) và Ghi chú (không bắt buộc), nhấn Lưu dữ liệu hiện tại thành phiên bản mới.
    • Phiên bản lưu các ảnh đã gán nhãn, đã duyệt cùng nhãn hiện tại, và cách chia huấn luyện / kiểm định / kiểm tra.
  3. Mỗi dòng trong danh sách phiên bản có thể:
    • So sánh với dữ liệu hiện tại: xem ảnh được thêm, ảnh bị bỏ ra, ảnh có nhãn đã sửa, và thay đổi số lượng nhãn của từng lớp;
    • Xuất phiên bản này;
    • Khôi phục về phiên bản này: trước khi khôi phục, dữ liệu hiện tại sẽ tự động được lưu thành phiên bản “Sao lưu tự động trước khi khôi phục”, có thể khôi phục lại bất cứ lúc nào;
    • Đổi tên, ghi chú, Xóa phiên bản này (chỉ xóa ảnh chụp nhanh, không ảnh hưởng đến dữ liệu hiện tại và các mô hình đã huấn luyện).
  4. Trong “Dữ liệu huấn luyện” ở trang Huấn luyện, bạn có thể chọn một phiên bản để huấn luyện (xem 10.1).

09 Cộng tác nhiều người

Khi có nhiều ảnh, một người gán không xuể, có hai cách:

9.1 Bật cộng tác thời gian thực

  1. Nhấn Cộng tác ở bên trái.
  2. Trước tiên, thêm thành viên trong mục “Thành viên”: điền Tên (dùng để đăng nhập), chọn Vai trò, mật khẩu mặc định được tạo ngẫu nhiên (có thể đổi), nhấn Thêm. Hãy sao chép tài khoản và mật khẩu hiện ra để gửi cho người đó (chỉ hiện một lần này, quên thì có thể Đặt lại mật khẩu).
    • Người gán nhãn: chỉ xem và sửa được ảnh giao cho mình;
    • Người duyệt: xem được toàn bộ ảnh, phụ trách duyệt hoặc trả lại;
    • Bạn là Quản trị viên.
  3. Trong mục “Chia sẻ”, chọn cách chia sẻ:
    • Mạng LAN: thành viên ở cùng mạng công ty, cùng Wi-Fi với bạn; nhanh nhất, dữ liệu không ra khỏi công ty.
    • Trực tuyến · Trung chuyển tự dựng: thành viên ở ngoài Internet (thuê ngoài, làm việc tại nhà). Cần một máy chủ đám mây của riêng bạn cài dịch vụ trung chuyển Wulabel (thư mục relay/ trong kho mã có hướng dẫn triển khai), điền Địa chỉ trung chuyển và Khóa bí mật. Dữ liệu chỉ đi qua máy chủ của bạn.
    • Trực tuyến · Trung chuyển chính thức của Xuntong: dùng khi thành viên ở ngoài Internet mà bạn không có máy chủ riêng. Dùng API Key Xuntong của bạn để kết nối máy chủ trung chuyển của Xuntong. Ảnh và nhãn sẽ được chuyển tiếp qua máy chủ Xuntong (chỉ chuyển tiếp, không lưu); dự án có dữ liệu nhạy cảm hãy dùng hai cách trước.
  4. Điền Tên của bạn (tên người chủ trì mà thành viên nhìn thấy). Cổng thường không cần đổi (mặc định 8765).
  5. Tùy chọn:
    • Thành viên có thể dùng hỗ trợ AI: chọn thông minh SAM, mô hình gán nhãn trước, gợi ý bằng văn bản đều chạy trên máy tính của bạn; trò chuyện với AI về quy tắc nhận diện sẽ dùng hạn mức Xuntong của bạn.
    • Thành viên có thể thêm, sửa lớp và mô tả nhận diện: xóa lớp sẽ xóa toàn bộ nhãn của lớp đó, chỉ bạn mới làm được.
    • Phủ hình mờ có tên thành viên lên màn hình của họ: chống phát tán ảnh chụp màn hình, phù hợp khi thuê ngoài.
  6. Nhấn Bật cộng tác. Trang sẽ hiện Địa chỉ LAN (ví dụ http://192.168.1.20:8765/); chế độ trực tuyến còn hiện thêm Địa chỉ Internet (ví dụ https://relay.example.com/s/xxxxxxxxxxxx/). Gửi địa chỉ cùng tài khoản và mật khẩu của từng người cho thành viên.
    • Lần đầu bật, Windows có thể hiện thông báo tường lửa, hãy nhấn Cho phép (Allow).
    • Trong lúc cộng tác đang bật, ba tùy chọn trên có thể đổi bất cứ lúc nào và có hiệu lực ngay.
    • Nhấn Dừng cộng tác, thành viên bị ngắt kết nối ngay, nhãn đã lưu không bị ảnh hưởng. Đổi dự án hoặc đóng Wulabel cũng sẽ dừng cộng tác.

9.2 Giao nhiệm vụ

  1. Trong “Giao nhiệm vụ”, chọn người gán nhãn (có thể nhấn Chọn tất cả người gán nhãn).
  2. Chọn phạm vi:
    • Ảnh chưa gán nhãn chưa giao cho ai (hay dùng nhất);
    • Tất cả ảnh chưa gán nhãn (chia lại cả ảnh đã giao);
    • Ảnh chưa duyệt (chưa gán nhãn + đã gán nhãn).
  3. Mỗi người N ảnh: không điền thì chia đều hết số ảnh trong phạm vi. Ảnh được chia liên tiếp theo thứ tự, các khung hình liên tiếp của video sẽ giao cho cùng một người.
  4. Nhấn Giao việc. Bên thành viên sẽ tự làm mới và hiện nhiệm vụ mới.
  5. Trong danh sách thành viên có thể xem mỗi người được giao bao nhiêu ảnh, đã nộp bao nhiêu, bị trả lại bao nhiêu. Nhấn Thu hồi nhiệm vụ để thu hồi các ảnh người đó chưa nộp, rồi giao lại cho người khác.

9.3 Thành viên gán nhãn thế nào (trình duyệt)

  1. Mở địa chỉ người chủ trì gửi bằng Chrome hoặc Edge, điền Tên và Mật khẩu để đăng nhập. Trên máy tính của mình thì có thể chọn Ghi nhớ đăng nhập. Không cần cài phần mềm.
  2. Vào là thấy ngay trang Gán nhãn, chỉ hiện ảnh giao cho mình. Thao tác giống trong Wulabel: vẽ khung, phím tắt, hỗ trợ AI (nếu người chủ trì cho phép). Góc trên bên phải hiện hôm nay đã nộp bao nhiêu ảnh.
  3. Gán xong nhấn Nộp và ảnh sau (Enter), chờ duyệt.
  4. Ảnh bị trả lại nằm trong bộ lọc Bị trả lại, phía trên ảnh có hiện lý do trả lại; sửa xong thì nộp lại.
  5. Ảnh người khác đang gán sẽ báo “«tên» đang gán nhãn ảnh này”, bạn chỉ xem được, thay đổi của họ hiển thị trực tiếp; họ rời đi thì ảnh tự chuyển sang sửa được.
  6. Khi mất mạng, góc trên bên phải sẽ báo “Mất kết nối thời gian thực, đang kết nối lại…”, có mạng lại thì tự tiếp tục, phần đã lưu không bị mất.

9.4 Duyệt

  1. Người duyệt (hoặc chính bạn) lọc Đã gán nhãn trong trang Gán nhãn, xem từng ảnh.
  2. Không có vấn đề: nhấn Duyệt và ảnh sau (Enter).
  3. Có vấn đề: nhấn Trả lại, chọn các lý do thường gặp (gán thiếu, khung không chính xác, gán sai lớp, gán thừa, điểm khóa sai), hoặc ghi rõ chỗ cần sửa, rồi nhấn Trả lại.
  4. Ảnh bị trả lại quay về mục “Bị trả lại” của người gán nhãn ban đầu, họ sửa xong thì nộp lại.

9.5 Tiến độ, khối lượng công việc và nhật ký

9.6 Chọn cách chia sẻ nào

Mạng LANTrực tuyến · Trung chuyển tự dựngTrực tuyến · Trung chuyển chính thức của Xuntong
Phù hợpCùng mạng công ty, cùng Wi-FiThuê ngoài, làm việc tại nhà, có máy chủ đám mây riêngThuê ngoài, làm việc tại nhà, không có máy chủ
Địa chỉ thành viên truy cậphttp://<IP-máy-bạn>:8765/https://<máy-chủ-trung-chuyển-của-bạn>/s/<mã>/https://xuntongai.com/wulabel-relay/s/<mã>/
Tốc độNhanh nhấtTùy băng thông máy chủTùy băng thông máy chủ Xuntong
Dữ liệu đi quaChỉ trong mạng nội bộ công tyMáy chủ của bạn (chỉ chuyển tiếp, không lưu)Máy chủ Xuntong (chỉ chuyển tiếp, không lưu)
Cần chuẩn bịKhông cầnMột máy chủ đám mây, cài dịch vụ trung chuyển theo relay/README.mdTài khoản Xuntong AI (đăng nhập trong Cài đặt)

9.7 Ai làm được gì

ViệcQuản trị viên (bạn)Người duyệtNgười gán nhãn
Ảnh xem đượcTất cảTất cảChỉ ảnh giao cho mình
Vẽ khung, sửa nhãn✓✓✓ (chỉ ảnh của mình)
Nộp✓✓✓
Duyệt, trả lại✓✓
Thêm, sửa lớp và mô tả nhận diện✓Theo công tắc “Thành viên có thể thêm, sửa lớp”Theo công tắc
Xóa lớp✓
SAM, mô hình gán nhãn trước, gợi ý bằng văn bản✓Theo công tắc “Thành viên có thể dùng hỗ trợ AI” (chạy trên máy của bạn)Theo công tắc
Gán nhãn trước bằng Xuntong AI✓
Trò chuyện với AI về quy tắc nhận diện✓Theo công tắc “Hỗ trợ AI” (dùng hạn mức Xuntong của bạn)Theo công tắc
Giao nhiệm vụ, quản lý thành viên, thống kê✓
Nhập, xuất, huấn luyện, triển khai, kiểm tra dữ liệu✓

Mỗi ảnh tại một thời điểm chỉ một người được sửa: ai mở trước thì giữ “khóa”, người khác mở ra chỉ xem được và thấy trực tiếp thay đổi của người đó. Khi người đó chuyển sang ảnh sau, đóng trang hoặc mất mạng 90 giây, khóa sẽ tự được nhả.

9.8 Một ví dụ hoàn chỉnh

Lấy ví dụ “nhóm thuê ngoài gán nhãn 2000 ảnh phân loại rác, nhóm của bạn duyệt”:

  1. Chuẩn bị: trong Wulabel, tạo dự án phát hiện, nhập 2000 ảnh, thêm sẵn các lớp ở bên phải (rác tái chế, rác thực phẩm, rác nguy hại, rác khác). Có thể dùng mô hình chuyên dụng của Xuntong AI gán nhãn trước hàng loạt một lượt (xem 16.4), người gán nhãn chỉ cần sửa chỗ sai, nhanh hơn nhiều.
  2. Thêm thành viên: ở trang “Cộng tác”, thêm 3 người gán nhãn (An, Bình, Châu bên thuê ngoài) và 1 người duyệt (Dũng trong nhóm của bạn), rồi gửi tài khoản và mật khẩu cho từng người.
  3. Bật cộng tác: chọn “Trực tuyến · Trung chuyển chính thức của Xuntong” (hoặc trung chuyển tự dựng), chọn “Hình mờ”, bật lên, rồi gửi địa chỉ Internet cho 4 người.
  4. Giao việc: chọn tất cả người gán nhãn, phạm vi “Ảnh chưa gán nhãn chưa giao cho ai”, không điền số ảnh mỗi người, nhấn Giao việc, mỗi người khoảng 666 ảnh.
  5. Gán nhãn: người gán nhãn mở địa chỉ bằng trình duyệt và đăng nhập, chỉ thấy ảnh của mình, gán xong một ảnh thì nhấn Enter để nộp.
  6. Duyệt: Dũng lọc “Đã gán nhãn” và kiểm tra từng ảnh. Không có vấn đề thì nhấn Enter để duyệt; có vấn đề thì nhấn “Trả lại”, chọn “Gán thiếu” và ghi “góc dưới bên phải còn một cái chai”. Ảnh bị trả lại quay về mục “Bị trả lại” của người gán ban đầu, sửa xong thì nộp lại.
  7. Theo dõi tiến độ: ở trang “Cộng tác”, bạn xem ai đang trực tuyến, ai gán nhanh, ai bị trả lại nhiều; ai bị tụt lại thì dùng “Thu hồi nhiệm vụ” để thu hồi ảnh họ chưa làm rồi giao cho người khác.
  8. Thanh toán: trong “Tiến độ và khối lượng công việc”, chọn khoảng thời gian, nhấn “Xuất CSV”, rồi tính tiền thuê ngoài theo số ảnh đã nộp và tỉ lệ được duyệt.
  9. Kết thúc: khi mọi ảnh đã được duyệt, dừng cộng tác, quay lại Wulabel để huấn luyện, đánh giá, triển khai như bình thường.

9.9 Câu hỏi thường gặp

9.10 Chia gói ngoại tuyến

Dùng khi không có mạng, hoặc dữ liệu không được mang ra khỏi công ty. Mỗi gói là một dự án Wulabel độc lập, chép cho người khác gán nhãn, gán xong thì gộp lại.

Chia gói:

  1. Ở trang Dữ liệu, nhấn Quản lý → Cộng tác nhiều người (chia gói, gộp lại), chuyển sang Chia gói.
  2. Lưu tại: chọn một thư mục, các gói gán nhãn sẽ được tạo ở đây.
  3. Điền Người gán nhãn, mỗi dòng một người (hoặc cách nhau bằng dấu phẩy), ví dụ “An”, “Bình”. Có bao nhiêu người thì chia bấy nhiêu gói.
  4. Chọn phạm vi: Chỉ chia ảnh chưa gán nhãn / Chưa duyệt (chưa gán nhãn + đã gán nhãn chờ duyệt lại) / Tất cả (trừ ảnh bỏ qua).
  5. Chọn Mang theo nhãn hiện có: ảnh đã được mô hình gán nhãn trước thì người gán nhãn sửa trên đó, nhanh hơn.
  6. (Không bắt buộc) Chọn Làm mờ ảnh để làm mờ khuôn mặt, biển số xe và các vùng riêng tư khác trước khi gửi đi (xem 13.2).
  7. Nhấn Chia thành N gói. Xong sẽ tự mở thư mục lưu. Chép thư mục gói cho đúng người, họ dùng Mở dự án… trong Wulabel là gán nhãn được.

Gộp lại:

  1. Chép các thư mục gói đã gán xong về.
  2. Mở Cộng tác nhiều người, chuyển sang Gộp lại (hoặc nhấn thẳng Gộp của gói đó trong danh sách “Các gói đã chia ra”).
  3. Chọn thư mục gói. Tùy chọn: Khi xung đột thì ghi đè bằng bản trong gói (những ảnh cũng đã được sửa trong dự án gốc sau khi chia gói; mặc định không ghi đè), Nhập cả ảnh mà người gán nhãn thêm mới vào gói.
  4. Nhấn Gộp. Kết quả hiện số ảnh đã gộp, số ảnh không thay đổi, số ảnh thêm mới, số ảnh xung đột. Khi có xung đột, nhấn Xem từng ảnh.

10 Huấn luyện

Nhấn Huấn luyện ở bên trái. Trước lần huấn luyện đầu tiên cần cài môi trường huấn luyện (xem chương 2); nếu chưa cài, trang sẽ nhắc bạn Cài đặt ngay.

10.1 Thiết lập tham số huấn luyện

Phía trên trang hiện số “Ảnh dùng được để huấn luyện” (ảnh đã gán nhãn, khi cộng tác nhóm thì gồm cả ảnh đã duyệt). Ảnh chưa chia sẽ được tự động phân vào tập huấn luyện và tập kiểm định theo tỉ lệ 8:2 khi bắt đầu huấn luyện; ảnh đã chia rồi sẽ không tự thay đổi, nên có thể so sánh trực tiếp các lần huấn luyện trước sau.

Nhấn Xem và điều chỉnh cạnh “Ảnh dùng được để huấn luyện” để xem từng ảnh được chia vào đâu:

Trong hộp thoại, nhấp vào ảnh để chọn (nhấp đúp để mở gán nhãn), nhấn Chuyển sang tập huấn luyện / Chuyển sang tập kiểm định / Chuyển sang tập kiểm thử để điều chỉnh thủ công; bên dưới có thể đổi tỉ lệ huấn luyện / kiểm định / kiểm tra, nhấn Phân chia ngay N ảnh chưa phân chia hoặc Chia lại toàn bộ (cách chia trước đó sẽ bị xáo trộn, các lần huấn luyện trước sau không so sánh trực tiếp được nữa). Nếu tập huấn luyện bị chuyển hết ảnh sẽ có cảnh báo và không thể bắt đầu huấn luyện.

Tùy chọnMô tả
Điểm bắt đầuMặc định là “Bắt đầu từ trọng số tiền huấn luyện (huấn luyện từ đầu)”. Sau khi bổ sung dữ liệu mới, có thể chọn “Huấn luyện tiếp từ “một lần huấn luyện””, nhanh hơn và ổn định hơn huấn luyện từ đầu; khi lớp có thay đổi, phần phân loại sẽ được học lại.
Mô hìnhLiệt kê theo nhiệm vụ của dự án, mô hình có nhãn “Khuyên dùng” là gợi ý theo máy tính này: dự án phát hiện không có GPU rời thì khuyên dùng YOLOX-Tiny, VRAM từ 4 GB khuyên dùng YOLOX-S, từ 8 GB khuyên dùng YOLOX-M, Mac khuyên dùng YOLOX-S. Dự án phát hiện mới tạo mặc định là YOLOX-S. Khi huấn luyện tiếp sẽ dùng lại mô hình của lần đó.
Số epochDữ liệu càng ít thì càng cần nhiều epoch, thường là 20~50.
Kích thước đầu vàoĐối tượng nhỏ (người ở xa, mũ bảo hộ) thì dùng kích thước lớn, tốc độ sẽ chậm hơn. Phân loại thường dùng 224.
Kích thước batchGiảm xuống nếu báo lỗi thiếu bộ nhớ GPU.
Dữ liệu huấn luyện“Dữ liệu hiện tại” hoặc một phiên bản tập dữ liệu.
Thiết bị“Tự động (có GPU thì dùng GPU)” hoặc “Chỉ dùng CPU”.
Chỉ dùng ảnh đã duyệtChỉ có khi cộng tác nhóm: chọn thì chỉ dùng ảnh đã duyệt để huấn luyện.

Kích thước đầu vào, kích thước batch, tăng cường dữ liệu, thiết bị và chỉ dùng ảnh đã duyệt (chỉ có khi cộng tác nhóm) nằm trong “Cài đặt nâng cao”, mặc định thu gọn, nhấn “Cài đặt nâng cao” để mở rộng; phần mềm sẽ nhớ lần trước bạn mở rộng hay thu gọn.

Khi huấn luyện thiếu bộ nhớ GPU (từ v0.4.2): phần mềm tự giảm một nửa kích thước batch và huấn luyện lại từ đầu, giảm dần đến 1 thì thôi; giao diện sẽ báo một lần, lịch sử huấn luyện cũng ghi “Kích thước batch 2 (không đủ bộ nhớ GPU, tự động giảm từ 8)”. Kích thước batch càng nhỏ thì huấn luyện càng chậm; nếu bộ nhớ GPU thực sự không đủ, bạn cũng có thể đổi sang mô hình nhỏ hơn một bậc hoặc giảm kích thước đầu vào.

Các mô hình có thể chọn:

Nhiệm vụMô hìnhĐặc điểm
Phát hiệnYOLOX-NanoMức nhẹ nhất của dòng YOLO, phù hợp CPU, điện thoại và thiết bị biên rất yếu; mặc định đầu vào 416
Phát hiệnYOLOX-TinyRất nhẹ, phù hợp suy luận thời gian thực trên CPU và hộp biên NPU; mặc định đầu vào 416
Phát hiệnYOLOX-SCân bằng nhất giữa tốc độ và độ chính xác, đa số dự án nên dùng nó trước
Phát hiệnYOLOX-MĐộ chính xác cao hơn, nên có từ 6 GB VRAM trở lên
Phát hiệnYOLOX-LĐộ chính xác cao nhất, chậm nhất, nên có từ 8 GB VRAM trở lên
Phát hiệnFaster R-CNN MobileNetV3Nhanh, tốn ít VRAM, phù hợp người mới và máy không có GPU rời
Phát hiệnFaster R-CNN ResNet50Độ chính xác cao hơn, chậm hơn, nên có từ 6 GB VRAM trở lên
Phát hiệnRetinaNetMột giai đoạn, độ chính xác gần với Faster R-CNN, chuyển sang TensorRT suôn sẻ hơn
Phát hiệnFCOSMột giai đoạn, không dùng anchor, cấu trúc đơn giản, phù hợp triển khai
Phát hiệnSSDLiteMột giai đoạn, rất nhẹ, phù hợp thiết bị biên CPU và NPU; cố định đầu vào 320, đối tượng nhỏ ở mức trung bình
Phân đoạnMask R-CNNPhân đoạn đối tượng, nên có từ 6 GB VRAM trở lên
Điểm khóaKeypoint R-CNNTư thế người 17 điểm dùng được tiền huấn luyện COCO
Phân loạiMobileNetV3 / EfficientNet-B0 / ResNet50Từ nhẹ, nhanh đến chính xác hơn

10.2 Mô hình YOLOX

YOLOX là mô hình phát hiện dòng YOLO do Megvii mở mã nguồn (Apache-2.0, yên tâm dùng cho mục đích thương mại), cùng dòng với các mô hình chuyên dụng của nền tảng Xuntong AI.

Mô hình YOLOX đã huấn luyện dùng giống như các mô hình khác: đều hỗ trợ đánh giá, gán nhãn trước bằng mô hình, kiểm thử báo nhầm, kiểm thử trực tiếp, xuất để triển khai, tải lên Xuntong.

10.3 Tăng cường dữ liệu

Khi huấn luyện, ảnh được biến đổi ngẫu nhiên để mô hình thấy được nhiều dạng hơn, hiệu quả rõ rệt khi dữ liệu ít.

  1. Trong “Tăng cường dữ liệu”, chọn mẫu thiết lập: Đóng, Mặc định, Nhẹ, Tiêu chuẩn, Mạnh (khi ít dữ liệu).
  2. Muốn tinh chỉnh thì mở rộng ra, đổi Lật ngang, Lật dọc, Độ sáng, Độ tương phản, Độ bão hòa, Sắc độ, Mờ (mô phỏng lấy nét sai, nhòe chuyển động), Nhiễu (mô phỏng ánh sáng yếu ban đêm), Đa tỉ lệ (có ích với đối tượng thay đổi kích thước nhiều theo khoảng cách), Xoay, Cắt ngẫu nhiên. Đổi xong, mẫu thiết lập sẽ hiện là “Tùy chỉnh”.
  3. Nhấn Xem trước hiệu quả để xem vài ảnh sau khi tăng cường ngẫu nhiên (mỗi ảnh biến đổi ngẫu nhiên hai lần, khung đỏ là vị trí nhãn sau khi biến đổi), xác nhận không quá đà.

10.4 Bắt đầu huấn luyện, theo dõi quá trình

  1. Trước khi bắt đầu, hãy xem dòng “Mỗi epoch khoảng N bước · tổng khoảng M bước” phía trên nút. Khi ảnh quá ít (tập huấn luyện dưới 20 ảnh) hoặc tổng số bước quá ít (dưới khoảng 300 bước), nhấn Bắt đầu huấn luyện sẽ hiện nhắc nhở trước: huấn luyện như vậy nhiều khả năng không học được gì, chỉ số có thể luôn là 0. Nên gán nhãn thêm ảnh, hoặc làm theo gợi ý tăng số epoch; dữ liệu rất ít thì cũng có thể dùng Faster R-CNN MobileNetV3 trước. Nếu thật sự chỉ muốn thử thì nhấn Vẫn bắt đầu. Khi tập kiểm định chỉ có một hai ảnh cũng sẽ có nhắc nhở: chỉ số sẽ dao động rất mạnh, không đáng tin.
  2. Nhấn Bắt đầu huấn luyện. Lần đầu sẽ tải trọng số tiền huấn luyện, hiện “Đang chuẩn bị…”.
  3. Trong lúc huấn luyện sẽ hiện “Epoch N / M · tiến độ epoch hiện tại · loss · thời gian còn lại dự kiến”, bên dưới có đường cong Hàm mất mát (loss), đường cong chỉ số trên Tập kiểm định và Nhật ký.
    • “Thông tin chính” phía trên nhật ký luôn hiện vài dòng đầu của nhật ký: thiết bị đang dùng, số ảnh của tập huấn luyện và tập kiểm định, trọng số tiền huấn luyện đã nạp được hay chưa. Các dòng lỗi, cảnh báo được tô vàng.
    • Khi cuộn nhật ký lên trên sẽ không bị kéo về cuối; khi đang ở cuối thì sẽ tự cuộn theo.
    • Khi không tải được trọng số tiền huấn luyện (thường là do mạng), hoặc chỉ số bằng 0 suốt 10 epoch liên tiếp, phía trên trang sẽ hiện thanh nhắc màu vàng, ghi nguyên nhân có thể và cách xử lý.
  4. Muốn kết thúc sớm thì nhấn Dừng, xác nhận xong thì tính xong lô hiện tại là dừng. Mô hình tốt nhất tính đến lúc đó được giữ lại, sau này có thể chọn nó để “huấn luyện tiếp”.
  5. Khi huấn luyện xong sẽ hiện thông báo hệ thống, biểu tượng trên thanh tác vụ nhấp nháy một cái (phần mềm chạy nền cũng biết được); trong phần mềm, góc dưới bên phải báo “Huấn luyện xong”, kèm chỉ số tốt nhất và đánh giá (kém / tạm được / dùng được):
    • Kết quả ổn thì có thể nhấn thẳng Đánh giá, Gán nhãn trước;
    • Kết quả rất kém thì sẽ gợi ý nhấn Xem nguyên nhân trước để quay lại trang Huấn luyện xem xét;
    • Huấn luyện thất bại thì dù không ở trang Huấn luyện cũng sẽ hiện thông báo, nhấn Xem lỗi để xem.
  6. Khi huấn luyện gặp lỗi, các lỗi thường gặp sẽ được diễn đạt bằng lời dễ hiểu và có nút sửa kèm theo: trình điều khiển card đồ họa và PyTorch không khớp (Đổi phiên bản PyTorch trong Cài đặt), thiếu bộ nhớ GPU hoặc bộ nhớ (Chuyển sang CPU), ổ đĩa đầy, tải xuống qua mạng thất bại, không tìm thấy tệp ảnh (Đi tới trang Dữ liệu). Nhấn Thông tin chi tiết để mở toàn bộ thông báo lỗi.

10.5 Lịch sử huấn luyện và so sánh huấn luyện

Mỗi lần huấn luyện được tự động lưu thành một dòng trong Lịch sử huấn luyện, liệt kê thời gian, mô hình, dữ liệu, số epoch, chỉ số, trạng thái (Đang huấn luyện / Xong / Đã dừng / Thất bại). Với mỗi dòng, bạn có thể:

So sánh huấn luyện:

  1. Trong lịch sử huấn luyện, chọn từ 2 lần huấn luyện trở lên.
  2. Nhấn So sánh mục đã chọn (N).
  3. Trong cửa sổ so sánh: tham số và dữ liệu đặt cạnh nhau (chỗ khác nhau được in đậm), các chỉ số, đường cong mất mát chồng lên nhau; kết quả theo từng lớp đánh dấu lần tốt nhất.

10.6 Nhập mô hình bên ngoài

Mô hình phát hiện đã huấn luyện ở nơi khác (ví dụ Ultralytics YOLO), sau khi xuất ra ONNX có thể nhập vào để gán nhãn trước, kiểm tra dữ liệu, đánh giá và kiểm thử báo nhầm (không huấn luyện tiếp hay triển khai được). Hiện chỉ hỗ trợ dự án phát hiện.

  1. Nhấn Nhập mô hình bên ngoài phía trên lịch sử huấn luyện.
  2. Nhấn Chọn tệp .onnx.
  3. Phần mềm tự nhận dạng:
    • Định dạng: YOLOv8 / v11 (Ultralytics), YOLOv5 / v7, YOLOv10 và các mô hình end-to-end, YOLOX, RT-DETR, DETR / RF-DETR, mô hình xuất từ Wulabel. Nhận dạng sai thì có thể đổi thủ công;
    • Kích thước đầu vào;
    • Tên lớp (mỗi dòng một tên, thứ tự phải khớp với mô hình). Đổi tên lớp tiếng Anh thành tên lớp trong dự án là khớp được, ví dụ đổi person thành “người”.
  4. Lớp sẽ dùng: lớp nào không chọn sẽ không được thêm vào khi gán nhãn trước; lớp trùng tên với dự án được chọn sẵn.
  5. Nhấn Nhập. Lịch sử huấn luyện sẽ có thêm một dòng “… (bên ngoài)”.

11 Đánh giá

Nhấn Đánh giá ở bên trái, chọn một dòng trong lịch sử huấn luyện (khi vào từ nút “Xem đánh giá” ở trang Huấn luyện thì lần đó đã được chọn sẵn). Dòng vẫn đang huấn luyện sẽ hiện “Đang huấn luyện”, huấn luyện xong mới chọn được.

11.1 Xem chỉ số

11.2 Ma trận nhầm lẫn

Hàng là lớp thực tế, cột là dự đoán của mô hình. Đường chéo là phần đoán đúng, các ô khác là trường hợp đoán nhầm lớp này thành lớp kia. Cột cuối “Nền” là bỏ sót, hàng cuối “Nền” là báo nhầm. Rê chuột lên sẽ hiện con số cụ thể.

11.3 Ca sai

11.4 Ngưỡng tin cậy

Khi triển khai, cảnh báo nên dùng ngưỡng bao nhiêu thì xem ở đây:

  1. Phần mềm đề xuất ngưỡng có F1 cao nhất, hiện Precision và Recall ở ngưỡng đó.
  2. Đường cong cho thấy Precision, Recall, F1 thay đổi theo ngưỡng. Kéo thanh trượt để xem hiệu quả ở các ngưỡng khác nhau: đúng bao nhiêu, báo nhầm bao nhiêu, bỏ sót bao nhiêu.
  3. Cách chọn: báo nhầm nhiều thì tăng ngưỡng; bỏ sót nhiều thì giảm ngưỡng.
  4. Bảng bên dưới là ngưỡng đề xuất cho từng lớp.
  5. Ngưỡng đề xuất sẽ tự động được đưa sang phần kiểm thử trực tiếp và gói dịch vụ suy luận ở trang “Triển khai”, làm ngưỡng tin cậy mặc định.

11.5 Đánh giá bằng dữ liệu hiện tại

Sau khi bổ sung dữ liệu, sửa nhãn, không cần huấn luyện lại, chỉ cần nhấn Đánh giá bằng dữ liệu hiện tại để tính lại chỉ số bằng dữ liệu đã gán nhãn hiện tại (tập kiểm định / tập kiểm tra). Mô hình bên ngoài đã nhập cũng được đánh giá bằng cách này.

11.6 Kiểm thử báo nhầm

Dùng một đoạn video không nên có cảnh báo (không có đối tượng, hoặc chỉ có thứ dễ nhận nhầm, như lối đi trống, khu nhà xưởng ban đêm) để kiểm tra mô hình báo nhầm bao nhiêu lần:

  1. Trong “Kiểm thử báo nhầm”, nhấn Chọn tệp video, hoặc điền địa chỉ rtsp:// / http(s)://.
  2. Thiết lập: Phát hiện N khung hình mỗi giây, Phát hiện liên tiếp N lần tính là một cảnh báo, Kiểm thử N phút (dùng cho luồng video).
  3. Nhấn Bắt đầu kiểm thử, có thể nhấn Kết thúc sớm bất cứ lúc nào.
  4. Kết quả: đã kiểm thử bao lâu, cảnh báo bao nhiêu lần, quy đổi mỗi giờ bao nhiêu lần, thống kê theo lớp; bên dưới là khung hình báo nhầm (khung đỏ là do mô hình báo, chỉ giữ 60 ảnh gần nhất).
  5. Nhấn Thêm các khung hình này vào tập dữ liệu làm mẫu âm: các ảnh được thêm vào với trạng thái “không có đối tượng”, lần huấn luyện sau mô hình sẽ học cách không cảnh báo với những cảnh như vậy. Nếu trong đó có đối tượng thật, hãy bổ sung nhãn ở trang Gán nhãn sau khi thêm.

11.7 Xuất báo cáo bàn giao

  1. Nhấn Xuất báo cáo, chọn vị trí lưu (tên tệp mặc định là “<tên dự án>_<tên lần huấn luyện>_bao_cao_mo_hinh.html”).
  2. Báo cáo là một tệp HTML, gồm tình hình dữ liệu, tham số huấn luyện, chỉ số, đường cong, ma trận nhầm lẫn, ca sai, ngưỡng đề xuất và kết quả kiểm thử báo nhầm; mở thẳng bằng trình duyệt, có thể gửi khách hàng để nghiệm thu.

12 Gán nhãn trước bằng mô hình và chọn ảnh

12.1 Gán nhãn trước bằng mô hình của bạn

  1. Vào trang Gán nhãn, trong “Hỗ trợ AI” bên phải chọn Mô hình của tôi, rồi chọn một mô hình đã huấn luyện trong ô chọn (hiện tên và mAP50 / độ chính xác).
  2. Chỉnh Độ tin cậy.
  3. Một ảnh: nhấn P hoặc nhấn Dự đoán ảnh này (P).
  4. Hàng loạt: nhấn Gán nhãn trước hàng loạt để gán nhãn cho một loạt ảnh chưa gán nhãn. Hộp thoại sẽ đóng ngay, thanh tiến độ nằm ở bên phải, có thể vừa chạy vừa gán nhãn; muốn dừng giữa chừng thì nhấn Dừng cạnh thanh tiến độ, những ảnh đã gán xong được giữ lại.
  5. Khung gán nhãn trước là nét đứt; kiểm tra, sửa xong thì nhấn Enter (Xong và ảnh sau), ảnh này sẽ tính là đã gán nhãn. Dự án phân loại sẽ hiện “Đề xuất của mô hình”, nhấp vào một trong 3 lớp đầu là áp dụng được.

Gán nhãn càng nhiều → mô hình càng chính xác → gán nhãn trước càng đỡ công.

Minh họa gán nhãn trước bằng mô hình
Minh họa gán nhãn trước: mô hình tự khoanh khung các đối tượng, bạn chỉ cần duyệt và sửa vài chỗ sai. Ảnh là kết quả phát hiện “xe đỗ sai quy định”.

12.2 Chọn ra những ảnh đáng gán nhãn nhất

Khi đã có mô hình bản đầu, thay vì gán nhãn tùy ý, hãy gán trước những ảnh mà mô hình chưa chắc chắn nhất:

  1. Ở trang Dữ liệu, nhấn Quản lý → Chọn ra những ảnh đáng gán nhãn nhất (dùng mô hình).
  2. Chọn mô hình, điền Chọn N ảnh, nhấn Bắt đầu chọn lọc.
  3. Kết quả được xếp theo mức độ “chưa chắc chắn” từ cao xuống thấp.
  4. Nhấn Gán nhãn theo thứ tự này, trang Gán nhãn sẽ chỉ hiện loạt ảnh này (phía trên có thêm bộ lọc “Mô hình chọn”). Gán xong, nhấn dấu × bên cạnh để quay về toàn bộ ảnh.

13 Xuất tập dữ liệu (kèm làm mờ)

13.1 Xuất

  1. Ở trang Dữ liệu, nhấn Xuất tập dữ liệu.
  2. Định dạng (theo nhiệm vụ của dự án):
    • Phát hiện: YOLO, COCO, VOC;
    • Phân đoạn: YOLO-seg, COCO, VOC (chỉ có khung bao ngoài);
    • Điểm khóa: YOLO-pose, điểm khóa COCO, VOC (chỉ có khung đối tượng);
    • Phân loại: thư mục theo lớp (train/<lớp>/<ảnh>.jpg).
  3. Phạm vi: ảnh chưa gán nhãn và ảnh đã bỏ qua không được xuất; ảnh được đánh dấu “Không có đối tượng” sẽ được xuất làm mẫu âm. Khi cộng tác nhóm còn có thể chọn Chỉ xuất ảnh đã duyệt.
  4. Tỉ lệ huấn luyện / kiểm định / kiểm tra (%): ảnh chưa chia sẽ được phân bổ theo tỉ lệ này. Muốn chia lại tất cả thì nhấn Chia lại toàn bộ (kết quả huấn luyện trước đó sẽ không so sánh trực tiếp được với cách chia mới).
  5. Xuất đến: nhấn Duyệt tệp để chọn vị trí, Tên thư mục được tạo tự động, có thể đổi (đã đổi rồi thì đổi định dạng cũng không bị ghi đè).
  6. Nhấn Xuất. Xong sẽ hiện đã xuất bao nhiêu ảnh, bao nhiêu nhãn, mỗi phần chia có bao nhiêu ảnh; nhấn Mở thư mục để xem ngay.

Xuất một phiên bản tập dữ liệu: trong danh sách phiên bản tập dữ liệu, nhấn Xuất phiên bản này, cách chia được giữ cố định theo phiên bản.

13.2 Làm mờ

Khi xuất tập dữ liệu, xuất phiên bản, chia gói, bạn đều có thể chọn Làm mờ ảnh:

  1. Theo lớp: trong ô chọn, chọn các lớp cần làm mờ, ví dụ lớp “khuôn mặt”, “biển số xe” mà bạn đã gán nhãn. Lớp có tên chứa “face”, “plate” (hoặc “脸”, “车牌” trong tên tiếng Trung) sẽ được chọn sẵn.
  2. Tự động tìm: chọn Tự động tìm khuôn mặt, Tự động tìm biển số xe, phần mềm sẽ dùng mô hình phát hiện từ vựng mở để tìm (lần đầu cần tải mô hình; có GPU sẽ nhanh hơn nhiều).
  3. Cách làm mờ: Mosaic, Mờ, Tô đen.
  4. Khi xuất sẽ có thêm tiến độ của giai đoạn “Làm mờ”.

Làm mờ chỉ sửa bản sao được xuất, ảnh gốc trong dự án giữ nguyên. Tự động tìm có thể bỏ sót đối tượng rất nhỏ, mặt nghiêng, ở xa; với dữ liệu quan trọng, hãy kiểm tra ngẫu nhiên.

14 Triển khai

Nhấn Triển khai ở bên trái, chọn một mô hình đã huấn luyện. Trang có bốn thẻ: Kiểm thử trực tiếp, Xuất mô hình, Gói dịch vụ suy luận, Dữ liệu hồi lưu từ hiện trường.

14.1 Kiểm thử trực tiếp

Kết nối camera hoặc video để xem trực tiếp hiệu quả của mô hình:

  1. Chọn Luồng video hoặc Video cục bộ.
  2. Điền địa chỉ luồng video: camera RTSP (ví dụ rtsp://admin:<mật-khẩu>@192.168.1.64:554/Streaming/Channels/101), hoặc địa chỉ HTTP-FLV, HLS (m3u8), MP4 qua http; cũng có thể nhấn Chọn tệp video.
  3. Nhấn Bắt đầu, kết quả được vẽ trực tiếp lên hình: mô hình phát hiện vẽ khung, mô hình phân đoạn vẽ đường viền, mô hình điểm khóa vẽ điểm và khung xương, mô hình phân loại hiện vài lớp có xác suất cao nhất ở góc trên bên trái; phía trên hiện độ phân giải và đang suy luận bằng GPU hay CPU.
  4. Kéo thanh trượt Độ tin cậy để chỉnh ngưỡng. Mặc định dùng ngưỡng đề xuất của trang Đánh giá; đã chỉnh rồi thì nhấn “Dùng giá trị khuyên dùng 0.xx” để trả về.
  5. Thấy khung hình bỏ sót, báo nhầm thì nhấn Chụp ảnh đưa vào tập dữ liệu, ảnh sẽ được thêm vào với trạng thái “Chưa gán nhãn”, gán nhãn xong thì huấn luyện lại.
  6. Nhấn Dừng để kết thúc.

14.2 Xuất mô hình

  1. Chọn định dạng:
    • ONNX (kích thước động): định dạng phổ thông, onnxruntime chạy được trên Windows / Linux / ARM;
    • ONNX (kích thước cố định): đầu vào cố định là [1,3,N,N], dành cho các framework suy luận cần hình dạng cố định;
    • OpenVINO: tăng tốc cho CPU Intel, GPU tích hợp, máy tính công nghiệp; chuyển đổi và kiểm chứng ngay trong phần mềm (lần đầu dùng sẽ tự cài OpenVINO);
    • Gói chuyển đổi TensorRT: GPU NVIDIA, Jetson; cần chạy script trên thiết bị đích để tạo engine;
    • Gói chuyển đổi RKNN: Rockchip RK3588 / 3568…; cần chạy script trên Ubuntu để chuyển đổi.
  2. Nếu cần kích thước cố định thì đặt kích thước.
  3. Chọn vị trí Xuất đến, Tên thư mục, nhấn Xuất. Mỗi định dạng sẽ hiện thành công hay thất bại, nhấn Mở để xem.

Faster R-CNN tích hợp sẵn là mô hình hai giai đoạn, NPU (RKNN) và TensorRT bản cũ hỗ trợ hạn chế, việc chuyển đổi có thể thất bại hoặc tốc độ không như mong muốn; nếu cần chạy trên các thiết bị này, nên huấn luyện YOLOX hoặc mô hình một giai đoạn khác (RetinaNet, FCOS, SSDLite). ONNX và OpenVINO thì có thể yên tâm sử dụng.

Khi xuất mô hình YOLOX: ONNX (kích thước động) và OpenVINO giống các mô hình khác, trong mô hình đã làm sẵn co giãn, giải mã và loại khung trùng (NMS), cho ra kết quả trực tiếp; ONNX (kích thước cố định), gói chuyển đổi TensorRT, RKNN dùng định dạng chính thức của YOLOX (đầu vào BGR 0~255, đệm giá trị 114 ở góc trên bên trái, đầu ra chưa làm NMS), các toán tử đều là tích chập thông thường, NPU và TensorRT đều chạy trọn vẹn được; phần hậu xử lý xem README trong gói chuyển đổi.

Mô hình phân đoạn, điểm khóa (Mask R-CNN, Keypoint R-CNN) cũng xuất được ONNX, OpenVINO và các định dạng khác: mô hình phân đoạn có thêm đầu ra masks (xác suất mặt nạ của từng đối tượng, lớn hơn 0.5 là đối tượng), mô hình điểm khóa có thêm keypoints (x, y, độ hiển thị của từng điểm) và keypoints_scores. Kiểm thử trực tiếp và gói dịch vụ suy luận hỗ trợ cả mô hình phát hiện, phân đoạn, điểm khóa và phân loại.

14.3 Gói dịch vụ suy luận

Tạo một dịch vụ suy luận mang đến máy tính ở hiện trường là chạy được, hỗ trợ cả mô hình phát hiện, phân đoạn, điểm khóa và phân loại:

  1. Luồng video: điền tên và địa chỉ (rtsp://…, địa chỉ http(s)://… FLV / m3u8 / MP4, hoặc đường dẫn tệp video), nhấn Thêm một luồng để thêm nhiều luồng.
  2. Khoảng cách phát hiện (giây): mỗi luồng video cứ bao lâu thì phát hiện một khung hình.
  3. Quy tắc cảnh báo:
    • Lớp cảnh báo (không chọn nghĩa là cảnh báo với mọi lớp);
    • Ngưỡng tin cậy (mặc định dùng ngưỡng đề xuất ở trang Đánh giá);
    • Khoảng cách chống trùng (giây): cùng một luồng video, cùng một lớp, trong khoảng thời gian này chỉ cảnh báo một lần;
    • Khung giờ hiệu lực: cả ngày, hoặc ví dụ 07:00-19:00;
    • Lưu ảnh chụp cảnh báo (có khung).
  4. Đẩy cảnh báo:
    • Webhook: khi có cảnh báo sẽ POST JSON tới địa chỉ này, có thể chọn Kèm ảnh chụp (base64);
    • MQTT: địa chỉ máy chủ, chủ đề (topic), tên người dùng, mật khẩu (không điền thì không đẩy).
  5. Dịch vụ: Cổng HTTP API; Suy luận bằng GPU (máy tính ở hiện trường cần cài onnxruntime-gpu, nếu không sẽ tự dùng CPU).
  6. Dữ liệu hồi lưu từ hiện trường: khung hình mà mô hình chưa chắc chắn (độ tin cậy nằm trong khoảng đã đặt) sẽ được lưu vào thư mục reflux/ của gói dịch vụ.
  7. Chọn vị trí Xuất ra, nhấn Tạo gói dịch vụ suy luận.
  8. Chép cả thư mục sang máy tính ở hiện trường: Windows nhấp đúp run.bat, Linux chạy sh run.sh. Cấu hình nằm trong config.json, hướng dẫn xem README.md. Máy tính ở hiện trường không cần PyTorch và GPU, chỉ cần onnxruntime, OpenCV, numpy.

14.4 Dữ liệu hồi lưu từ hiện trường

  1. Khi gói dịch vụ chạy ở hiện trường, nó sẽ lưu các khung hình mà mô hình chưa chắc chắn vào thư mục reflux/.
  2. Định kỳ chép reflux/ về, ở thẻ Dữ liệu hồi lưu từ hiện trường nhấn Nhập ảnh thu từ hiện trường, chọn thư mục này.
  3. Nhấn Đi gán nhãn, lọc “Chưa gán nhãn”, dùng mô hình gán nhãn trước rồi chỉnh sửa.
  4. Huấn luyện lại, tạo gói dịch vụ mới, thay model.onnx ở hiện trường. Mô hình sẽ càng dùng càng chính xác.

14.5 Tải lên nền tảng Xuntong AI

Nếu không muốn tự triển khai dịch vụ, bạn có thể tải mô hình lên nền tảng Xuntong AI, rồi kết nối camera, cấu hình cảnh báo trên nền tảng (hiện hỗ trợ mô hình phát hiện đối tượng):

  1. Trước tiên cấu hình Xuntong AI trong Cài đặt (xem 2.3).
  2. Ở mục “Tải lên nền tảng Xuntong AI” cuối thẻ Triển khai → Xuất mô hình, sửa Tên mô hình, nhấn Tải lên. Nếu chưa xuất ONNX, phần mềm sẽ tự xuất trước.
  3. Sau khi tải lên, nền tảng cần kiểm tra từ vài giây đến một phút, hiện “nền tảng đang kiểm tra”; kiểm tra đạt thì chuyển thành “Kiểm tra đạt” (thất bại sẽ hiện nguyên nhân). Ngưỡng đề xuất tính ở trang Đánh giá sẽ được tải lên cùng, làm ngưỡng mặc định trên nền tảng.
  4. Nhấn Mở bảng điều khiển, vào “Mô hình tùy chỉnh” rồi nhấn Bật, là có thể kết nối camera, cấu hình cảnh báo.
  5. Mục “Mô hình tùy chỉnh trên nền tảng” bên dưới liệt kê các mô hình đã tải lên, trạng thái kiểm tra và có đang bật hay không. Tài khoản chưa đăng ký lưu trữ (hosting) chỉ đặt được 1 mô hình; muốn tải phiên bản mới thì Xóa bản cũ trước.
  6. Ảnh cảnh báo phát sinh trên nền tảng có thể lấy về để gán nhãn tiếp (xem 4.7).

15 Gửi phản hồi

  1. Nhấn Phản hồi ở góc trên bên phải.
  2. Viết mô tả vấn đề hoặc góp ý.
  3. (Không bắt buộc) Email: khi vấn đề được xử lý, tác giả sẽ gửi email báo kết quả cho bạn. Điền một lần là phần mềm sẽ nhớ, lần sau không cần điền lại.
  4. Mặc định chọn sẵn Đính kèm ảnh chụp giao diện hiện tại, có thể xem trước; không muốn gửi kèm thì bỏ chọn.
  5. Mặc định chọn sẵn Đính kèm nhật ký chạy (từ v0.4.2): môi trường huấn luyện, nhật ký và thông tin lỗi của hai lần huấn luyện gần nhất trong dự án hiện tại; nhấn “Xem nội dung” để xem cụ thể những gì được gửi; tên người dùng trong đường dẫn sẽ được thay bằng ~. Không muốn gửi kèm thì bỏ chọn.
  6. Nhấn Gửi. Mô tả, ảnh chụp, nhật ký cùng phiên bản phần mềm, hệ điều hành sẽ được gửi cho nhà phát triển; ảnh và nhãn trong dự án của bạn sẽ không bị tải lên.

Bạn cũng có thể tạo Issue trên kho mã nguồn mở GitHub.

16 Hướng dẫn dùng Xuntong AI

Xuntong AI (xuntongai.com) là một nền tảng nhận diện AI: có sẵn các mô hình nhận diện chuyên dụng (phân loại rác, mũ bảo hộ, khói lửa…) và nhận diện bằng mô hình lớn, còn có thể lưu trữ mô hình của riêng bạn, kết nối camera, đẩy cảnh báo. Khi Wulabel kết nối với nền tảng này, gán nhãn, huấn luyện, đưa vào vận hành, hồi lưu từ hiện trường có thể nối thành một vòng khép kín. Các chương trước đã nói rải rác cách dùng, chương này gom lại cho rõ ràng.

Những chỗ dùng Xuntong AI trong Wulabel:

Ở đâuLàm gìXem
Cài đặt → Xuntong AIĐăng nhập tài khoản, xem hạn mức16.1, 16.2
Trang Gán nhãn → Hỗ trợ AI → Xuntong AITự động gán nhãn bằng mô hình chuyên dụng / mô hình lớn / theo lớp của dự án16.3–16.5
Trang Gán nhãn → Hỗ trợ AI → Quy tắc nhận diệnViết mô tả nhận diện, trò chuyện với AI về cách nhận diện, đồng bộ lên nền tảng16.5
Triển khai → Xuất mô hình → Tải lên nền tảng Xuntong AIĐưa mô hình đã huấn luyện lên nền tảng để dùng16.6
Dữ liệu → Thêm cách nhập → Lấy ảnh cảnh báo từ Xuntong AILấy các ca báo nhầm, bỏ sót ở hiện trường về để gán nhãn lại16.7
Cộng tác → Trực tuyến · Trung chuyển chính thức của XuntongThành viên ngoài Internet kết nối vào cùng gán nhãn16.8

16.1 Đăng nhập tài khoản

  1. Mở Cài đặt, ở mục “Xuntong AI” nhấn Đăng nhập tài khoản Xuntong AI.
  2. Trình duyệt sẽ mở trang web Xuntong AI:
    • Nếu chưa đăng nhập thì đăng nhập trước (giống như khi bạn đăng nhập Xuntong bình thường, dùng mã xác minh hay SMS đều được);
    • Đối chiếu mã xác nhận trên trang web với mã trong hộp thoại của Wulabel, giống nhau thì nhấn Cho phép.
  3. Quay lại Wulabel, sau vài giây sẽ hiện Đã đăng nhập, tên tài khoản và gói dịch vụ, hạn mức còn lại, cùng các cách nhận diện có thể dùng.

Lưu ý:

16.2 Hạn mức và chi phí

16.3 Chọn cách nào trong bốn cách nhận diện

Ở trang Gán nhãn, trong “Hỗ trợ AI” bên phải chọn Xuntong AI, ô “Chọn mô hình nhận diện” có:

Cách nhận diệnPhù hợpTốc độHạn mức
Mô hình chuyên dụng (như phân loại rác, mũ bảo hộ)Các lớp của dự án khớp với mô hình có sẵn của nền tảngNhanh nhất, khi chạy hàng loạt mỗi lô 8 ảnh, gửi hai lô cùng lúcNhận diện bằng mô hình chuyên dụng
Mô hình tự mang mà bạn đã tải lên và bậtMô hình bạn tự huấn luyện và đưa lên nền tảngNhư trênNhận diện bằng mô hình tự mang
Nhận diện theo lớp của dự án (khuyên dùng)Nền tảng không có mô hình phù hợp; chỉ muốn tìm vài lớp trong dự ánTừng ảnh một, chậm hơnNhận diện bằng mô hình lớn
Nhận diện tổng quát bằng mô hình lớnTìm theo các nhóm nguy cơ an toàn lớn (phòng cháy, điện, vệ sinh môi trường…)Từng ảnh mộtNhận diện bằng mô hình lớn

Cách chọn rất đơn giản: có mô hình chuyên dụng phù hợp thì dùng mô hình chuyên dụng (vừa nhanh vừa chuẩn); không có thì dùng Nhận diện theo lớp của dự án, và viết rõ mô tả nhận diện cho từng lớp (16.5).

16.4 Tự động gán nhãn hàng loạt bằng mô hình chuyên dụng

Lấy phân loại rác làm ví dụ:

  1. Tạo dự án phát hiện, nhập ảnh. Có thể chưa cần tạo lớp: nếu dự án chưa có tên lớp mà mô hình nhận diện ra (như “rác tái chế”), lớp đó sẽ tự được tạo.
  2. Mở trang Gán nhãn, trong “Hỗ trợ AI” bên phải chọn Xuntong AI, mô hình chọn Phân loại rác.
  3. Chỉnh Độ tin cậy: trước hết dùng giá trị mặc định, khung quá nhiều thì tăng lên, bỏ sót nhiều thì giảm xuống.
  4. Trước tiên nhấn P để gán nhãn ảnh hiện tại xem hiệu quả, ưng ý rồi mới nhấn Gán nhãn trước hàng loạt. Phần mềm sẽ nhận diện theo từng lô tất cả ảnh “Chưa gán nhãn” và chưa có nhãn nào, thanh tiến trình hiện tiến độ.
  5. Khung nhận diện được là nét đứt (nguồn “Xuntong”). Kiểm tra từng ảnh: xóa cái sai, kéo lại cái lệch, bổ sung chỗ thiếu, nhấn Enter (Xong và ảnh sau).
  6. Muốn nhanh hơn nữa: gán được vài trăm ảnh thì dùng dữ liệu này huấn luyện mô hình của riêng bạn (chương 10), sau này gán nhãn trước ngay trên máy, không tốn hạn mức.

Khi chạy hàng loạt mà gặp “gọi quá thường xuyên”, phần mềm sẽ tự giảm tốc rồi thử lại, không trừ hạn mức hai lần; gặp lỗi như không đủ hạn mức, mô hình chưa được đăng ký thì sẽ dừng lại và cho bạn biết đã gán được bao nhiêu ảnh.

16.5 Nhận diện theo lớp của dự án và quy tắc nhận diện

Khi nền tảng không có mô hình phù hợp, hãy dùng “Nhận diện theo lớp của dự án”: nền tảng chỉ tìm các lớp trong dự án của bạn, tên lớp được giữ nguyên, thứ gì ngoài danh sách đều không báo. Hiệu quả tốt hay không chủ yếu phụ thuộc vào việc bạn viết quy tắc có rõ ràng không.

Viết mô tả nhận diện:

  1. Trong nút chỉnh sửa cạnh lớp, điền mô tả nhận diện: lớp này cụ thể là gì, cái gì tính / không tính. Ví dụ:
    • Không đội mũ bảo hộ: người không đội mũ bảo hộ; đội mũ nhưng không cài quai cũng tính; chỉ khoanh đầu và nửa thân trên.
    • Xe điện: xe điện hai bánh, xe đạp điện; xe đạp, xe máy không tính.
  2. Hoặc nhấn Quy tắc nhận diện cạnh tiêu đề “Hỗ trợ AI”, rồi trong Quy tắc hiện tại sửa tập trung Quy tắc chung (áp dụng cho mọi lớp, ví dụ “chỉ xem lối đi ở nửa dưới khung hình, bỏ qua nội dung trong áp phích và màn hình”) và mô tả của từng lớp, nhấn Lưu quy tắc.

Trò chuyện với AI: không biết viết quy tắc thế nào, hãy vào Quy tắc nhận diện → Trò chuyện với AI và nói bằng lời lẽ đơn giản:

Mặc định sẽ đính kèm ảnh hiện tại, AI trả lời xong sẽ thử nhận diện trên ảnh này theo quy tắc mới. Khi AI đề xuất sửa quy tắc, nó sẽ liệt kê nội dung cụ thể, chỉ khi bạn nhấn Áp dụng các quy tắc này thì mới được lưu; khi nhận diện thử có kết quả, nhấn Thêm khung nhận diện thử vào ảnh này để dùng luôn.

Đồng bộ lên nền tảng Xuntong (không bắt buộc): ở cuối “Quy tắc hiện tại”, nhấn Đồng bộ lên nền tảng Xuntong, quy tắc sẽ được lưu lên nền tảng. Mặc định không bật, không ảnh hưởng đến nhận diện hiện tại của nền tảng.

Muốn nhận diện của chính nền tảng Xuntong (chụp ảnh, đẩy cảnh báo) cũng chỉ báo các lớp trong dự án của bạn, hãy bật Nhận diện trên nền tảng cũng dùng bộ quy tắc này. Lưu ý: sau khi bật, mọi nhận diện của cả tài khoản Xuntong sẽ làm theo bộ quy tắc này; cảnh áp dụng có thể điều chỉnh ở trang “Quy tắc nhận diện” trong bảng điều khiển Xuntong.

Sau khi liên kết, mỗi lần lưu hoặc áp dụng quy tắc sẽ tự đồng bộ nội dung, nhưng không thay đổi trạng thái bật / tắt và cảnh áp dụng mà bạn đặt trong bảng điều khiển. Không muốn đồng bộ nữa thì nhấn Hủy liên kết, quy tắc trên nền tảng không bị xóa.

Giới hạn: tối đa 30 lớp, tên lớp không quá 30 ký tự; quy tắc chung tối đa 1000 ký tự, mô tả nhận diện của mỗi lớp tối đa 500 ký tự; mỗi tài khoản Xuntong tối đa 20 bộ quy tắc.

16.6 Đưa mô hình đã huấn luyện lên Xuntong

  1. Huấn luyện một mô hình phát hiện đối tượng trong Wulabel (hiện Xuntong chỉ nhận mô hình phát hiện).
  2. Vào Triển khai → Xuất mô hình, ở mục “Tải lên nền tảng Xuntong AI” cuối trang, sửa tên mô hình, nhấn Tải lên. Nếu chưa xuất ONNX, phần mềm sẽ tự xuất trước; ngưỡng đề xuất ở trang Đánh giá sẽ được tải lên cùng.
  3. Nền tảng kiểm tra từ vài giây đến một phút: hiện “Đang kiểm tra” → “Kiểm tra đạt” (hoặc “Kiểm tra thất bại” kèm nguyên nhân).
  4. Nhấn Mở bảng điều khiển, vào “Mô hình tùy chỉnh” rồi nhấn Bật. Bật xong là có thể kết nối camera, cấu hình cảnh báo trên nền tảng, và cũng chọn được mô hình này trong danh sách mô hình ở trang Gán nhãn.
  5. Mục “Mô hình tùy chỉnh trên nền tảng” bên dưới liệt kê các mô hình đã tải lên, trạng thái kiểm tra, có đang bật hay không. Tài khoản chưa đăng ký lưu trữ (hosting) chỉ đặt được 1 mô hình; trước khi tải phiên bản mới, hãy Xóa bản cũ. Tệp mô hình tối đa 200 MB.

16.7 Lấy ảnh cảnh báo ở hiện trường về, cải thiện liên tục

Sau khi mô hình đi vào vận hành, các ca báo nhầm, bỏ sót trong ảnh chụp cảnh báo ở hiện trường chính là dữ liệu đáng bổ sung nhất:

  1. Dữ liệu → Thêm cách nhập → Lấy ảnh cảnh báo từ Xuntong AI.
  2. Chọn khoảng thời gian (1 / 3 / 7 ngày gần đây), cảnh báo của mô hình nào, tối đa bao nhiêu ảnh. Mặc định chọn sẵn Dùng khung nền tảng nhận diện được làm nhãn trước.
  3. Ảnh lấy về nằm trong thư mục images/xuntong_<thời-gian>/ của dự án, khung là nét đứt (nguồn “Xuntong”).
  4. Sửa từng ảnh: xóa khung báo nhầm (ảnh vốn không có đối tượng thì nhấn Enter để hoàn tất luôn, dùng làm mẫu âm), bổ sung chỗ bỏ sót.
  5. Huấn luyện lại, đánh giá, rồi tải phiên bản mới lên, thay mô hình cũ trên nền tảng.

Lưu ý: nền tảng chỉ giữ ảnh cảnh báo 7 ngày, nhớ lấy về định kỳ; chỉ tài khoản đã cấu hình kênh đẩy thông báo mới có bản ghi cảnh báo.

Đây chính là vòng khép kín: gán nhãn → huấn luyện → tải lên Xuntong → cảnh báo ở hiện trường → lấy về sửa lỗi → huấn luyện lại, mô hình càng dùng càng chính xác.

16.8 Xuntong AI trong cộng tác

16.9 Câu hỏi thường gặp

Phím tắt

Chung (trang Gán nhãn)

PhímTác dụng
1–9Đổi lớp (dự án phân loại: chọn lớp trực tiếp)
A / D hoặc ← / →Ảnh trước / ảnh sau
EnterXong và ảnh sau (ảnh không có đối tượng được ghi là mẫu âm); khi cộng tác nhóm là duyệt và chuyển sang ảnh sau
XBỏ qua (không dùng để huấn luyện)
Shift+D hoặc Shift+→Ảnh chưa gán nhãn tiếp theo
Ctrl+Z / Ctrl+YHoàn tác / làm lại
?Mở bảng mô tả phím tắt
Ctrl+DSao chép nhãn của ảnh trước (phân loại: dùng lại lớp của ảnh trước)
PDự đoán / gán nhãn ảnh này bằng hỗ trợ AI
FVừa cửa sổ
Cuộn chuộtThu phóng
Phím cách + kéo / kéo chuột phảiDi chuyển ảnh

Phát hiện, phân đoạn, điểm khóa

PhímTác dụng
RVẽ khung / vẽ đa giác / vẽ khung đối tượng
VChọn, điều chỉnh
SChọn thông minh SAM
Del / BackspaceXóa đối tượng đang chọn
HẨn / hiện tên lớp
EscBỏ chọn

Khi vẽ đa giác: nhấp để thêm điểm, nhấp đúp hoặc Enter để khép, Backspace để bỏ điểm vừa đặt.

Khi chấm điểm khóa: nhấp là nhìn thấy, Shift+nhấp là bị che khuất, N để bỏ qua, Backspace để quay lại điểm trước, Esc hoặc Enter để kết thúc.

Khi chọn bằng SAM: nhấp để chọn, Shift+nhấp để loại trừ, Backspace để bỏ điểm cuối cùng, Enter để nhận, Esc để bỏ.

Dự án phân loại: Del để xóa lớp.


准备好了?下载 Wulabel,开始标你的第一张图。