@allbluecn/web-app 0.19.2 → 0.19.4

package/src/components/billing/currency-toggle.tsx

@@ -15,53 +15,96 @@
 // You should have received a copy of the GNU Affero General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-import { useEffect, useState } from 'react'
+import { useEffect, useRef, useState } from 'react'
+import { Button } from '@/components/ui/button'
 import { updatePreferredCurrencyFn } from '@/server/serverFns/billing'
 
-export function CurrencyToggle() {
-  const [currency, setCurrency] = useState<'usd' | 'cny'>('usd')
+export type PreferredCurrency = 'usd' | 'cny'
+
+interface CurrencyToggleProps {
+  /** 受控值：传入后组件显示由父级驱动（挂载时仍会从 localStorage 恢复并经 onChange 通知父级） */
+  value?: PreferredCurrency
+  /** 切换/恢复偏好时回调（父级据此同步结算货币或重取价目） */
+  onChange?: (currency: PreferredCurrency) => void
+}
+
+const PREFERRED_CURRENCY_KEY = 'preferredCurrency'
+
+/**
+ * USD/CNY 偏好切换器：本地持久化 + 服务端同步（未登录忽略）。
+ * 受控模式供 pricing-page / billing-panel 同步结算货币；非受控模式保持旧行为。
+ */
+export function CurrencyToggle({ value, onChange }: CurrencyToggleProps) {
+  const [internal, setInternal] = useState<PreferredCurrency>('usd')
+  // value/onChange 走 ref，挂载恢复 effect 无需依赖父级逐帧变化的 props 引用
+  const valueRef = useRef(value)
+  valueRef.current = value
+  const onChangeRef = useRef(onChange)
+  onChangeRef.current = onChange
+  const currency = value ?? internal
 
   useEffect(() => {
-    const saved = localStorage.getItem('preferredCurrency')
-    if (saved === 'usd' || saved === 'cny') {
-      setCurrency(saved)
+    let saved: string | null = null
+    try {
+      saved = localStorage.getItem(PREFERRED_CURRENCY_KEY)
+    } catch {
+      return
+    }
+    if (saved !== 'usd' && saved !== 'cny') return
+    if (valueRef.current === undefined) {
+      setInternal(saved)
+    } else if (saved !== valueRef.current) {
+      // 受控模式：恢复偏好只通知父级，不重复落库
+      onChangeRef.current?.(saved)
     }
+    // 仅挂载时恢复一次（value/onChange 经 ref 读取，不依赖外层 props 引用）
   }, [])
 
-  const toggleCurrency = async (next: 'usd' | 'cny') => {
-    setCurrency(next)
-    localStorage.setItem('preferredCurrency', next)
+  const toggleCurrency = (next: PreferredCurrency) => {
+    const current = valueRef.current ?? internal
+    if (next === current) return
+    if (valueRef.current === undefined) setInternal(next)
+    onChangeRef.current?.(next)
     try {
-      await updatePreferredCurrencyFn({ data: { currency: next } })
+      localStorage.setItem(PREFERRED_CURRENCY_KEY, next)
     } catch {
-      // 未登录用户忽略
+      // localStorage 不可用（隐私模式等）时静默降级为不持久化
     }
+    updatePreferredCurrencyFn({ data: { currency: next } }).catch(() => {
+      // 未登录用户忽略
+    })
   }
 
   return (
     <div className="inline-flex rounded-lg border border-border bg-background p-1">
-      <button
+      <Button
         type="button"
+        variant="ghost"
+        size="sm"
+        aria-pressed={currency === 'usd'}
         onClick={() => toggleCurrency('usd')}
-        className={`px-3 py-1 text-sm rounded-md transition-colors ${
+        className={`px-3 text-sm rounded-md ${
           currency === 'usd'
-            ? 'bg-primary text-primary-foreground'
+            ? 'bg-primary text-primary-foreground hover:bg-primary hover:text-primary-foreground'
             : 'text-muted-foreground hover:text-foreground'
         }`}
       >
         USD
-      </button>
-      <button
+      </Button>
+      <Button
         type="button"
+        variant="ghost"
+        size="sm"
+        aria-pressed={currency === 'cny'}
         onClick={() => toggleCurrency('cny')}
-        className={`px-3 py-1 text-sm rounded-md transition-colors ${
+        className={`px-3 text-sm rounded-md ${
           currency === 'cny'
-            ? 'bg-primary text-primary-foreground'
+            ? 'bg-primary text-primary-foreground hover:bg-primary hover:text-primary-foreground'
             : 'text-muted-foreground hover:text-foreground'
         }`}
       >
         CNY
-      </button>
+      </Button>
     </div>
   )
 }

package/src/components/billing/feature-gate.tsx

@@ -2,6 +2,7 @@ import { useState, type ReactElement } from 'react'
 import { useFeature } from './use-feature'
 import { UpgradePrompt } from './upgrade-prompt'
 import { LoginPromptDialog } from './login-prompt-dialog'
+import { Button } from '@/components/ui/button'
 import { type FeatureKey } from '@allbluecn/kernel'
 import { m } from "@/paraglide/messages.js";
 
@@ -43,6 +44,10 @@ export function FeatureGate({
       <>
         <div className="flex flex-col items-center justify-center gap-3 p-6 text-center">
           <p className="text-sm text-muted-foreground">{m.billing_requiresLogin()}</p>
+          {/* 登录解锁入口：loginOpen 唯一置真点（桌面访客经 LoginPromptDialog 打开登录页） */}
+          <Button size="sm" onClick={() => setLoginOpen(true)}>
+            {m.billing_goToLogin()}
+          </Button>
           <UpgradePrompt feature={feature} />
         </div>
         <LoginPromptDialog open={loginOpen} onOpenChange={setLoginOpen} feature={feature} />

package/src/components/billing/feature-label.ts

@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// Feature key → 用户可读文案的统一映射（审计 🔵：upgrade-prompt / pricing-card
+// 各写各的映射表会随 kernel FeatureRegistry 膨胀而失配）。key 集合对齐 kernel
+// FeatureRegistry（feature-label.test 有覆盖哨兵，漏注册即红）；aiQuota / auditLog
+// 为历史遗留别名（注册表无此 key），保留映射防旧数据回落原始英文标识。
+import { m } from '@/paraglide/messages.js'
+
+const FEATURE_LABELS: Record<string, () => string> = {
+  byokAi: m.billing_featureByokAi,
+  hostedAi: m.billing_featureHostedAi,
+  multiProvider: m.billing_featureMultiProvider,
+  largePageSize: m.billing_featureLargePageSize,
+  versionHistory: m.billing_featureVersionHistory,
+  automation: m.billing_featureAutomation,
+  templates: m.billing_featureTemplates,
+  globalSearch: m.billing_featureGlobalSearch,
+  analytics: m.billing_featureAnalytics,
+  sso: m.billing_featureSso,
+  audit: m.billing_featureAudit,
+  advancedPermissions: m.billing_featureAdvancedPermissions,
+  compliance: m.billing_featureCompliance,
+  customAgents: m.billing_featureCustomAgents,
+  sandboxExecution: m.billing_featureSandboxExecution,
+  mediaGeneration: m.billing_featureMediaGeneration,
+  bugAutoFix: m.billing_featureBugAutoFix,
+  testGeneration: m.billing_featureTestGeneration,
+  // 历史遗留别名
+  aiQuota: m.billing_featureAiQuota,
+  auditLog: m.billing_featureAuditLog,
+}
+
+/** 注册表 key 未命中时原样返回（调用方无需判空） */
+export function featureLabel(feature: string): string {
+  return FEATURE_LABELS[feature]?.() ?? feature
+}

package/src/components/billing/invoice-history.tsx

@@ -54,8 +54,8 @@ export function InvoiceHistory({
                   <span
                     className={`inline-block px-2 py-0.5 rounded text-xs ${
                       inv.status === 'paid'
-                        ? 'bg-green-100 text-green-700'
-                        : 'bg-yellow-100 text-yellow-700'
+                        ? 'bg-green-500/10 text-green-600 dark:text-green-400'
+                        : 'bg-amber-500/10 text-amber-600 dark:text-amber-400'
                     }`}
                   >
                     {inv.status === 'paid' ? m.billing_paid() : m.billing_unpaid()}

package/src/components/billing/login-prompt-dialog.tsx

@@ -1,4 +1,4 @@
-import { useEffect, useState, type ReactElement } from 'react'
+import { useState, type ReactElement } from 'react'
 import {
   Dialog,
   DialogContent,
@@ -29,26 +29,15 @@ export function LoginPromptDialog({
 }: LoginPromptDialogProps): ReactElement {
   const [exchanging, setExchanging] = useState(false)
 
-  useEffect(() => {
-    if (!onOpenChange) return
-    const handleKeyDown = (e: KeyboardEvent) => {
-      if (!open) return
-      if (e.key === 'Escape') {
-        e.preventDefault()
-        onOpenChange(false)
-      }
-    }
-    document.addEventListener('keydown', handleKeyDown)
-    return () => {
-      document.removeEventListener('keydown', handleKeyDown)
-    }
-  }, [open, onOpenChange])
-
   const handleLogin = async () => {
+    if (exchanging) return
+    // 提交期禁用按钮防连点（成功路径对话框随外层跳转/新开页关闭，无需提前复位）
+    setExchanging(true)
     try {
       await openLoginUrl(`/login?desktop_redirect=true`)
     } catch (e) {
       toast.error(m.billing_openBrowserFailed({ message: errorMessage(e, m.billing_unknownError()) }))
+    } finally {
       setExchanging(false)
     }
   }

package/src/components/billing/pricing-card.tsx

@@ -1,4 +1,6 @@
 import { Check } from 'lucide-react'
+import { Button } from '@/components/ui/button'
+import { featureLabel } from './feature-label'
 import { m } from "@/paraglide/messages.js";
 
 interface PricingCardProps {
@@ -14,12 +16,13 @@ interface PricingCardProps {
     features: Record<string, boolean>
     providerPriceId?: string | null
   }
+  /** 页面当前选中的结算货币（价格符号以它为准，与 checkout 币种一致） */
   currency: 'usd' | 'cny'
   onSubscribe: (planId: string) => void
 }
 
-export function PricingCard({ plan, onSubscribe }: PricingCardProps) {
-  const currencySymbol = plan.currency === 'usd' ? '$' : '¥'
+export function PricingCard({ plan, currency, onSubscribe }: PricingCardProps) {
+  const currencySymbol = currency === 'usd' ? '$' : '¥'
   const isFree = plan.priceMonthly === 0
 
   return (
@@ -57,24 +60,20 @@ export function PricingCard({ plan, onSubscribe }: PricingCardProps) {
           enabled ? (
             <li key={feature} className="flex items-center gap-2 text-sm">
               <Check size={14} className="text-primary" />
-              <span>{feature}</span>
+              <span>{featureLabel(feature)}</span>
             </li>
           ) : null,
         )}
       </ul>
 
-      <button
+      <Button
         type="button"
         onClick={() => onSubscribe(plan.name)}
         disabled={isFree}
-        className={`w-full py-2 rounded-lg font-medium transition-colors ${
-          isFree
-            ? 'bg-muted text-muted-foreground cursor-default'
-            : 'bg-primary text-primary-foreground hover:bg-primary/90'
-        }`}
+        className={`w-full ${isFree ? 'bg-muted text-muted-foreground' : ''}`}
       >
         {isFree ? m.billing_currentPlan() : m.billing_startTrial()}
-      </button>
+      </Button>
     </div>
   )
-}
+}

package/src/components/billing/pricing-page.tsx

@@ -1,14 +1,36 @@
-import { useState } from 'react'
+import { useEffect, useRef, useState } from 'react'
 import { useLoaderData } from '@tanstack/react-router'
 import { CurrencyToggle } from './currency-toggle'
 import { PricingCard } from './pricing-card'
 import { redirectToCheckout } from './checkout-redirect'
+import { listPublicPlansFn } from '@/server/serverFns/billing'
 import { isChina } from '@/lib/deploy-region'
 import { m } from "@/paraglide/messages.js";
 
 export function PricingPage() {
-  const { plans, currency } = useLoaderData({ from: '/_public/pricing' })
+  const { plans: loaderPlans, currency } = useLoaderData({ from: '/_public/pricing' })
+  // 结算货币单一事实源：CurrencyToggle 受控回调更新，切换即按新币种重取价目
+  // （loader 固定 USD 拉首屏，切换后由客户端重取对齐卡片价格与 checkout 币种）
   const [selectedCurrency, setSelectedCurrency] = useState<'usd' | 'cny'>(currency)
+  const [plans, setPlans] = useState(loaderPlans)
+  const fetchedCurrencyRef = useRef(currency)
+
+  useEffect(() => {
+    if (fetchedCurrencyRef.current === selectedCurrency) return
+    fetchedCurrencyRef.current = selectedCurrency
+    let cancelled = false
+    listPublicPlansFn({ data: { currency: selectedCurrency } })
+      .then((rows) => {
+        if (!cancelled) setPlans(rows)
+      })
+      .catch(() => {
+        // 重取失败保留上一币种价目（checkout 仍以 selectedCurrency 提交，不阻塞切换）
+      })
+    return () => {
+      cancelled = true
+    }
+  }, [selectedCurrency])
+
   const isCn = isChina()
 
   if (plans.length === 0 || isCn) {
@@ -29,7 +51,7 @@ export function PricingPage() {
           {m.billing_trialDescription()}
         </p>
         <div className="mt-4 flex justify-center">
-          <CurrencyToggle />
+          <CurrencyToggle value={selectedCurrency} onChange={setSelectedCurrency} />
         </div>
       </div>
 
@@ -50,4 +72,4 @@ export function PricingPage() {
       </div>
     </div>
   )
-}
+}

package/src/components/billing/seats-manager.tsx

@@ -15,7 +15,7 @@
 // You should have received a copy of the GNU Affero General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-import { useState } from 'react'
+import { useEffect, useState } from 'react'
 import { Link } from '@tanstack/react-router'
 import { Minus, Plus } from 'lucide-react'
 import { toast } from '@/components/ui/toast'
@@ -52,6 +52,13 @@ export function SeatsManager({ subscription, onRefresh }: SeatsManagerProps) {
   const [newAddon, setNewAddon] = useState(subscription?.addonSeats ?? 0)
   const [submitting, setSubmitting] = useState(false)
 
+  // 服务端权威值同步：onRefresh 后父级 subscription 更新（服务端可能对 addonSeats
+  // 钳制/修正），本地草稿随之对齐；值不变时 setState bail-out 无额外渲染
+  const serverAddonSeats = subscription?.status === 'active' ? subscription.addonSeats : 0
+  useEffect(() => {
+    setNewAddon(serverAddonSeats)
+  }, [serverAddonSeats])
+
   const activeSub =
     subscription && subscription.status === 'active' ? subscription : null
   if (!activeSub || planName === 'free') {
@@ -97,7 +104,7 @@ export function SeatsManager({ subscription, onRefresh }: SeatsManagerProps) {
       toast.success(m.billing_seatsManager_success())
       onRefresh()
     } catch (e) {
-      toastError(e, String(e))
+      toastError(e, m.billing_seats_update_failed())
     } finally {
       setSubmitting(false)
     }

package/src/components/billing/subscription-card.tsx

@@ -1,5 +1,6 @@
 import { format } from 'date-fns'
 import { redirectToCheckout, redirectToPortal } from './checkout-redirect'
+import { Button } from '@/components/ui/button'
 import { isChina } from '@/lib/deploy-region'
 import { m } from "@/paraglide/messages.js";
 
@@ -33,12 +34,9 @@ export function SubscriptionCard({
             </p>
           </div>
           {!isCn && (
-            <button
-              onClick={() => redirectToCheckout('pro', 'usd')}
-              className="px-4 py-2 bg-primary text-primary-foreground rounded-lg hover:bg-primary/90 transition-colors"
-            >
+            <Button onClick={() => void redirectToCheckout('pro', 'usd')}>
               {m.billing_upgradeToPro()}
-            </button>
+            </Button>
           )}
           {isCn && (
             <span className="px-4 py-2 text-sm text-muted-foreground bg-muted rounded-lg">
@@ -80,12 +78,9 @@ export function SubscriptionCard({
         </div>
         <div className="flex gap-2">
           {!isCn && (
-            <button
-              onClick={redirectToPortal}
-              className="px-4 py-2 border border-border rounded-lg hover:bg-muted transition-colors"
-            >
+            <Button variant="outline" onClick={() => void redirectToPortal()}>
               {m.billing_manageBilling()}
-            </button>
+            </Button>
           )}
           {isCn && (
             <span className="px-4 py-2 text-sm text-muted-foreground bg-muted rounded-lg border border-border">

package/src/components/billing/upgrade-prompt.tsx

@@ -2,6 +2,7 @@ import { Link } from '@tanstack/react-router'
 import { ArrowRight } from 'lucide-react'
 import { type ReactElement } from 'react'
 import { isChina } from '@/lib/deploy-region'
+import { featureLabel } from './feature-label'
 import { m } from "@/paraglide/messages.js";
 
 interface UpgradePromptProps {
@@ -9,17 +10,7 @@ interface UpgradePromptProps {
 }
 
 export function UpgradePrompt({ feature }: UpgradePromptProps): ReactElement {
-  const featureLabels: Record<string, string> = {
-    multiProvider: m.billing_featureMultiProvider(),
-    hostedAi: m.billing_featureHostedAi(),
-    byokAi: m.billing_featureByokAi(),
-    aiQuota: m.billing_featureAiQuota(),
-    sso: m.billing_featureSso(),
-    auditLog: m.billing_featureAuditLog(),
-    largePageSize: m.billing_featureLargePageSize(),
-  }
-
-  const label = featureLabels[feature] ?? feature
+  const label = featureLabel(feature)
 
   if (isChina()) {
     return (

package/src/components/billing/use-feature.ts

@@ -2,6 +2,11 @@ import { useSubscription } from './subscription-provider'
 import { useSession } from '@/lib/auth/auth-client'
 import { type FeatureKey } from '@allbluecn/kernel'
 
+// 桌面访客会话固定 userId（服务端唯一来源 src/server/desktop-guest.ts 的
+// GUEST_USER_ID；客户端组件禁止 import server 模块，故镜像常量，值由
+// src/lib/__tests__/desktop-guest.test.ts 哨兵钉住）
+const LOCAL_GUEST_USER_ID = 'local-guest'
+
 interface FeatureState {
   enabled: boolean
   loading: boolean
@@ -12,7 +17,7 @@ interface FeatureState {
 export function useFeature(feature: FeatureKey): FeatureState {
   const { features, loading, unavailable } = useSubscription()
   const { data: session } = useSession()
-  const isGuest = session?.user?.id === 'local-guest'
+  const isGuest = session?.user?.id === LOCAL_GUEST_USER_ID
 
   if (unavailable?.includes(feature)) {
     return { enabled: false, loading: false, unavailable: true }

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

@@ -28,7 +28,7 @@ vi.mock("@/server/serverFns/bug", () => h);
 
 import { BugDisplayDropdown, hasBugDisplayChanges } from "../display/display-dropdown";
 import { useBugDisplayOptions } from "../display/use-bug-display-options";
-import { BUG_DISPLAY_PROPERTIES, DEFAULT_BUG_DISPLAY_OPTIONS, type BugDisplayOptions } from "../display/types";
+import { BUG_DISPLAY_PROPERTIES, DEFAULT_BUG_DISPLAY_OPTIONS, type BugDisplayOptions } from "@/shared/bug/display-types";
 
 const OPTIONS: BugDisplayOptions = {
   ...DEFAULT_BUG_DISPLAY_OPTIONS,

package/src/components/bug/__tests__/bug-list-loading-defer.test.tsx

@@ -35,7 +35,7 @@ vi.mock("../views/bug-list/group", () => ({
 vi.mock("../views/bug-list/batch-toolbar", () => ({ BugBatchToolbar: () => null }));
 
 import { BugList } from "../views/bug-list";
-import { DEFAULT_BUG_DISPLAY_OPTIONS } from "../display/types";
+import { DEFAULT_BUG_DISPLAY_OPTIONS } from "@/shared/bug/display-types";
 
 // jsdom 无 ResizeObserver（@tanstack/react-virtual 观察滚动容器需要）
 class NoopResizeObserver {

package/src/components/bug/__tests__/saved-views.test.tsx

@@ -27,7 +27,7 @@ import { render, screen, waitFor, cleanup } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
 import { TooltipProvider } from "@/components/ui/tooltip";
 
-import { DEFAULT_BUG_DISPLAY_OPTIONS, type BugSavedView } from "../display/types";
+import { DEFAULT_BUG_DISPLAY_OPTIONS, type BugSavedView } from "@/shared/bug/display-types";
 import { BugListView } from "../bug-list-view";
 
 const h = vi.hoisted(() => ({

package/src/components/bug/__tests__/toolbar-shell.test.tsx

@@ -70,7 +70,7 @@ vi.mock("../peek-panel", () => ({ BugPeekPanel: () => null }));
 import { BugToolbar } from "../bug-toolbar";
 import { BugListView } from "../bug-list-view";
 import { useToolbarCompact } from "@/components/shared-kit/list-kit/toolbar-shell";
-import { DEFAULT_BUG_DISPLAY_OPTIONS } from "../display/types";
+import { DEFAULT_BUG_DISPLAY_OPTIONS } from "@/shared/bug/display-types";
 
 afterEach(() => {
   cleanup();

package/src/components/bug/__tests__/use-paged-bug-groups.test.tsx

@@ -18,7 +18,7 @@
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { renderHook, waitFor, act, render, screen, fireEvent, cleanup } from "@testing-library/react";
 import type { BugListItem } from "../types";
-import { DEFAULT_BUG_DISPLAY_OPTIONS } from "../display/types";
+import { DEFAULT_BUG_DISPLAY_OPTIONS } from "@/shared/bug/display-types";
 import type { PagedBugsArgs } from "../display/use-paged-bug-groups";
 
 const h = vi.hoisted(() => ({

package/src/components/bug/bug-list-view.tsx

@@ -34,7 +34,7 @@ import {
 import type { UserBrief } from "@/components/story/types";
 import { usePagedBugGroups, type PagedBugGroupNode } from "./display/use-paged-bug-groups";
 import { useBugDisplayOptions } from "./display/use-bug-display-options";
-import type { BugGroupKey } from "./display/types";
+import type { BugGroupKey } from "@/shared/bug/display-types";
 import type { PeekMode } from "@/components/shared-kit/peek/peek-mode";
 import { BugList } from "./views/bug-list";
 import { BugBoardView, type BugBoardGroupDimension } from "./views/board-view";
@@ -152,15 +152,28 @@ export function BugListView({ users: initialUsers, projects: initialProjects, la
     setProjects(initialProjects);
   }, [initialProjects]);
 
+  // 未选项目（含归档）：直接跟随父级全量成员（引用变化即同步，无请求）
   useEffect(() => {
     if (!projectId || projectId === "__archived__") {
       setUsers(initialUsers);
-      return;
     }
+  }, [projectId, initialUsers]);
+
+  // 选定项目：按项目拉成员。依赖仅 projectId——initialUsers 是父级逐帧引用，
+  // 入依赖会在已选项目时反复触发 listUsersBriefFn；拉取失败静默（筛选下拉退化，
+  // 主列表链路不受影响）
+  useEffect(() => {
+    if (!projectId || projectId === "__archived__") return;
+    let cancelled = false;
     listUsersBriefFn({ data: { projectId } })
-      .then((u: UserBrief[]) => setUsers(u))
+      .then((u: UserBrief[]) => {
+        if (!cancelled) setUsers(u);
+      })
       .catch(() => {});
-  }, [projectId, initialUsers]);
+    return () => {
+      cancelled = true;
+    };
+  }, [projectId]);
 
   useEffect(() => {
     let restoredProjectId: string | undefined;
@@ -392,11 +405,20 @@ export function BugListView({ users: initialUsers, projects: initialProjects, la
     [paged.loadMore],
   );
 
-  // 手动排序（拖拽列内/跨列均写目标列 boardOrder）：reorderBugsFn 批量落库
-  const handleBoardReorder = useCallback(async (orders: ReorderEntry[]) => {
-    if (orders.length === 0) return;
-    await reorderBugsFn({ data: { items: orders } });
-  }, []);
+  // 手动排序（拖拽列内/跨列均写目标列 boardOrder）：reorderBugsFn 批量落库。
+  // 失败 toast + refresh 回拉服务端序，避免看板本地顺序与库失配（下次刷新回跳）
+  const handleBoardReorder = useCallback(
+    async (orders: ReorderEntry[]) => {
+      if (orders.length === 0) return;
+      try {
+        await reorderBugsFn({ data: { items: orders } });
+      } catch (e) {
+        toastError(e, m.bug_board_reorder_failed());
+        paged.refresh();
+      }
+    },
+    [paged.refresh],
+  );
 
   // 排序键不是 manual 时 boardOrder 不被读取（拖拽会被排回原位），落库后自动切换
   const handleBoardAutoSwitchManual = useCallback(async () => {

package/src/components/bug/bug-panel-header.tsx

@@ -171,9 +171,14 @@ export function BugPanelHeader({
 
   const handleDelete = async () => {
     if (!bugId || !onDeleted) return;
-    await deleteBugFn({ data: { bugId } });
-    toast.success(m.bug_panel_deleted());
-    onDeleted();
+    try {
+      await deleteBugFn({ data: { bugId } });
+      toast.success(m.bug_panel_deleted());
+      onDeleted();
+    } catch (e) {
+      // 与 handleArchive 对称：失败 toast，确认框交由用户重试或关闭
+      toastError(e, m.bug_panel_delete_failed());
+    }
   };
 
   return (

package/src/components/bug/bug-toolbar.tsx

@@ -57,7 +57,7 @@ import { BugDisplayDropdown } from "./display/display-dropdown";
 import { BugViewSwitcher } from "./views/view-switcher";
 import { ViewSelectorButton } from "./views/view-selector-button";
 import type { BugView, BugViewModel } from "./views/view-types";
-import type { BugDisplayOptions } from "./display/types";
+import type { BugDisplayOptions } from "@/shared/bug/display-types";
 import type { UserBrief } from "@/components/story/types";
 import { m } from "@/paraglide/messages.js";
 import { getLocale } from "@/paraglide/runtime.js";

package/src/components/bug/collect/collect-form.tsx

@@ -137,6 +137,8 @@ export function CollectForm({ token, page }: CollectFormProps) {
           method: "POST",
           headers: { "X-Bug-Key": token },
           body: fd,
+          // 5MB×3 免登录上传的墙钟兜底：慢网不无限挂 submitting（超时走外层 catch 通用错误文案）
+          signal: AbortSignal.timeout(60_000),
         });
         const json = (await res.json().catch(() => null)) as
           | { ok: boolean; blobIds?: string[] }

package/src/components/bug/create-bug-dialog.tsx

@@ -33,6 +33,7 @@ import { StateEditor, SeverityEditor, AssigneeEditor, LabelsEditor } from "./inl
 import { ReproduceStepsEditor } from "./reproduce-steps-editor";
 import type { BugListItem, ReproduceSteps } from "./types";
 import { NotionDocEditor } from "@/components/tiptap/notion-like";
+import { errorMessage } from "@/lib/toast-error";
 import { m } from "@/paraglide/messages.js";
 
 /**
@@ -182,7 +183,7 @@ export function CreateBugDialog({
       onOpenChange(false);
       onSuccess?.(bug);
     } catch (e) {
-      setError(e instanceof Error ? e.message : m.bug_list_create_failed());
+      setError(errorMessage(e, m.bug_list_create_failed()));
     } finally {
       setLoading(false);
     }