feat: complete testing-tool browser extension with timestamp converter and storage cleaner

2025-11-11 01:07:43 +08:00
commit f4c2f6d374
42 changed files with 13902 additions and 0 deletions
@@ -0,0 +1,121 @@
+# 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. 安装依赖
+
+```bash
+npm install
+```
+
+### 2. 开发模式
+
+```bash
+# Chrome 浏览器
+npm run dev
+
+# Firefox 浏览器
+npm run dev:firefox
+```
+
+### 3. 构建生产版本
+
+```bash
+# Chrome 浏览器
+npm run build
+
+# Firefox 浏览器
+npm run build:firefox
+```
+
+### 4. 打包分发
+
+```bash
+# Chrome 浏览器
+npm run zip
+
+# Firefox
+npm run zip:firefox
+```
+
+### 5. 其他命令
+
+```bash
+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)，仅供内部使用。