本地Schema与语义数据指南：Protobuf、Avro、JSON-LD、RDF及CRS

根据接收任务选择解释规则

已有二进制和.proto时，按明确消息类型检查Protobuf；已有写入和读取Schema时，比较Avro解析方向。字节检查与Schema兼容是不同交付：前者解释一条具体消息，后者判断两套声明能否按某方向读取。

需要查看术语IRI或用选定上下文压缩时，使用离线JSON-LD处理；需要判断完整N-Quads数据集是否仅临时空白节点标签不同，使用RDF规范化比较；几何需要在已支持的经纬度与Web Mercator之间转换时，使用显式CRS重投影。这是不同任务，JSON格式化不会替代它们。

按原Schema检查Protobuf，保留存在性

提供二进制文件或严格hex/base64字节，在第二区粘贴独立proto2/proto3，明确消息路径。示例087b120161在demo.Event中表示seq=123和payload字节a；解码把seq写为字符串"123"、payload写为base64"YQ=="。无需也不会猜类型、抓取import或执行service。

看decoded最终值和presence，而不是把默认值当作已经传入。proto3 implicit零值可以省略，optional零值和oneof的零值仍保留存在性。重复singular子消息先合并，再对最终状态递归检查required；不同oneof成员以后者为准，同一个message成员的片段仍合并。未知字段、错误wire类型与closed enum未知值给出原始片段；原始binary完整保留，JSON不是无损重编码。

声明group、extensions、editions、service、外部import与features覆写不支持；保护标识符拒绝。proto2显式bytes默认值和不安全/非有限数值Schema默认值也拒绝。Schema只作数据，用户脚本或服务不会执行；受控内部decoder在同源独立HTTP Worker运行，页面CSP不改。

syntax = "proto3";
package demo;
message Event { int64 seq = 1; bytes payload = 2; }

明确Avro谁写、谁读，再看双向结果

主输入是写入Schema，第二输入是目标读取Schema。int写入、long读取可提升；反向无法保证所有long值放入int。合法但不兼容得到完整false报告，JSON或Schema本身无效才失败。别把forward/backward标签当成不需指定参与者的结论。

新增读取字段需要合适default；读取方record/field aliases可处理支持范围内的改名，完整名称包含namespace。保留底层resolutionError，但不从错误字符串伪造精确字段路径。具名递归Schema受预算控制，不解析数据、IDL或Schema Registry历史策略。

固定avsc5.7.9，union字段默认值必须匹配第一分支；logicalType和保护标识符明确不支持。不要移除logicalType后把结果当成原Schema结论。比较是解析关系，不验证业务取值约束或Registry整体策略。

在本地提供每份JSON-LD上下文

粘贴对象或数组，选择展开、压缩，在辅助信封中提供contexts及可选compactContext。每个映射文档必须含@context，URL键需与请求的绝对HTTP(S) URL精确匹配；缺少映射即失败，工具不会访问该地址。压缩必须提供非null的compactContext。

例如，将name绑定到https://example.com/name的上下文会把name:"Alice"展开为该IRI下的@value:"Alice"。未绑定字段可能消失，空展开是有效结果；先检查术语绑定，不把空数组直接认作处理错误。相对IRI需要明确文档基准；本地文件名不会自动成为基准IRI。

{"contexts":{"https://example.com/context":{"@context":{"name":"https://example.com/name"}}},"compactContext":"https://example.com/context"}

先比较RDF数据集，再解释差异

粘贴右侧数据集，左侧可粘贴或打开导出文件。两份都须为严格N-Quads，使用绝对IRI和受支持RDF 1.1项；RDF/XML或Turtle需先导出。保留命名图、数据类型和语言含义；重复quad按集合语义去重，语言标签规范为小写。

仅把_:alice改为_:person可能没有改变数据集。RDFC-1.0及SHA-256会给同构数据共同规范形式。若不等价，新增和删除比较的是各自规范化后的行集合；图修改可能改变许多空白节点标签，因此不是最小修改方案或持久节点对应。下载两份规范文件再审阅。

明确CRS与轴顺序

当前支持EPSG:4326经度、纬度（度）与EPSG:3857东距、北距（米）这一对，源、目标须不同。六位数字不能证明CRS，请向来源获取准确声明。未知CRS、三维/M坐标及有效域之外的坐标拒绝。

经度120、纬度30的Web Mercator约为[13358338.895192828,3503549.843504374]米。核对一个已知点，并按明确数值容差反向检查。保留几何、环、孔洞顺序及Feature ID、属性；元数据数字保留原token。已有bbox/crs成员拒绝，以免留下旧边界；主动移除前先单独保存。不提供UTM、基准面/网格变换或拓扑修复。

按预算处理并从错误恢复

这些预算约束输入和计算，不证明接收应用能正确使用下载。预览最多200行或节点，成功下载包含完整结果；失败没有部分结果。

• 保留原始数据及精确上下文、CRS选择，在接收应用重新打开下载。
• 按精确URL补齐JSON-LD映射、修正N-Quads语法，或修正源CRS、轴顺序后再跑。
• 超出工作预算时，仅在不改变数据集含义的前提下分区；改扩展名不会改变支持范围。

本文相关工具