Zivv Docs

主题

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

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

当前核验状态 ​

客户端官方信息源最近核验当前结论
Claude Code安装 · LLM Gateway2026-10-23原生安装器为推荐方式（npm 需 Node.js 22+）；网关优先使用 ANTHROPIC_AUTH_TOKEN，持久化推荐 ~/.claude/settings.json
Claude Desktop第三方推理2026-10-23通过 Developer Mode 的 Configure Third-Party Inference 接入
Codex CLICLI · 配置参考2026-10-23独立安装脚本为推荐方式；自定义 Provider 使用 Responses API
Codex 桌面端Codex App · 配置参考2026-10-23与其他本地 Codex 客户端共享用户级配置层
CursorBYOK2026-10-23Override OpenAI Base URL 为全局开关，官方未把任意 OpenAI Compatible Base URL 列为稳定能力
Devin Desktop（原 Windsurf）FAQ2026-10-232026-06-02 起更名；仍没有通用 Custom Provider Base URL 的稳定官方入口
规则文件Claude Code · Codex · Cursor2026-10-23Codex 读取 AGENTS.md；Cursor 推荐 .cursor/rules/*.mdc；Claude Code 也可读取 AGENTS.md

核验范围 ​

以下内容描述同一套接入方式，核验时必须一起检查，避免不同入口给出互相矛盾的配置：

  1. 客户端指南页：Claude Code、Claude Desktop、Codex CLI、Codex 桌面端、Cursor、Devin Desktop（原 Windsurf）以及 推荐全局规则。这些页面都带 lastVerified，由 npm run check:freshness 检查。
  2. 引用客户端名称或配置的其他页面：简介、选择接入方式、快速开始、常见问题、协议与兼容性 和侧边栏。客户端更名、设置入口变化时同步修改。
  3. 控制台与一键安装脚本（zivv-api 仓库）：令牌页的一键配置模板、控制台文档页，以及 scripts/install/ 下的安装脚本。环境变量名、Base URL 和配置文件写法必须与本站指南一致；修改指南时同步检查这些位置。

更新原则 ​

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

触发重新核验的情况 ​

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

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

核验清单 ​

每个客户端至少完成：

  1. 从官方来源重新安装或升级到当前版本。
  2. 用全新配置验证安装命令和设置入口。
  3. 发送最小文本请求并检查用量日志。
  4. 验证流式输出、工具调用和错误处理。
  5. 检查 Key 是否通过正确 Header 发送。
  6. 检查 Base URL 是否重复拼接版本路径。
  7. 对照核验范围，检查其他页面、控制台一键配置和安装脚本是否与指南一致。
  8. 更新页面的“最近核验”日期。
  9. 运行 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 会在文档变更时运行 npm run check，并在每月 1 日定期执行核验日期与官方链接检查。自动检查只能发现过期风险，不能替代人工确认客户端行为，也覆盖不到控制台和安装脚本。

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

© 2026 Zivv