@tbox.cn/app-template-agent 0.1.0 → 0.7.4

package/apps/client/src/components/ChatInput/index.tsx

@@ -27,6 +27,12 @@ const OPTION_ICONS: Record<PickKind, { icon: string; label: string }> = {
 
 const MENU_ANIMATION_MS = 250;
 
+/** 连接终态阻断（登录失败/scope 拒绝）：提示条 + 输入禁用 + 可选重试入口 */
+export interface ChatBlocked {
+  message: string;
+  onRetry?: () => void;
+}
+
 /** 媒体上传默认约束（分类型数量 + 单文件大小）。如需放开/收紧按业务改这里。 */
 const DEFAULT_MEDIA_CONFIG = {
   image: { maxCount: 9, maxSize: 10 * 1024 * 1024 },
@@ -38,12 +44,14 @@ const MEDIA_MAX_TOTAL = 9;
 /** 对话输入框（对齐原模板）：媒体预览 + 新对话 + 药丸[输入框/按住说话 + 语音切换 + 发送/“+”] + 动画选取菜单 + 免责声明。 */
 export function ChatInput({
   generating,
+  blocked,
   onSend,
   onCancel,
   onNewChat,
   disclaimer = '以上内容由AI生成，请谨慎甄别。',
 }: {
   generating?: boolean;
+  blocked?: ChatBlocked;
   onSend: (msg: ChatInputMessage) => void;
   onCancel?: () => void;
   onNewChat?: () => void;
@@ -64,14 +72,16 @@ export function ChatInput({
   const enableVideo = useChatConfigStore((s) => s.enableVideoUpload);
   const enableVoice = useChatConfigStore((s) => s.enableVoiceInput);
   const defaultInputMode = useChatConfigStore((s) => s.defaultInputMode);
-  const [inputMode, setInputMode] = useState<'text' | 'voice'>(
-    defaultInputMode === 'VOICE' && enableVoice ? 'voice' : 'text',
-  );
+  // 派生模式（禁 useState 捕获初值——水合晚到时服务端 defaultInputMode 进不了已捕获 state）：
+  // userMode=null 跟随默认（随水合重渲染更新）；显式值 = 用户手动切换优先
+  const [userMode, setUserMode] = useState<'text' | 'voice' | null>(null);
+  const inputMode: 'text' | 'voice' =
+    !enableVoice ? 'text' : userMode ?? (defaultInputMode === 'VOICE' ? 'voice' : 'text');
   const [menuVisible, setMenuVisible] = useState(false);
   const [menuAnimating, setMenuAnimating] = useState(false);
 
   const voice = useVoicePress({
-    disabled: generating,
+    disabled: generating || !!blocked,
     asr,
     onResult: (t) => onSend({ text: t, mediaItems: [], inputMethod: 'voice' }),
   });
@@ -128,7 +138,7 @@ export function ChatInput({
 
   useEffect(() => () => closeTimerRef.current && clearTimeout(closeTimerRef.current), []);
 
-  const canSend = !!(text.trim() || items.length > 0) && !uploading && inputMode === 'text';
+  const canSend = !!(text.trim() || items.length > 0) && !uploading && inputMode === 'text' && !blocked;
 
   const submit = () => {
     if (!canSend) return;
@@ -144,7 +154,10 @@ export function ChatInput({
     e.target.value = '';
   };
 
-  const toggleMode = () => setInputMode((m) => (m === 'text' ? 'voice' : 'text'));
+  const toggleMode = () => {
+    if (blocked) return;
+    setUserMode(inputMode === 'text' ? 'voice' : 'text');
+  };
 
   return (
     <div className="tbox-chat-input">
@@ -174,7 +187,7 @@ export function ChatInput({
 
           {inputMode === 'voice' ? (
             <VoicePressField
-              disabled={generating}
+              disabled={generating || !!blocked}
               interactionState={voice.interactionState}
               handlers={voice.handlers}
             />
@@ -182,8 +195,9 @@ export function ChatInput({
             <textarea
               className="tbox-chat-input__field"
               value={text}
-              placeholder="有什么需要问我的吗"
+              placeholder={blocked?.message ?? '有什么需要问我的吗'}
               rows={1}
+              disabled={!!blocked}
               onChange={(e) => setText(e.target.value)}
               onKeyDown={(e) => {
                 if (e.key === 'Enter' && !e.shiftKey) {
@@ -204,7 +218,7 @@ export function ChatInput({
             </div>
           )}
 
-          {generating ? (
+          {blocked ? null : generating ? (
             <div className="tbox-chat-input__send tbox-chat-input__send--active" onClick={onCancel}>
               <img className="tbox-chat-input__send-img" src={stopIcon} alt="停止" />
             </div>
@@ -223,6 +237,16 @@ export function ChatInput({
             </div>
           ) : null}
         </div>
+        {blocked && (
+          <div className="tbox-chat-input__blocked">
+            <span className="tbox-chat-input__blocked-msg">{blocked.message}</span>
+            {blocked.onRetry && (
+              <button type="button" className="tbox-chat-input__blocked-retry" onClick={blocked.onRetry}>
+                重试
+              </button>
+            )}
+          </div>
+        )}
       </div>
 
       {menuVisible && (

package/apps/client/src/components/ChatInput/voice/useVoicePress.ts

@@ -1,4 +1,4 @@
-import { useCallback, useRef, useState } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 import type { IASRAdapter } from '@tbox.cn/app-sdk/client';
 import { useRefreshSession } from '@tbox.cn/app-sdk/client';
 import { isSessionExpiredError } from '@/utils/session-error';
@@ -81,6 +81,8 @@ export function useVoicePress({
   const onTouchStart = useCallback(
     async (e: React.TouchEvent) => {
       if (disabled || !asr || recordingRef.current) return;
+      // 长按录音由应用接管，避免移动端浏览器启动原生选择/拖拽手势。
+      e.preventDefault();
       startYRef.current = e.touches[0]?.clientY ?? 0;
       setState('pressing');
 
@@ -133,6 +135,7 @@ export function useVoicePress({
   const onTouchMove = useCallback(
     (e: React.TouchEvent) => {
       if (!recordingRef.current) return;
+      e.preventDefault();
       const y = e.touches[0]?.clientY ?? 0;
       setState(getMoveInteractionState(startYRef.current, y));
     },
@@ -184,5 +187,21 @@ export function useVoicePress({
     (interactionState === 'recording-active' || interactionState === 'recording-cancel' || interactionState === 'pressing');
   const countdown = counting && duration >= MAX_DURATION - COUNTDOWN_START ? MAX_DURATION - duration : null;
 
+  useEffect(() => {
+    const locked = interactionState !== 'idle';
+    document.body.classList.toggle('tbox-voice-page-lock', locked);
+    if (!locked) return undefined;
+    const preventNativeGesture = (event: Event) => event.preventDefault();
+    document.addEventListener('selectstart', preventNativeGesture);
+    document.addEventListener('dragstart', preventNativeGesture);
+    document.addEventListener('contextmenu', preventNativeGesture);
+    return () => {
+      document.body.classList.remove('tbox-voice-page-lock');
+      document.removeEventListener('selectstart', preventNativeGesture);
+      document.removeEventListener('dragstart', preventNativeGesture);
+      document.removeEventListener('contextmenu', preventNativeGesture);
+    };
+  }, [interactionState]);
+
   return { interactionState, overlayVisible: interactionState !== 'idle', countdown, handlers };
 }

package/apps/client/src/components/MessageBubble/index.less

@@ -43,6 +43,12 @@
   }
 }
 
+/* 意图空文本出卡（无气泡、有卡）：卡片前间距由 meta 下边距提供——
+   meta 无 border → 折叠语义 max(12, 卡 mt)，未来全局卡框间距调整自然跟随 */
+.msg-meta--solo-card {
+  margin-bottom: 12px;
+}
+
 .msg-bubble {
   padding: 18px 22px;
   border-radius: 20px;
@@ -74,6 +80,9 @@
     box-shadow:
       0 3px 8px 5px rgba(1, 112, 254, 0.0392),
       0 2px 4px rgba(72, 78, 86, 0.0706);
+    /* 卡片在对话气泡之后显示：间距由气泡下边距提供（单一来源；
+       不写 .tbox-card 规则——避免特异性压过全局卡框、避免复制全局间距值） */
+    margin-bottom: 12px;
   }
 
   &__text {
@@ -151,7 +160,9 @@
   display: flex;
   align-items: center;
   gap: 12px;
-  margin-top: 12px;
+  /* 操作栏间距由前元素 margin-bottom 提供（气泡 mb 12 / 卡片 mb 12）：
+     不能自设 margin-top——气泡有 border 阻断折叠，自设会与气泡 mb 叠加成 24px */
+  margin-top: 0;
   flex-wrap: wrap;
 }
 

package/apps/client/src/components/MessageBubble/index.tsx

@@ -9,6 +9,7 @@ import ToolCallBlock from '@/components/ToolCallBlock';
 import { ActionBar, CopyButton, getMessageCopyText } from '@/components/ActionBar';
 import { DebugButton } from '@/components/ActionBar/DebugButton';
 import { CardRenderer } from '@/cards/CardRenderer';
+import { CardCarousel } from '@tbox.cn/app-sdk/client';
 import { useChatStore } from '@/store/chat';
 import { copyText } from '@/utils/copyText';
 import { toast } from '@/utils/toast';
@@ -31,9 +32,12 @@ export function MessageBubble({ message }: { message: ChatMessage }) {
   const isThinking = message.status === 'thinking';
   const isStreaming = message.status === 'streaming';
   const hasReasoning = !!message.reasoning;
+  // 018 tool-debug：服务端旗标单源（HELLO_ACK；无 URL 逃逸——数据面信任锚点在服务端）
+  const toolDebug = useChatStore((s) => s.helloAck?.toolDebug === true);
+  // 018：formSubmit 伪工具 prod 过滤不变；dev 放行（防御性——若事件到达则可见）
   const visibleToolCalls = useMemo(
-    () => (message.toolCalls || []).filter((tc) => tc.name !== '__a2uiFormSubmit'),
-    [message.toolCalls],
+    () => (message.toolCalls || []).filter((tc) => toolDebug || tc.name !== '__a2uiFormSubmit'),
+    [message.toolCalls, toolDebug],
   );
   const hasToolCalls = visibleToolCalls.length > 0;
 
@@ -59,7 +63,9 @@ export function MessageBubble({ message }: { message: ChatMessage }) {
   return (
     <div className={`msg-row ${isUser ? 'msg-row--user' : 'msg-row--bot'}`}>
       <div className="msg-main">
-        <div className={`msg-meta ${isUser ? 'msg-meta--user' : 'msg-meta--bot'}`}>
+        <div
+          className={`msg-meta ${isUser ? 'msg-meta--user' : 'msg-meta--bot'}${!showBubble && messageCards.length > 0 ? ' msg-meta--solo-card' : ''}`}
+        >
           <span className="msg-meta__role">{roleName}</span>
           <span className="msg-meta__time">{timeLabel}</span>
         </div>
@@ -74,7 +80,7 @@ export function MessageBubble({ message }: { message: ChatMessage }) {
 
         {hasReasoning && <ReasoningBlock reasoning={message.reasoning!} isActive={isReasoningActive} />}
 
-        {hasToolCalls && <ToolCallBlock toolCalls={visibleToolCalls} />}
+        {hasToolCalls && <ToolCallBlock toolCalls={visibleToolCalls} debug={toolDebug} />}
 
         {isThinking && hasToolCalls && !message.content && (
           <div className="msg-thinking-inline">
@@ -84,10 +90,6 @@ export function MessageBubble({ message }: { message: ChatMessage }) {
           </div>
         )}
 
-        {messageCards.map((card) => (
-          <CardRenderer key={card.id} card={card} />
-        ))}
-
         {showBubble && (
           <div className={`msg-bubble ${isUser ? 'msg-bubble--user' : 'msg-bubble--bot'}`}>
             {isUser ? (
@@ -113,6 +115,12 @@ export function MessageBubble({ message }: { message: ChatMessage }) {
           </div>
         )}
 
+        {/* 卡片在对话气泡之后显示（决策出卡多张/意图卡/历史卡统一经 cardsByMessageId 挂载，多卡纵向铺开） */}
+        <CardCarousel
+          cards={messageCards}
+          renderItem={(card) => <CardRenderer key={card.id} card={card} />}
+        />
+
         {imageItems && imageItems.length > 0 && (
           <div className="msg-media">
             {imageItems.map((item, idx) => (

package/apps/client/src/components/PullDownIndicator/index.less

@@ -13,7 +13,7 @@
     width: 32px;
     height: 32px;
     border: 3px solid #d0d5dd;
-    border-top-color: #1677ff;
+    border-top-color: var(--tbox-primary);
     border-radius: 50%;
     animation: pull-spin 0.6s linear infinite;
   }

package/apps/client/src/components/PullDownIndicator/index.tsx

@@ -1,13 +1,12 @@
-import type { PullStatus } from '@/hooks/usePullDownHistory';
+import type { PullStatus } from '@tbox.cn/app-sdk/client';
+import { PULL_DOWN_THRESHOLD } from '@tbox.cn/app-sdk/client';
 import './index.less';
 
-const INDICATOR_HEIGHT = 60;
-
 /** 下拉加载历史的顶部指示器。 */
 export default function PullDownIndicator({ status, distance }: { status: PullStatus; distance: number }) {
   if (status === 'idle') return null;
 
-  const marginTop = status === 'loading' ? 0 : -INDICATOR_HEIGHT + Math.min(distance, INDICATOR_HEIGHT);
+  const marginTop = status === 'loading' ? 0 : -PULL_DOWN_THRESHOLD + Math.min(distance, PULL_DOWN_THRESHOLD);
   const showTransition = status === 'loading' || status === 'noMore';
 
   const content =

package/apps/client/src/components/QuickCommands/index.tsx

@@ -1,19 +1,26 @@
 // ⚠️ 平台标准组件：输入框上方的「快捷指令」。视觉还原时不改本组件、不另画。
 // 改内容只改 client/config/chat.json 的 quickCommands 数组（{ label, query, icon? }）。
+// 011 I2：服务端 HelloAck.chatConfig.quickCommands 优先（单一真源），本地 chat.json 为 fallback。
 // label 只写纯文字；前面的星标由本组件渲染（icon 字段或默认 ✦），不要把 ✦/emoji 写进 label。
 import { useChatConfigStore } from '@/store/chat-config';
+import { useChatStore } from '@/store/chat';
 import starIcon from '../../../assets/quick-command-star.svg';
 import './index.less';
 
 export function QuickCommands({ onCommand }: { onCommand: (query: string) => void }) {
-  const commands = useChatConfigStore((s) => s.quickCommands);
+  const staticCommands = useChatConfigStore((s) => s.quickCommands);
+  const serverCommands = useChatStore((s) => s.helloAck?.chatConfig.quickCommands);
+  // 服务端下发优先；未收到 HELLO_ACK（非 mall 部署）回落本地静态
+  const commands = (serverCommands && serverCommands.length > 0
+    ? serverCommands.map((c) => ({ label: c.label, query: c.prompt }))
+    : staticCommands) as { label: string; query: string }[];
   if (!commands.length) return null;
 
   return (
     <div className="quick-commands">
       {commands.map((cmd) => (
         <button key={cmd.label} className="quick-commands__item" onClick={() => onCommand(cmd.query)}>
-          <img className="quick-commands__icon" src={cmd.icon || starIcon} alt="" />
+          <img className="quick-commands__icon" src={starIcon} alt="" />
           <span className="quick-commands__label">{cmd.label}</span>
         </button>
       ))}

package/apps/client/src/components/ToolCallBlock/index.less

@@ -43,6 +43,17 @@
     animation: tool-spin 0.8s linear infinite;
   }
 
+  // 010：前置工具「自动」徽标（与模型主动调用区分）
+  &__badge {
+    font-size: 18px;
+    line-height: 1;
+    padding: 3px 8px;
+    border-radius: 8px;
+    background: rgba(93, 126, 198, 0.12);
+    color: #5f7ec6;
+    flex-shrink: 0;
+  }
+
   &__name {
     font-size: 22px;
     line-height: 1.4;
@@ -82,6 +93,35 @@
       color: #dc2626;
     }
   }
+
+  // 018 dev 视图输入/输出双栏（紧凑单行 + 头尾保留）
+  &__io {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+
+    & + & {
+      margin-top: 12px;
+    }
+  }
+
+  &__io-label {
+    font-size: 18px;
+    color: #8a97ad;
+  }
+
+  &__io-text {
+    font-size: 20px;
+    color: #6b7a99;
+    line-height: 1.6;
+    font-family: Menlo, Monaco, Consolas, monospace;
+    white-space: pre-wrap;
+    word-break: break-all;
+
+    &--error {
+      color: #dc2626;
+    }
+  }
 }
 
 @keyframes tool-spin {

package/apps/client/src/components/ToolCallBlock/index.tsx

@@ -1,22 +1,85 @@
 import { useState } from 'react';
 import { Check, X } from '@phosphor-icons/react';
+import { parseMemoryToolCallArgs, parsePreToolToolCallArgs } from '@tbox.cn/app-contracts';
 import type { ToolCallInfo } from '@/types/chat';
+import { describeToolCall, formatCompactToolIo } from '@tbox.cn/app-sdk/client';
 import './index.less';
 
-/** 工具调用状态卡片（调用中 spinner / 完成 / 失败，可展开详情）。 */
-export default function ToolCallBlock({ toolCalls }: { toolCalls: ToolCallInfo[] }) {
+/**
+ * 工具调用状态卡片（调用中 spinner / 完成 / 失败）。
+ * 010：展示语义判定下沉 SDK describeToolCall（skill/preTool/normal/memory 四分支），
+ * 本组件退化为纯渲染（徽标/颜色/展开交互）。
+ * 018 tool-debug：debug 门控在渲染层——prod 恒无出入参展开入口（I4）；
+ * dev 详情走 formatCompactToolIo（紧凑单行 + 头尾保留），输入输出双栏。
+ */
+export default function ToolCallBlock({
+  toolCalls,
+  debug = false,
+}: {
+  toolCalls: ToolCallInfo[];
+  /** 018 tool-debug：dev 视图（出入参展开 + 紧凑格式）；prod 缺省 false */
+  debug?: boolean;
+}) {
   const [expandedId, setExpandedId] = useState<string | null>(null);
 
   return (
     <div className="tool-calls">
       {toolCalls.map((tc) => {
+        const display = describeToolCall(tc);
         const isCalling = tc.status === 'calling';
-        const isError = tc.status === 'error';
-        const isDone = tc.status === 'done';
+        const isError =
+          tc.status === 'error' ||
+          (display.kind === 'preTool' && display.status === 'error') ||
+          (display.kind === 'memory' && display.status === 'degraded');
+        const isDone = !isCalling && !isError;
         const isExpanded = expandedId === tc.id;
-        const hasDetail = !!(tc.result || tc.error);
+        // 018 I4：prod 恒无展开入口；dev 按 display.hasDetail
+        const hasDetail = debug && display.hasDetail;
         const stateClass = isError ? 'tool-call--error' : isCalling ? 'tool-call--calling' : 'tool-call--done';
 
+        const displayName = (() => {
+          if (display.kind === 'skill') {
+            return isCalling ? `加载技能 ${display.label}` : `已加载技能 ${display.label}`;
+          }
+          if (display.kind === 'preTool') {
+            if (display.status === 'calling') return `自动查询 ${display.label}`;
+            if (display.status === 'error') return `自动查询失败 ${display.label}`;
+            return `已自动获取 ${display.label}`;
+          }
+          if (display.kind === 'memory') {
+            return display.label;
+          }
+          return isCalling
+            ? `调用 ${display.label}`
+            : isDone
+              ? `${display.label} 已完成`
+              : `${display.label} 调用失败`;
+        })();
+
+        // 详情文本（018：dev 态才计算——prod 无展开无渲染需求）
+        const detailText = (() => {
+          if (!hasDetail) return '';
+          if (display.kind === 'preTool') {
+            return (display.status === 'error' ? display.errorText : display.resultText) ?? '';
+          }
+          if (display.kind === 'memory') {
+            return display.detailText ?? '';
+          }
+          return isError ? (tc.error ?? '') : (tc.result ?? '');
+        })();
+        // dev 输入侧：normal 用 tc.args；preTool 解包 toolArgs（对齐 mall 视图模型）；memory 取 query
+        const inputText = (() => {
+          if (!hasDetail) return '';
+          if (display.kind === 'normal') return tc.args ?? '';
+          if (display.kind === 'preTool') {
+            return JSON.stringify(parsePreToolToolCallArgs(tc.args)?.toolArgs ?? {});
+          }
+          if (display.kind === 'memory') {
+            return parseMemoryToolCallArgs(tc.args)?.query ?? '';
+          }
+          return '';
+        })();
+
         return (
           <div key={tc.id} className={`tool-call ${stateClass}`}>
             <div
@@ -27,11 +90,10 @@ export default function ToolCallBlock({ toolCalls }: { toolCalls: ToolCallInfo[]
                 {isCalling && <div className="tool-call__spinner" />}
                 {isDone && <Check size={16} color="#10a37f" strokeWidth={2.5} />}
                 {isError && <X size={16} color="#ef4444" strokeWidth={2.5} />}
-                <span className="tool-call__name">
-                  {isCalling && `调用 ${tc.name}`}
-                  {isDone && `${tc.name} 已完成`}
-                  {isError && `${tc.name} 调用失败`}
-                </span>
+                <span className="tool-call__name">{displayName}</span>
+                {display.kind === 'preTool' && (
+                  <span className="tool-call__badge">自动</span>
+                )}
               </div>
               {hasDetail && (
                 <span className={`tool-call__toggle${isExpanded ? ' tool-call__toggle--up' : ''}`}>
@@ -41,9 +103,18 @@ export default function ToolCallBlock({ toolCalls }: { toolCalls: ToolCallInfo[]
             </div>
             {isExpanded && hasDetail && (
               <div className="tool-call__result">
-                <span className={`tool-call__result-text${isError ? ' tool-call__result-text--error' : ''}`}>
-                  {formatResult(isError ? tc.error! : tc.result!)}
-                </span>
+                {inputText && (
+                  <div className="tool-call__io">
+                    <span className="tool-call__io-label">输入</span>
+                    <span className="tool-call__io-text">{formatCompactToolIo(inputText)}</span>
+                  </div>
+                )}
+                <div className="tool-call__io">
+                  <span className="tool-call__io-label">输出</span>
+                  <span className={`tool-call__io-text${isError ? ' tool-call__io-text--error' : ''}`}>
+                    {formatCompactToolIo(detailText) || '（无）'}
+                  </span>
+                </div>
               </div>
             )}
           </div>
@@ -52,12 +123,3 @@ export default function ToolCallBlock({ toolCalls }: { toolCalls: ToolCallInfo[]
     </div>
   );
 }
-
-function formatResult(raw: string): string {
-  try {
-    const pretty = JSON.stringify(JSON.parse(raw), null, 2);
-    return pretty.length > 500 ? pretty.slice(0, 500) + '...' : pretty;
-  } catch {
-    return raw.length > 500 ? raw.slice(0, 500) + '...' : raw;
-  }
-}

package/apps/client/src/hooks/useMediaUpload.ts

@@ -1,3 +1,7 @@
+import { createLogger } from '@tbox.cn/app-sdk/client';
+
+const mediaLogger = createLogger('media');
+
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { useUploadAdapter, useRefreshSession, chooseImage, chooseVideo } from '@tbox.cn/app-sdk/client';
 
@@ -109,7 +113,8 @@ export function useMediaUpload(maxTotal = 9, mediaConfig?: MediaConfig) {
                 done(await next.upload.upload(rec.source, { type: rec.type, name: rec.name }));
                 return;
               }
-            } catch {
+            } catch (retryErr) {
+              mediaLogger.warn(`上传重试失败：err=${(retryErr as Error).message}`);
               /* 重试失败 → 落到下方失败处理 */
             }
           }
@@ -211,7 +216,7 @@ export function useMediaUpload(maxTotal = 9, mediaConfig?: MediaConfig) {
           typeCount += 1;
         }
       } catch (err) {
-        console.warn('[media] bridge pick failed:', err);
+        mediaLogger.warn('bridge pick failed:', err);
       }
     },
     [adapter, enqueue, validate],

package/apps/client/src/main.tsx

@@ -1,12 +1,15 @@
 import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
-import { configureRuntime } from '@tbox.cn/app-sdk/client';
+import { configureRuntime, installGlobalErrorReporting } from '@tbox.cn/app-sdk/client';
 import App from './app';
 import './styles/global.less';
 
 // H1：环境值注入点（SDK 零 Vite 依赖）——VITE_API_URL 空串 = 同源相对路径
 configureRuntime({ apiBaseUrl: import.meta.env.VITE_API_URL as string | undefined });
 
+// 全局错误兜底：未捕获异常/rejection → 统一日志行（本地落地；上报扩展点见 SDK client logger）
+installGlobalErrorReporting();
+
 const el = document.getElementById('root');
 if (el) {
   createRoot(el).render(