feat(admin): LLM config, knowledge base, and WeCom AI binding

Add owner-scoped model API settings, uploadable knowledge bases, and WeCom bot AI/KB wiring with OpenAI-compatible URL normalization.

Co-authored-by: Cursor <cursoragent@cursor.com>

apps/admin-web/src/App.tsx

@@ -43,6 +43,8 @@ import WechatBindingsPage from './pages/WechatBindingsPage';
 import HqPermissionsPage from './pages/HqPermissionsPage';
 import SystemSettingsPage from './pages/SystemSettingsPage';
 import WecomBotsPage from './pages/WecomBotsPage';
+import LlmConfigsPage from './pages/LlmConfigsPage';
+import KnowledgeBasesPage from './pages/KnowledgeBasesPage';
 
 function RequireAuth({ children }: { children: React.ReactNode }) {
   if (!getToken()) return <Navigate to="/login" replace />;
@@ -70,6 +72,8 @@ export default function App() {
           <Route path="users" element={<PromoCodeUsersPage />} />
         </Route>
         <Route path="/wecom-bots" element={<WecomBotsPage />} />
+        <Route path="/llm-configs" element={<LlmConfigsPage />} />
+        <Route path="/knowledge-bases" element={<KnowledgeBasesPage />} />
         <Route path="/products" element={<ProductsPage />} />
         <Route path="/product-detail-templates" element={<ProductDetailTemplatesPage />} />
         <Route path="/stores" element={<StoresPage />} />

apps/admin-web/src/layouts/AdminLayout.tsx

@@ -3,6 +3,7 @@ import { Outlet, useLocation, useNavigate } from 'react-router-dom';
 import { Layout, Menu, Typography, Button, Space } from 'antd';
 import type { MenuProps } from 'antd';
 import {
+  RobotOutlined,
   DashboardOutlined,
   UserOutlined,
   ShoppingOutlined,
@@ -42,6 +43,8 @@ const MENU_ITEMS: MenuProps['items'] = [
   { key: '/orders', icon: <ShoppingOutlined />, label: '订单' },
   { key: '/promo-codes', icon: <GiftOutlined />, label: '推广码' },
   { key: '/wecom-bots', icon: <TeamOutlined />, label: '企微机器人' },
+  { key: '/llm-configs', icon: <RobotOutlined />, label: '语言模型' },
+  { key: '/knowledge-bases', icon: <FileTextOutlined />, label: '知识库' },
   {
     key: 'stores-group',
     icon: <ShopOutlined />,
@@ -137,6 +140,8 @@ function menuAllowed(key: string, permissionKeys: string[]): boolean {
     '/orders': 'orders',
     '/promo-codes': 'promo_codes',
     '/wecom-bots': 'wecom_bots',
+    '/llm-configs': 'llm_configs',
+    '/knowledge-bases': 'knowledge_bases',
     'stores-group': 'stores',
     '/stores': 'stores',
     '/store-categories': 'stores',

apps/admin-web/src/pages/KnowledgeBasesPage.tsx

@@ -0,0 +1,403 @@
+import { useState } from 'react';
+import {
+  Button,
+  Drawer,
+  Form,
+  Input,
+  Modal,
+  Popconfirm,
+  Space,
+  Switch,
+  Table,
+  Tag,
+  Typography,
+  Upload,
+  message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import { UploadOutlined } from '@ant-design/icons';
+import type {
+  KnowledgeBaseDto,
+  KnowledgeDocumentDto,
+} from '@dukang/shared-types';
+import { request } from '../lib/api';
+import { fmtTime } from '../lib/constants';
+import { useAdminList } from '../lib/useAdminList';
+import { uploadFileToOss } from '../lib/upload';
+
+type FormValues = {
+  name: string;
+  description?: string;
+  enabled: boolean;
+};
+
+type DocForm = {
+  title: string;
+  contentText?: string;
+};
+
+export default function KnowledgeBasesPage() {
+  const [filterForm] = Form.useForm();
+  const [form] = Form.useForm<FormValues>();
+  const [docForm] = Form.useForm<DocForm>();
+  const [filters, setFilters] = useState<Record<string, string>>({});
+  const [modalOpen, setModalOpen] = useState(false);
+  const [editing, setEditing] = useState<KnowledgeBaseDto | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [drawerKb, setDrawerKb] = useState<KnowledgeBaseDto | null>(null);
+  const [docs, setDocs] = useState<KnowledgeDocumentDto[]>([]);
+  const [docsLoading, setDocsLoading] = useState(false);
+  const [docModalOpen, setDocModalOpen] = useState(false);
+  const [docSaving, setDocSaving] = useState(false);
+
+  const { data, loading, page, pageSize, setPage, setPageSize, reload } =
+    useAdminList<KnowledgeBaseDto>(
+      '/admin/knowledge-bases',
+      () => {
+        const qs = new URLSearchParams();
+        if (filters.name) qs.set('name', filters.name);
+        if (filters.enabled) qs.set('enabled', filters.enabled);
+        return qs;
+      },
+      [filters],
+    );
+
+  const loadDocs = async (kb: KnowledgeBaseDto) => {
+    setDrawerKb(kb);
+    setDocsLoading(true);
+    try {
+      const res = await request<{ items: KnowledgeDocumentDto[] }>(
+        `/admin/knowledge-bases/${kb.id}/documents`,
+      );
+      setDocs(res.items);
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : String(e));
+    } finally {
+      setDocsLoading(false);
+    }
+  };
+
+  const openCreate = () => {
+    setEditing(null);
+    form.setFieldsValue({ name: '', description: '', enabled: true });
+    setModalOpen(true);
+  };
+
+  const openEdit = (row: KnowledgeBaseDto) => {
+    setEditing(row);
+    form.setFieldsValue({
+      name: row.name,
+      description: row.description || '',
+      enabled: row.enabled,
+    });
+    setModalOpen(true);
+  };
+
+  const onSave = async () => {
+    const values = await form.validateFields();
+    setSaving(true);
+    try {
+      if (editing) {
+        await request(`/admin/knowledge-bases/${editing.id}`, {
+          method: 'PUT',
+          body: JSON.stringify(values),
+        });
+        message.success('已保存');
+      } else {
+        await request('/admin/knowledge-bases', {
+          method: 'POST',
+          body: JSON.stringify(values),
+        });
+        message.success('已创建');
+      }
+      setModalOpen(false);
+      reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : String(e));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  const columns: ColumnsType<KnowledgeBaseDto> = [
+    { title: '名称', dataIndex: 'name' },
+    { title: '说明', dataIndex: 'description', ellipsis: true },
+    { title: '文档数', dataIndex: 'documentCount', width: 90 },
+    {
+      title: '启用',
+      dataIndex: 'enabled',
+      width: 90,
+      render: (v: boolean) => (v ? <Tag color="green">开</Tag> : <Tag>关</Tag>),
+    },
+    {
+      title: '创建人',
+      dataIndex: 'createdByName',
+      width: 100,
+      render: (v: string | null, row) => v || row.createdByHqAccountId,
+    },
+    {
+      title: '更新时间',
+      dataIndex: 'updatedAt',
+      width: 170,
+      render: (t: string) => fmtTime(t),
+    },
+    {
+      title: '操作',
+      width: 240,
+      render: (_, row) => (
+        <Space>
+          <Button type="link" size="small" onClick={() => void loadDocs(row)}>
+            文档
+          </Button>
+          {row.canEditFull ? (
+            <Button type="link" size="small" onClick={() => openEdit(row)}>
+              编辑
+            </Button>
+          ) : null}
+          {row.canEditFull ? (
+            <Popconfirm
+              title="确认删除知识库及全部文档？"
+              onConfirm={async () => {
+                try {
+                  await request(`/admin/knowledge-bases/${row.id}`, { method: 'DELETE' });
+                  message.success('已删除');
+                  reload();
+                } catch (e) {
+                  message.error(e instanceof Error ? e.message : String(e));
+                }
+              }}
+            >
+              <Button type="link" size="small" danger>
+                删除
+              </Button>
+            </Popconfirm>
+          ) : null}
+        </Space>
+      ),
+    },
+  ];
+
+  const docColumns: ColumnsType<KnowledgeDocumentDto> = [
+    { title: '标题', dataIndex: 'title' },
+    { title: '文件', dataIndex: 'fileName', ellipsis: true },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 90,
+      render: (s: string) =>
+        s === 'READY' ? <Tag color="green">可检索</Tag> : s === 'FAILED' ? <Tag color="red">失败</Tag> : <Tag>无正文</Tag>,
+    },
+    {
+      title: '时间',
+      dataIndex: 'createdAt',
+      width: 170,
+      render: (t: string) => fmtTime(t),
+    },
+    {
+      title: '操作',
+      width: 80,
+      render: (_, row) =>
+        drawerKb?.canEditFull ? (
+          <Popconfirm
+            title="删除文档？"
+            onConfirm={async () => {
+              try {
+                await request(`/admin/knowledge-bases/${drawerKb.id}/documents/${row.id}`, {
+                  method: 'DELETE',
+                });
+                message.success('已删除');
+                void loadDocs(drawerKb);
+                reload();
+              } catch (e) {
+                message.error(e instanceof Error ? e.message : String(e));
+              }
+            }}
+          >
+            <Button type="link" size="small" danger>
+              删除
+            </Button>
+          </Popconfirm>
+        ) : null,
+    },
+  ];
+
+  return (
+    <div>
+      <Space style={{ marginBottom: 16 }} wrap>
+        <Typography.Title level={4} style={{ margin: 0 }}>
+          知识库
+        </Typography.Title>
+        <Typography.Text type="secondary">
+          支持粘贴文本或上传 .txt/.md；可绑定到企微机器人供 AI 检索
+        </Typography.Text>
+      </Space>
+
+      <Form
+        form={filterForm}
+        layout="inline"
+        style={{ marginBottom: 16 }}
+        onFinish={(v) =>
+          setFilters({
+            name: v.name || '',
+            enabled: v.enabled === undefined || v.enabled === null ? '' : String(v.enabled),
+          })
+        }
+      >
+        <Form.Item name="name" label="名称">
+          <Input allowClear />
+        </Form.Item>
+        <Form.Item>
+          <Button type="primary" htmlType="submit">
+            查询
+          </Button>
+        </Form.Item>
+        <Form.Item>
+          <Button type="primary" onClick={openCreate}>
+            新建知识库
+          </Button>
+        </Form.Item>
+      </Form>
+
+      <Table
+        rowKey="id"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total,
+          showSizeChanger: true,
+          onChange: (p, ps) => {
+            setPage(p);
+            setPageSize(ps);
+          },
+        }}
+      />
+
+      <Modal
+        title={editing ? '编辑知识库' : '新建知识库'}
+        open={modalOpen}
+        onCancel={() => setModalOpen(false)}
+        onOk={() => void onSave()}
+        confirmLoading={saving}
+        destroyOnClose
+      >
+        <Form form={form} layout="vertical">
+          <Form.Item name="name" label="名称" rules={[{ required: true }]}>
+            <Input />
+          </Form.Item>
+          <Form.Item name="description" label="说明">
+            <Input.TextArea rows={2} />
+          </Form.Item>
+          <Form.Item name="enabled" label="启用" valuePropName="checked">
+            <Switch />
+          </Form.Item>
+        </Form>
+      </Modal>
+
+      <Drawer
+        title={drawerKb ? `文档 · ${drawerKb.name}` : '文档'}
+        open={!!drawerKb}
+        width={720}
+        onClose={() => setDrawerKb(null)}
+        extra={
+          drawerKb?.canEditFull ? (
+            <Button type="primary" onClick={() => { docForm.resetFields(); setDocModalOpen(true); }}>
+              上传/粘贴
+            </Button>
+          ) : null
+        }
+      >
+        <Table
+          rowKey="id"
+          size="small"
+          loading={docsLoading}
+          columns={docColumns}
+          dataSource={docs}
+          pagination={false}
+        />
+      </Drawer>
+
+      <Modal
+        title="添加知识文档"
+        open={docModalOpen}
+        onCancel={() => setDocModalOpen(false)}
+        confirmLoading={docSaving}
+        onOk={async () => {
+          if (!drawerKb) return;
+          const values = await docForm.validateFields();
+          setDocSaving(true);
+          try {
+            await request(`/admin/knowledge-bases/${drawerKb.id}/documents`, {
+              method: 'POST',
+              body: JSON.stringify({
+                title: values.title,
+                contentText: values.contentText || null,
+              }),
+            });
+            message.success('已添加');
+            setDocModalOpen(false);
+            void loadDocs(drawerKb);
+            reload();
+          } catch (e) {
+            message.error(e instanceof Error ? e.message : String(e));
+          } finally {
+            setDocSaving(false);
+          }
+        }}
+        destroyOnClose
+        width={640}
+      >
+        <Form form={docForm} layout="vertical">
+          <Form.Item name="title" label="标题" rules={[{ required: true }]}>
+            <Input />
+          </Form.Item>
+          <Form.Item name="contentText" label="正文（可粘贴）">
+            <Input.TextArea rows={8} placeholder="支持 Markdown / 纯文本" />
+          </Form.Item>
+          <Form.Item label="或上传文本文件">
+            <Upload
+              accept=".txt,.md,.markdown,.csv,.json,.log,text/*"
+              maxCount={1}
+              customRequest={async ({ file, onSuccess, onError }) => {
+                if (!drawerKb) return;
+                try {
+                  const raw = file as File;
+                  const uploaded = await uploadFileToOss(raw, {
+                    bizType: 'KB_DOCUMENT',
+                    mediaType: 'FILE',
+                  });
+                  const title =
+                    docForm.getFieldValue('title') || raw.name.replace(/\.[^.]+$/, '');
+                  await request(`/admin/knowledge-bases/${drawerKb.id}/documents`, {
+                    method: 'POST',
+                    body: JSON.stringify({
+                      title,
+                      fileName: raw.name,
+                      fileUrl: uploaded.url,
+                      mimeType: raw.type || null,
+                      sizeBytes: raw.size,
+                    }),
+                  });
+                  message.success('上传成功');
+                  setDocModalOpen(false);
+                  void loadDocs(drawerKb);
+                  reload();
+                  onSuccess?.(uploaded);
+                } catch (e) {
+                  const err = e instanceof Error ? e : new Error(String(e));
+                  message.error(err.message);
+                  onError?.(err);
+                }
+              }}
+              showUploadList={false}
+            >
+              <Button icon={<UploadOutlined />}>上传到 OSS 并入库</Button>
+            </Upload>
+          </Form.Item>
+        </Form>
+      </Modal>
+    </div>
+  );
+}

apps/admin-web/src/pages/LlmConfigsPage.tsx

@@ -0,0 +1,380 @@
+import { useEffect, useState } from 'react';
+import {
+  Button,
+  Form,
+  Input,
+  InputNumber,
+  Modal,
+  Popconfirm,
+  Select,
+  Space,
+  Switch,
+  Table,
+  Tag,
+  Typography,
+  message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  LLM_PROVIDERS,
+  LLM_PROVIDER_LABELS,
+  LLM_PROVIDER_PRESETS,
+  type LlmApiConfigDto,
+  type LlmProvider,
+} from '@dukang/shared-types';
+import { request } from '../lib/api';
+import { fmtTime } from '../lib/constants';
+import { useAdminList } from '../lib/useAdminList';
+
+type FormValues = {
+  name: string;
+  provider: LlmProvider;
+  baseUrl?: string;
+  apiKey?: string;
+  modelName?: string;
+  temperature?: number | null;
+  maxTokens?: number | null;
+  systemPrompt?: string;
+  enabled: boolean;
+};
+
+export default function LlmConfigsPage() {
+  const [filterForm] = Form.useForm();
+  const [form] = Form.useForm<FormValues>();
+  const [filters, setFilters] = useState<Record<string, string>>({});
+  const [modalOpen, setModalOpen] = useState(false);
+  const [editing, setEditing] = useState<LlmApiConfigDto | null>(null);
+  const [saving, setSaving] = useState(false);
+  const providerWatch = Form.useWatch('provider', form);
+
+  const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<LlmApiConfigDto>(
+    '/admin/llm-configs',
+    () => {
+      const qs = new URLSearchParams();
+      if (filters.name) qs.set('name', filters.name);
+      if (filters.enabled) qs.set('enabled', filters.enabled);
+      return qs;
+    },
+    [filters],
+  );
+
+  useEffect(() => {
+    if (!providerWatch || editing) return;
+    const preset = LLM_PROVIDER_PRESETS[providerWatch as LlmProvider];
+    if (!preset) return;
+    form.setFieldsValue({
+      baseUrl: preset.defaultBaseUrl || undefined,
+      modelName: preset.defaultModel || undefined,
+    });
+  }, [providerWatch, editing, form]);
+
+  const openCreate = () => {
+    setEditing(null);
+    form.setFieldsValue({
+      name: '',
+      provider: 'DEEPSEEK',
+      baseUrl: LLM_PROVIDER_PRESETS.DEEPSEEK.defaultBaseUrl,
+      apiKey: '',
+      modelName: LLM_PROVIDER_PRESETS.DEEPSEEK.defaultModel,
+      temperature: 0.3,
+      maxTokens: 1024,
+      systemPrompt: '',
+      enabled: true,
+    });
+    setModalOpen(true);
+  };
+
+  const openEdit = (row: LlmApiConfigDto) => {
+    setEditing(row);
+    form.setFieldsValue({
+      name: row.name,
+      provider: row.provider,
+      baseUrl: row.baseUrl,
+      apiKey: '',
+      modelName: row.modelName,
+      temperature: row.temperature,
+      maxTokens: row.maxTokens,
+      systemPrompt: row.systemPrompt || '',
+      enabled: row.enabled,
+    });
+    setModalOpen(true);
+  };
+
+  const onSave = async () => {
+    const values = await form.validateFields();
+    setSaving(true);
+    try {
+      if (editing) {
+        if (!editing.canEditFull) {
+          await request(`/admin/llm-configs/${editing.id}`, {
+            method: 'PUT',
+            body: JSON.stringify({ enabled: values.enabled }),
+          });
+        } else {
+          await request(`/admin/llm-configs/${editing.id}`, {
+            method: 'PUT',
+            body: JSON.stringify({
+              name: values.name,
+              provider: values.provider,
+              baseUrl: values.baseUrl,
+              apiKey: values.apiKey || undefined,
+              modelName: values.modelName,
+              temperature: values.temperature ?? null,
+              maxTokens: values.maxTokens ?? null,
+              systemPrompt: values.systemPrompt || null,
+              enabled: values.enabled,
+            }),
+          });
+        }
+        message.success('已保存');
+      } else {
+        await request('/admin/llm-configs', {
+          method: 'POST',
+          body: JSON.stringify({
+            name: values.name,
+            provider: values.provider,
+            baseUrl: values.baseUrl,
+            apiKey: values.apiKey,
+            modelName: values.modelName,
+            temperature: values.temperature ?? null,
+            maxTokens: values.maxTokens ?? null,
+            systemPrompt: values.systemPrompt || null,
+            enabled: values.enabled,
+          }),
+        });
+        message.success('已创建');
+      }
+      setModalOpen(false);
+      reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : String(e));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  const columns: ColumnsType<LlmApiConfigDto> = [
+    { title: '名称', dataIndex: 'name' },
+    {
+      title: '提供商',
+      dataIndex: 'provider',
+      width: 120,
+      render: (p: LlmProvider) => LLM_PROVIDER_LABELS[p] || p,
+    },
+    { title: '模型', dataIndex: 'modelName', ellipsis: true },
+    {
+      title: 'Key',
+      dataIndex: 'apiKeyConfigured',
+      width: 80,
+      render: (v: boolean) => (v ? <Tag color="green">已配</Tag> : <Tag>无</Tag>),
+    },
+    {
+      title: '生效',
+      dataIndex: 'enabled',
+      width: 90,
+      render: (v: boolean, row) => (
+        <Switch
+          checked={v}
+          disabled={!row.isOwner && !row.canEditFull}
+          onChange={async (checked) => {
+            try {
+              await request(`/admin/llm-configs/${row.id}`, {
+                method: 'PUT',
+                body: JSON.stringify({ enabled: checked }),
+              });
+              message.success(checked ? '已启用' : '已停用');
+              reload();
+            } catch (e) {
+              message.error(e instanceof Error ? e.message : String(e));
+            }
+          }}
+        />
+      ),
+    },
+    {
+      title: '创建人',
+      dataIndex: 'createdByName',
+      width: 100,
+      render: (v: string | null, row) => v || row.createdByHqAccountId,
+    },
+    {
+      title: '更新时间',
+      dataIndex: 'updatedAt',
+      width: 170,
+      render: (t: string) => fmtTime(t),
+    },
+    {
+      title: '操作',
+      width: 220,
+      render: (_, row) => (
+        <Space>
+          <Button
+            type="link"
+            size="small"
+            onClick={() => openEdit(row)}
+          >
+            {row.canEditFull ? '编辑' : '开关'}
+          </Button>
+          <Button
+            type="link"
+            size="small"
+            onClick={async () => {
+              try {
+                const res = await request<{ reply: string }>(`/admin/llm-configs/${row.id}/test`, {
+                  method: 'POST',
+                  body: '{}',
+                });
+                message.success(res.reply || '测试成功');
+              } catch (e) {
+                message.error(e instanceof Error ? e.message : String(e));
+              }
+            }}
+          >
+            测试
+          </Button>
+          {row.canEditFull ? (
+            <Popconfirm
+              title="确认删除？"
+              onConfirm={async () => {
+                try {
+                  await request(`/admin/llm-configs/${row.id}`, { method: 'DELETE' });
+                  message.success('已删除');
+                  reload();
+                } catch (e) {
+                  message.error(e instanceof Error ? e.message : String(e));
+                }
+              }}
+            >
+              <Button type="link" size="small" danger>
+                删除
+              </Button>
+            </Popconfirm>
+          ) : null}
+        </Space>
+      ),
+    },
+  ];
+
+  const fullEdit = !editing || editing.canEditFull;
+
+  return (
+    <div>
+      <Space style={{ marginBottom: 16 }} wrap>
+        <Typography.Title level={4} style={{ margin: 0 }}>
+          语言模型配置
+        </Typography.Title>
+        <Typography.Text type="secondary">
+          非超管仅可见自己创建的配置，且创建后只能改是否生效
+        </Typography.Text>
+      </Space>
+
+      <Form
+        form={filterForm}
+        layout="inline"
+        style={{ marginBottom: 16 }}
+        onFinish={(v) =>
+          setFilters({
+            name: v.name || '',
+            enabled: v.enabled === undefined || v.enabled === null ? '' : String(v.enabled),
+          })
+        }
+      >
+        <Form.Item name="name" label="名称">
+          <Input allowClear placeholder="搜索" />
+        </Form.Item>
+        <Form.Item name="enabled" label="生效">
+          <Select
+            allowClear
+            style={{ width: 100 }}
+            options={[
+              { value: true, label: '开' },
+              { value: false, label: '关' },
+            ]}
+          />
+        </Form.Item>
+        <Form.Item>
+          <Button type="primary" htmlType="submit">
+            查询
+          </Button>
+        </Form.Item>
+        <Form.Item>
+          <Button type="primary" onClick={openCreate}>
+            新建配置
+          </Button>
+        </Form.Item>
+      </Form>
+
+      <Table
+        rowKey="id"
+        loading={loading}
+        columns={columns}
+        dataSource={data?.items}
+        pagination={{
+          current: page,
+          pageSize,
+          total: data?.total,
+          showSizeChanger: true,
+          onChange: (p, ps) => {
+            setPage(p);
+            setPageSize(ps);
+          },
+        }}
+      />
+
+      <Modal
+        title={editing ? (fullEdit ? '编辑语言模型' : '修改是否生效') : '新建语言模型'}
+        open={modalOpen}
+        onCancel={() => setModalOpen(false)}
+        onOk={() => void onSave()}
+        confirmLoading={saving}
+        destroyOnClose
+        width={640}
+      >
+        <Form form={form} layout="vertical">
+          <Form.Item name="name" label="名称" rules={[{ required: true, message: '必填' }]}>
+            <Input disabled={!fullEdit} />
+          </Form.Item>
+          <Form.Item name="provider" label="提供商" rules={[{ required: true }]}>
+            <Select
+              disabled={!fullEdit}
+              options={LLM_PROVIDERS.map((p) => ({ value: p, label: LLM_PROVIDER_LABELS[p] }))}
+            />
+          </Form.Item>
+          <Form.Item
+            name="baseUrl"
+            label="Base URL"
+            rules={[{ required: fullEdit, message: '必填' }]}
+            extra="填主机根地址即可，如 https://api.deepseek.com（不要带 /v1）"
+          >
+            <Input disabled={!fullEdit} placeholder="https://api.deepseek.com" />
+          </Form.Item>
+          <Form.Item
+            name="apiKey"
+            label="API Key"
+            rules={editing ? [] : [{ required: true, message: '必填' }]}
+            extra={editing ? '留空表示不修改' : undefined}
+          >
+            <Input.Password disabled={!fullEdit} />
+          </Form.Item>
+          <Form.Item name="modelName" label="模型名" rules={[{ required: fullEdit, message: '必填' }]}>
+            <Input disabled={!fullEdit} />
+          </Form.Item>
+          <Space style={{ display: 'flex' }} size="large">
+            <Form.Item name="temperature" label="Temperature">
+              <InputNumber disabled={!fullEdit} min={0} max={2} step={0.1} style={{ width: 120 }} />
+            </Form.Item>
+            <Form.Item name="maxTokens" label="Max Tokens">
+              <InputNumber disabled={!fullEdit} min={1} max={128000} style={{ width: 140 }} />
+            </Form.Item>
+          </Space>
+          <Form.Item name="systemPrompt" label="系统提示词">
+            <Input.TextArea disabled={!fullEdit} rows={3} />
+          </Form.Item>
+          <Form.Item name="enabled" label="生效" valuePropName="checked">
+            <Switch />
+          </Form.Item>
+        </Form>
+      </Modal>
+    </div>
+  );
+}

apps/admin-web/src/pages/WecomBotsPage.tsx

@@ -25,6 +25,8 @@ import {
   WECOM_BOT_ROLE_DEFAULT_PERMISSIONS,
   WECOM_BOT_ROLE_LABELS,
   WECOM_BOT_ROLES,
+  type LlmApiConfigOptionDto,
+  type KnowledgeBaseOptionDto,
   type WecomBotDto,
   type WecomBotPermission,
   type WecomBotRole,
@@ -53,6 +55,9 @@ type FormValues = {
   avatarUrl?: string;
   welcome?: string;
   permissions: WecomBotPermission[];
+  aiEnabled: boolean;
+  llmConfigId?: string | null;
+  knowledgeBaseId?: string | null;
   enabled: boolean;
   sortOrder: number;
 };
@@ -66,6 +71,8 @@ export default function WecomBotsPage() {
   const [saving, setSaving] = useState(false);
   const [detail, setDetail] = useState<WecomBotDto | null>(null);
   const [runtime, setRuntime] = useState<ListRes['runtime']>();
+  const [llmOptions, setLlmOptions] = useState<LlmApiConfigOptionDto[]>([]);
+  const [kbOptions, setKbOptions] = useState<KnowledgeBaseOptionDto[]>([]);
   const roleWatch = Form.useWatch('role', form);
 
   const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<WecomBotDto>(
@@ -87,6 +94,21 @@ export default function WecomBotsPage() {
       .catch(() => {});
   }, [data]);
 
+  useEffect(() => {
+    void request<{
+      llmConfigs: LlmApiConfigOptionDto[];
+      knowledgeBases: KnowledgeBaseOptionDto[];
+    }>('/admin/wecom-bots/ai-options')
+      .then((res) => {
+        setLlmOptions(res.llmConfigs);
+        setKbOptions(res.knowledgeBases);
+      })
+      .catch(() => {
+        setLlmOptions([]);
+        setKbOptions([]);
+      });
+  }, []);
+
   function openCreate() {
     setEditing(null);
     form.setFieldsValue({
@@ -97,6 +119,9 @@ export default function WecomBotsPage() {
       avatarUrl: '',
       welcome: '',
       permissions: [...WECOM_BOT_ROLE_DEFAULT_PERMISSIONS.CUSTOMER_SERVICE],
+      aiEnabled: false,
+      llmConfigId: null,
+      knowledgeBaseId: null,
       enabled: true,
       sortOrder: 0,
     });
@@ -113,6 +138,9 @@ export default function WecomBotsPage() {
       avatarUrl: row.avatarUrl || '',
       welcome: row.welcome || '',
       permissions: row.permissions,
+      aiEnabled: row.aiEnabled,
+      llmConfigId: row.llmConfigId,
+      knowledgeBaseId: row.knowledgeBaseId,
       enabled: row.enabled,
       sortOrder: row.sortOrder,
     });
@@ -123,19 +151,25 @@ export default function WecomBotsPage() {
     const values = await form.validateFields();
     setSaving(true);
     try {
+      const payload = {
+        name: values.name.trim(),
+        role: values.role,
+        botId: values.botId.trim(),
+        avatarUrl: values.avatarUrl?.trim() || null,
+        welcome: values.welcome?.trim() || null,
+        permissions: values.permissions,
+        aiEnabled: values.aiEnabled,
+        llmConfigId: values.llmConfigId || null,
+        knowledgeBaseId: values.knowledgeBaseId || null,
+        enabled: values.enabled,
+        sortOrder: values.sortOrder,
+      };
       if (editing) {
         await request(`/admin/wecom-bots/${editing.id}`, {
           method: 'PUT',
           body: JSON.stringify({
-            name: values.name.trim(),
-            role: values.role,
-            botId: values.botId.trim(),
+            ...payload,
             secret: values.secret?.trim() || undefined,
-            avatarUrl: values.avatarUrl?.trim() || null,
-            welcome: values.welcome?.trim() || null,
-            permissions: values.permissions,
-            enabled: values.enabled,
-            sortOrder: values.sortOrder,
           }),
         });
         message.success('已更新');
@@ -147,15 +181,8 @@ export default function WecomBotsPage() {
         await request('/admin/wecom-bots', {
           method: 'POST',
           body: JSON.stringify({
-            name: values.name.trim(),
-            role: values.role,
-            botId: values.botId.trim(),
+            ...payload,
             secret: values.secret.trim(),
-            avatarUrl: values.avatarUrl?.trim() || null,
-            welcome: values.welcome?.trim() || null,
-            permissions: values.permissions,
-            enabled: values.enabled,
-            sortOrder: values.sortOrder,
           }),
         });
         message.success('已创建');
@@ -225,6 +252,16 @@ export default function WecomBotsPage() {
           </Tag>
         )),
     },
+    {
+      title: 'AI',
+      width: 100,
+      render: (_, row) =>
+        row.aiEnabled ? (
+          <Tag color="blue">{row.llmConfigName || '已开'}</Tag>
+        ) : (
+          <Tag>关</Tag>
+        ),
+    },
     {
       title: '启用',
       dataIndex: 'enabled',
@@ -401,6 +438,34 @@ export default function WecomBotsPage() {
           <Form.Item name="welcome" label="欢迎语">
             <Input.TextArea rows={3} placeholder="进入会话时的欢迎语，可空" />
           </Form.Item>
+          <Form.Item
+            name="aiEnabled"
+            label="启用 AI 问答"
+            valuePropName="checked"
+            extra="开启后，未匹配指令的自然语言将调用绑定的语言模型（可挂知识库）"
+          >
+            <Switch />
+          </Form.Item>
+          <Form.Item name="llmConfigId" label="语言模型">
+            <Select
+              allowClear
+              placeholder="选择已生效的配置"
+              options={llmOptions.map((o) => ({
+                value: o.id,
+                label: `${o.name}（${o.modelName}）`,
+              }))}
+            />
+          </Form.Item>
+          <Form.Item name="knowledgeBaseId" label="知识库">
+            <Select
+              allowClear
+              placeholder="可选，供 AI 检索"
+              options={kbOptions.map((o) => ({
+                value: o.id,
+                label: `${o.name}（${o.documentCount} 篇）`,
+              }))}
+            />
+          </Form.Item>
           <Space size="large">
             <Form.Item name="enabled" label="启用" valuePropName="checked">
               <Switch />
@@ -432,6 +497,9 @@ export default function WecomBotsPage() {
               {detail.permissions.map((p) => WECOM_BOT_PERMISSION_LABELS[p] || p).join('、')}
             </Descriptions.Item>
             <Descriptions.Item label="欢迎语">{detail.welcome || '—'}</Descriptions.Item>
+            <Descriptions.Item label="AI 问答">{detail.aiEnabled ? '开' : '关'}</Descriptions.Item>
+            <Descriptions.Item label="语言模型">{detail.llmConfigName || '—'}</Descriptions.Item>
+            <Descriptions.Item label="知识库">{detail.knowledgeBaseName || '—'}</Descriptions.Item>
             <Descriptions.Item label="启用">{detail.enabled ? '是' : '否'}</Descriptions.Item>
             <Descriptions.Item label="排序">{detail.sortOrder}</Descriptions.Item>
             <Descriptions.Item label="创建">{fmtTime(detail.createdAt)}</Descriptions.Item>