更新与变更说明:功能变了以后,先看影响范围和验证路径
模型、工具、接口、状态页和安全规则都会随平台迭代调整。这里不替代主站公告,而是告诉你遇到变化时应该先看哪里、怎么确认是否影响自己、改完配置后如何验收。
看变更前,先准备这 4 个信息
更新说明不是让你马上改配置,而是先判断“这次变化和我有没有关系”。准备好下面信息,再去看公告、模型广场或教程,会更容易做出正确判断。
| 准备项 | 用来判断什么 | 不要怎么做 |
|---|---|---|
| 当前使用场景 | 你是在用 Claude Code、Codex CLI、图形客户端、n8n、后端 API,还是图像视频任务。 | 不要只说“AI 不能用了”,先分清入口。 |
| 当前模型 ID | 判断公告里的新增、下线或能力变化是否影响你正在用的模型。 | 不要凭记忆写模型名,优先从配置、日志或模型广场复制。 |
| 当前令牌用途和分组 | 判断新模型或新能力是否在这条令牌的可见范围内。 | 不要贴完整令牌;只记录用途、分组和脱敏片段。 |
| 最近一次成功调用时间 | 方便和状态页、用量日志、配置变更时间对齐。 | 不要用“昨天还好好的”代替具体时间。 |
等不及了,先按这张表判断
更新说明的核心不是“看见新功能”,而是判断它会不会影响你的现有配置。先按影响级别分层,再决定是否马上操作。
| 影响级别 | 典型变化 | 你应该做什么 |
|---|---|---|
| 无需操作 | 新增教程、说明文案优化、状态页展示细节调整。 | 知道即可;下次排障时按新教程看。 |
| 建议验证 | 新增模型、模型能力说明变化、工具接入步骤补充。 | 用测试令牌跑一次最小请求,确认模型和分组匹配。 |
| 需要调整 | 旧模型不可用、Base URL 规则变化、客户端配置字段变化。 | 先在测试环境改,验收后再改长期使用配置。 |
| 需要暂停观察 | 状态页显示大面积异常、维护中、某类模型持续失败。 | 降低并发或换模型;不要在故障窗口里做大范围配置迁移。 |
3 分钟判断流程
看到更新消息时,先用这四步判断要不要行动。不要一看到“变更”就直接改长期配置。
先判断是否影响你正在用的能力
只看和你有关的模型、工具、接口或状态页分组。没有使用的能力,先记录即可。
再判断是否影响现有配置
如果只是新增模型,不一定要改;如果旧模型下线、Base URL 规则变化或字段变化,就需要测试迁移。
用测试令牌做最小验证
先复制当前模型 ID,用短 prompt、低成本参数和测试令牌验证,不要直接改正式项目。
记录结果再决定是否切换
把时间、模型、状态码、用量日志和回退方式记下来。验证通过后,再改长期配置。
这页解决什么问题
当你看到“新模型上线”“某个工具接入方式调整”“状态页颜色变化”“旧模型不可用”这类信息时,先不要直接改生产配置。按本页判断它影响的是哪一层,再回到对应教程操作。
| 你看到的变化 | 优先判断 | 先看教程 |
|---|---|---|
| 新增模型、模型名变化、某模型下线 | 模型 ID、模型分组和当前令牌权限是否匹配。 | 模型分组、模型列表 |
| Claude Code、Codex CLI、Gemini CLI 配置方式变化 | Base URL、Provider、令牌字段和项目级配置是否仍正确。 | CC Switch、工具接入总览 |
| OpenAI 兼容接口或 SDK 示例变化 | 请求路径、请求体字段、模型能力和错误码是否需要更新。 | 开发者 API 总览、进阶玩法 |
| 状态页显示异常或探测规则变化 | 是线路波动、低频探测、展示型分组,还是自己的配置问题。 | 状态页与可用性、FAQ 与排障 |
变更信息从哪里看
| 来源 | 适合看什么 | 看完以后做什么 |
|---|---|---|
| 主站公告或控制台提示 | 充值、账号、功能入口、维护通知、重要使用提示。 | 确认是否影响你的账号或正在运行的项目。 |
| 模型广场 | 当前可用模型 ID、分组、能力、价格或倍率口径。 | 复制最新模型 ID,不要凭记忆手写旧名称。 |
| 状态页 | 模型分组近期可用性、延迟、成功率和低频探测说明。 | 决定是等待恢复、换模型、降并发,还是查本地配置。 |
| 本使用教程 | 具体怎么配置、怎么调用、怎么验收、报错后看哪里。 | 按对应章节的完成标准重新验证。 |
不同变更的处理方式
模型变化
先回模型广场复制模型 ID,再确认令牌分组能访问它。旧模型不可用时,不要只改模型名,还要看上下文长度、多模态能力和价格口径是否变化。
工具变化
工具升级后可能改变配置读取优先级。Claude Code、Codex CLI、Gemini CLI 要分别检查,不要把一个工具的 Base URL 写法套用到另一个工具。
接口变化
先用最小 curl 或 SDK 示例跑通,再把参数带回业务代码。新增字段、异步任务、文件上传都要单独验收,不要只看保存配置成功。
状态变化
状态页异常时先判断影响范围。只有你失败,多半是令牌、模型 ID、Base URL 或本地网络;同类模型大面积异常时再考虑换线路或等待恢复。
看到更新时先不要做这些事
| 不要这样做 | 风险 | 更稳妥的做法 |
|---|---|---|
| 直接把正式模型 ID 换成新模型 | 新模型可能不在当前分组、参数不兼容或成本不同。 | 先用测试令牌和最小请求验收。 |
| 同时改 Base URL、令牌、模型和客户端版本 | 失败后无法判断是哪一项导致。 | 一次只改一个变量,保存变更记录。 |
| 在状态页异常时做大范围迁移 | 可能把临时波动误判成配置错误。 | 先降并发、保留旧配置,等状态稳定后再迁移。 |
| 把完整令牌贴到群里请求协助 | 密钥泄露后可能产生异常消耗。 | 只提供脱敏令牌片段、模型 ID、时间和错误码。 |
变更后怎么验收
确认影响对象
先写清楚变更影响的是账号、令牌、模型分组、工具配置、API 请求还是状态页判断。
复制当前模型 ID
从模型广场或 /v1/models 获取当前可用 ID,避免继续使用旧名称。
用测试令牌跑最小请求
聊天用“回复 OK”,图像视频用低成本参数,工具接入用新终端短问答。
核对用量日志
确认请求进入 6星中转,并能看到时间、模型、状态码或消耗记录。
再改正式配置
只有最小链路成功后,再把模型、Provider 或环境变量改到正式项目里。
按变更类型做最小验收
| 变更类型 | 最小验收 | 通过标准 |
|---|---|---|
| 新增聊天模型 | 用测试令牌调用 /v1/chat/completions,prompt 写“回复 OK”。 |
返回文本,且用量日志里模型 ID 和令牌一致。 |
| 新增 Claude 相关模型 | 先用模型列表确认可见,再用 Claude Code 或 Messages 最小请求验证。 | Base URL 没有手动加 /v1,短问答成功。 |
| 新增图像或视频能力 | 使用最低成本参数跑一次任务,确认返回结构和任务状态。 | 任务成功,日志里能看到对应模型和消耗。 |
| 工具配置教程更新 | 新建一个临时配置或测试项目,不覆盖正在使用的正式配置。 | 新配置可用,旧配置仍可回退。 |
| 错误码或状态页说明更新 | 复核你当前遇到的问题是否属于新说明覆盖的范围。 | 能明确下一步是改配置、换模型、等待恢复还是提交问题。 |
可复制的最小检查命令
如果变更影响模型、分组或 API 入口,可以先用下面两条命令判断“令牌是否能看到模型”和“模型是否能真实生成”。这只是低成本验收,不替代你的业务测试。
export COMEU_API_KEY="sk-你的令牌"
curl "https://www.6xin.cc/v1/models" \
-H "Authorization: Bearer $COMEU_API_KEY"
curl "https://www.6xin.cc/v1/chat/completions" \
-H "Authorization: Bearer $COMEU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "从模型广场复制的当前模型ID",
"messages": [
{"role": "user", "content": "回复 OK"}
],
"max_tokens": 16
}'
| 结果 | 说明 | 下一步 |
|---|---|---|
| 模型列表成功,短生成成功 | 令牌、分组、模型和基础生成链路都可用。 | 再回到你的真实工具或业务参数做验收。 |
| 模型列表成功,短生成失败 | 模型可见,但接口能力、参数或状态可能不匹配。 | 按错误码看 FAQ 错误码速查。 |
| 模型列表没有目标模型 | 当前令牌分组看不到这个模型。 | 看 模型分组,不要直接改正式配置。 |
| 两个请求都失败 | 优先怀疑令牌、Base URL、本地网络或状态页异常。 | 回到 快速开始失败回退。 |
不要直接改正式配置
模型和工具变化看起来很小,但一旦写进团队共用配置,影响范围会变大。建议按下面顺序迁移。
复制一份测试配置
新建测试令牌、测试 Provider 或测试项目,不覆盖正在工作的配置。
跑最小请求
只验证一个模型、一个工具、一条短请求,先证明基本链路没问题。
扩大到真实场景
再测试你的真实 prompt、图片、工作流或脚本参数,确认返回结构符合预期。
保留旧配置
正式切换前记录旧模型 ID、旧 Base URL、旧 Provider 名称和旧令牌分组。
观察日志
切换后看用量日志、状态码、耗时和错误率。异常时优先回退受影响工具。
团队使用时建议记录什么
| 记录项 | 示例 | 作用 |
|---|---|---|
| 变更时间 | 2026-06-21 18:00 左右 | 方便和用量日志、状态页、问题反馈对齐。 |
| 影响范围 | Codex CLI、图像生成、某个服务端项目 | 避免把一个工具的问题误判成全站问题。 |
| 旧配置和新配置 | 模型 ID、Base URL、Provider 名称、令牌分组 | 方便回滚,不要记录完整 API Key。 |
| 验收结果 | HTTP 200、短问答成功、用量日志可见 | 证明变更不是只保存成功,而是真的能调用。 |
可复制的记录模板
变更名称:
变更时间:
影响对象:账号 / 令牌 / 模型 / 工具 / API / 状态页
旧配置:模型 ID、Base URL、Provider、令牌分组(不要写完整令牌)
新配置:模型 ID、Base URL、Provider、令牌分组
最小验证:请求时间、状态码、模型、用量日志是否可见
回退方式:保留哪个旧配置,谁负责执行
多人协作时谁负责确认
| 变更对象 | 建议负责人 | 必须确认什么 |
|---|---|---|
| 个人工具配置 | 使用该工具的人 | 短问答成功,用量日志能对上,旧配置能切回。 |
| 团队共享令牌 | 令牌管理员或项目负责人 | 分组、额度、用途、禁用方式和使用范围。 |
| 后端服务模型 | 服务维护者 | 测试环境通过、日志字段可追踪、回退方式明确。 |
| 图像视频任务 | 任务流负责人 | 任务 ID、状态轮询、成本、失败重试和结果保存位置。 |
什么时候应该回退
| 现象 | 先做什么 | 回退判断 |
|---|---|---|
| 新模型请求 401 | 检查令牌是否复制完整、是否被禁用。 | 认证问题不一定要回退模型,先修令牌。 |
| 新模型请求 403 | 检查令牌分组和模型 ID 是否匹配。 | 如果无法快速创建匹配令牌,先回退旧模型或旧分组。 |
| 新模型 5xx 或超时变多 | 看状态页和用量日志,确认是否同类模型大面积异常。 | 影响真实业务时先回退,保留复现信息再排查。 |
| 客户端读不到新配置 | 重开终端或服务,确认项目级配置是否覆盖。 | 配置读取不明时,不要继续扩大改动范围。 |