@allbluecn/web-app 0.19.2 → 0.19.4

package/src/components/knowledge/knowledge-tree-item.tsx

@@ -15,8 +15,8 @@
 // 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, useRef } from 'react'
-import { ChevronDown, ChevronRight, FileText, Grid3X3, Home, MoreHorizontal, Network, Plus, Table, Trash2, FilePenLine, Check, X } from 'lucide-react'
+import { useEffect, useState, useRef } from 'react'
+import { Check, ChevronDown, ChevronRight, FileText, Home, MoreHorizontal, Plus, Trash2, FilePenLine, X } from 'lucide-react'
 import { cn } from '@/lib/utils'
 import { Input } from '@/components/ui/input'
 import { Button } from '@/components/ui/button'
@@ -41,6 +41,8 @@ import {
   DialogTitle,
 } from '@/components/ui/dialog'
 import { createDocumentFn, deleteDocumentFn, updateDocumentFn } from '@/server/serverFns/knowledge'
+import { toastError } from '@/lib/toast-error'
+import { DOC_TYPE_OPTIONS, TYPE_DEFAULTS, TYPE_ICONS } from '@/components/knowledge/doc-type-meta'
 import { m } from "@/paraglide/messages.js";
 
 const MAX_DEPTH = 19
@@ -71,27 +73,6 @@ interface KnowledgeTreeItemProps {
   onToggleExpand: () => void
 }
 
