服务层与基础设施
services/ 承载 API 调用、认证、设置、分析、成本、LSP、迁移 等与 UI/对话解耦的横切能力。
1. API 服务
| 能力 | 说明 |
|---|---|
callModel | 流式、重试、多后端路由 |
| 后端 | Anthropic Direct、Bedrock、Vertex 等 |
| 限流 | 429 退避、用户可见提示 |
2. 认证
OAuth 设备流 / API Key;token 刷新与 安全存储(OS keychain 类,见 11)。
3. 成本追踪
按请求统计 input/output token,会话累计;触达限额时警告或阻断(策略可配置)。
4. 分析与遥测
GrowthBook feature flag、匿名 usage 事件(可 opt-out)。门控实验功能。
5. Settings
多源 JSON/JSONC 合并:defaults < 全局 < 项目 < 本地 < CLI flag(见 12 专题 10)。
6. LSP
语言服务协议集成:诊断、定义跳转,作为工具或后台服务,减轻模型盲改。
7. History / State / Migrations
会话持久化、版本升级迁移脚本,避免升级后配置损坏。
8. 总结
服务层 = 「连得上、配得对、算得清」;对话循环只依赖稳定服务接口。