系统设置

修改管理员密码、轮询策略与 sub2api / 维护参数

—

修改管理员密码

本卡片独立保存（点「更新密码」）。密码哈希写入数据库（hybrid 的 PostgreSQL）。环境变量 GROK2API_ADMIN_PASSWORD 仅用于首次无密码时自动导入，之后鉴权以数据库为准。当前密码不会下发到前端，须手动输入。

—
不会自动填入；请自行输入当前密码后再设新密码。

轮询与维护

账号选择策略与后台维护开关（立即生效）。间隔类改完保存后下一周期生效。

逗号分隔；后台每轮轮询其中一个，避免笛卡尔积打爆池子
默认 90；大池子可适当调高减轻刷新风暴
到期前多少秒开始刷新；默认 120
0 = 仅手动；≥30 为周期探测。大号池建议 120–300。默认 180
每轮选取账号数；实际可能按 workers 自适应放大。默认 120
同时探测的账号数。大号池建议 8–16。默认 12
多轮对话绑定同一账号的缓存时长；默认 7200（2h）

账号出站代理池

账号池请求上游（聊天 / 测活 / Token 续期）走代理。按账号粘性选代理，与会话粘性配合更稳。协议注册可共用同一列表，也可单独配置。

—

未配置时直连上游。策略 round_robin 会对账号 ID 做稳定哈希（同账号固定出口）。

Relay / sub2api 参数

影响 Claude Code / sub2api 工具流、reasoning 兼容与长上下文压缩。单工具 + 间隔可避免 “Content block not found”。

sub2api / Claude Code 建议保持 1
仅 /v1/chat/completions；默认 0
推荐 0.08；纯 OpenAI 客户端可设 0
messages JSON 超过此长度时强制压缩；0=关闭（默认，优先智商）。仅当大会话导致上游失败时再设阈值
仅在开启压缩时生效：近乎完整保留最近 N 轮 tool；默认 32（智商优先）
仅开启压缩时：最近轮次单条 tool 上限（head+tail）；默认 48000

轮询 / 冷却 / 踢出策略

失败即进入冷却状态（无时长，仅测活成功或手动解除）；可配置模型封禁 TTL、探测踢出次数与故障切换上限。

free-usage 耗尽时仅封禁该模型，到期自动恢复
模型真正不可用时封禁时长，到期由探测自动复核
请求/探测失败会把账号标记为冷却中（纯状态，没有倒计时）。仅下次测活成功或管理台手动解除后才回到轮询；临时额度错误可同时软封禁该模型；多次探测失败会进一步踢出或禁用。

sub2api 导入

—

配置 sub2api 管理端地址与登录后， 可在「账号」页将本地 Grok 账号批量导入到指定分组（平台 grok / OAuth）。 优先使用本地 access/refresh token 直推；无 token 时回退 SSO→OAuth。

勾选后会同时启用 sub2api 导入；协议注册入库本地后立刻推送到上方分组（需填好 URL/登录/分组）。点「保存设置」后生效。
本地→sub2api 同时推送几个账号；默认 4
写入 sub2api 每个账号的并发容量；在线推送与导出数据均生效。默认 3
sub2api account.priority；默认 50
sub2api 计费/限速倍率；默认 1.0

保存后到「账号」页：可「导入 sub2api（选中/全部）」在线推送；或「导出 sub2api 数据」下载官方 sub2api-data 备份，在 sub2api 管理台「导入数据」上传。 勾选「注册成功后自动入库 sub2api」后，协议注册导入本地账号会立刻推送到上方配置的分组。

CLIProxyAPI（CPA）导入

—

配置 CLIProxyAPI 的 Management API 后，可在「账号」页把本地号池账号同步导入到 CPA auth 目录 （POST /v0/management/auth-files，写入 xai-email.json 等文件）。 需在 CPA config.yaml 开启 remote-management 并设置 management key。

管理 API 根地址（不要带 /v0/management）
对应 CPA remote-management.secret-key；请求头 Authorization: Bearer … / X-Management-Key
勾选后会同时启用 CLIProxyAPI 导入；协议注册入库本地后立刻推送到 CPA（需填好 URL / Management Key）。点「保存设置」后生效。
本地→CPA 同时上传几个账号；默认 4
写入 CPA auth JSON 的上游；Grok Build 请保持 cli-chat-proxy，勿改成 api.x.ai 以免 402

保存后到「账号」页：用「导入 CLIProxyAPI（选中/全部）」把库里的账号同步到 CPA。 「导出 CLIProxyAPI」可下载 cliproxyapi-auth-bundle 备份（也可手动拆文件放进 CPA auth 目录）。

—

每个卡片可单独「保存」或「重置默认」（仅影响该卡片）。底部可重新加载全部。