Văn bản UUID chuẩn tắc
Đổi UUID chuẩn tắc chữ thường thành mười sáu byte mà không suy ra phiên bản hay danh tính.
import re
UUID_TEXT = re.compile(r"[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}")
def uuid_bytes(text):
if not isinstance(text, str) or not UUID_TEXT.fullmatch(text):
raise ValueError("canonical lowercase UUID required")
return bytes.fromhex(text.replace("-", ""))Kiểm tra trước khi áp dụng
So sánh hành vi thực tế với kết quả mong đợi. Nếu kiểm tra thất bại, tìm nguyên nhân trước khi sửa tiếp.
Mô hình
Cấu hình endpoint tương thích OpenAI hoặc Anthropic bằng URL cơ sở và khóa API nếu cần. Kiểm tra kết nối. Máy chủ mô hình cục bộ phải đang chạy; công cụ từ xa có thể truyền dữ liệu riêng.
Dự án
Kiểm tra số không và chữ thập lục phân, từ chối chữ hoa, ngoặc nhọn, gạch nối sai chỗ và khoảng trắng ngoài.
import re
UUID_TEXT = re.compile(r"[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}")
def uuid_bytes(text):
if not isinstance(text, str) or not UUID_TEXT.fullmatch(text):
raise ValueError("canonical lowercase UUID required")
return bytes.fromhex(text.replace("-", ""))Thống nhất biểu diễn mã định danh ở ranh giới ứng dụng
IdSaffron cung cấp không gian lập trình AI trên Windows để xem các hàm ranh giới nhỏ kết nối những phần lớn hơn của ứng dụng. Khi cần đổi xử lý mã định danh, mô tả biểu diễn được chấp nhận và kỳ vọng mã phía sau. Yêu cầu mô hình xem cùng lúc bộ kiểm tra, bước chuyển đổi và mã gọi liên quan, để phép chuẩn hóa tưởng vô hại không âm thầm mở rộng quy ước đầu vào.
Tác vụ dựa trên uuid_text.py có thể rà soát việc chấp nhận văn bản UUID chữ thường dạng chuẩn trước khi chuyển thành byte. Đưa ví dụ khác nhau về hoa thường, dấu phân cách hoặc khoảng trắng xung quanh và nêu ca nào phải bị từ chối. Trao đổi liệu chuẩn hóa thuộc bước trước kiểm tra hay mã gọi phải cung cấp dạng chuẩn. Những quyết định đó làm chỉnh sửa đề xuất đủ cụ thể để đối chiếu với mã.
Sau rà soát, chạy kiểm thử dự án kiểm tra cả byte kết quả và biểu diễn bị từ chối. Xem cách ứng dụng báo mã định danh không hợp lệ, kể cả các luồng từng giả định chuyển đổi không thể thất bại. IdSaffron kết nối điểm cuối tương thích OpenAI hoặc Anthropic được hỗ trợ với thông tin xác thực khi cần. Lựa chọn mô hình không hạn chế tùy điểm cuối bạn chọn; hạn chế, công cụ và dung lượng ngữ cảnh vẫn là thuộc tính mô hình và máy chủ đó. Ví dụ chấp nhận tạo mốc tham chiếu ổn định cho trao đổi lập trình qua các lần sửa.
Các ranh giới mã định danh cần câu trả lời rõ ràng
Hàm có nên nhận cả mã định danh chữ hoa không?
Quyết định theo quy ước ứng dụng thay vì tự động thêm hành vi dễ dãi. Nếu mã gọi cần văn bản chữ thường dạng chuẩn, nhận dạng khác có thể che sự thiếu nhất quán phía trước. Nếu định chuẩn hóa, nêu nơi thực hiện và kiểm thử biểu diễn kết quả.
Mã định danh hợp lệ có chứng minh bản ghi tồn tại không?
Không. Kiểm tra định dạng chỉ xác nhận biểu diễn đã cho đáp ứng cấu trúc mong đợi. Tồn tại và phân quyền thuộc kiểm tra riêng của ứng dụng, nên rà soát nơi sử dụng trước khi coi chuyển đổi thành công là quyền truy cập bản ghi.
Vì sao kiểm tra byte bên cạnh văn bản hợp lệ?
Chỉ chấp nhận không chứng minh chuyển đổi tạo giá trị nơi sử dụng mong đợi. Thêm cặp văn bản và byte đã biết, rồi xác minh xử lý phía sau, nhất là nếu chỉnh sửa đổi ranh giới tuần tự hóa hoặc lưu trữ dùng nơi khác trong dự án.
Nếu mã gọi đã cắt khoảng trắng thì sao?
Xem hành vi đó trước khi làm trùng. Thống nhất hàm này nhận đầu vào đã chuẩn hóa hay tự chuẩn hóa. Nêu rõ trách nhiệm giúp dễ hiểu quy tắc từ chối và tránh xử lý không nhất quán giữa các luồng gọi.
IdSaffron · Cập nhật 2026-10-25