From 197e4cab9c07d7f9a7117bfb3c1981621f3d0995 Mon Sep 17 00:00:00 2001
From: KDB <937925477@qq.com>
Date: Tue, 11 Aug 2026 19:43:16 +0800
Subject: [PATCH] fix(frontend): clear lint issues and enforce lint gate

---
 .github/workflows/ci.yml                      |   6 +-
 frontend/.eslintrc.cjs                        |   4 +-
 frontend/@/components/ui/alert-dialog.tsx     | 141 --------------
 frontend/@/components/ui/badge.tsx            |  36 ----
 frontend/@/components/ui/button.tsx           |  56 ------
 frontend/@/components/ui/card.tsx             |  79 --------
 frontend/@/components/ui/form.tsx             | 176 ------------------
 frontend/@/components/ui/input.tsx            |  22 ---
 frontend/@/components/ui/label.tsx            |  26 ---
 frontend/@/components/ui/progress.tsx         |  28 ---
 frontend/@/components/ui/select.tsx           | 158 ----------------
 frontend/@/components/ui/separator.tsx        |  29 ---
 frontend/@/components/ui/sheet.tsx            | 138 --------------
 frontend/@/components/ui/table.tsx            | 117 ------------
 frontend/@/components/ui/tabs.tsx             |  53 ------
 frontend/@/components/ui/textarea.tsx         |  22 ---
 frontend/src/App.tsx                          |   2 +-
 frontend/src/components/admin/AgentAvatar.tsx |  41 +---
 .../src/components/admin/AgentModeLabel.tsx   |   6 +-
 .../components/admin/agentAvatarPresets.ts    |  39 ++++
 .../src/components/admin/agentModeLabels.ts   |   7 +
 .../src/components/chat/FeedbackButtons.tsx   |   1 -
 .../src/components/chat/MarkdownRenderer.tsx  |  63 ++++---
 frontend/src/components/chat/MessageList.tsx  |   2 +-
 .../components/document/DocumentPreview.tsx   |  36 +---
 .../src/components/document/previewUtils.ts   |  29 +++
 frontend/src/components/ui/badge.tsx          |   6 +-
 frontend/src/components/ui/button.tsx         |   6 +-
 frontend/src/components/ui/form.tsx           |   1 +
 frontend/src/hooks/useStreamResponse.ts       |   1 +
 frontend/src/lib/source.ts                    |   1 +
 frontend/src/pages/admin/AdminLayout.tsx      |   7 +-
 .../pages/admin/agents/AgentProfilePage.tsx   |   6 +-
 .../admin/change-logs/BizChangeLogPage.tsx    |  10 +-
 .../pages/admin/dashboard/DashboardPage.tsx   |   5 +-
 .../pages/admin/ingestion/IngestionPage.tsx   |  36 ++--
 .../admin/intent-tree/IntentTreePage.tsx      |   4 +
 .../admin/knowledge/KnowledgeChunksPage.tsx   |  14 +-
 .../knowledge/KnowledgeDocumentsPage.tsx      |  33 ++--
 .../admin/knowledge/KnowledgeListPage.tsx     |   6 +-
 .../QueryTermMappingPage.tsx                  |   8 +-
 .../sample-questions/SampleQuestionPage.tsx   |   8 +-
 .../pages/admin/traces/RagTraceDetailPage.tsx |   7 +-
 .../src/pages/admin/traces/RagTracePage.tsx   |  51 ++---
 .../src/pages/admin/users/UserListPage.tsx    |   8 +-
 frontend/src/router.tsx                       | 166 +----------------
 frontend/src/routerConfig.tsx                 | 169 +++++++++++++++++
 frontend/src/services/authService.ts          |   6 +-
 frontend/src/services/chatService.ts          |   8 +-
 frontend/src/services/sessionService.ts       |   8 +-
 frontend/src/stores/authStore.ts              |   3 -
 frontend/src/stores/chatStore.ts              |  19 +-
 52 files changed, 446 insertions(+), 1468 deletions(-)
 delete mode 100644 frontend/@/components/ui/alert-dialog.tsx
 delete mode 100644 frontend/@/components/ui/badge.tsx
 delete mode 100644 frontend/@/components/ui/button.tsx
 delete mode 100644 frontend/@/components/ui/card.tsx
 delete mode 100644 frontend/@/components/ui/form.tsx
 delete mode 100644 frontend/@/components/ui/input.tsx
 delete mode 100644 frontend/@/components/ui/label.tsx
 delete mode 100644 frontend/@/components/ui/progress.tsx
 delete mode 100644 frontend/@/components/ui/select.tsx
 delete mode 100644 frontend/@/components/ui/separator.tsx
 delete mode 100644 frontend/@/components/ui/sheet.tsx
 delete mode 100644 frontend/@/components/ui/table.tsx
 delete mode 100644 frontend/@/components/ui/tabs.tsx
 delete mode 100644 frontend/@/components/ui/textarea.tsx
 create mode 100644 frontend/src/components/admin/agentAvatarPresets.ts
 create mode 100644 frontend/src/components/admin/agentModeLabels.ts
 create mode 100644 frontend/src/components/document/previewUtils.ts
 create mode 100644 frontend/src/routerConfig.tsx

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 9a8fb3641..61ccaece7 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -77,8 +77,6 @@ jobs:
         run: npm run test
 
       - name: Lint
-        # 仓库既有代码存在 21 个存量 lint error（配置加载原就崩溃，从未跑通过），
-        # 修复属于业务代码改造，列入后续计划；此处先启用 lint 并完整记录结果，
-        # 不阻塞 CI，也不假装 lint 已全绿。
-        continue-on-error: true
+        # 硬门禁：存量 lint 问题已清零（含 0 warnings，--max-warnings 0），
+        # lint 成为与 build/test 同级的前端质量门禁。
         run: npm run lint
diff --git a/frontend/.eslintrc.cjs b/frontend/.eslintrc.cjs
index 01247e808..0ed72e497 100644
--- a/frontend/.eslintrc.cjs
+++ b/frontend/.eslintrc.cjs
@@ -24,6 +24,8 @@ module.exports = {
   rules: {
     "react/react-in-jsx-scope": "off",
     "react/prop-types": "off",
-    "react-refresh/only-export-components": "error"
+    // allowConstantExport 放行 cva 变体常量（badge/button）与只读常量导出（AgentModeLabel），
+    // 这是 shadcn/ui 组件结构的官方推荐配置，常量不参与 fast refresh 失效问题。
+    "react-refresh/only-export-components": ["error", { "allowConstantExport": true }]
   }
 };
