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 配置文件

entrypoints/popup/pages/FormRecognizerPage.tsx

@@ -1,339 +1,39 @@
-import { useState, useRef, useEffect } from 'react';
-import {
-  Box,
-  Container,
-  Button,
-  CircularProgress,
-  FormControlLabel,
-  Switch,
-  alpha,
-} from '@mui/material';
+import { Box, Container, CircularProgress, FormControlLabel, Switch } from '@mui/material';
+import Button from '@/components/Button';
 import InputIcon from '@mui/icons-material/Input';
 import OpenInNewIcon from '@mui/icons-material/OpenInNew';
-import GlobalSnackbar, { useSnackbar } from '@/components/GlobalSnackbar';
-import { dashboardPageStyles, formRecognizerPageStyles } from '@/config/pageTheme';
-import { MessageAction, sendMessageToContent, injectContentScript } from '@/utils/messages';
-import { FillMode } from '@/utils/dummyDataGenerator';
+import { formRecognizerPageStyles } from '@/config/pageTheme';
 import FieldList from '@/components/FieldList';
-import { useStorageState } from '@/utils/useStorageState';
-import { FieldTypePreferences } from '@/types/storage';
 import PageHeader from '@/components/PageHeader';
+import { useFormRecognizer } from './hooks/useFormRecognizer';
 
