Zivv Docs

主题

客户端文档版本维护策略 ​

客户端安装命令、配置字段和默认模型会随官方工具更新。本页说明这些文档如何核验，以及何时必须重新检查。

当前核验状态 ​

客户端官方信息源最近核验当前结论
Claude Code安装 · LLM Gateway2026-07-24使用原生安装器；网关优先使用 ANTHROPIC_AUTH_TOKEN
Claude DesktopClaude Apps Gateway2026-07-24通过 Developer Mode 的 Configure Provider 接入
Codex CLICLI · 配置参考2026-07-24独立安装脚本为推荐方式；自定义 Provider 使用 Responses API
Codex 桌面端Codex App · 配置参考2026-07-24与其他本地 Codex 客户端共享用户级配置层
CursorBYOK2026-07-24官方未把任意 OpenAI Compatible Base URL 列为稳定能力
WindsurfAI Models2026-07-24当前没有通用 Custom Provider Base URL 的稳定官方入口

更新原则 ​

  1. 官方文档优先：安装命令、字段名和支持范围只以客户端官方文档为依据。
  2. Zivv 能力二次核验：官方支持某个字段，不代表网关已经支持该客户端的全部请求；还要用真实 Key 做最小请求和高级功能测试。
  3. 不固定易变数据：模型 ID、价格、默认模型和可用分组以模型广场及控制台为单一来源。
  4. 明确支持边界：官方未承诺的行为标记为实验性，不把“某个版本可用”写成长期保证。
  5. 保留核验日期：每个客户端页面都显示 lastVerified，让读者判断信息新鲜度。

触发重新核验的情况 ​

出现以下任一情况时，应在发布文档前重新检查：

  • 客户端大版本或安装器发生变化
  • 设置界面新增、移除或重命名 Provider / Base URL 字段
  • 官方认证变量、请求协议或默认 API 发生变化
  • 默认模型、模型别名或工具调用机制变化
  • Zivv 网关升级 Responses、Anthropic Messages 或流式协议实现
  • 客服反馈同一配置问题连续出现
  • 距离上次核验超过 45 天

核验清单 ​

每个客户端至少完成：

  1. 从官方来源重新安装或升级到当前版本。
  2. 用全新配置验证安装命令和设置入口。
  3. 发送最小文本请求并检查用量日志。
  4. 验证流式输出、工具调用和错误处理。
  5. 检查 Key 是否通过正确 Header 发送。
  6. 检查 Base URL 是否重复拼接版本路径。
  7. 更新页面的“最近核验”日期。
  8. 运行 npm run check。

自动质量检查 ​

仓库提供两类检查：

bash
npm run check
npm run check:freshness
npm run check:official-links
  • npm run check：构建站点，并检查 frontmatter、内部链接、canonical、OG、Twitter Card 和 JSON-LD。
  • npm run check:freshness：当客户端文档超过 45 天未核验时失败。
  • npm run check:official-links：检查本页和客户端页面引用的官方来源是否仍可访问。

GitHub Actions 会在文档变更时运行质量检查，并定期执行核验日期与官方链接检查。自动检查只能发现过期风险，不能替代人工确认客户端行为。

Zivv — OpenAI / Anthropic / Gemini 多协议 AI Gateway

© 2026 Zivv