-const TYPE_DEFAULTS: Record<string, () => string> = {
-  doc: m.knowledge_untitledDoc,
-  mindmap: m.knowledge_untitledMindmap,
-  sheet: m.knowledge_untitledSheet,
-  table: m.knowledge_untitledTable,
-}
-
-const TYPE_ICONS: Record<string, React.ComponentType<{ className?: string }>> = {
-  doc: FileText,
-  mindmap: Network,
-  sheet: Table,
-  table: Grid3X3,
-}
-
-const DOC_TYPE_OPTIONS = [
-  { type: 'doc' as const, label: m.knowledge_treeType_doc, icon: FileText },
-  { type: 'mindmap' as const, label: m.knowledge_treeType_mindmap, icon: Network },
-  { type: 'sheet' as const, label: m.knowledge_treeType_sheet, icon: Table, disabled: true },
-  { type: 'table' as const, label: m.knowledge_treeType_table, icon: Grid3X3, disabled: true },
-]
-
 export function KnowledgeTreeItem({
   node, depth, hasChildren, activeDocId, isHomePage, kbId,
   onSelect, onHome, onRefresh, onDocRenamed, expanded, onToggleExpand,
@@ -119,7 +100,7 @@ export function KnowledgeTreeItem({
       onRefresh()
       onDocRenamed?.(node.id)
     } catch (e) {
-      console.error('Rename failed:', e instanceof Error ? e.message : String(e))
+      toastError(e, m.common_operationFailed())
     }
     finishEditing()
   }
@@ -133,7 +114,7 @@ export function KnowledgeTreeItem({
       setDeleteConfirm('')
       onRefresh()
     } catch (e) {
-      console.error('Delete failed:', e instanceof Error ? e.message : String(e))
+      toastError(e, m.common_operationFailed())
     }
     setDeleting(false)
   }
@@ -143,22 +124,29 @@ export function KnowledgeTreeItem({
     setChildType(type)
     setChildTitle(TYPE_DEFAULTS[type]?.() ?? m.knowledge_untitledDoc())
     if (!expanded) onToggleExpand()
-    setTimeout(() => childInputRef.current?.focus(), 50)
   }
 
+  // 创建输入行出现后聚焦（带 cleanup，避免卸载后触发）
+  useEffect(() => {
+    if (!creatingChild) return
+    const timer = setTimeout(() => childInputRef.current?.focus(), 50)
+    return () => clearTimeout(timer)
+  }, [creatingChild])
+
   const handleConfirmCreateChild = async () => {
     if (!childTitle.trim()) { setCreatingChild(false); return }
     const title = childTitle.trim()
     const type = childType
-    setCreatingChild(false)
     try {
       const doc = await createDocumentFn({
         data: { kbId, parentId: node.id, title, type: type as 'doc' | 'mindmap' | 'sheet' | 'table' },
       })
+      setCreatingChild(false)
       onRefresh()
       onSelect(doc.id)
     } catch (e) {
-      console.error('Create child failed:', e instanceof Error ? e.message : String(e))
+      // 失败保留输入行与标题，用户无需重输
+      toastError(e, m.common_operationFailed())
     }
   }
 

package/src/components/knowledge/knowledge-tree.tsx

@@ -15,10 +15,8 @@
 // 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, useCallback, useRef } from 'react'
-import {
-  Plus, FileText, Table, Grid3X3, Network,
-} from 'lucide-react'
+import { useEffect, useMemo, useState, useCallback, useRef } from 'react'
+import { Plus } from 'lucide-react'
 import { Button } from '@/components/ui/button'
 import { Input } from '@/components/ui/input'
 import {
@@ -29,6 +27,8 @@ import {
 } from '@/components/ui/dropdown-menu'
 import { KnowledgeTreeItem, TreeNode } from './knowledge-tree-item'
 import { createDocumentFn, listDocumentsFn } from '@/server/serverFns/knowledge'
+import { toastError } from '@/lib/toast-error'
+import { DOC_TYPE_OPTIONS, TYPE_DEFAULTS } from '@/components/knowledge/doc-type-meta'
 import { m } from "@/paraglide/messages.js";
 
 interface KnowledgeTreeProps {
@@ -41,20 +41,6 @@ interface KnowledgeTreeProps {
   onDocRenamed?: (docId: string) => void
 }
 
-const DOC_TYPE_OPTIONS = [
-  { type: 'doc' as const, label: m.knowledge_treeType_doc, icon: FileText },
-  { type: 'mindmap' as const, label: m.knowledge_treeType_mindmap, icon: Network },
-  { type: 'sheet' as const, label: m.knowledge_treeType_sheet, icon: Table, disabled: true },
-  { type: 'table' as const, label: m.knowledge_treeType_table, icon: Grid3X3, disabled: true },
-]
-
-const TYPE_DEFAULTS: Record<string, () => string> = {
-  doc: m.knowledge_untitledDoc,
-  mindmap: m.knowledge_untitledMindmap,
-  sheet: m.knowledge_untitledSheet,
-  table: m.knowledge_untitledTable,
-}
-
 function flattenTree(
   nodes: TreeNode[],
   expandedIds: Set<string>,
@@ -100,15 +86,21 @@ export function KnowledgeTree({
   const [creatingType, setCreatingType] = useState<string | null>(null)
   const [creatingTitle, setCreatingTitle] = useState('')
   const creatingInputRef = useRef<HTMLInputElement>(null)
+  // 竞态守卫：kbId 快速切换时丢弃晚到的旧响应（序号 latest-wins）
+  const fetchSeqRef = useRef(0)
+  // 挂载时的 treeRefreshKey 已由下方首个 effect 覆盖，防重复请求
+  const prevTreeRefreshKeyRef = useRef(treeRefreshKey)
 
   const fetchDocuments = useCallback(async () => {
+    const seq = ++fetchSeqRef.current
     try {
       const docs = await listDocumentsFn({ data: { kbId } })
+      if (seq !== fetchSeqRef.current) return
       setDocuments(docs as TreeNode[])
     } catch (e) {
       console.error('Failed to fetch documents:', e instanceof Error ? e.message : String(e))
     } finally {
-      setLoading(false)
+      if (seq === fetchSeqRef.current) setLoading(false)
     }
   }, [kbId])
 
@@ -117,7 +109,8 @@ export function KnowledgeTree({
   }, [fetchDocuments])
 
   useEffect(() => {
-    if (treeRefreshKey !== undefined && treeRefreshKey > 0) {
+    if (treeRefreshKey !== undefined && treeRefreshKey > 0 && treeRefreshKey !== prevTreeRefreshKeyRef.current) {
+      prevTreeRefreshKeyRef.current = treeRefreshKey
       fetchDocuments()
     }
   }, [treeRefreshKey, fetchDocuments])
@@ -138,7 +131,10 @@ export function KnowledgeTree({
     })
   }, [])
 
-  const flatNodes = flattenTree(documents, expandedIds)
+  const flatNodes = useMemo(
+    () => flattenTree(documents, expandedIds),
+    [documents, expandedIds],
+  )
 
   const handleStartCreate = (type: string) => {
     setCreatingType(type)
@@ -157,7 +153,7 @@ export function KnowledgeTree({
       await fetchDocuments()
       onSelect(doc.id)
     } catch (e) {
-      console.error('Create failed:', e instanceof Error ? e.message : String(e))
+      toastError(e, m.common_operationFailed())
     }
   }
 

package/src/components/knowledge/public/bookmark-card.tsx

@@ -24,6 +24,7 @@ import { HoverCard, HoverCardContent, HoverCardTrigger } from '@/components/ui/h
 import { Star, GitBranch, RefreshCw, ExternalLink, Pencil } from 'lucide-react'
 import { CategoryIcon } from './category-icon'
 import { cn } from '@/lib/utils'
+import { toSafeHref } from '@/lib/safe-url'
 import { m } from "@/paraglide/messages.js";
 
 interface BookmarkItem {
@@ -64,7 +65,11 @@ export function BookmarkCard({
   onShareToggle?: () => void
   onFavoriteToggle?: () => void
 }) {
-  const open = () => window.open(item.url, '_blank', 'noopener,noreferrer')
+  // 落库 URL 可能含 javascript: 等伪协议（历史数据/旁路写入），open 前做 scheme 白名单
+  const open = () => {
+    const href = toSafeHref(item.url, { allowRelative: false })
+    if (href) window.open(href, '_blank', 'noopener,noreferrer')
+  }
   const stale = !item.githubSyncedAt || isStale(item.githubSyncedAt)
   const isPublic = item.visibility === 'public'
   const isOwner = !!item.isOwner
@@ -242,6 +247,9 @@ function fmt(d: Date | string) {
   return m.knowledge_bookmarkCard_yearsAgo({ years: Math.floor(days / 365) })
 }
 
+/** GitHub 同步过期阈值：6 小时（产品口径：上游仓库日级变更为常态，超过即提示可同步） */
+const GITHUB_SYNC_STALE_MS = 6 * 60 * 60 * 1000
+
 function isStale(d: Date | string) {
-  return Date.now() - new Date(d).getTime() > 6 * 60 * 60 * 1000
+  return Date.now() - new Date(d).getTime() > GITHUB_SYNC_STALE_MS
 }

package/src/components/knowledge/public/industry-options.ts

@@ -0,0 +1,36 @@
+// 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/>.
+
+// 行业筛选项共享定义（审计 A5x-2 🔵）：compliance / dictionaries 两个 index 页
+// 原各有一份逐字重复的 buildIndustryOptions，复用同一批
+// knowledge_compliance_industries_* i18n key。
+import { m } from '@/paraglide/messages.js'
+
+export function buildIndustryOptions() {
+  return [
+    { value: 'internet', label: m.knowledge_compliance_industries_internet() },
+    { value: 'finance', label: m.knowledge_compliance_industries_finance() },
+    { value: 'medical', label: m.knowledge_compliance_industries_medical() },
+    { value: 'education', label: m.knowledge_compliance_industries_education() },
+    { value: 'manufacturing', label: m.knowledge_compliance_industries_manufacturing() },
+    { value: 'energy', label: m.knowledge_compliance_industries_energy() },
+    { value: 'transportation', label: m.knowledge_compliance_industries_transportation() },
+    { value: 'ecommerce', label: m.knowledge_compliance_industries_ecommerce() },
+    { value: 'gaming', label: m.knowledge_compliance_industries_gaming() },
+    { value: 'general', label: m.knowledge_compliance_industries_general() },
+  ]
+}

package/src/components/knowledge/public/legal-detail-actions.tsx

@@ -0,0 +1,286 @@
+// 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/>.
+
+// compliance / laws 两个公开知识详情页的操作区共享组件（审计 A5x-2 🔵）：
+// 两页 actions JSX 原为 ~130 行逐字复制，仅 i18n 前缀与服务端 fn 不同；
+// 收敛后交互逻辑（删除确认/分享开关/收藏/复制链接）单点维护。
+// 附带统一修复：收藏与剪贴板操作补 try-catch + toast，复制链接仅公开条目可见。
+
+import { shareResultMessage } from '@/lib/knowledge/share-result-message'
+import { useState } from 'react'
+import { Link, useNavigate } from '@tanstack/react-router'
+import { useQueryClient } from '@tanstack/react-query'
+import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger } from '@/components/ui/alert-dialog'
+import { Button } from '@/components/ui/button'
+import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip'
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '@/components/ui/dropdown-menu'
+import { Share2, ArrowLeft, Pencil, Trash2, Link2, Globe, Star } from 'lucide-react'
+import { cn } from '@/lib/utils'
+import { toggleFavoriteFn } from '@/server/serverFns/knowledge/public/favorite'
+import { deleteComplianceFn } from '@/server/serverFns/knowledge/public/compliance/delete'
+import { shareComplianceFn } from '@/server/serverFns/knowledge/public/compliance/share'
+import { unshareComplianceFn } from '@/server/serverFns/knowledge/public/compliance/unshare'
+import { deleteLegalFn } from '@/server/serverFns/knowledge/public/legal/delete'
+import { shareLegalFn } from '@/server/serverFns/knowledge/public/legal/share'
+import { unshareLegalFn } from '@/server/serverFns/knowledge/public/legal/unshare'
+import { toast } from '@/components/ui/toast'
+import { m } from '@/paraglide/messages.js'
+import { toastError } from '@/lib/toast-error'
+import { SharersAvatarGroup } from '@/components/knowledge/public/sharers-avatar-group'
+
+export interface LegalDetailActionsMessages {
+  cancel: string
+  confirmDeleteTitle: string
+  confirmDeleteDesc: string
+  delete: string
+  deleteFailed: string
+  deleted: string
+  edit: string
+  favorite: string
+  favorited: string
+  unfavorite: string
+  unfavorited: string
+  copyLink: string
+  copyShareLink: string
+  linkCopied: string
+  share: string
+  shareFailed: string
+  sharePublic: string
+  unshare: string
+  unshareFailed: string
+  unshared: string
+}
+
+interface Sharer {
+  id: string
+  username: string
+  avatarConfig: unknown
+  bgShape: string | null
+  bgColor: string | null
+}
+
+export interface LegalDetailActionsProps {
+  id: string
+  entityType: 'compliance' | 'legal'
+  isOwn: boolean
+  isPublic: boolean
+  hasShared: boolean
+  canonicalId: string | null
+  favorited: boolean
+  sharers?: Sharer[] | null
+  currentUserId?: string
+  /** 详情查询 key（分享开关后失效重拉） */
+  detailQueryKey: readonly unknown[]
+  /** 列表查询失效前缀（删除/收藏后失效） */
+  listQueryKey: string
+  /** 收藏 ids 查询 key（收藏切换后失效） */
+  favoriteQueryKey: readonly unknown[]
+  editTo: string
+  /** 公开分享链接前缀，如 /share/compliance */
+  shareBasePath: string
+  msg: LegalDetailActionsMessages
+}
+
+async function copyToClipboard(text: string): Promise<boolean> {
+  try {
+    await navigator.clipboard.writeText(text)
+    return true
+  } catch {
+    return false
+  }
+}
+
+export function LegalDetailActions({
+  id,
+  entityType,
+  isOwn,
+  isPublic,
+  hasShared,
+  canonicalId,
+  favorited,
+  sharers,
+  currentUserId,
+  detailQueryKey,
+  listQueryKey,
+  favoriteQueryKey,
+  editTo,
+  shareBasePath,
+  msg,
+}: LegalDetailActionsProps) {
+  const navigate = useNavigate()
+  const qc = useQueryClient()
+  const [deleteOpen, setDeleteOpen] = useState(false)
+  const [sharing, setSharing] = useState(false)
+  const shareUrl = `${window.location.origin}${shareBasePath}/${id}`
+
+  const handleDelete = async () => {
+    try {
+      await (entityType === 'compliance'
+        ? deleteComplianceFn({ data: { id } })
+        : deleteLegalFn({ data: { id } }))
+      toast.success(msg.deleted)
+      qc.invalidateQueries({ queryKey: [listQueryKey] })
+      await navigate({ to: entityType === 'compliance' ? '/knowledge/compliance' : '/knowledge/laws' })
+    } catch {
+      toast.error(msg.deleteFailed)
+    }
+  }
+
+  const handleToggleFavorite = async () => {
+    try {
+      const r = await toggleFavoriteFn({ data: { entityType, entityId: id } })
+      toast.success(r.favorited ? msg.favorited : msg.unfavorited)
+      qc.invalidateQueries({ queryKey: favoriteQueryKey })
+      qc.invalidateQueries({ queryKey: [listQueryKey] })
+    } catch (e) {
+      toastError(e, m.common_operationFailed())
+    }
+  }
+
+  const handleCopy = async () => {
+    const ok = await copyToClipboard(shareUrl)
+    if (ok) {
+      toast.success(msg.linkCopied)
+    } else {
+      toast.error(m.common_clipboard_copyFailed())
+    }
+  }
+
+  const ownerActions = (
+    <>
+      <AlertDialog open={deleteOpen} onOpenChange={setDeleteOpen}>
+        <Tooltip>
+          <TooltipTrigger render={<AlertDialogTrigger render={<Button variant="ghost" size="icon" className="text-destructive hover:text-destructive" />} />}>
+            <Trash2 className="h-4 w-4" />
+          </TooltipTrigger>
+          <TooltipContent>{msg.delete}</TooltipContent>
+        </Tooltip>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>{msg.confirmDeleteTitle}</AlertDialogTitle>
+            <AlertDialogDescription>{msg.confirmDeleteDesc}</AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>{msg.cancel}</AlertDialogCancel>
+            <AlertDialogAction onClick={handleDelete}>{msg.delete}</AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+      <Tooltip>
+        <TooltipTrigger render={<Button variant="ghost" size="icon" onClick={() => navigate({ to: editTo, params: { id } })} />}>
+          <Pencil className="h-4 w-4" />
+        </TooltipTrigger>
+        <TooltipContent>{msg.edit}</TooltipContent>
+      </Tooltip>
+      <DropdownMenu>
+        <Tooltip>
+          <TooltipTrigger render={<DropdownMenuTrigger render={<Button variant="ghost" size="icon" disabled={sharing} />} />}>
+            <Share2 className="h-4 w-4" />
+          </TooltipTrigger>
+          <TooltipContent>{msg.share}</TooltipContent>
+        </Tooltip>
+        <DropdownMenuContent align="end" className="w-40">
+          {hasShared ? (
+            <DropdownMenuItem onClick={async () => {
+              if (!canonicalId) return
+              setSharing(true)
+              try {
+                await (entityType === 'compliance'
+                  ? unshareComplianceFn({ data: { canonicalId } })
+                  : unshareLegalFn({ data: { canonicalId } }))
+                toast.success(msg.unshared)
+                qc.invalidateQueries({ queryKey: detailQueryKey })
+              } catch (e) {
+                toastError(e, msg.unshareFailed)
+              } finally {
+                setSharing(false)
+              }
+            }}>
+              <Globe className="mr-2 h-4 w-4" />
+              {msg.unshare}
+            </DropdownMenuItem>
+          ) : (
+            <DropdownMenuItem onClick={async () => {
+              setSharing(true)
+              try {
+                const r = entityType === 'compliance'
+                  ? await shareComplianceFn({ data: { id } })
+                  : await shareLegalFn({ data: { id } })
+                toast.success(shareResultMessage(r.action))
+                qc.invalidateQueries({ queryKey: detailQueryKey })
+              } catch (e) {
+                toastError(e, msg.shareFailed)
+              } finally {
+                setSharing(false)
+              }
+            }}>
+              <Globe className="mr-2 h-4 w-4" />
+              {msg.sharePublic}
+            </DropdownMenuItem>
+          )}
+          {/* 仅公开条目可复制分享链接：私有内容的 /share/ 链接对他人不可用 */}
+          {isPublic && (
+            <DropdownMenuItem onClick={handleCopy}>
+              <Link2 className="mr-2 h-4 w-4" />
+              {msg.copyLink}
+            </DropdownMenuItem>
+          )}
+        </DropdownMenuContent>
+      </DropdownMenu>
+    </>
+  )
+
+  const visitorActions = (
+    <>
+      <Tooltip>
+        <TooltipTrigger render={<Button variant="ghost" size="icon" onClick={handleToggleFavorite} />}>
+          <Star className={cn('h-4 w-4', favorited && 'fill-amber-400 text-amber-400')} />
+        </TooltipTrigger>
+        <TooltipContent>{favorited ? msg.unfavorite : msg.favorite}</TooltipContent>
+      </Tooltip>
+      {isPublic && (
+        <Tooltip>
+          <TooltipTrigger render={<Button variant="ghost" size="icon" onClick={handleCopy} />}>
+            <Share2 className="h-4 w-4" />
+          </TooltipTrigger>
+          <TooltipContent>{msg.copyShareLink}</TooltipContent>
+        </Tooltip>
+      )}
+    </>
+  )
+
+  return (
+    <>
+      {isOwn ? ownerActions : visitorActions}
+      {isPublic && sharers?.length ? (
+        <SharersAvatarGroup sharers={sharers} currentUserId={currentUserId} />
+      ) : null}
+    </>
+  )
+}
+
+/** 两页共用的返回按钮（KnowledgeDocEditor backButton 槽位） */
+export function LegalDetailBackButton({ backTo, label }: { backTo: string; label: string }) {
+  return (
+    <Tooltip>
+      <TooltipTrigger render={<Link to={backTo} className="inline-flex items-center text-foreground hover:text-muted-foreground transition-colors" />}>
+        <ArrowLeft className="size-8" />
+      </TooltipTrigger>
+      <TooltipContent>{label}</TooltipContent>
+    </Tooltip>
+  )
+}

package/src/components/layout/sidebar-03/nav-main.tsx

@@ -144,9 +144,9 @@ export default function DashboardNavigation({ routes }: { routes: Route[] }) {
                         {!isCollapsed && (
 <span className="ml-2 flex-1 text-sm font-medium">
                              {route.title()}
-                             {route.badge()?.trim() && (
+                             {route.badge?.()?.trim() && (
                                <Badge className="ml-2 bg-green-50 text-green-700 border-green-400 dark:bg-green-950 dark:text-green-300 ">
-                                 <AnimatedGradientText speed={2} colorFrom="#8ECEAA" colorTo="#2A7E3B">{route.badge()}</AnimatedGradientText>
+                                 <AnimatedGradientText speed={2} colorFrom="#8ECEAA" colorTo="#2A7E3B">{route.badge?.()}</AnimatedGradientText>
                                </Badge>
                              )}
                            </span>

package/src/components/magicui/__tests__/word-rotate.test.tsx

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**
+ * WordRotate 边界输入（审计 A85 回归）：
+ * - 空 words 数组：% 0 = NaN 索引，渲染 undefined 内容 → early return null
+ * - 重复词条：key 含 index 前缀，AnimatePresence mode="wait" 切换不错乱
+ */
+import { describe, expect, it } from "vitest"
+import { render } from "@testing-library/react"
+
+import { WordRotate } from "../word-rotate"
+
+describe("WordRotate 边界输入", () => {
+  it("空 words 数组渲染空容器（不抛错、不渲染 NaN 内容）", () => {
+    const { container } = render(<WordRotate words={[]} />)
+    // early return null：外层 span 内无内容 span
+    expect(container.querySelector("span > span")).toBeNull()
+    expect(container.textContent).toBe("")
+  })
+
+  it("重复词条正常渲染与切换（key 冲突回归哨兵）", () => {
+    const { container, rerender } = render(<WordRotate words={["a", "a"]} />)
+    expect(container.textContent).toBe("a")
+    // 词条整体切换触发 key 变化（0-a → 0-b），AnimatePresence 卸旧挂新
+    rerender(<WordRotate words={["b", "b"]} />)
+    expect(container.textContent).toBe("b")
+  })
+})

package/src/components/magicui/primitives/animate/slot.tsx

@@ -78,22 +78,30 @@ function Slot<T extends HTMLElement = HTMLElement>({
   ref,
   ...props
 }: SlotProps<T>) {
+  // 守卫先于 children.type 解引用：children 为 null/undefined（条件渲染穿透）
+  // 时旧写法在 isValidElement 判定前就访问 .type 抛 TypeError。守卫收敛为
+  // isValid 布尔（hooks 顺序恒定，useMemo 不得条件化）
+  const isValid = React.isValidElement(children);
   const isAlreadyMotion =
-    typeof children.type === 'object' &&
-    children.type !== null &&
-    isMotionComponent(children.type);
+    isValid &&
+    typeof (children as { type?: unknown }).type === 'object' &&
+    (children as { type?: unknown }).type !== null &&
+    isMotionComponent((children as React.ReactElement).type);
 
   const Base = React.useMemo(
     () =>
-      isAlreadyMotion
-        ? (children.type as React.ElementType)
-        : m.create(children.type as React.ElementType),
-    [isAlreadyMotion, children.type],
+      !isValid
+        ? null
+        : isAlreadyMotion
+          ? ((children as React.ReactElement).type as React.ElementType)
+          : m.create((children as React.ReactElement).type as React.ElementType),
+    [isAlreadyMotion, isValid, isValid ? (children as React.ReactElement).type : null],
   );
 
-  if (!React.isValidElement(children)) return null;
+  if (!isValid || !Base) return null;
 
-  const { ref: childRef, ...childProps } = children.props as AnyProps;
+  const { ref: childRef, ...childProps } = (children as React.ReactElement)
+    .props as AnyProps;
 
   const mergedProps = mergeProps(childProps, props);
 

package/src/components/magicui/primitives/animate/tooltip.tsx

@@ -171,6 +171,16 @@ function TooltipProvider({
     };
   }, [hideImmediate]);
 
+  // 卸载清理：pending 的 show/hide 延时定时器不再触发 setCurrentTooltip
+  React.useEffect(() => {
+    return () => {
+      if (timeoutRef.current !== null) {
+        clearTimeout(timeoutRef.current);
+        timeoutRef.current = null;
+      }
+    };
+  }, []);
+
   return (
     <GlobalTooltipProvider
       value={{