feat(用户端): 密钥设置面板 LLM 两卡加人民币余额行,与代理余量同形

现状纠偏(写死免得下次重研):桌面壳加载的是 frontend-vue 的 Vue SPA(app_client/blueprints/main.py:52 供产物、
config.py:96 WEB_HOME_URL 直载),所谓"客户端密钥设置"不在 Python 里;而密钥明文只在后端(前端手里只有掩码),
所以余额必须由后端查、前端不自打上游——本面只消费 GET /api/user-secrets/llm-balance。

- 新建 SecretBalanceRow.vue:根元素就是 <div class="secret-meta">,保住既有挂载测试按 .secret-meta 取数的断言不破;
  LLM 卡插一行、代理卡那 8 行 div 换成同一组件 ⇒ 两卡同形自动达成。面板 763→789 行,在 800 报警线内,
  可读棘轮基线不用动(该文件本就未点名)。
- 新建 shared/utils/llm-balance-text.ts(零依赖纯函数,node --test 直测)+ shared/composables/useLlmBalance.ts
  (按 moduleKey 存 items、三态文案、available=false 原样透出后端 message)。不引任何汇率乘算:绊线
  tests/llm-balance-text.test.ts 里钉住源码不得出现 7.2/per_usd 类字样——换算只在上游 credits.per_usd 里。
- loadLlmBalance() 移出 if (props.showProxy):原形状下 LLM 卡永远空白。刷新时机=挂载、保存该模块后、清空后、
  「检测已存值」后;⚠ 刻意不在「检测输入框未保存值」后刷——checkMyApiSecret(moduleKey,value) 探的是没落库的那把
  key,而余额读服务端已存密钥,刷出来是上一把 key 的钱挂在新渠道名下=串档形状(同一格绊线盯着这条)。
- 不动 ProxyBalanceAlert.vue / utils/proxy-balance-alert.ts:没要求告警,引阈值就是自造口径。
- 复用 jikip 那套 VO 的 surplus/scope/low 语义不 borrow 给 LLM(铁律 25):types/modules/user-secret.ts 里
  新类型与 :48-59 的 jikip VO 并置但互不相通。

