fix(文案): NO_AVAILABLE_CHANNEL 不再断言"是你自己的采集占着",三成因一次说全

现网实测把这句文案证伪了:零并发单发 overseas.proxy.qg.net/get(就这把平台 key)仍回
NO_AVAILABLE_CHANNEL,而两台机器本小时都没有一条青果提取记录(vc 槽空闲、maixiang 走的是
极客且本小时只确立 17 次租约)。所以"等约 3 分钟释放"是一个**猜出来的单一成因**,
它会把人引去反复点、等一个根本不会来的释放。

供应商这个码至少三种成因,文案一次给全并给出去哪查:同账号其他提取占着(约 3 分钟)、
这把 key 的套餐到期/无余量、后台把鉴权切成 IP 白名单档(我们只做账密档,切了就一直拿不到
通道——铁律 25 那条口径)。后管档位名同步从「待释放」改成「无可用通道」,用户端面板提示
补"隔几分钟仍报同一句就别再等,去青果控制台核对通道数与有效期"。

判据跟着反转:原来那条测试把"正被你自己的采集占着"当事实钉住,现在改成
doesNotContain 那句 + 必须含「没有可用的空闲通道」「IP 白名单」——谁改回单一成因即红。

顺带清掉 B73-14:UserSecretModule.defaultChannel() 的注释写"代理=青果(10-29 拍板)",
而代码取 ProxyProvider.DEFAULT=JIKIP(10-30 拍板改回极客)——注释与代码相反,下一个人照
注释判断"没写 channel 就是青果"会做错事;改成只跟着 DEFAULT 取值并写明来历。

后端整量 5187/0 失败/19 skipped;用户端 994+55、后管 1872+68、tsc 两面 rc=0、
ops 可读性棘轮 10 绿。
This commit is contained in:
2026-11-02 17:09:08 +08:00
parent e26a157037
commit 0114a5b7a7
8 changed files with 25 additions and 12 deletions
@@ -70,7 +70,9 @@ public class UserApiSecretCheckService {
public static final String INSUFFICIENT_BALANCE_MESSAGE = "代理服务商余额不足,请充值后重试";
/** 通道被自己占用的提示文案:说人话,并给出可执行的下一步(等存活周期释放)。 */
public static final String CHANNEL_BUSY_MESSAGE = "青果通道正被你自己的采集占着,等约 3 分钟释放后再点检测";
public static final String CHANNEL_BUSY_MESSAGE = "青果回「没有可用的空闲通道」:可能是同账号的其他提取正占着(约 3 分钟释放),"
+ "也可能是这把 key 的套餐到期/无余量,或后台把鉴权切成了 IP 白名单档(账密提取于是永远拿不到通道)。"
+ "请到青果控制台核对通道数、有效期与鉴权方式后再点检测。";
/** 提取成功但服务端无法验连的提示文案:如实说"没验成",不拿它冒充 passed。 */
public static final String TUNNEL_UNVERIFIED_MESSAGE = "青果提取成功,但这条链接里没有可用于隧道验连的 key/pwd,"
@@ -328,7 +330,10 @@ public class UserApiSecretCheckService {
* <li>青果:code 为字符串,逐码分档,**一档一个 code**——
* BALANCE_INSUFFICIENT=余额不足;INVALID_KEY/UNAVAILABLE_KEY/KEY_BLOCK=密钥本身不可用;
* API_AUTH_DENY/ACCESS_DENY=这一条链接的鉴权没过(多数是 pwd 没填);
* NO_AVAILABLE_CHANNEL=通道被自己的采集占着({@link #CODE_CHANNEL_BUSY},稍后再点);
* NO_AVAILABLE_CHANNEL=供应商侧此刻没有空闲通道({@link #CODE_CHANNEL_BUSY})——
* **成因不止一种**:同账号其他提取占着(约 3 分钟释放)、套餐到期/无余量、
* 或后台把该 key 的鉴权切成 IP 白名单档。2026-11-02 实测:零并发单发仍回此码,
* 所以文案不许断言"是你自己的采集占着"(那是猜的,会把人引去等一个不会来的释放);
* REQUEST_LIMIT_EXCEEDED=限流;INVALID_PARAMETER=参数错;其余业务失败按上游异常。</li>
* <li>极客:沿用历史口径(code=-1 或 message 含「余额不足」=余额不足)。</li>
* </ul>
@@ -47,7 +47,12 @@ public enum UserSecretModule {
return this == PROXY;
}
/** 新建配置的默认货源:LLM 模块=龙抬头,代理=青果(2026-10-29 用户拍板)。 */
/**
* 新建配置的默认货源:LLM 模块=龙抬头,代理=**极客**(`ProxyProvider.DEFAULT`,
* 2026-10-30 用户拍板把 10-29 那句"默认青果"改回极客,青果手动切)。
* 这里刻意只跟着 {@link ProxyProvider#DEFAULT} 取值、不写死供应商名:上一版注释就是
* 因为写死了"青果"而与代码相反,下一个人照它判断"这行没写 channel 就是青果"会做错事。
*/
public String defaultChannel() {
return isProxy() ? ProxyProvider.DEFAULT.key() : LlmChannel.DEFAULT.key();
}