init: api-gateway v2.4.0(Agnes/b.ai/火山方舟 三家供应商网关)

This commit is contained in:
api-gateway committed 2026-09-15 17:05:46 +08:00
commit 6cc65ff76f
91 files changed
+24653

No files matched your search

+139
View File
@@ -0,0 +1,139 @@
// M4: 图表公共样式。集中处理两类「文字挤压」问题:
// ① 长模型名重叠 —— 类目轴喂完整名称(tooltip 显全称),轴上截断 + 倾斜 + hideOverlap,
// grid 用 containLabel 让 ECharts 按标签实际占位留白;
// ② ECharts 6 把 legend 默认位置从 top 改成了 bottom(LegendModel.defaultOption.bottom),
// 于是图例压在 x 轴标签上 —— 这里统一显式 top: 0,并给 grid.top 留出图例行高。
export function clip(v: string, n = 12): string {
return v.length > n ? v.slice(0, n) + '…' : v
}
/** 读一个主题 token 的当前值。ECharts 只吃具体色值(不认 CSS 变量),
* 所以每次重算 option 时现取一次 —— 切主题后重新 computed 即可换色。 */
export function cssVar(name: string, fallback = ''): string {
if (typeof document === 'undefined') return fallback
const v = getComputedStyle(document.documentElement).getPropertyValue(name).trim()
return v || fallback
}
/** 图表用色板(随 A/B/C 主题变化)。 */
export function chartTheme() {
return {
a: cssVar('--chart-a', '#4F63F5'),
b: cssVar('--chart-b', '#35B8C9'),
ok: cssVar('--ok', '#15A34A'),
warn: cssVar('--warn', '#D97706'),
err: cssVar('--err', '#DC2626'),
text: cssVar('--text', '#16203A'),
muted: cssVar('--muted', '#6B7891'),
muted2: cssVar('--muted-2', '#98A3B7'),
line: cssVar('--line', '#E5EAF4'),
primary: cssVar('--primary', '#4F63F5'),
}
}
/** 类目轴配置:传入完整名称(tooltip 显全称),轴上按 maxLen 截断显示。 */
export function categoryAxis(labels: string[], maxLen = 12) {
const c = chartTheme()
return {
type: 'category' as const,
data: labels,
axisTick: { alignWithLabel: true },
axisLine: { lineStyle: { color: c.line } },
axisLabel: {
interval: 0,
rotate: labels.length > 4 ? 30 : 0,
hideOverlap: true,
margin: 8,
fontSize: 11,
color: c.muted2,
formatter: (v: string) => clip(v, maxLen),
},
}
}
/** 数值轴:统一网格线与轴色(深色主题下默认灰线会糊成一片)。 */
export function valueAxis(name = '', minInterval = 0) {
const c = chartTheme()
return {
type: 'value' as const,
name,
minInterval,
axisLine: { show: false },
axisTick: { show: false },
axisLabel: { fontSize: 11, color: c.muted2 },
splitLine: { lineStyle: { color: c.line } },
}
}
/** 图例:显式钉在顶部,避免 ECharts 6 默认落到底部压住 x 轴标签。 */
export function legend(data: string[]) {
return {
data,
top: 0,
left: 'center',
itemWidth: 14,
itemHeight: 10,
itemGap: 14,
textStyle: { fontSize: 12, color: chartTheme().muted },
}
}
/** top 留出图例(约 22px);containLabel 自动为轴标签留白,不用再手算 bottom。 */
export const grid = { left: 12, right: 18, top: 34, bottom: 10, containLabel: true }
/** 环形图:半径留足空间给外部标签,避免标签被容器裁掉。 */
export const pieRadius = ['34%', '56%']
export const pieCenter = ['50%', '52%']
/** 环形图标签:色值必须现取(ECharts 默认 #333,深色主题 A 下会糊在底色里看不见)。
* 和 legend/valueAxis 一样做成函数,切主题后重算 option 就会跟着换色。 */
export function pieLabel() {
return {
overflow: 'truncate' as const,
width: 110,
formatter: '{b}: {c}',
fontSize: 11,
color: chartTheme().muted,
}
}
/** 空数据的图表别只留一副空坐标轴:在画布中央给一行灰字提示。
* 传进来的数组全空(或全 0)时才出现,有数据时返回空数组、不影响原图。 */
export function emptyTip(series: (number[] | undefined | null)[], text: string) {
const allEmpty = series.every((s) => !s || !s.length || s.every((v) => !v))
if (!allEmpty) return []
return [
{
type: 'text',
left: 'center',
top: 'middle',
silent: true,
style: { text, fill: chartTheme().muted2, fontSize: 12 },
},
]
}
export const pieLabelLine = { length: 8, length2: 10, smooth: true }
/** 环形图配色:主色系渐次铺开,供应商/模型数量不定也不至于撞色。 */
export function piePalette(n: number): string[] {
const c = chartTheme()
const base = [c.a, c.b, c.warn, c.ok, c.primary, c.muted2]
return Array.from({ length: Math.max(n, 1) }, (_, i) => base[i % base.length])
}
/** 空数据时环形图也得画个灰圈,别留白块。
* 空态那一项只报名字(「暂无数据」),别拼成「暂无数据: 1」这种看着像真数据的怪文案。 */
export function pieData(items: { name: string; value: number }[], emptyLabel = '暂无数据') {
if (items.length) {
const colors = piePalette(items.length)
return items.map((it, i) => ({ ...it, itemStyle: { color: colors[i] } }))
}
const c = chartTheme()
return [{
name: emptyLabel,
value: 1,
itemStyle: { color: c.line },
// 逐项覆盖:不显示数值、不画引导线,纯占位
label: { show: true, formatter: emptyLabel, color: c.muted },
labelLine: { show: false },
}]
}
+134
View File
@@ -0,0 +1,134 @@
// M2: 对话 Playground —— 流式 / 非流式调用网关 /v1/chat/completions。
// 同源请求,带会话 Bearer;流式用 fetch + body reader 直接解析 SSE。
import { getToken } from '../api'
export interface Meta {
served: string
provider: string
requested: string
fallback: boolean
}
export interface Usage {
prompt_tokens?: number
completion_tokens?: number
total_tokens?: number
}
export interface ChatMessage {
id: number
role: 'user' | 'assistant'
content: string
images?: string[] // 第十一轮 #3:随该条用户消息附带的图片(URL 或 data URI)
imgNames?: string[] // 第十三轮:图片文件名(展示用,data URI 看不出来源)
imgThumbs?: string[] // 第十三轮:缩略图 data URI —— 落服务端历史时用它替代原图
// (服务端单条 512KB,原图 base64 会被截断成坏图)
reasoning?: string // 推理内容(reasoning_content),单独折叠展示
meta?: Meta // 网关元信息(served/provider/fallback)
usage?: Usage
cost?: number // estimated_cost_cny(仅非流式)
streaming?: boolean // 正在流式输出中
error?: string
}
let idSeq = 1
export function nextId(): number { return idSeq++ }
export function seekId(maxId: number): void { idSeq = maxId + 1 }
export interface HistItem {
role: string
content: string
images?: string[]
}
/** 组装给网关的 messages(system 前缀 + 历史 user/assistant 正文;推理不随历史发送)。
* 带 images 的用户消息会发成 OpenAI 视觉格式:content=[{type:text},{type:image_url,...}]。 */
export function buildPayloadMessages(
system: string,
history: HistItem[],
): { role: string; content: any }[] {
const out: { role: string; content: any }[] = []
if (system && system.trim()) out.push({ role: 'system', content: system })
for (const m of history) {
const imgs = (m.images || []).filter(Boolean)
if (!m.content && !imgs.length) continue
if (imgs.length) {
const parts: any[] = []
if (m.content) parts.push({ type: 'text', text: m.content })
for (const url of imgs) parts.push({ type: 'image_url', image_url: { url } })
out.push({ role: m.role, content: parts })
} else {
out.push({ role: m.role, content: m.content })
}
}
return out
}
/** 分块解析 SSE,回调每个 data 事件。返回被 [DONE] 或流结束决定的结果。 */
export async function streamChat(
payload: Record<string, any>,
onChunk: (chunk: any) => void,
signal?: AbortSignal,
): Promise<void> {
const token = getToken()
const headers: Record<string, string> = { 'Content-Type': 'application/json' }
if (token) headers['Authorization'] = `Bearer ${token}`
const resp = await fetch('/v1/chat/completions', {
method: 'POST',
headers,
body: JSON.stringify(payload),
signal,
})
if (!resp.ok) {
let body: any = null
try { body = await resp.json() } catch { /* 不是 JSON */ }
const err: any = new Error((body && (body.detail?.message || body.detail)) || `HTTP ${resp.status}`)
err.status = resp.status
err.body = body
throw err
}
if (!resp.body) return
const reader = resp.body.getReader()
const decoder = new TextDecoder()
let buf = ''
for (;;) {
const { value, done } = await reader.read()
if (done) break
buf += decoder.decode(value, { stream: true })
let idx
while ((idx = buf.indexOf('\n\n')) !== -1) {
const frame = buf.slice(0, idx)
buf = buf.slice(idx + 2)
for (const line of frame.split('\n')) {
if (!line.startsWith('data: ')) continue
const data = line.slice(6)
if (data.trim() === '[DONE]') return
let chunk: any
try { chunk = JSON.parse(data) } catch { continue }
onChunk(chunk)
}
}
}
}
/** 非流式:直接拿完整对象。 */
export async function chatOnce(payload: Record<string, any>): Promise<any> {
const token = getToken()
const headers: Record<string, string> = { 'Content-Type': 'application/json' }
if (token) headers['Authorization'] = `Bearer ${token}`
const resp = await fetch('/v1/chat/completions', {
method: 'POST',
headers,
body: JSON.stringify(payload),
})
let body: any = null
try { body = await resp.json() } catch { /* 忽略 */ }
if (!resp.ok) {
const err: any = new Error((body && (body.detail?.message || body.detail)) || `HTTP ${resp.status}`)
err.status = resp.status
err.body = body
throw err
}
return body
}
+143
View File
@@ -0,0 +1,143 @@
// M6: 生成图片/视频的「下载」。
//
// 为什么要绕后端一圈(而不是 `<a :href="src" download>`):
// 生成产物挂在第三方 CDN 上(如 cos-platform-outputs.agnes-ai.cn),该 CDN
// **不返回 CORS 头**,于是浏览器里两条直链下载的路都堵死:
// 1) fetch(src) → blob 被跨域拦(拿不到字节,自己造不了 Blob 下载);
// 2) `<a href="跨域 URL" download>`:HTML 规范里 download 属性对跨域地址无效 ——
// 点下去只会"新标签页打开",不是存文件(手机端最明显)。
// 所以走同源的 /v1/media/download,由网关代拉并补 Content-Disposition,
// 前端拿 blob 自己触发保存。只有"要不要下载"是前端的事,"能不能拉到"交给后端。
import { getToken } from '../api'
/** 服务端代下载端点(与网关同源)。 */
const DL_PATH = '/v1/media/download'
/** 从 Content-Disposition 里取文件名(优先 RFC 5987 的 filename*,它支持中文)。 */
export function filenameFromHeader(cd: string): string {
if (!cd) return ''
const star = /filename\*\s*=\s*UTF-8''([^;]+)/i.exec(cd)
if (star && star[1]) {
try { return decodeURIComponent(star[1].trim().replace(/^"|"$/g, '')) } catch { /* 落下面兜底 */ }
}
const plain = /filename\s*=\s*"([^"]*)"/i.exec(cd) || /filename\s*=\s*([^;]+)/i.exec(cd)
return plain && plain[1] ? plain[1].trim() : ''
}
/**
* data:URI → Blob(不经过 fetch)。
*
* 为什么不用 `fetch(dataURI)`:CSP 是 `connect-src 'self'`,data: 不在白名单里,
* fetch 会被浏览器直接拦掉(前端只看到「下载失败」)。解码 base64 属于纯计算,
* 不触网,也就不受 CSP 约束 —— 顺便离线也能用。
*/
export function dataUriToBlob(src: string): Blob {
const m = /^data:([^,]*),([\s\S]*)$/i.exec(src)
if (!m) throw new Error('bad data URI')
const header = m[1] || ''
const body = m[2] || ''
const semi = header.indexOf(';')
const mime = (semi === -1 ? header : header.slice(0, semi)) || 'application/octet-stream'
if (/;base64/i.test(header)) {
const bin = atob(body.replace(/\s+/g, ''))
const bytes = new Uint8Array(bin.length)
for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
return new Blob([bytes], { type: mime })
}
try {
return new Blob([decodeURIComponent(body)], { type: mime })
} catch {
return new Blob([body], { type: mime }) // 百分号残缺就按原样存,别把下载搞崩
}
}
/** data:URI 的 MIME → 扩展名(本地/上游直回 base64 的图走这条路)。 */
function dataExt(src: string): string {
const m = /^data:([a-z0-9.+/-]+)/i.exec(src)
const map: Record<string, string> = {
'image/png': '.png', 'image/jpeg': '.jpg', 'image/webp': '.webp', 'image/gif': '.gif',
'video/mp4': '.mp4', 'video/webm': '.webm', 'video/quicktime': '.mov',
}
return (m && map[m[1].toLowerCase()]) || ''
}
/** 兜底文件名:从 URL 末段取(带 query 的地址会退化到 `media-<时间戳>`)。 */
function fallbackName(src: string, prefix: string): string {
const ext = dataExt(src)
if (ext) return `${prefix}-${stamp()}${ext}`
const tail = (src.split('?')[0] || '').split('#')[0].split('/').pop() || ''
if (tail && /\.[a-z0-9]{2,5}$/i.test(tail)) return tail.slice(-120)
return `${prefix}-${stamp()}.bin`
}
/** yyyyMMdd-HHmm(本地时区),用来区分同名下载。 */
export function stamp(d = new Date()): string {
const p = (n: number) => String(n).padStart(2, '0')
return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}`
}
/** 用提示词做文件名前缀:先截断再抹掉斜杠等路径成分(避免落盘时被当目录)。 */
export function nameFromPrompt(prompt: string, fallback = 'media', max = 24): string {
const s = (prompt || '').replace(/[\r\n\t]+/g, ' ').replace(/[\\/:*?"<>|]+/g, ' ').trim()
const cut = s.slice(0, max).trim()
return cut || fallback
}
/** 触发浏览器保存一个 blob(同源 blob: URL,download 属性一定生效)。 */
function saveBlob(blob: Blob, name: string): void {
const href = URL.createObjectURL(blob)
const a = document.createElement('a')
a.href = href
a.download = name || 'download'
a.style.display = 'none'
document.body.appendChild(a)
a.click()
a.remove()
// 立刻 revoke 在部分浏览器(Safari/Firefox)会打断尚未开始的保存,延后回收。
setTimeout(() => URL.revokeObjectURL(href), 10_000)
}
/**
* 下载一个生成出来的图片/视频。
*
* @param src 产物地址:http(s)(走后端代拉)或 data:(浏览器内直接存)
* @param name 期望文件名(不含后缀也行,后端按 Content-Type 补);
* 实际落盘名以服务端 Content-Disposition 为准
* @throws Error 带上后端给的人话原因(白名单/失效/超限…),交给调用方弹提示
*/
export async function downloadMedia(src: string, name = ''): Promise<void> {
if (!src) throw new Error('empty media src')
if (src.startsWith('data:')) {
// data URI 不出网、也不该绕后端:本地解码成 blob 直接存(离线也能下载;
// 注意不能用 fetch —— CSP 的 connect-src 'self' 会把它拦掉,见 dataUriToBlob)
const base = name || `media-${stamp()}`
saveBlob(dataUriToBlob(src), base.includes('.') ? base : base + dataExt(src))
return
}
const q = new URLSearchParams({ url: src })
if (name) q.set('filename', name)
const headers: Record<string, string> = {}
const token = getToken()
if (token) headers['Authorization'] = `Bearer ${token}`
const resp = await fetch(`${DL_PATH}?${q.toString()}`, { headers })
if (!resp.ok) {
// 网关错误统一是 {"error":{"message": "..."}}(见 openai_compat_error)
let msg = `HTTP ${resp.status}`
try {
const body = await resp.json()
msg = (body && (body.error?.message || body.detail)) || msg
} catch { /* 非 JSON(如代理层 502 页面)就用状态码 */ }
if (resp.status === 401) {
window.dispatchEvent(new Event('gw-auth-expired')) // 会话过期 → 回登录页
}
throw new Error(msg)
}
const serverName = filenameFromHeader(resp.headers.get('content-disposition') || '')
const blob = await resp.blob()
saveBlob(blob, serverName || fallbackName(src, name || 'media'))
}
+28
View File
@@ -0,0 +1,28 @@
// M4: ECharts 按需注册(只引入用到的图表/组件,减小体积)。
import * as echarts from 'echarts/core'
import { BarChart, LineChart, PieChart } from 'echarts/charts'
import {
GridComponent,
TooltipComponent,
LegendComponent,
TitleComponent,
DataZoomComponent,
GraphicComponent, // 空数据的「暂无数据」提示靠它画(不注册的话 graphic 会被静默丢掉)
} from 'echarts/components'
import { CanvasRenderer } from 'echarts/renderers'
echarts.use([
BarChart,
LineChart,
PieChart,
GridComponent,
TooltipComponent,
LegendComponent,
TitleComponent,
DataZoomComponent,
GraphicComponent,
CanvasRenderer,
])
export { echarts }
export type { EChartsCoreOption } from 'echarts/core'
+10
View File
@@ -0,0 +1,10 @@
// 功能开关(第二十三轮追加,老板 19:3x)
//
// 老板原话:「网关配置功能先不要删掉先隐藏起来,这块先不支持页面配置」。
// 所以这里**不是删功能**:`views/GatewayConfig.vue`、路由定义、中英文案、后端 `GET|PUT /config`
// 全部原样保留,只把下面这个开关关掉 ——
// ① 桌面侧栏与手机抽屉不出现「网关配置」入口(`lib/nav.ts`)
// ② 设置页那颗「打开配置页」按钮不渲染(`views/Settings.vue`)
// ③ 直接手敲 / 地址栏输入 `#/gateway-config` 会被路由守卫送回仪表盘(`router.ts`)
// 恢复 = 把这一行改成 `true`,三个入口同时回来(后端接口本来就没停)。
export const GATEWAY_CONFIG_ENABLED = true // 老板 2026-09-15 重新开放:整页 YAML 编辑器 + API Key 环境变量管理
+123
View File
@@ -0,0 +1,123 @@
// 第二十二轮:意见反馈的前端契约层。
//
// 分工:服务端存「正文 + 缩略图」,原图按需取(见后端 app/feedback.py 的说明)。
// 这里只做三件事:提交、取自己的、取全部(admin),以及取某张原图。
import { api } from '../api'
import { PRESETS, assertBodyBudget, pickImage, type PickedMedia } from './upload'
/** 一条反馈最多几张图(与服务端 MAX_IMAGES 必须一致,改一处就得改两处)。 */
export const FEEDBACK_MAX_IMAGES = 3
/** 处理进度三档,顺序即流程顺序(与服务端 STATUSES 一致)。 */
export const FEEDBACK_STATUSES = ['pending', 'doing', 'done'] as const
export type FeedbackStatus = (typeof FEEDBACK_STATUSES)[number]
/** i18n 后缀:t(`fbStatus.${s}`) */
export const FEEDBACK_STATUS_CLASS: Record<FeedbackStatus, string> = {
pending: 'o', // 待处理:橙色,需要有人看一眼
doing: 'p', // 处理中:主题色
done: 'g', // 已处理:绿色
}
export interface FeedbackImage {
name: string
bytes: number
/** 缩略图 data URI(服务端内嵌返回);空串表示没有预览图 */
thumb: string
type?: string
}
/** 一条处理记录:谁(by)在什么时候(ts)把它从 from 改到 to,留了什么说明(note)。
* `from` 为空串表示「提交」那一步(没有前一个状态)。 */
export interface FeedbackStep {
ts: number
from: string
to: FeedbackStatus
note: string
by: string
}
export interface FeedbackItem {
id: string
account: string
content: string
/** epoch 秒(与日志/用户页的时间口径一致) */
created: number
images: FeedbackImage[]
/** 处理进度:pending / doing / done */
status: FeedbackStatus
/** 最新一条处理说明(提交人可见,可为空) */
note: string
/** 最后一次改状态的时间(epoch 秒) */
updated: number
/** 处理记录:提交 + 每一次状态变更,old → new,只增不改(服务端最多留 50 条) */
history: FeedbackStep[]
/** 管理员归档标记:收件箱「归档/取消归档」,不影响提交人视角 */
archived?: boolean
}
export interface FeedbackDraft {
content: string
images: PickedMedia[]
}
/** 图片 → data URI(自动压缩到反馈档位)。缩略图由 pickImage 一并生成(256px,列表够用)。 */
export function pickFeedbackImage(file: File): Promise<PickedMedia> {
return pickImage(file, PRESETS.feedback)
}
export async function submitFeedback(draft: FeedbackDraft): Promise<FeedbackItem> {
const images = draft.images.map((m) => ({ uri: m.uri, thumb: m.thumb, name: m.name }))
// 提交前的整包预算:宁可在这里给一句人话,也不要让浏览器吃到 Nginx 的 413
assertBodyBudget([draft.content, ...images.flatMap((i) => [i.uri, i.thumb])])
const r = await api('/feedback', {
method: 'POST',
body: JSON.stringify({ content: draft.content, images }),
})
return r.item as FeedbackItem
}
export async function myFeedback(): Promise<FeedbackItem[]> {
const r = await api('/feedback/mine')
return (r.items || []) as FeedbackItem[]
}
export async function allFeedback(): Promise<FeedbackItem[]> {
const r = await api('/feedback')
return (r.items || []) as FeedbackItem[]
}
/** 管理员更新处理进度(status + 可选处理说明);提交人会看到同样的状态。 */
export async function updateFeedback(
fid: string, status: FeedbackStatus, note: string,
): Promise<FeedbackItem> {
const r = await api(`/feedback/${encodeURIComponent(fid)}`, {
method: 'PATCH',
body: JSON.stringify({ status, note }),
})
return r.item as FeedbackItem
}
/**
* 撤回自己提交的反馈(连服务端的图片文件一起删)。
* 只对「待处理」的单子有用 —— 管理员一动手(处理中/已处理)服务端会 400。
*/
export async function withdrawFeedback(fid: string): Promise<void> {
await api(`/feedback/${encodeURIComponent(fid)}`, { method: 'DELETE' })
}
export async function archiveFeedback(fid: string, archived: boolean): Promise<FeedbackItem> {
const r = await api(`/feedback/${encodeURIComponent(fid)}/archive`, {
method: 'PATCH',
body: JSON.stringify({ archived }),
})
return r.item as FeedbackItem
}
export async function adminDeleteFeedback(fid: string): Promise<void> {
await api(`/feedback/${encodeURIComponent(fid)}`, { method: 'DELETE' })
}
/** 取某条反馈第 idx 张原图(返回 data URI;权限由服务端判:本人或 admin)。 */
export async function feedbackImage(fid: string, idx: number): Promise<string> {
const r = await api(`/feedback/media/${encodeURIComponent(fid)}/${idx}`)
return String(r.uri || '')
}
+56
View File
@@ -0,0 +1,56 @@
// 服务端历史(图像 / 视频 / 对话)读写封装。
//
// 为什么要这一层:三类历史原先只存在浏览器里,图像/视频在 localStorage、对话在
// sessionStorage —— 换设备看不见、关标签页就丢,而且 `setItem` 抛异常(配额写满)
// 被 `catch {}` 静默吞掉,用户看到的就是"我生成过的东西没了"。
// 现在以服务端 data/history.json 为准(按账号隔离、按 id upsert),本地只留一份缓存。
//
// 约定:**所有失败都要冒泡给调用方去提示**,不再静默丢数据。
import { api } from '../api'
export type HistoryKind = 'chat' | 'images' | 'videos'
/** 拉取本账号某类别的历史;后端不可用时返回 null(调用方回落到本地缓存)。 */
export async function pullHistory(kind: HistoryKind): Promise<any[] | null> {
try {
const j = await api(`/history/${kind}`)
return Array.isArray(j.items) ? j.items : []
} catch {
return null
}
}
/** 按 id upsert 提交(整份或增量都行);返回 false 表示没存上,调用方要提示。 */
export async function pushHistory(kind: HistoryKind, items: any[]): Promise<boolean> {
try {
await api(`/history/${kind}`, { method: 'POST', body: JSON.stringify({ items }) })
return true
} catch {
return false
}
}
export async function deleteHistoryItem(kind: HistoryKind, id: string | number): Promise<boolean> {
try {
await api(`/history/${kind}/${encodeURIComponent(String(id))}`, { method: 'DELETE' })
return true
} catch {
return false
}
}
export async function clearHistory(kind: HistoryKind): Promise<boolean> {
try {
await api(`/history/${kind}`, { method: 'DELETE' })
return true
} catch {
return false
}
}
/** 给没有 id 的旧本地数据补一个稳定 id(迁移用,别让 upsert 把它们当新条目反复插)。 */
export function ensureIds(items: any[], prefix: string): any[] {
return items.map((it, i) => (it && it.id !== undefined && it.id !== null
? it
: { ...it, id: `${prefix}-${i}-${it?.ts ?? it?.started ?? it?.created ?? Date.now()}` }))
}
+44
View File
@@ -0,0 +1,44 @@
// M2/M5: Markdown 渲染 + 代码高亮 + XSS 消毒。
// 模型输出是不可信内容,必须经 DOMPurify 消毒后再 v-html 注入。
// M5: highlight.js 由「全量 import」改为 core + 按需注册语言,主包体积显著下降。
import { Marked } from 'marked'
import { markedHighlight } from 'marked-highlight'
import hljs from 'highlight.js/lib/core'
import DOMPurify from 'dompurify'
import python from 'highlight.js/lib/languages/python'
import javascript from 'highlight.js/lib/languages/javascript'
import typescript from 'highlight.js/lib/languages/typescript'
import bash from 'highlight.js/lib/languages/bash'
import json from 'highlight.js/lib/languages/json'
import xml from 'highlight.js/lib/languages/xml'
import css from 'highlight.js/lib/languages/css'
import markdown from 'highlight.js/lib/languages/markdown'
import sql from 'highlight.js/lib/languages/sql'
import yaml from 'highlight.js/lib/languages/yaml'
import rust from 'highlight.js/lib/languages/rust'
import go from 'highlight.js/lib/languages/go'
import java from 'highlight.js/lib/languages/java'
import cpp from 'highlight.js/lib/languages/cpp'
import c from 'highlight.js/lib/languages/c'
const langs: Record<string, any> = {
python, javascript, typescript, bash, json, xml, css, markdown, sql, yaml, rust, go, java, cpp, c,
}
for (const [name, reg] of Object.entries(langs)) hljs.registerLanguage(name, reg)
const md = new Marked(
markedHighlight({
langPrefix: 'hljs language-',
highlight(code: string, lang: string) {
const l = lang && hljs.getLanguage(lang) ? lang : 'plaintext'
return hljs.highlight(code, { language: l }).value
},
}),
{ gfm: true, breaks: true },
)
/** 把 markdown 渲染成已消毒的 HTML(安全地用于 v-html)。 */
export function renderMarkdown(src: string): string {
return DOMPurify.sanitize(md.parse(src || '') as string)
}
+44
View File
@@ -0,0 +1,44 @@
// M3: 媒体(图像/视频)通用工具。
/** 从图像 data 项里解析可显示的 src(url / base64 / data:URI 均可)。 */
export function imageSrc(item: any): string {
if (!item) return ''
if (item.url) return item.url
if (item.b64_json) return 'data:image/png;base64,' + item.b64_json
if (item.data_url) return item.data_url
if (typeof item.data === 'string') {
if (item.data.startsWith('data:')) return item.data
return 'data:image/png;base64,' + item.data
}
return ''
}
function looksLikeVideo(s: string): boolean {
return /\.(mp4|webm|ogg|m3u8|mov)(\?|#|$)/i.test(s)
}
/** 从视频轮询返回的 raw 对象里尽量找出视频播放地址(按常见键优先,再递归兜底)。 */
export function findVideoUrl(obj: any): string {
if (!obj) return ''
if (typeof obj === 'string') return looksLikeVideo(obj) ? obj : ''
if (Array.isArray(obj)) {
for (const o of obj) { const u = findVideoUrl(o); if (u) return u }
return ''
}
if (typeof obj === 'object') {
for (const k of ['video_url', 'play_url', 'url', 'html_url', 'video', 'media_url', 'result', 'data', 'mp4']) {
if (k in obj) { const u = findVideoUrl(obj[k]); if (u) return u }
}
for (const v of Object.values(obj)) { const u = findVideoUrl(v); if (u) return u }
}
return ''
}
/** 状态文案归类(completed/succeeded=成功;failed/failed=失败;其余为等待)。 */
export function videoStatusKind(s: string): 'done' | 'fail' | 'pending' {
if (!s) return 'pending'
const t = String(s).toLowerCase()
if (['completed', 'succeeded', 'success'].includes(t)) return 'done'
if (['failed', 'fail', 'error'].includes(t)) return 'fail'
return 'pending'
}
+60
View File
@@ -0,0 +1,60 @@
// 导航结构单一来源:桌面侧栏、手机抽屉、手机底部 Tab 都从这里取,
// 避免菜单项加一个地方漏一个地方。分组顺序与设计稿 v2 一致。
import { GATEWAY_CONFIG_ENABLED } from './features'
export interface NavItem {
path: string
/** i18n key 后缀:t(`nav.menu${key}`) */
key: string
/** Icon.vue 里的图标名 */
icon: string
}
export interface NavGroup {
id: string
items: NavItem[]
}
/** 桌面侧栏 / 手机抽屉的完整菜单(按功能分组,组间一条分隔线)。 */
export function navGroups(isAdmin: boolean): NavGroup[] {
const groups: NavGroup[] = [
{
id: 'core',
items: [
{ path: '/dashboard', key: 'dashboard', icon: 'dash' },
{ path: '/chat', key: 'chat', icon: 'chat' },
{ path: '/images', key: 'images', icon: 'img' },
{ path: '/videos', key: 'videos', icon: 'vid' },
],
},
{
id: 'ops',
items: [
{ path: '/models', key: 'models', icon: 'model' },
{ path: '/metrics', key: 'metrics', icon: 'metric' },
{ path: '/keys', key: 'keys', icon: 'key' },
],
},
]
const sys: NavItem[] = []
// 第二十二轮定稿:管理员只处理反馈(「用户反馈」),不提意见 —— 所以这两项互斥。
if (isAdmin) sys.push({ path: '/users', key: 'users', icon: 'users' })
if (isAdmin) sys.push({ path: '/feedback-inbox', key: 'feedbackinbox', icon: 'inbox' })
// 第二十三轮追加:老板要求「网关配置先不要删掉、先隐藏起来,这块先不支持页面配置」→
// 入口由 `lib/features.ts` 的开关统一控制(页面与路由都还在,只是不挂出来)。
if (isAdmin && GATEWAY_CONFIG_ENABLED) sys.push({ path: '/gateway-config', key: 'gatewaycfg', icon: 'sliders' })
sys.push({ path: '/logs', key: 'logs', icon: 'log' })
if (!isAdmin) sys.push({ path: '/feedback', key: 'feedback', icon: 'bulb' })
sys.push({ path: '/settings', key: 'settings', icon: 'set' })
groups.push({ id: 'sys', items: sys })
return groups
}
/** 手机底部 Tab:四个主功能 + 「更多」(抽屉里是完整菜单)。 */
export const MOBILE_TABS: NavItem[] = [
{ path: '/dashboard', key: 'dashboard', icon: 'dash' },
{ path: '/chat', key: 'chat', icon: 'chat' },
{ path: '/images', key: 'images', icon: 'img' },
{ path: '/videos', key: 'videos', icon: 'vid' },
]
+26
View File
@@ -0,0 +1,26 @@
// 设置页工具层 —— 对话默认参数,统一读写 localStorage。
// 注:主题(A/B/C + 跟随系统)已独立到 lib/theme.ts;这里只管参数。
export interface ChatDefaults {
model?: string
temperature?: number
top_p?: number
max_tokens?: number | null
stream?: boolean
system?: string
}
const DEFAULTS_KEY = 'gw_chat_defaults'
export function getChatDefaults(): ChatDefaults {
try {
const raw = localStorage.getItem(DEFAULTS_KEY)
return raw ? (JSON.parse(raw) as ChatDefaults) : {}
} catch {
return {}
}
}
export function setChatDefaults(d: ChatDefaults): void {
localStorage.setItem(DEFAULTS_KEY, JSON.stringify(d))
}
+126
View File
@@ -0,0 +1,126 @@
// 主题管理(前端重设计 v2)。
//
// 口径:一套结构 + 三套 token。切主题只改 <html data-theme>,页面代码零改动。
// A 深空蓝(深色)· B 素白蓝紫(浅色,默认)· C 暖砂墨绿(浅色暖调)
//
// 为什么还要切 <html class="dark">:
// Element Plus 的弹层/表单深度配色由 dark/css-vars.css(html.dark)驱动,
// A 是深色皮肤,必须同时打开这个开关;B/C 关掉。
// 两者不冲突 —— 具体的 --el-* 值在 style.css 里由 :root[data-theme] 覆盖。
//
// 「跟随系统深色模式」:系统切深色时自动用 A,切回浅色时用用户选的主题。
import { computed, ref } from 'vue'
export type ThemeId = 'A' | 'B' | 'C'
export const THEME_IDS: ThemeId[] = ['A', 'B', 'C']
/** 默认皮肤:B 素白蓝紫(老板拍板) */
export const DEFAULT_THEME: ThemeId = 'B'
const THEME_KEY = 'gw_theme_v2'
const FOLLOW_KEY = 'gw_follow_system'
const LEGACY_KEY = 'gw_theme' // 旧版只存 light / dark
const DARK_QUERY = '(prefers-color-scheme: dark)'
function readThemeId(): ThemeId {
try {
const v = localStorage.getItem(THEME_KEY)
if (v === 'A' || v === 'B' || v === 'C') return v
// 老用户的偏好迁移:深色 → A,浅色 → B(新默认)
const legacy = localStorage.getItem(LEGACY_KEY)
if (legacy === 'dark') return 'A'
return DEFAULT_THEME
} catch {
return DEFAULT_THEME
}
}
function readFollow(): boolean {
try {
return localStorage.getItem(FOLLOW_KEY) === '1'
} catch {
return false
}
}
function systemPrefersDark(): boolean {
if (typeof window === 'undefined' || !window.matchMedia) return false
return window.matchMedia(DARK_QUERY).matches
}
// 模块级单例:顶栏调色盘、设置页主题卡、手机「更多」抽屉三处共用同一份状态
const themeId = ref<ThemeId>(readThemeId())
const followSystem = ref<boolean>(readFollow())
const systemDark = ref<boolean>(systemPrefersDark())
/** 实际生效的皮肤(跟随系统时可能是 A) */
const resolved = computed<ThemeId>(() => (followSystem.value && systemDark.value ? 'A' : themeId.value))
/** 把当前皮肤写进 <html>:data-theme 喂自定义 token,dark class 喂 Element Plus */
function apply(): void {
const id = resolved.value
const root = document.documentElement
root.setAttribute('data-theme', id)
root.classList.toggle('dark', id === 'A')
}
let started = false
/** 在 mount 前调用一次:立即上色 + 监听系统深浅色变化(避免闪白/闪黑)。 */
export function initTheme(): void {
try {
apply()
} catch { /* 忽略 */ }
if (started || typeof window === 'undefined' || !window.matchMedia) return
started = true
const mql = window.matchMedia(DARK_QUERY)
const onChange = (e: MediaQueryListEvent) => {
systemDark.value = e.matches
apply()
}
if (typeof mql.addEventListener === 'function') mql.addEventListener('change', onChange)
else mql.addListener(onChange)
}
export function getThemeId(): ThemeId {
return themeId.value
}
export function setThemeId(id: ThemeId): void {
themeId.value = id
try {
localStorage.setItem(THEME_KEY, id)
} catch { /* 忽略 */ }
apply()
}
export function isFollowSystem(): boolean {
return followSystem.value
}
export function setFollowSystem(on: boolean): void {
followSystem.value = on
try {
localStorage.setItem(FOLLOW_KEY, on ? '1' : '0')
} catch { /* 忽略 */ }
apply()
}
/** 组件里用的响应式主题状态。 */
export function useTheme() {
return {
theme: computed(() => themeId.value),
resolved,
followSystem: computed(() => followSystem.value),
setTheme: setThemeId,
setFollowSystem,
}
}
// 名称/说明走 i18n(key 见 locales/zh.ts · theme.nameA 等):换语言时皮肤名跟着变,
// 这里只留「结构色值」——那些是设计常量,不该被翻译。
export const THEME_META: Record<ThemeId, { nameKey: string; descKey: string; side: string; canvas: string; accent: string }> = {
B: { nameKey: 'theme.nameB', descKey: 'theme.descB', side: '#FFFFFF', canvas: '#F4F6FB', accent: '#4F63F5' },
A: { nameKey: 'theme.nameA', descKey: 'theme.descA', side: '#121B2C', canvas: '#0A101E', accent: '#35D0BA' },
C: { nameKey: 'theme.nameC', descKey: 'theme.descC', side: '#FFFFFF', canvas: '#F8F4EF', accent: '#0E7C6B' },
}
+32
View File
@@ -0,0 +1,32 @@
// 移动端适配的单一断点来源。
//
// 为什么用 matchMedia 而不是监听 resize 比 innerWidth:
// 平板转屏、桌面浏览器缩放都能可靠触发,且与 style.css 里的
// @media (max-width: 768px) 天然对齐 —— 样式断点交给 CSS,
// 「侧栏 vs 抽屉」这类**结构**切换才需要 JS。改断点时两处必须一起改。
import { onUnmounted, ref } from 'vue'
export const MOBILE_MAX = 768
const QUERY = `(max-width: ${MOBILE_MAX}px)`
/** 响应式「是否窄屏」。组件卸载时自动摘掉监听。 */
export function useIsMobile() {
const isMobile = ref(typeof window !== 'undefined' && !!window.matchMedia
? window.matchMedia(QUERY).matches
: false)
if (typeof window === 'undefined' || !window.matchMedia) return { isMobile }
const mql = window.matchMedia(QUERY)
const onChange = (e: MediaQueryListEvent) => { isMobile.value = e.matches }
if (typeof mql.addEventListener === 'function') {
mql.addEventListener('change', onChange)
onUnmounted(() => mql.removeEventListener('change', onChange))
} else {
// Safari < 14 只有已废弃的 addListener
const legacy = mql as unknown as { addListener(cb: (e: MediaQueryListEvent) => void): void; removeListener(cb: (e: MediaQueryListEvent) => void): void }
legacy.addListener(onChange)
onUnmounted(() => legacy.removeListener(onChange))
}
return { isMobile }
}
+221
View File
@@ -0,0 +1,221 @@
// 第十三轮: 页面端「上传图片 / 音频 → data URI」工具。
//
// 为什么不上传到服务端再拿公网 URL?
// Agnes 要求素材能被它公开访问,但实测它同样接受 `data:image/png;base64,...` /
// `data:audio/wav;base64,...`(图像生成、视频 keyframe/reference、对话视觉三条路径都跑通过)。
// 浏览器端直接转 data URI 是最短路径:不落盘、不占公网带宽、也不用新增上传端点与临时文件清理。
//
// 但**必须压缩**:网关注入体上限 2MB(server.max_body_size),Nginx 也是 client_max_body_size 2m,
// 而 base64 会把体积再放大 4/3。手机随手拍的 3~5MB 照片直接转 base64 只会换来一个 413。
// 所以这里按用途分级压缩 + 逐级降档,并在提交前做「整包体积」预算检查。
/** 网关 Nginx / 应用层的请求体上限(字节),留一点余量给 prompt 与 JSON 结构。 */
export const BODY_BUDGET = 1_700_000
export interface MediaPreset {
/** 长边上限(像素) */
maxSide: number
/** JPEG 质量 */
quality: number
/** 单件 data URI 目标上限(字节) */
maxBytes: number
label: string
}
/** 各用途的压缩档位。数值来自实测:1024px/q0.82 的普通照片约 150~300KB(base64 后 ×1.37)。 */
export const PRESETS: Record<string, MediaPreset> = {
// 对话视觉:给模型看的,1024px 足够(再大也只会烧 token)
chat: { maxSide: 1024, quality: 0.8, maxBytes: 500_000, label: '对话附图' },
// 图生图 / 多图合成:保留构图细节
ref: { maxSide: 1024, quality: 0.85, maxBytes: 500_000, label: '参考图' },
// 视频首/尾帧:画面直接进视频,给到 1280px
frame: { maxSide: 1280, quality: 0.85, maxBytes: 450_000, label: '首/尾帧' },
// 视频参考图:最多 5 张,单件必须小(5 × 300KB ≈ 1.5MB,逼近 2MB 上限)
videoRef: { maxSide: 1024, quality: 0.8, maxBytes: 300_000, label: '视频参考图' },
// 视频参考音频:无浏览器端压缩手段,只能卡体积(最多 3 段)
audio: { maxSide: 0, quality: 0, maxBytes: 420_000, label: '参考音频' },
// 第二十二轮 意见反馈附图:一条最多 3 张,管理员要在电脑上看清细节,给到 1280px;
// 但整包(3 张 + 缩略图)必须落在网关/Nginx 的 2MB 上限内,所以单张卡 400KB。
feedback: { maxSide: 1280, quality: 0.8, maxBytes: 400_000, label: '反馈图片' },
}
export interface PickedMedia {
/** 原始文件名(用于卡片/标签展示) */
name: string
kind: 'image' | 'audio'
/** 直接塞进请求体的 data URI */
uri: string
/** 压成缩略图后的 data URI(对话历史只存这个,避免把历史文件撑爆) */
thumb: string
/** data URI 的字节数(base64 长度换算) */
bytes: number
/** 压缩后的像素尺寸(图片才有) */
width?: number
height?: number
/** 是否做过有损压缩(用于提示用户"已压缩") */
compressed: boolean
}
const AUDIO_EXT = ['mp3', 'wav', 'm4a', 'aac', 'ogg', 'oga', 'flac', 'opus', 'webm']
/** base64 data URI 的实际字节数(4 个 base64 字符 = 3 字节)。 */
export function dataUriBytes(uri: string): number {
const i = uri.indexOf(',')
if (i < 0) return uri.length
const b64 = uri.slice(i + 1)
const pad = b64.endsWith('==') ? 2 : b64.endsWith('=') ? 1 : 0
return Math.max(0, Math.floor((b64.length * 3) / 4) - pad)
}
export function formatBytes(n: number): string {
if (n < 1024) return `${n}B`
if (n < 1024 * 1024) return `${(n / 1024).toFixed(0)}KB`
return `${(n / 1024 / 1024).toFixed(2)}MB`
}
function extOf(name: string): string {
return (name.split('.').pop() || '').toLowerCase()
}
export function isAudioFile(f: File): boolean {
return (f.type || '').startsWith('audio/') || AUDIO_EXT.includes(extOf(f.name))
}
export function isImageFile(f: File): boolean {
if ((f.type || '').startsWith('image/')) return true
return ['png', 'jpg', 'jpeg', 'webp', 'gif', 'bmp'].includes(extOf(f.name))
}
function readAsDataUri(f: Blob): Promise<string> {
return new Promise((resolve, reject) => {
const fr = new FileReader()
fr.onerror = () => reject(new Error('读取文件失败'))
fr.onload = () => resolve(String(fr.result || ''))
fr.readAsDataURL(f)
})
}
async function loadBitmap(file: File): Promise<{ w: number; h: number; draw: CanvasImageSource; dispose: () => void }> {
// 优先 createImageBitmap(快、不占 DOM);老浏览器回落到 <img> + objectURL
if (typeof createImageBitmap === 'function') {
try {
const bmp = await createImageBitmap(file)
return { w: bmp.width, h: bmp.height, draw: bmp, dispose: () => bmp.close && bmp.close() }
} catch { /* 落到 <img> 分支(部分浏览器对某些格式不支持) */ }
}
const url = URL.createObjectURL(file)
try {
const img = await new Promise<HTMLImageElement>((resolve, reject) => {
const el = new Image()
el.onload = () => resolve(el)
el.onerror = () => reject(new Error('图片解码失败(格式不支持?)'))
el.src = url
})
return {
w: img.naturalWidth, h: img.naturalHeight, draw: img,
dispose: () => URL.revokeObjectURL(url),
}
} catch (e) {
URL.revokeObjectURL(url)
throw e
}
}
async function encodeCanvas(file: File, maxSide: number, quality: number): Promise<{
uri: string; width: number; height: number
}> {
const src = await loadBitmap(file)
try {
const scale = Math.min(1, maxSide / Math.max(src.w || 1, src.h || 1))
const w = Math.max(1, Math.round((src.w || 1) * scale))
const h = Math.max(1, Math.round((src.h || 1) * scale))
const cv = document.createElement('canvas')
cv.width = w
cv.height = h
const ctx = cv.getContext('2d')
if (!ctx) throw new Error('浏览器不支持 Canvas 2D,无法压缩图片')
// 白底:PNG 透明区转 JPEG 会变黑,铺一层白更接近原图观感
ctx.fillStyle = '#ffffff'
ctx.fillRect(0, 0, w, h)
ctx.drawImage(src.draw, 0, 0, w, h)
return { uri: cv.toDataURL('image/jpeg', quality), width: w, height: h }
} finally {
src.dispose()
}
}
/** 生成缩略图(对话历史、列表预览用)。失败时回落到原图,不阻断主流程。 */
export async function makeThumb(dataUri: string, maxSide = 256, quality = 0.6): Promise<string> {
try {
const blob = await (await fetch(dataUri)).blob()
const file = new File([blob], 'thumb.jpg', { type: blob.type || 'image/jpeg' })
return (await encodeCanvas(file, maxSide, quality)).uri
} catch {
return dataUri
}
}
/**
* 图片 → data URI(自动压缩到预设档位内)。
*
* 策略:文件本来就不大且是无损格式 → 原样用;否则画布重编码,并按
* 「原档 → 0.75×边长 → 0.5×边长」逐级降档,直到落进 maxBytes 预算。
*/
export async function pickImage(file: File, preset: MediaPreset): Promise<PickedMedia> {
if (!isImageFile(file)) throw new Error(`${file.name} 不是图片文件`)
const raw = await readAsDataUri(file)
// 小体积 PNG/WEBP 直接原样用(避免无谓的有损压缩,也保住透明通道)
if (raw.length <= preset.maxBytes && /png|webp|gif|bmp/i.test(file.type || extOf(file.name))) {
return {
name: file.name, kind: 'image', uri: raw, thumb: await makeThumb(raw),
bytes: raw.length, compressed: false,
}
}
const tries: Array<[number, number]> = [
[preset.maxSide, preset.quality],
[Math.round(preset.maxSide * 0.75), Math.max(0.5, preset.quality - 0.1)],
[Math.round(preset.maxSide * 0.5), 0.6],
[Math.round(preset.maxSide * 0.35), 0.5],
]
let last = ''
for (const [side, q] of tries) {
const enc = await encodeCanvas(file, side, q)
last = enc.uri
if (enc.uri.length <= preset.maxBytes) {
return {
name: file.name, kind: 'image', uri: enc.uri, thumb: await makeThumb(enc.uri),
bytes: enc.uri.length, width: enc.width, height: enc.height, compressed: true,
}
}
}
throw new Error(`${file.name} 压缩后仍有 ${formatBytes(dataUriBytes(last))},超过 ${preset.label} 单件上限 ${formatBytes(preset.maxBytes)}`)
}
/** 音频 → data URI(浏览器端无法重编码,只做体积与格式校验)。 */
export async function pickAudio(file: File, preset: MediaPreset = PRESETS.audio): Promise<PickedMedia> {
if (!isAudioFile(file)) throw new Error(`${file.name} 不是音频文件(支持 ${AUDIO_EXT.join('/')})`)
if (file.size > preset.maxBytes) {
throw new Error(`${file.name} 有 ${formatBytes(file.size)},超过参考音频上限 ${formatBytes(preset.maxBytes)}(请裁剪或压缩后再传)`)
}
const uri = await readAsDataUri(file)
return { name: file.name, kind: 'audio', uri, thumb: '', bytes: uri.length, compressed: false }
}
/** 按类型自动选择解析方式。 */
export async function pickMedia(file: File, preset: MediaPreset): Promise<PickedMedia> {
return isAudioFile(file) ? pickAudio(file, PRESETS.audio) : pickImage(file, preset)
}
/**
* 提交前的整包预算检查:素材 + 提示词必须落在网关/Nginx 的请求体上限内。
* 抛出可读错误(页面直接展示),而不是让浏览器拿到一个 413。
*/
export function assertBodyBudget(parts: Array<string | undefined>, extraBytes = 0): void {
const total = parts.reduce((n, p) => n + (p ? p.length : 0), 0) + extraBytes
if (total > BODY_BUDGET) {
throw new Error(
`本次请求体约 ${formatBytes(total)},超过网关上送上限(约 ${formatBytes(BODY_BUDGET)})。` +
'请减少素材数量,或换体积更小的图片/音频。',
)
}
}