/** * 会商「前端调用报错」上报器。 * * 服务端诊断只能记到「处理函数跑起来后抛的错」;而用户实际遇到的很多报错(nginx/网关 * 返回 502、网络中断、fetch 直接失败、SSE 里收到的 error 帧)发生在**客户端**侧。这里把 * 这些前端可观测到的报错 best-effort 上报到 `POST /api/roundtable-diagnostics/report` * (scope="client",非 admin 接口),便于管理员在诊断页统一筛选用户使用时的报错。 * * 设计:fire-and-forget + `keepalive`(页面跳转也能发出去)+ 绝不抛错(上报失败就算了, * 不能让「报错上报」本身再影响会商流程)。 */ import { apiFetch } from "@/core/api/fetch-client"; import { getBackendBaseURL } from "@/core/config"; export interface RoundtableErrorReport { stage: string; event: string; message: string; level?: "error" | "warning" | "info"; detail?: unknown; agentId?: string; agentName?: string; cycle?: number; draftId?: string; taskId?: string; jobId?: string; httpStatus?: number; } // 页面级上下文(draftId / taskId),由会商页设置,使每条上报都能归属到草稿/任务, // 而无需把它们穿进每个底层 api 调用。 let _ctx: { draftId?: string; taskId?: string } = {}; export function setRoundtableErrorContext(ctx: { draftId?: string; taskId?: string }): void { _ctx = { ..._ctx, ...ctx }; } /** 据 agentType + agentName 推断诊断 stage(与后端 `_stage_for_agent` 对齐)。 */ export function stageForRoundtableAgent( agentType: string | undefined, agentName: string | null | undefined, ): string { switch (agentName) { case "roundtable-report": return "step3_report"; case "roundtable-summary": return "step3_summary"; case "roundtable-dashboard": return "step3_dashboard"; case "roundtable-structure": return "step3_structure"; default: return agentType === "leader" ? "step2_leader" : "step2_seat"; } } export function reportRoundtableError(input: RoundtableErrorReport): void { try { const detail = input.httpStatus != null && typeof input.detail !== "object" ? { httpStatus: input.httpStatus, raw: input.detail } : input.httpStatus != null ? { httpStatus: input.httpStatus, ...(input.detail as Record) } : input.detail; const body = JSON.stringify({ stage: input.stage, event: input.event, level: input.level ?? "error", message: (input.message ?? "").slice(0, 2000), detail, jobId: input.jobId, draftId: input.draftId ?? _ctx.draftId, taskId: input.taskId ?? _ctx.taskId, agentId: input.agentId, agentName: input.agentName, cycle: input.cycle, }); void apiFetch(`${getBackendBaseURL()}/api/roundtable-diagnostics/report`, { method: "POST", headers: { "Content-Type": "application/json" }, body, keepalive: true, }).catch(() => { /* 上报失败静默 */ }); } catch { /* 绝不抛错 */ } }