@gientech/modual 2.2.3-fix.5 → 2.2.3-fix.6

package/src/modules/knowledgebaseDetails/modules/RetrievalTestModule.tsx

@@ -0,0 +1,49 @@
+import React from 'react';
+import styled from 'styled-components';
+import { defaultTheme } from '@mxmweb/zui';
+import type { KnowledgeBaseDetailsModuleRenderProps } from './types';
+
+/**
+ * 模块：检索测试
+ * - 顶部 Tab：检索测试
+ * - 内容：仅搭建模块框架（后续按需求完善，不预设 table 形态）
+ */
+export const RetrievalTestModule: React.FC<KnowledgeBaseDetailsModuleRenderProps> = ({
+  styles,
+}) => {
+  const theme = styles?.theme || defaultTheme;
+  return (
+    <ModuleWrapper theme={theme}>
+      <ModuleTitle theme={theme}>检索测试</ModuleTitle>
+      <ModuleDesc theme={theme}>模块框架已搭建，后续接入检索参数、召回结果预览、对比评估等能力。</ModuleDesc>
+    </ModuleWrapper>
+  );
+};
+
+const ModuleWrapper = styled.div.attrs({
+  className: 'knowledgebase-details-module-retrieval-test',
+})<{ theme: any }>`
+  width: 100%;
+  background: ${({ theme }) => theme.colors?.dashboardBackground || theme.colors?.background || '#fff'};
+  border: 1px solid ${({ theme }) => theme.colors?.border || '#E5E6EB'};
+  border-radius: ${({ theme }) => theme.space?.radius || '8px'};
+  padding: 16px;
+`;
+
+const ModuleTitle = styled.div.attrs({
+  className: 'knowledgebase-details-module-retrieval-test-title',
+})<{ theme: any }>`
+  font-size: 14px;
+  font-weight: 600;
+  color: ${({ theme }) => theme.colors?.text || '#1D2129'};
+  margin-bottom: 8px;
+`;
+
+const ModuleDesc = styled.div.attrs({
+  className: 'knowledgebase-details-module-retrieval-test-desc',
+})<{ theme: any }>`
+  font-size: 13px;
+  color: ${({ theme }) => theme.colors?.textSecondary || '#4E5969'};
+  line-height: 1.6;
+`;
+

package/src/modules/knowledgebaseDetails/modules/UploadManagementModule.tsx

@@ -0,0 +1,49 @@
+import React from 'react';
+import styled from 'styled-components';
+import { defaultTheme } from '@mxmweb/zui';
+import type { KnowledgeBaseDetailsModuleRenderProps } from './types';
+
+/**
+ * 模块：上传文件管理
+ * - 顶部 Tab：上传文件管理
+ * - 内容：仅搭建模块框架（后续按需求完善，不预设 table 形态）
+ */
+export const UploadManagementModule: React.FC<KnowledgeBaseDetailsModuleRenderProps> = ({
+  styles,
+}) => {
+  const theme = styles?.theme || defaultTheme;
+  return (
+    <ModuleWrapper theme={theme}>
+      <ModuleTitle theme={theme}>上传文件管理</ModuleTitle>
+      <ModuleDesc theme={theme}>模块框架已搭建，后续根据需求接入上传/目录/权限等能力。</ModuleDesc>
+    </ModuleWrapper>
+  );
+};
+
+const ModuleWrapper = styled.div.attrs({
+  className: 'knowledgebase-details-module-upload-management',
+})<{ theme: any }>`
+  width: 100%;
+  background: ${({ theme }) => theme.colors?.dashboardBackground || theme.colors?.background || '#fff'};
+  border: 1px solid ${({ theme }) => theme.colors?.border || '#E5E6EB'};
+  border-radius: ${({ theme }) => theme.space?.radius || '8px'};
+  padding: 16px;
+`;
+
+const ModuleTitle = styled.div.attrs({
+  className: 'knowledgebase-details-module-upload-management-title',
+})<{ theme: any }>`
+  font-size: 14px;
+  font-weight: 600;
+  color: ${({ theme }) => theme.colors?.text || '#1D2129'};
+  margin-bottom: 8px;
+`;
+
+const ModuleDesc = styled.div.attrs({
+  className: 'knowledgebase-details-module-upload-management-desc',
+})<{ theme: any }>`
+  font-size: 13px;
+  color: ${({ theme }) => theme.colors?.textSecondary || '#4E5969'};
+  line-height: 1.6;
+`;
+

