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
@@ -657,7 +657,7 @@ h3 {
border-color: #f0dfae;
color: #8f6d1e;
}
/* 「等一会再点」这一族(通道待释放/限流/超时/网络/上游):既不红(密钥没坏)
/* 「等一会再点」这一族(无可用通道/限流/超时/网络/上游):既不红(密钥没坏)
也不黄(不是欠费)更不是灰(不是查不出),独立一档青色——三种处置一眼分开。 */
.wh-pill.is-retry {
background: #e6f2f7;
@@ -74,7 +74,7 @@ const GENERIC_FAILED_BAND: StatusBand = { label: '失败', tone: 'is-blocked' }
const CHECK_CODE_BANDS: Record<string, StatusBand> = {
ok: PASSED_BAND,
/** 通道被自己的采集占着:等释放后重点一次,密钥没坏——这一档就是本次要修的错渲染。 */
channel_busy: { label: '待释放', tone: 'is-retry' },
channel_busy: { label: '无可用通道', tone: 'is-retry' },
rate_limited: { label: '限流重试', tone: 'is-retry' },
timeout: { label: '超时重试', tone: 'is-retry' },
/** 传输层失败:后端两个分支都给这个码(提取接口不可达=failed、探测异常=error),都可重试。 */
@@ -126,11 +126,11 @@ describe('密钥管理页:检测结果按 check_code 分档渲染', () => {
})
}
it('channel_busy 渲染成「待释放」+独立配色,不再掉进「无法判定」', async () => {
it('channel_busy 渲染成「无可用通道」+独立配色,不再掉进「无法判定」', async () => {
const wrapper = await mountWith(busyRow())
const proxyPills = pills(wrapper, '代理设置')
const statusPill = proxyPills[proxyPills.length - 1]
expect(statusPill.text).toBe('待释放')
expect(statusPill.text).toBe('无可用通道')
expect(statusPill.classes).toContain('is-retry')
expect(cellText(wrapper, '代理设置')).not.toContain('无法判定')
// 供应商那颗药丸还在原位:改的是状态档,不是把货源档挤掉
@@ -236,7 +236,7 @@ describe('密钥管理页:检测结果按 check_code 分档渲染', () => {
expect(llmPills[1].classes).toContain('is-allowed')
})
it('筛选项把 error 这一档的两个可能读法都点名(选了要能筛到待释放的行)', async () => {
it('筛选项把 error 这一档的两个可能读法都点名(选了要能筛到无可用通道的行)', async () => {
const wrapper = await mountWith(busyRow())
const options = wrapper.findAll('.secrets-filter-row select')[0].findAll('option').map((option) => option.text().trim())
expect(options).toContain('无法判定/可重试')
@@ -158,7 +158,7 @@ test('后端分出的每一档码都不许掉进「无法判定」(逐码扫
test('逐码档位表:档名与配色都登记在案(可重试那一族既不正红也不黄)', () => {
const table: Array<[string, string, string]> = [
['ok', '通过', 'is-allowed'],
['channel_busy', '待释放', 'is-retry'],
['channel_busy', '无可用通道', 'is-retry'],
['rate_limited', '限流重试', 'is-retry'],
['timeout', '超时重试', 'is-retry'],
['network_error', '网络重试', 'is-retry'],
@@ -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();
}
@@ -320,8 +320,11 @@ class UserApiSecretCheckServiceTest {
assertThat(outcome.status()).isEqualTo(UserApiSecretCheckService.STATUS_ERROR);
assertThat(outcome.message())
.isEqualTo(UserApiSecretCheckService.CHANNEL_BUSY_MESSAGE)
.contains("青果通道正被你自己的采集占着")
.contains("3 分钟");
.contains("没有可用的空闲通道")
.contains("IP 白名单")
// 2026-11-02 实测:零并发单发 overseas.proxy.qg.net 仍回 NO_AVAILABLE_CHANNEL,
// 所以文案不许把"被自己的采集占着"当唯一事实——那会把用户引去等一个不会来的释放。
.doesNotContain("青果通道正被你自己的采集占着");
}
/**
@@ -235,7 +235,7 @@
</div>
<div v-else-if="proxySupported && proxyProvider === 'qingguo'" class="proxy-plan-hint">
青果的套餐与通道用量以青果后台为准;这里的「检测」会真打一次提取并经隧道验连——
它会占掉你那一条通道的存活期(约 3 分钟),期间再点会得到「通道被占」,等释放后重点一次即可。
它会占掉你那一条通道的存活期(约 3 分钟),期间再点会得到「无可用通道」。若隔几分钟仍报同一句,多半不是被占,而是这把 key 的套餐到期/无余量,或后台把鉴权切成了 IP 白名单档——去青果控制台核对通道数与有效期。
</div>
<div class="secret-actions">