-// 字段数据接口
-interface FieldData {
-  id: string;
-  fieldType: string;
-  label: string | null;
-  placeholder: string;
-  name: string;
-  value: string;
-  isSelected: boolean;
-  generatedValue: string;
-  useInvalidData?: boolean;
-}
-
-const DEFAULT_FIELD_TYPE_PREFERENCES: FieldTypePreferences = {};
-
-const FormRecognizerPage = () => {
-  const { snackbarProps, showMessage } = useSnackbar({ autoHideDuration: 1500 });
-  const [fillLoading, setFillLoading] = useState(false);
-  const [clearLoading, setClearLoading] = useState(false);
-  const [includeHidden, setIncludeHidden] = useState(false);
-  const isProcessingRef = useRef(false);
-  const [fields, setFields] = useState<FieldData[]>([]);
-  const [scanning, setScanning] = useState(false);
-  const [showFields, setShowFields] = useState(false);
-  const [hoveredFieldId, setHoveredFieldId] = useState<string | null>(null);
-  const [currentDomain, setCurrentDomain] = useState<string>('');
-  const [sidePanelOpen, setSidePanelOpen] = useState(false);
-
-  const [fieldTypePreferences, setFieldTypePreferences] = useStorageState(
-    'formRecognizer/fieldTypePreferences',
-    DEFAULT_FIELD_TYPE_PREFERENCES,
-  );
-
-  // 获取当前域名
-  useEffect(() => {
-    const getActiveTab = async () => {
-      try {
-        const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
-        if (tab?.url) {
-          const url = new URL(tab.url);
-          setCurrentDomain(url.hostname);
-        }
-      } catch (error) {
-        console.error('获取标签页信息失败:', error);
-      }
-    };
-    getActiveTab();
-  }, []);
-
-  // 检测侧边栏状态
-  useEffect(() => {
-    console.log('开始检测侧边栏状态');
-    const checkSidePanelState = async () => {
-      try {
-        // 检查 chrome.runtime.getContexts 是否可用
-        if (typeof chrome.runtime.getContexts === 'function') {
-          const contexts = await chrome.runtime.getContexts({
-            contextTypes: ['SIDE_PANEL'],
-          });
-          console.log('侧边栏上下文:', contexts);
-          setSidePanelOpen(contexts.length > 0);
-        } else {
-          console.log('chrome.runtime.getContexts 不可用');
-          setSidePanelOpen(false);
-        }
-      } catch (error) {
-        console.error('检测侧边栏状态失败:', error);
-        setSidePanelOpen(false);
-      }
-    };
-
-    // 初始检查
-    checkSidePanelState();
-
-    // 定期检查侧边栏状态（每 500ms）
-    const interval = setInterval(checkSidePanelState, 500);
-
-    console.log('侧边栏状态检测已启动');
-    return () => {
-      console.log('清理侧边栏状态检测');
-      clearInterval(interval);
-    };
-  }, []);
-
-  // 生成字段标识符
-  const getFieldIdentifier = (field: Pick<FieldData, 'label' | 'name' | 'placeholder'>): string => {
-    return field.label || field.name || field.placeholder || 'unknown';
-  };
-
-  // 应用保存的类型偏好
-  const applySavedPreferences = (fields: FieldData[]): FieldData[] => {
-    if (!currentDomain || !(fieldTypePreferences as FieldTypePreferences)[currentDomain]) {
-      return fields;
-    }
-    const prefs = (fieldTypePreferences as FieldTypePreferences)[currentDomain];
-    return fields.map((field) => {
-      const identifier = getFieldIdentifier(field);
-      if (prefs && prefs[identifier]) {
-        return { ...field, fieldType: prefs[identifier] };
-      }
-      return field;
-    });
-  };
-
-  // 保存类型偏好
-  const saveTypePreference = (field: FieldData, newType: string) => {
-    if (!currentDomain) return;
-    const identifier = getFieldIdentifier(field);
-    setFieldTypePreferences((prev) => {
-      const prevPrefs = prev as FieldTypePreferences;
-      const currentDomainPrefs = prevPrefs[currentDomain] || {};
-      return {
-        ...prevPrefs,
-        [currentDomain]: {
-          ...currentDomainPrefs,
-          [identifier]: newType,
-        },
-      } as FieldTypePreferences;
-    });
-  };
-
-  // 扫描表单字段
-  const handleScanFields = async () => {
-    setScanning(true);
-    try {
-      let response = await sendMessageToContent(MessageAction.SCAN_FORM_FIELDS);
-
-      if (!response.success && response.message && response.message.includes('无法连接')) {
-        showMessage('正在注入内容脚本...', { severity: 'info' });
-        const injected = await injectContentScript();
-        if (injected) {
-          response = await sendMessageToContent(MessageAction.SCAN_FORM_FIELDS);
-        }
-      }
-
-      if (response.success && response.fields) {
-        const fieldsWithPreferences = applySavedPreferences(response.fields as FieldData[]);
-        setFields(fieldsWithPreferences);
-        setShowFields(true);
-        showMessage(`扫描完成，发现 ${response.totalCount} 个可填充字段`, { severity: 'success' });
-      } else {
-        showMessage(response.message || '扫描失败', { severity: 'error' });
-      }
-    } catch (error) {
-      console.error('扫描失败:', error);
-      showMessage('扫描失败，请确保页面已加载', { severity: 'error' });
-    } finally {
-      setScanning(false);
-    }
-  };
-
-  // 更新字段类型
-  const handleFieldTypeChange = (fieldId: string, newType: string) => {
-    setFields((prev) =>
-      prev.map((field) => {
-        if (field.id === fieldId) {
-          const updatedField = {
-            ...field,
-            fieldType: newType,
-            // 清空旧的 generatedValue，保持界面一致性
-            generatedValue: '',
-          };
-          saveTypePreference(field, newType);
-          return updatedField;
-        }
-        return field;
-      }),
-    );
-  };
-
-  // 切换单个字段的选中状态
-  const handleToggleFieldSelection = (fieldId: string) => {
-    setFields((prev) =>
-      prev.map((field) =>
-        field.id === fieldId ? { ...field, isSelected: !field.isSelected } : field,
-      ),
-    );
-  };
-
-  // 全选/取消全选
-  const handleToggleAllFields = () => {
-    setFields((prev) => {
-      const allSelected = prev.every((f) => f.isSelected);
-      return prev.map((f) => ({ ...f, isSelected: !allSelected }));
-    });
-  };
-
-  // 定位字段（闪烁）
-  const handleLocateField = async (fieldId: string) => {
-    try {
-      const response = await sendMessageToContent(MessageAction.FLASH_FIELD, { fieldId });
-      if (!response.success) {
-        showMessage(response.message || '定位字段失败', { severity: 'error' });
-      }
-    } catch (error) {
-      console.error('定位字段失败:', error);
-    }
-  };
-
-  // 悬停高亮
-  const handleHoverField = async (fieldId: string | null) => {
-    setHoveredFieldId(fieldId);
-    try {
-      if (fieldId) {
-        await sendMessageToContent(MessageAction.HIGHLIGHT_FIELD, { fieldId });
-      } else {
-        await sendMessageToContent(MessageAction.UNHIGHLIGHT_ALL_FIELDS);
-      }
-    } catch (error) {
-      console.error('高亮字段失败:', error);
-    }
-  };
-
-  // 填充选中字段
-  const handleFillSelectedFields = async () => {
-    if (isProcessingRef.current) {
-      showMessage('操作进行中，请稍候...', { severity: 'warning' });
-      return;
-    }
-
-    const selectedCount = fields.filter((f) => f.isSelected).length;
-    if (selectedCount === 0) {
-      showMessage('请先选择要填充的字段', { severity: 'warning' });
-      return;
-    }
-
-    setFillLoading(true);
-    isProcessingRef.current = true;
-    try {
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const messageFields = fields as any;
-      let response = await sendMessageToContent(MessageAction.FILL_SELECTED_FIELDS, {
-        fields: messageFields,
-        mode: FillMode.VALID,
-        includeHidden,
-      });
-
-      if (!response.success && response.message && response.message.includes('无法连接')) {
-        showMessage('正在注入内容脚本...', { severity: 'info' });
-        const injected = await injectContentScript();
-        if (injected) {
-          response = await sendMessageToContent(MessageAction.FILL_SELECTED_FIELDS, {
-            fields: messageFields,
-            mode: FillMode.VALID,
-            includeHidden,
-          });
-        }
-      }
-
-      if (response.success) {
-        showMessage(response.message || '填充成功', { severity: 'success' });
-      } else {
-        showMessage(response.message || '填充失败', { severity: 'error' });
-      }
-    } catch (error) {
-      console.error('填充失败:', error);
-      const errorMessage = error instanceof Error ? error.message : '未知错误';
-      showMessage(`填充失败：${errorMessage}，请确保当前页面已加载完成`, { severity: 'error' });
-    } finally {
-      setFillLoading(false);
-      isProcessingRef.current = false;
-    }
-  };
-
-  // 清空所有字段
-  const handleClearAllFields = async () => {
-    if (isProcessingRef.current) {
-      showMessage('操作进行中，请稍候...', { severity: 'warning' });
-      return;
-    }
-
-    setClearLoading(true);
-    isProcessingRef.current = true;
-    try {
-      let response = await sendMessageToContent(MessageAction.CLEAR_ALL_FIELDS);
-
-      if (!response.success && response.message && response.message.includes('无法连接')) {
-        showMessage('正在注入内容脚本...', { severity: 'info' });
-        const injected = await injectContentScript();
-        if (injected) {
-          response = await sendMessageToContent(MessageAction.CLEAR_ALL_FIELDS);
-        }
-      }
-
-      if (response.success) {
-        showMessage(response.message || '清空成功', { severity: 'success' });
-      } else {
-        showMessage(response.message || '清空失败', { severity: 'error' });
-      }
-    } catch (error) {
-      console.error('清空失败:', error);
-      const errorMessage = error instanceof Error ? error.message : '未知错误';
-      showMessage(`清空失败：${errorMessage}，请确保当前页面已加载完成`, { severity: 'error' });
-    } finally {
-      setClearLoading(false);
-      isProcessingRef.current = false;
-    }
-  };
-
-  // 打开侧边栏
-  const handleOpenSidePanel = async () => {
-    try {
-      await chrome.sidePanel.open({ windowId: chrome.windows.WINDOW_ID_CURRENT });
-      showMessage('侧边栏已打开', { severity: 'success' });
-    } catch (error) {
-      console.error('打开侧边栏失败:', error);
-      showMessage('打开侧边栏失败', { severity: 'error' });
-    }
-  };
-
-  const selectedCount = fields.filter((f) => f.isSelected).length;
+export default function FormRecognizerPage() {
+  const {
+    fillLoading,
+    clearLoading,
+    includeHidden,
+    setIncludeHidden,
+    fields,
+    scanning,
+    showFields,
+    setShowFields,
+    hoveredFieldId,
+    sidePanelOpen,
+    handleScanFields,
+    handleFieldTypeChange,
+    handleToggleFieldSelection,
+    handleToggleAllFields,
+    handleLocateField,
+    handleHoverField,
+    handleFillSelectedFields,
+    handleClearAllFields,
+    handleOpenSidePanel,
+    selectedCount,
+  } = useFormRecognizer();
 
   return (
-    <Box sx={{ bgcolor: dashboardPageStyles.backgroundColor, minHeight: '100%', pb: 4 }}>
-      <Container maxWidth="sm" sx={{ py: 3, px: 2, bgcolor: '#f5f5f5' }}>
+    <Box>
+      <Container maxWidth="sm" sx={{ py: 3, px: 2 }}>
         {/* Header */}
         <PageHeader
           title="表单测试数据填充器"
@@ -366,16 +66,6 @@ const FormRecognizerPage = () => {
           onClick={handleScanFields}
           disabled={scanning}
           fullWidth
-          sx={{
-            ...formRecognizerPageStyles.buttonStyle,
-            mb: 2,
-            borderColor: formRecognizerPageStyles.validColor,
-            color: formRecognizerPageStyles.validColor,
-            '&:hover': {
-              borderColor: formRecognizerPageStyles.validDark,
-              bgcolor: 'rgba(76, 175, 80, 0.05)',
-            },
-          }}
           startIcon={scanning ? <CircularProgress size={16} color="inherit" /> : <InputIcon />}
         >
           {scanning ? '扫描中...' : '扫描表单字段'}
@@ -403,27 +93,6 @@ const FormRecognizerPage = () => {
               onClick={handleFillSelectedFields}
               disabled={fillLoading || selectedCount === 0}
               fullWidth
-              sx={{
-                py: 1.6,
-                borderRadius: 4,
-                bgcolor: formRecognizerPageStyles.validColor,
-                fontWeight: 700,
-                fontSize: '1rem',
-                textTransform: 'none',
-                transition: 'all 0.3s cubic-bezier(0.4, 0, 0.2, 1)',
-                '&:hover': {
-                  bgcolor: formRecognizerPageStyles.validDark,
-                  boxShadow: `0 8px 24px ${alpha(formRecognizerPageStyles.validColor, 0.3)}`,
-                  transform: 'translateY(-1px)',
-                },
-                '&:disabled': {
-                  bgcolor: '#e0e0e0',
-                  color: '#9e9e9e',
-                },
-                '&:active': {
-                  transform: 'translateY(0)',
-                },
-              }}
             >
               填充选中字段
             </Button>
@@ -435,28 +104,6 @@ const FormRecognizerPage = () => {
               onClick={handleClearAllFields}
               disabled={clearLoading}
               fullWidth
-              sx={{
-                py: 1.6,
-                borderRadius: 4,
-                borderColor: formRecognizerPageStyles.clearColor,
-                color: formRecognizerPageStyles.clearColor,
-                fontWeight: 600,
-                fontSize: '1rem',
-                textTransform: 'none',
-                transition: 'all 0.3s cubic-bezier(0.4, 0, 0.2, 1)',
-                '&:hover': {
-                  borderColor: formRecognizerPageStyles.clearDark,
-                  bgcolor: formRecognizerPageStyles.clearBg,
-                  transform: 'translateY(-1px)',
-                },
-                '&:disabled': {
-                  borderColor: '#e0e0e0',
-                  color: '#9e9e9e',
-                },
-                '&:active': {
-                  transform: 'translateY(0)',
-                },
-              }}
             >
               清空所有字段
             </Button>
@@ -474,11 +121,7 @@ const FormRecognizerPage = () => {
             label="包含隐藏字段"
           />
         </Box>
-
-        <GlobalSnackbar {...snackbarProps} />
       </Container>
     </Box>
   );
-};
-
-export default FormRecognizerPage;
+}