package/src/modules/knowledgebaseDetails/modules/types.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import type { Styles } from '@mxmweb/zui';
+import type { CustomComponents } from '@mxmweb/xviewer';
+import type { KnowledgeBaseDetailsServer } from '../servers';
+
+export type KnowledgeBaseDetailsModuleKey =
+  | 'knowledge-parse'
+  | 'faq'
+  | 'upload-management'
+  | 'config'
+  | 'retrieval-test';
+
+export interface KnowledgeBaseDetailsModulesConfigItem {
+  /** 是否隐藏该模块（隐藏后不会出现在顶部 Tab，也无法被选中） */
+  hidden?: boolean;
+  /** 覆盖该模块在 Tab 上的显示文案 */
+  label?: string;
+}
+
+export type KnowledgeBaseDetailsModulesConfig = Partial<Record<KnowledgeBaseDetailsModuleKey, KnowledgeBaseDetailsModulesConfigItem>>;
+
+export interface KnowledgeBaseDetailsModuleRenderProps {
+  /** 业务侧传入的知识库 ID（用于列表等接口请求） */
+  kbId?: string | number;
+  /** XViewer ref（如需调用核心方法） */
+  coreRef: React.RefObject<any>;
+  /** XViewer 外部状态 */
+  appStatus: any;
+  /** 合并后的主题 */
+  styles: Styles;
+  /** 业务网络层（可选，由示例或上层注入） */
+  server?: KnowledgeBaseDetailsServer;
+  /** 事件透传 */
+  eventsEmit: (name: string, data: any, appFn: any) => void;
+  /** XViewer 自定义组件 */
+  CustomComponents?: CustomComponents;
+  /** 表格示例数据 */
+  tableData: any[];
+  /** 内部 tabs 的 activeId（仅部分模块需要） */
+  activeId: string;
+  /** 设置内部 tabs 的 activeId（仅部分模块需要） */
+  setActiveId: (id: string) => void;
+}
+

package/src/modules/knowledgebaseDetails/modules-shim.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 本文件用于修复部分编辑器/诊断环境下的 TS 模块解析误报：
+ * - 现象：对同目录下的 TSX 相对路径 import 误报 “Cannot find module ... or its corresponding type declarations.”
+ * - 目的：为这些相对路径提供稳定的类型声明兜底（不会影响运行时打包解析）
+ *
+ * 2026-01-28: 增加 KnowledgeBaseDetails 本模块的 TSX 导入声明兜底
+ */
+
+declare module './modules/KnowledgeParseModule' {
+  import type React from 'react';
+  import type { KnowledgeBaseDetailsModuleRenderProps } from './modules/types';
+  export const KnowledgeParseModule: React.FC<KnowledgeBaseDetailsModuleRenderProps>;
+}
+

package/src/modules/knowledgebaseDetails/servers/analysis.ts

@@ -0,0 +1,5 @@
+// 知识解析->文件管理列表接口  /proxy/index/knowledgeBase/file/folder/list?pageSize=10&pageNo=1&fileListType=1&kbId=4790&fuzzy=
+
+// 知识解析-> 版本管理列表接口 /proxy/index/knowledgeBase/file/list?pageSize=10&pageNo=1&fileListType=1&kbId=4790&fuzzy=&showType=1
+
+// 知识解析-> 知识图谱列表接口 /proxy/index/knowledgeBase/file/graph/list?pageSize=10&pageNo=3&fileListType=1&kbId=4790&fuzzy=

package/src/modules/knowledgebaseDetails/servers/index.ts

