feat(admin-v2): add Knowledge base management page

- 4 tabs: Items (CRUD + ProTable), Categories (tree management), Search, Analytics
- Knowledge service with full API integration
- Nav item + breadcrumb + route registration
- Analytics overview with 8 KPI statistics

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

admin-v2/src/layouts/AdminLayout.tsx

@@ -16,6 +16,7 @@ import {
   SunOutlined,
   MoonOutlined,
   ApiOutlined,
+  BookOutlined,
 } from '@ant-design/icons'
 import { Avatar, Dropdown, Tooltip, Drawer } from 'antd'
 import { useAuthStore } from '@/stores/authStore'
@@ -42,6 +43,7 @@ const navItems: NavItem[] = [
   { path: '/api-keys', name: 'API 密钥', icon: <ApiOutlined />, permission: 'provider:manage', group: '资源管理' },
   { path: '/usage', name: '用量统计', icon: <BarChartOutlined />, permission: 'admin:full', group: '运维' },
   { path: '/relay', name: '中转任务', icon: <SwapOutlined />, permission: 'relay:use', group: '运维' },
+  { path: '/knowledge', name: '知识库', icon: <BookOutlined />, permission: 'knowledge:read', group: '资源管理' },
   { path: '/logs', name: '操作日志', icon: <FileTextOutlined />, permission: 'admin:full', group: '运维' },
   { path: '/config', name: '系统配置', icon: <SettingOutlined />, permission: 'config:read', group: '系统' },
   { path: '/prompts', name: '提示词管理', icon: <MessageOutlined />, permission: 'prompt:read', group: '系统' },
@@ -204,6 +206,7 @@ const breadcrumbMap: Record<string, string> = {
   '/agent-templates': 'Agent 模板',
   '/usage': '用量统计',
   '/relay': '中转任务',
+  '/knowledge': '知识库',
   '/config': '系统配置',
   '/prompts': '提示词管理',
   '/logs': '操作日志',

admin-v2/src/pages/Knowledge.tsx

@@ -0,0 +1,503 @@
+// ============================================================
+// 知识库管理
+// ============================================================
+
+import { useState, useMemo } from 'react'
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
+import {
+  Button, message, Tag, Modal, Form, Input, Select, Space, Popconfirm,
+  Card, Statistic, Row, Col, Tabs, Tree, Typography, Empty, Spin, InputNumber,
+} from 'antd'
+import {
+  PlusOutlined, SearchOutlined, BookOutlined, FolderOutlined,
+  DeleteOutlined, EditOutlined, EyeOutlined, BarChartOutlined,
+} from '@ant-design/icons'
+import type { ProColumns } from '@ant-design/pro-components'
+import { ProTable } from '@ant-design/pro-components'
+import { knowledgeService } from '@/services/knowledge'
+import type { CategoryResponse, KnowledgeItem, SearchResult } from '@/services/knowledge'
+
+const { TextArea } = Input
+const { Text, Title } = Typography
+
+// === 分类树 + 条目列表 Tab ===
+
+function CategoriesPanel() {
+  const queryClient = useQueryClient()
+  const [createOpen, setCreateOpen] = useState(false)
+  const [form] = Form.useForm()
+
+  const { data: categories = [], isLoading } = useQuery({
+    queryKey: ['knowledge-categories'],
+    queryFn: ({ signal }) => knowledgeService.listCategories(signal),
+  })
+
+  const createMutation = useMutation({
+    mutationFn: (data: Parameters<typeof knowledgeService.createCategory>[0]) =>
+      knowledgeService.createCategory(data),
+    onSuccess: () => {
+      message.success('分类已创建')
+      queryClient.invalidateQueries({ queryKey: ['knowledge-categories'] })
+      setCreateOpen(false)
+      form.resetFields()
+    },
+    onError: (err: Error) => message.error(err.message || '创建失败'),
+  })
+
+  const deleteMutation = useMutation({
+    mutationFn: (id: string) => knowledgeService.deleteCategory(id),
+    onSuccess: () => {
+      message.success('分类已删除')
+      queryClient.invalidateQueries({ queryKey: ['knowledge-categories'] })
+    },
+    onError: (err: Error) => message.error(err.message || '删除失败'),
+  })
+
+  const treeData = useMemo(
+    () => buildTreeData(categories, (id) => {
+      Modal.confirm({
+        title: '确认删除',
+        content: '删除后无法恢复，请确保分类下没有子分类和条目。',
+        okType: 'danger',
+        onOk: () => deleteMutation.mutate(id),
+      })
+    }),
+    [categories, deleteMutation],
+  )
+
+  return (
+    <div>
+      <div className="flex justify-between items-center mb-4">
+        <Title level={5} style={{ margin: 0 }}>分类管理</Title>
+        <Button type="primary" icon={<PlusOutlined />} onClick={() => setCreateOpen(true)}>
+          新建分类
+        </Button>
+      </div>
+
+      {isLoading ? (
+        <div className="flex justify-center py-8"><Spin /></div>
+      ) : categories.length === 0 ? (
+        <Empty description="暂无分类，请新建一个" />
+      ) : (
+        <Tree
+          treeData={treeData}
+          defaultExpandAll
+          showLine={{ showLeafIcon: false }}
+          showIcon
+        />
+      )}
+
+      <Modal
+        title="新建分类"
+        open={createOpen}
+        onCancel={() => setCreateOpen(false)}
+        onOk={() => form.submit()}
+        confirmLoading={createMutation.isPending}
+      >
+        <Form form={form} layout="vertical" onFinish={(v) => createMutation.mutate(v)}>
+          <Form.Item name="name" label="分类名称" rules={[{ required: true, message: '请输入分类名称' }]}>
+            <Input placeholder="例如：产品知识、技术文档" />
+          </Form.Item>
+          <Form.Item name="description" label="描述">
+            <TextArea rows={2} placeholder="可选描述" />
+          </Form.Item>
+          <Form.Item name="parent_id" label="父分类">
+            <Select placeholder="无（顶级分类）" allowClear>
+              {flattenCategories(categories).map((c) => (
+                <Select.Option key={c.id} value={c.id}>{c.name}</Select.Option>
+              ))}
+            </Select>
+          </Form.Item>
+          <Form.Item name="icon" label="图标">
+            <Input placeholder="可选，如 📚" />
+          </Form.Item>
+        </Form>
+      </Modal>
+    </div>
+  )
+}
+
+// === 条目列表 ===
+
+function ItemsPanel() {
+  const queryClient = useQueryClient()
+  const [createOpen, setCreateOpen] = useState(false)
+  const [detailItem, setDetailItem] = useState<string | null>(null)
+  const [page, setPage] = useState(1)
+  const [pageSize, setPageSize] = useState(20)
+  const [filters, setFilters] = useState<{ category_id?: string; status?: string; keyword?: string }>({})
+  const [form] = Form.useForm()
+
+  const { data: categories = [] } = useQuery({
+    queryKey: ['knowledge-categories'],
+    queryFn: ({ signal }) => knowledgeService.listCategories(signal),
+  })
+
+  const { data, isLoading } = useQuery({
+    queryKey: ['knowledge-items', page, pageSize, filters],
+    queryFn: ({ signal }) =>
+      knowledgeService.listItems({ page, page_size: pageSize, ...filters }, signal),
+  })
+
+  const { data: detailData } = useQuery({
+    queryKey: ['knowledge-item-detail', detailItem],
+    queryFn: ({ signal }) => knowledgeService.getItem(detailItem!, signal),
+    enabled: !!detailItem,
+  })
+
+  const createMutation = useMutation({
+    mutationFn: (data: Parameters<typeof knowledgeService.createItem>[0]) =>
+      knowledgeService.createItem(data),
+    onSuccess: () => {
+      message.success('条目已创建')
+      queryClient.invalidateQueries({ queryKey: ['knowledge-items'] })
+      setCreateOpen(false)
+      form.resetFields()
+    },
+    onError: (err: Error) => message.error(err.message || '创建失败'),
+  })
+
+  const deleteMutation = useMutation({
+    mutationFn: (id: string) => knowledgeService.deleteItem(id),
+    onSuccess: () => {
+      message.success('已删除')
+      queryClient.invalidateQueries({ queryKey: ['knowledge-items'] })
+    },
+    onError: (err: Error) => message.error(err.message || '删除失败'),
+  })
+
+  const statusColors: Record<string, string> = { active: 'green', draft: 'orange', archived: 'default' }
+  const statusLabels: Record<string, string> = { active: '活跃', draft: '草稿', archived: '已归档' }
+
+  const columns: ProColumns<KnowledgeItem>[] = [
+    {
+      title: '标题',
+      dataIndex: 'title',
+      width: 250,
+      render: (_, r) => (
+        <Button type="link" size="small" onClick={() => setDetailItem(r.id)}>
+          {r.title}
+        </Button>
+      ),
+    },
+    { title: '状态', dataIndex: 'status', width: 80, valueEnum: Object.fromEntries(Object.entries(statusLabels).map(([k, v]) => [k, { text: v, status: statusColors[k] === 'green' ? 'Success' : statusColors[k] === 'orange' ? 'Warning' : 'Default' }])) },
+    { title: '版本', dataIndex: 'version', width: 60, search: false },
+    { title: '优先级', dataIndex: 'priority', width: 70, search: false },
+    {
+      title: '标签',
+      dataIndex: 'tags',
+      width: 200,
+      search: false,
+      render: (_, r) => (
+        <Space size={[4, 4]} wrap>
+          {r.tags?.map((t) => <Tag key={t}>{t}</Tag>)}
+        </Space>
+      ),
+    },
+    { title: '更新时间', dataIndex: 'updated_at', width: 160, valueType: 'dateTime', search: false },
+    {
+      title: '操作',
+      width: 100,
+      search: false,
+      render: (_, r) => (
+        <Space>
+          <Button type="link" size="small" icon={<EyeOutlined />} onClick={() => setDetailItem(r.id)} />
+          <Popconfirm title="确认删除？" onConfirm={() => deleteMutation.mutate(r.id)}>
+            <Button type="link" size="small" danger icon={<DeleteOutlined />} />
+          </Popconfirm>
+        </Space>
+      ),
+    },
+  ]
+
+  return (
+    <div>
+      <ProTable<KnowledgeItem>
+        columns={columns}
+        dataSource={data?.items || []}
+        loading={isLoading}
+        rowKey="id"
+        search={{
+          onReset: () => setFilters({}),
+          onSearch: (values) => setFilters(values),
+        }}
+        toolBarRender={() => [
+          <Button key="create" type="primary" icon={<PlusOutlined />} onClick={() => setCreateOpen(true)}>
+            新建条目
+          </Button>,
+        ]}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total || 0,
+          showSizeChanger: true,
+          onChange: (p, ps) => { setPage(p); setPageSize(ps) },
+        }}
+        options={{ density: false, fullScreen: false, reload: () => queryClient.invalidateQueries({ queryKey: ['knowledge-items'] }) }}
+      />
+
+      {/* 创建弹窗 */}
+      <Modal
+        title="新建知识条目"
+        open={createOpen}
+        onCancel={() => setCreateOpen(false)}
+        onOk={() => form.submit()}
+        confirmLoading={createMutation.isPending}
+        width={640}
+      >
+        <Form form={form} layout="vertical" onFinish={(v) => createMutation.mutate(v)}>
+          <Form.Item name="category_id" label="分类" rules={[{ required: true, message: '请选择分类' }]}>
+            <Select placeholder="选择分类">
+              {flattenCategories(categories).map((c) => (
+                <Select.Option key={c.id} value={c.id}>{c.name}</Select.Option>
+              ))}
+            </Select>
+          </Form.Item>
+          <Form.Item name="title" label="标题" rules={[{ required: true, message: '请输入标题' }]}>
+            <Input placeholder="知识条目标题" />
+          </Form.Item>
+          <Form.Item name="content" label="内容" rules={[{ required: true, message: '请输入内容' }]}>
+            <TextArea rows={8} placeholder="支持 Markdown 格式" />
+          </Form.Item>
+          <Row gutter={16}>
+            <Col span={12}>
+              <Form.Item name="keywords" label="关键词">
+                <Select mode="tags" placeholder="输入后回车添加" />
+              </Form.Item>
+            </Col>
+            <Col span={12}>
+              <Form.Item name="tags" label="标签">
+                <Select mode="tags" placeholder="输入后回车添加" />
+              </Form.Item>
+            </Col>
+          </Row>
+          <Form.Item name="priority" label="优先级" initialValue={0}>
+            <InputNumber min={0} max={100} />
+          </Form.Item>
+        </Form>
+      </Modal>
+
+      {/* 详情弹窗 */}
+      <Modal
+        title={detailData?.title || '条目详情'}
+        open={!!detailItem}
+        onCancel={() => setDetailItem(null)}
+        footer={null}
+        width={720}
+      >
+        {detailData && (
+          <div>
+            <div className="mb-4 flex gap-2">
+              <Tag color={statusColors[detailData.status]}>{statusLabels[detailData.status] || detailData.status}</Tag>
+              <Tag>版本 {detailData.version}</Tag>
+              <Tag>优先级 {detailData.priority}</Tag>
+            </div>
+            <div className="mb-4 whitespace-pre-wrap bg-neutral-50 dark:bg-neutral-900 p-4 rounded-lg max-h-96 overflow-y-auto text-sm">
+              {detailData.content}
+            </div>
+            <div className="flex gap-2 flex-wrap">
+              {detailData.tags?.map((t) => <Tag key={t} color="blue">{t}</Tag>)}
+              {detailData.keywords?.map((k) => <Tag key={k} color="cyan">{k}</Tag>)}
+            </div>
+          </div>
+        )}
+      </Modal>
+    </div>
+  )
+}
+
+// === 搜索面板 ===
+
+function SearchPanel() {
+  const [query, setQuery] = useState('')
+  const [results, setResults] = useState<SearchResult[]>([])
+  const [searching, setSearching] = useState(false)
+
+  const handleSearch = async () => {
+    if (!query.trim()) return
+    setSearching(true)
+    try {
+      const data = await knowledgeService.search({ query: query.trim(), limit: 10 })
+      setResults(data)
+    } catch (err) {
+      message.error('搜索失败')
+    } finally {
+      setSearching(false)
+    }
+  }
+
+  return (
+    <div>
+      <Title level={5}>语义搜索</Title>
+      <Space.Compact className="w-full mb-4">
+        <Input
+          size="large"
+          placeholder="输入搜索关键词..."
+          value={query}
+          onChange={(e) => setQuery(e.target.value)}
+          onPressEnter={handleSearch}
+          prefix={<SearchOutlined />}
+        />
+        <Button size="large" type="primary" loading={searching} onClick={handleSearch}>
+          搜索
+        </Button>
+      </Space.Compact>
+
+      {results.length === 0 && !searching && query === '' && (
+        <Empty description="输入关键词搜索知识库" />
+      )}
+
+      <div className="space-y-3">
+        {results.map((r) => (
+          <Card key={r.chunk_id} size="small" hoverable>
+            <div className="flex justify-between items-start mb-2">
+              <Text strong>{r.item_title}</Text>
+              <Tag>{r.category_name}</Tag>
+            </div>
+            <div className="text-sm text-neutral-600 dark:text-neutral-400 line-clamp-3 mb-2">
+              {r.content}
+            </div>
+            <div className="flex gap-1 flex-wrap">
+              {r.keywords?.slice(0, 5).map((k) => (
+                <Tag key={k} color="cyan" style={{ fontSize: 11 }}>{k}</Tag>
+              ))}
+            </div>
+          </Card>
+        ))}
+      </div>
+    </div>
+  )
+}
+
+// === 分析看板 ===
+
+function AnalyticsPanel() {
+  const { data: overview, isLoading } = useQuery({
+    queryKey: ['knowledge-analytics'],
+    queryFn: ({ signal }) => knowledgeService.getOverview(signal),
+  })
+
+  if (isLoading) return <div className="flex justify-center py-8"><Spin /></div>
+
+  return (
+    <div>
+      <Title level={5} className="mb-4">知识库概览</Title>
+      <Row gutter={[16, 16]}>
+        <Col span={6}>
+          <Card><Statistic title="总条目数" value={overview?.total_items || 0} /></Card>
+        </Col>
+        <Col span={6}>
+          <Card><Statistic title="活跃条目" value={overview?.active_items || 0} valueStyle={{ color: '#52c41a' }} /></Card>
+        </Col>
+        <Col span={6}>
+          <Card><Statistic title="分类数" value={overview?.total_categories || 0} /></Card>
+        </Col>
+        <Col span={6}>
+          <Card><Statistic title="本周新增" value={overview?.weekly_new_items || 0} valueStyle={{ color: '#1890ff' }} /></Card>
+        </Col>
+      </Row>
+
+      <Row gutter={[16, 16]} className="mt-4">
+        <Col span={6}>
+          <Card><Statistic title="总引用次数" value={overview?.total_references || 0} /></Card>
+        </Col>
+        <Col span={6}>
+          <Card>
+            <Statistic
+              title="注入率"
+              value={((overview?.injection_rate || 0) * 100).toFixed(1)}
+              suffix="%"
+            />
+          </Card>
+        </Col>
+        <Col span={6}>
+          <Card>
+            <Statistic
+              title="正面反馈率"
+              value={((overview?.positive_feedback_rate || 0) * 100).toFixed(1)}
+              suffix="%"
+              valueStyle={{ color: '#52c41a' }}
+            />
+          </Card>
+        </Col>
+        <Col span={6}>
+          <Card><Statistic title="过期条目" value={overview?.stale_items_count || 0} valueStyle={{ color: '#faad14' }} /></Card>
+        </Col>
+      </Row>
+    </div>
+  )
+}
+
+// === 主页面 ===
+
+export default function Knowledge() {
+  return (
+    <div className="p-6">
+      <Tabs
+        defaultActiveKey="items"
+        items={[
+          {
+            key: 'items',
+            label: '知识条目',
+            icon: <BookOutlined />,
+            children: <ItemsPanel />,
+          },
+          {
+            key: 'categories',
+            label: '分类管理',
+            icon: <FolderOutlined />,
+            children: <CategoriesPanel />,
+          },
+          {
+            key: 'search',
+            label: '搜索',
+            icon: <SearchOutlined />,
+            children: <SearchPanel />,
+          },
+          {
+            key: 'analytics',
+            label: '分析看板',
+            icon: <BarChartOutlined />,
+            children: <AnalyticsPanel />,
+          },
+        ]}
+      />
+    </div>
+  )
+}
+
+// === 辅助函数 ===
+
+function flattenCategories(cats: CategoryResponse[]): { id: string; name: string }[] {
+  const result: { id: string; name: string }[] = []
+  for (const c of cats) {
+    result.push({ id: c.id, name: c.name })
+    if (c.children?.length) {
+      result.push(...flattenCategories(c.children))
+    }
+  }
+  return result
+}
+
+interface TreeNode {
+  key: string
+  title: React.ReactNode
+  icon?: React.ReactNode
+  children?: TreeNode[]
+}
+
+function buildTreeData(cats: CategoryResponse[], onDelete: (id: string) => void): TreeNode[] {
+  return cats.map((c) => ({
+    key: c.id,
+    title: (
+      <div className="flex items-center gap-2">
+        <span>{c.icon || '📁'} {c.name}</span>
+        <Tag>{c.item_count}</Tag>
+        <Button type="link" size="small" danger onClick={() => onDelete(c.id)}>
+          <DeleteOutlined />
+        </Button>
+      </div>
+    ),
+    children: c.children?.length ? buildTreeData(c.children, onDelete) : undefined,
+  }))
+}

