Skip to content

研究工具 ​

当前 shared/btlx/tools/ 已提供 schema recovery 阶段的离线工具,包括:

  • btlx_wire.py:严格 wire parser 与 byte-preserving serializer;
  • scan_corpus.py:APK 内 BTLX corpus 扫描与 root inventory;
  • nested_recovery.py:保守 nested candidate 分析;
  • recover_proto_descriptor.py:从 native 恢复 FileDescriptorProto;
  • build_schema_profile.py:建立 per-title/version BattleArgs profile;
  • compare_descriptors.py:跨标题 descriptor 对比;
  • validate_descriptor_corpus.py:按 descriptor 递归验证 corpus;
  • validate_recovery.py:SchemaRecovery/v1 focused gate。

这些工具当前仍属于 research tooling,不等于已经完成可编辑的 BTLX Core。

下一阶段 ​

Reference 站之后的首选实现工作单元仍是:

EasyTechBTLXLosslessCodec/v1

目标是建立 profile-aware 的:

text
inspect
dump
diff
roundtrip
set / add / remove(后续)

writer 必须默认保留 untouched unknown/raw fields,不能把 protobuf canonicalization 当作“无损”。