AI 架构 — Downcity City SDK Docs

City 客户端 / Agent
        |
        v
CityModel（LanguageModelV3）
        |
        v
Federation AIService
  鉴权 -> 模型查找 -> fallback -> reasoning -> 计量
        |
        v
AIChannel.stream(ctx, LanguageModelV3CallOptions)
        |
        v
AI SDK 模型或私有上游适配器

CityModel 是客户端可执行模型，持有公开的 CityModelDescriptor 和 Federation transport，不知道上游密钥或厂商协议。

AIService 是服务端编排器，负责路由、fallback、reasoning 校验、usage 归一化和计费。

AIChannel 是服务端上游边界，负责连接配置、真实模型选择、AI SDK providerOptions 和 LanguageModelV3StreamResult 转换。

OpenAI 兼容端点只是适配器，不是第二条执行路径：

OpenAI JSON/SSE -> V3 call -> AIService -> AIChannel.stream -> V3 stream -> OpenAI JSON/SSE