From cc22600a073ccf4a0f66ca5958e1c69dabf0dbd5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Thu, 5 Nov 2026 12:03:43 +0800
Subject: [PATCH] =?UTF-8?q?feat(=E5=90=8E=E7=AE=A1):=20=E5=AF=86=E9=92=A5?=
=?UTF-8?q?=E7=AE=A1=E7=90=86=E6=8B=86=E4=B8=A4=E5=88=97=E6=98=BE=E7=A4=BA?=
=?UTF-8?q?=E4=BD=99=E9=A2=9D=EF=BC=88LLM=20=E4=BA=BA=E6=B0=91=E5=B8=81?=
=?UTF-8?q?=E4=BD=99=E9=A2=9D=EF=BC=8F=E4=BB=A3=E7=90=86=E4=BD=99=E9=87=8F?=
=?UTF-8?q?=EF=BC=89=EF=BC=8C=E5=AE=9E=E6=97=B6=E6=9F=A5=E4=B8=8D=E8=90=BD?=
=?UTF-8?q?=E5=BA=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
按拍板:数据源=实时查上游不落库(⇒ 本窗零 Flyway、零 Schema);列形态=拆两列,不是一列两行——
两张货源字典本就互不相通(LLM 行为渠道 longtaitou/t8star,代理行为供应商 qingguo/jikip),合成一格
就是 11-02 那次"代理行贴出龙抬头"的串档形状重来一遍(铁律 25)。不加 v-if="isSuperAdmin":主管必须
能解释组员任务为什么挂欠费,鉴权维持 requireAdmin + DataReadScope。
- src/api/user-secrets.ts:fetchAdminSecretBalances(userIds, companyId?),POST /api/admin/user-secrets/balances,
超时放宽到 30s(服务端整请求预算 10s,客户端必须比它长,否则拿到的是本地掐断而不是"上游未应答")。
- user-secret-model.ts:llmBalanceLines/proxyBalanceLine 纯函数——**两张字典各查各的**、跨域一律 —、
未知渠道只出 — 不出钱;available=false 时把 message 挂进 title 而不是画成 0;同一账号两个模块归到
同一个渠道名下只列一次钱。保持零 @/ 别名以便 node --test 直测。
- UserSecretsPage.vue:两个
(LLM 余额 170px/代理余量 160px,放「更新时间」前),两个 | 首屏画 —/查询中,
列表返回后异步填(不阻塞首屏);colspan 由 isSuperAdmin ? 10 : 9 改成 12 : 11(两处同改,892d88ed 的提交信息
专门写过这句);表格 min-width 相应 +240px;「刷新余额」按钮按 BALANCE_BATCH=20 分批请求。
- 已核对 ops-cell-must-wrap.test.ts:它的 opsColDecl() 正则锚在表头文字「操作」上,新增 | 排在它之前不影响
UserSecretsPage: 314 下限 ⇒ 那张表不改(实测绿)。
- mock-admin-server.mjs 补两列夹具(一条有数、一条全查不到)供 dev/e2e。
测试:tests/密钥余额列读数.test.ts 12 例(跨域不认、坏值不画 0)+
tests/mount/user-secret-balance-columns.mount.test.ts 9 例——按表头文字定位不靠列序数,并钉 | 数= | 数=
空行 colspan(超管与非超管两种形状各一遍),把"加列忘改 colspan"直接钉死。既有 status-band 挂载格的夹具 mock
补一个 fetchAdminSecretBalances 函数名(页面挂载即取余额,缺它整个模块 mock 会炸),不是判据改动。
刻意不新增 readSource 钉 ⇒ 不动 tests/baselines/source-pin-ledger.json。vue-tsc rc=0、node --test 1890 例、vitest 77 例。
---
.../scripts/mock-admin-server.mjs | 26 +++
admin-frontend-vue/src/api/user-secrets.ts | 64 ++++++
.../src/pages/account/UserSecretsPage.vue | 106 ++++++++-
.../src/pages/account/user-secret-model.ts | 151 ++++++++++++-
.../user-secret-balance-columns.mount.test.ts | 210 ++++++++++++++++++
.../user-secret-status-band.mount.test.ts | 1 +
.../tests/密钥余额列读数.test.ts | 140 ++++++++++++
7 files changed, 695 insertions(+), 3 deletions(-)
create mode 100644 admin-frontend-vue/tests/mount/user-secret-balance-columns.mount.test.ts
create mode 100644 admin-frontend-vue/tests/密钥余额列读数.test.ts
diff --git a/admin-frontend-vue/scripts/mock-admin-server.mjs b/admin-frontend-vue/scripts/mock-admin-server.mjs
index 61dd20f95..06b5d008f 100644
--- a/admin-frontend-vue/scripts/mock-admin-server.mjs
+++ b/admin-frontend-vue/scripts/mock-admin-server.mjs
@@ -499,6 +499,32 @@ const server = createServer((req, res) => {
},
})
}
+ if (url === '/api/admin/user-secrets/balances') {
+ // 余额侧写夹具(POST):两把密钥同渠道 ⇒ 界面折叠成一行;代理给「你的套餐」形状
+ const llmCell = (moduleKey, moduleLabel, over = {}) => ({
+ moduleKey, moduleLabel,
+ channel: 'longtaitou', channelLabel: '龙抬头',
+ available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
+ unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00', ...over,
+ })
+ return json(res, {
+ success: true,
+ data: {
+ items: [
+ {
+ userId: 1,
+ llm: [
+ llmCell('appearance-patent', '外观专利密钥'),
+ llmCell('similar-asin', '货源查询密钥'),
+ ],
+ proxy: { available: true, surplus: '1234', balance: '56', scope: 'user', message: null },
+ },
+ ],
+ deniedUserIds: [],
+ timedOutUserIds: [],
+ },
+ })
+ }
if (url === '/api/admin/shop-manage-groups') {
return json(res, { success: true, data: { items: [] } })
}
diff --git a/admin-frontend-vue/src/api/user-secrets.ts b/admin-frontend-vue/src/api/user-secrets.ts
index 290667087..fc2740efa 100644
--- a/admin-frontend-vue/src/api/user-secrets.ts
+++ b/admin-frontend-vue/src/api/user-secrets.ts
@@ -63,6 +63,53 @@ export interface GroupOption {
groupName: string
}
+/**
+ * LLM 一格的余额(**人民币口径**,后端取龙抬头 `credits` 块)。
+ * 与 `AdminProxyBalanceCell` 是两套语义:这里的 `balance` 是钱、单位 CREDIT(=⚡=人民币),
+ * 代理那边的 `surplus` 是「次」。界面不得用一张函数渲染两域(同 `channel` 那张表的教训)。
+ */
+export interface AdminLlmBalanceCell {
+ moduleKey: string
+ moduleLabel: string
+ 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
+}
+
+/** 代理余量一格:jikip 套餐口径(`surplus`=IP 次数、`scope`=谁的池子)。青果为 scope=none。 */
+export interface AdminProxyBalanceCell {
+ available: boolean
+ surplus: string | null
+ balance: string | null
+ /** user=该用户自己的套餐;platform=平台池子(不是这个用户的钱);none=查不了。 */
+ scope: string | null
+ message: string | null
+ low?: boolean
+ lowReason?: string | null
+}
+
+export interface AdminUserSecretBalanceItem {
+ userId: number
+ llm: AdminLlmBalanceCell[]
+ proxy: AdminProxyBalanceCell
+}
+
+export interface AdminUserSecretBalances {
+ items: AdminUserSecretBalanceItem[]
+ /** 被数据权限剔出、本次没查的用户(不静默少给数)。 */
+ deniedUserIds?: number[]
+ /** 超出整请求时间预算、这轮没取到数的用户。 */
+ timedOutUserIds?: number[]
+}
+
export interface UserSecretQuery {
keyword?: string
checkStatus?: string
@@ -87,6 +134,23 @@ export async function fetchUserSecretList(params: UserSecretQuery): Promise(data)
}
+/**
+ * 刷新本页用户的余额侧写:POST /api/admin/user-secrets/balances。
+ *
+ * 实时打上游、不落库,所以服务端带三条护栏(单次 ≤20 个用户、固定并发、整请求 10s 预算),
+ * 客户端的超时必须**长于**服务端预算,否则服务端还在取数、这边先报错,
+ * 界面就会把「查得慢」显示成「查不到」(与铁律 10「前端超时不得短于服务端预算」同形)。
+ */
+export async function fetchAdminSecretBalances(
+ userIds: number[],
+ companyId?: number | null,
+): Promise {
+ const body: Record = { userIds }
+ if (companyId != null) body.company_id = companyId
+ const { data } = await http.post('/api/admin/user-secrets/balances', body, { timeout: 30_000 })
+ return unwrap(data)
+}
+
/** 立即检测该用户全部已配置项:POST /api/admin/user-secrets/{userId}/check
* 逐模块检测(每项最多「首查 + 传输层失败重试一次」,最坏约 31s/项),故放宽超时到 180s。 */
export async function checkUserSecret(userId: number) {
diff --git a/admin-frontend-vue/src/pages/account/UserSecretsPage.vue b/admin-frontend-vue/src/pages/account/UserSecretsPage.vue
index 5ea280e7f..936f725f5 100644
--- a/admin-frontend-vue/src/pages/account/UserSecretsPage.vue
+++ b/admin-frontend-vue/src/pages/account/UserSecretsPage.vue
@@ -8,15 +8,19 @@ import {
checkUserSecret,
clearUserSecretModule,
deleteUserSecret,
+ fetchAdminSecretBalances,
fetchUserSecretList,
+ type AdminUserSecretBalanceItem,
type AdminUserSecretModule,
type AdminUserSecretRow,
type GroupOption,
} from '@/api/user-secrets'
import {
PROXY_MODULE_KEY,
+ llmBalanceLines,
llmSourceLabel,
moduleStatusBand,
+ proxyBalanceLine,
proxyDisplayText,
proxySourceLabel,
rowDetailLines,
@@ -51,6 +55,14 @@ const proxyBusyId = ref(null)
/** 代填/改代理弹窗的目标行(脱敏后没有原文可预填,只能重填账密)。 */
const proxyDialog = ref<{ userId: number; username: string; provider: string | null; locked: boolean } | null>(null)
+/** 余额侧写(实时查上游、不落库):按 userId 存,列表接口本身不带这些数。 */
+const balances = ref>({})
+const balanceLoading = ref(false)
+/** 本轮「没取到」的原因(越权剔除/上游未应答/请求失败):进工具行悬停,不弹全局打扰。 */
+const balanceNotice = ref('')
+/** 服务端单次上限 20 个用户;超出会被当场拒,所以这里按批顺取(并发留给服务端那个线程池)。 */
+const BALANCE_BATCH = 20
+
const totalPages = computed(() => Math.max(1, Math.ceil(total.value / pageSize.value)))
const STATUS_OPTIONS = [
@@ -131,6 +143,7 @@ async function load() {
rows.value = result?.items || []
total.value = Number(result?.total || 0)
groupOptions.value = result?.groupOptions || []
+ void loadBalances()
} catch (error) {
loadFailure.value = error instanceof Error ? error.message : '加载失败'
showAdminFeedback(loadFailure.value, 'error')
@@ -139,6 +152,57 @@ async function load() {
}
}
+/**
+ * 取本页用户的余额:列表已经画完,这两列随后填(余额要实时打上游,不能让它在列表主数据前占位)。
+ *
+ * 失败只影响这两列并留一句说明——不 `showAdminFeedback`、不把整页判成加载失败:
+ * 一次上游抖动就红整页,管理员会以为密钥数据本身出了问题。
+ */
+async function loadBalances() {
+ const ids = rows.value.map((row) => row.userId)
+ balances.value = {}
+ balanceNotice.value = ''
+ if (!ids.length) return
+ balanceLoading.value = true
+ try {
+ const merged: Record = {}
+ let denied = 0
+ let timedOut = 0
+ for (let start = 0; start < ids.length; start += BALANCE_BATCH) {
+ const batch = ids.slice(start, start + BALANCE_BATCH)
+ const result = await fetchAdminSecretBalances(batch, companyTab.requestCompanyId)
+ for (const item of result?.items || []) {
+ if (item && item.userId != null) merged[Number(item.userId)] = item
+ }
+ denied += result?.deniedUserIds?.length || 0
+ timedOut += result?.timedOutUserIds?.length || 0
+ }
+ balances.value = merged
+ const notices: string[] = []
+ if (denied) notices.push(`${denied} 个用户不在当前数据权限内,本轮未查`)
+ if (timedOut) notices.push(`${timedOut} 个用户本轮上游未应答(不是余额为 0)`)
+ balanceNotice.value = notices.join(';')
+ } catch (error) {
+ balanceNotice.value = error instanceof Error ? error.message : '余额本轮没取到(不是余额为 0)'
+ } finally {
+ balanceLoading.value = false
+ }
+}
+
+/** 某行的 LLM 余额行(按渠道折叠);没取到时给一格占位而不是空白。 */
+function llmLinesOf(userId: number) {
+ const lines = llmBalanceLines(balances.value[userId]?.llm, balanceLoading.value)
+ return lines.length ? lines : [{ text: '—', title: balanceNotice.value || '本轮没取到数(不是余额为 0)' }]
+}
+
+function proxyLineOf(userId: number) {
+ const item = balances.value[userId]
+ if (item?.proxy) return proxyBalanceLine(item.proxy, false)
+ return balanceLoading.value
+ ? { text: '查询中…', title: '余额按实时查询,不落库' }
+ : { text: '—', title: balanceNotice.value || '本轮没取到数(不是余量为 0)' }
+}
+
// 切公司 = 重新取数。不重取的页 = tab 在那页上是假的(G1 的 pageFiles 断言盯着这条)。
watch(() => companyTab.activeId, () => void load())
@@ -276,6 +340,15 @@ onMounted(load)
+
@@ -290,7 +363,9 @@ onMounted(load)
分组 |
货源查询密钥 |
外观专利密钥 |
+ LLM 余额 |
代理设置 |
+ 代理余量 |
状态 |
创建时间 |
更新时间 |
@@ -331,6 +406,16 @@ onMounted(load)
|
+
+
+ {{ line.text }}
+
+ |
{{ proxyDisplayText(row.proxy) }}
@@ -352,6 +437,13 @@ onMounted(load)
|
+
+
+
+ {{ proxyLineOf(row.userId).text }}
+
+
+ |
{{ rowStatusBand(row).label }}
@@ -389,10 +481,10 @@ onMounted(load)
- | 加载中... |
+ 加载中... |
- | {{ keyword || statusFilter || groupFilter ? '暂无匹配记录' : '暂无用户密钥记录' }} |
+ {{ keyword || statusFilter || groupFilter ? '暂无匹配记录' : '暂无用户密钥记录' }} |
@@ -616,6 +708,16 @@ h3 {
.empty-value {
color: #a7b4c1;
}
+/* 余额列:数字按等宽数位对齐(两行叠着看差值才不用竖着对),超长进 title。 */
+.balance-line {
+ max-width: 100%;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+ font-variant-numeric: tabular-nums;
+ font-size: 12.5px;
+ color: #2f4256;
+}
.ops-cell {
display: flex;
gap: 8px;
diff --git a/admin-frontend-vue/src/pages/account/user-secret-model.ts b/admin-frontend-vue/src/pages/account/user-secret-model.ts
index da515b034..c61f18845 100644
--- a/admin-frontend-vue/src/pages/account/user-secret-model.ts
+++ b/admin-frontend-vue/src/pages/account/user-secret-model.ts
@@ -1,7 +1,7 @@
/**
* 密钥管理页的纯逻辑模型(货源标签 + 代理重填 + 检测结果档位)。
*
- * 三条收口都在这个文件里,页模板只调这里导出的函数,不各写各的字典:
+ * 四条收口都在这个文件里,页模板只调这里导出的函数,不各写各的字典:
*
* 1. **货源标签按模块分字典**(2026-11-02 修):原先 `UserSecretsPage.vue` 里是一整张
* `sourceLabel()`,把 LLM 渠道(longtaitou/t8star)与代理供应商(qingguo/jikip)混在同一个
@@ -312,3 +312,152 @@ export function buildProxyEntryPayload(
}
return { value: String(draft.link || '').trim(), channel: 'jikip' }
}
+
+/* ------------------------------------------------------------------ *
+ * 余额侧写(2026-11-05 B83):第四处收口,仍守「两张字典互不相通」那一条。
+ *
+ * LLM 那格的单位是**钱**(人民币=龙抬头站内 ⚡,后端只取 `credits` 块),
+ * 代理那格的 `surplus` 是**次数**、`scope` 说这份量属于谁的池子。
+ * 两者都叫「余额」,混用一张函数就会读出「极客 ¥34」这种既不像钱也不像次的数——
+ * 所以这里各写各的,跨域字段一个都不读,认不出来一律 `—`(同货源标签那条判据)。
+ * ------------------------------------------------------------------ */
+
+/** 后端 credits 块登记的单位;不是这个值就说明口径换了,宁可不显示也不猜。 */
+export const LLM_BALANCE_UNIT = 'CREDIT'
+
+interface LlmBalanceLike {
+ moduleKey?: string | null
+ moduleLabel?: string | null
+ channel?: string | null
+ channelLabel?: string | null
+ available?: boolean | null
+ balance?: string | null
+ availableBalance?: string | null
+ frozen?: string | null
+ unit?: string | null
+ message?: string | null
+ checkedAt?: string | null
+}
+
+interface ProxyBalanceLike {
+ available?: boolean | null
+ surplus?: string | null
+ balance?: string | null
+ scope?: string | null
+ message?: string | null
+}
+
+/** 一行的显示内容:`text` 进格子,`title` 进悬停(整句原因与取数时刻都在那儿)。 */
+export interface BalanceLine {
+ text: string
+ title: string
+}
+
+const BALANCE_PLACEHOLDER: BalanceLine = { text: UNKNOWN_SOURCE_LABEL, title: '本轮没取到数(不是余额为 0)' }
+const BALANCE_PENDING: BalanceLine = { text: '查询中…', title: '余额按实时查询,不落库' }
+
+/** 人民币读数:解析不出数字时原样回显,不返回 `¥0`(一格 0 会被读成「没钱了」)。 */
+export function formatYuan(raw: string | null | undefined): string {
+ const text = String(raw ?? '').trim()
+ if (!text) return ''
+ const value = Number(text.replace(/,/g, ''))
+ if (!Number.isFinite(value)) return text
+ return `¥${value.toFixed(2)}`
+}
+
+function llmDetail(cell: LlmBalanceLike): string {
+ const parts: string[] = []
+ if (cell.moduleLabel) parts.push(String(cell.moduleLabel))
+ const total = formatYuan(cell.balance)
+ const usable = formatYuan(cell.availableBalance)
+ const frozen = formatYuan(cell.frozen)
+ if (total) parts.push(`总 ${total}`)
+ if (usable) parts.push(`可用 ${usable}`)
+ if (frozen) parts.push(`预冻结 ${frozen}`)
+ if (cell.checkedAt) parts.push(`取数于 ${String(cell.checkedAt).replace('T', ' ').slice(0, 16)}`)
+ const message = String(cell.message ?? '').trim()
+ if (message) parts.push(message)
+ return parts.join(';') || '暂无余额信息'
+}
+
+/**
+ * LLM 余额列:一把密钥一行,前缀是**渠道名**(钱挂在渠道账户上,不在模块上)。
+ *
+ * `pending=true` ⇒ 这一轮还在取数;取到但不合格(单位不是 CREDIT/available=false)
+ * 一律走占位与后端原文,不显示金额。
+ */
+export function llmBalanceLine(cell: LlmBalanceLike | null | undefined, pending = false): BalanceLine {
+ if (pending && !cell) return BALANCE_PENDING
+ if (!cell) return BALANCE_PLACEHOLDER
+ const label = known(LLM_CHANNEL_LABELS, cell.channel) ?? UNKNOWN_SOURCE_LABEL
+ // 渠道认不出(LLM 列被喂了供应商名这类跨域值)时整格给占位:宁可什么都不显示,
+ // 也不让一个不知道属于谁的数字或句子进界面(同货源标签那张表「跨域一律 —」的判据)
+ if (label === UNKNOWN_SOURCE_LABEL) {
+ return { text: UNKNOWN_SOURCE_LABEL, title: `${llmDetail(cell)}|渠道值认不出,未显示金额` }
+ }
+ if (!cell.available || String(cell.unit ?? '').trim().toUpperCase() !== LLM_BALANCE_UNIT) {
+ const message = String(cell.message ?? '').trim()
+ return { text: message ? `${label} 查不到` : `${label} ${UNKNOWN_SOURCE_LABEL}`, title: llmDetail(cell) }
+ }
+ const total = formatYuan(cell.balance)
+ if (!total) return { text: `${label} ${UNKNOWN_SOURCE_LABEL}`, title: llmDetail(cell) }
+ return { text: `${label} ${total}`, title: llmDetail(cell) }
+}
+
+/**
+ * LLM 余额列的整格内容:**按渠道折叠**,一个渠道一行。
+ *
+ * 钱挂在渠道账户上、不挂在模块上:两把密钥(外观专利/货源查询)都在龙抬头时,
+ * 上游回的是同一个余额——排两遍会读成「这个账户有两笔钱」。折叠后 title 里仍留每一把的原文,
+ * 运维要判「是哪把密钥的渠道」看得回来。
+ */
+export function llmBalanceLines(
+ cells: Array | null | undefined,
+ pending = false,
+): BalanceLine[] {
+ const list = (cells ?? []).filter((cell): cell is LlmBalanceLike => Boolean(cell))
+ if (!list.length) return pending ? [BALANCE_PENDING] : []
+ const grouped = new Map()
+ for (const cell of list) {
+ const key = normalizeKey(cell.channel) || 'unknown'
+ const line = llmBalanceLine(cell, pending)
+ const hit = grouped.get(key)
+ grouped.set(key, hit ? { text: hit.text, title: `${hit.title}|${line.title}` } : line)
+ }
+ return [...grouped.values()]
+}
+
+/** 代理池子的归属说法:platform 那份是**平台的钱**,绝不允许被读成这个用户的余量。 */
+const PROXY_SCOPE_LABELS: Record = {
+ user: '你的套餐',
+ platform: '平台池',
+ none: '查不了',
+}
+
+/**
+ * 代理余量列:极客给「剩余 IP 次数」(单位是次、不是钱);青果按 scope=none 说查不了。
+ * `scope` 认不出来时不硬认(回落「来源未标注」并保留原值进 title 供运维核)。
+ */
+export function proxyBalanceLine(cell: ProxyBalanceLike | null | undefined, pending = false): BalanceLine {
+ if (pending && !cell) return BALANCE_PENDING
+ if (!cell) return BALANCE_PLACEHOLDER
+ const scopeKey = normalizeKey(cell.scope)
+ const scopeLabel = Object.prototype.hasOwnProperty.call(PROXY_SCOPE_LABELS, scopeKey)
+ ? PROXY_SCOPE_LABELS[scopeKey]
+ : '来源未标注'
+ const message = String(cell.message ?? '').trim()
+ const detailParts = [`${scopeLabel}`]
+ const surplus = String(cell.surplus ?? '').trim()
+ const amount = String(cell.balance ?? '').trim()
+ if (surplus) detailParts.push(`剩余 IP ${surplus}`)
+ if (amount) detailParts.push(`账户余额 ${amount}`)
+ if (message) detailParts.push(message)
+ const title = detailParts.join(';') || '暂无余量信息'
+ if (!cell.available) {
+ // 后端那句原文(「青果不提供余量查询…」「上游未在预算内应答…」)全在 title 里;
+ // 格子只说「查不了」——留 `—` 会被读成「这人没配代理」,那是另一件事。
+ return { text: message ? '查不了' : `${scopeLabel} ${UNKNOWN_SOURCE_LABEL}`, title }
+ }
+ // 次数就是次数:这里不套 ¥ 符号、不换算,读数带「次」把单位写在格子里
+ return { text: `${scopeLabel} ${surplus || UNKNOWN_SOURCE_LABEL} 次`, title }
+}
diff --git a/admin-frontend-vue/tests/mount/user-secret-balance-columns.mount.test.ts b/admin-frontend-vue/tests/mount/user-secret-balance-columns.mount.test.ts
new file mode 100644
index 000000000..5a8fa43b5
--- /dev/null
+++ b/admin-frontend-vue/tests/mount/user-secret-balance-columns.mount.test.ts
@@ -0,0 +1,210 @@
+/**
+ * 密钥管理列表页「余额两列」的界面侧判据(2026-11-05 B83)。
+ *
+ * 读数本身在 `user-secret-model.ts` 里被那颗纯函数尺子钉着;这一支管的是**接上去的形状**:
+ * ① 两列都在,且 `` 数=每行 ` | ` 数=空态行的 colspan —— 加列忘改 colspan 是本仓常踩的残行,
+ * 历史上专门为此写过提交说明,所以这里把它钉成算术关系而不是逐个数字;
+ * ② 有数时 LLM 列给人民币、代理列给次数,两者不混;
+ * ③ 整轮没取到时两列都是 `—`,**不是 0**(一格 0 会被读成「这人欠费了」);
+ * ④ 非超管少一列「分组」时,上述三个数仍然彼此相等。
+ *
+ * 跑法:`npx vitest run tests/mount/user-secret-balance-columns.mount.test.ts`
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import { flushPromises, mount, type VueWrapper } from '@vue/test-utils'
+import { createPinia, setActivePinia, type Pinia } from 'pinia'
+
+import UserSecretsPage from '@/pages/account/UserSecretsPage.vue'
+import { useAdminSessionStore } from '@/stores/admin-session'
+import { useCompanyTabStore } from '@/stores/company-tab'
+
+const secretsApi = vi.hoisted(() => ({
+ fetchUserSecretList: vi.fn(),
+ fetchAdminSecretBalances: vi.fn(),
+ checkUserSecret: vi.fn(),
+ deleteUserSecret: vi.fn(),
+ saveUserSecretModule: vi.fn(),
+ clearUserSecretModule: vi.fn(),
+}))
+
+vi.mock('@/api/user-secrets', () => secretsApi)
+
+function moduleCell(moduleKey: string, over: Record = {}) {
+ return {
+ moduleKey, moduleLabel: moduleKey, channel: null,
+ masked: 'sk-f****9BgQ', full: '', exists: true, locked: false,
+ checkStatus: 'passed', checkCode: 'ok', checkMessage: '连通正常',
+ checkLatencyMs: 12, checkedAt: '2026-11-05T10:30:00', updatedAt: '2026-11-05T10:30:00',
+ ...over,
+ }
+}
+
+function row(userId: number, over: Record = {}) {
+ return {
+ userId,
+ username: `user${userId}`,
+ groups: [],
+ leaderUsername: '',
+ similarAsin: moduleCell('similar-asin', { moduleLabel: '货源查询密钥', channel: 'longtaitou' }),
+ appearancePatent: moduleCell('appearance-patent', { moduleLabel: '外观专利密钥', channel: 'longtaitou' }),
+ proxy: moduleCell('proxy', { moduleLabel: '代理设置', channel: 'jikip' }),
+ status: 'passed',
+ statusMessage: '三项均检测通过',
+ createdAt: '2026-11-01T09:00:00',
+ updatedAt: '2026-11-05T10:30:00',
+ ...over,
+ }
+}
+
+function llmCells(userId: number) {
+ return [
+ {
+ moduleKey: 'appearance-patent', moduleLabel: '外观专利密钥',
+ channel: 'longtaitou', channelLabel: '龙抬头',
+ available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
+ unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00',
+ },
+ {
+ moduleKey: 'similar-asin', moduleLabel: '货源查询密钥',
+ channel: 'longtaitou', channelLabel: '龙抬头',
+ available: true, balance: '88.888882', availableBalance: '85.288882', frozen: '3.6',
+ unit: 'CREDIT', message: null, checkedAt: '2026-11-05T10:30:00',
+ },
+ ].map((cell) => (userId === 7 ? cell : { ...cell, balance: '12.5', availableBalance: '10', frozen: null }))
+}
+
+function indexByHeader(wrapper: VueWrapper, header: string) {
+ const headers = wrapper.findAll('thead th').map((th) => th.text().trim())
+ const index = headers.findIndex((label) => label.includes(header))
+ expect(index, `表头里找不到「${header}」`).toBeGreaterThanOrEqual(0)
+ return index
+}
+
+function cellText(wrapper: VueWrapper, header: string, rowIndex = 0): string {
+ const index = indexByHeader(wrapper, header)
+ return wrapper.findAll('tbody tr')[rowIndex].findAll('td')[index].text().trim()
+}
+
+function cellTitle(wrapper: VueWrapper, header: string, rowIndex = 0): string {
+ const index = indexByHeader(wrapper, header)
+ const cell = wrapper.findAll('tbody tr')[rowIndex].findAll('td')[index]
+ return cell.find('.balance-line').attributes('title') ?? ''
+}
+
+let pinia: Pinia
+
+beforeEach(() => {
+ vi.clearAllMocks()
+ pinia = createPinia()
+ setActivePinia(pinia)
+ useAdminSessionStore().user = { id: 1, username: 'root', role: 'super_admin' }
+ useCompanyTabStore().setActiveId(1)
+})
+
+async function mountWith(rowValues: unknown[], balances?: unknown) {
+ secretsApi.fetchUserSecretList.mockResolvedValue({
+ items: rowValues, total: rowValues.length, page: 1, pageSize: 15, groupOptions: [],
+ })
+ secretsApi.fetchAdminSecretBalances.mockResolvedValue(
+ balances === undefined
+ ? { items: rowValues.map((item: any) => ({ userId: item.userId, llm: llmCells(item.userId), proxy: { available: true, surplus: '1234', balance: '56', scope: 'user', message: null } })), deniedUserIds: [], timedOutUserIds: [] }
+ : balances,
+ )
+ const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
+ await flushPromises()
+ await flushPromises()
+ return wrapper
+}
+
+describe('余额两列接在密钥管理列表上', () => {
+ it('表头数=行内格数=空态 colspan(加列忘改 colspan 直接红)', async () => {
+ const wrapper = await mountWith([row(7)])
+ const headerCount = wrapper.findAll('thead th').length
+ const cellCount = wrapper.findAll('tbody tr')[0].findAll('td').length
+ expect(cellCount, '每行的 td 数必须等于表头列数').toBe(headerCount)
+ expect(headerCount).toBe(12)
+
+ const emptyWrapper = await mountWith([])
+ const colspan = Number(emptyWrapper.find('tbody td').attributes('colspan'))
+ expect(colspan, '空态行的 colspan 必须跟着列数走').toBe(headerCount)
+ })
+
+ it('非超管少一列分组时,三个数仍然彼此相等', async () => {
+ useAdminSessionStore().user = { id: 2, username: 'leader', role: 'admin' }
+ const wrapper = await mountWith([row(7)])
+ const headerCount = wrapper.findAll('thead th').length
+ expect(headerCount).toBe(11)
+ expect(wrapper.findAll('tbody tr')[0].findAll('td').length).toBe(headerCount)
+
+ const emptyWrapper = await mountWith([])
+ expect(Number(emptyWrapper.find('tbody td').attributes('colspan'))).toBe(headerCount)
+ })
+
+ it('LLM 列给人民币读数,按渠道折成一行(同一个钱不排两遍)', async () => {
+ const wrapper = await mountWith([row(7)])
+
+ expect(cellText(wrapper, 'LLM 余额')).toBe('龙抬头 ¥88.89')
+ expect(cellTitle(wrapper, 'LLM 余额')).toContain('外观专利密钥')
+ expect(cellTitle(wrapper, 'LLM 余额')).toContain('货源查询密钥')
+ expect(cellTitle(wrapper, 'LLM 余额')).toContain('取数于 2026-11-05 10:30')
+ })
+
+ it('代理列给次数并说清是谁的池子,不套 ¥', async () => {
+ const wrapper = await mountWith([row(7)])
+
+ const text = cellText(wrapper, '代理余量')
+ expect(text).toContain('你的套餐')
+ expect(text).toContain('1234 次')
+ expect(text).not.toContain('¥')
+ })
+
+ it('两列各读各的:LLM 列里不出现次数、代理列里不出现金额', async () => {
+ const wrapper = await mountWith([row(7)])
+
+ expect(cellText(wrapper, 'LLM 余额')).not.toMatch(/\d+\s*次/)
+ expect(cellText(wrapper, '代理余量')).not.toContain('¥')
+ })
+
+ it('整轮没取到时两列都是 —,一格都不许是 0', async () => {
+ const wrapper = await mountWith([row(7)], { items: [], deniedUserIds: [7], timedOutUserIds: [] })
+
+ expect(cellText(wrapper, 'LLM 余额')).toBe('—')
+ expect(cellText(wrapper, '代理余量')).toBe('—')
+ expect(cellText(wrapper, 'LLM 余额')).not.toContain('0.00')
+ })
+
+ it('超预算的行说「本轮未应答」,不冒充欠费', async () => {
+ const wrapper = await mountWith([row(7)], {
+ items: [{ userId: 7, llm: [], proxy: { available: false, surplus: null, balance: null, scope: null, message: '上游未在本轮时间预算内应答,稍后重试;这不代表余量为 0' } }],
+ deniedUserIds: [],
+ timedOutUserIds: [7],
+ })
+
+ expect(cellText(wrapper, 'LLM 余额')).toBe('—')
+ expect(cellText(wrapper, '代理余量')).toBe('查不了')
+ expect(cellTitle(wrapper, '代理余量')).toContain('不代表余量为 0')
+ })
+
+ it('余额接口整个失败也不把整页判成加载失败', async () => {
+ secretsApi.fetchUserSecretList.mockResolvedValue({ items: [row(7)], total: 1, page: 1, pageSize: 15, groupOptions: [] })
+ secretsApi.fetchAdminSecretBalances.mockRejectedValue(new Error('上游 502'))
+ const wrapper = mount(UserSecretsPage, { global: { plugins: [pinia] } })
+ await flushPromises()
+ await flushPromises()
+
+ expect(wrapper.findAll('tbody tr')).toHaveLength(1)
+ expect(wrapper.find('.load-failure-bar').exists(), '列表主数据在,就不该把整页报成加载失败').toBe(false)
+ expect(cellText(wrapper, 'LLM 余额')).toBe('—')
+ })
+
+ it('点「刷新余额」重取一轮,不动列表请求', async () => {
+ const wrapper = await mountWith([row(7)])
+ const listCalls = secretsApi.fetchUserSecretList.mock.calls.length
+
+ await wrapper.findAll('.filter-actions button').at(-1)!.trigger('click')
+ await flushPromises()
+
+ expect(secretsApi.fetchAdminSecretBalances).toHaveBeenCalledTimes(2)
+ expect(secretsApi.fetchUserSecretList).toHaveBeenCalledTimes(listCalls)
+ })
+})
diff --git a/admin-frontend-vue/tests/mount/user-secret-status-band.mount.test.ts b/admin-frontend-vue/tests/mount/user-secret-status-band.mount.test.ts
index 36a34198e..9b864c81a 100644
--- a/admin-frontend-vue/tests/mount/user-secret-status-band.mount.test.ts
+++ b/admin-frontend-vue/tests/mount/user-secret-status-band.mount.test.ts
@@ -25,6 +25,7 @@ import { useCompanyTabStore } from '@/stores/company-tab'
const secretsApi = vi.hoisted(() => ({
fetchUserSecretList: vi.fn(),
+ fetchAdminSecretBalances: vi.fn(),
checkUserSecret: vi.fn(),
deleteUserSecret: vi.fn(),
saveUserSecretModule: vi.fn(),
diff --git a/admin-frontend-vue/tests/密钥余额列读数.test.ts b/admin-frontend-vue/tests/密钥余额列读数.test.ts
new file mode 100644
index 000000000..226176cb8
--- /dev/null
+++ b/admin-frontend-vue/tests/密钥余额列读数.test.ts
@@ -0,0 +1,140 @@
+/**
+ * 密钥管理页「余额两列」的读数判据(2026-11-05 B83)。
+ *
+ * 靶子是口径与归属,不是排版:
+ * ① LLM 那格只认 `unit=CREDIT`(人民币=龙抬头 ⚡),认不出就一律 `—`,不猜、不给 0;
+ * ② 两把密钥同属一个渠道账户时**折成一行**(同一个钱排两遍会被读成两笔钱);
+ * ③ 代理那格的 `surplus` 是**次数**,读数带「次」不带 `¥`;`scope=platform` 必须说清是平台池,
+ * 不许被读成这个用户自己的量(铁律 25 的串档形状);
+ * ④ 查不到 ≠ 没钱:`available=false` 与「整格没取到」都得出可分辨的文字。
+ *
+ * 跑法:`cd crawler-plugin/admin-frontend-vue && npm test`
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+import {
+ formatYuan,
+ llmBalanceLine,
+ llmBalanceLines,
+ proxyBalanceLine,
+} from '../src/pages/account/user-secret-model.ts'
+
+function llmCell(over: Record = {}) {
+ return {
+ moduleKey: 'appearance-patent',
+ moduleLabel: '外观专利密钥',
+ channel: 'longtaitou',
+ channelLabel: '龙抬头',
+ available: true,
+ balance: '88.888882',
+ availableBalance: '85.288882',
+ frozen: '3.6',
+ unit: 'CREDIT',
+ message: null,
+ checkedAt: '2026-11-05T10:30:00',
+ ...over,
+ }
+}
+
+test('人民币读数保留两位且不提前取整', () => {
+ assert.equal(formatYuan('88.888882'), '¥88.89')
+ assert.equal(formatYuan('0'), '¥0.00')
+ assert.equal(formatYuan(''), '')
+ assert.equal(formatYuan(null), '')
+ // 认不出数字时原样回显,不套 ¥(套了就是宣称它是人民币)
+ assert.equal(formatYuan('$12.345678'), '$12.345678')
+})
+
+test('LLM 一行给渠道名与金额,悬停带模块原文与取数时刻', () => {
+ const line = llmBalanceLine(llmCell())
+ assert.equal(line.text, '龙抬头 ¥88.89')
+ assert.match(line.title, /外观专利密钥/)
+ assert.match(line.title, /可用 ¥85\.29/)
+ assert.match(line.title, /预冻结 ¥3\.60/)
+ assert.match(line.title, /取数于 2026-11-05 10:30/)
+})
+
+test('单位不是 CREDIT 时按认不出处理,一个金额都不给', () => {
+ const line = llmBalanceLine(llmCell({ unit: 'USD', message: '龙抬头没返回人民币口径的余额块' }))
+ assert.equal(line.text, '龙抬头 查不到')
+ assert.ok(!line.text.includes('¥'), `认不出口径不许显示金额:${line.text}`)
+ assert.match(line.title, /没返回人民币/)
+})
+
+test('available=false 说查不到,不显示 0', () => {
+ const line = llmBalanceLine(llmCell({
+ available: false, balance: null, availableBalance: null, frozen: null,
+ channel: 't8star', channelLabel: '贞贞', message: '贞贞渠道不提供余额查询',
+ }))
+ assert.equal(line.text, '贞贞 查不到')
+ assert.ok(!line.text.includes('0.00'), '查不到不许读成欠费')
+})
+
+test('两把密钥同渠道时折成一行,同一个钱不排两遍', () => {
+ const lines = llmBalanceLines([
+ llmCell(),
+ llmCell({ moduleKey: 'similar-asin', moduleLabel: '货源查询密钥' }),
+ ])
+ assert.equal(lines.length, 1)
+ assert.equal(lines[0].text, '龙抬头 ¥88.89')
+ assert.match(lines[0].title, /外观专利密钥/)
+ assert.match(lines[0].title, /货源查询密钥/, '折叠后每一把的原文都要还在悬停里')
+})
+
+test('两把密钥分属两渠道时各出一行', () => {
+ const lines = llmBalanceLines([
+ llmCell(),
+ llmCell({
+ channel: 't8star', channelLabel: '贞贞', available: false,
+ balance: null, availableBalance: null, frozen: null, unit: null,
+ message: '贞贞渠道不提供余额查询',
+ }),
+ ])
+ assert.deepEqual(lines.map((line) => line.text), ['龙抬头 ¥88.89', '贞贞 查不到'])
+})
+
+test('没取到数与查询中是两件事,都不许画成 0', () => {
+ assert.equal(llmBalanceLine(null).text, '—')
+ assert.match(llmBalanceLine(null).title, /不是余额为 0/)
+ assert.equal(llmBalanceLine(undefined, true).text, '查询中…')
+ assert.deepEqual(llmBalanceLines([], true).map((l) => l.text), ['查询中…'])
+ assert.deepEqual(llmBalanceLines([], false), [])
+})
+
+test('渠道认不出时整格占位,连金额都不给', () => {
+ const line = llmBalanceLine(llmCell({ channel: 'jikip', channelLabel: '极客' }))
+ assert.equal(line.text, '—')
+ assert.ok(!line.text.includes('¥'), '把供应商名贴到 LLM 列就是那处错标的形状')
+ assert.match(line.title, /渠道值认不出,未显示金额/)
+})
+
+test('代理余量给的是次数,带单位且不套 ¥', () => {
+ const line = proxyBalanceLine({ available: true, surplus: '1234', balance: '56', scope: 'user', message: null })
+ assert.equal(line.text, '你的套餐 1234 次')
+ assert.ok(!line.text.includes('¥'), `次数不是钱:${line.text}`)
+ assert.match(line.title, /剩余 IP 1234/)
+ assert.match(line.title, /账户余额 56/)
+})
+
+test('平台池必须自报是平台的钱,不许冒充这个用户的余量', () => {
+ const line = proxyBalanceLine({ available: true, surplus: '9', balance: '1', scope: 'platform', message: null })
+ assert.match(line.text, /^平台池/)
+ assert.match(line.title, /平台池/)
+ assert.ok(!line.text.includes('你的套餐'), '串档形状:平台池的量被写成用户自己的套餐')
+})
+
+test('青果那一档说查不了,句子用后端原文', () => {
+ const line = proxyBalanceLine({
+ available: false, surplus: null, balance: null, scope: 'none',
+ message: '青果不提供余量/余额查询(它的余额接口要控制台 Appid 与 Appkey 签名)',
+ })
+ assert.equal(line.text, '查不了')
+ assert.match(line.title, /查不了/)
+ assert.match(line.title, /青果不提供/)
+})
+
+test('scope 缺失时不硬认,标成来源未标注', () => {
+ const line = proxyBalanceLine({ available: true, surplus: '5', balance: null, scope: null, message: null })
+ assert.match(line.text, /^来源未标注/)
+})
| |