版本：0.6.1

路线图

核心原则：功能通过约定自动发现或配置激活。用户永远不需要改变 ISharkEndpoint 编码模式，不需要实现新接口，不需要在业务代码中调用框架 API。

v0.4.0 — 2026-06-28 ✅

废弃 [SharkEndpoint] / [SharkMethod] / SharkHttpMethod 及相关反射基础设施 — 迁移到 ISharkEndpoint
启动配置自检 — ConfigurationValidator 在 AddShark() 时校验 JWT、多租户配置
优雅关闭 — K8s 友好的 SIGTERM 处理：/healthz → 503，排空请求，然后关闭
审计日志批量/异步写入 — Channel 缓冲 + 后台刷新（AsyncWrite、BatchSize、FlushInterval）
幂等性分布式存储 — IIdempotencyStore 可通过 TryAddSingleton 或 IdempotencyStoreFactory 替换
限流分布式存储 — IDistributedRateLimitStore + SharkRateLimiterMiddleware，默认 MemoryRateLimitStore，RateLimitStoreFactory
Sharkable.Cache.Redis NuGet 插件 — Redis 版 IIdempotencyStore + IDistributedRateLimitStore，AddSharkableRedis()

#	功能	价值	侵入度	状态
5	内置分布式追踪	可观测性	零 — `ActivitySource`	✅
6	可扩展健康检查 — 结构化JSON `/healthz`，自定义检查，自动JWT检测，运行时长+版本	运维	仅配置	✅
7	轻量性能面板	调试	仅配置	✅

#	功能	价值	侵入度	状态
8	幂等性分布式存储接口	集群高可用	仅配置	✅ v0.4.0
9	多租户数据源隔离 — `ITenantDataSource` scoped服务，`ConfigureDataSource()` 按租户路由连接串	SaaS	仅配置	✅
10	限流分布式存储接口	集群高可用	仅配置	✅ v0.4.0
11	自适应限流	鲁棒性	仅配置

#	功能	价值	侵入度
20	`ConfigureOnStarted` / `ConfigureOnStopped` 回调 — 应用就绪和关闭清理的钩子（预热缓存、关闭连接、刷新缓冲区）	启动/关闭控制	仅配置
21	独立存活探针 `/livez` — 始终返回 200 的 k8s liveness 端点，与 `/healthz` readiness 分离	K8s 原生运维	零 — 开启健康检查后自动
22	启动就绪闸门 — `/healthz` 在所有 `OnStarted` 回调完成前返回 503，防止初始化未完成就接入流量	生产安全	零 — 内部机制
23	预热 / 异步初始化 — `IWarmupService` 接口 + `ConfigureWarmup(Func<IServiceProvider, CancellationToken, Task>[])`，在 app 启动后、就绪探针变绿前执行	冷启动优化	仅配置
24	启动 DI 验证 — 可选 `ValidateOnStart` 标志，启动时主动解析所有注册的服务，提前捕获缺失的 DI 注册	快速失败	仅配置
25	启动横幅 — 在 `UseShark()` 时输出框架版本、已启用功能和关键配置	运维	零 — 自动
26	中间件管道注入点 — `app.UseShark(beforeAuth: mw => ..., afterAuth: mw => ...)` 在精确位置插入自定义中间件	管道控制	仅配置
27	预创单例 — `[SingletonService(Eager = true)]` 标志，在启动时预先创建单例实例而非首次解析时创建	冷启动优化	属性选项