升级回归清单

主站升级（sub2api 镜像更新）后，文档站要核对什么。

为什么需要这份清单

文档站与主站完全解耦——文档是纯静态站，主站升级不会碰它（详见部署与发布）。 但文档描述的是主站的行为，所以主站改了东西，文档可能就说得不对了。

这份清单列的是「升级后要人工确认一遍」的点。不是每次都要全跑， 按升级涉及的范围挑着看。

零、先看数据有没有自动跟上

最省事的一步——重新构建，让数据管线自己去对：

刷新数据并查看变化

cd fluxtoken-docsexport PATH="$HOME/.local/node/bin:$PATH"npm run buildgit diff --stat docs/.vitepress/data/groups.json

如果 groups.json 有变化，说明分组/模型/价格动过了。看 diff 确认：

• 有没有新增分组 → 需要补一句「什么时候该选它」的人工说明
• 有没有分组被删 → 检查哪些页面还在引用它（搜索分组名）
• 倍率变了 → how-to-choose 里的推荐表可能需要调整
• 模型增删 → 模型列表 会自动跟上，但要确认分档计价标记是否正常

数据是自动的，人工说明是手写的。 差异就在这。

一、账号与登录相关的开关

以下开关状态来自 /api/v1/settings/public。升级后可能被重置或默认值变化：

检查线上开关与文档是否一致

node scripts/check-status.mjs

这个脚本会把上表的所有开关、端点连通性和条款 revision 一次查完， 与文档不一致的项会标 ⚠ 并以非零状态码退出，方便挂进 CI 或升级流程。

对照性检查：

开关	文档依赖它的地方	当前值（2026-10-08）
registration_enabled	注册账号	true
email_verify_enabled	注册账号	true
github_oauth_enabled	注册账号	true
google_oauth_enabled	注册账号	true
turnstile_enabled	注册账号	true
invitation_code_enabled	注册账号（当前写「不需要」）	false
totp_enabled / passkey_enabled	账号与安全（当前写「未开启」）	false
payment_enabled	充值额度	true
model_plaza_enabled	模型价格表	true
model_plaza_require_auth	广场是否需登录	false
hide_ccs_import_button	CC-Switch 一键导入	false（即按钮可用）
version	各页页尾「站点版本」	0.2.11

任何一项与文档描述不符，就要改对应页面。 尤其是 hide_ccs_import_button 一旦变成 true，CC-Switch 页的整条主推路径就失效了。

二、端点和域名

项	当前值	文档依赖
国内加速端点	https://cn.fluxtoken.ai	全站
全球站端点	https://api.fluxtoken.ai	端点与域名
公开价格接口	https://status.fluxtoken.ai/pricing/provider-pricing.json	公开价格接口
服务状态页	https://status.fluxtoken.ai/	多处
控制台菜单「模型监控状态」	指向 status 站	快速自查清单

端点连通性检查

for u in https://cn.fluxtoken.ai/v1/models \         https://api.fluxtoken.ai/v1/models \         https://status.fluxtoken.ai/pricing/provider-pricing.json; do  printf '%-62s ' "$u"  curl -s -o /dev/null -w '%{http_code}\n' --max-time 12 "$u"done# 期望输出：401 401 200

期望结果是 401 401 200：前两个需鉴权（返回 401 才正常），价格接口公开（返回 200）。 若出现 404，说明端点可能变了。

/v1/models 返回 401 是正常的（需鉴权）。返回 404 就要查了——可能端点变了。

三、条款文本

条款更新后必须重新抓取并生成页面：

查看条款版本

node scripts/check-status.mjs | grep -i revision

check-status.mjs 的输出里含 条款 revision 一行。记下它，值变了就是条款有更新。

记下 login_agreement_revision（当前 26036769b02b922a）。 值变了就是条款有更新，此时：

1. 重新抓取到 _facts/legal/
2. 跑 node scripts/gen-legal.mjs
3. 检查 条款与政策总览 里的「必须先知道的三条」和「常见疑问」是否还准确 （尤其是退款手续费比例、退款时限、地区限制这三项）

四、页面里引用的控制台路径

文档里写了具体的控制台操作路径。UI 改版会让这些失效：

文档里的路径	出现在
令牌管理 → 添加令牌	创建 API 令牌
钱包 / 充值入口	充值额度
模型广场入口	模型价格表
查看错误请求记录	快速自查清单
侧边栏「模型监控状态」菜单项	快速自查清单

升级后如果有 UI 改版，逐条点一遍确认。

五、报错文案

报错原文索引和各 FAQ 专题里的报错标题，是从平台实际返回或 上游惯例推导的。如果升级后平台改了报错文案，用户就搜不到了。

重点核对这几条（它们出现频率最高）：

• 模型不存在 —— 分组不含该模型时的报错
• 401 相关的认证失败提示
• 余额不足提示

改法：把新文案加进索引页，旧的保留做别名（用户手里可能有旧截图）。

六、构建与发布链路

升级不影响文档站构建，但值得顺手确认依赖还装得上：

干净重建

cd fluxtoken-docsrm -rf node_modules docs/.vitepress/distnpm cinpm run buildls -la docs/.vitepress/dist/ | head

快速版：只跑这三条

时间紧的时候，跑这三条就够覆盖八成风险：

# 1. 数据有没有变（分组、模型、价格）
cd fluxtoken-docs && npm run build && git diff --stat docs/.vitepress/data/groups.json

# 2. 关键开关有没有被重置
curl -s https://cn.fluxtoken.ai/api/v1/settings/public | node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{const d=JSON.parse(s).data;["registration_enabled","email_verify_enabled","github_oauth_enabled","google_oauth_enabled","turnstile_enabled","invitation_code_enabled","payment_enabled","model_plaza_require_auth","hide_ccs_import_button","version"].forEach(k=>console.log(k.padEnd(34),d[k]))})'

# 3. 端点还通不通（期望 401 401 200）
for u in https://cn.fluxtoken.ai/v1/models https://api.fluxtoken.ai/v1/models https://status.fluxtoken.ai/pricing/provider-pricing.json; do printf '%-62s ' "$u"; curl -s -o /dev/null -w '%{http_code}\n' --max-time 12 "$u"; done

与主站升级流程的挂靠

主站升级流程见服务器上的 GIT升级工作流.md。建议在其中「验证」环节后追加一步：

文档回归：跑本页「快速版」三条命令；若数据有变化或开关有变动， 更新对应页面并重新发布文档站。

这样文档不会落后于产品。

数据快照：2026-10-08 · 站点版本 0.2.11
来源：模型广场接口 · 价格接口
文档站数据随构建自动更新；实时价格、可用性与限额请以控制台实际展示为准。