cx-chat 0.0.1

package/src/router/index.tsx

@@ -0,0 +1,312 @@
+import { Spin } from 'antd'
+import React, { type ReactNode } from 'react'
+import { Navigate, type RouteObject } from 'react-router-dom'
+
+import { useAuth } from '@/contexts/AuthContext'
+import { useMenu } from '@/contexts/MenuContext'
+import type { MenuTreeItem } from '@/types/menu'
+import {
+    registerAdminMenuRoute,
+    resetMenuRouteRegistry,
+} from '@/utils/menuRouteRegistry'
+
+// ---------------------------------------------------------------------------
+// 懒加载页面（按：认证 → 主布局业务 → 全局错误 → 管理端显式入口）
+// ---------------------------------------------------------------------------
+
+// 认证
+const LoginPage = React.lazy(() => import('@/views/auth/login'))
+const RegisterPage = React.lazy(() => import('@/views/auth/register'))
+
+// 主布局内
+const ChatNewPage = React.lazy(() => import('@/views/chat'))
+const ChatSessionPage = React.lazy( () => import('@/views/chat/index-session'))
+const MemoryPage = React.lazy(() => import('@/views/base/memory'))
+const SettingsPage = React.lazy(() => import('@/views/base/settings'))
+
+// 全局错误页
+const Route401Page = React.lazy(() => import('@/views/page-error/401'))
+const Route404Page = React.lazy(() => import('@/views/page-error/404'))
+
+// ---------------------------------------------------------------------------
+// 动态菜单：glob 扫描 views/**/index.tsx，与菜单 component 路径对齐
+// ---------------------------------------------------------------------------
+
+const menuPageModules = import.meta.glob('../views/**/index.tsx')
+const submitPageModules = import.meta.glob('../views/**/submit.tsx')
+const detailPageModules = import.meta.glob('../views/**/detail.tsx')
+
+const componentMap: Record<string, React.ComponentType<any>> = {}
+
+/** 将 glob loader 转为 React.lazy 组件（模块必须 default export 组件）。 */
+function createLazyPageComponent(path: string, loader: () => Promise<unknown>) {
+  return React.lazy(async () => {
+    const mod: any = await loader()
+    const Comp = mod?.default
+    if (!Comp) {
+      if (import.meta.env.DEV) {
+        console.error('[Router] 页面组件缺少 default export:', path, mod)
+      }
+      const Fallback: React.FC = () => (
+        <div style={{ padding: 16 }}>
+          页面加载失败：组件导出异常
+        </div>
+      )
+      return { default: Fallback }
+    }
+    return { default: Comp }
+  })
+}
+
+// 注册 index.tsx
+Object.entries(menuPageModules).forEach(([path, loader]) => {
+  const componentPath = path
+    .replace(/^\.\.\/views/, '')
+    .replace('/index.tsx', '')
+    .replace(/^\//, '')  // 移除前导斜杠
+  const lazyComponent = createLazyPageComponent(path, loader as any)
+  componentMap[componentPath] = lazyComponent
+})
+
+// 注册 submit.tsx
+Object.entries(submitPageModules).forEach(([path, loader]) => {
+  const componentPath = path
+    .replace(/^\.\.\/views/, '')
+    .replace('/submit.tsx', '')
+    .replace(/^\//, '')  // 移除前导斜杠
+  const lazyComponent = createLazyPageComponent(path, loader as any)
+  componentMap[`${componentPath}/submit`] = lazyComponent
+})
+
+// 注册 detail.tsx
+Object.entries(detailPageModules).forEach(([path, loader]) => {
+  const componentPath = path
+    .replace(/^\.\.\/views/, '')
+    .replace('/detail.tsx', '')
+    .replace(/^\//, '')  // 移除前导斜杠
+  const lazyComponent = createLazyPageComponent(path, loader as any)
+  componentMap[`${componentPath}/detail`] = lazyComponent
+})
+
+// 调试日志已移除：避免控制台刷屏
+
+// ---------------------------------------------------------------------------
+// 工具与类型
+// ---------------------------------------------------------------------------
+
+export function withPageFallback(node: React.ReactNode) {
+  return (
+    <React.Suspense
+      fallback={
+        <div className="flex h-screen items-center justify-center">
+          <Spin size="large" />
+        </div>
+      }>
+      {node}
+    </React.Suspense>
+  )
+}
+
+export type RouteConfig = {
+  path?: string
+  index?: boolean
+  element: ReactNode
+  children?: RouteConfig[]
+}
+
+export function toRouteObjects(configs: RouteConfig[]): RouteObject[] {
+  return configs.map((config) => {
+    if (config.index) {
+      return {
+        index: true,
+        element: config.element,
+      } as RouteObject
+    }
+    return {
+      path: config.path,
+      element: config.element,
+      children: config.children ? toRouteObjects(config.children) : undefined,
+    } as RouteObject
+  })
+}
+
+// ---------------------------------------------------------------------------
+// 静态路由（顺序与 App 中 routeConfigs 拼接一致：公开 → 401 → 主布局 → 404）
+// ---------------------------------------------------------------------------
+
+/** 无需登录 */
+export const ROUTES_PUBLIC: RouteConfig[] = [
+  { path: '/login', element: withPageFallback(<LoginPage />) },
+  { path: '/register', element: withPageFallback(<RegisterPage />) },
+]
+
+export const ROUTE_401: RouteConfig = {
+  path: '/401',
+  element: withPageFallback(<Route401Page />),
+}
+
+/**
+ * 主布局 children（相对 path）
+ * 顺序：默认重定向 → 新对话 → 具体会话 → 其它业务
+ */
+export const ROUTES_MAIN_CHILD: RouteConfig[] = [
+  { index: true, element: <Navigate to="/chat" replace /> },
+  { path: 'chat', element: withPageFallback(<ChatNewPage />) },
+  {
+    path: 'chat/:sessionId',
+    element: withPageFallback(<ChatSessionPage />),
+  },
+  { path: 'memories', element: withPageFallback(<MemoryPage />) },
+  { path: 'settings', element: withPageFallback(<SettingsPage />) },
+]
+
+export const ROUTE_404: RouteConfig = {
+  path: '*',
+  element: withPageFallback(<Route404Page />),
+}
+
+/** 菜单尚未注入动态路由时，用全屏加载替代 404，避免刷新深层链接瞬间落到通配 404 */
+export const ROUTE_BOOT: RouteConfig = {
+  path: '*',
+  element: (
+    <div className="flex h-screen items-center justify-center">
+      <Spin size="large" />
+    </div>
+  ),
+}
+
+// ---------------------------------------------------------------------------
+// 动态菜单路由 + 登录守卫
+// ---------------------------------------------------------------------------
+
+export function generateAdminRoutes(menus: MenuTreeItem[]): RouteConfig[] {
+  const flattenMenus = (menuList: MenuTreeItem[]): MenuTreeItem[] => {
+    const result: MenuTreeItem[] = []
+    menuList.forEach((menu) => {
+      if (menu.component && menu.component !== 'Main' && menu.path) {
+        result.push({
+          ...menu,
+          path: menu.path.replace(/^\//, ''),
+        })
+      }
+      if (menu.children && menu.children.length > 0) {
+        result.push(...flattenMenus(menu.children))
+      }
+    })
+    return result
+  }
+
+  const routes: RouteConfig[] = []
+  resetMenuRouteRegistry()
+
+  flattenMenus(menus).forEach((route) => {
+    // 清理 component 路径：移除前导斜杠和 /index 后缀
+    let rawComponent = route.component || ''
+
+    // 跳过无效的路径
+    if (!rawComponent || rawComponent === '/' || rawComponent === 'Main' || rawComponent === 'Root') {
+      return
+    }
+
+    // 标准化路径：移除前导斜杠
+    let componentPath = rawComponent.replace(/^\//, '')
+
+    // 尝试多种路径组合
+    if (!componentMap[componentPath]) {
+      componentPath = `${componentPath}/index`
+    }
+    if (!componentMap[componentPath]) {
+      componentPath = rawComponent.replace(/^\//, '').replace(/\/index$/, '')
+    }
+    if (!componentMap[componentPath]) {
+      componentPath = rawComponent.replace(/^\//, '').replace(/\/index$/, '') + '/index'
+    }
+
+    const Component = componentMap[componentPath]
+    if (!Component) {
+      return
+    }
+
+    const hasDetail = !!componentMap[`${componentPath}/detail`]
+    const hasSubmit = !!componentMap[`${componentPath}/submit`]
+
+    let basePath = route.path
+    if (basePath.endsWith('/index')) {
+      basePath = basePath.slice(0, -'/index'.length)
+    }
+
+    const listPath = route.path.startsWith('/') ? route.path : `/${route.path}`
+
+    registerAdminMenuRoute({
+      basePath,
+      listPath,
+      menuCode: route.code,
+      hasDetail,
+      hasSubmit,
+    })
+
+    // 添加主路由 - 完全按配置的 path
+    routes.push({
+      path: route.path,
+      element: withPageFallback(<Component />),
+    })
+
+    // 自动注册 submit/detail 路由（basePath 已含去掉 /index）
+
+    // 自动注册 submit 路由
+    const submitComponentPath = `${componentPath}/submit`
+    if (componentMap[submitComponentPath]) {
+      const SubmitComponent = componentMap[submitComponentPath]
+      // 先注册带 id，避免与无参 `submit` 产生匹配歧义（RR6/7）
+      routes.push({
+        path: `${basePath}/submit/:id`,
+        element: withPageFallback(<SubmitComponent />),
+      })
+      routes.push({
+        path: `${basePath}/submit`,
+        element: withPageFallback(<SubmitComponent />),
+      })
+    }
+
+    // 自动注册 detail 路由
+    const detailComponentPath = `${componentPath}/detail`
+    if (componentMap[detailComponentPath]) {
+      const DetailComponent = componentMap[detailComponentPath]
+      routes.push({
+        path: `${basePath}/detail/:id`,
+        element: withPageFallback(<DetailComponent />),
+      })
+    }
+  })
+  return routes
+}
+
+export const ProtectedRoute: React.FC<{ children: React.ReactNode }> = ({
+  children,
+}) => {
+  const { isAuthenticated, isLoading } = useAuth()
+  const { isLoading: isMenuLoading } = useMenu()
+
+  if (isLoading) {
+    return (
+      <div className="flex h-screen items-center justify-center">
+        <Spin size="large" />
+      </div>
+    )
+  }
+
+  if (!isAuthenticated) {
+    return <Navigate to="/login" />
+  }
+
+  // 登录态下：等待菜单就绪后再放行（避免先跳转再补菜单导致空白/闪烁）
+  if (isMenuLoading) {
+    return (
+      <div className="flex h-screen items-center justify-center">
+        <Spin size="large" />
+      </div>
+    )
+  }
+
+  return <>{children}</>
+}

package/src/styles/AntdThemeProvider.tsx

@@ -0,0 +1,40 @@
+import { ConfigProvider, theme as antdThemePreset } from 'antd'
+import React, { useEffect, useState } from 'react'
+import { antdTheme } from './antd-theme'
+
+function readHtmlDark(): boolean {
+  return document.documentElement.classList.contains('dark')
+}
+
+/**
+ * 随 `document.documentElement` 的 `dark` class 切换 antd 明/暗算法；
+ * 与 `useUserPreferences`、Tailwind `dark:`、variable.less 中 `html.dark` 一致。
+ */
+export function AntdThemeProvider({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  const [isDark, setIsDark] = useState(readHtmlDark)
+
+  useEffect(() => {
+    const el = document.documentElement
+    const sync = () => setIsDark(el.classList.contains('dark'))
+    sync()
+    const mo = new MutationObserver(sync)
+    mo.observe(el, { attributes: true, attributeFilter: ['class'] })
+    return () => mo.disconnect()
+  }, [])
+
+  return (
+    <ConfigProvider
+      theme={{
+        ...antdTheme,
+        algorithm: isDark
+          ? antdThemePreset.darkAlgorithm
+          : antdThemePreset.defaultAlgorithm,
+      }}>
+      {children}
+    </ConfigProvider>
+  )
+}

package/src/styles/antd-theme.ts

@@ -0,0 +1,20 @@
+import type { ThemeConfig } from 'antd'
+
+import { TAG_COLOR } from '@/meta/const'
+
+/**
+ * Ant Design 全局 Design Token（由 AntdThemeProvider 注入）
+ * 种子色来自 `@/meta/const` 的 `TAG_COLOR`；`variable.less` 中 `@antd-*` 须与之一致。
+ * 明暗切换由 Provider 设置 `darkAlgorithm` / `defaultAlgorithm`，会重算背景/边框等派生 token。
+ */
+export const antdTheme: ThemeConfig = {
+  token: {
+    colorPrimary: TAG_COLOR.info,
+    colorSuccess: TAG_COLOR.success,
+    colorWarning: TAG_COLOR.warning,
+    colorError: TAG_COLOR.error,
+    colorInfo: TAG_COLOR.info,
+    colorLink: TAG_COLOR.info,
+    borderRadius: 8,
+  },
+}

package/src/styles/global.less

@@ -0,0 +1,107 @@
+/**
+ * 全局公共样式（与页面/组件解耦，由 index.less 引入）
+ * 第三方组件覆盖、无作用域的全局规则可放此处。
+ */
+
+/* KaTeX：在 Tailwind Typography prose 内避免被裁切；暗色下与正文对比度一致 */
+
+.group {
+  .prose {
+    max-width: 80%;
+  }
+}
+
+.prose .katex {
+  max-width: 100%;
+  overflow-x: auto;
+}
+
+.prose-invert .katex,
+.dark .prose .katex {
+  color: #e5e7eb;
+}
+
+/* form 表单项 label 与控件间距（全局） */
+.ant-form-item-label {
+  padding-bottom: 0 !important;
+}
+
+/* antd 默认字体栈（需要按 antd 的基准字体显示时使用） */
+.font-antd {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
+    'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji',
+    'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
+}
+
+/**
+ * CxModal 内容区撑满壳（与 modalConfig.styles 里 container/body flex 配合）
+ * content / container / body：纵向 flex；container padding:0 消除 footer 下白边。
+ */
+.cx-modal-content-fill-struct(@root) {
+  .@{root} .ant-modal-content {
+    display: flex;
+    flex-direction: column;
+    min-height: 0;
+    overflow: hidden;
+    max-height: inherit;
+  }
+
+  .@{root} .ant-modal-container {
+    padding: 0 !important;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    height: min(95dvh, 95vh) !important;
+    max-height: min(95dvh, 95vh);
+    min-height: 0;
+  }
+
+  .@{root} .ant-modal-body {
+    overflow: hidden !important;
+    display: flex;
+    flex-direction: column;
+    flex: 1 1 0%;
+    min-height: 0;
+    max-height: none !important;
+    padding: 20px 32px;
+  }
+}
+
+.cx-modal-content-fill-form(@root) {
+  .@{root} .ant-modal-body form.ant-form {
+    display: flex !important;
+    flex-direction: column !important;
+    flex: 1 1 0% !important;
+    min-height: 0 !important;
+    align-self: stretch;
+    width: 100%;
+    max-height: none;
+    overflow: hidden;
+  }
+}
+
+/* 角色权限分配 */
+.cx-modal-content-fill-struct(~"cx-modal-role-assign");
+.cx-modal-content-fill-form(~"cx-modal-role-assign");
+
+.cx-modal-role-assign .ant-modal-body form.ant-form {
+  /* 2px 边框 + 焦点 ring 画在控件盒外时，避免被本层 overflow 裁切 */
+  padding: 4px;
+  box-sizing: border-box;
+}
+
+/* 固定视口高 + 头/体/脚布局：文档提交/详情、技能详情等共用 rootClassName */
+.cx-modal-content-fill-struct(~"cx-modal-content-fill");
+.cx-modal-content-fill-form(~"cx-modal-content-fill");
+
+.cx-modal-content-fill.scroll {
+  .ant-modal-body {
+    overflow-y: auto !important;
+    overflow-x: hidden !important;
+  }
+
+  .ant-modal-body form.ant-form {
+    overflow: visible !important;
+  }
+}
+

package/src/styles/variable.less

@@ -0,0 +1,103 @@
+/**
+ * 全局设计色（Less 变量 + CSS 自定义属性）
+ * - `@antd-*` / `@cx-*`：供本仓库 .less 引用（需 @import 本文件）
+ * - `:root` / `html.dark`：Cx 系列与任意 CSS 使用 `var(--cx-*)`、`var(--antd-*)`
+ *
+ * 暗色主题：`useUserPreferences` 等在 `document.documentElement` 上切换 `class="dark"`；
+ * Tailwind `dark:` 与下文 `html.dark` 选择器均依赖于此。
+ * Ant Design：`AntdThemeProvider` 根据 `html.dark` 切换 `darkAlgorithm`，与 Cx 变量并行生效。
+ */
+
+// ----- Ant Design seed（与 antd-theme.ts 同步）-----
+@antd-color-primary: #2563eb;
+@antd-color-primary-hover: #1d4ed8;
+@antd-color-primary-active: #1e40af;
+
+@antd-color-success: #22c55e;
+@antd-color-warning: #f59e0b;
+@antd-color-error: #ef4444;
+@antd-color-info: @antd-color-primary;
+
+@antd-color-link: @antd-color-primary;
+
+@antd-border-radius: 8px;
+
+// ----- Cx 组件用 Less 别名（可选，与 CSS 变量一致）-----
+@cx-option-hover-bg-light: #f3f4f6;
+@cx-option-selected-bg-light: #eff6ff;
+@cx-danger-border-light: #fecaca;
+@cx-danger-text-light: #dc2626;
+@cx-danger-hover-bg-light: #fef2f2;
+
+:root {
+  --ant-font-family: ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji",
+    "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji" !important;
+
+  --antd-color-primary: @antd-color-primary;
+  --antd-color-primary-hover: @antd-color-primary-hover;
+  --antd-color-primary-active: @antd-color-primary-active;
+  --antd-color-success: @antd-color-success;
+  --antd-color-warning: @antd-color-warning;
+  --antd-color-error: @antd-color-error;
+  --antd-color-info: @antd-color-info;
+  --antd-color-link: @antd-color-link;
+  --antd-border-radius: @antd-border-radius;
+
+  --brand-primary: @antd-color-primary;
+
+  /* Cx：主按钮实心（与 antd 主色一致） */
+  --cx-color-primary-solid: var(--antd-color-primary);
+  --cx-color-primary-solid-hover: var(--antd-color-primary-hover);
+  --cx-color-primary-solid-active: var(--antd-color-primary-active);
+
+  /* Cx：主色阴影（随主色变化） */
+  --cx-shadow-primary-sm: 0 1px 2px 0 color-mix(in srgb, var(--antd-color-primary) 15%, transparent);
+  --cx-shadow-primary-md:
+    0 4px 6px -1px color-mix(in srgb, var(--antd-color-primary) 20%, transparent),
+    0 2px 4px -2px color-mix(in srgb, var(--antd-color-primary) 20%, transparent);
+
+  /* Cx：下拉 / 树选项 */
+  --cx-option-hover-bg: @cx-option-hover-bg-light;
+  --cx-option-selected-bg: @cx-option-selected-bg-light;
+  --cx-option-selected-text: var(--antd-color-primary-hover);
+
+  /* Cx：空心 danger */
+  --cx-danger-outlined-bg: #fff;
+  --cx-danger-outlined-border: @cx-danger-border-light;
+  --cx-danger-outlined-text: @cx-danger-text-light;
+  --cx-danger-outlined-hover-bg: @cx-danger-hover-bg-light;
+
+  /* Cx：text 类型按钮 hover 底 */
+  --cx-text-btn-hover-bg: #f3f4f6;
+
+  /* Cx：多选「全选」链色 */
+  --cx-accent-link: var(--antd-color-primary-hover);
+}
+
+/* antd 运行时会用 `.css-var-xxxx` 作用域类注入变量；在该作用域下同步覆盖 */
+[class^='css-var-'],
+[class*=' css-var-'] {
+  --ant-font-family: ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji",
+    "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji" !important;
+}
+
+html.dark {
+  --brand-primary: @antd-color-primary;
+
+  --cx-shadow-primary-sm: 0 1px 2px 0 color-mix(in srgb, var(--antd-color-primary) 28%, transparent);
+  --cx-shadow-primary-md:
+    0 4px 6px -1px color-mix(in srgb, var(--antd-color-primary) 35%, transparent),
+    0 2px 4px -2px color-mix(in srgb, var(--antd-color-primary) 30%, transparent);
+
+  --cx-option-hover-bg: #374151;
+  --cx-option-selected-bg: color-mix(in srgb, var(--antd-color-primary) 22%, transparent);
+  --cx-option-selected-text: #93c5fd;
+
+  --cx-danger-outlined-bg: #374151;
+  --cx-danger-outlined-border: rgb(127 29 29 / 0.3);
+  --cx-danger-outlined-text: #f87171;
+  --cx-danger-outlined-hover-bg: rgb(127 29 29 / 0.1);
+
+  --cx-text-btn-hover-bg: #374151;
+  --cx-accent-link: #93c5fd;
+}

package/src/types/feedback.ts

@@ -0,0 +1,43 @@
+/** 审核状态：0=待审核、1=已通过、2=已拒绝 */
+export type ReviewStatus = 0 | 1 | 2
+
+/** 列表筛选：空字符串表示全部 */
+export type FeedbackStatusFilter = ReviewStatus | ''
+
+/** 将接口或表单中的状态转为 i18n 后缀（pending / approved / rejected） */
+export function feedbackStatusI18nKey(
+  status: unknown,
+): 'pending' | 'approved' | 'rejected' {
+  if (status === 0 || status === '0') return 'pending'
+  if (status === 1 || status === '1') return 'approved'
+  if (status === 2 || status === '2') return 'rejected'
+  return 'pending'
+}
+
+/** 是否为待审核（兼容数字或字符串枚举） */
+export function isFeedbackPending(status: unknown): boolean {
+  return status === 0 || status === '0'
+}
+
+export interface FeedbackDatasetItem {
+  id: string
+  messageId: string
+  userId: string
+  userName: string
+  question: string
+  answer: string
+  status: ReviewStatus
+  /** 评价类型：10=赞、20=踩 */
+  evaluationType: 10 | 20
+  createTime: string
+  updateTime: string
+  reviewBy?: string
+  reviewTime?: string
+}
+
+export interface FeedbackUpdate {
+  question?: string
+  answer?: string
+  status?: ReviewStatus
+  evaluationType?: 10 | 20
+}