用途
Cohere Local Development Loop 用于在本地构建一个确定性的 Cohere 开发循环。其核心目标是：让常规开发保持离线、可复现，同时保留一条受严格约束的路径，用于验证真实的 v2 契约。
主要能力
- 对应用自有的提供者接口进行 mock，而不是对生成的 SDK 内部实现进行 mock。
- 存储具有代表性的 v2 Chat、Embed、Rerank、流式、错误和工具调用（tool-call）夹具，并移除其中的密钥。
- 将真实调用置于显式的环境开关和受保护的评估密钥之后。
- 将模型 ID 和 SDK 响应类型视为由适配器测试覆盖的外部契约。
使用方式
前置条件包括：目标仓库、运行时、环境和可问责的负责人；用于任何实时验证的已批准 Cohere 团队和密钥；当前的质量、安全、隐私、容量和变更控制要求。
工具纪律：使用 Read、Glob 和 Grep 检查代码、配置和证据。仅在获取当前 Cohere 一手文档时使用 WebFetch。仅当用户请求实现且确切目标文件已知时，才使用 Write 或 Edit；绝不写入凭据或客户内容。
认证：使用从已批准密钥管理器注入的环境特定密钥。绝不打印、持久化、提交或将 CO_API_KEY 放入示例中。使用与任务相称的成本最低的有界操作确认访问权限，并将密钥创建、轮换、撤销、角色变更和生产容量请求视为需负责人批准的操作。
操作步骤：
- 在添加文件之前，先定位提供者边界和现有测试框架。
- 为应用实际需要的操作定义一个窄范围的 Cohere 端口。
- 为成功、速率限制、超时和格式错误响应路径添加经过净化的夹具。
- 为请求映射、响应解析和脱敏编写离线契约测试。
- 添加一个可选的实时冒烟测试，仅包含单个请求和硬超时。
- 记录确切的离线和实时命令，并确保默认测试命令不进行任何网络调用。
审批边界：未经可问责负责人批准，不得暴露或轮换密钥、更改 Cohere Team 角色、接受商业条款、启用敏感生产数据、增加支出或容量、切换生产模型、发送支持包或执行模型提议的副作用。除非请求实现，否则保持诊断只读。
输出：返回解析后的 API 和模型契约、检查过的文件或设置、收集的证据、验证结果、剩余风险、负责人以及回滚或下一步操作。对密钥、授权头、提示、检索文档、嵌入、客户标识符和不受限的环境输出进行脱敏。
错误处理：
- 夹具漂移：从脱敏的实时响应刷新并审查差异。
- 意外支出：除非设置了显式实时测试开关，否则失败关闭（fail closed）。
- 不稳定测试：用本地提供者端口替换 SDK/网络依赖。
- 快照中的密钥：若为真实密钥则撤销，清理历史记录，并添加回归断言。
示例：使用紧凑的交接形式，使所选范围、验证证据和操作结果可审查。 输入：framework=vitest; default=offline; live-switch=COHERE_LIVE_TESTS 预期交接：offline=pass; network-calls=0; live-smoke=opt-in; fixtures=sanitized
适用场景
适用于开发或测试 Cohere 集成时，需要在本地进行确定性、离线的开发与测试，同时保留一条受控的实时验证路径。
限制
资料未提供具体的收费、价格、平台支持范围或效果保证等信息。使用实时验证需要已批准的 Cohere 团队和密钥，且受审批边界约束。