AuthSdk 总览

• 入口与结构

  • 依赖注入扩展： AuthSdk/Extensions/ServiceCollectionExtensions.cs
  • 配置选项： AuthSdk/Options/AuthSdkOptions.cs
  • 公共接口（消费方依赖）：
    • AuthSdk/Abstractions/IAuthServerTokenProvider.cs
    • AuthSdk/Abstractions/IChannelTokenProvider.cs
  • 内部实现（仅 SDK 内部使用）：
    • AuthSdk/Internal/AuthServerTokenProvider.cs
    • AuthSdk/Internal/ChannelTokenProvider.cs
    • AuthSdk/Internal/TokenCacheEntry.cs
  • 统一异常类型： AuthSdk/Exceptions/AuthSdkException.cs
  • 文档：
    • 使用说明： AuthSdk/USAGE.md
    • 设计说明： AuthSdk/DESIGN.md

• 消费方最佳实践

  • 通过 ServiceCollection 扩展方法注册 SDK（具体方法名见 ServiceCollectionExtensions）。
  • 通过 IOptions 配置 AuthSdkOptions（建议由配置文件/机密管理器绑定）。
  • 仅依赖 Abstractions 中的接口，不要直接依赖 Internal 命名空间类型。
  • 捕获并处理 AuthSdkException，向上游返回简明错误信息，避免泄露敏感细节。

• 重要约束

  • Internal/* 为实现细节，不对外部项目开放直接引用。
  • 对外 API 变化需审慎评估兼容性，并同步更新 USAGE.md 与 DESIGN.md。