From b94555f411224ae88e32037e211a9e057a8c81ae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Sat, 24 Oct 2026 10:50:24 +0800 Subject: [PATCH] =?UTF-8?q?feat(frontend):=20=E5=AE=A2=E6=88=B7=E7=AB=AF?= =?UTF-8?q?=E6=8D=9F=E8=80=97=E4=BF=9D=E6=8A=A4=E5=BC=B9=E7=AA=97=E4=B8=8E?= =?UTF-8?q?=E5=85=B1=E4=BA=AB=E5=AF=86=E9=92=A5=E6=8F=90=E7=A4=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 30 秒轮询损耗状态;暂停时红色弹窗/横幅并提供「继续任务」 - 共享密钥黄色提示条,按类型去重,不重复刷屏 - 通知铃铛登记 cost_guard / secret_shared 场景 --- frontend-vue/src/App.vue | 2 + frontend-vue/src/shared/api/endpoints.ts | 4 + .../shared/api/types/modules/cost-guard.ts | 52 ++++ .../shared/api/types/modules/notification.ts | 4 +- .../src/shared/components/CostGuardAlert.vue | 278 ++++++++++++++++++ .../src/shared/utils/cost-guard-alert.ts | 29 ++ frontend-vue/tests/cost-guard-alert.test.ts | 98 ++++++ 7 files changed, 466 insertions(+), 1 deletion(-) create mode 100644 frontend-vue/src/shared/api/types/modules/cost-guard.ts create mode 100644 frontend-vue/src/shared/components/CostGuardAlert.vue create mode 100644 frontend-vue/src/shared/utils/cost-guard-alert.ts create mode 100644 frontend-vue/tests/cost-guard-alert.test.ts diff --git a/frontend-vue/src/App.vue b/frontend-vue/src/App.vue index c82c0dccf..27239b11c 100644 --- a/frontend-vue/src/App.vue +++ b/frontend-vue/src/App.vue @@ -3,6 +3,7 @@ + @@ -18,6 +19,7 @@ import { onBeforeUnmount } from 'vue' import ExpiryNotice from '@/shared/components/ExpiryNotice.vue' import ForceUpdateGate from '@/shared/components/ForceUpdateGate.vue' import ProxyBalanceAlert from '@/shared/components/ProxyBalanceAlert.vue' +import CostGuardAlert from '@/shared/components/CostGuardAlert.vue' import { disposeGlobalErrorGuard } from '@/shared/utils/app-error' import { uninstallUserTokenSync } from '@/shared/auth/user-token-sync' import { disposeDownloadProgressListener } from '@/shared/utils/download-progress' diff --git a/frontend-vue/src/shared/api/endpoints.ts b/frontend-vue/src/shared/api/endpoints.ts index dd0070805..cbb387dc8 100644 --- a/frontend-vue/src/shared/api/endpoints.ts +++ b/frontend-vue/src/shared/api/endpoints.ts @@ -207,6 +207,10 @@ export const API_ENDPOINTS = { proxyBalance: '/api/user-secrets/proxy-balance', proxyPlan: '/api/user-secrets/proxy-plan', }, + costGuard: { + status: '/api/user/cost-guard/status', + resume: '/api/user/cost-guard/resume', + }, notification: { summary: '/api/notifications/summary', list: '/api/notifications', diff --git a/frontend-vue/src/shared/api/types/modules/cost-guard.ts b/frontend-vue/src/shared/api/types/modules/cost-guard.ts new file mode 100644 index 000000000..9478b1e2c --- /dev/null +++ b/frontend-vue/src/shared/api/types/modules/cost-guard.ts @@ -0,0 +1,52 @@ +import { get, post, type JavaApiResponse, unwrapJavaResponse } from '../../http.ts' +import { buildJavaUrl } from '../../url.ts' +import { API_ENDPOINTS } from '../../endpoints.ts' + +/** 代理/LLM 共享密钥提示:只报账号数,不暴露其他账号身份。 */ +export interface SharedSecretWarning { + type: 'proxy' | 'llm' | string + moduleLabel: string + accounts: number + threshold: number + message: string +} + +export interface CostGuardUsage { + proxy: number + llmCalls: number + llmTokens: number +} + +export interface CostGuardStatus { + paused: boolean + reason: string + pausedAt: string | null + today: CostGuardUsage + window: CostGuardUsage & { seconds: number } + thresholds: { + proxyWindow: number + llmCallsWindow: number + llmTokensWindow: number + proxyDaily: number + llmCallsDaily: number + llmTokensDaily: number + sharedAccounts: number + } + sharedWarnings: SharedSecretWarning[] +} + +export function fetchCostGuardStatus() { + return unwrapJavaResponse( + get>(buildJavaUrl(API_ENDPOINTS.costGuard.status)), + ) +} + +/** 排查后手动继续:只清暂停闸,不删除已完成任务与结果行。 */ +export function resumeCostGuard() { + return unwrapJavaResponse( + post, undefined>( + buildJavaUrl(API_ENDPOINTS.costGuard.resume), + undefined, + ), + ) +} diff --git a/frontend-vue/src/shared/api/types/modules/notification.ts b/frontend-vue/src/shared/api/types/modules/notification.ts index e75502b5c..3a2dd4e79 100644 --- a/frontend-vue/src/shared/api/types/modules/notification.ts +++ b/frontend-vue/src/shared/api/types/modules/notification.ts @@ -2,7 +2,7 @@ import { get, post, type JavaApiResponse, unwrapJavaResponse } from '../../http. import { buildJavaUrl } from '../../url.ts' import { API_ENDPOINTS } from '../../endpoints.ts' -/** 通知场景:密钥欠费 / 密钥失效 / 任务失败 / 交付不完整 / 服务异常 / 麦象异常 / 系统。 */ +/** 通知场景:密钥欠费 / 密钥失效 / 任务失败 / 交付不完整 / 服务异常 / 麦象异常 / 损耗暂停 / 密钥共用 / 系统。 */ export type NotificationScene = | 'secret_balance' | 'secret_invalid' @@ -10,6 +10,8 @@ export type NotificationScene = | 'task_partial' | 'service_down' | 'maixiang_anomaly' + | 'cost_guard' + | 'secret_shared' | 'system' /** diff --git a/frontend-vue/src/shared/components/CostGuardAlert.vue b/frontend-vue/src/shared/components/CostGuardAlert.vue new file mode 100644 index 000000000..c5ea34229 --- /dev/null +++ b/frontend-vue/src/shared/components/CostGuardAlert.vue @@ -0,0 +1,278 @@ + + + + + + ! + + 任务已自动暂停(损耗保护) + {{ status.reason }} + {{ usageLine(status) }} + + 已完成的任务与结果行不受影响。请检查「密钥设置」与被暂停任务,排查后继续。 + + + {{ resuming ? '正在恢复…' : '继续任务' }} + + + + + + i + + 密钥共用提示 + + {{ warning.message }} + + + + + + + diff --git a/frontend-vue/src/shared/utils/cost-guard-alert.ts b/frontend-vue/src/shared/utils/cost-guard-alert.ts new file mode 100644 index 000000000..2064f9323 --- /dev/null +++ b/frontend-vue/src/shared/utils/cost-guard-alert.ts @@ -0,0 +1,29 @@ +import type { CostGuardStatus, SharedSecretWarning } from '@/shared/api/types/modules/cost-guard' + +/** 损耗状态轮询间隔:与后端每分钟扫描配合,30 秒足够把暂停提示送到界面。 */ +export const COST_GUARD_POLL_MS = 30_000 + +export function formatCount(value: number | null | undefined): string { + const number = Number(value ?? 0) + if (!Number.isFinite(number)) return '0' + return number.toLocaleString('zh-CN') +} + +/** 暂停弹窗/横幅里的用量行:当日累计 + 本轮增量,用户一眼看出是哪一项超了。 */ +export function usageLine(status: CostGuardStatus | null): string { + if (!status) return '' + const today = status.today + const window = status.window + return `今日代理提取 ${formatCount(today.proxy)} 次 · LLM ${formatCount(today.llmCalls)} 次 / ${formatCount(today.llmTokens)} tokens;` + + `最近 ${window.seconds} 秒:代理 ${formatCount(window.proxy)} 次 · LLM ${formatCount(window.llmCalls)} 次 / ${formatCount(window.llmTokens)} tokens` +} + +/** 同一个暂停事件只弹一次:pausedAt 变化(新的自动暂停)才重新弹。 */ +export function pausedPromptKey(status: CostGuardStatus | null): string { + if (!status?.paused) return '' + return status.pausedAt || status.reason || 'paused' +} + +export function sharedWarningKey(warning: SharedSecretWarning): string { + return `${warning.type}|${warning.moduleLabel}|${warning.accounts}` +} diff --git a/frontend-vue/tests/cost-guard-alert.test.ts b/frontend-vue/tests/cost-guard-alert.test.ts new file mode 100644 index 000000000..dbed8c73d --- /dev/null +++ b/frontend-vue/tests/cost-guard-alert.test.ts @@ -0,0 +1,98 @@ +import { test } from 'node:test' +import assert from 'node:assert/strict' +import { readFileSync } from 'node:fs' +import { join } from 'node:path' + +/** + * 代理/LLM 损耗保护(2026-10-24 需求): + * 「异常要立刻弹窗警告在客户端界面上,并暂停任务;排查后手动点击接着跑」。 + * + * 分两层钉: + * ① 行为层:暂停键只随 pausedAt 变化、用量行含当日与窗口两段、共享提示按键去重; + * ② 源码层:全局挂载、30 秒轮询、暂停弹窗带「继续任务」、resume 走独立接口。 + */ + +const COMPONENT = 'src/shared/components/CostGuardAlert.vue' +const APP = 'src/App.vue' +const ENDPOINTS = 'src/shared/api/endpoints.ts' +const NOTIFICATION_TYPES = 'src/shared/api/types/modules/notification.ts' + +function read(rel: string): string { + return readFileSync(join(process.cwd(), rel), 'utf8') +} + +const component = read(COMPONENT) +const app = read(APP) + +test('用量行同时给出当日累计与最近窗口增量', async () => { + const { usageLine, formatCount } = await import('../src/shared/utils/cost-guard-alert.ts') + const status = { + paused: true, + reason: '代理提取异常', + pausedAt: '2026-10-24T10:00:00', + today: { proxy: 12345, llmCalls: 678, llmTokens: 900000 }, + window: { seconds: 120, proxy: 600, llmCalls: 180, llmTokens: 600000 }, + thresholds: { + proxyWindow: 600, + llmCallsWindow: 180, + llmTokensWindow: 600000, + proxyDaily: 8000, + llmCallsDaily: 6000, + llmTokensDaily: 20000000, + sharedAccounts: 3, + }, + sharedWarnings: [], + } + + const line = usageLine(status as never) + assert.match(line, /今日代理提取 12,345 次/) + assert.match(line, /最近 120 秒:代理 600 次/) + assert.match(line, /LLM 180 次 \/ 600,000 tokens/) + assert.equal(formatCount(undefined), '0') +}) + +test('同一个暂停事件只弹一次,pausedAt 变化才重新弹', async () => { + const { pausedPromptKey } = await import('../src/shared/utils/cost-guard-alert.ts') + const base = { paused: true, reason: 'r', pausedAt: '2026-10-24T10:00:00' } + const next = { paused: true, reason: 'r', pausedAt: '2026-10-24T11:00:00' } + + assert.equal(pausedPromptKey(base as never), pausedPromptKey({ ...base } as never)) + assert.notEqual(pausedPromptKey(base as never), pausedPromptKey(next as never)) + assert.equal(pausedPromptKey({ paused: false, reason: 'r', pausedAt: null } as never), '') +}) + +test('共享密钥提示按键去重,不按文案去重', async () => { + const { sharedWarningKey } = await import('../src/shared/utils/cost-guard-alert.ts') + + assert.equal( + sharedWarningKey({ type: 'proxy', moduleLabel: '代理设置', accounts: 3, threshold: 3, message: 'a' }), + sharedWarningKey({ type: 'proxy', moduleLabel: '代理设置', accounts: 3, threshold: 3, message: 'b' }), + ) + assert.notEqual( + sharedWarningKey({ type: 'llm', moduleLabel: '代理设置', accounts: 3, threshold: 3, message: 'a' }), + sharedWarningKey({ type: 'proxy', moduleLabel: '代理设置', accounts: 3, threshold: 3, message: 'a' }), + ) +}) + +test('全局挂载并在暂停时提供「继续任务」', () => { + assert.ok(app.includes("import CostGuardAlert from '@/shared/components/CostGuardAlert.vue'")) + assert.ok(app.includes(''), '组件没挂到 App.vue,异常时界面不会弹') + + assert.ok(component.includes('setInterval'), '缺少轮询,用户停在页面上等不到暂停提示') + assert.ok(component.includes('COST_GUARD_POLL_MS')) + assert.ok(component.includes('fetchCostGuardStatus')) + assert.ok(component.includes('resumeCostGuard')) + assert.ok(component.includes('ElMessageBox.confirm')) + assert.ok(component.includes('继续任务')) + assert.ok(component.includes('已完成的任务与数据不受影响')) +}) + +test('接口与通知场景已登记', () => { + const endpoints = read(ENDPOINTS) + assert.ok(endpoints.includes("status: '/api/user/cost-guard/status'")) + assert.ok(endpoints.includes("resume: '/api/user/cost-guard/resume'")) + + const notification = read(NOTIFICATION_TYPES) + assert.ok(notification.includes("| 'cost_guard'")) + assert.ok(notification.includes("| 'secret_shared'")) +})