版本与兼容性

SoFinder 遵循 Semantic Versioning。1.0 前的 Release 可变更 PHP Extension Interface，但 Changelog 及 UPGRADING.md 必须提供 Migration。beta.3 的 Storage Contract 变更是 1.0 前最后一项计划中的 Breaking Change。

从 1.0 开始：

• HTTP Route、文件化 JSON Field 与公开 PHP Contract 在整个 1.x 期间保持向后兼容。
• Minor Release 可以新建可选 Field、Capability Flag、Event 及 Interface；Client 必须忽略未知 JSON Field。
• Deprecation 至少保留一个 Minor Release，并在下一个 Major Version 移除前列入 Changelog。
• Security Fix 及 Data-integrity Fix 可在没有 Deprecation Period 的情况下收紧验证。
• 已发布的 Composer Tag 不可变。

1.0 Support Matrix 为 PHP 8.2–8.5 搭配 Symfony 6.4 LTS 或 7.4 LTS。内建 Local Adapter 是唯一纳入 1.0 Support Promise 的 Storage Backend。React Application 是 Composer Package 随附的私有 Build Input；1.0 不发布 npm Package。