Testing Tools Browser Extension

这是一个基于 WXT 框架的浏览器扩展项目，提供时间戳转换工具。

项目概述

Testing Tools 是一个轻量级的浏览器扩展，提供实用的时间戳转换功能。项目采用现代化的技术栈，包括 React 19、TypeScript 和 Material UI，并利用 WXT 框架简化浏览器扩展的开发流程。

功能特性

时间戳转换工具

• 实时显示当前时间戳（毫秒/秒可切换）
• 日期与时间戳之间的双向转换
• 支持多个时区（亚洲/上海、美洲/纽约、欧洲/伦敦）
• 一键复制转换结果
• 输入验证和错误提示

技术栈

• 框架: WXT (Web Extension Toolkit)
• 前端: React 19 + TypeScript
• UI 库: Material UI
• 日期处理: dayjs (含 UTC 和时区插件)
• 通信: @webext-core/messaging
• 存储: Chrome Storage API (类型安全封装)

项目结构

├── entrypoints/         # 浏览器扩展入口点
│   ├── popup/           # 扩展弹窗界面（时间戳转换页面）
│   ├── options/         # 选项页面
│   ├── background.ts    # 后台脚本
│   └── content.ts       # 内容脚本
├── utils/              # 工具函数（存储、日期处理、消息通信）
├── types/              # TypeScript 类型定义
├── public/             # 静态资源
├── wxt.config.ts       # WXT 配置文件
├── package.json        # 项目依赖和脚本
└── README.md           # 项目说明文档

开发环境要求

• 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 代码检查

权限说明

扩展请求以下权限：

• storage 和 unlimitedStorage - 本地数据存储
• clipboardWrite - 剪贴板写入（复制功能）
• activeTab, scripting, tabs - 当前标签页控制和脚本注入
• debugger - 调试器权限
• <all_urls> - 访问所有网站内容（内容脚本注入）

主要依赖

• react, react-dom - 前端框架
• @mui/material - UI 组件库
• dayjs - 日期处理
• @webext-core/messaging - 扩展消息通信

贡献指南

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建 Pull Request

许可证

此项目为私有项目 (private: true)，仅供内部使用。