测试:tests/llm-balance-text.test.ts 10 例(含源码绊线:面板行数<800、useLlmBalance 无汇率乘算、检测输入值路径
不触发 loadLlmBalance)+ tests/mount/密钥面板余额显示.mount.test.ts 11 例(两 LLM 卡各有 .secret-meta;龙抬头行
含 ¥+「龙抬头」、贞贞行含「不提供余额查询」且不含 ¥;两卡夹具给不同数字并交叉断言不互串;代理余量文案未变);
endpoints.test.ts 金样加一行;两支既有挂载夹具补 fetchLlmBalanceSafely 默认值。
catch-silence 棘轮:useLlmBalance.ts 那一枚 catch 的**首条语句是界面可见出口**(清空该 moduleKey 的展示),
console.warn 留在其后——按"首条即 log 才算静默"的口径它不该入账,实测入账了就把 blocks 311→312 如实登记并写明
理由,不删那个 catch(删了就是把失败读成"没有这一项")。vue-tsc rc=0、node --test 1018 例、vitest 66 例。
This commit is contained in:
2026-11-05 12:03:14 +08:00
parent eeff73d322
commit a10aa6bda3
13 changed files with 736 additions and 9 deletions
+1
View File
@@ -211,6 +211,7 @@ export const API_ENDPOINTS = {
check: '/api/user-secrets/{moduleKey}/check',
migrate: '/api/user-secrets/migrate',
proxyBalance: '/api/user-secrets/proxy-balance',
llmBalance: '/api/user-secrets/llm-balance',
proxyPlan: '/api/user-secrets/proxy-plan',
proxyWhitelist: '/api/user-secrets/proxy-whitelist',
clientIp: '/api/user-secrets/client-ip',
@@ -58,6 +58,30 @@ export interface UserApiSecretBalance {
lowReason?: string | null
}
/**
* LLM 渠道余额(人民币口径)。
*
* 与 `UserApiSecretBalance` 分开的理由在后端 `UserLlmBalanceVo` 上写着:那一个的
* surplus/scope/low 全是 jikip 套餐语义。这里同样不复用——一个字段名在两处表示两种东西,
* 下一个读代码的人一定会照错的用(铁律 25「口径不得借」)。
*/
export interface UserLlmBalance {
moduleKey: string
moduleLabel: string
/** longtaitou / t8star */
channel: string
channelLabel: string
available: boolean
/** 总余额,人民币(⚡)口径的上游原样小数串;available=false 时为 null。 */
balance: string | null
availableBalance: string | null
frozen: string | null
/** 恒为 CREDIT(站内 ⚡=人民币)。 */
unit: string | null
message: string | null
checkedAt: string | null
}
export interface UserProxyPlan {
planId: string | null
jikipUserId: string | null
@@ -130,6 +154,21 @@ export function fetchProxyBalance() {
)
}
/**
* LLM 渠道余额(人民币口径)。`moduleKey` 留空=一次回齐两张密钥卡。
*
* 服务端最坏一次上游读 8 秒(`LongtaitouBalanceClient` 的读超时)+ 本地取密钥,
* 界面上限给到 20 秒:比它短会把「查得慢」报成「查不到」,比它长则用户盯着转圈没反馈。
*/
export function fetchLlmBalance(moduleKey?: string) {
return unwrapJavaResponse(
get<JavaApiResponse<UserLlmBalance[]>>(
buildJavaUrl(API_ENDPOINTS.userSecret.llmBalance, moduleKey ? { moduleKey } : undefined),
{ timeout: 20000 },
),
)
}
/** 读取当前用户填写的 jikip 套餐 ID / 用户 ID(只用于余量查询)。 */
export function fetchProxyPlan() {
return unwrapJavaResponse(
@@ -78,6 +78,13 @@
{{ statusTextOf(module.moduleKey) }}
</span>
</div>
<SecretBalanceRow
:text="llmMetaText(module.moduleKey)"
:updated-at="llmBalanceUpdatedAtOf(module.moduleKey)"
:refreshing="llmBalanceLoading"
@refresh="() => loadLlmBalance(module.moduleKey)"
/>
</section>
<section v-if="showProxy" class="secret-card">
@@ -252,14 +259,7 @@
</span>
</div>
<div class="secret-meta">
<span v-if="proxyLoading">正在读取代理配置...</span>
<span v-else-if="proxyLoadFailed">代理配置读取失败,请关闭弹窗后重试</span>
<span v-else-if="!proxySupported">代理设置仅在桌面客户端中可用</span>
<span v-else-if="balanceLoading">正在查询代理余量...</span>
<span v-else-if="balance">{{ balanceText }}</span>
<span v-else>{{ balanceUnavailableText }}</span>
</div>
<SecretBalanceRow :text="proxyMetaText" :refreshing="balanceLoading" @refresh="loadBalance" />
</section>
</div>
</template>
@@ -308,7 +308,9 @@ import {
} from '@/shared/utils/api-secret-proxy-config'
import { useProxyBalance, useProxyPlan } from '@/shared/composables/useProxyPlan'
import { useKeyedSecretVisibility, useSecretVisibility } from '@/shared/composables/useSecretVisibility'
import { useLlmBalance } from '@/shared/composables/useLlmBalance'
import SecretVisibilityToggle from '@/shared/components/SecretVisibilityToggle.vue'
import SecretBalanceRow from '@/shared/components/SecretBalanceRow.vue'
import { createModuleView, proxyCheckPresentation, type ModuleState } from '@/shared/utils/api-secret-module-view'
const props = withDefaults(
@@ -383,6 +385,23 @@ const proxyCheckResult = ref<UserApiSecretCheckResult | null>(null)
const proxyCheckError = ref('')
const { balance, balanceLoading, balanceText, balanceUnavailableText, loadBalance } = useProxyBalance({ proxyProvider })
const { llmBalanceLoading, llmBalanceTextOf, llmBalanceUpdatedAtOf, loadLlmBalance } = useLlmBalance()
/** LLM 卡余额行:渠道名以服务端回传为准(库里那把 key 才是余额接口读的,本地未保存的单选不参与取数)。 */
function llmMetaText(moduleKey: string): string {
if (llmBalanceLoading.value) return '正在查询密钥余额...'
return llmBalanceTextOf(moduleKey, llmChannelLabel(moduleChannels[moduleKey]))
}
/** 代理卡那一行的既有优先级原样搬过来(读取中 → 失败 → 不支持 → 查询中 → 数值 → 查不到)。 */
const proxyMetaText = computed(() => {
if (proxyLoading.value) return '正在读取代理配置...'
if (proxyLoadFailed.value) return '代理配置读取失败,请关闭弹窗后重试'
if (!proxySupported.value) return '代理设置仅在桌面客户端中可用'
if (balanceLoading.value) return '正在查询代理余量...'
return balance.value ? balanceText.value : balanceUnavailableText.value
})
const {
proxyPlanId,
proxyPlanUserId,
@@ -557,6 +576,8 @@ async function runCheck(moduleKey: ApiSecretModuleKey) {
} finally {
state.checking = false
refreshSnapshots()
// 只有「检测已存密钥」才顺带刷余额:检测输入值时库里还是上一把 key,刷出来是上一把的钱(串档形状)
if (!inputValue) void loadLlmBalance(moduleKey)
}
}
@@ -571,6 +592,8 @@ async function clearModule(moduleKey: ApiSecretModuleKey) {
state.error = ''
channelDirty[moduleKey] = false
refreshSnapshots()
// 清空后库里已经没有这把 key:不刷的话,这一行会继续挂着上一把 key 的钱
void loadLlmBalance(moduleKey)
ElMessage.success('已清空密钥')
} catch (error) {
ElMessage.error(error instanceof Error ? error.message : '清空失败')
@@ -679,6 +702,7 @@ async function saveAll(options: { requireAll?: boolean } = {}): Promise<boolean>
}
secretsSaved = true
refreshSnapshots()
void loadLlmBalance()
if (props.showProxy && proxyReady.value && proxyDirty.value && !proxyLocked.value) {
const api = getPywebviewApi()
@@ -741,6 +765,8 @@ onMounted(() => {
// 先拉服务端密钥包(后台锁定的代理会先对齐到本地配置),再读本地代理,避免展示对齐前的旧值
void (async () => {
await reload()
// 读的是服务端已存密钥 ⇒ 排在 reload 之后;且它不属代理卡(浏览器形态 showProxy=false 会永远空白)
void loadLlmBalance()
if (props.showProxy) {
await loadProxyConfig()
if (proxySupported.value) {
@@ -0,0 +1,65 @@
<template>
<div class="secret-meta">
<span>{{ text }}</span>
<span v-if="updatedAt" class="meta-updated">更新于 {{ updatedAt }}</span>
<button
v-if="refreshable"
type="button"
class="meta-refresh"
:disabled="refreshing"
@click="emit('refresh')"
>
{{ refreshing ? '查询中...' : '刷新余额' }}
</button>
</div>
</template>
<script setup lang="ts">
/**
* 密钥卡上的「余额/余量」那一行(LLM 两卡与代理卡共用同一个形状)。
*
* 根元素刻意就是 `<div class="secret-meta">`:面板的样式与既有挂载用例都按这个类取数
* (`tests/mount/密钥面板青果检测.mount.test.ts` 的 `proxyCard(panel).find('.secret-meta')`),
* 抽组件不许把这条既有判据挪走。父作用域的 `.secret-meta` 规则会照常落到本组件根元素上
* (Vue 给子组件根节点同时挂父子两个 scope 属性),所以这里不重复定义行色。
*
* 文案由调用方算好整条传进来(含「正在读取…」那几档),本组件只管显示与「刷新」这个动作——
* 三态优先级留在面板里,一处一份,不在组件里再造第二套判定。
*/
withDefaults(defineProps<{
/** 整行文案(loading / 数值 / 查不到,都由调用方按既有优先级算好)。 */
text: string
/** 取数时刻(`HH:mm`);为空就不显示——没有数的时候不该假装知道它是几点取的。 */
updatedAt?: string
refreshing?: boolean
refreshable?: boolean
}>(), {
updatedAt: '',
refreshing: false,
refreshable: true,
})
const emit = defineEmits<{ refresh: [] }>()
</script>
<style scoped>
.meta-updated {
margin-left: 6px;
}
.meta-refresh {
margin-left: 8px;
border: 1px solid #cdd4dd;
background: transparent;
color: inherit;
border-radius: 4px;
padding: 0 8px;
font-size: 12px;
cursor: pointer;
}
.meta-refresh:disabled {
cursor: default;
opacity: 0.6;
}
</style>
@@ -0,0 +1,70 @@
import { ref } from 'vue'
import { fetchLlmBalanceSafely } from '@/shared/utils/api-secret-store'
import {
llmBalanceText,
llmBalanceUnavailableText,
llmBalanceUpdatedAt,
} from '@/shared/utils/llm-balance-text'
import type { UserLlmBalance } from '@/shared/api/types/modules/user-secret'
/**
* LLM 渠道余额(人民币口径):两张密钥卡各一格,形状与代理余量同一套三态。
*
* 三条口径写在这里,因为它们是「看着像成功、其实是错的」的成因:
* 1. **只在读服务端已存密钥的时刻刷**。输入框里那把还没保存的 key 不是余额接口读的那把
* (`checkApiSecret(value)` 探的是输入值,余额读的是库里那把)——在「检测输入值」后刷,
* 得到的是**上一把 key 的钱挂在新渠道名下**,与切渠道后不刷相比更容易被骗。
* 2. **失败即清空数字**,只留原因。留着上一次的读数就是上一条那个串档形状。
* 3. 不做任何汇率换算:`credits` 块本身就是人民币(⚡),乘一次系数等于自造一套口径
* (铁律 25)。
*/
export function useLlmBalance() {
const llmBalanceItems = ref<Record<string, UserLlmBalance>>({})
const llmBalanceLoading = ref(false)
function llmBalanceTextOf(moduleKey: string, channelLabel = ''): string {
const item = llmBalanceItems.value[moduleKey]
return item?.available
? llmBalanceText(item)
: llmBalanceUnavailableText(item, channelLabel)
}
function llmBalanceUpdatedAtOf(moduleKey: string): string {
return llmBalanceUpdatedAt(llmBalanceItems.value[moduleKey])
}
/** `moduleKey` 留空=一次刷两张卡(面板打开时用);带 key=只刷那一格(保存/切渠道后用)。 */
async function loadLlmBalance(moduleKey?: string): Promise<void> {
llmBalanceLoading.value = true
try {
const list = await fetchLlmBalanceSafely(moduleKey)
const next = { ...llmBalanceItems.value }
for (const item of list || []) {
if (item && item.moduleKey) next[item.moduleKey] = item
}
llmBalanceItems.value = next
} catch (error) {
// 失败的第一出口是界面那一行(清空数字 ⇒ 渲染成「这次没查到」,与代理余量同一口径);
// 余额是打开面板时的附带读取,弹全局打扰会把用户下一次正常操作也打断,所以不 ElMessage。
// 顺序有意义:先给用户看得见的交代,控制台只作留链(catch-silence 棘轮按首条语句判静默)。
if (moduleKey) {
const next = { ...llmBalanceItems.value }
delete next[moduleKey]
llmBalanceItems.value = next
} else {
llmBalanceItems.value = {}
}
console.warn('[api-secret] LLM 余额查询失败:', error)
} finally {
llmBalanceLoading.value = false
}
}
return {
llmBalanceItems,
llmBalanceLoading,
llmBalanceTextOf,
llmBalanceUpdatedAtOf,
loadLlmBalance,
}
}
@@ -13,6 +13,7 @@ import {
checkMyApiSecret,
deleteMyApiSecret,
fetchMyApiSecrets,
fetchLlmBalance,
fetchProxyBalance,
migrateMyApiSecrets,
putMyApiSecret,
@@ -21,6 +22,7 @@ import {
type UserApiSecretBundle,
type UserApiSecretCheckResult,
type UserApiSecretItem,
type UserLlmBalance,
} from '../api/types/modules/user-secret.ts'
import {
applyInheritedSecrets,
@@ -979,6 +981,15 @@ export async function fetchProxyBalanceSafely() {
return fetchProxyBalance()
}
/**
* LLM 渠道余额(人民币口径)。`moduleKey` 留空=一次回齐两张密钥卡。
* 与 `fetchProxyBalanceSafely` 同层:只做薄封装、不吞异常——吞掉异常就把「查不到」
* 混成「余额为零」了,判红分支由调用方(useLlmBalance)如实分流。
*/
export async function fetchLlmBalanceSafely(moduleKey?: string): Promise<UserLlmBalance[]> {
return fetchLlmBalance(moduleKey)
}
/** 登出清理:内存与镜像一并清空(旧 v1 记录保留,供下次登录迁移)。 */
export function clearApiSecretCache(): void {
for (const moduleKey of [...DEFAULT_REQUIRED_MODULES]) {
@@ -0,0 +1,70 @@
/**
* LLM 余额的显示口径(纯函数,零 vue、零 `@/` 别名)。
*
* 单独成文件与本仓 `proxy-balance-alert.ts` / `user-secret-model.ts` 同一理由:
* 判据要能被 `node --test` 直接钉住。放进 composable 里就得拖起 vue 运行时,
* 或者干脆没人钉——而「把美元读成人民币」「把查不到显示成 ¥0」正是没人钉就会复发的形状。
*/
import type { UserLlmBalance } from '../api/types/modules/user-secret.ts'
/** 站内 ⚡=人民币口径;单位由服务端 `credits.unit` 判定,这里只负责加符号。 */
const YUAN = '¥'
function isFiniteNumber(value: number): boolean {
return Number.isFinite(value)
}
/**
* 人民币金额显示:保留两位小数。
*
* 上游给的是原样小数串(`88.888882`)——**四舍五入只发生在这里**,落库/传值都不提前取整,
* 否则账单对不上时没人能回溯当时到底是多少。解析不出数字时原样回显,不返回 `'¥0.00'`:
* 一格 0 会被读成「没钱了」,而真值可能只是上游换了写法。
*/
export function formatYuan(raw: string | null | undefined): string {
const text = (raw ?? '').trim()
if (!text) return ''
const value = Number(text.replace(/,/g, ''))
if (!isFiniteNumber(value)) return text
return `${YUAN}${value.toFixed(2)}`
}
/** 有数时的整行文案;可用/冻结按字段在不在追加(缺字段不补 0)。 */
export function llmBalanceText(item: UserLlmBalance | null | undefined): string {
if (!item || !item.available) return ''
const label = item.channelLabel || '该渠道'
const parts = [`总 ${formatYuan(item.balance) || '—'}`]
if (item.availableBalance) parts.push(`可用 ${formatYuan(item.availableBalance)}`)
if (item.frozen) parts.push(`冻结 ${formatYuan(item.frozen)}`)
return `${label}余额(人民币):${parts.join(' · ')}`
}
/**
* 没数时的诚实文案。
*
* 后端已经把原因说清了(渠道不支持/没配密钥/上游拒绝/超时),这里只补前缀、不改写;
* 已经以渠道名开头的话就不再叠一遍(免得读出「贞贞余额:贞贞渠道不提供余额查询」)。
* 兜底那句刻意说明「不是欠费、也不是不支持」——这一格空白最容易被读成没钱。
*
* `fallbackLabel` 只在整条 item 都没有时兜底(请求整个失败时,界面至少要说清这一行是谁的钱;
* 此时**不许**留着上一把 key 的数字,那是串档形状)。
*/
export function llmBalanceUnavailableText(
item: UserLlmBalance | null | undefined,
fallbackLabel = '',
): string {
const label = (item?.channelLabel || fallbackLabel || '该渠道').trim()
const reason = (item?.message ?? '').trim()
if (reason) return reason.startsWith(label) ? reason : `${label}余额:${reason}`
return `${label}余额这次没查到:接口没返回可用值(不是欠费,也不是不支持),可稍后重开设置页再看`
}
/** `checkedAt` 是 ISO 串:只取到分钟,给「这一格数是什么时候的」一个可核对的落点。 */
export function llmBalanceUpdatedAt(item: UserLlmBalance | null | undefined): string {
const raw = (item?.checkedAt ?? '').trim()
if (!raw) return ''
const parsed = new Date(raw)
if (Number.isNaN(parsed.getTime())) return ''
const pad = (value: number) => String(value).padStart(2, '0')
return `${pad(parsed.getHours())}:${pad(parsed.getMinutes())}`
}