admin-v2/src/router/index.tsx

@@ -28,6 +28,7 @@ export const router = createBrowserRouter([
       { path: 'api-keys', lazy: () => import('@/pages/ModelServices').then((m) => ({ Component: m.default })) },
       { path: 'usage', lazy: () => import('@/pages/Usage').then((m) => ({ Component: m.default })) },
       { path: 'relay', lazy: () => import('@/pages/Relay').then((m) => ({ Component: m.default })) },
+      { path: 'knowledge', lazy: () => import('@/pages/Knowledge').then((m) => ({ Component: m.default })) },
       { path: 'config', lazy: () => import('@/pages/Config').then((m) => ({ Component: m.default })) },
       { path: 'prompts', lazy: () => import('@/pages/Prompts').then((m) => ({ Component: m.default })) },
       { path: 'logs', lazy: () => import('@/pages/Logs').then((m) => ({ Component: m.default })) },

admin-v2/src/services/knowledge.ts

@@ -0,0 +1,128 @@
+import request, { withSignal } from './request'
+
+// === Types ===
+
+export interface CategoryResponse {
+  id: string
+  name: string
+  description: string | null
+  parent_id: string | null
+  icon: string | null
+  sort_order: number
+  item_count: number
+  children: CategoryResponse[]
+  created_at: string
+  updated_at: string
+}
+
+export interface KnowledgeItem {
+  id: string
+  category_id: string
+  title: string
+  content: string
+  keywords: string[]
+  related_questions: string[]
+  priority: number
+  status: string
+  version: number
+  source: string
+  tags: string[]
+  created_by: string
+  created_at: string
+  updated_at: string
+}
+
+export interface SearchResult {
+  chunk_id: string
+  item_id: string
+  item_title: string
+  category_name: string
+  content: string
+  score: number
+  keywords: string[]
+}
+
+export interface AnalyticsOverview {
+  total_items: number
+  active_items: number
+  total_categories: number
+  weekly_new_items: number
+  total_references: number
+  avg_reference_per_item: number
+  hit_rate: number
+  injection_rate: number
+  positive_feedback_rate: number
+  stale_items_count: number
+}
+
+export interface ListItemsResponse {
+  items: KnowledgeItem[]
+  total: number
+  page: number
+  page_size: number
+}
+
+// === Service ===
+
+export const knowledgeService = {
+  // 分类
+  listCategories: (signal?: AbortSignal) =>
+    request.get<CategoryResponse[]>('/knowledge/categories', withSignal({}, signal))
+      .then((r) => r.data),
+
+  createCategory: (data: { name: string; description?: string; parent_id?: string; icon?: string }) =>
+    request.post('/knowledge/categories', data).then((r) => r.data),
+
+  deleteCategory: (id: string) =>
+    request.delete(`/knowledge/categories/${id}`).then((r) => r.data),
+
+  // 条目
+  listItems: (params: { page?: number; page_size?: number; category_id?: string; status?: string; keyword?: string }, signal?: AbortSignal) =>
+    request.get<ListItemsResponse>('/knowledge/items', withSignal({ params }, signal))
+      .then((r) => r.data),
+
+  getItem: (id: string, signal?: AbortSignal) =>
+    request.get<KnowledgeItem>(`/knowledge/items/${id}`, withSignal({}, signal))
+      .then((r) => r.data),
+
+  createItem: (data: {
+    category_id: string
+    title: string
+    content: string
+    keywords?: string[]
+    related_questions?: string[]
+    priority?: number
+    tags?: string[]
+  }) => request.post('/knowledge/items', data).then((r) => r.data),
+
+  updateItem: (id: string, data: Record<string, unknown>) =>
+    request.put(`/knowledge/items/${id}`, data).then((r) => r.data),
+
+  deleteItem: (id: string) =>
+    request.delete(`/knowledge/items/${id}`).then((r) => r.data),
+
+  batchCreate: (items: Array<{
+    category_id: string
+    title: string
+    content: string
+    keywords?: string[]
+    tags?: string[]
+  }>) => request.post('/knowledge/items/batch', items).then((r) => r.data),
+
+  // 搜索
+  search: (data: { query: string; category_id?: string; limit?: number }) =>
+    request.post<SearchResult[]>('/knowledge/search', data).then((r) => r.data),
+
+  // 分析
+  getOverview: (signal?: AbortSignal) =>
+    request.get<AnalyticsOverview>('/knowledge/analytics/overview', withSignal({}, signal))
+      .then((r) => r.data),
+
+  getTrends: (signal?: AbortSignal) =>
+    request.get('/knowledge/analytics/trends', withSignal({}, signal))
+      .then((r) => r.data),
+
+  getTopItems: (signal?: AbortSignal) =>
+    request.get('/knowledge/analytics/top-items', withSignal({}, signal))
+      .then((r) => r.data),
+}