# tools

**Repository Path**: php_project/tools

## Basic Information

- **Project Name**: tools
- **Description**: 常用工具，如时间戳转换，二维码生成，密码生成
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-26
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 在线工具集 - 多功能实用工具平台

一个现代化的在线工具集合，提供图片压缩、JSON格式化、二维码生成、密码生成、URL编码等实用功能。所有工具完全免费，无需注册，直接在浏览器中使用。

## ✨ 功能特性

### 🖼️ 图片压缩工具
- 支持 JPG、PNG、GIF、WebP 等常见图片格式
- 可调节压缩质量（10%-100%）
- 自动优化图片尺寸（最大宽度1920px）
- 实时预览压缩效果
- 显示压缩前后文件大小对比
- 一键下载压缩后的图片

### 📝 JSON格式化工具
- 美化JSON格式，提高可读性
- 压缩JSON，减小文件大小
- JSON格式验证，快速发现错误
- 支持文件上传和下载
- 一键复制到剪贴板
- 语法高亮显示

### 🔲 二维码生成器
- 支持文本、URL、邮箱、电话等多种内容
- 可自定义二维码尺寸（200-600px）
- 4种纠错级别可选（L/M/Q/H）
- 一键下载PNG格式
- 支持复制到剪贴板
- 实时预览生成效果

### 🔐 密码生成器
- 可自定义密码长度（4-64位）
- 支持大写字母、小写字母、数字、特殊字符
- 密码强度实时评估
- 一键复制密码
- 安全随机生成算法

### 🔗 URL编码/解码工具
- URL编码：将中文和特殊字符转换为URL安全格式
- URL解码：还原编码后的URL
- 实时转换，无需点击按钮
- 支持一键复制
- 提供使用示例

### 📝 Base64 编码/解码工具
- Base64 编码：将文本转换为 Base64 格式
- Base64 解码：还原 Base64 编码的文本
- 支持中文和特殊字符
- 实时转换，一键复制
- 提供使用示例

### 🔐 MD5 加密工具
- MD5 哈希加密：生成 32 位十六进制字符串
- 单向加密，不可逆
- 实时生成，一键复制
- 常用于密码存储、文件校验等场景

### 🛡️ 签名生成与验证工具
- 支持多种 HMAC 算法（SHA256、SHA512、SHA1、MD5）
- 生成数字签名
- 验证签名有效性
- 确保数据完整性和真实性
- 适用于 API 接口签名、数据完整性验证等场景

### ⏰ 时间戳转换工具
- Unix 时间戳转日期时间
- 日期时间转 Unix 时间戳
- 支持秒级（10位）和毫秒级（13位）时间戳
- 实时显示当前时间和时间戳
- 支持多种日期格式（ISO 8601、标准格式等）
- 一键复制结果

### 📊 文本统计工具
- 统计字符数（含/不含空格）
- 统计单词数、行数、段落数、句子数
- 统计字节数
- 实时统计，无需点击按钮
- 清晰的数据展示

### 🆔 UUID 生成器
- 生成符合 UUID v4 标准的唯一标识符
- 支持批量生成（1-100个）
- 一键复制单个或全部 UUID
- 适用于数据库主键、API 请求 ID 等场景

### 🎨 颜色值转换工具
- HEX、RGB、HSL 颜色格式相互转换
- 颜色预览功能
- 颜色选择器
- 一键复制颜色值
- 适用于前端开发和设计场景

### 🔐 SHA 加密工具
- 支持 SHA256、SHA512、SHA1、SHA3 算法
- 实时加密，一键复制
- 适用于密码存储、数据完整性验证等场景

### 🔤 文本大小写转换
- 支持多种转换格式：
  - 大写、小写
  - 标题格式、句子格式
  - 驼峰命名、帕斯卡命名
  - 蛇形命名、短横线命名
- 实时转换，一键复制
- 适用于代码命名规范转换

## 🚀 快速开始

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run dev
```

应用将在 `http://localhost:3000` 启动

### 构建生产版本

```bash
npm run build
```

### 预览生产构建

```bash
npm run preview
```

## 🛠️ 技术栈

- **React 18** - 用户界面框架
- **Vite** - 快速构建工具
- **React Router** - 路由管理
- **QRCode** - 二维码生成库
- **Lucide React** - 图标库
- **纯CSS** - 现代化样式设计

## 📦 项目结构

```
po1/
├── src/
│   ├── tools/           # 工具组件
│   │   ├── ImageCompressor.jsx
│   │   ├── JsonFormatter.jsx
│   │   ├── QRCodeGenerator.jsx
│   │   ├── PasswordGenerator.jsx
│   │   ├── UrlEncoder.jsx
│   │   └── ToolStyles.css
│   ├── App.jsx          # 主应用组件
│   ├── App.css          # 应用样式
│   ├── main.jsx         # 入口文件
│   └── index.css        # 全局样式
├── index.html           # HTML模板
├── package.json         # 项目配置
├── vite.config.js       # Vite配置
└── README.md           # 项目文档
```

## 🎨 设计特点

- **现代化UI设计** - 简洁美观的用户界面
- **响应式布局** - 完美适配桌面和移动设备
- **流畅动画** - 优雅的交互动画效果
- **深色友好** - 优化的颜色方案，保护眼睛
- **快速加载** - 轻量级代码，快速响应

## 💡 使用场景

- **开发者** - JSON格式化、URL编码、密码生成
- **设计师** - 图片压缩、二维码生成
- **普通用户** - 日常工作中的各种实用工具需求

## 💰 广告集成

本项目已集成广告系统，支持流量变现：

- **Google AdSense 支持** - 集成 Google AdSense 广告
- **自定义广告支持** - 支持联盟营销、直接广告等
- **多位置广告** - 顶部、底部、侧边栏、内容中等位置
- **响应式设计** - 自动适配桌面和移动端
- **灵活配置** - 通过配置文件轻松管理

详细配置说明请查看：[广告集成指南](./docs/广告集成指南.md)

### 快速配置广告

1. 编辑 `src/config/ads.config.js`
2. 填写你的 AdSense Client ID 和广告位 ID
3. 或配置自定义广告 HTML
4. 在 `index.html` 中添加 AdSense 脚本（如使用 AdSense）

## 🔒 隐私安全

- 所有处理都在浏览器本地完成
- 不会上传任何数据到服务器
- 完全免费，无需注册
- 开源透明，可自行部署

## 📝 许可证

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📧 联系方式

如有问题或建议，欢迎通过 Issue 反馈。

---

**享受使用！** 🎉