1. 核心定义

Wrapper 是一种设计模式，旨在通过一层抽象代码，将原本复杂、难用或接口不匹配的底层功能，转换为更易于使用且符合业务逻辑的接口。本质上是屏蔽底层实现，降低系统耦合。

2. 典型应用场景：LLM 接口统一

在调用 LLM（如 OpenAI、Claude 等）时，直接使用原始 API 会产生大量重复的样板代码（构造 messages 数组、配置参数、异常捕获、流式处理等）。

封装前（痛点）：

  • 调用逻辑分散，难以维护。
  • 底层 SDK 更新或更换供应商时，全站代码需要重构。
  • 无法统一管理 Token 计数、日志记录或重试策略。

封装后（Wrapper 模式）： 将复杂请求包装为 Ask(text) 或 Chat(text) 方法，业务层无需感知底层实现。

本文归档于个人知识库 · 领域：CS & AI · 模块：04 Project_CS_AI/General