用途:为开发者设计高质量 Swift 库与框架提供模式与最佳实践指导,当涉及 Swift 库/框架设计或公开 API 设计模式时使用。
核心原则:协议导向设计,围绕带关联类型的协议实现灵活性与可测试性,用泛型兼顾类型安全与运行时多态;编译期安全,借助类型系统、不可复制类型、泛型与协议约束让非法状态不可表示;默认性能,热路径使用 @inlinable,避免不必要分配并提供零拷贝选项;渐进式披露,简单场景保持简单,复杂需求仍可实现,提供合理默认值同时允许自定义。
关键模式:带关联类型的协议,如 public protocol Handler<Context>: Sendable 定义 associatedtype Context 与异步 handle 方法,消费方通过泛型约束接受任意符合类型;ResponseGenerator 模式,让多种返回类型自动转换,例如为 String 与 HTTPResponse.Status 扩展 response 方法;结果构建器 DSL,用 @resultBuilder 定义 PipelineBuilder,通过 buildExpression 与 buildPartialBlock 组合中间件;静态构建方法,如 ServerBuilder 提供 .http1(config:) 与 .http2(tlsConfig:) 等流式入口。
参考文件:references/api-patterns.md 涵盖协议设计、结果构建器、构建器模式、错误处理与参数提取;references/performance.md 涵盖内联、不可复制类型、数据结构、无锁模式与状态机。
限制:资料未提供安装命令、平台支持、收费方式与具体使用步骤,暂未提供。