feat(代理): 多套餐余量预警与用户级 jikip 套餐配置

平台自费池由单个 planId/userId 改为 planId:userId 列表逐套餐探测,
套餐余量或账户余额低于阈值时推管理员预警;用户可在密钥设置里为自己
配置多个套餐,巡检跟随密钥检查按用户查余量并推站内通知,欠费状态在
客户端右上角常驻提示(V160 新建用户级套餐表)。

同时把测试里写死的真实代理 key 换成占位串,避免凭证随仓库扩散。
This commit is contained in:
2026-10-21 13:32:56 +08:00
parent 19a291ec39
commit f6aa04d0f2
31 changed files with 1544 additions and 52 deletions
@@ -0,0 +1,23 @@
/**
* 客户端右上角代理余量警告的判定口径(纯函数,便于单测)。
*
* 只对「用户自己填的 jikip 套餐」报警:平台套餐由管理员侧巡检负责,
* 普通用户看到平台余量只会困惑,而且每个客户端都去查平台套餐只会白打供应商接口。
*/
import type { UserApiSecretBalance } from '../api/types/modules/user-secret.ts'
/** 轮询间隔:余量变化不需要秒级感知,10 分钟一轮即可。 */
export const PROXY_BALANCE_POLL_MS = 10 * 60 * 1000
/** 设置面板保存/清除套餐后广播,右上角警告立即按新配置刷新,不用等下一轮轮询。 */
export const PROXY_PLAN_CHANGED_EVENT = 'proxy-plan-changed'
/** 低余量兜底文案:服务端 lowReason 为空时仍要让用户看懂该做什么。 */
export const PROXY_BALANCE_FALLBACK_REASON = '代理套餐余额不足,耗尽后相关任务将无法购买代理。'
/** 返回需要常驻展示的警告文案;空串表示不展示。 */
export function proxyBalanceWarningReason(balance: UserApiSecretBalance | null | undefined): string {
if (!balance || balance.available === false) return ''
if (balance.scope !== 'user' || balance.low !== true) return ''
return (balance.lowReason || '').trim() || PROXY_BALANCE_FALLBACK_REASON
}