feat(用户密钥): 龙抬头余额按人民币口径上界面——credits 查询+用户端/后管两个读取面

上游事实(官方文档+2026-11-05 从主机B 直打实测):`GET /v1/skills/balance` 顶层 balance 是美元串("$12.345678"),
站内 ⚡=人民币口径在 credits 块(⚡ = 美元 × credits.per_usd)。要跟网页/账单对上必须取 credits,Java 里
不得出现任何汇率字面量。四条硬规则落在 LongtaitouBalanceClient:① 只认 credits.balance/available/frozen,
且 credits.unit 必须为 CREDIT、per_usd>0;② 顶层 $… 与 currency:USD 只作交叉校验(偏差 >0.5% 打 WARN),永不进展示;
③ credits 缺失/不可解析时不回落美元——把 12.34 当 ¥12.34 显示就是"美元当人民币"的假绿;④ 错误体
{error:{code,message,type}} 与 4xx/5xx 一律 available=false + message 原样透出,绝不抛、也不显示成 ¥0。
URL 由 LlmChannel.LONGTAITOU.host() 派生(配置键留空即用域名唯一正本),响应体限读 1MB。

不复用 UserApiSecretBalanceVo:那个类的 surplus/scope/low 语义全是 jikip 代理的,LLM 塞进去会让注释撒谎并
诱导下一个人在 useProxyBalance 里加分支(铁律 25「口径不得借」)。新建 UserLlmBalanceVo + 平行新建
UserLlmBalanceService(不扩 UserProxyBalanceService),缓存键 (userId,moduleKey) 5 分钟;渠道分档:t8star 不打
上游、available=false +「不提供余额查询」(贞贞有没有余额接口在册无判据,不许猜端点、更不许借龙抬头的数)。

后管走实时查、不落库(本窗零 Schema、零迁移):POST /api/admin/user-secrets/balances,requireAdmin +
DataReadScope 逐个剔除越权 userId(不信任前端给的列表)。三条护栏是这条路线不被点爆的唯一防线:单次 ≤20 行
(越限 BusinessException,不静默截断)、固定线程池 adminBalanceConcurrency=4 + 整请求 deadline 10s(到点的行
按「上游未在本轮时间预算内应答」降级并记进 timedOutUserIds 如实上报,不读成 0)、只对真能查的行打上游
(LLM 仅 longtaitou、代理仅 detectFromUrl==JIKIP;t8star/青果零 HTTP),一页 15 行通常只剩 3–8 次调用。
用户端 GET /api/user-secrets/llm-balance?moduleKey= 与既有 proxy-balance 同款 requireUser。

保存/清空密钥与后台代填/清空时代际失效两侧余额缓存:换一把钥匙还挂着上一把的钱就是串档。
配置三键同步 application.yml 与 application-local.example.yml(铁律 3)。

测试:LongtaitouBalanceClientTest 11(官方样例断言 balance=="88.888882"/surplus=="85.288882" 且 12.34/11.84/0.50/$
一律不出现;缺 credits、per_usd<=0、unit≠CREDIT、缺 available 四种坏形状各自 available=false + balance=null;
现网实测 401 missing_api_key / invalid_api_key 形状入夹具——钉的是测过的读数不是猜的错误体)、
UserLlmBalanceServiceTest 10(贞贞 never() 打上游、三态不伪装成 0、缓存命中不二次查询、两模块各回各值)、
UserSecretBalanceAdminServiceTest 7(越上限拒、越权剔、超时行 available=false 而非 0、只有可查行产生 HTTP)。
三支已登记进 ops scripts/score_ratchet.py 的 suites(不入册=闸门永远跑不到)。
catch 棘轮五枚新增全是 NOT_RETHROW(LOG_ONLY/EMPTY 一格没涨),逐处记名抬 STRICT_TOTAL 1065→1069、
notRethrow 604→608。未证事项按 BACKLOG B83-01 如实挂:真 sk- 下 credits 字段逐字核对、后管实时查的现网
并发表现、jikip find-balance 对用户自有套餐 key;本窗代码未随任何 jar 发版。
This commit is contained in:
2026-11-05 12:02:33 +08:00
parent b231a67dd7
commit 609ad396a6
15 changed files with 1381 additions and 6 deletions
@@ -104,6 +104,14 @@ AIIMAGE_NOTIFICATION_JIKIP_LOW_SURPLUS_THRESHOLD=100
# 账户余额 ≤ 阈值 → 管理员通知;供应商口径,0=关闭
AIIMAGE_NOTIFICATION_JIKIP_LOW_BALANCE_THRESHOLD=0
# 龙抬头余额查询(人民币口径=credits 块,不是顶层那个 `$…` 美元串)。
# 留空=按 LlmChannel.LONGTAITOU 的主机派生 `/v1/skills/balance`——域名只允许有一个出处,别在这里抄第二份。
AIIMAGE_USER_SECRET_LONGTAITOU_BALANCE_URL=
# 后管「密钥管理」实时查上游的两条护栏(第三条是单次 ≤20 行,写在代码常量里)。
# 这两个不是性能旋钮:没有它们,一个后管页面就能把上游点爆;而调小了只会把行读成「上游未应答」,不会读成 0。
AIIMAGE_USER_SECRET_ADMIN_BALANCE_CONCURRENCY=4
AIIMAGE_USER_SECRET_ADMIN_BALANCE_DEADLINE_MILLIS=10000
# 以上 LLM 主机/模型是「贞贞」渠道的默认值(历史口径)。
# 2026-10-29 起用户密钥可按人选择渠道(龙抬头 / 贞贞,默认贞贞,可手动切龙抬头):
# - 渠道主机写死在 UserSecretModule/LlmChannel 里,不读本段;
@@ -600,6 +600,13 @@ aiimage:
proxy-balance-check-budget-minutes: ${AIIMAGE_USER_SECRET_PROXY_BALANCE_CHECK_BUDGET_MINUTES:10}
proxy-balance-low-surplus-threshold: ${AIIMAGE_USER_SECRET_PROXY_LOW_SURPLUS_THRESHOLD:100}
proxy-balance-low-balance-threshold: ${AIIMAGE_USER_SECRET_PROXY_LOW_BALANCE_THRESHOLD:0}
# 龙抬头余额查询地址:留空=按登记的渠道主机派生(LlmChannel.LONGTAITOU.host + /v1/skills/balance)。
# 刻意不在此抄一份域名:域名有两个出处就会漂(发布域名红线那次就是这么踩的)。
longtaitou-balance-url: ${AIIMAGE_USER_SECRET_LONGTAITOU_BALANCE_URL:}
# 后台密钥列表的余额侧写:实时打上游、不落库。这两个数是「别拿后管页去压上游」的护栏,
# 不是性能旋钮——并发再高只会让整页一起撞供应商限流。两侧各有 5 分钟内存缓存。
admin-balance-concurrency: ${AIIMAGE_USER_SECRET_ADMIN_BALANCE_CONCURRENCY:4}
admin-balance-deadline-millis: ${AIIMAGE_USER_SECRET_ADMIN_BALANCE_DEADLINE_MILLIS:10000}
# 巡检发现欠费/密钥失效时是否推送站内通知(铃铛)
notify-enabled: ${AIIMAGE_USER_SECRET_NOTIFY_ENABLED:true}
# 用量日统计保留期:取 400 天而非整年,避免跨年时把刚过期的上年数据删掉(含同比对比场景)