Refactor and enhance form recognition, mapping, and UI components (#18)

* docs: 添加组件文档注释和类型导入 refactor: 统一使用 SnackbarOptions 类型 style: 优化导入语句顺序和格式 * refactor: 简化假数据生成器中的faker导入和使用 Co-authored-by: Copilot <copilot@github.com> * feat(form-recognizer): 增强表单识别功能并优化UI交互 - 新增字段类型偏好设置功能，支持按域名保存字段类型 - 重构FieldList组件，改进字段选择和类型修改体验 - 添加字段定位闪烁功能，便于在页面上快速找到对应字段 - 优化表单填充逻辑，支持单个字段覆盖默认填充模式 - 移除独立的侧边栏页面，统一使用主页面组件 - 改进useStorageState钩子，增加加载状态管理和防抖处理 * refactor: 移除未使用的组件文件 * refactor(页面头部): 提取通用 PageHeader 组件并替换各页面头部实现重构各页面头部为统一的 PageHeader 组件，提高代码复用性和维护性 * style(组件): 调整自动刷新开关和存储选项网格的样式优化自动刷新开关的文本内边距，重构存储选项网格的布局结构，调整间距和边框样式 * style(ui): 调整时间戳页面和结果视图的样式 - 为时区选择器添加圆角 - 优化结果视图的布局和对齐方式 - 调整结果项的内边距和文本样式 * ci(workflow): 移除Firefox测试以简化CI流程仅保留Chrome浏览器的构建步骤，减少CI运行时间和资源消耗 * refactor(qrcode): 重构二维码解析功能并提取为独立模块 * style(页面样式): 统一页面头部图标颜色并优化表单样式更新各页面头部组件的图标颜色配置，移除冗余的表单标签属性，优化输入框样式和按钮悬停效果 * feat(formMapping): 添加表单映射功能 - 创建 FormMappingPage 页面组件 - 实现表单扫描器 scanner.ts - 实现高亮器 highlighter.ts - 更新路由配置 routes.ts - 更新内容脚本 content.ts - 更新类型定义 storage.d.ts - 添加 formMappingPageStyles 样式配置 * feat(表单映射): 添加配置导出功能及状态提示添加配置导出为JSON文件的功能，包含导出按钮和错误处理。新增Snackbar组件用于显示导出成功和错误状态。优化页面布局结构，将状态提示移至全局容器外。 * feat(表单填充): 新增智能表单填充功能添加智能表单填充功能，包括： 1. 新增表单填充页面和路由配置 2. 实现模糊匹配引擎和智能注入引擎 3. 添加Mock数据生成器和视觉反馈渲染器 4. 扩展消息接口支持填充操作 * ci: 精简触发CI的工作流分支移除对develop分支及其变体的触发，仅保留main分支的触发 * test: 更新路由测试以匹配新增的路由数量 * test: 将测试文件中的描述和断言翻译为中文 * test(PageHeader): 添加组件测试用例验证渲染逻辑和样式 * refactor(theme): 重构主题样式并优化仪表盘卡片组件将页面样式配置集中管理，移除各页面中硬编码的背景色新增 DashboardCard 组件封装通用卡片逻辑添加 dashboardCards 配置文件统一管理卡片数据 * refactor(Button): 统一按钮样式并移除重复样式定义将按钮样式统一封装到 Button 组件中，移除各页面重复的样式定义更新组件文档说明，提供更清晰的用法示例 * docs: 更新 README 文件中的目录结构说明添加新组件和配置文件的说明，保持文档与代码同步 * refactor: 优化代码类型声明和UI布局修复类型声明从any改为never以提高类型安全性调整TimestampPage页面布局间距移除DashboardPage中不必要的实时时钟状态更新ESLint配置以使用推荐配置添加选项页面打开的错误处理 * refactor(消息通信): 使用 @webext-core/messaging 重构消息处理逻辑将原有的 chrome.runtime.onMessage 和 chrome.tabs.sendMessage 替换为类型安全的 @webext-core/messaging 实现添加 ProtocolMap 类型定义确保消息类型安全更新相关页面和后台脚本使用新的消息通信方式 * fix: 修复依赖项缺失导致的潜在问题修复 useStorageState 中缺少 defaultValue 依赖的问题重构 RouterProvider 的初始化逻辑，使用 useCallback 优化性能 * refactor: 重构表单识别和消息处理逻辑将表单映射UI逻辑提取到独立文件将消息处理器提取到独立文件将表单识别页面逻辑提取到自定义hook 优化代码结构和可维护性 * feat(侧边栏): 添加侧边栏状态变化通知功能 - 在消息类型中新增侧边栏状态变化枚举和字段 - 侧边栏打开和关闭时发送状态通知 - 替换轮询检查方式为消息监听机制 * refactor: 优化高亮组件渲染逻辑并添加防抖处理重构高亮组件渲染逻辑，使用 requestAnimationFrame 进行节流优化在 useStorageCleaner 中添加防抖处理以避免频繁加载 * refactor: 统一组件导出方式为默认导出 * refactor: 重构样式系统并迁移至 MUI 主题删除冗余的 CSS 文件，统一使用 MUI 主题管理样式新增 useActiveTabDomain 和 useSidePanelState 自定义 Hook 优化各入口点的主题集成和布局处理 * docs: 更新项目文档以反映新增功能和技术栈细节更新 AGENTS.md 文档，详细描述新增的功能模块（存储管理、URL 管理、二维码生成、表单工具套件等）和更新的技术栈信息 * feat: 添加错误边界组件以捕获子组件错误在 popup、sidepanel 和 options 入口点添加 ErrorBoundary 组件，用于捕获并处理子组件中的 JavaScript 错误。当错误发生时，显示友好的错误界面并提供刷新功能。 * refactor(ui): 使用全局 snackbar 替换本地通知组件重构表单页面中的通知系统，移除本地 Snackbar 和 Alert 组件，改用全局 GlobalSnackbar 组件统一管理通知标准化主题配置中的 CSS 属性命名，移除带前缀的样式属性 * refactor(snackbar): 重构全局消息提示为 SnackbarProvider 组件将原本分散在各页面的 GlobalSnackbar 组件重构为集中管理的 SnackbarProvider，通过 Context 提供统一的消息提示功能。主要变更包括： 1. 创建新的 SnackbarProvider 组件作为全局消息提示容器 2. 提供 useSnackbar hook 供子组件调用 3. 移除各页面中独立的 GlobalSnackbar 实例 4. 在 App 根组件中统一集成 SnackbarProvider 5. 优化消息提示样式和交互行为 * refactor(Snackbar): 重构消息提示组件并优化样式重构 Snackbar 组件，将状态管理逻辑提取到 GlobalSnackbar 中复用优化消息提示样式，调整阴影效果和最小尺寸统一各页面使用 Snackbar 的方式，移除冗余配置 * refactor: 重构路由和功能配置系统 - 将路由配置和仪表盘卡片配置合并为统一的 features 配置 - 重构 RouterProvider 增加数据校验和本地快照功能 - 优化表单字段识别和填充逻辑，提取公共方法 - 更新相关组件和文档以适配新的配置系统 - 删除废弃的 dashboardCards 和 routes 配置文件
2026-05-01 18:00:06 +08:00
parent 60537f6e2e
commit 8d36f21f1b
64 changed files with 2901 additions and 2197 deletions
@@ -1,9 +0,0 @@
-.app {
-  min-height: 100vh;
-  background-color: #f5f5f5;
-  font-family:
-    -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell',
-    'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-}
@@ -14,30 +14,35 @@ import KeyboardArrowUpIcon from '@mui/icons-material/KeyboardArrowUp';
 import KeyboardArrowDownIcon from '@mui/icons-material/KeyboardArrowDown';
 import type { PageType } from '@/types/storage';
 import { storageUtil } from '@/utils/chromeStorage';
-import { getRouteByKey, getDefaultPageOrder, getDefaultVisibleRoutes } from '@/config/routes';
-import GlobalSnackbar, { useSnackbar } from '@/components/GlobalSnackbar';
+import {
+  getFeatureByKey,
+  getDefaultPageOrder,
+  getDefaultVisibleFeatureKeys,
+} from '@/config/features';
+import GlobalSnackbar, { useSnackbarState } from '@/components/GlobalSnackbar';
+import ErrorBoundary from '@/components/ErrorBoundary';

-function App() {
+export default function App() {
  const [visiblePages, setVisiblePages] = useState<PageType[]>([]);
  const [pageOrder, setPageOrder] = useState<PageType[]>([]);
  const [isLoaded, setIsLoaded] = useState(false);
-  const { snackbarProps, showMessage } = useSnackbar();
+  const { snackbarProps, showMessage } = useSnackbarState();

  useEffect(() => {
-    loadConfig();
+    loadConfig().catch(console.error);
  }, []);

  const loadConfig = async () => {
    try {
      const [savedVisible, savedOrder] = await Promise.all([
-        storageUtil.get('app/visiblePages', getDefaultVisibleRoutes()),
+        storageUtil.get('app/visiblePages', getDefaultVisibleFeatureKeys()),
        storageUtil.get('app/pageOrder', getDefaultPageOrder()),
      ]);
-      setVisiblePages(savedVisible ?? getDefaultVisibleRoutes());
+      setVisiblePages(savedVisible ?? getDefaultVisibleFeatureKeys());
      setPageOrder(savedOrder && savedOrder.length > 0 ? savedOrder : getDefaultPageOrder());
    } catch (error) {
      console.error('Failed to load config:', error);
-      setVisiblePages(getDefaultVisibleRoutes());
+      setVisiblePages(getDefaultVisibleFeatureKeys());
      setPageOrder(getDefaultPageOrder());
    } finally {
      setIsLoaded(true);
@@ -61,8 +66,8 @@ function App() {
    try {
      await storageUtil.set('app/visiblePages', newPages);
      setVisiblePages(newPages);
-      const route = getRouteByKey(page);
-      showToast(`已${isCurrentlyVisible ? '隐藏' : '显示'} ${route?.label || page}`, 'success');
+      const feature = getFeatureByKey(page);
+      showToast(`已${isCurrentlyVisible ? '隐藏' : '显示'} ${feature?.label || page}`, 'success');
    } catch (error) {
      console.error('Failed to save config:', error);
      showToast('保存失败', 'warning');
@@ -88,8 +93,8 @@ function App() {

  const handleRestoreDefaults = async () => {
    try {
-      const { getDefaultVisibleRoutes } = await import('@/config/routes');
-      const defaults = getDefaultVisibleRoutes();
+      const { getDefaultVisibleFeatureKeys } = await import('@/config/features');
+      const defaults = getDefaultVisibleFeatureKeys();
      const defaultOrder = getDefaultPageOrder();

      await Promise.all([
@@ -121,92 +126,102 @@ function App() {
  }

  return (
-    <Box sx={{ p: 4, maxWidth: 600, mx: 'auto', minHeight: '100vh', bgcolor: 'grey.50' }}>
-      <Stack direction="row" justifyContent="space-between" alignItems="flex-start" sx={{ mb: 4 }}>
-        <Button
-          variant="text"
-          size="small"
-          onClick={handleRestoreDefaults}
-          startIcon={<RefreshIcon sx={{ fontSize: 16 }} />}
-          sx={{ color: 'text.secondary', fontWeight: 600 }}
-        >
-          恢复默认
-        </Button>
-      </Stack>
+    <Box
+      className="app"
+      sx={{ p: 4, minHeight: '100vh', bgcolor: 'grey.50', display: 'block', overflowY: 'auto' }}
+    >
+      <ErrorBoundary>
+        <Box sx={{ maxWidth: 600, mx: 'auto' }}>
+          <Stack
+            direction="row"
+            justifyContent="space-between"
+            alignItems="flex-start"
+            sx={{ mb: 4 }}
+          >
+            <Button
+              variant="text"
+              size="small"
+              onClick={handleRestoreDefaults}
+              startIcon={<RefreshIcon sx={{ fontSize: 16 }} />}
+              sx={{ color: 'text.secondary', fontWeight: 600 }}
+            >
+              恢复默认
+            </Button>
+          </Stack>

-      <Paper
-        elevation={0}
-        sx={{
-          borderRadius: 4,
-          border: '1px solid',
-          borderColor: 'grey.200',
-          overflow: 'hidden',
-          bgcolor: 'background.paper',
-        }}
-      >
-        <Box sx={{ display: 'flex', flexDirection: 'column' }}>
-          {pageOrder.map((key, index, array) => {
-            const route = getRouteByKey(key);
-            if (!route) return null;
+          <Paper
+            elevation={0}
+            sx={{
+              borderRadius: 4,
+              border: '1px solid',
+              borderColor: 'grey.200',
+              overflow: 'hidden',
+              bgcolor: 'background.paper',
+            }}
+          >
+            <Box sx={{ display: 'flex', flexDirection: 'column' }}>
+              {pageOrder.map((key, index, array) => {
+                const feature = getFeatureByKey(key);
+                if (!feature) return null;

-            const isChecked = visiblePages.includes(key);
-            const isDisabled = isChecked && visiblePages.length === 1;
+                const isChecked = visiblePages.includes(key);
+                const isDisabled = isChecked && visiblePages.length === 1;

-            return (
-              <Box
-                key={key}
-                sx={{
-                  display: 'flex',
-                  alignItems: 'center',
-                  justifyContent: 'space-between',
-                  p: 2.5,
-                  borderBottom: index === array.length - 1 ? 'none' : '1px solid',
-                  borderColor: 'grey.100',
-                  transition: 'all 0.2s',
-                  '&:hover': { bgcolor: 'grey.50' },
-                }}
-              >
-                <Box>
-                  <Typography variant="body1" sx={{ fontWeight: 700, color: 'text.primary' }}>
-                    {route.label}
-                  </Typography>
-                  <Typography variant="caption" color="text.secondary">
-                    {isChecked ? '已在 Dashboard 启用' : '已在 Dashboard 隐藏'}
-                  </Typography>
-                </Box>
-                <Box sx={{ display: 'flex', alignItems: 'center', gap: 1 }}>
-                  <IconButton
-                    size="small"
-                    onClick={() => handleMove(index, 'up')}
-                    disabled={index === 0}
-                    sx={{ color: 'text.secondary' }}
+                return (
+                  <Box
+                    key={key}
+                    sx={{
+                      display: 'flex',
+                      alignItems: 'center',
+                      justifyContent: 'space-between',
+                      p: 2.5,
+                      borderBottom: index === array.length - 1 ? 'none' : '1px solid',
+                      borderColor: 'grey.100',
+                      transition: 'all 0.2s',
+                      '&:hover': { bgcolor: 'grey.50' },
+                    }}
                  >
-                    <KeyboardArrowUpIcon fontSize="small" />
-                  </IconButton>
-                  <IconButton
-                    size="small"
-                    onClick={() => handleMove(index, 'down')}
-                    disabled={index === array.length - 1}
-                    sx={{ color: 'text.secondary' }}
-                  >
-                    <KeyboardArrowDownIcon fontSize="small" />
-                  </IconButton>
-                  <Switch
-                    size="small"
-                    checked={isChecked}
-                    onChange={() => handlePageToggle(key)}
-                    disabled={isDisabled}
-                  />
-                </Box>
-              </Box>
-            );
-          })}
+                    <Box>
+                      <Typography variant="body1" sx={{ fontWeight: 700, color: 'text.primary' }}>
+                        {feature.label}
+                      </Typography>
+                      <Typography variant="caption" color="text.secondary">
+                        {isChecked ? '已在 Dashboard 启用' : '已在 Dashboard 隐藏'}
+                      </Typography>
+                    </Box>
+                    <Box sx={{ display: 'flex', alignItems: 'center', gap: 1 }}>
+                      <IconButton
+                        size="small"
+                        onClick={() => handleMove(index, 'up')}
+                        disabled={index === 0}
+                        sx={{ color: 'text.secondary' }}
+                      >
+                        <KeyboardArrowUpIcon fontSize="small" />
+                      </IconButton>
+                      <IconButton
+                        size="small"
+                        onClick={() => handleMove(index, 'down')}
+                        disabled={index === array.length - 1}
+                        sx={{ color: 'text.secondary' }}
+                      >
+                        <KeyboardArrowDownIcon fontSize="small" />
+                      </IconButton>
+                      <Switch
+                        size="small"
+                        checked={isChecked}
+                        onChange={() => handlePageToggle(key)}
+                        disabled={isDisabled}
+                      />
+                    </Box>
+                  </Box>
+                );
+              })}
+            </Box>
+          </Paper>
        </Box>
-      </Paper>
+      </ErrorBoundary>

      <GlobalSnackbar {...snackbarProps} />
    </Box>
  );
 }
-
-export default App;
@@ -1,11 +1,15 @@
 import React from 'react';
 import ReactDOM from 'react-dom/client';
+import { ThemeProvider } from '@mui/material/styles';
+import CssBaseline from '@mui/material/CssBaseline';
+import theme from '@/config/theme';
 import App from './App';
-import './App.css';
-import '@mui/material/styles';

 ReactDOM.createRoot(document.getElementById('root')!).render(
  <React.StrictMode>
-    <App />
+    <ThemeProvider theme={theme}>
+      <CssBaseline />
+      <App />
+    </ThemeProvider>
  </React.StrictMode>,
 );