hex-viewer 是按文件格式（PNG/ZIP 等已知魔数）解析，protobuf-decoder 针对 protobuf 这一种自描述格式。本工具面向没有标准、各家自定义的私有通讯协议——你用模板告诉它字段怎么排，它就怎么拆，并且能反向拼回报文。适合嵌入式、串口、Modbus、物联网设备这类"协议在文档里、不在代码里"的场景。

一行一个字段：名称 长度 类型 [修饰符]，# 后面是注释。比如 addr 1 uint、crc 2 crc16/modbus。长度填字节数；变长字段把长度写成前面某个 uint 字段的名字（如 data len ascii）；最后一个字段想吃掉剩余全部字节就写 *。修饰符可选，用来指定字节序或校验范围。

把存放长度的字段先声明出来（通常是 uint），再让变长字段的"长度"列引用它的名字。例如 len 1 uint 后面跟 data len hex——解析时先读出 len 的值，再据此截取 data。反向编码时更省事：你只填 data 的内容，len 字段会自动算成 data 的字节数回填，不用手动数。

九成是字节序问题。工业设备的 32 位浮点经常不是标准大端，而是"字内交换"或"字交换"。在 float 字段后面试 abcd（标准大端）、dcba（小端）、badc、cdab（Modbus 设备最常见）四种排列，哪种读出来是合理数值就用哪种。双精度 double 用 be/le 即可。

内置 crc16/modbus（0xA001，初值 0xFFFF）、crc16/ccitt（CCITT-FALSE，0x1021，初值 0xFFFF）、crc16/xmodem（0x1021，初值 0x0000）、crc8（0x07，SMBus）、sum（累加和取低 8/16 位）、xor（逐字节异或，即 LRC）。注意 ccitt 与 xmodem 多项式相同但初值不同，是两种算法。非标准 CRC 用通用形式 crc(poly=0x1021,init=0xFFFF,refin,refout,xorout=0)，位宽由字段字节数决定（只有 poly 必填，其余缺省为 0/false），几乎能覆盖所有 CRC 变体。默认校验从帧首到该校验字段之前的所有字节；如果你的协议只校验中间一段，用修饰符 range(起字段..止字段) 指定起止字段名（含两端）。编码时校验值永远自动算，解析时会比对实际值与期望值并标 ✓/✗。

用数值修饰符，可叠加在 uint/int/float 字段后面：缩放 *0.1、偏移 +100、单位 ~℃、枚举 {3:读寄存器,6:写寄存器}。例如 temp 2 uint *0.1 ~℃，原始 00 FA（250）直接显示成 25 ℃；func 1 uint {3:读寄存器,6:写寄存器} 会把 03 显示成 读寄存器(3)。反向编码时「值」列直接填物理量（如 25 ℃ 或 读寄存器），工具自动还原成原始字节，不用手算。注意枚举标签里不能含逗号或大括号（逗号是分隔符）。

能。写一个 bits 类型字段，下面用 > 名称 位数 缩进续行逐位声明，从高位到低位排列。例如 status 1 bits 下面跟 > online 1、> mode 2、> reserved 5。解析时每位单独列出；编码时在该字段的值里写 online=1 mode=2 这种形式即可。

能。写好模板点「💾 存模板」起个名字，就存进浏览器本地（localStorage），下次从左上角下拉里选回来。内置的几个示例（Modbus-RTU、TLV、传感器浮点）可以直接当模板改。数据只在你这台机器上，不上传。

不会上传，可以离线用。 模板解析、编解码、CRC 计算全部在浏览器本地完成，不发起任何网络请求。把页面打开后断网照常工作，适合处理内部设备的敏感协议数据。