Công cụ giải mã Protocol Buffers

Công cụ giải mã Protobuf không schema có thể xác nhận điều gì?

Protocol Buffers lưu một chuỗi tag và giá trị trường, chứ không lưu các khai báo .proto ban đầu. Hướng dẫn mã hóa protobuf chính thức định nghĩa mỗi tag bằng cách dịch số trường ba bit rồi kết hợp với Wire Type, tương đương field_number × 8 + wire_type. Nhờ đó, công cụ có thể xác nhận số trường, Wire Type, ranh giới byte và các kiểu mã hóa có thể tồn tại về mặt cấu trúc. Công cụ không thể xác nhận một varint đã được khai báo là uint64, int64, sint64, bool hay enum, vì các khai báo này có thể dùng cùng một chuỗi byte.

Chế độ đầu vào luôn do bạn chọn rõ ràng. Hex chấp nhận khoảng trắng ASCII và tối đa một tiền tố 0x ở đầu. Base64 và Base64URL được kiểm tra riêng, bao gồm độ dài, phần đệm và các bit đệm không dùng; không được trộn bảng ký tự chuẩn với bảng URL-safe. Văn bản thô là chính xác các byte UTF-8 do TextEncoder của trình duyệt tạo ra, các escape có dấu gạch chéo ngược không được diễn giải. Chế độ tệp sử dụng đúng byte gốc của tệp.

Wire Type và cách diễn giải

Kiểu number thông thường của JavaScript không thể biểu diễn chính xác mọi số nguyên 64 bit. Công cụ dùng BigInt xuyên suốt Wire Parser và chuyển số nguyên chính xác thành chuỗi thập phân để hiển thị và xuất. Các giá trị dấu phẩy động đặc biệt như NaN, vô cực và số không âm cũng được xuất thành chuỗi để JSON không âm thầm biến chúng thành giá trị khác.

Hiểu tính mơ hồ của Length-delimited

Wire Type 2 được dùng cho chuỗi, byte thô, thông điệp nhúng và các giá trị vô hướng lặp lại dạng Packed. Khi thiếu schema, cùng một chuỗi byte có thể hợp lệ trong nhiều vai trò cùng lúc. Ví dụ, 2a 03 01 02 03 là trường 5 chứa ba byte. Các byte đó hợp lệ dưới dạng Packed Varint [1, 2, 3], nhưng cũng chỉ có thể là byte thông thường. Công cụ hiển thị cả hai khả năng và không xếp hạng khả năng nào đáng tin hơn.

Khả năng Nested Message chỉ xuất hiện khi toàn bộ nội dung Length-delimited được phân tích trọn vẹn thành một thông điệp hợp lệ. Các khả năng Packed Varint, fixed32 và fixed64 cũng chỉ xuất hiện khi cách diễn giải đó dùng hết mọi byte. Khả năng UTF-8 nghiêm ngặt đòi hỏi toàn bộ chuỗi được giải mã mà không cần ký tự thay thế. Những phép kiểm tra này cho biết khả năng về cấu trúc, không phải kiểu trường đã khai báo.

Group được xử lý theo ngữ pháp Wire dù schema hiện đại thường ưu tiên thông điệp nhúng. Tag Start-group phải được đóng bằng tag End-group mang cùng số trường. Tag kết thúc ở cấp gốc, tag không khớp hoặc tag kết thúc bị thiếu sẽ dừng giải mã tại đúng offset byte. Các trường đã giải mã hoàn chỉnh trước lỗi vẫn được hiển thị; byte bị thiếu và giá trị chưa biết không bao giờ bị biến thành số không giả.

Giới hạn, framing và xử lý an toàn

Công cụ nhận một thông điệp không có frame với dung lượng tối đa 10 MiB. Công cụ không tách stream có tiền tố độ dài, frame gRPC, tệp Delimited Message hay lớp bọc truyền tải. Hãy gỡ framing trước, rồi giải mã một thông điệp. Parser cũng giới hạn tổng số record, độ sâu đệ quy, số hàng hiển thị và lượng xử lý dành cho các khả năng. Những kiểm soát này tuân theo tinh thần của hướng dẫn chính thức về tập dữ liệu lớn và giới hạn triển khai: protobuf hoạt động hiệu quả, nhưng một thẻ trình duyệt dùng để chẩn đoán vẫn cần giới hạn bộ nhớ và khối lượng công việc.

Số trường phải nằm trong khoảng từ 1 đến 536.870.911. Công cụ cảnh báo các số 19.000–19.999 vì hướng dẫn số trường chính thức dành riêng dải này cho phần triển khai. Wire Type 6 và 7 không hợp lệ.

Việc phân tích và xuất dữ liệu diễn ra cục bộ. Giao diện nhiều bước có thể giữ một payload đã giới hạn kích thước trong sessionStorage của thẻ này tối đa hai giờ; bắt đầu lại sẽ xóa dữ liệu đó. Không có gì được đặt trong URL hoặc gửi đến máy chủ của chúng tôi. Đầu ra JSON được ghi rõ là báo cáo giải mã theo định dạng riêng của công cụ này, không phải ProtoJSON. CSV bắt đầu bằng UTF-8 BOM và thêm tiền tố vào các ô giống công thức để mở an toàn hơn trong bảng tính. Báo cáo vẫn có thể chứa dữ liệu ứng dụng bí mật, vì vậy hãy kiểm tra trước khi chia sẻ.