专有场景 API 总览
OnePath™ 在统一逻辑网络（Unified Logical Network, ULN）的核心数据面之上，提供一组面向 特定场景的扩展能力：同机零拷贝传输、高级发布订阅、安全通信、分布式追踪与指标、网络 拓扑感知、JSON/JSON5 操作，以及三模存储 / 三模计算 / 多模冗余等可靠性封装。
这些能力都以 OnePath 既有的发布→订阅、查询→应答、持久请求→应答三条通路为基础，按 「一个高度封装的入口 + 可选 opts 逐项覆盖」的风格设计：传 NULL/默认即取全默认行为， 需要精细控制时再填 opts。本页给出每个场景的变体可用性，点击任一行进入对应专题。
变体可用性矩阵
OnePath 提供 完整版（Full） 与 精简版（Tiny） 两个变体，核心 API 完全一致。 下表列出各专有场景在两个变体下的可用情况。完整版独占的能力，在精简版的头文件中即被 声明剔除——误用会在编译期报错，而非留到运行期，便于及早发现移植问题。
| 场景 | 完整版 Full | 精简版 Tiny | 说明 |
|---|---|---|---|
| 同机零拷贝 SHM | ✅ | — | 完整版专属；精简版头文件中声明被剔除 |
| 高级发布订阅 | ✅ | — | 完整版专属（缓存 / 丢包恢复 / 历史回放） |
| 安全通信 | ✅ | TLS ✅ / 认证 — | TLS 加密两个变体均支持；用户名密码认证为完整版专属 |
| 分布式追踪与指标 | ✅ | ✅ | 两个变体均支持，纯环境变量开关 |
| 网络拓扑感知 | ✅ | ✅ | 两个变体均支持，接口与用法一致 |
| JSON / JSON5 操作 | ✅ | ✅ | 两个变体均支持，独立于会话可用 |
| 三模存储 | ✅ | — | 完整版专属便捷封装 |
| 三模计算 | ✅ | — | 完整版专属便捷封装 |
| 多模冗余 XMR | ✅ | ✅ | 两个变体均支持的冗余容错层 |
关于「完整版专属」
完整版专属并非「精简版无能为力」，而是一条清晰的能力边界：这些能力依赖完整版运行时 才有意义。精简版下，相关 API 在头文件中即被声明剔除，误用在编译期即报错；个别在运行期 判定不可用的能力（如拓扑）则统一返回 ONEPATH_ERR_UNSUPPORTED，应用据此优雅降级即可。 关于如何选择变体，见 核心 API 总览。