LingandRX
af0089c980
* feat(formRecognizer): 添加表单识别功能及相关组件 添加表单识别功能，包括以下内容： 1. 在路由配置中添加表单识别页面 2. 实现表单识别页面和侧边栏面板 3. 添加表单数据生成工具类 4. 实现与内容脚本的通信机制 5. 添加faker-js依赖用于生成测试数据 6. 支持不同入口点(popup/sidepanel)的组件渲染 * refactor(消息通信): 重构消息通信机制并集中管理消息协议 将分散的消息协议和通信逻辑集中到 utils/messages.ts 中 移除旧的 messages.tsx 文件并更新相关引用 添加消息动作枚举和类型定义，提高类型安全性 优化内容脚本注入失败时的处理逻辑 * feat(QR码): 添加粘贴图片功能并优化上传组件 添加全局粘贴事件监听，支持从剪贴板直接粘贴二维码图片进行解析。重构上传组件为独立组件QrCodeUploader，包含拖拽上传、预览、进度显示和错误处理功能。优化页面样式和用户体验。 - 在QrCodePage添加粘贴事件监听 - 创建QrCodeUploader组件整合上传功能 - 更新测试用例格式 - 调整多个页面的背景色样式 * feat(表单识别): 新增表单识别页面功能与模板管理 - 添加表单识别页面样式配置 - 实现表单字段扫描与展示功能 - 新增数据模板管理工具类 - 添加数据验证工具类 - 扩展表单识别页面功能，包括操作历史记录 - 支持模板的导入导出功能 - 优化表单填充操作的用户体验 * feat(消息系统): 添加标签页刷新功能 在消息系统中新增 RELOAD_TAB 动作类型和 tabId 字段，用于处理标签页刷新请求 修改 StorageCleanerPage 使用后台脚本发送刷新请求，确保弹窗关闭后仍能执行 在 background.ts 中添加标签页刷新处理逻辑，包括错误处理和响应返回 * refactor(theme): 重构主题颜色和样式配置 - 更新主题颜色以满足 WCAG AA 可访问性标准 - 提取全局样式配置到统一变量 - 使用语义化颜色变量替换硬编码值 - 为输入框样式创建统一配置 * feat: add URL entry management components and QR code generation feature - Introduced `UrlEntryItem` and `UrlEntryList` components for displaying and managing URL entries. - Added `UrlToQrCodeSection` component for generating QR codes from URLs with download and copy functionality. - Implemented `AutoRefreshToggle`, `CleaningResult`, `DomainHeader`, `ErrorDisplay`, `OptionItem`, and `StorageOptionsGrid` components for enhanced user interface in storage cleaning. - Created custom hooks `useStorageCleaner` and `useStorageState` for managing storage-related states and preferences. - Added utility hook `useUrlPreferences` for handling URL entry preferences. * feat: 新增时间戳转换器和相关组件，优化时间戳页面功能 * Refactor message handling and storage cleaning logic * feat: 添加 GitHub Actions CI/CD 工作流，支持自动化构建与发布 * fix(background): 修复标签页刷新使用browser.tabs代替chrome.tabs style(popup): 调整QR码页面样式顺序 refactor(storage): 重构存储清理逻辑并移除useSnackbar依赖 style(confirm): 优化存储清理确认对话框的UI样式 chore: 更新.gitignore忽略.trae目录 * chore: 移除 workbuddy 相关文件并更新 gitignore * test: 更新 StorageCleanerConfirm 组件测试中的文本匹配
Testing Tools Browser Extension
这是一个基于 WXT 框架的浏览器扩展项目，提供实用的测试工具功能。
项目概述
Testing Tools 是一个轻量级的浏览器扩展，提供多种实用的测试工具功能。项目采用现代化的技术栈，包括 React 19、TypeScript 和 Material UI，并利用 WXT 框架简化浏览器扩展的开发流程。
功能特性
Dashboard 首页
- 卡片式工具展示
- 支持自定义工具排序和可见性
- 实时数据预览（时间戳等）
时间戳转换工具
- 实时显示当前时间戳（毫秒/秒可切换）
- 日期与时间戳之间的双向转换
- 支持多个时区（亚洲/上海、美洲/纽约、欧洲/伦敦）
- 一键复制转换结果
- 输入验证和错误提示
存储清理工具
- 自动读取当前域名
- 支持清理多种存储类型：
- localStorage
- sessionStorage
- IndexedDB
- Cookies
- Cache Storage
- Service Workers
- 可选择的清理类型（默认全选）
- 确认对话框防止误操作
- 清理结果统计
- 自动刷新页面选项
URL 工具
- 保存常用 URL 列表
- 快速打开保存的 URL
- 支持 URL 验证和安全检查
- 内置 URL 查看器（iframe 沙箱模式）
二维码工具
- URL 转二维码（生成器）
- 二维码转 URL（解析器）
- 支持上传二维码图片解析
- 生成的二维码可下载
- 一键复制转换结果
- 卡片式布局，节省空间
技术栈
- 框架: WXT (Web Extension Toolkit)
- 前端: React 19 + TypeScript
- UI 库: Material UI
- 日期处理: dayjs (含 UTC 和时区插件)
- 通信: @webext-core/messaging
- 存储: Chrome Storage API (类型安全封装)
- 二维码: qrcode (生成) + jsqr (解析)
- 测试: Vitest + Testing Library
项目结构
├── components/ # 可复用 UI 组件
│ ├── Button.tsx
│ ├── CopyButton.tsx
│ ├── GlobalSnackbar.tsx
│ ├── RouterContainer.tsx
│ ├── StorageCleanerConfirm.tsx
│ ├── ToolCard.tsx
│ └── TopBar.tsx
├── config/ # 路由配置
│ └── routes.ts # 页面路由定义
├── entrypoints/ # 浏览器扩展入口点
│ ├── popup/ # 扩展弹窗界面
│ │ ├── App.tsx
│ │ ├── main.tsx
│ │ └── pages/ # 页面组件
│ │ ├── DashboardPage.tsx
│ │ ├── OpenUrlPage.tsx
│ │ ├── OpenUrlViewerPage.tsx
│ │ ├── QrCodePage.tsx
│ │ ├── StorageCleanerPage.tsx
│ │ └── TimestampPage.tsx
│ ├── options/ # 选项页面
│ ├── sidepanel/ # 侧边栏
│ ├── background.ts # 后台脚本
│ └── content.ts # 内容脚本
├── providers/ # React Context providers
│ └── RouterProvider.tsx # 路由状态管理
├── types/ # TypeScript 类型定义
│ └── storage.d.ts
├── utils/ # 工具函数
│ ├── chromeStorage.ts
│ ├── clipboard.ts
│ ├── dayjs.ts
│ ├── messages.tsx
│ └── storageCleaner.ts
├── public/ # 静态资源
├── wxt.config.ts # WXT 配置文件
├── package.json
└── README.md
路由系统
项目实现了灵活的路由系统，支持：
- 页面导航: 在不同工具页面之间切换
- 路由同步: 通过 Chrome Storage 同步路由状态
- 可见性控制: 可配置显示哪些页面
- 页面排序: 自定义工具卡片的显示顺序
页面类型 (PageType)
| 页面 | 说明 | 默认可见 |
|---|---|---|
dashboard |
首页 | ✓ |
timestamp |
时间戳转换 | ✓ |
storageCleaner |
存储清理 | ✓ |
openUrl |
URL 工具 | ✓ |
qrCode |
二维码工具 | ✓ |
openUrlViewer |
URL 查看器 | ✗ |
扩展入口点
| 入口点 | 说明 |
|---|---|
| popup | 点击扩展图标弹出的界面 |
| options | 扩展选项页面 |
| sidepanel | 浏览器侧边栏 |
| background | 后台脚本（生命周期管理） |
| content | 内容脚本（注入到网页） |
开发环境要求
- Node.js >= 18
- npm 或 yarn
安装与运行
1. 安装依赖
npm install
2. 开发模式
# Chrome 浏览器
npm run dev
# Firefox 浏览器
npm run dev:firefox
3. 构建生产版本
# Chrome 浏览器
npm run build
# Firefox 浏览器
npm run build:firefox
4. 打包分发
# Chrome 浏览器
npm run zip
# Firefox 浏览器
npm run zip:firefox
5. 代码质量
npm run compile # TypeScript 类型检查
npm run lint # ESLint 代码检查
6. 测试
npm run test # 运行所有测试
npm run test:watch # 运行测试并监听文件变化
npm run test:coverage # 运行测试并生成覆盖率报告
持续集成与发布
项目使用 GitHub Actions 实现自动化 CI/CD，无需手动操作。
CI — 持续集成
在以下场景自动触发：
- push 到
main/develop/develop-*分支 - 所有 PR（合并到
main或develop）
自动执行：ESLint 检查 → TypeScript 类型检查 → 单元测试 → Chrome & Firefox 构建验证。
发布版本
只需推送符合 v* 格式的 Git tag，即可自动完成全量 CI 检查、打包并发布到 GitHub Release：
git tag v1.0.0
git push origin v1.0.0
含
-的 tag（如v1.0.0-beta.1）会自动标记为预发布版本（prerelease）。
工作流文件位于 .github/workflows/：
ci.yml— 持续集成release.yml— 自动发布
权限说明
扩展请求以下权限：
storage和unlimitedStorage- 本地数据存储clipboardWrite- 剪贴板写入（复制功能）activeTab,scripting,tabs- 当前标签页控制和脚本注入cookies- Cookie 访问sidePanel- 侧边栏支持<all_urls>- 访问所有网站内容（内容脚本注入）
主要依赖
react,react-dom- 前端框架@mui/material- UI 组件库dayjs- 日期处理@webext-core/messaging- 扩展消息通信vitest- 测试框架@testing-library/react- React 组件测试
浏览器兼容性
- Chrome (推荐)
- Firefox
许可证
此项目采用 MIT 许可证。详见 LICENSE 文件。