@@ -0,0 +1,318 @@
+import axios, { type AxiosInstance, type AxiosRequestConfig, type AxiosResponse, type Method } from 'axios';
+
+export type KnowledgeBaseDetailsRequestKey = string;
+
+export type KnowledgeBaseId = string | number;
+
+export interface KnowledgeBaseDetailsServerConfig {
+  /** API baseURL（例如：https://api.example.com） */
+  baseURL: string;
+  /**
+   * 可选：路径前缀（例如：'/proxy'）
+   *
+   * 说明：
+   * - 你们的 proxy 前缀由外部决定，因此业务接口里不要写死 '/proxy'
+   * - 这里通过 pathPrefix 统一注入，默认不注入（空字符串）
+   *
+   * 示例：
+   * - 本地开发：pathPrefix = '/proxy'（走 Vite dev server proxy）
+   * - 平台环境：pathPrefix = ''（直接请求 /index/...）
+   */
+  pathPrefix?: string;
+  /** token（默认以 Authorization: Bearer ${token} 形式注入，可被 headers 覆盖） */
+  token?: string;
+  /** 全局附加 headers（每个请求都会带上，可被 per-request 覆盖） */
+  customHeaders?: Record<string, string>;
+  /**
+   * 指定某类请求的专用 headers（用于“对某个请求”单独配置）
+   * - key 由业务层定义，比如：'kb_list_files' / 'kb_parse_doc' 等
+   */
+  requestHeaders?: Record<KnowledgeBaseDetailsRequestKey, Record<string, string>>;
+  /** 自定义 token 注入方式（默认 Bearer） */
+  buildAuthHeaders?: (token: string) => Record<string, string>;
+}
+
+export interface KnowledgeBaseDetailsRequestOptions {
+  /** 可选：用于匹配 requestHeaders[key] */
+  key?: KnowledgeBaseDetailsRequestKey;
+  /** 请求方法 */
+  method: Method;
+  /** 路径或完整 URL（建议传 path，例如：/api/knowledgebase/list） */
+  url: string;
+  /** 可选：仅本次请求注入路径前缀（例如：'/proxy'） */
+  pathPrefix?: string;
+  /** query 参数 */
+  params?: any;
+  /** body 数据 */
+  data?: any;
+  /** 本次请求专用 headers（最高优先级） */
+  headers?: Record<string, string>;
+  /** 覆盖 baseURL（仅本次请求） */
+  baseURL?: string;
+  /** 覆盖 token（仅本次请求） */
+  token?: string;
+  /** 覆盖/追加全局 headers（仅本次请求） */
+  customHeaders?: Record<string, string>;
+  /** 超时（毫秒） */
+  timeoutMs?: number;
+  /** AbortController signal */
+  signal?: AbortSignal;
+  /**
+   * 若需要拿到完整 AxiosResponse，可以设置为 true
+   * - 默认只返回 response.data
+   */
+  returnRawResponse?: boolean;
+  /** 额外透传 axios config（谨慎使用） */
+  axiosConfig?: Omit<AxiosRequestConfig, 'method' | 'url' | 'params' | 'data' | 'headers' | 'baseURL' | 'timeout' | 'signal'>;
+}
+
+export interface KnowledgeBaseDetailsServer {
+  /** axios 实例（有需要时可直接用，但推荐用 request） */
+  instance: AxiosInstance;
+  /**
+   * 统一请求入口
+   * - 默认返回 response.data
+   * - returnRawResponse=true 时返回 AxiosResponse
+   */
+  request<T = unknown>(options: KnowledgeBaseDetailsRequestOptions): Promise<T>;
+}
+
+/**
+ * 创建 KnowledgeBaseDetails 业务模块的基础网络层 client
+ *
+ * 功能：
+ * - 支持用户配置 baseURL / token / customHeaders
+ * - 支持按 key 配置“某个请求”的专用 headers（requestHeaders）
+ * - 支持每次请求覆盖 baseURL / token / headers / customHeaders
+ *
+ * 2026-01-27: 初始化网络层骨架（支持全局/按请求/单次覆盖 headers）
+ */
+export function createKnowledgeBaseDetailsServer(config: KnowledgeBaseDetailsServerConfig): KnowledgeBaseDetailsServer {
+  const buildAuthHeaders = config.buildAuthHeaders || ((token: string) => ({ Authorization: `Bearer ${token}` }));
+
+  const instance = axios.create({
+    baseURL: config.baseURL,
+  });
+
+  const normalizePrefix = (prefix?: string) => {
+    const p = (prefix || '').trim();
+    if (!p) return '';
+    return p.startsWith('/') ? p : `/${p}`;
+  };
+
+  const attachPrefixIfNeeded = (url: string, prefix?: string) => {
+    const p = normalizePrefix(prefix);
+    if (!p) return url;
+    // 绝对 URL 不处理
+    if (/^https?:\/\//i.test(url)) return url;
+    // 仅对以 / 开头的“同源路径”追加前缀
+    if (!url.startsWith('/')) return url;
+    // 已经带前缀则不重复追加
+    if (url === p || url.startsWith(`${p}/`)) return url;
+    return `${p}${url}`;
+  };
+
+  const request: KnowledgeBaseDetailsServer['request'] = async (options) => {
+    const baseURL = options.baseURL || config.baseURL;
+    const token = options.token ?? config.token;
+
+    const globalHeaders = config.customHeaders || {};
+    const scopedHeaders = (options.key && config.requestHeaders?.[options.key]) || {};
+    const perRequestGlobalHeaders = options.customHeaders || {};
+
+    const authHeaders =
+      token && typeof token === 'string' && token.trim().length > 0 ? buildAuthHeaders(token) : {};
+
+    // headers 合并优先级（后者覆盖前者）：
+    // 全局 customHeaders -> key 专用 -> 本次 customHeaders -> authHeaders -> 本次 headers
+    const headers: Record<string, string> = {
+      ...globalHeaders,
+      ...scopedHeaders,
+      ...perRequestGlobalHeaders,
+      ...authHeaders,
+      ...(options.headers || {}),
+    };
+
+    const axiosReq: AxiosRequestConfig = {
+      method: options.method,
+      url: attachPrefixIfNeeded(options.url, options.pathPrefix ?? config.pathPrefix),
+      baseURL,
+      params: options.params,
+      data: options.data,
+      headers,
+      timeout: options.timeoutMs,
+      signal: options.signal,
+      ...(options.axiosConfig || {}),
+    };
+
+    const resp: AxiosResponse = await instance.request(axiosReq);
+    if (options.returnRawResponse) return resp as any;
+    return resp.data as any;
+  };
+
+  return { instance, request };
+}
+
+// =========================
+// KnowledgeParse（知识解析）相关 API
+// =========================
+
+export const KB_API_KEYS = {
+  /** 知识解析：文件管理（含文件夹）列表 */
+  knowledge_parse_file_folder_list: 'knowledge_parse_file_folder_list',
+  /** 知识解析：版本管理列表 */
+  knowledge_parse_version_list: 'knowledge_parse_version_list',
+  /** 知识解析：知识图谱列表 */
+  knowledge_parse_graph_list: 'knowledge_parse_graph_list',
+} as const;
+
+export interface KnowledgeParseListBaseParams {
+  kbId: KnowledgeBaseId;
+  pageNo: number;
+  pageSize: number;
+  /** 默认 1（后端约定） */
+  fileListType?: number;
+  /** 模糊搜索关键字 */
+  fuzzy?: string;
+  /** AbortController signal（可选） */
+  signal?: AbortSignal;
+}
+
+export interface KnowledgeParseVersionListParams extends KnowledgeParseListBaseParams {
+  /** 默认 1（后端约定） */
+  showType?: number;
+}
+
+export interface KnowledgeParsePagedResult<T = any> {
+  list: T[];
+  total: number;
+  pageNo: number;
+  pageSize: number;
+  raw: any;
+}
+
+/**
+ * 将后端返回的分页结构做“宽松归一化”
+ *
+ * 兼容常见字段：
+ * - list / records / rows / items / data
+ * - total / count / totalCount
+ *
+ * 2026-01-28: 初始化知识解析列表接口的数据归一化
+ */
+export function normalizePagedResult<T = any>(
+  resp: any,
+  pageNo: number,
+  pageSize: number
+): KnowledgeParsePagedResult<T> {
+  const root = resp?.data ?? resp?.result ?? resp;
+  const data = root?.data ?? root;
+
+  const listCandidate =
+    data?.list ??
+    data?.records ??
+    data?.rows ??
+    data?.items ??
+    data?.data ??
+    data?.result ??
+    [];
+  const list: T[] = Array.isArray(listCandidate) ? listCandidate : [];
+
+  const totalCandidate = data?.total ?? data?.count ?? data?.totalCount ?? data?.pagination?.total;
+  const total =
+    typeof totalCandidate === 'number'
+      ? totalCandidate
+      : typeof totalCandidate === 'string'
+        ? Number(totalCandidate) || list.length
+        : list.length;
+
+  return { list, total, pageNo, pageSize, raw: resp };
+}
+
+/**
+ * 知识解析 -> 文件管理（含文件夹）列表
+ * GET `/index/knowledgeBase/file/folder/list`
+ *
+ * query:
+ * - pageSize
+ * - pageNo
+ * - fileListType（默认 1）
+ * - kbId
+ * - fuzzy（可选）
+ *
+ * 2026-01-28: 接入知识解析列表（文件管理）接口封装
+ */
+export async function fetchKnowledgeParseFileFolderList<T = any>(
+  server: KnowledgeBaseDetailsServer,
+  params: KnowledgeParseListBaseParams
+): Promise<KnowledgeParsePagedResult<T>> {
+  const { kbId, pageNo, pageSize, fileListType = 1, fuzzy = '', signal } = params;
+  const resp = await server.request<any>({
+    key: KB_API_KEYS.knowledge_parse_file_folder_list,
+    method: 'GET',
+    url: '/index/knowledgeBase/file/folder/list',
+    params: { pageNo, pageSize, fileListType, kbId, fuzzy },
+    signal,
+  });
+  return normalizePagedResult<T>(resp, pageNo, pageSize);
+}
+
+/**
+ * 知识解析 -> 版本管理列表
+ * GET `/index/knowledgeBase/file/list`
+ *
+ * query:
+ * - pageSize
+ * - pageNo
+ * - fileListType（默认 1）
+ * - kbId
+ * - fuzzy（可选）
+ * - showType（默认 1）
+ *
+ * 2026-01-28: 接入知识解析列表（版本管理）接口封装
+ */
+export async function fetchKnowledgeParseVersionList<T = any>(
+  server: KnowledgeBaseDetailsServer,
+  params: KnowledgeParseVersionListParams
+): Promise<KnowledgeParsePagedResult<T>> {
+  const { kbId, pageNo, pageSize, fileListType = 1, fuzzy = '', showType = 1, signal } = params;
+  const resp = await server.request<any>({
+    key: KB_API_KEYS.knowledge_parse_version_list,
+    method: 'GET',
+    url: '/index/knowledgeBase/file/list',
+    params: { pageNo, pageSize, fileListType, kbId, fuzzy, showType },
+    signal,
+  });
+  return normalizePagedResult<T>(resp, pageNo, pageSize);
+}
+
+/**
+ * 知识解析 -> 知识图谱列表
+ * GET `/index/knowledgeBase/file/graph/list`
+ *
+ * query:
+ * - pageSize
+ * - pageNo
+ * - fileListType（默认 1）
+ * - kbId
+ * - fuzzy（可选）
+ *
+ * 2026-01-28: 接入知识解析列表（知识图谱）接口封装
+ */
+export async function fetchKnowledgeParseGraphList<T = any>(
+  server: KnowledgeBaseDetailsServer,
+  params: KnowledgeParseListBaseParams
+): Promise<KnowledgeParsePagedResult<T>> {
+  // 线上图谱增强实际复用文件管理接口，通过 fileListType=3 区分
+  const { kbId, pageNo, pageSize, fileListType = 3, fuzzy = '', signal } = params;
+  const resp = await server.request<any>({
+    key: KB_API_KEYS.knowledge_parse_graph_list,
+    method: 'GET',
+    // 与文件管理一致，区别仅在 fileListType
+    url: '/index/knowledgeBase/file/folder/list',
+    params: { pageNo, pageSize, fileListType, kbId, fuzzy },
+    signal,
+  });
+  return normalizePagedResult<T>(resp, pageNo, pageSize);
+}
+

package/src/modules/login/components/Login/LoginBox/index.tsx

@@ -0,0 +1,105 @@
+import { Loader2, ShoppingCart, User } from 'lucide-react';
+import { Button, Flex, Form, FormInstance, Input, Typography } from 'antd';
+import React, { useState } from 'react';
+import { useLoginI18n } from '../../../i18n';
+
+export enum LoginFormActionEnum {
+  CANCEL = 'cancel',
+  SUBMIT = 'submit',
+  REFRESH = 'refresh',
+  REGISTER = 'register',
+}
+
+interface Iprops {
+  setIsRegister: React.Dispatch<React.SetStateAction<boolean>>;
+  logoImg?: string;
+  eventEmit?: (n: string, d: any) => void;
+  form: FormInstance<any>;
+  codeImgSrc?: string;
+  loginLoading?: boolean;
+}
+
+const LoginBox: React.FC<Iprops> = props => {
+  const { logoImg, setIsRegister, eventEmit, form, codeImgSrc, loginLoading = false } = props;
+  const { messages } = useLoginI18n();
+  const [codeLoading, setCodeLoading] = useState<boolean>(false);
+  const handleLogin = () => {
+    form.validateFields().then(async res => {
+      eventEmit && (await eventEmit('login:login', res));
+    });
+  };
+
+  const handleClickCode = async () => {
+    setCodeLoading(true);
+    eventEmit && (await eventEmit('login:codeClick', ''));
+    setCodeLoading(false);
+  };
+  return (
+    <Flex vertical justify="center">
+      <img
+        style={{
+          display: 'inline-block',
+          width: '100%',
+          objectFit: 'cover',
+          marginTop: '12px',
+          marginBottom: '20px',
+          textAlign: 'center',
+        }}
+        src={logoImg}
+      />
+      <Form.Item name={'userName'} rules={[{ required: true, message: messages.login.usernameRequired }]}>
+        <Input placeholder={messages.login.usernamePlaceholder} prefix={<User size={16} />} />
+      </Form.Item>
+      <Form.Item name={'password'} rules={[{ required: true, message: messages.login.passwordRequired }]}>
+        <Input placeholder={messages.login.passwordPlaceholder} prefix={<ShoppingCart size={16} />} type="password" />
+      </Form.Item>
+      {codeImgSrc && (
+        <Form.Item name={'verifyCode'} rules={[{ required: true, message: messages.login.verifyCodeRequired }]}>
+          <Flex>
+            <Input placeholder={messages.login.verifyCodePlaceholder} />
+
+            {codeLoading ? (
+              <Flex style={{ width: '96px', height: '40px' }} justify="center">
+                <Loader2 className="animate-spin" size={20} />
+              </Flex>
+            ) : (
+              <img
+                onClick={handleClickCode}
+                src={codeImgSrc}
+                style={{
+                  width: '96px',
+                  height: '40px',
+                  background: 'white',
+                  border: 'solid 1px #d9d9d9',
+                  cursor: 'pointer',
+                  borderRadius: '6px',
+                }}
+              />
+            )}
+          </Flex>
+        </Form.Item>
+      )}
+      <Form.Item>
+        <Button
+          style={{ width: '100%' }}
+          type="primary"
+          loading={loginLoading}
+          onClick={handleLogin}
+        >
+          {messages.login.submit}
+        </Button>
+      </Form.Item>
+      {/* <Text
+        style={{
+          textAlign: "right",
+          cursor: "pointer"
+        }}
+        onClick={() => setIsRegister(true)}
+      >
+        点击注册
+      </Text> */}
+    </Flex>
+  );
+};
+
+export default LoginBox;