@allbluecn/web-app 0.19.2 → 0.19.4

package/src/components/bug/detail/activity-tabs.tsx

@@ -18,11 +18,12 @@
 // BUG 详情活动/评论 tab（任务 11 占位的正式实现）。数据自取（同 EventsTimeline
 // 自包含分区模式）：活动走 listBugActivitiesFn cursor 分页，评论走 listCommentsFn
 // 一次性取全树。评论增删后刷新活动流（服务端会同步写 commented 活动）。
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { LoaderCircle } from "lucide-react";
 import { Button } from "@/components/ui/button";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { listBugActivitiesFn, listCommentsFn } from "@/server/serverFns/bug";
+import { errorMessage } from "@/lib/toast-error";
 import type { BugActivityItem, BugCommentWithReplies } from "../types";
 import { ActivityTimeline } from "./activity-timeline";
 import { CommentThread } from "./comment-thread";
@@ -65,12 +66,20 @@ export function ActivityTabs({ bugId, refreshKey = 0 }: ActivityTabsProps) {
   const [comments, setComments] = useState<BugCommentWithReplies[] | null>(null);
   const [error, setError] = useState<string | null>(null);
   const [loadingMore, setLoadingMore] = useState(false);
+  // 过期响应守卫：peek 上下条快速切换 bug 时，旧 bug 的 loadMore/刷新响应在途落盘
+  // 会追加串页数据——响应返回时比对当前 bugId，不一致即丢弃
+  const bugIdRef = useRef(bugId);
+  useEffect(() => {
+    bugIdRef.current = bugId;
+  }, [bugId]);
 
   const loadActivities = useCallback(
     async (cursor?: string) => {
+      const requestBugId = bugId;
       const res = await listBugActivitiesFn({
         data: { bugId, take: ACTIVITY_PAGE_SIZE, ...(cursor ? { cursor } : {}) },
       });
+      if (bugIdRef.current !== requestBugId) return;
       setActivities((prev) =>
         cursor && prev ? [...prev, ...res.items] : res.items,
       );
@@ -96,7 +105,7 @@ export function ActivityTabs({ bugId, refreshKey = 0 }: ActivityTabsProps) {
         setComments(cmts);
       })
       .catch((e: unknown) => {
-        if (!cancelled) setError(e instanceof Error ? e.message : m.bug_detail_load_failed());
+        if (!cancelled) setError(errorMessage(e, m.bug_detail_load_failed()));
       });
     return () => {
       cancelled = true;
@@ -109,7 +118,7 @@ export function ActivityTabs({ bugId, refreshKey = 0 }: ActivityTabsProps) {
     try {
       await loadActivities(nextCursor);
     } catch (e) {
-      setError(e instanceof Error ? e.message : m.bug_detail_load_failed());
+      setError(errorMessage(e, m.bug_detail_load_failed()));
     } finally {
       setLoadingMore(false);
     }

package/src/components/bug/detail/bug-detail-body.tsx

@@ -292,7 +292,7 @@ function BugDetailBodyInner({
         const who = res.activeRun.agentName;
         toast.warning(
           who
-            ? `${m.bug_fix_conflict_toast()}（${who}）`
+            ? m.bug_fix_conflict_toast_with_agent({ name: who })
             : m.bug_fix_conflict_toast(),
         );
       }
@@ -374,7 +374,7 @@ function BugDetailBodyInner({
         </div>
       )}
       {/* data-slot：BugPanelHeader 顶栏滚动渐显标题的滚动源（story-detail-scroll 同款，capture 监听） */}
-      <div data-slot="bug-detail-scroll" className="min-h-0 flex-1 overflow-y-auto" style={{ scrollbarGutter: "stable" } as React.CSSProperties}>
+      <div data-slot="bug-detail-scroll" className="min-h-0 flex-1 overflow-y-auto" style={{ scrollbarGutter: "stable" }}>
         {/* ① 头部：identifier + 来源/计数元信息 + 标题行内编辑 */}
         <header className="space-y-1 px-6 pt-4 pb-3">
           <div

package/src/components/bug/detail/comment-input.tsx

@@ -22,6 +22,7 @@ import { Button } from "@/components/ui/button";
 import { Textarea } from "@/components/ui/textarea";
 import { createCommentFn } from "@/server/serverFns/bug";
 import { toast } from "@/components/ui/toast";
+import { errorMessage } from "@/lib/toast-error";
 import type { BugCommentWithReplies } from "../types";
 import { m } from "@/paraglide/messages.js";
 
@@ -50,7 +51,7 @@ export function CommentInput({ bugId, parentId, onCommentCreated, onCancel, auto
       onCancel?.();
     } catch (err) {
       toast.error(m.bug_comment_failed(), {
-        description: err instanceof Error ? err.message : m.bug_comment_retry(),
+        description: errorMessage(err, m.bug_comment_retry()),
       });
     } finally {
       setSubmitting(false);
@@ -58,7 +59,8 @@ export function CommentInput({ bugId, parentId, onCommentCreated, onCancel, auto
   };
 
   const handleKeyDown = (e: React.KeyboardEvent<HTMLTextAreaElement>) => {
-    if (e.key === "Enter" && !e.shiftKey) {
+    // isComposing：中文输入法组词确认的 Enter 不触发提交（防半截拼音评论误发）
+    if (e.key === "Enter" && !e.shiftKey && !e.nativeEvent.isComposing) {
       e.preventDefault();
       void handleSubmit();
     }

package/src/components/bug/detail/comment-item.tsx

@@ -32,6 +32,7 @@ import {
 } from "@/components/ui/dropdown-menu";
 import { deleteCommentFn, updateCommentFn } from "@/server/serverFns/bug";
 import { toast } from "@/components/ui/toast";
+import { errorMessage } from "@/lib/toast-error";
 import type { BugCommentWithReplies } from "../types";
 import { formatRelative } from "./activity-timeline";
 import { CommentInput } from "./comment-input";
@@ -73,7 +74,7 @@ export function CommentItem({ bugId, comment, onAppendComment, onRemoveComment }
       setIsEditing(false);
     } catch (err) {
       toast.error(m.bug_comment_editFailed(), {
-        description: err instanceof Error ? err.message : m.bug_comment_retry(),
+        description: errorMessage(err, m.bug_comment_retry()),
       });
     } finally {
       setSaving(false);
@@ -88,7 +89,7 @@ export function CommentItem({ bugId, comment, onAppendComment, onRemoveComment }
       onRemoveComment(comment.id);
     } catch (err) {
       toast.error(m.bug_comment_deleteFailed(), {
-        description: err instanceof Error ? err.message : m.bug_comment_retry(),
+        description: errorMessage(err, m.bug_comment_retry()),
       });
     } finally {
       setDeleting(false);
@@ -138,7 +139,8 @@ export function CommentItem({ bugId, comment, onAppendComment, onRemoveComment }
                 value={editContent}
                 onChange={(e) => setEditContent(e.target.value)}
                 onKeyDown={(e) => {
-                  if (e.key === "Enter" && !e.shiftKey) {
+                  // isComposing：输入法组词确认的 Enter 不触发保存（同 comment-input）
+                  if (e.key === "Enter" && !e.shiftKey && !e.nativeEvent.isComposing) {
                     e.preventDefault();
                     void handleSaveEdit();
                   }

package/src/components/bug/detail/comment-reactions.tsx

@@ -27,6 +27,7 @@ import { SmilePlus } from "lucide-react";
 import { EmojiPicker } from "@/components/shared-kit/comments/emoji-picker";
 import { toast } from "@/components/ui/toast";
 import { toggleBugCommentReactionFn } from "@/server/serverFns/bug";
+import { errorMessage } from "@/lib/toast-error";
 import type { ReactionGroup } from "@/components/story/types";
 import { m } from "@/paraglide/messages.js";
 
@@ -76,7 +77,7 @@ export function CommentReactions({ commentId, reactions }: CommentReactionsProps
       // 由后者的权威响应自愈——单表情失败是常态路径，不为极端并发加复杂度
       setOverride(base);
       toast.error(m.bug_comment_reactionFailed(), {
-        description: err instanceof Error ? err.message : m.bug_comment_retry(),
+        description: errorMessage(err, m.bug_comment_retry()),
       });
     } finally {
       pendingRef.current.delete(emoji);

package/src/components/bug/detail/error-context.tsx

@@ -97,7 +97,17 @@ export function ErrorContext({ bugId, title, stack, url, userAgent, env, screens
               src={screenshotSrc}
               alt={screenshotAlt}
               loading="lazy"
+              role="button"
+              tabIndex={0}
+              aria-label={screenshotAlt}
               onClick={() => setLightboxOpen(true)}
+              onKeyDown={(e) => {
+                // 键盘可达：Enter/Space 触发 lightbox（与点击等价）
+                if (e.key === "Enter" || e.key === " ") {
+                  e.preventDefault();
+                  setLightboxOpen(true);
+                }
+              }}
               onError={() => setScreenshotFailed(true)}
               data-testid="bug-screenshot-thumbnail"
               className="max-h-72 max-w-full cursor-zoom-in rounded-md border object-contain"

package/src/components/bug/detail/events-timeline.tsx

@@ -18,11 +18,13 @@
 // 事件样本时间线（规格 §5.4 第 5 分区）：BugEvent 采样快照，occurTime 倒序
 // cursor 分页。rawPayload 为服务端截断后的原始报文，仅展示摘要字段
 // （errorName/message），完整报文属 P2 采集链路消费范围。
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { History, LoaderCircle } from "lucide-react";
 import { Button } from "@/components/ui/button";
+import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
 import { listBugEventsFn } from "@/server/serverFns/bug";
 import { formatTimestamp } from "@/lib/datetime";
+import { errorMessage } from "@/lib/toast-error";
 import { m } from "@/paraglide/messages.js";
 
 interface BugEventItem {
@@ -51,6 +53,11 @@ export function EventsTimeline({ bugId }: EventsTimelineProps) {
   const [nextCursor, setNextCursor] = useState<string | null>(null);
   const [loadingMore, setLoadingMore] = useState(false);
   const [error, setError] = useState<string | null>(null);
+  // 过期响应守卫：bugId 快速切换时 loadMore 在途响应不得追加旧 bug 事件
+  const bugIdRef = useRef(bugId);
+  useEffect(() => {
+    bugIdRef.current = bugId;
+  }, [bugId]);
 
   useEffect(() => {
     let cancelled = false;
@@ -65,7 +72,7 @@ export function EventsTimeline({ bugId }: EventsTimelineProps) {
         }
       })
       .catch((e: unknown) => {
-        if (!cancelled) setError(e instanceof Error ? e.message : m.bug_detail_load_failed());
+        if (!cancelled) setError(errorMessage(e, m.bug_detail_load_failed()));
       });
     return () => {
       cancelled = true;
@@ -77,10 +84,11 @@ export function EventsTimeline({ bugId }: EventsTimelineProps) {
     setLoadingMore(true);
     try {
       const res = await listBugEventsFn({ data: { bugId, take: 10, cursor: nextCursor } });
+      if (bugIdRef.current !== bugId) return;
       setEvents((prev) => (prev ? [...prev, ...(res.items as BugEventItem[])] : (res.items as BugEventItem[])));
       setNextCursor(res.nextCursor);
     } catch (e) {
-      setError(e instanceof Error ? e.message : m.bug_detail_load_failed());
+      setError(errorMessage(e, m.bug_detail_load_failed()));
     } finally {
       setLoadingMore(false);
     }
@@ -119,9 +127,17 @@ export function EventsTimeline({ bugId }: EventsTimelineProps) {
                 </div>
                 {summary && <div className="mt-1 break-all font-mono text-muted-foreground">{summary}</div>}
                 {e.userAgent && (
-                  <div className="mt-1 truncate font-mono text-muted-foreground/70" title={e.userAgent}>
-                    {e.userAgent}
-                  </div>
+                  // Tooltip 替代被禁用的 HTML title 属性（bug-toolbar 同口径）
+                  <Tooltip>
+                    <TooltipTrigger
+                      render={
+                        <span className="mt-1 block truncate font-mono text-muted-foreground/70" />
+                      }
+                    >
+                      {e.userAgent}
+                    </TooltipTrigger>
+                    <TooltipContent>{e.userAgent}</TooltipContent>
+                  </Tooltip>
                 )}
               </li>
             );

package/src/components/bug/detail/fix-timeline.tsx

@@ -25,7 +25,7 @@
 // R16 口径：失败态从 run.summary.result 读（"failed" | "cannot_reproduce"），
 // 不依赖 run.status==="failed"——report_result 一律置 completed，schema 的
 // failed 是死值；仅 cancelled 经用户取消可达。
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import {
   Ban,
   Bot,
@@ -45,7 +45,8 @@ import { cancelBugFixFn, listFixRunsFn } from "@/server/serverFns/bug";
 import type { FixProgressItem, FixRunItem } from "@/server/serverFns/bug/bug-fix";
 import { formatRelative } from "./activity-timeline";
 import { m } from "@/paraglide/messages.js";
-import { toastError } from "@/lib/toast-error";
+import { toastError, errorMessage } from "@/lib/toast-error";
+import { toSafeHref } from "@/lib/safe-url";
 
 const RUN_STATUS_LABEL: Record<string, () => string> = {
   pending: m.bug_fix_status_pending,
@@ -149,20 +150,28 @@ export function FixTimeline({ bugId, refreshKey = 0 }: FixTimelineProps) {
   const [progressByRun, setProgressByRun] = useState<Map<string, FixProgressItem[]>>(new Map());
   const [error, setError] = useState<string | null>(null);
   const [cancelling, setCancelling] = useState(false);
+  // 过期响应守卫：bugId 切换或 refreshKey 连续递增时，慢响应后到不得覆盖新数据
+  const bugIdRef = useRef(bugId);
+  useEffect(() => {
+    bugIdRef.current = bugId;
+  }, [bugId]);
 
   const load = useCallback(
     (silent = false) => {
+      const requestBugId = bugId;
       if (!silent) {
         setRuns(null);
         setError(null);
       }
       return listFixRunsFn({ data: { bugId } })
         .then((res) => {
+          if (bugIdRef.current !== requestBugId) return;
           setRuns(res.runs);
           setProgressByRun(attachProgress(res.runs, res.progress));
         })
         .catch((e: unknown) => {
-          setError(e instanceof Error ? e.message : m.bug_detail_load_failed());
+          if (bugIdRef.current !== requestBugId) return;
+          setError(errorMessage(e, m.bug_detail_load_failed()));
         });
     },
     [bugId],
@@ -216,6 +225,9 @@ export function FixTimeline({ bugId, refreshKey = 0 }: FixTimelineProps) {
           const progress = progressByRun.get(run.id) ?? [];
           const isActive =
             run.status === "pending" || run.status === "claimed" || run.status === "in_progress";
+          // agent 产出的 commitUrl/prUrl 按 scheme 白名单校验，非法（如 javascript:）不渲染链接
+          const safeCommitUrl = summary?.commitUrl ? toSafeHref(summary.commitUrl) : null;
+          const safePrUrl = summary?.prUrl ? toSafeHref(summary.prUrl) : null;
           return (
             <div key={run.id} className="rounded-lg border bg-card/50 p-3" data-testid={`fix-run-${run.id}`}>
               {/* run 头：状态徽章 + 触发方式 + agent + 时间 + 取消按钮 */}
@@ -290,9 +302,10 @@ export function FixTimeline({ bugId, refreshKey = 0 }: FixTimelineProps) {
                       )}
                       {resultLabel(summary.result)}
                     </Badge>
-                    {summary.commitUrl && (
+                    {/* agent 侧不可信 URL：scheme 白名单校验（非法 scheme 不渲染链接，退化为无链接文本布局） */}
+                    {safeCommitUrl && (
                       <a
-                        href={summary.commitUrl}
+                        href={safeCommitUrl}
                         target="_blank"
                         rel="noreferrer"
                         className="inline-flex items-center gap-1 text-muted-foreground underline-offset-2 hover:text-foreground hover:underline"
@@ -302,9 +315,9 @@ export function FixTimeline({ bugId, refreshKey = 0 }: FixTimelineProps) {
                         <ExternalLink className="size-3" />
                       </a>
                     )}
-                    {summary.prUrl && (
+                    {safePrUrl && (
                       <a
-                        href={summary.prUrl}
+                        href={safePrUrl}
                         target="_blank"
                         rel="noreferrer"
                         className="inline-flex items-center gap-1 text-muted-foreground underline-offset-2 hover:text-foreground hover:underline"

package/src/components/bug/detail/props-section.tsx

@@ -252,7 +252,8 @@ function EnvEditor({
           disabled={saving}
           autoFocus
           onKeyDown={(e) => {
-            if (e.key === "Enter") {
+            // isComposing：输入法组词确认的 Enter 不触发保存（comment-input 同款守卫）
+            if (e.key === "Enter" && !e.nativeEvent.isComposing) {
               e.preventDefault();
               const next = draft.trim();
               if (next && next !== bug.env) void save(next);

package/src/components/bug/detail/repro-report-card.tsx

@@ -25,7 +25,7 @@
 // 安全约束：reasoning/rootCauseHypothesis/suggestedFix 等 AI 输出按不可信内容处理，
 // 推理走 MarkdownView（react-markdown 默认转义 raw HTML），其余纯文本节点渲染，
 // 禁止 dangerouslySetInnerHTML。
-import { useCallback, useEffect, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import {
   ChevronDown,
   CircleCheck,
@@ -49,7 +49,7 @@ import { MarkdownView } from "@/components/knowledge/public/markdown-view";
 import { formatRelative } from "./activity-timeline";
 import { m } from "@/paraglide/messages.js";
 import type { BugDetail } from "../types";
-import { toastError } from "@/lib/toast-error";
+import { toastError, errorMessage } from "@/lib/toast-error";
 
 /** confidence 0-1 → 整数百分比（越界钳制，防脏数据渲染 -3% / 140%） */
 function confidencePercent(confidence: number): number {
@@ -117,8 +117,8 @@ function ReproReportView({ report }: { report: NonNullable<ReproRunItem["report"
         <div className="space-y-1" data-testid="repro-missing-info">
           <p className="text-xs font-medium text-amber-600 dark:text-amber-400">{m.bug_repro_missing_info()}</p>
           <ul className="list-disc space-y-0.5 pl-5 text-xs text-muted-foreground">
-            {report.missingInfo.map((item) => (
-              <li key={item}>{item}</li>
+            {report.missingInfo.map((item, i) => (
+              <li key={`${item}-${i}`}>{item}</li>
             ))}
           </ul>
         </div>
@@ -147,16 +147,34 @@ export function ReproReportCard({ bug, onBugUpdate, onRunFinished }: ReproReport
     setRepoHintsDraft(bug.repoHints ?? "");
   }, [bug.id, bug.repoHints]);
 
+  // 过期响应/卸载守卫：55s 同步执行窗口内用户可离开详情页（卸载后不再 setState/发请求），
+  // bugId 切换时旧响应不得覆盖新数据
+  const bugIdRef = useRef(bug.id);
+  const unmountedRef = useRef(false);
+  useEffect(() => {
+    bugIdRef.current = bug.id;
+  }, [bug.id]);
+  useEffect(() => {
+    return () => {
+      unmountedRef.current = true;
+    };
+  }, []);
+
   const load = useCallback(
     (silent = false) => {
+      const requestBugId = bug.id;
       if (!silent) {
         setRuns(null);
         setLoadError(null);
       }
-      return listReproRunsFn({ data: { bugId: bug.id } })
-        .then((res) => setRuns(res.runs))
+      return listReproRunsFn({ data: { bugId: requestBugId } })
+        .then((res) => {
+          if (unmountedRef.current || bugIdRef.current !== requestBugId) return;
+          setRuns(res.runs);
+        })
         .catch((e: unknown) => {
-          setLoadError(e instanceof Error ? e.message : m.bug_detail_load_failed());
+          if (unmountedRef.current || bugIdRef.current !== requestBugId) return;
+          setLoadError(errorMessage(e, m.bug_detail_load_failed()));
         });
     },
     [bug.id],
@@ -181,8 +199,11 @@ export function ReproReportCard({ bug, onBugUpdate, onRunFinished }: ReproReport
       // run 创建前失败（AI 未配置 / BUG 不存在 / 权限）
       toastError(e, m.bug_repro_action_failed());
     } finally {
-      setRunning(false);
-      await load(true);
+      // 卸载后静默退出：不 setState、不发收尾请求
+      if (!unmountedRef.current) {
+        setRunning(false);
+        void load(true);
+      }
     }
   };
 

package/src/components/bug/detail/reproduce-steps-view.tsx

@@ -43,8 +43,9 @@ export function ReproduceStepsView({ steps }: ReproduceStepsViewProps) {
       ) : (
         <>
           <ol className="space-y-2">
-            {steps!.steps.map((step) => (
-              <li key={step.order} className="flex items-start gap-2 text-sm">
+            {steps!.steps.map((step, i) => (
+              // order 为序号语义，服务端脏数据重复时防 key 冲突，拼 index 兜底
+              <li key={`${step.order}-${i}`} className="flex items-start gap-2 text-sm">
                 <span className="flex size-5 shrink-0 items-center justify-center rounded-full bg-muted text-xs font-medium">
                   {step.order}
                 </span>

package/src/components/bug/display/constants.ts

@@ -17,7 +17,7 @@
 
 import { ArrowDownUp, CircleDotDashed, CircleFadingArrowUp, Hash, Plus, RefreshCw, User, UserPlus, X, Tag, CalendarClock, Bug, type LucideIcon } from "lucide-react";
 import { m } from "@/paraglide/messages.js";
-import type { BugDisplayProperty, BugGroupKey, BugOrderKey } from "./types";
+import type { BugDisplayProperty, BugGroupKey, BugOrderKey } from "@/shared/bug/display-types";
 
 /** 分组维度标签（bug_ 域文案，照 story display/constants 裁剪到 BUG 维度） */
 export const BUG_GROUP_LABELS: Record<BugGroupKey, () => string> = {

package/src/components/bug/display/display-dropdown.tsx

@@ -29,7 +29,7 @@ import {
 } from "@/components/shared-kit/list-kit/display/dropdown";
 import { m } from "@/paraglide/messages.js";
 import { BUG_GROUP_ICONS, BUG_GROUP_LABELS, BUG_ORDER_ICONS, BUG_ORDER_LABELS, BUG_PROPERTY_LABELS } from "./constants";
-import { BUG_DISPLAY_PROPERTIES, BUG_GROUP_KEYS, BUG_ORDER_KEYS, BUG_PAGE_SIZE_OPTIONS, DEFAULT_BUG_DISPLAY_OPTIONS, type BugDisplayOptions, type BugDisplayProperty, type BugGroupKey, type BugOrderKey } from "./types";
+import { BUG_DISPLAY_PROPERTIES, BUG_GROUP_KEYS, BUG_ORDER_KEYS, BUG_PAGE_SIZE_OPTIONS, DEFAULT_BUG_DISPLAY_OPTIONS, type BugDisplayOptions, type BugDisplayProperty, type BugGroupKey, type BugOrderKey } from "@/shared/bug/display-types";
 import { BugViewListSection } from "../views/view-list-section";
 import type { BugViewModel } from "../views/view-types";
 

package/src/components/bug/display/use-bug-display-options.ts

@@ -20,7 +20,7 @@
 // 持久化（保存永不报错：失败静默吞掉，服务端 capPageSize 降级不影响 UI）。
 import { useCallback, useEffect, useRef, useState } from "react";
 import { getBugDisplayOptionsFn, updateBugDisplayOptionsFn } from "@/server/serverFns/bug";
-import { DEFAULT_BUG_DISPLAY_OPTIONS, type BugDisplayOptions } from "./types";
+import { DEFAULT_BUG_DISPLAY_OPTIONS, type BugDisplayOptions } from "@/shared/bug/display-types";
 
 export interface BugDisplayOptionsState {
   filters: BugDisplayOptions;
@@ -29,6 +29,10 @@ export interface BugDisplayOptionsState {
 
 export function useBugDisplayOptions(): BugDisplayOptionsState {
   const [filters, setFilters] = useState<BugDisplayOptions>(DEFAULT_BUG_DISPLAY_OPTIONS);
+  // filters 镜像 ref：updateFilters 在 updater 外计算 next（setState updater 必须纯函数，
+  // 内嵌 RPC 在 StrictMode 双调用下会重复发持久化请求），连续调用间以 ref 为最新基线
+  // （不等 re-render），首屏加载完成后同步回写。
+  const filtersRef = useRef<BugDisplayOptions>(DEFAULT_BUG_DISPLAY_OPTIONS);
   const loadedRef = useRef(false);
 
   useEffect(() => {
@@ -36,17 +40,19 @@ export function useBugDisplayOptions(): BugDisplayOptionsState {
     loadedRef.current = true;
     void getBugDisplayOptionsFn()
       .then((prefs) => {
-        if (prefs) setFilters(prefs);
+        if (prefs) {
+          filtersRef.current = prefs;
+          setFilters(prefs);
+        }
       })
       .catch(() => {});
   }, []);
 
   const updateFilters = useCallback((patch: Partial<BugDisplayOptions>) => {
-    setFilters((prev) => {
-      const next = { ...prev, ...patch };
-      void updateBugDisplayOptionsFn({ data: next }).catch(() => {});
-      return next;
-    });
+    const next = { ...filtersRef.current, ...patch };
+    filtersRef.current = next;
+    setFilters(next);
+    void updateBugDisplayOptionsFn({ data: next }).catch(() => {});
   }, []);
 
   return { filters, updateFilters };

package/src/components/bug/display/use-paged-bug-groups.ts

@@ -35,7 +35,7 @@ import type { FilterCondition } from "../filters";
 import { serializeFilters } from "../filters";
 import { BUG_STATES, BUG_SEVERITIES, type BugState, type BugSeverity } from "@/shared/bug/constants";
 import { STATE_LABEL, SEVERITY_LABEL } from "@/shared/bug/constants";
-import type { BugDisplayOptions, BugGroupKey, BugOrderKey } from "./types";
+import type { BugDisplayOptions, BugGroupKey, BugOrderKey } from "@/shared/bug/display-types";
 import { m } from "@/paraglide/messages.js";
 
 /** BUG 行内编辑 patch 面（updateBugFn 的客户端子集；title 供标题行内编辑） */
@@ -114,7 +114,8 @@ const GROUP_COUNT_ESTIMATE: Partial<Record<BugGroupKey, number>> = {
 function estimateGroupCount(groupBy: BugGroupKey, users: UserBrief[]): number {
   const known = GROUP_COUNT_ESTIMATE[groupBy];
   if (known != null) return known;
-  // 指派人/创建人按成员数+未指派估算
+  // 经验下限 10：assignee/createdBy 组数 = 成员数 + 未指派/未知组，成员稀少的项目
+  // 仍按 10 估算批量拉取条数，避免每组首屏只取到 2-3 条就触发翻页
   return Math.max(users.length + 1, 10);
 }
 
@@ -187,6 +188,8 @@ function applyBugPatch(bug: BugListItem, patch: BugPatch, ctx: PatchContext): Bu
       .filter((l): l is { id: string; name: string; color: string } => l != null);
   }
   if (patch.lastOccurAt !== undefined) {
+    // 服务端 lastOccurAt 非可空（null patch 在 row.tsx updateField 归一为 no-op）：
+    // null 这里归一为保留旧值，保证乐观态与服务端最终态一致，而非让行显示空日期
     next.lastOccurAt = patch.lastOccurAt ?? bug.lastOccurAt;
   }
   return next;
@@ -442,7 +445,12 @@ export function usePagedBugGroups(args: PagedBugsArgs): {
                     skip: 0,
                     take: pageSize,
                   },
-                }).catch(() => ({ items: [] as BugListItem[], total: sg.total ?? 0, hasMore: false })),
+                }).catch((e: unknown) => {
+                  // 首屏失败降级为空组但不静默：console 归属排查信号（组级 error 态
+                  // + 重试入口需动 use-paged-groups core，暂以日志兜底）
+                  console.error("[usePagedBugGroups] 子组首屏加载失败", g.key, sg.key, e);
+                  return { items: [] as BugListItem[], total: sg.total ?? 0, hasMore: false };
+                }),
               ),
             );
             subLoaded.forEach((res, i: number) => {
@@ -472,7 +480,11 @@ export function usePagedBugGroups(args: PagedBugsArgs): {
                 skip: 0,
                 take: pageSize,
               },
-            }).catch(() => ({ items: [] as BugListItem[], total: g.total ?? 0, hasMore: false })),
+            }).catch((e: unknown) => {
+              // 同上：无分组模式「全部」组首屏失败降级空列表，console 归属不静默
+              console.error("[usePagedBugGroups] 首屏加载失败", g.key, e);
+              return { items: [] as BugListItem[], total: g.total ?? 0, hasMore: false };
+            }),
           ),
         );
         loaded.forEach((res, i: number) => {