diff --git a/frontend/@/components/ui/alert-dialog.tsx b/frontend/@/components/ui/alert-dialog.tsx
deleted file mode 100644
index 25e7b4744..000000000
--- a/frontend/@/components/ui/alert-dialog.tsx
+++ /dev/null
@@ -1,141 +0,0 @@
-"use client"
-
-import * as React from "react"
-import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog"
-
-import { cn } from "@/lib/utils"
-import { buttonVariants } from "@/components/ui/button"
-
-const AlertDialog = AlertDialogPrimitive.Root
-
-const AlertDialogTrigger = AlertDialogPrimitive.Trigger
-
-const AlertDialogPortal = AlertDialogPrimitive.Portal
-
-const AlertDialogOverlay = React.forwardRef<
-  React.ElementRef<typeof AlertDialogPrimitive.Overlay>,
-  React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Overlay>
->(({ className, ...props }, ref) => (
-  <AlertDialogPrimitive.Overlay
-    className={cn(
-      "fixed inset-0 z-50 bg-black/80  data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
-      className
-    )}
-    {...props}
-    ref={ref}
-  />
-))
-AlertDialogOverlay.displayName = AlertDialogPrimitive.Overlay.displayName
-
-const AlertDialogContent = React.forwardRef<
-  React.ElementRef<typeof AlertDialogPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Content>
->(({ className, ...props }, ref) => (
-  <AlertDialogPortal>
-    <AlertDialogOverlay />
-    <AlertDialogPrimitive.Content
-      ref={ref}
-      className={cn(
-        "fixed left-[50%] top-[50%] z-50 grid w-full max-w-lg translate-x-[-50%] translate-y-[-50%] gap-4 border bg-background p-6 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[48%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[48%] sm:rounded-lg",
-        className
-      )}
-      {...props}
-    />
-  </AlertDialogPortal>
-))
-AlertDialogContent.displayName = AlertDialogPrimitive.Content.displayName
-
-const AlertDialogHeader = ({
-  className,
-  ...props
-}: React.HTMLAttributes<HTMLDivElement>) => (
-  <div
-    className={cn(
-      "flex flex-col space-y-2 text-center sm:text-left",
-      className
-    )}
-    {...props}
-  />
-)
-AlertDialogHeader.displayName = "AlertDialogHeader"
-
-const AlertDialogFooter = ({
-  className,
-  ...props
-}: React.HTMLAttributes<HTMLDivElement>) => (
-  <div
-    className={cn(
-      "flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2",
-      className
-    )}
-    {...props}
-  />
-)
-AlertDialogFooter.displayName = "AlertDialogFooter"
-
-const AlertDialogTitle = React.forwardRef<
-  React.ElementRef<typeof AlertDialogPrimitive.Title>,
-  React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Title>
->(({ className, ...props }, ref) => (
-  <AlertDialogPrimitive.Title
-    ref={ref}
-    className={cn("text-lg font-semibold", className)}
-    {...props}
-  />
-))
-AlertDialogTitle.displayName = AlertDialogPrimitive.Title.displayName
-
-const AlertDialogDescription = React.forwardRef<
-  React.ElementRef<typeof AlertDialogPrimitive.Description>,
-  React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Description>
->(({ className, ...props }, ref) => (
-  <AlertDialogPrimitive.Description
-    ref={ref}
-    className={cn("text-sm text-muted-foreground", className)}
-    {...props}
-  />
-))
-AlertDialogDescription.displayName =
-  AlertDialogPrimitive.Description.displayName
-
-const AlertDialogAction = React.forwardRef<
-  React.ElementRef<typeof AlertDialogPrimitive.Action>,
-  React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Action>
->(({ className, ...props }, ref) => (
-  <AlertDialogPrimitive.Action
-    ref={ref}
-    className={cn(buttonVariants(), className)}
-    {...props}
-  />
-))
-AlertDialogAction.displayName = AlertDialogPrimitive.Action.displayName
-
-const AlertDialogCancel = React.forwardRef<
-  React.ElementRef<typeof AlertDialogPrimitive.Cancel>,
-  React.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Cancel>
->(({ className, ...props }, ref) => (
-  <AlertDialogPrimitive.Cancel
-    ref={ref}
-    className={cn(
-      buttonVariants({ variant: "outline" }),
-      "mt-2 sm:mt-0",
-      className
-    )}
-    {...props}
-  />
-))
-AlertDialogCancel.displayName = AlertDialogPrimitive.Cancel.displayName
-
-export {
-  AlertDialog,
-  AlertDialogPortal,
-  AlertDialogOverlay,
-  AlertDialogTrigger,
-  AlertDialogContent,
-  AlertDialogHeader,
-  AlertDialogFooter,
-  AlertDialogTitle,
-  AlertDialogDescription,
-  AlertDialogAction,
-  AlertDialogCancel,
-}
diff --git a/frontend/@/components/ui/badge.tsx b/frontend/@/components/ui/badge.tsx
deleted file mode 100644
index f000e3ef5..000000000
--- a/frontend/@/components/ui/badge.tsx
+++ /dev/null
@@ -1,36 +0,0 @@
-import * as React from "react"
-import { cva, type VariantProps } from "class-variance-authority"
-
-import { cn } from "@/lib/utils"
-
-const badgeVariants = cva(
-  "inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",
-  {
-    variants: {
-      variant: {
-        default:
-          "border-transparent bg-primary text-primary-foreground hover:bg-primary/80",
-        secondary:
-          "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
-        destructive:
-          "border-transparent bg-destructive text-destructive-foreground hover:bg-destructive/80",
-        outline: "text-foreground",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-    },
-  }
-)
-
-export interface BadgeProps
-  extends React.HTMLAttributes<HTMLDivElement>,
-    VariantProps<typeof badgeVariants> {}
-
-function Badge({ className, variant, ...props }: BadgeProps) {
-  return (
-    <div className={cn(badgeVariants({ variant }), className)} {...props} />
-  )
-}
-
-export { Badge, badgeVariants }
diff --git a/frontend/@/components/ui/button.tsx b/frontend/@/components/ui/button.tsx
deleted file mode 100644
index 36496a287..000000000
--- a/frontend/@/components/ui/button.tsx
+++ /dev/null
@@ -1,56 +0,0 @@
-import * as React from "react"
-import { Slot } from "@radix-ui/react-slot"
-import { cva, type VariantProps } from "class-variance-authority"
-
-import { cn } from "@/lib/utils"
-
-const buttonVariants = cva(
-  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium ring-offset-background transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
-  {
-    variants: {
-      variant: {
-        default: "bg-primary text-primary-foreground hover:bg-primary/90",
-        destructive:
-          "bg-destructive text-destructive-foreground hover:bg-destructive/90",
-        outline:
-          "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
-        secondary:
-          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
-        ghost: "hover:bg-accent hover:text-accent-foreground",
-        link: "text-primary underline-offset-4 hover:underline",
-      },
-      size: {
-        default: "h-10 px-4 py-2",
-        sm: "h-9 rounded-md px-3",
-        lg: "h-11 rounded-md px-8",
-        icon: "h-10 w-10",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-      size: "default",
-    },
-  }
-)
-
-export interface ButtonProps
-  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
-    VariantProps<typeof buttonVariants> {
-  asChild?: boolean
-}
-
-const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
-  ({ className, variant, size, asChild = false, ...props }, ref) => {
-    const Comp = asChild ? Slot : "button"
-    return (
-      <Comp
-        className={cn(buttonVariants({ variant, size, className }))}
-        ref={ref}
-        {...props}
-      />
-    )
-  }
-)
-Button.displayName = "Button"
-
-export { Button, buttonVariants }
diff --git a/frontend/@/components/ui/card.tsx b/frontend/@/components/ui/card.tsx
deleted file mode 100644
index f62edea57..000000000
--- a/frontend/@/components/ui/card.tsx
+++ /dev/null
@@ -1,79 +0,0 @@
-import * as React from "react"
-
-import { cn } from "@/lib/utils"
-
-const Card = React.forwardRef<
-  HTMLDivElement,
-  React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-  <div
-    ref={ref}
-    className={cn(
-      "rounded-lg border bg-card text-card-foreground shadow-sm",
-      className
-    )}
-    {...props}
-  />
-))
-Card.displayName = "Card"
-
-const CardHeader = React.forwardRef<
-  HTMLDivElement,
-  React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-  <div
-    ref={ref}
-    className={cn("flex flex-col space-y-1.5 p-6", className)}
-    {...props}
-  />
-))
-CardHeader.displayName = "CardHeader"
-
-const CardTitle = React.forwardRef<
-  HTMLDivElement,
-  React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-  <div
-    ref={ref}
-    className={cn(
-      "text-2xl font-semibold leading-none tracking-tight",
-      className
-    )}
-    {...props}
-  />
-))
-CardTitle.displayName = "CardTitle"
-
-const CardDescription = React.forwardRef<
-  HTMLDivElement,
-  React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-  <div
-    ref={ref}
-    className={cn("text-sm text-muted-foreground", className)}
-    {...props}
-  />
-))
-CardDescription.displayName = "CardDescription"
-
-const CardContent = React.forwardRef<
-  HTMLDivElement,
-  React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-  <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
-))
-CardContent.displayName = "CardContent"
-
-const CardFooter = React.forwardRef<
-  HTMLDivElement,
-  React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => (
-  <div
-    ref={ref}
-    className={cn("flex items-center p-6 pt-0", className)}
-    {...props}
-  />
-))
-CardFooter.displayName = "CardFooter"
-
-export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }
diff --git a/frontend/@/components/ui/form.tsx b/frontend/@/components/ui/form.tsx
deleted file mode 100644
index a98b0ae49..000000000
--- a/frontend/@/components/ui/form.tsx
+++ /dev/null
@@ -1,176 +0,0 @@
-import * as React from "react"
-import * as LabelPrimitive from "@radix-ui/react-label"
-import { Slot } from "@radix-ui/react-slot"
-import {
-  Controller,
-  FormProvider,
-  useFormContext,
-  type ControllerProps,
-  type FieldPath,
-  type FieldValues,
-} from "react-hook-form"
-
-import { cn } from "@/lib/utils"
-import { Label } from "@/components/ui/label"
-
-const Form = FormProvider
-
-type FormFieldContextValue<
-  TFieldValues extends FieldValues = FieldValues,
-  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>
-> = {
-  name: TName
-}
-
-const FormFieldContext = React.createContext<FormFieldContextValue | null>(null)
-
-const FormField = <
-  TFieldValues extends FieldValues = FieldValues,
-  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>
->({
-  ...props
-}: ControllerProps<TFieldValues, TName>) => {
-  return (
-    <FormFieldContext.Provider value={{ name: props.name }}>
-      <Controller {...props} />
-    </FormFieldContext.Provider>
-  )
-}
-
-const useFormField = () => {
-  const fieldContext = React.useContext(FormFieldContext)
-  const itemContext = React.useContext(FormItemContext)
-  const { getFieldState, formState } = useFormContext()
-
-  if (!fieldContext) {
-    throw new Error("useFormField should be used within <FormField>")
-  }
-
-  if (!itemContext) {
-    throw new Error("useFormField should be used within <FormItem>")
-  }
-
-  const fieldState = getFieldState(fieldContext.name, formState)
-
-  const { id } = itemContext
-
-  return {
-    id,
-    name: fieldContext.name,
-    formItemId: `${id}-form-item`,
-    formDescriptionId: `${id}-form-item-description`,
-    formMessageId: `${id}-form-item-message`,
-    ...fieldState,
-  }
-}
-
-type FormItemContextValue = {
-  id: string
-}
-
-const FormItemContext = React.createContext<FormItemContextValue | null>(null)
-
-const FormItem = React.forwardRef<
-  HTMLDivElement,
-  React.HTMLAttributes<HTMLDivElement>
->(({ className, ...props }, ref) => {
-  const id = React.useId()
-
-  return (
-    <FormItemContext.Provider value={{ id }}>
-      <div ref={ref} className={cn("space-y-2", className)} {...props} />
-    </FormItemContext.Provider>
-  )
-})
-FormItem.displayName = "FormItem"
-
-const FormLabel = React.forwardRef<
-  React.ElementRef<typeof LabelPrimitive.Root>,
-  React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>
->(({ className, ...props }, ref) => {
-  const { error, formItemId } = useFormField()
-
-  return (
-    <Label
-      ref={ref}
-      className={cn(error && "text-destructive", className)}
-      htmlFor={formItemId}
-      {...props}
-    />
-  )
-})
-FormLabel.displayName = "FormLabel"
-
-const FormControl = React.forwardRef<
-  React.ElementRef<typeof Slot>,
-  React.ComponentPropsWithoutRef<typeof Slot>
->(({ ...props }, ref) => {
-  const { error, formItemId, formDescriptionId, formMessageId } = useFormField()
-
-  return (
-    <Slot
-      ref={ref}
-      id={formItemId}
-      aria-describedby={
-        !error
-          ? `${formDescriptionId}`
-          : `${formDescriptionId} ${formMessageId}`
-      }
-      aria-invalid={!!error}
-      {...props}
-    />
-  )
-})
-FormControl.displayName = "FormControl"
-
-const FormDescription = React.forwardRef<
-  HTMLParagraphElement,
-  React.HTMLAttributes<HTMLParagraphElement>
->(({ className, ...props }, ref) => {
-  const { formDescriptionId } = useFormField()
-
-  return (
-    <p
-      ref={ref}
-      id={formDescriptionId}
-      className={cn("text-sm text-muted-foreground", className)}
-      {...props}
-    />
-  )
-})
-FormDescription.displayName = "FormDescription"
-
-const FormMessage = React.forwardRef<
-  HTMLParagraphElement,
-  React.HTMLAttributes<HTMLParagraphElement>
->(({ className, children, ...props }, ref) => {
-  const { error, formMessageId } = useFormField()
-  const body = error ? String(error?.message ?? "") : children
-
-  if (!body) {
-    return null
-  }
-
-  return (
-    <p
-      ref={ref}
-      id={formMessageId}
-      className={cn("text-sm font-medium text-destructive", className)}
-      {...props}
-    >
-      {body}
-    </p>
-  )
-})
-FormMessage.displayName = "FormMessage"
-
-export {
-  useFormField,
-  Form,
-  FormItem,
-  FormLabel,
-  FormControl,
-  FormDescription,
-  FormMessage,
-  FormField,
-}
diff --git a/frontend/@/components/ui/input.tsx b/frontend/@/components/ui/input.tsx
deleted file mode 100644
index 68551b927..000000000
--- a/frontend/@/components/ui/input.tsx
+++ /dev/null
@@ -1,22 +0,0 @@
-import * as React from "react"
-
-import { cn } from "@/lib/utils"
-
-const Input = React.forwardRef<HTMLInputElement, React.ComponentProps<"input">>(
-  ({ className, type, ...props }, ref) => {
-    return (
-      <input
-        type={type}
-        className={cn(
-          "flex h-10 w-full rounded-md border border-input bg-background px-3 py-2 text-base ring-offset-background file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
-          className
-        )}
-        ref={ref}
-        {...props}
-      />
-    )
-  }
-)
-Input.displayName = "Input"
-
-export { Input }
diff --git a/frontend/@/components/ui/label.tsx b/frontend/@/components/ui/label.tsx
deleted file mode 100644
index 534182176..000000000
--- a/frontend/@/components/ui/label.tsx
+++ /dev/null
@@ -1,26 +0,0 @@
-"use client"
-
-import * as React from "react"
-import * as LabelPrimitive from "@radix-ui/react-label"
-import { cva, type VariantProps } from "class-variance-authority"
-
-import { cn } from "@/lib/utils"
-
-const labelVariants = cva(
-  "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70"
-)
-
-const Label = React.forwardRef<
-  React.ElementRef<typeof LabelPrimitive.Root>,
-  React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root> &
-    VariantProps<typeof labelVariants>
->(({ className, ...props }, ref) => (
-  <LabelPrimitive.Root
-    ref={ref}
-    className={cn(labelVariants(), className)}
-    {...props}
-  />
-))
-Label.displayName = LabelPrimitive.Root.displayName
-
-export { Label }
diff --git a/frontend/@/components/ui/progress.tsx b/frontend/@/components/ui/progress.tsx
deleted file mode 100644
index 5c87ea486..000000000
--- a/frontend/@/components/ui/progress.tsx
+++ /dev/null
@@ -1,28 +0,0 @@
-"use client"
-
-import * as React from "react"
-import * as ProgressPrimitive from "@radix-ui/react-progress"
-
-import { cn } from "@/lib/utils"
-
-const Progress = React.forwardRef<
-  React.ElementRef<typeof ProgressPrimitive.Root>,
-  React.ComponentPropsWithoutRef<typeof ProgressPrimitive.Root>
->(({ className, value, ...props }, ref) => (
-  <ProgressPrimitive.Root
-    ref={ref}
-    className={cn(
-      "relative h-4 w-full overflow-hidden rounded-full bg-secondary",
-      className
-    )}
-    {...props}
-  >
-    <ProgressPrimitive.Indicator
-      className="h-full w-full flex-1 bg-primary transition-all"
-      style={{ transform: `translateX(-${100 - (value || 0)}%)` }}
-    />
-  </ProgressPrimitive.Root>
-))
-Progress.displayName = ProgressPrimitive.Root.displayName
-
-export { Progress }
diff --git a/frontend/@/components/ui/select.tsx b/frontend/@/components/ui/select.tsx
deleted file mode 100644
index d826bdbab..000000000
--- a/frontend/@/components/ui/select.tsx
+++ /dev/null
@@ -1,158 +0,0 @@
-import * as React from "react"
-import * as SelectPrimitive from "@radix-ui/react-select"
-import { Check, ChevronDown, ChevronUp } from "lucide-react"
-
-import { cn } from "@/lib/utils"
-
-const Select = SelectPrimitive.Root
-
-const SelectGroup = SelectPrimitive.Group
-
-const SelectValue = SelectPrimitive.Value
-
-const SelectTrigger = React.forwardRef<
-  React.ElementRef<typeof SelectPrimitive.Trigger>,
-  React.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>
->(({ className, children, ...props }, ref) => (
-  <SelectPrimitive.Trigger
-    ref={ref}
-    className={cn(
-      "flex h-10 w-full items-center justify-between rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background data-[placeholder]:text-muted-foreground focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 [&>span]:line-clamp-1",
-      className
-    )}
-    {...props}
-  >
-    {children}
-    <SelectPrimitive.Icon asChild>
-      <ChevronDown className="h-4 w-4 opacity-50" />
-    </SelectPrimitive.Icon>
-  </SelectPrimitive.Trigger>
-))
-SelectTrigger.displayName = SelectPrimitive.Trigger.displayName
-
-const SelectScrollUpButton = React.forwardRef<
-  React.ElementRef<typeof SelectPrimitive.ScrollUpButton>,
-  React.ComponentPropsWithoutRef<typeof SelectPrimitive.ScrollUpButton>
->(({ className, ...props }, ref) => (
-  <SelectPrimitive.ScrollUpButton
-    ref={ref}
-    className={cn(
-      "flex cursor-default items-center justify-center py-1",
-      className
-    )}
-    {...props}
-  >
-    <ChevronUp className="h-4 w-4" />
-  </SelectPrimitive.ScrollUpButton>
-))
-SelectScrollUpButton.displayName = SelectPrimitive.ScrollUpButton.displayName
-
-const SelectScrollDownButton = React.forwardRef<
-  React.ElementRef<typeof SelectPrimitive.ScrollDownButton>,
-  React.ComponentPropsWithoutRef<typeof SelectPrimitive.ScrollDownButton>
->(({ className, ...props }, ref) => (
-  <SelectPrimitive.ScrollDownButton
-    ref={ref}
-    className={cn(
-      "flex cursor-default items-center justify-center py-1",
-      className
-    )}
-    {...props}
-  >
-    <ChevronDown className="h-4 w-4" />
-  </SelectPrimitive.ScrollDownButton>
-))
-SelectScrollDownButton.displayName =
-  SelectPrimitive.ScrollDownButton.displayName
-
-const SelectContent = React.forwardRef<
-  React.ElementRef<typeof SelectPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof SelectPrimitive.Content>
->(({ className, children, position = "popper", ...props }, ref) => (
-  <SelectPrimitive.Portal>
-    <SelectPrimitive.Content
-      ref={ref}
-      className={cn(
-        "relative z-50 max-h-[--radix-select-content-available-height] min-w-[8rem] overflow-y-auto overflow-x-hidden rounded-md border bg-popover text-popover-foreground shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 origin-[--radix-select-content-transform-origin]",
-        position === "popper" &&
-          "data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1",
-        className
-      )}
-      position={position}
-      {...props}
-    >
-      <SelectScrollUpButton />
-      <SelectPrimitive.Viewport
-        className={cn(
-          "p-1",
-          position === "popper" &&
-            "h-[var(--radix-select-trigger-height)] w-full min-w-[var(--radix-select-trigger-width)]"
-        )}
-      >
-        {children}
-      </SelectPrimitive.Viewport>
-      <SelectScrollDownButton />
-    </SelectPrimitive.Content>
-  </SelectPrimitive.Portal>
-))
-SelectContent.displayName = SelectPrimitive.Content.displayName
-
-const SelectLabel = React.forwardRef<
-  React.ElementRef<typeof SelectPrimitive.Label>,
-  React.ComponentPropsWithoutRef<typeof SelectPrimitive.Label>
->(({ className, ...props }, ref) => (
-  <SelectPrimitive.Label
-    ref={ref}
-    className={cn("py-1.5 pl-8 pr-2 text-sm font-semibold", className)}
-    {...props}
-  />
-))
-SelectLabel.displayName = SelectPrimitive.Label.displayName
-
-const SelectItem = React.forwardRef<
-  React.ElementRef<typeof SelectPrimitive.Item>,
-  React.ComponentPropsWithoutRef<typeof SelectPrimitive.Item>
->(({ className, children, ...props }, ref) => (
-  <SelectPrimitive.Item
-    ref={ref}
-    className={cn(
-      "relative flex w-full cursor-default select-none items-center rounded-sm py-1.5 pl-8 pr-2 text-sm outline-none focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
-      className
-    )}
-    {...props}
-  >
-    <span className="absolute left-2 flex h-3.5 w-3.5 items-center justify-center">
-      <SelectPrimitive.ItemIndicator>
-        <Check className="h-4 w-4" />
-      </SelectPrimitive.ItemIndicator>
-    </span>
-
-    <SelectPrimitive.ItemText>{children}</SelectPrimitive.ItemText>
-  </SelectPrimitive.Item>
-))
-SelectItem.displayName = SelectPrimitive.Item.displayName
-
-const SelectSeparator = React.forwardRef<
-  React.ElementRef<typeof SelectPrimitive.Separator>,
-  React.ComponentPropsWithoutRef<typeof SelectPrimitive.Separator>
->(({ className, ...props }, ref) => (
-  <SelectPrimitive.Separator
-    ref={ref}
-    className={cn("-mx-1 my-1 h-px bg-muted", className)}
-    {...props}
-  />
-))
-SelectSeparator.displayName = SelectPrimitive.Separator.displayName
-
-export {
-  Select,
-  SelectGroup,
-  SelectValue,
-  SelectTrigger,
-  SelectContent,
-  SelectLabel,
-  SelectItem,
-  SelectSeparator,
-  SelectScrollUpButton,
-  SelectScrollDownButton,
-}
diff --git a/frontend/@/components/ui/separator.tsx b/frontend/@/components/ui/separator.tsx
deleted file mode 100644
index 6d7f12265..000000000
--- a/frontend/@/components/ui/separator.tsx
+++ /dev/null
@@ -1,29 +0,0 @@
-import * as React from "react"
-import * as SeparatorPrimitive from "@radix-ui/react-separator"
-
-import { cn } from "@/lib/utils"
-
-const Separator = React.forwardRef<
-  React.ElementRef<typeof SeparatorPrimitive.Root>,
-  React.ComponentPropsWithoutRef<typeof SeparatorPrimitive.Root>
->(
-  (
-    { className, orientation = "horizontal", decorative = true, ...props },
-    ref
-  ) => (
-    <SeparatorPrimitive.Root
-      ref={ref}
-      decorative={decorative}
-      orientation={orientation}
-      className={cn(
-        "shrink-0 bg-border",
-        orientation === "horizontal" ? "h-[1px] w-full" : "h-full w-[1px]",
-        className
-      )}
-      {...props}
-    />
-  )
-)
-Separator.displayName = SeparatorPrimitive.Root.displayName
-
-export { Separator }
diff --git a/frontend/@/components/ui/sheet.tsx b/frontend/@/components/ui/sheet.tsx
deleted file mode 100644
index d64a6fa79..000000000
--- a/frontend/@/components/ui/sheet.tsx
+++ /dev/null
@@ -1,138 +0,0 @@
-import * as React from "react"
-import * as SheetPrimitive from "@radix-ui/react-dialog"
-import { cva, type VariantProps } from "class-variance-authority"
-import { X } from "lucide-react"
-
-import { cn } from "@/lib/utils"
-
-const Sheet = SheetPrimitive.Root
-
-const SheetTrigger = SheetPrimitive.Trigger
-
-const SheetClose = SheetPrimitive.Close
-
-const SheetPortal = SheetPrimitive.Portal
-
-const SheetOverlay = React.forwardRef<
-  React.ElementRef<typeof SheetPrimitive.Overlay>,
-  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Overlay>
->(({ className, ...props }, ref) => (
-  <SheetPrimitive.Overlay
-    className={cn(
-      "fixed inset-0 z-50 bg-black/80  data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
-      className
-    )}
-    {...props}
-    ref={ref}
-  />
-))
-SheetOverlay.displayName = SheetPrimitive.Overlay.displayName
-
-const sheetVariants = cva(
-  "fixed z-50 gap-4 bg-background p-6 shadow-lg transition ease-in-out data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:duration-300 data-[state=open]:duration-500",
-  {
-    variants: {
-      side: {
-        top: "inset-x-0 top-0 border-b data-[state=closed]:slide-out-to-top data-[state=open]:slide-in-from-top",
-        bottom:
-          "inset-x-0 bottom-0 border-t data-[state=closed]:slide-out-to-bottom data-[state=open]:slide-in-from-bottom",
-        left: "inset-y-0 left-0 h-full w-3/4 border-r data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left sm:max-w-sm",
-        right:
-          "inset-y-0 right-0 h-full w-3/4  border-l data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right sm:max-w-sm",
-      },
-    },
-    defaultVariants: {
-      side: "right",
-    },
-  }
-)
-
-interface SheetContentProps
-  extends React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>,
-    VariantProps<typeof sheetVariants> {}
-
-const SheetContent = React.forwardRef<
-  React.ElementRef<typeof SheetPrimitive.Content>,
-  SheetContentProps
->(({ side = "right", className, children, ...props }, ref) => (
-  <SheetPortal>
-    <SheetOverlay />
-    <SheetPrimitive.Content
-      ref={ref}
-      className={cn(sheetVariants({ side }), className)}
-      {...props}
-    >
-      {children}
-      <SheetPrimitive.Close className="absolute right-4 top-4 rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none data-[state=open]:bg-secondary">
-        <X className="h-4 w-4" />
-        <span className="sr-only">Close</span>
-      </SheetPrimitive.Close>
-    </SheetPrimitive.Content>
-  </SheetPortal>
-))
-SheetContent.displayName = SheetPrimitive.Content.displayName
-
-const SheetHeader = ({
-  className,
-  ...props
-}: React.HTMLAttributes<HTMLDivElement>) => (
-  <div
-    className={cn(
-      "flex flex-col space-y-2 text-center sm:text-left",
-      className
-    )}
-    {...props}
-  />
-)
-SheetHeader.displayName = "SheetHeader"
-
-const SheetFooter = ({
-  className,
-  ...props
-}: React.HTMLAttributes<HTMLDivElement>) => (
-  <div
-    className={cn(
-      "flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2",
-      className
-    )}
-    {...props}
-  />
-)
-SheetFooter.displayName = "SheetFooter"
-
-const SheetTitle = React.forwardRef<
-  React.ElementRef<typeof SheetPrimitive.Title>,
-  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Title>
->(({ className, ...props }, ref) => (
-  <SheetPrimitive.Title
-    ref={ref}
-    className={cn("text-lg font-semibold text-foreground", className)}
-    {...props}
-  />
-))
-SheetTitle.displayName = SheetPrimitive.Title.displayName
-
-const SheetDescription = React.forwardRef<
-  React.ElementRef<typeof SheetPrimitive.Description>,
-  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Description>
->(({ className, ...props }, ref) => (
-  <SheetPrimitive.Description
-    ref={ref}
-    className={cn("text-sm text-muted-foreground", className)}
-    {...props}
-  />
-))
-SheetDescription.displayName = SheetPrimitive.Description.displayName
-
-export {
-  Sheet,
-  SheetPortal,
-  SheetOverlay,
-  SheetTrigger,
-  SheetClose,
-  SheetContent,
-  SheetHeader,
-  SheetFooter,
-  SheetTitle,
-  SheetDescription,
-}
diff --git a/frontend/@/components/ui/table.tsx b/frontend/@/components/ui/table.tsx
deleted file mode 100644
index 7f3502f8b..000000000
--- a/frontend/@/components/ui/table.tsx
+++ /dev/null
@@ -1,117 +0,0 @@
-import * as React from "react"
-
-import { cn } from "@/lib/utils"
-
-const Table = React.forwardRef<
-  HTMLTableElement,
-  React.HTMLAttributes<HTMLTableElement>
->(({ className, ...props }, ref) => (
-  <div className="relative w-full overflow-auto">
-    <table
-      ref={ref}
-      className={cn("w-full caption-bottom text-sm", className)}
-      {...props}
-    />
-  </div>
-))
-Table.displayName = "Table"
-
-const TableHeader = React.forwardRef<
-  HTMLTableSectionElement,
-  React.HTMLAttributes<HTMLTableSectionElement>
->(({ className, ...props }, ref) => (
-  <thead ref={ref} className={cn("[&_tr]:border-b", className)} {...props} />
-))
-TableHeader.displayName = "TableHeader"
-
-const TableBody = React.forwardRef<
-  HTMLTableSectionElement,
-  React.HTMLAttributes<HTMLTableSectionElement>
->(({ className, ...props }, ref) => (
-  <tbody
-    ref={ref}
-    className={cn("[&_tr:last-child]:border-0", className)}
-    {...props}
-  />
-))
-TableBody.displayName = "TableBody"
-
-const TableFooter = React.forwardRef<
-  HTMLTableSectionElement,
-  React.HTMLAttributes<HTMLTableSectionElement>
->(({ className, ...props }, ref) => (
-  <tfoot
-    ref={ref}
-    className={cn(
-      "border-t bg-muted/50 font-medium [&>tr]:last:border-b-0",
-      className
-    )}
-    {...props}
-  />
-))
-TableFooter.displayName = "TableFooter"
-
-const TableRow = React.forwardRef<
-  HTMLTableRowElement,
-  React.HTMLAttributes<HTMLTableRowElement>
->(({ className, ...props }, ref) => (
-  <tr
-    ref={ref}
-    className={cn(
-      "border-b transition-colors hover:bg-muted/50 data-[state=selected]:bg-muted",
-      className
-    )}
-    {...props}
-  />
-))
-TableRow.displayName = "TableRow"
-
-const TableHead = React.forwardRef<
-  HTMLTableCellElement,
-  React.ThHTMLAttributes<HTMLTableCellElement>
->(({ className, ...props }, ref) => (
-  <th
-    ref={ref}
-    className={cn(
-      "h-12 px-4 text-left align-middle font-medium text-muted-foreground [&:has([role=checkbox])]:pr-0",
-      className
-    )}
-    {...props}
-  />
-))
-TableHead.displayName = "TableHead"
-
-const TableCell = React.forwardRef<
-  HTMLTableCellElement,
-  React.TdHTMLAttributes<HTMLTableCellElement>
->(({ className, ...props }, ref) => (
-  <td
-    ref={ref}
-    className={cn("p-4 align-middle [&:has([role=checkbox])]:pr-0", className)}
-    {...props}
-  />
-))
-TableCell.displayName = "TableCell"
-
-const TableCaption = React.forwardRef<
-  HTMLTableCaptionElement,
-  React.HTMLAttributes<HTMLTableCaptionElement>
->(({ className, ...props }, ref) => (
-  <caption
-    ref={ref}
-    className={cn("mt-4 text-sm text-muted-foreground", className)}
-    {...props}
-  />
-))
-TableCaption.displayName = "TableCaption"
-
-export {
-  Table,
-  TableHeader,
-  TableBody,
-  TableFooter,
-  TableHead,
-  TableRow,
-  TableCell,
-  TableCaption,
-}
diff --git a/frontend/@/components/ui/tabs.tsx b/frontend/@/components/ui/tabs.tsx
deleted file mode 100644
index f57fffdb5..000000000
--- a/frontend/@/components/ui/tabs.tsx
+++ /dev/null
@@ -1,53 +0,0 @@
-import * as React from "react"
-import * as TabsPrimitive from "@radix-ui/react-tabs"
-
-import { cn } from "@/lib/utils"
-
-const Tabs = TabsPrimitive.Root
-
-const TabsList = React.forwardRef<
-  React.ElementRef<typeof TabsPrimitive.List>,
-  React.ComponentPropsWithoutRef<typeof TabsPrimitive.List>
->(({ className, ...props }, ref) => (
-  <TabsPrimitive.List
-    ref={ref}
-    className={cn(
-      "inline-flex h-10 items-center justify-center rounded-md bg-muted p-1 text-muted-foreground",
-      className
-    )}
-    {...props}
-  />
-))
-TabsList.displayName = TabsPrimitive.List.displayName
-
-const TabsTrigger = React.forwardRef<
-  React.ElementRef<typeof TabsPrimitive.Trigger>,
-  React.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger>
->(({ className, ...props }, ref) => (
-  <TabsPrimitive.Trigger
-    ref={ref}
-    className={cn(
-      "inline-flex items-center justify-center whitespace-nowrap rounded-sm px-3 py-1.5 text-sm font-medium ring-offset-background transition-all focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:bg-background data-[state=active]:text-foreground data-[state=active]:shadow-sm",
-      className
-    )}
-    {...props}
-  />
-))
-TabsTrigger.displayName = TabsPrimitive.Trigger.displayName
-
-const TabsContent = React.forwardRef<
-  React.ElementRef<typeof TabsPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof TabsPrimitive.Content>
->(({ className, ...props }, ref) => (
-  <TabsPrimitive.Content
-    ref={ref}
-    className={cn(
-      "mt-2 ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2",
-      className
-    )}
-    {...props}
-  />
-))
-TabsContent.displayName = TabsPrimitive.Content.displayName
-
-export { Tabs, TabsList, TabsTrigger, TabsContent }
diff --git a/frontend/@/components/ui/textarea.tsx b/frontend/@/components/ui/textarea.tsx
deleted file mode 100644
index 4d858bb6b..000000000
--- a/frontend/@/components/ui/textarea.tsx
+++ /dev/null
@@ -1,22 +0,0 @@
-import * as React from "react"
-
-import { cn } from "@/lib/utils"
-
-const Textarea = React.forwardRef<
-  HTMLTextAreaElement,
-  React.ComponentProps<"textarea">
->(({ className, ...props }, ref) => {
-  return (
-    <textarea
-      className={cn(
-        "flex min-h-[80px] w-full rounded-md border border-input bg-background px-3 py-2 text-base ring-offset-background placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
-        className
-      )}
-      ref={ref}
-      {...props}
-    />
-  )
-})
-Textarea.displayName = "Textarea"
-
-export { Textarea }
diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index 93cea9164..0573e2f9b 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -2,7 +2,7 @@ import { RouterProvider } from "react-router-dom";
 
 import { ErrorBoundary } from "@/components/common/ErrorBoundary";
 import { Toast } from "@/components/common/Toast";
