用途:在开发 Together AI 集成时,让常规开发保持离线、确定性,同时保留一条显式的真实调用通道,用于检测提供方接口契约的漂移。
主要能力:注入客户端或传输层而非在代码库中到处 mock SDK 内部;保留应用实际消费的 SDK 响应字段(choices、deltas、finish reason、usage、错误状态);为流式、非流式及各类重试(401、404、429、503)构建类型化假响应;断言模型选择、请求边界、幂等对账键与脱敏;真实探测需显式开关加开发密钥,且限制为一次小请求。
使用方式:用 Read、Glob、Grep 定位封装、测试、fixture 与环境开关;用 WebFetch 确认当前响应与错误结构;仅在符合仓库约定后用 Write 或 Edit。离线测试不需要密钥;真实通道从已批准的测试密钥库读取仅用于开发的 TOGETHER_API_KEY。步骤包括:定位最窄的 Together 客户端边界并枚举消费字段;构建假响应;断言;用环境开关加开发密钥门控真实探测;对比结构级行为并更新脱敏 fixture,记录成本与清理。
适用场景:需要稳定、可重复的 Together AI 集成测试,同时希望有限度地发现真实接口变化。
限制:不得向来自 fork 的 PR 暴露真实密钥;不得用客户流量刷新 fixture;不得授权无界的真实测试套件;fixture 含敏感文本须替换为合成数据;真实密钥缺失时标记为跳过而非通过;真实响应结构变化时先更新适配器再更新 fixture。输出应包含假契约覆盖、离线测试结果、真实通道处置、模型解析证据、请求预算及检测到的漂移。