Published November 4, 2026 | Version 1.0

代理订阅转换的语义保留与差异检查方法

Authors/Creators

  • 1. iLang Inc.

Description

代理订阅的转换结果通常以"生成文件"或"成功导入"表示,但这些事件不能证明地址、认证、插件参数和客户端策略得到保留。本文提出面向明确支持域的字段投影检查方法,将源配置、目标配置、显式节点映射和审阅规则分开处理,使用 field-preserved、transformed、changed、unsupported 与 unknown 五类结果保留差异和不确定性。实现采用 Python 标准库,在本地比较 SIP008 v1 与 sing-box Shadowsocks 出站 JSON,不下载订阅、不运行第三方转换器,也不将配置值或秘密写入报告。对人工编写的 19 个合成案例及 19 项单元测试完成 Linux 运行,分别识别保留、已知等价表示、字段改变、插件丢失、未映射节点和未知策略。所得结果验证检查器在这些样本上的行为,不构成真实转换服务的质量排名、客户端兼容认证或网络连通性证明。

A generated or successfully imported proxy configuration does not establish that endpoint, authentication, plugin, or policy semantics have been preserved. This technical note introduces a bounded field-projection method that separates source and target configurations, an explicit node mapping, and reviewed comparison rules. Results distinguish field-preserved, transformed, changed, unsupported, and unknown states. A Python standard-library implementation locally compares SIP008 v1 documents with sing-box Shadowsocks outbound JSON, without fetching subscriptions, invoking a third-party converter, or exposing configuration values in reports. Linux execution covered 19 manually authored synthetic cases and 19 unit tests, including representation changes, altered fields, plugin loss, unmapped nodes, and unmodeled policies. These results establish the checker's observed behavior on the declared fixtures, rather than conversion-service quality, full client compatibility, or network connectivity.

全文与复现材料:代理订阅转换的语义保留与差异检查方法。

Notes

Implementation snapshot: 8261a8b8e7a3189bc0eec8c23c7e7906d3f6f063. Evaluation uses synthetic fixtures and local Linux software tests; physical-device performance measurements are outside this version.

Files

subscription-semantics-toolkit.zip

Files (1.2 MB)

Name Size
md5:684beb33ebd127d7116faea3662e20b7
36.9 kB Preview Download
md5:8633c37ff04ded6e3a97ae8666adec70
17.0 kB Preview Download
md5:b58b58aa1b822157241d11c97f33c5ec
15.2 kB Preview Download
md5:a4c0d12a2a24eee083fc702196748953
1.1 MB Preview Download

Additional details

References

  • Zhu, Long Quan (2026). 面向用户自主 AI 的设备配置协议:目标绑定、局部修复与证据验收. 10.5281/zenodo.23961041. 先前设备配置协议;本文将转换后逐项核对细化为独立检查器。
  • Shadowsocks contributors (n.d.). SIP008 Online Configuration Delivery. https://shadowsocks.org/doc/sip008.html. 访问于 2026-11-04;格式章节明确规定无插件时 plugin 与 plugin_opts 可为空或从服务器对象省略。
  • SagerNet / sing-box contributors (n.d.). Shadowsocks outbound configuration. https://sing-box.sagernet.org/configuration/outbound/shadowsocks/. 访问于 2026-11-04;目标出站字段与 obfs-local、v2ray-plugin 支持集合的审阅依据。
  • Bray, T. (2017). The JavaScript Object Notation (JSON) Data Interchange Format (RFC 8259). 10.17487/RFC8259. JSON 与重复键互操作性的规范依据;检查器另采用更严格的输入拒绝策略。
  • Jackson, Daniel; Ladd, David A. (1994). Semantic Diff: a tool for summarizing the effects of modifications. 10.1109/ICSM.1994.336770. 相关工作:区分表示变化与意义变化。作者摘要 https://www.cs.cmu.edu/~Compose/paper_abstracts/dnj/semantic_diff.html;本文不声称实现其程序分析算法。
  • Eastlake 3rd, D. (2006). Domain Name System (DNS) Case Insensitivity Clarification (RFC 4343). 10.17487/RFC4343. ASCII DNS 名称大小写等价规则的依据,不用于扩大到任意 Unicode 名称。
  • Kawamura, S.; Kawashima, M. (2010). A Recommendation for IPv6 Address Text Representation (RFC 5952). 10.17487/RFC5952. IPv6 地址多种文本表示与规范表示的依据。