-import { router } from "@/router";
+import { router } from "@/routerConfig";
 
 export default function App() {
   return (
diff --git a/frontend/src/components/admin/AgentAvatar.tsx b/frontend/src/components/admin/AgentAvatar.tsx
index c3fd5bef7..adb3fda02 100644
--- a/frontend/src/components/admin/AgentAvatar.tsx
+++ b/frontend/src/components/admin/AgentAvatar.tsx
@@ -1,44 +1,5 @@
-import {
-  Aperture,
-  Atom,
-  Compass,
-  Gem,
-  Hexagon,
-  Orbit,
-  Rocket,
-  Shapes,
-  Sparkles,
-  Zap,
-  type LucideIcon
-} from "lucide-react";
-
 import { cn } from "@/lib/utils";
-
-export interface AgentAvatarPreset {
-  key: string;
-  Icon: LucideIcon;
-  /** 底色渐变，与图标同表存放，避免颜色在 CSS、图标在 TS 两处对齐 */
-  gradient: string;
-  shadow: string;
-}
-
-export const AGENT_AVATARS: AgentAvatarPreset[] = [
-  { key: "orbit-indigo", Icon: Orbit, gradient: "linear-gradient(135deg, #6366F1, #8B5CF6)", shadow: "rgba(99, 102, 241, 0.85)" },
-  { key: "sparkles-violet", Icon: Sparkles, gradient: "linear-gradient(135deg, #8B5CF6, #D946EF)", shadow: "rgba(139, 92, 246, 0.85)" },
-  { key: "hexagon-teal", Icon: Hexagon, gradient: "linear-gradient(135deg, #14B8A6, #06B6D4)", shadow: "rgba(20, 184, 166, 0.85)" },
-  { key: "gem-amber", Icon: Gem, gradient: "linear-gradient(135deg, #F59E0B, #F97316)", shadow: "rgba(245, 158, 11, 0.85)" },
-  { key: "compass-rose", Icon: Compass, gradient: "linear-gradient(135deg, #F43F5E, #EC4899)", shadow: "rgba(244, 63, 94, 0.85)" },
-  { key: "atom-sky", Icon: Atom, gradient: "linear-gradient(135deg, #0EA5E9, #6366F1)", shadow: "rgba(14, 165, 233, 0.85)" },
-  { key: "rocket-emerald", Icon: Rocket, gradient: "linear-gradient(135deg, #10B981, #14B8A6)", shadow: "rgba(16, 185, 129, 0.85)" },
-  { key: "shapes-slate", Icon: Shapes, gradient: "linear-gradient(135deg, #64748B, #475569)", shadow: "rgba(100, 116, 139, 0.85)" },
-  { key: "aperture-fuchsia", Icon: Aperture, gradient: "linear-gradient(135deg, #A855F7, #EC4899)", shadow: "rgba(168, 85, 247, 0.85)" },
-  { key: "zap-lime", Icon: Zap, gradient: "linear-gradient(135deg, #84CC16, #10B981)", shadow: "rgba(132, 204, 22, 0.85)" }
-];
-
-/** 新建智能体时给个随机预设，省得一屏卡片全是同一个色 */
-export function randomAvatarKey(): string {
-  return AGENT_AVATARS[Math.floor(Math.random() * AGENT_AVATARS.length)].key;
-}
+import { AGENT_AVATARS, type AgentAvatarPreset } from "@/components/admin/agentAvatarPresets";
 
 // 后端只存 key 不校验白名单，认不出的取值按 seed 散列到某个预设，保证永远画得出东西
 function presetFor(avatar?: string | null, seed?: string): AgentAvatarPreset {
diff --git a/frontend/src/components/admin/AgentModeLabel.tsx b/frontend/src/components/admin/AgentModeLabel.tsx
index debee1098..8770393df 100644
--- a/frontend/src/components/admin/AgentModeLabel.tsx
+++ b/frontend/src/components/admin/AgentModeLabel.tsx
@@ -1,15 +1,11 @@
 import type { OrchestrationMode } from "@/services/agentProfileService";
+import { OTHER_MODE_LABEL } from "@/components/admin/agentModeLabels";
 
 const MODE_LABEL: Record<OrchestrationMode, string> = {
   WORKFLOW: "WorkFlow",
   AGENT: "Agent"
 };
 
-export const OTHER_MODE_LABEL: Record<OrchestrationMode, string> = {
-  WORKFLOW: "Agent",
-  AGENT: "WorkFlow"
-};
-
 /**
  * 执行架构标识，作为两个智能体页面副标题的前缀
  *
diff --git a/frontend/src/components/admin/agentAvatarPresets.ts b/frontend/src/components/admin/agentAvatarPresets.ts
new file mode 100644
index 000000000..b7e95cbb2
--- /dev/null
+++ b/frontend/src/components/admin/agentAvatarPresets.ts
@@ -0,0 +1,39 @@
+import {
+  Aperture,
+  Atom,
+  Compass,
+  Gem,
+  Hexagon,
+  Orbit,
+  Rocket,
+  Shapes,
+  Sparkles,
+  Zap,
+  type LucideIcon
+} from "lucide-react";
+
+export interface AgentAvatarPreset {
+  key: string;
+  Icon: LucideIcon;
+  /** 底色渐变，与图标同表存放，避免颜色在 CSS、图标在 TS 两处对齐 */
+  gradient: string;
+  shadow: string;
+}
+
+export const AGENT_AVATARS: AgentAvatarPreset[] = [
+  { key: "orbit-indigo", Icon: Orbit, gradient: "linear-gradient(135deg, #6366F1, #8B5CF6)", shadow: "rgba(99, 102, 241, 0.85)" },
+  { key: "sparkles-violet", Icon: Sparkles, gradient: "linear-gradient(135deg, #8B5CF6, #D946EF)", shadow: "rgba(139, 92, 246, 0.85)" },
+  { key: "hexagon-teal", Icon: Hexagon, gradient: "linear-gradient(135deg, #14B8A6, #06B6D4)", shadow: "rgba(20, 184, 166, 0.85)" },
+  { key: "gem-amber", Icon: Gem, gradient: "linear-gradient(135deg, #F59E0B, #F97316)", shadow: "rgba(245, 158, 11, 0.85)" },
+  { key: "compass-rose", Icon: Compass, gradient: "linear-gradient(135deg, #F43F5E, #EC4899)", shadow: "rgba(244, 63, 94, 0.85)" },
+  { key: "atom-sky", Icon: Atom, gradient: "linear-gradient(135deg, #0EA5E9, #6366F1)", shadow: "rgba(14, 165, 233, 0.85)" },
+  { key: "rocket-emerald", Icon: Rocket, gradient: "linear-gradient(135deg, #10B981, #14B8A6)", shadow: "rgba(16, 185, 129, 0.85)" },
+  { key: "shapes-slate", Icon: Shapes, gradient: "linear-gradient(135deg, #64748B, #475569)", shadow: "rgba(100, 116, 139, 0.85)" },
+  { key: "aperture-fuchsia", Icon: Aperture, gradient: "linear-gradient(135deg, #A855F7, #EC4899)", shadow: "rgba(168, 85, 247, 0.85)" },
+  { key: "zap-lime", Icon: Zap, gradient: "linear-gradient(135deg, #84CC16, #10B981)", shadow: "rgba(132, 204, 22, 0.85)" }
+];
+
+/** 新建智能体时给个随机预设，省得一屏卡片全是同一个色 */
+export function randomAvatarKey(): string {
+  return AGENT_AVATARS[Math.floor(Math.random() * AGENT_AVATARS.length)].key;
+}
diff --git a/frontend/src/components/admin/agentModeLabels.ts b/frontend/src/components/admin/agentModeLabels.ts
new file mode 100644
index 000000000..e46be121d
--- /dev/null
+++ b/frontend/src/components/admin/agentModeLabels.ts
@@ -0,0 +1,7 @@
+import type { OrchestrationMode } from "@/services/agentProfileService";
+
+// 与 MODE_LABEL 反向的架构标签，用于标注非当前架构（如 Agent 页标注 WorkFlow 槽位）
+export const OTHER_MODE_LABEL: Record<OrchestrationMode, string> = {
+  WORKFLOW: "Agent",
+  AGENT: "WorkFlow"
+};
diff --git a/frontend/src/components/chat/FeedbackButtons.tsx b/frontend/src/components/chat/FeedbackButtons.tsx
index 9fff23a29..884bd6e9f 100644
--- a/frontend/src/components/chat/FeedbackButtons.tsx
+++ b/frontend/src/components/chat/FeedbackButtons.tsx
@@ -152,7 +152,6 @@ export function FeedbackButtons({
             sideOffset={6}
             onMouseEnter={openCopyMenu}
             onMouseLeave={scheduleCloseCopyMenu}
-            onOpenAutoFocus={(event) => event.preventDefault()}
             onCloseAutoFocus={(event) => event.preventDefault()}
             className="min-w-[9rem]"
           >
diff --git a/frontend/src/components/chat/MarkdownRenderer.tsx b/frontend/src/components/chat/MarkdownRenderer.tsx
index 16b429c09..45f1b6b48 100644
--- a/frontend/src/components/chat/MarkdownRenderer.tsx
+++ b/frontend/src/components/chat/MarkdownRenderer.tsx
@@ -1,6 +1,3 @@
-// @ts-nocheck
-/* eslint-disable */
-
 import * as React from "react";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
@@ -172,6 +169,36 @@ function resolveCitationIndexes(content: string, sources?: SourceRef[]) {
   return [...result];
 }
 
+/**
+ * 图片组件：加载失败时替换为占位提示
+ * <p>
+ * 独立顶层组件（大写命名）以符合 rules-of-hooks：react-markdown components 里的
+ * 小写回调会被当作渲染函数而非组件，useState 将触发 hooks 规则告警
+ */
+function MarkdownImage({ src, ...props }: React.ImgHTMLAttributes<HTMLImageElement>) {
+  const [hasError, setHasError] = React.useState(false);
+
+  if (hasError) {
+    return (
+      <div className="my-3 flex items-center gap-2 text-sm text-[#999999]">
+        <ImageIcon className="h-4 w-4" />
+        <span>图片加载失败</span>
+      </div>
+    );
+  }
+
+  return (
+    <img
+      src={src}
+      alt=""
+      className="my-3 max-w-full rounded-lg"
+      onError={() => setHasError(true)}
+      loading="lazy"
+      {...props}
+    />
+  );
+}
+
 export function MarkdownRenderer({ content, messageId, sources }: MarkdownRendererProps) {
   const theme = useThemeStore((state) => state.theme);
   const citationIndexes = React.useMemo(
@@ -189,13 +216,13 @@ export function MarkdownRenderer({ content, messageId, sources }: MarkdownRender
       ]}
       rehypePlugins={[rehypeRaw, rehypeSanitize]}
       components={{
-        code({ inline, className, children, node, ...props }) {
+        code({ className, children, ...props }) {
           const match = /language-(\w+)/.exec(className || "");
           const language = match?.[1] || "text";
           const value = String(children).replace(/\n$/, "");
 
-          // 判断是否为内联代码：inline 为 true 或者没有换行符
-          if (inline || !value.includes('\n')) {
+          // react-markdown v9 不再提供 inline prop，无语言标注且无换行视为内联代码
+          if (!value.includes('\n')) {
             return (
               <code
                 className={cn(
@@ -239,29 +266,7 @@ export function MarkdownRenderer({ content, messageId, sources }: MarkdownRender
             </div>
           );
         },
-        img({ src, alt, ...props }) {
-          const [hasError, setHasError] = React.useState(false);
-
-          if (hasError) {
-            return (
-              <div className="my-3 flex items-center gap-2 text-sm text-[#999999]">
-                <ImageIcon className="h-4 w-4" />
-                <span>图片加载失败</span>
-              </div>
-            );
-          }
-
-          return (
-            <img
-              src={src}
-              alt=""
-              className="my-3 max-w-full rounded-lg"
-              onError={() => setHasError(true)}
-              loading="lazy"
-              {...props}
-            />
-          );
-        },
+        img: MarkdownImage,
         a({ children, href, ...props }) {
           const citationIndex = messageId ? parseCitationIndex(href) : null;
           if (citationIndex != null) {
diff --git a/frontend/src/components/chat/MessageList.tsx b/frontend/src/components/chat/MessageList.tsx
index 4d9ae3204..57a1d43ae 100644
--- a/frontend/src/components/chat/MessageList.tsx
+++ b/frontend/src/components/chat/MessageList.tsx
@@ -167,7 +167,7 @@ export function MessageList({ messages, isLoading, isStreaming, sessionKey }: Me
       }
       window.removeEventListener("load", handleLoad);
     };
-  }, [messages.length, isStreaming, isLoading, sessionKey]);
+  }, [messages.length, isStreaming, isLoading, sessionKey, scrollToBottom]);
 
   React.useEffect(() => {
     return () => {
diff --git a/frontend/src/components/document/DocumentPreview.tsx b/frontend/src/components/document/DocumentPreview.tsx
index b1f38f371..7a6d49bb7 100644
--- a/frontend/src/components/document/DocumentPreview.tsx
+++ b/frontend/src/components/document/DocumentPreview.tsx
@@ -4,6 +4,12 @@ import { Download } from "lucide-react";
 import { MarkdownRenderer } from "@/components/chat/MarkdownRenderer";
 import { csvToMarkdown } from "@/lib/csvToMarkdown";
 import { fetchDocumentFile, previewDocument } from "@/services/knowledgeService";
+import {
+  isDocxType,
+  isImageType,
+  isSpreadsheetType,
+  parseFrontMatter
+} from "@/components/document/previewUtils";
 
 // xlsx 预览依赖较重(exceljs + x-data-spreadsheet)，懒加载避免拖累主包
 const SpreadsheetPreview = lazy(() =>
@@ -22,36 +28,6 @@ const PdfPreview = lazy(() =>
 
 const API_BASE_URL = (import.meta.env.VITE_API_BASE_URL || "").replace(/\/$/, "");
 
-const IMAGE_EXTS = ["png", "jpg", "jpeg", "svg", "gif", "webp", "bmp"];
-
-export const isSpreadsheetType = (ext?: string | null) => {
-  const e = (ext || "").toLowerCase();
-  return e === "xlsx" || e === "xls";
-};
-
-export const isImageType = (ext?: string | null) => IMAGE_EXTS.includes((ext || "").toLowerCase());
-
-export const isDocxType = (ext?: string | null) => (ext || "").toLowerCase() === "docx";
-
-export const isPreviewableType = (ext?: string | null) => {
-  const type = (ext || "").toLowerCase();
-  return ["pdf", "csv", "markdown", "txt"].includes(type)
-    || isDocxType(type)
-    || isSpreadsheetType(type)
-    || isImageType(type);
-};
-
-// 剥离 markdown 头部的 front-matter，单独展示
-export const parseFrontMatter = (content: string): { head: string | null; body: string } => {
-  if (content.startsWith("---\n")) {
-    const end = content.indexOf("\n---\n", 4);
-    if (end > 0) {
-      return { head: content.substring(4, end), body: content.substring(end + 5) };
-    }
-  }
-  return { head: null, body: content };
-};
-
 interface DocumentPreviewProps {
   docId: string;
   fileType?: string | null;
diff --git a/frontend/src/components/document/previewUtils.ts b/frontend/src/components/document/previewUtils.ts
new file mode 100644
index 000000000..366bb2be8
--- /dev/null
+++ b/frontend/src/components/document/previewUtils.ts
@@ -0,0 +1,29 @@
+const IMAGE_EXTS = ["png", "jpg", "jpeg", "svg", "gif", "webp", "bmp"];
+
+export const isSpreadsheetType = (ext?: string | null) => {
+  const e = (ext || "").toLowerCase();
+  return e === "xlsx" || e === "xls";
+};
+
+export const isImageType = (ext?: string | null) => IMAGE_EXTS.includes((ext || "").toLowerCase());
+
+export const isDocxType = (ext?: string | null) => (ext || "").toLowerCase() === "docx";
+
+export const isPreviewableType = (ext?: string | null) => {
+  const type = (ext || "").toLowerCase();
+  return ["pdf", "csv", "markdown", "txt"].includes(type)
+    || isDocxType(type)
+    || isSpreadsheetType(type)
+    || isImageType(type);
+};
+
+// 剥离 markdown 头部的 front-matter，单独展示
+export const parseFrontMatter = (content: string): { head: string | null; body: string } => {
+  if (content.startsWith("---\n")) {
+    const end = content.indexOf("\n---\n", 4);
+    if (end > 0) {
+      return { head: content.substring(4, end), body: content.substring(end + 5) };
+    }
+  }
+  return { head: null, body: content };
+};
diff --git a/frontend/src/components/ui/badge.tsx b/frontend/src/components/ui/badge.tsx
index e20e0574e..aa31dbc57 100644
--- a/frontend/src/components/ui/badge.tsx
+++ b/frontend/src/components/ui/badge.tsx
@@ -38,4 +38,8 @@ function Badge({ className, variant, ...props }: BadgeProps) {
   )
 }
 
-export { Badge, badgeVariants }
+export {
+  Badge,
+  // eslint-disable-next-line react-refresh/only-export-components -- shadcn 标准结构：cva variants 与组件同文件导出，供外部类型推导与复用
+  badgeVariants
+}
diff --git a/frontend/src/components/ui/button.tsx b/frontend/src/components/ui/button.tsx
index a752cb33e..a64b42837 100644
--- a/frontend/src/components/ui/button.tsx
+++ b/frontend/src/components/ui/button.tsx
@@ -51,4 +51,8 @@ const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
 );
 Button.displayName = "Button";
 
-export { Button, buttonVariants };
+export {
+  Button,
+  // eslint-disable-next-line react-refresh/only-export-components -- shadcn 标准结构：cva variants 与组件同文件导出，供外部（alert-dialog 等）复用
+  buttonVariants
+};
diff --git a/frontend/src/components/ui/form.tsx b/frontend/src/components/ui/form.tsx
index 4603f8b3d..cc40fe136 100644
--- a/frontend/src/components/ui/form.tsx
+++ b/frontend/src/components/ui/form.tsx
@@ -165,6 +165,7 @@ const FormMessage = React.forwardRef<
 FormMessage.displayName = "FormMessage"
 
 export {
+  // eslint-disable-next-line react-refresh/only-export-components -- shadcn 标准结构：useFormField 由 FormField 内部使用并对外导出，拆文件会破坏 FormItem/FormLabel 等对它的依赖
   useFormField,
   Form,
   FormItem,
diff --git a/frontend/src/hooks/useStreamResponse.ts b/frontend/src/hooks/useStreamResponse.ts
index 76aa8b7e5..dd0bb8277 100644
--- a/frontend/src/hooks/useStreamResponse.ts
+++ b/frontend/src/hooks/useStreamResponse.ts
@@ -89,6 +89,7 @@ async function readSseStream(response: Response, handlers: StreamHandlers, signa
     dataLines = [];
   };
 
+  // eslint-disable-next-line no-constant-condition -- SSE 读取循环：靠内部 aborted/done 条件 break，没有固定上界
   while (true) {
     if (signal?.aborted) {
       reader.cancel();
diff --git a/frontend/src/lib/source.ts b/frontend/src/lib/source.ts
index de5d4776c..46183aa09 100644
--- a/frontend/src/lib/source.ts
+++ b/frontend/src/lib/source.ts
@@ -74,6 +74,7 @@ export interface SourceDisplayName {
  * 书名/文章名挤没。这里把次要信息抽到副标题，原始值仍由调用方保留在 title 属性里
  */
 export function displayName(source: SourceRef): SourceDisplayName {
+  // eslint-disable-next-line no-irregular-whitespace -- 正则需精确匹配全角空格 U+3000（业务数据来自网页抓取），\s 无法只匹配它
   const raw = (source.docName || "").replace(/　/g, " ");
   if (!raw.trim()) return { title: "未命名文档", detail: "" };
 
diff --git a/frontend/src/pages/admin/AdminLayout.tsx b/frontend/src/pages/admin/AdminLayout.tsx
index 9d309ba37..eecf2d6a9 100644
--- a/frontend/src/pages/admin/AdminLayout.tsx
+++ b/frontend/src/pages/admin/AdminLayout.tsx
@@ -24,7 +24,8 @@ import {
   Upload,
   Users,
   FolderKanban,
-  Workflow
+  Workflow,
+  type LucideIcon
 } from "lucide-react";
 import { useAuthStore } from "@/stores/authStore";
 import { Button } from "@/components/ui/button";
@@ -51,7 +52,7 @@ import { Avatar } from "@/components/common/Avatar";
 type MenuChild = {
   path: string;
   label: string;
-  icon: any;
+  icon: LucideIcon;
   search?: string;
 };
 
@@ -59,7 +60,7 @@ type MenuItem = {
   id?: string;
   path: string;
   label: string;
-  icon: any;
+  icon: LucideIcon;
   /** 字形本身偏小的图标在这里补一个视觉尺寸修正，跟同栏其余图标找齐 */
   iconClass?: string;
   search?: string;
diff --git a/frontend/src/pages/admin/agents/AgentProfilePage.tsx b/frontend/src/pages/admin/agents/AgentProfilePage.tsx
index b29027b8f..d1febc65f 100644
--- a/frontend/src/pages/admin/agents/AgentProfilePage.tsx
+++ b/frontend/src/pages/admin/agents/AgentProfilePage.tsx
@@ -41,8 +41,10 @@ import {
 } from "@/services/agentProfileService";
 import { getErrorMessage } from "@/utils/error";
 import { RelativeTime } from "@/components/RelativeTime";
-import { AGENT_AVATARS, AgentAvatar, randomAvatarKey } from "@/components/admin/AgentAvatar";
-import { AgentModeLabel, OTHER_MODE_LABEL } from "@/components/admin/AgentModeLabel";
+import { AgentAvatar } from "@/components/admin/AgentAvatar";
+import { AGENT_AVATARS, randomAvatarKey } from "@/components/admin/agentAvatarPresets";
+import { AgentModeLabel } from "@/components/admin/AgentModeLabel";
+import { OTHER_MODE_LABEL } from "@/components/admin/agentModeLabels";
 import { cn } from "@/lib/utils";
 
 const emptyForm = { name: "", description: "", avatar: AGENT_AVATARS[0].key };
diff --git a/frontend/src/pages/admin/change-logs/BizChangeLogPage.tsx b/frontend/src/pages/admin/change-logs/BizChangeLogPage.tsx
index d929c26ef..3815e883f 100644
--- a/frontend/src/pages/admin/change-logs/BizChangeLogPage.tsx
+++ b/frontend/src/pages/admin/change-logs/BizChangeLogPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import {
   Boxes,
   Check,
@@ -441,7 +441,7 @@ export function BizChangeLogPage() {
   const rangeStart = total === 0 ? 0 : (current - 1) * pageSize + 1;
   const rangeEnd = total === 0 ? 0 : Math.min((current - 1) * pageSize + records.length, total);
 
-  const loadData = async (currentPage = pageNo, nextQuery = query, size = pageSize) => {
+  const loadData = useCallback(async (currentPage = pageNo, nextQuery = query, size = pageSize) => {
     try {
       setLoading(true);
       const result = await getBizChangeLogsPage({
@@ -462,11 +462,11 @@ export function BizChangeLogPage() {
     } finally {
       setLoading(false);
     }
-  };
+  }, [pageNo, query, pageSize]);
 
   useEffect(() => {
-    loadData(pageNo, query, pageSize);
-  }, [pageNo, query, pageSize]);
+    loadData();
+  }, [loadData]);
 
   const handleSearch = () => {
     setPageNo(1);
diff --git a/frontend/src/pages/admin/dashboard/DashboardPage.tsx b/frontend/src/pages/admin/dashboard/DashboardPage.tsx
index 3e8b8fea3..936975a23 100644
--- a/frontend/src/pages/admin/dashboard/DashboardPage.tsx
+++ b/frontend/src/pages/admin/dashboard/DashboardPage.tsx
@@ -274,8 +274,9 @@ const useDashboardData = () => {
       console.error(err);
       setError("数据加载失败");
     } finally {
-      if (requestIdRef.current !== requestId) return;
-      setLoading(false);
+      if (requestIdRef.current === requestId) {
+        setLoading(false);
+      }
     }
   }, []);
 
diff --git a/frontend/src/pages/admin/ingestion/IngestionPage.tsx b/frontend/src/pages/admin/ingestion/IngestionPage.tsx
index d0a81ca40..cce02b5a4 100644
--- a/frontend/src/pages/admin/ingestion/IngestionPage.tsx
+++ b/frontend/src/pages/admin/ingestion/IngestionPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useState } from "react";
+import { useCallback, useEffect, useState } from "react";
 import { useSearchParams } from "react-router-dom";
 import {
   ClipboardList,
@@ -242,7 +242,7 @@ export function IngestionPage() {
   const pipelines = pipelinePage?.records || [];
   const tasks = taskPage?.records || [];
 
-  const loadPipelines = async (pageNo = pipelinePageNo, keyword = pipelineKeyword) => {
+  const loadPipelines = useCallback(async (pageNo = pipelinePageNo, keyword = pipelineKeyword) => {
     setPipelineLoading(true);
     try {
       const data = await getIngestionPipelines(pageNo, PIPELINE_PAGE_SIZE, keyword || undefined);
@@ -253,7 +253,7 @@ export function IngestionPage() {
     } finally {
       setPipelineLoading(false);
     }
-  };
+  }, [pipelinePageNo, pipelineKeyword]);
 
   const loadPipelineOptions = async () => {
     try {
@@ -264,7 +264,7 @@ export function IngestionPage() {
     }
   };
 
-  const loadTasks = async (pageNo = taskPageNo, status = taskStatus) => {
+  const loadTasks = useCallback(async (pageNo = taskPageNo, status = taskStatus) => {
     setTaskLoading(true);
     try {
       const data = await getIngestionTasks(pageNo, TASK_PAGE_SIZE, status);
@@ -275,15 +275,15 @@ export function IngestionPage() {
     } finally {
       setTaskLoading(false);
     }
-  };
+  }, [taskPageNo, taskStatus]);
 
   useEffect(() => {
     loadPipelines();
-  }, [pipelinePageNo, pipelineKeyword]);
+  }, [loadPipelines]);
 
   useEffect(() => {
     loadTasks();
-  }, [taskPageNo, taskStatus]);
+  }, [loadTasks]);
 
   useEffect(() => {
     loadPipelineOptions();
@@ -709,7 +709,7 @@ function PipelineDialog({ open, mode, pipeline, onOpenChange, onSubmit }: Pipeli
     }
   });
 
-  const createLocalId = () => `${Date.now()}-${Math.random().toString(16).slice(2, 8)}`;
+  const createLocalId = useCallback(() => `${Date.now()}-${Math.random().toString(16).slice(2, 8)}`, []);
 
   const createTask = (type: string) => ({
     id: createLocalId(),
@@ -748,7 +748,7 @@ function PipelineDialog({ open, mode, pipeline, onOpenChange, onSubmit }: Pipeli
     }
   });
 
-  const mapSettingsTasks = (tasks: unknown): EnhancerTaskForm[] => {
+  const mapSettingsTasks = useCallback((tasks: unknown): EnhancerTaskForm[] => {
     if (!Array.isArray(tasks)) return [];
     return tasks.map((task) => ({
       id: createLocalId(),
@@ -756,9 +756,9 @@ function PipelineDialog({ open, mode, pipeline, onOpenChange, onSubmit }: Pipeli
       systemPrompt: String((task as { systemPrompt?: string }).systemPrompt || ""),
       userPromptTemplate: String((task as { userPromptTemplate?: string }).userPromptTemplate || "")
     }));
-  };
+  }, [createLocalId]);
 
-  const buildNodeForm = (node: IngestionPipelineNode): PipelineNodeForm => {
+  const buildNodeForm = useCallback((node: IngestionPipelineNode): PipelineNodeForm => {
     const settings = (node.settings as Record<string, unknown>) || {};
     const rawCondition = node.condition as unknown;
     const condition = rawCondition
@@ -802,14 +802,15 @@ function PipelineDialog({ open, mode, pipeline, onOpenChange, onSubmit }: Pipeli
           : ""
       }
     };
-  };
+  }, [createLocalId, mapSettingsTasks]);
 
-  const buildNodesFromPipeline = (source?: IngestionPipelineNode[] | null) => {
+  const buildNodesFromPipeline = useCallback((source?: IngestionPipelineNode[] | null) => {
     if (!source || source.length === 0) return [];
     return source.map(buildNodeForm);
-  };
+  }, [buildNodeForm]);
 
-  const parseCondition = (raw: string) => {
+  // 条件表达式：JSON 对象/数组原样保留，其余按字符串条件传给后端，故返回 unknown 而非 any
+  const parseCondition = (raw: string): unknown => {
     const trimmed = raw.trim();
     if (!trimmed) return null;
     if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
@@ -938,7 +939,8 @@ function PipelineDialog({ open, mode, pipeline, onOpenChange, onSubmit }: Pipeli
         nodeId,
         nodeType: node.nodeType,
         settings: settings ?? null,
-        condition: condition ?? null,
+        // 条件表达式可能是 JSON 对象/数组或字符串，服务类型定义按对象建模，此处对齐既有契约
+        condition: (condition ?? null) as Record<string, unknown> | null,
         nextNodeId: node.nextNodeId.trim() || null
       });
     }
@@ -992,7 +994,7 @@ function PipelineDialog({ open, mode, pipeline, onOpenChange, onSubmit }: Pipeli
       setNodes(buildNodesFromPipeline(pipeline?.nodes));
       setNodeMode("form");
     }
-  }, [open, pipeline, defaultNodes, form]);
+  }, [open, pipeline, defaultNodes, form, buildNodesFromPipeline]);
 
   const handleSubmit = async (values: PipelineFormValues) => {
     let nodesPayload: IngestionPipelinePayload["nodes"] | undefined;
diff --git a/frontend/src/pages/admin/intent-tree/IntentTreePage.tsx b/frontend/src/pages/admin/intent-tree/IntentTreePage.tsx
index c968fe4e0..e58d260ea 100644
--- a/frontend/src/pages/admin/intent-tree/IntentTreePage.tsx
+++ b/frontend/src/pages/admin/intent-tree/IntentTreePage.tsx
@@ -229,9 +229,13 @@ export function IntentTreePage() {
     }
   };
 
+  // 树只在挂载时加载一次：loadTree 捕获 focusIntentCode 作为初始聚焦值，
+  // URL 聚焦码后续变化由下方 [focusIntentCode, tree] effect 处理选中；
+  // 把 loadTree 加入依赖会让每次聚焦码变化都重发请求并触发 loading 闪烁
   useEffect(() => {
     loadTree();
     loadKnowledgeBases();
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- 见上方说明：树不应随 focusIntentCode 重载
   }, []);
 
   useEffect(() => {
diff --git a/frontend/src/pages/admin/knowledge/KnowledgeChunksPage.tsx b/frontend/src/pages/admin/knowledge/KnowledgeChunksPage.tsx
index e06f91608..7523b5a63 100644
--- a/frontend/src/pages/admin/knowledge/KnowledgeChunksPage.tsx
+++ b/frontend/src/pages/admin/knowledge/KnowledgeChunksPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { useNavigate, useParams } from "react-router-dom";
 import { CircleHelp, PenSquare, Plus, RefreshCw, ShieldCheck, ShieldX, Trash2 } from "lucide-react";
 import { toast } from "sonner";
@@ -58,7 +58,7 @@ export function KnowledgeChunksPage() {
 
   const selectedList = useMemo(() => Array.from(selectedIds), [selectedIds]);
 
-  const loadDocument = async () => {
+  const loadDocument = useCallback(async () => {
     if (!docId) return;
     try {
       const data = await getDocument(docId);
@@ -67,9 +67,9 @@ export function KnowledgeChunksPage() {
       toast.error(getErrorMessage(error, "加载文档失败"));
       console.error(error);
     }
-  };
+  }, [docId]);
 
-  const loadChunks = async (current = pageNo, enabled = enabledFilter) => {
+  const loadChunks = useCallback(async (current = pageNo, enabled = enabledFilter) => {
     if (!docId) return;
     setLoading(true);
     try {
@@ -85,11 +85,11 @@ export function KnowledgeChunksPage() {
     } finally {
       setLoading(false);
     }
-  };
+  }, [docId, pageNo, enabledFilter]);
 
   useEffect(() => {
     loadDocument();
-  }, [docId]);
+  }, [loadDocument]);
 
   useEffect(() => {
     if (kbId) {
@@ -99,7 +99,7 @@ export function KnowledgeChunksPage() {
 
   useEffect(() => {
     loadChunks();
-  }, [docId, pageNo, enabledFilter]);
+  }, [loadChunks]);
 
   useEffect(() => {
     setSelectedIds(new Set());
diff --git a/frontend/src/pages/admin/knowledge/KnowledgeDocumentsPage.tsx b/frontend/src/pages/admin/knowledge/KnowledgeDocumentsPage.tsx
index 111adf3d5..802cf9506 100644
--- a/frontend/src/pages/admin/knowledge/KnowledgeDocumentsPage.tsx
+++ b/frontend/src/pages/admin/knowledge/KnowledgeDocumentsPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useRef, useState, type ReactNode } from "react";
+import { useCallback, useEffect, useRef, useState, type ReactNode } from "react";
 import { useLocation, useNavigate, useParams } from "react-router-dom";
 import { Check, ChevronDown, ChevronRight, FileUp, FileImage, Info, PlayCircle, RefreshCw, Trash2, Pencil, FileBarChart, X, Eye, MoreHorizontal, FileText, FileSpreadsheet, Link as LinkIcon, Download } from "lucide-react";
 import { toast } from "sonner";
@@ -37,7 +37,13 @@ import {
 } from "@/services/knowledgeService";
 import { getIngestionPipelines, type IngestionPipeline } from "@/services/ingestionService";
 import { getSystemSettings } from "@/services/settingsService";
-import { DocumentPreview, isDocxType, isImageType, isPreviewableType, isSpreadsheetType } from "@/components/document/DocumentPreview";
+import { DocumentPreview } from "@/components/document/DocumentPreview";
+import {
+  isDocxType,
+  isImageType,
+  isPreviewableType,
+  isSpreadsheetType
+} from "@/components/document/previewUtils";
 import { getErrorMessage } from "@/utils/error";
 
 const PAGE_SIZE = 10;
@@ -455,7 +461,7 @@ export function KnowledgeDocumentsPage() {
     }
   };
 
-  const loadKnowledgeBase = async () => {
+  const loadKnowledgeBase = useCallback(async () => {
     if (!kbId) return;
     try {
       const data = await getKnowledgeBase(kbId);
@@ -464,9 +470,9 @@ export function KnowledgeDocumentsPage() {
       toast.error(getErrorMessage(error, "加载知识库失败"));
       console.error(error);
     }
-  };
+  }, [kbId]);
 
-  const loadDocuments = async (page = current, status = statusFilter, keywordValue = keyword) => {
+  const loadDocuments = useCallback(async (page = current, status = statusFilter, keywordValue = keyword) => {
     if (!kbId) return;
     setLoading(true);
     try {
@@ -483,15 +489,15 @@ export function KnowledgeDocumentsPage() {
     } finally {
       setLoading(false);
     }
-  };
+  }, [kbId, current, statusFilter, keyword]);
 
   useEffect(() => {
     loadKnowledgeBase();
-  }, [kbId]);
+  }, [loadKnowledgeBase]);
 
   useEffect(() => {
     loadDocuments();
-  }, [kbId, current, statusFilter, keyword]);
+  }, [loadDocuments]);
 
   useEffect(() => {
     if (detailTarget) {
@@ -542,7 +548,8 @@ export function KnowledgeDocumentsPage() {
       setDetailNoChunk(false);
       setDetailShowAdvanced(false);
     }
-  }, [detailTarget]);
+    // specSchema 为 state 的稳定引用，仅在 schema 加载完成后变化，加入依赖不会造成循环
+  }, [detailTarget, specSchema]);
 
   const handleSearch = () => {
     setCurrent(1);
@@ -1517,7 +1524,9 @@ function UploadDialog({ open, onOpenChange, onSubmit }: UploadDialogProps) {
   const [loadingPipelines, setLoadingPipelines] = useState(false);
   const [maxFileSize, setMaxFileSize] = useState<number>(50 * 1024 * 1024);
 
-  const form = useForm<UploadFormValues>({
+  // schema 的 .default() 使 input 与 output 类型分化（input 中 scheduleEnabled 等可选），
+  // useForm 三泛型与 zodResolver 的 Resolver<z.input, Context, z.output> 签名对齐
+  const form = useForm<z.input<typeof uploadSchema>, unknown, z.output<typeof uploadSchema>>({
     resolver: zodResolver(uploadSchema),
     defaultValues: {
       sourceType: "file",
@@ -1631,11 +1640,11 @@ function UploadDialog({ open, onOpenChange, onSubmit }: UploadDialogProps) {
       const payload: KnowledgeDocumentUploadPayload = {
         sourceType: values.sourceType,
         file: values.sourceType === "file" ? file : null,
-        sourceLocation: values.sourceType === "url" ? values.sourceLocation.trim() : null,
+        sourceLocation: values.sourceType === "url" ? (values.sourceLocation || "").trim() : null,
         scheduleEnabled: values.sourceType === "url" ? values.scheduleEnabled : false,
         scheduleCron:
           values.sourceType === "url" && values.scheduleEnabled
-            ? values.scheduleCron.trim()
+            ? (values.scheduleCron || "").trim()
             : null,
         processMode: values.processMode,
         ingestionSpec: ingestionSpec ?? null,
diff --git a/frontend/src/pages/admin/knowledge/KnowledgeListPage.tsx b/frontend/src/pages/admin/knowledge/KnowledgeListPage.tsx
index 30f205839..4bbe7c034 100644
--- a/frontend/src/pages/admin/knowledge/KnowledgeListPage.tsx
+++ b/frontend/src/pages/admin/knowledge/KnowledgeListPage.tsx
@@ -64,7 +64,7 @@ export function KnowledgeListPage() {
 
   const knowledgeBases = pageData?.records || [];
 
-  const loadKnowledgeBases = async (current = pageNo, name = keyword) => {
+  const loadKnowledgeBases = useCallback(async (current = pageNo, name = keyword) => {
     try {
       setLoading(true);
       const data = await getKnowledgeBasesPage(current, PAGE_SIZE, name || undefined);
@@ -75,7 +75,7 @@ export function KnowledgeListPage() {
     } finally {
       setLoading(false);
     }
-  };
+  }, [pageNo, keyword]);
 
   const loadStats = useCallback(async (name = keyword) => {
     const requestId = ++statsRequestId.current;
@@ -138,7 +138,7 @@ export function KnowledgeListPage() {
 
   useEffect(() => {
     loadKnowledgeBases();
-  }, [pageNo, keyword]);
+  }, [loadKnowledgeBases]);
 
   useEffect(() => {
     loadStats(keyword);
diff --git a/frontend/src/pages/admin/query-term-mapping/QueryTermMappingPage.tsx b/frontend/src/pages/admin/query-term-mapping/QueryTermMappingPage.tsx
index cbcd15cdb..d751a79eb 100644
--- a/frontend/src/pages/admin/query-term-mapping/QueryTermMappingPage.tsx
+++ b/frontend/src/pages/admin/query-term-mapping/QueryTermMappingPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useState } from "react";
+import { useCallback, useEffect, useState } from "react";
 import { Pencil, Plus, RefreshCw, Trash2 } from "lucide-react";
 import { toast } from "sonner";
 
@@ -78,7 +78,7 @@ export function QueryTermMappingPage() {
   }>({ open: false, mode: "create", item: null });
   const [form, setForm] = useState(emptyForm);
 
-  const loadData = async (current = pageNo, keywordValue = keyword) => {
+  const loadData = useCallback(async (current = pageNo, keywordValue = keyword) => {
     try {
       setLoading(true);
       const data = await getQueryTermMappingsPage(current, PAGE_SIZE, keywordValue || undefined);
@@ -89,11 +89,11 @@ export function QueryTermMappingPage() {
     } finally {
       setLoading(false);
     }
-  };
+  }, [pageNo, keyword]);
 
   useEffect(() => {
     loadData();
-  }, [pageNo, keyword]);
+  }, [loadData]);
 
   useEffect(() => {
     if (!dialogState.open) {
diff --git a/frontend/src/pages/admin/sample-questions/SampleQuestionPage.tsx b/frontend/src/pages/admin/sample-questions/SampleQuestionPage.tsx
index dc498c0e0..aa0dd3c82 100644
--- a/frontend/src/pages/admin/sample-questions/SampleQuestionPage.tsx
+++ b/frontend/src/pages/admin/sample-questions/SampleQuestionPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useState } from "react";
+import { useCallback, useEffect, useState } from "react";
 import { Pencil, Plus, RefreshCw, Trash2 } from "lucide-react";
 import { toast } from "sonner";
 
@@ -57,7 +57,7 @@ export function SampleQuestionPage() {
   }>({ open: false, mode: "create", item: null });
   const [form, setForm] = useState(emptyForm);
 
-  const loadQuestions = async (current = pageNo, keywordValue = keyword) => {
+  const loadQuestions = useCallback(async (current = pageNo, keywordValue = keyword) => {
     try {
       setLoading(true);
       const data = await getSampleQuestionsPage(current, PAGE_SIZE, keywordValue || undefined);
@@ -68,11 +68,11 @@ export function SampleQuestionPage() {
     } finally {
       setLoading(false);
     }
-  };
+  }, [pageNo, keyword]);
 
   useEffect(() => {
     loadQuestions();
-  }, [pageNo, keyword]);
+  }, [loadQuestions]);
 
   useEffect(() => {
     if (!dialogState.open) {
diff --git a/frontend/src/pages/admin/traces/RagTraceDetailPage.tsx b/frontend/src/pages/admin/traces/RagTraceDetailPage.tsx
index 3df9616dd..df3663175 100644
--- a/frontend/src/pages/admin/traces/RagTraceDetailPage.tsx
+++ b/frontend/src/pages/admin/traces/RagTraceDetailPage.tsx
@@ -388,8 +388,9 @@ export function RagTraceDetailPage() {
       console.error(error);
       setDetail(null);
     } finally {
-      if (detailRequestRef.current !== requestId) return;
-      setDetailLoading(false);
+      if (detailRequestRef.current === requestId) {
+        setDetailLoading(false);
+      }
     }
   };
 
@@ -407,7 +408,7 @@ export function RagTraceDetailPage() {
 
   const timeline = useMemo(() => {
     const nodes = detail?.nodes || [];
-    if (!nodes.length && !selectedRun) return { totalWindowMs: 0, nodes: [] as any[] };
+    if (!nodes.length && !selectedRun) return { totalWindowMs: 0, nodes: [] as TimelineNode[] };
 
     const normalized = nodes.map((node) => {
       const startTs = toTimestamp(node.startTime);
diff --git a/frontend/src/pages/admin/traces/RagTracePage.tsx b/frontend/src/pages/admin/traces/RagTracePage.tsx
index 5dee9d740..99081434f 100644
--- a/frontend/src/pages/admin/traces/RagTracePage.tsx
+++ b/frontend/src/pages/admin/traces/RagTracePage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
 import { useNavigate } from "react-router-dom";
 import { Activity, Clock3, RefreshCw, Search, TrendingUp } from "lucide-react";
 import { toast } from "sonner";
@@ -39,32 +39,37 @@ export function RagTracePage() {
   const [pageData, setPageData] = useState<PageResult<RagTraceRun> | null>(null);
   const [loading, setLoading] = useState(false);
 
-  const runs = pageData?.records || [];
+  // 逻辑表达式（pageData?.records || []）每次渲染都产生新引用，会令下方 useMemo 依赖失效，故用 useMemo 稳定引用
+  const runs = useMemo(() => pageData?.records || [], [pageData]);
 
-  const loadRuns = async (current = pageNo, nextTraceId = queryTraceId) => {
-    const requestId = ++runsRequestRef.current;
-    setLoading(true);
-    try {
-      const result = await getRagTraceRuns({
-        current,
-        size: PAGE_SIZE,
-        traceId: nextTraceId.trim() || undefined
-      });
-      if (runsRequestRef.current !== requestId) return;
-      setPageData(result);
-    } catch (error) {
-      if (runsRequestRef.current !== requestId) return;
-      toast.error(getErrorMessage(error, "加载链路运行列表失败"));
-      console.error(error);
-    } finally {
-      if (runsRequestRef.current !== requestId) return;
-      setLoading(false);
-    }
-  };
+  const loadRuns = useCallback(
+    async (current = pageNo, nextTraceId = queryTraceId) => {
+      const requestId = ++runsRequestRef.current;
+      setLoading(true);
+      try {
+        const result = await getRagTraceRuns({
+          current,
+          size: PAGE_SIZE,
+          traceId: nextTraceId.trim() || undefined
+        });
+        if (runsRequestRef.current !== requestId) return;
+        setPageData(result);
+      } catch (error) {
+        if (runsRequestRef.current !== requestId) return;
+        toast.error(getErrorMessage(error, "加载链路运行列表失败"));
+        console.error(error);
+      } finally {
+        if (runsRequestRef.current === requestId) {
+          setLoading(false);
+        }
+      }
+    },
+    [pageNo, queryTraceId]
+  );
 
   useEffect(() => {
     loadRuns();
-  }, [pageNo, queryTraceId]);
+  }, [loadRuns]);
 
   const handleSearch = () => {
     setPageNo(1);
diff --git a/frontend/src/pages/admin/users/UserListPage.tsx b/frontend/src/pages/admin/users/UserListPage.tsx
index c31bf9335..4154d4531 100644
--- a/frontend/src/pages/admin/users/UserListPage.tsx
+++ b/frontend/src/pages/admin/users/UserListPage.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useState } from "react";
+import { useCallback, useEffect, useState } from "react";
 import { Pencil, Plus, RefreshCw, Trash2, UserPlus } from "lucide-react";
 import { toast } from "sonner";
 
@@ -46,7 +46,7 @@ export function UserListPage() {
 
   const users = pageData?.records || [];
 
-  const loadUsers = async (current = pageNo, name = keyword) => {
+  const loadUsers = useCallback(async (current = pageNo, name = keyword) => {
     try {
       setLoading(true);
       const data = await getUsersPage(current, PAGE_SIZE, name || undefined);
@@ -57,11 +57,11 @@ export function UserListPage() {
     } finally {
       setLoading(false);
     }
-  };
+  }, [pageNo, keyword]);
 
   useEffect(() => {
     loadUsers();
-  }, [pageNo, keyword]);
+  }, [loadUsers]);
 
   const handleSearch = () => {
     setPageNo(1);
diff --git a/frontend/src/router.tsx b/frontend/src/router.tsx
index ce74a8ac4..64baf24d2 100644
--- a/frontend/src/router.tsx
+++ b/frontend/src/router.tsx
@@ -1,31 +1,10 @@
-import { Navigate, createBrowserRouter } from "react-router-dom";
+import { Navigate } from "react-router-dom";
 
-import { LoginPage } from "@/pages/LoginPage";
-import { ChatPage } from "@/pages/ChatPage";
-import { ChangeLogsPage } from "@/pages/ChangeLogsPage";
-import { DocPreviewPage } from "@/pages/DocPreviewPage";
-import { NotFoundPage } from "@/pages/NotFoundPage";
-import { AdminLayout } from "@/pages/admin/AdminLayout";
-import { DashboardPage } from "@/pages/admin/dashboard/DashboardPage";
-import { KnowledgeListPage } from "@/pages/admin/knowledge/KnowledgeListPage";
-import { KnowledgeDocumentsPage } from "@/pages/admin/knowledge/KnowledgeDocumentsPage";
-import { KnowledgeChunksPage } from "@/pages/admin/knowledge/KnowledgeChunksPage";
-import { KnowledgeGraphPage } from "@/pages/admin/knowledge-graph/KnowledgeGraphPage";
-import { BizChangeLogPage } from "@/pages/admin/change-logs/BizChangeLogPage";
-import { IntentTreePage } from "@/pages/admin/intent-tree/IntentTreePage";
-import { IntentListPage } from "@/pages/admin/intent-tree/IntentListPage";
-import { IntentEditPage } from "@/pages/admin/intent-tree/IntentEditPage";
-import { IngestionPage } from "@/pages/admin/ingestion/IngestionPage";
-import { RagTracePage } from "@/pages/admin/traces/RagTracePage";
-import { RagTraceDetailPage } from "@/pages/admin/traces/RagTraceDetailPage";
-import { SystemSettingsPage } from "@/pages/admin/settings/SystemSettingsPage";
-import { SampleQuestionPage } from "@/pages/admin/sample-questions/SampleQuestionPage";
-import { QueryTermMappingPage } from "@/pages/admin/query-term-mapping/QueryTermMappingPage";
-import { AgentProfilePage } from "@/pages/admin/agents/AgentProfilePage";
-import { AgentPromptPage } from "@/pages/admin/agents/AgentPromptPage";
-import { UserListPage } from "@/pages/admin/users/UserListPage";
 import { useAuthStore } from "@/stores/authStore";
 
+// 路由守卫组件集中在本文件，router 实例在 routerConfig.tsx（只导出非组件，
+// 满足 react-refresh 对组件/非组件混合导出的约束）。
+
 function RequireAuth({ children }: { children: JSX.Element }) {
   const isAuthenticated = useAuthStore((state) => state.isAuthenticated);
   if (!isAuthenticated) {
@@ -62,139 +41,4 @@ function HomeRedirect() {
   return <Navigate to={isAuthenticated ? "/chat" : "/login"} replace />;
 }
 
-export const router = createBrowserRouter([
-  {
-    path: "/",
-    element: <HomeRedirect />
-  },
-  {
-    path: "/login",
-    element: (
-      <RedirectIfAuth>
-        <LoginPage />
-      </RedirectIfAuth>
-    )
-  },
-  {
-    path: "/chat",
-    element: (
-      <RequireAuth>
-        <ChatPage />
-      </RequireAuth>
-    )
-  },
-  {
-    path: "/chat/:sessionId",
-    element: (
-      <RequireAuth>
-        <ChatPage />
-      </RequireAuth>
-    )
-  },
-  {
-    path: "/change-logs",
-    element: (
-      <RequireAuth>
-        <ChangeLogsPage />
-      </RequireAuth>
-    )
-  },
-  {
-    path: "/preview/doc/:docId",
-    element: (
-      <RequireAuth>
-        <DocPreviewPage />
-      </RequireAuth>
-    )
-  },
-  {
-    path: "/admin",
-    element: (
-      <RequireAdmin>
-        <AdminLayout />
-      </RequireAdmin>
-    ),
-    children: [
-      {
-        index: true,
-        element: <Navigate to="/admin/dashboard" replace />
-      },
-      {
-        path: "dashboard",
-        element: <DashboardPage />
-      },
-      {
-        path: "knowledge",
-        element: <KnowledgeListPage />
-      },
-      {
-        path: "knowledge/:kbId",
-        element: <KnowledgeDocumentsPage />
-      },
-      {
-        path: "knowledge/:kbId/docs/:docId",
-        element: <KnowledgeChunksPage />
-      },
-      {
-        path: "knowledge-graph",
-        element: <KnowledgeGraphPage />
-      },
-      {
-        path: "intent-tree",
-        element: <IntentTreePage />
-      },
-      {
-        path: "intent-list",
-        element: <IntentListPage />
-      },
-      {
-        path: "intent-list/:id/edit",
-        element: <IntentEditPage />
-      },
-      {
-        path: "ingestion",
-        element: <IngestionPage />
-      },
-      {
-        path: "traces",
-        element: <RagTracePage />
-      },
-      {
-        path: "traces/:traceId",
-        element: <RagTraceDetailPage />
-      },
-      {
-        path: "change-logs",
-        element: <BizChangeLogPage />
-      },
-      {
-        path: "settings",
-        element: <SystemSettingsPage />
-      },
-      {
-        path: "sample-questions",
-        element: <SampleQuestionPage />
-      },
-      {
-        path: "mappings",
-        element: <QueryTermMappingPage />
-      },
-      {
-        path: "agents",
-        element: <AgentProfilePage />
-      },
-      {
-        path: "agents/:agentId",
-        element: <AgentPromptPage />
-      },
-      {
-        path: "users",
-        element: <UserListPage />
-      }
-    ]
-  },
-  {
-    path: "*",
-    element: <NotFoundPage />
-  }
-]);
+export { HomeRedirect, RedirectIfAuth, RequireAdmin, RequireAuth };
diff --git a/frontend/src/routerConfig.tsx b/frontend/src/routerConfig.tsx
new file mode 100644
index 000000000..73becace0
--- /dev/null
+++ b/frontend/src/routerConfig.tsx
@@ -0,0 +1,169 @@
+import { Navigate, createBrowserRouter } from "react-router-dom";
+
+import { LoginPage } from "@/pages/LoginPage";
+import { ChatPage } from "@/pages/ChatPage";
+import { ChangeLogsPage } from "@/pages/ChangeLogsPage";
+import { DocPreviewPage } from "@/pages/DocPreviewPage";
+import { NotFoundPage } from "@/pages/NotFoundPage";
+import { AdminLayout } from "@/pages/admin/AdminLayout";
+import { DashboardPage } from "@/pages/admin/dashboard/DashboardPage";
+import { KnowledgeListPage } from "@/pages/admin/knowledge/KnowledgeListPage";
+import { KnowledgeDocumentsPage } from "@/pages/admin/knowledge/KnowledgeDocumentsPage";
+import { KnowledgeChunksPage } from "@/pages/admin/knowledge/KnowledgeChunksPage";
+import { KnowledgeGraphPage } from "@/pages/admin/knowledge-graph/KnowledgeGraphPage";
+import { BizChangeLogPage } from "@/pages/admin/change-logs/BizChangeLogPage";
+import { IntentTreePage } from "@/pages/admin/intent-tree/IntentTreePage";
+import { IntentListPage } from "@/pages/admin/intent-tree/IntentListPage";
+import { IntentEditPage } from "@/pages/admin/intent-tree/IntentEditPage";
+import { IngestionPage } from "@/pages/admin/ingestion/IngestionPage";
+import { RagTracePage } from "@/pages/admin/traces/RagTracePage";
+import { RagTraceDetailPage } from "@/pages/admin/traces/RagTraceDetailPage";
+import { SystemSettingsPage } from "@/pages/admin/settings/SystemSettingsPage";
+import { SampleQuestionPage } from "@/pages/admin/sample-questions/SampleQuestionPage";
+import { QueryTermMappingPage } from "@/pages/admin/query-term-mapping/QueryTermMappingPage";
+import { AgentProfilePage } from "@/pages/admin/agents/AgentProfilePage";
+import { AgentPromptPage } from "@/pages/admin/agents/AgentPromptPage";
+import { UserListPage } from "@/pages/admin/users/UserListPage";
+import {
+  HomeRedirect,
+  RedirectIfAuth,
+  RequireAdmin,
+  RequireAuth
+} from "@/router";
+
+export const router = createBrowserRouter([
+  {
+    path: "/",
+    element: <HomeRedirect />
+  },
+  {
+    path: "/login",
+    element: (
+      <RedirectIfAuth>
+        <LoginPage />
+      </RedirectIfAuth>
+    )
+  },
+  {
+    path: "/chat",
+    element: (
+      <RequireAuth>
+        <ChatPage />
+      </RequireAuth>
+    )
+  },
+  {
+    path: "/chat/:sessionId",
+    element: (
+      <RequireAuth>
+        <ChatPage />
+      </RequireAuth>
+    )
+  },
+  {
+    path: "/change-logs",
+    element: (
+      <RequireAuth>
+        <ChangeLogsPage />
+      </RequireAuth>
+    )
+  },
+  {
+    path: "/preview/doc/:docId",
+    element: (
+      <RequireAuth>
+        <DocPreviewPage />
+      </RequireAuth>
+    )
+  },
+  {
+    path: "/admin",
+    element: (
+      <RequireAdmin>
+        <AdminLayout />
+      </RequireAdmin>
+    ),
+    children: [
+      {
+        index: true,
+        element: <Navigate to="/admin/dashboard" replace />
+      },
+      {
+        path: "dashboard",
+        element: <DashboardPage />
+      },
+      {
+        path: "knowledge",
+        element: <KnowledgeListPage />
+      },
+      {
+        path: "knowledge/:kbId",
+        element: <KnowledgeDocumentsPage />
+      },
+      {
+        path: "knowledge/:kbId/docs/:docId",
+        element: <KnowledgeChunksPage />
+      },
+      {
+        path: "knowledge-graph",
+        element: <KnowledgeGraphPage />
+      },
+      {
+        path: "intent-tree",
+        element: <IntentTreePage />
+      },
+      {
+        path: "intent-list",
+        element: <IntentListPage />
+      },
+      {
+        path: "intent-list/:id/edit",
+        element: <IntentEditPage />
+      },
+      {
+        path: "ingestion",
+        element: <IngestionPage />
+      },
+      {
+        path: "traces",
+        element: <RagTracePage />
+      },
+      {
+        path: "traces/:traceId",
+        element: <RagTraceDetailPage />
+      },
+      {
+        path: "change-logs",
+        element: <BizChangeLogPage />
+      },
+      {
+        path: "settings",
+        element: <SystemSettingsPage />
+      },
+      {
+        path: "sample-questions",
+        element: <SampleQuestionPage />
+      },
+      {
+        path: "mappings",
+        element: <QueryTermMappingPage />
+      },
+      {
+        path: "agents",
+        element: <AgentProfilePage />
+      },
+      {
+        path: "agents/:agentId",
+        element: <AgentPromptPage />
+      },
+      {
+        path: "users",
+        element: <UserListPage />
+      }
+    ]
+  },
+  {
+    path: "*",
+    element: <NotFoundPage />
+  }
+]);
diff --git a/frontend/src/services/authService.ts b/frontend/src/services/authService.ts
index c30c339b9..d932fcce8 100644
--- a/frontend/src/services/authService.ts
+++ b/frontend/src/services/authService.ts
@@ -5,13 +5,13 @@ export interface LoginResponse extends User {}
 export interface CurrentUserResponse extends CurrentUser {}
 
 export async function login(username: string, password: string) {
-  return api.post<LoginResponse>("/auth/login", { username, password });
+  return api.post<LoginResponse, LoginResponse>("/auth/login", { username, password });
 }
 
 export async function logout() {
-  return api.post<void>("/auth/logout");
+  return api.post<void, void>("/auth/logout");
 }
 
 export async function getCurrentUser() {
-  return api.get<CurrentUserResponse>("/user/me");
+  return api.get<CurrentUserResponse, CurrentUserResponse>("/user/me");
 }
diff --git a/frontend/src/services/chatService.ts b/frontend/src/services/chatService.ts
index d02eb2cab..2bd5eeb38 100644
--- a/frontend/src/services/chatService.ts
+++ b/frontend/src/services/chatService.ts
@@ -2,21 +2,21 @@ import { api } from "@/services/api";
 import type { RecommendedQuestionsPayload } from "@/types";
 
 export async function stopTask(taskId: string) {
-  return api.post<void>(`/rag/v3/stop?taskId=${encodeURIComponent(taskId)}`);
+  return api.post<void, void>(`/rag/v3/stop?taskId=${encodeURIComponent(taskId)}`);
 }
 
 export async function submitFeedback(messageId: string, vote: number) {
-  return api.post<void>(`/conversations/messages/${messageId}/feedback`, {
+  return api.post<void, void>(`/conversations/messages/${messageId}/feedback`, {
     vote
   });
 }
 
 export async function cancelFeedback(messageId: string) {
-  return api.delete<void>(`/conversations/messages/${messageId}/feedback`);
+  return api.delete<void, void>(`/conversations/messages/${messageId}/feedback`);
 }
 
 export async function generateRecommendedQuestions(messageId: string) {
-  return api.post<RecommendedQuestionsPayload>(
+  return api.post<RecommendedQuestionsPayload, RecommendedQuestionsPayload>(
     `/conversations/messages/${messageId}/recommended-questions`
   );
 }
diff --git a/frontend/src/services/sessionService.ts b/frontend/src/services/sessionService.ts
index 2d1780b7e..f0dc45b49 100644
--- a/frontend/src/services/sessionService.ts
+++ b/frontend/src/services/sessionService.ts
@@ -22,17 +22,17 @@ export interface ConversationMessageVO {
 }
 
 export async function listSessions() {
-  return api.get<ConversationVO[]>("/conversations");
+  return api.get<ConversationVO[], ConversationVO[]>("/conversations");
 }
 
 export async function deleteSession(conversationId: string) {
-  return api.delete<void>(`/conversations/${conversationId}`);
+  return api.delete<void, void>(`/conversations/${conversationId}`);
 }
 
 export async function renameSession(conversationId: string, title: string) {
-  return api.put<void>(`/conversations/${conversationId}`, { title });
+  return api.put<void, void>(`/conversations/${conversationId}`, { title });
 }
 
 export async function listMessages(conversationId: string) {
-  return api.get<ConversationMessageVO[]>(`/conversations/${conversationId}/messages`);
+  return api.get<ConversationMessageVO[], ConversationMessageVO[]>(`/conversations/${conversationId}/messages`);
 }
diff --git a/frontend/src/stores/authStore.ts b/frontend/src/stores/authStore.ts
index a82575bcc..0538b7c65 100644
--- a/frontend/src/stores/authStore.ts
+++ b/frontend/src/stores/authStore.ts
@@ -1,6 +1,3 @@
-// @ts-nocheck
-/* eslint-disable */
-
 import { create } from "zustand";
 import { toast } from "sonner";
 
diff --git a/frontend/src/stores/chatStore.ts b/frontend/src/stores/chatStore.ts
index bccfcd74f..beb00705b 100644
--- a/frontend/src/stores/chatStore.ts
+++ b/frontend/src/stores/chatStore.ts
@@ -227,18 +227,19 @@ export const useChatStore = create<ChatState>((set, get) => ({
     } catch (error) {
       toast.error((error as Error).message || "加载消息失败");
     } finally {
+      // finally 内不使用 return：会话已切换时只复位 loading，否则完整复位流式状态
       if (get().currentSessionId !== sessionId) {
         set({ isLoading: false });
-        return;
+      } else {
+        set({
+          isLoading: false,
+          isStreaming: false,
+          streamTaskId: null,
+          streamAbort: null,
+          streamingMessageId: null,
+          cancelRequested: false
+        });
       }
-      set({
-        isLoading: false,
-        isStreaming: false,
-        streamTaskId: null,
-        streamAbort: null,
-        streamingMessageId: null,
-        cancelRequested: false
-      });
     }
   },
   updateSessionTitle: (sessionId, title) => {