v0.2.4 更新日志

发布日期：2026 年 3 月 4 日

v0.2.4 是 v0.2.x 的功能迭代版本，不包含任何破坏性变更，所有现有部署和插件无需任何修改即可升级。

同期发布的 Contracts v0.2.6 在 IApiPlugin 接口中新增了 OnRoutePrefixResolved 回调方法，插件可选择实现以感知最终生效的路由前缀。

新增内容

新增：路由前缀回调 (OnRoutePrefixResolved)

当插件启用了 UseAutoRoutePrefix 时，运维人员可通过 appsettings.json 的 RouteOverride 节将插件的路由前缀覆盖为自定义值。此前插件无法感知这一变更；v0.2.4 起，主程序会在路由前缀确定后调用插件的 OnRoutePrefixResolved 方法：

void OnRoutePrefixResolved(string resolvedPrefix, bool isOverridden);

参数	说明
resolvedPrefix	最终生效的路由前缀（不含前导斜杠）
isOverridden	前缀是否来自 RouteOverride 配置覆盖

该方法在 IApiPlugin 中提供了默认空实现，不重写不影响插件的正常运行。仅当插件需要在启动时记录、对外暴露或依赖最终前缀时才需要实现。

详细用法请参阅 路由注册 → 感知路由前缀更改。