# multi_tool_website

**Repository Path**: Ylih433/multi_tool_website

## Basic Information

- **Project Name**: multi_tool_website
- **Description**: 工具箱
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 万能工具箱

一站式在线工具集合，免费、快速、无需登录。基于 Vue 3 + FastAPI 构建，Docker 一键部署。

## 功能列表

### 常用工具
| 工具 | 说明 |
|------|------|
| 文字转语音 | 基于 Edge TTS，支持中英日韩多语种、10+ 音色、语速音量调节 |
| 文件压缩 | JPG/PNG/WebP/GIF/PDF 在线压缩，可调压缩质量，支持批量 |
| 文件转换 | Word/PPT/Excel/PDF/Markdown/图片(含HEIC)等 20+ 格式互转，支持批量 |
| PDF 合并/拆分 | 多个 PDF 合并为一个，或按页拆分为多个，支持多图合 PDF |
| 去水印 | PDF/Word/图片水印去除，支持指定水印文字或自动检测，支持批量 |

### 文本工具
| 工具 | 说明 |
|------|------|
| JSON 工具 | 格式化、压缩、校验、JSON→YAML 转换 |
| 文本处理 | 字数统计、去重、大小写转换、排序、反转、去空行 |
| 编码转换 | Base64/URL 编解码、SHA-256 哈希生成 |

### 图片工具
| 工具 | 说明 |
|------|------|
| 图片处理 | 缩放、加水印、旋转 |
| 拼图工具 | 多张图片合并拼接，支持横向/纵向/网格布局 |
| 二维码 | 生成二维码（自定义尺寸）、识别二维码 |

### 实用工具
| 工具 | 说明 |
|------|------|
| 时间工具 | 实时时钟、时间戳↔日期互转 |
| 颜色工具 | 取色器、HEX/RGB/HSL 格式互转、预设色板 |

## 技术栈

- **前端**：Vue 3 + Vue Router + Vite + Axios
- **后端**：FastAPI + Uvicorn
- **核心依赖**：edge-tts、Pillow、pillow-heif、PyMuPDF、python-docx、python-pptx、openpyxl、reportlab、qrcode
- **部署**：Docker + Docker Compose

## 快速开始

### Docker 部署（推荐）

```bash
git clone https://gitee.com/Ylih433/multi_tool_website.git -b develop
cd multi_tool_website
docker compose up -d --build
```

服务启动后访问 `http://localhost:3007`

### 本地开发

**后端**

```bash
pip3 install -r requirements.txt
python3 server.py
```

**前端**

```bash
cd frontend
npm install
npm run dev
```

前端 `http://localhost:3000`，后端 `http://localhost:8000`，Vite 已配置 API 代理。

**一键启动**

```bash
./start.sh
```

## 项目结构

```
multi_tool_website/
├── server.py              # FastAPI 主入口
├── routers/               # 后端路由模块
│   ├── tts.py             # 文字转语音
│   ├── compress.py        # 文件压缩
│   ├── convert.py         # 文件转换
│   ├── watermark.py       # 去水印
│   ├── qrcode_tool.py     # 二维码
│   ├── image_tool.py      # 图片处理
│   └── collage.py         # 拼图
├── frontend/              # Vue 3 前端
│   ├── src/
│   │   ├── App.vue        # 主布局（侧边栏 + 路由）
│   │   ├── router.js      # 路由配置
│   │   └── views/         # 各工具页面
│   └── vite.config.js
├── requirements.txt       # Python 依赖
├── CHANGELOG.md           # 更新日志
├── Dockerfile             # 多阶段构建（腾讯云镜像加速）
├── docker-compose.yml     # 容器编排
└── start.sh               # 本地一键启动脚本
```

## 部署配置

默认端口 `3007`，修改 `docker-compose.yml` 中的 ports 即可更换：

```yaml
ports:
  - "80:8000"   # 改为 80 端口
```

## 分支说明

| 分支 | 用途 |
|------|------|
| `master` | 稳定版本 |
| `develop` | 开发分支，最新功能 |

## 许可

仅供学习交流使用。