# wechat_tools

**Repository Path**: liu-chichi/wechat_tools

## Basic Information

- **Project Name**: wechat_tools
- **Description**: 微信小程序集合工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-10
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工具百宝箱 - 微信小程序

一个功能丰富的微信小程序工具箱，提供计算器、图片处理、文字工具等12个实用工具。

## 项目特点

- ✅ **前后端分离**: Vue 3 + UniApp 前端 + FastAPI 后端
- ✅ **12个实用工具**: 涵盖计算、图片、文字三大类
- ✅ **AI功能**: 老照片上色、签名设计
- ✅ **完整功能**: 收藏、历史记录、分享
- ✅ **响应式设计**: 适配各种屏幕尺寸
- ✅ **易于部署**: 提供一键启动脚本

## 技术栈

### 前端
- **框架**: Vue 3 + UniApp
- **构建工具**: Vite
- **状态管理**: Pinia
- **UI组件**: uView Plus
- **样式**: SCSS

### 后端
- **框架**: FastAPI 0.104+
- **数据库**: MySQL 8.0
- **ORM**: SQLAlchemy 2.0
- **图片处理**: Pillow, OpenCV
- **Python**: 3.9+

## 功能列表

### 计算器类 (4个)
1. **房贷计算器** - 等额本息/等额本金计算
2. **个税计算器** - 2024年个人所得税计算
3. **单位换算** - 长度/重量/温度/面积/速度换算
4. **日期计算** - 怀孕计算器/倒计时/工作日计算

### 图片处理类 (4个)
5. **九宫格切图** - 图片分割为3x3网格
6. **文字水印** - 为图片添加文字水印
7. **老照片上色** - AI智能上色(需后端支持)
8. **表情包制作** - 制作搞笑表情包

### 文字工具类 (4个)
9. **简繁体转换** - 简体繁体互转
10. **火星文生成器** - 生成火星文字
11. **花样字体** - Unicode花样字体
12. **签名设计** - 艺术签名设计(需后端支持)

## 项目结构

```
微信小程序工具类/
├── frontend/                     # 前端代码
│   ├── src/                      # 源码
│   │   ├── api/                  # API客户端
│   │   │   ├── index.js
│   │   │   ├── colorize.js
│   │   │   └── signature.js
│   │   ├── components/           # 组件
│   │   ├── pages/                # 页面
│   │   ├── stores/               # 状态管理
│   │   ├── utils/                # 工具函数
│   │   └── styles/               # 样式
│   ├── package.json
│   ├── vite.config.js
│   └── start.sh                  # 前端启动脚本
│
├── backend/                      # 后端代码
│   ├── app/
│   │   ├── main.py              # FastAPI入口
│   │   ├── config.py            # 配置
│   │   ├── database.py          # 数据库
│   │   ├── models/              # 数据模型
│   │   ├── routers/             # API路由
│   │   ├── services/            # 业务逻辑
│   │   ├── schemas/             # 数据验证
│   │   └── utils/               # 工具函数
│   ├── uploads/                 # 上传文件
│   ├── outputs/                 # 处理结果
│   ├── fonts/                   # 字体文件
│   ├── requirements.txt
│   ├── .env
│   ├── init_db.sql
│   └── run.py
│
├── start_all.sh                 # 一键启动脚本
├── README.md                    # 项目文档
└── DEPLOYMENT.md                # 部署文档
```

## API文档

### 老照片上色

```bash
# 上传图片
POST /api/colorize/upload
Content-Type: multipart/form-data

# 查询状态
GET /api/colorize/status/{task_id}

# 获取结果
GET /api/colorize/result/{task_id}
```

### 签名设计

```bash
# 生成签名
POST /api/signature/generate
Content-Type: application/json
{
  "name": "张三",
  "style": "行书"
}

# 下载签名
GET /api/signature/download/{signature_id}
```

详细API文档: http://localhost:8000/docs

## 快速开始

### 前置要求

- Node.js 16.0+
- Python 3.9+
- MySQL 8.0+
- 微信开发者工具

### 一键启动

```bash
# 1. 克隆项目
git clone <your-repo-url>
cd 微信小程序工具类

# 2. 安装前端依赖
cd frontend
npm install
cd ..

# 3. 启动MySQL
brew services start mysql  # macOS
# 或
sudo systemctl start mysql  # Linux

# 4. 初始化数据库
mysql -u root -padmin123 < backend/init_db.sql

# 5. 一键启动所有服务
./start_all.sh
```

### 手动启动

详见 [DEPLOYMENT.md](./DEPLOYMENT.md)

### 访问应用

- **前端**: 在微信开发者工具中打开 `frontend/dist/dev/mp-weixin`
- **后端API**: http://localhost:8000
- **API文档**: http://localhost:8000/docs

## 核心功能

### 收藏功能
- 支持收藏常用工具
- 数据持久化到 localStorage
- 在收藏页快速访问

### 历史记录
- 自动记录工具使用历史
- 显示输入输出数据
- 最多保存50条记录
- 支持清空历史

### 分享功能
- 支持分享到微信好友
- 支持分享到朋友圈
- 生成分享图片

## 开发指南

### 添加新工具

1. 在 `frontend/src/pages/tools/` 创建工具页面
2. 在 `frontend/src/utils/` 添加工具函数
3. 在 `frontend/src/stores/toolStore.js` 注册工具
4. 在 `frontend/src/pages.json` 添加路由

### 添加新API

1. 在 `backend/app/routers/` 创建路由
2. 在 `backend/app/services/` 创建服务
3. 在 `backend/app/schemas/` 定义模型
4. 在 `backend/app/main.py` 注册路由
5. 在 `frontend/src/api/` 创建客户端

## 部署

### 开发环境

使用 `./start_all.sh` 一键启动

### 生产环境

详见 [DEPLOYMENT.md](./DEPLOYMENT.md)

主要步骤：
1. 配置服务器（Ubuntu/CentOS）
2. 部署MySQL数据库
3. 使用Gunicorn + Nginx部署后端
4. 构建并上传小程序
5. 配置SSL证书
6. 设置监控和备份

## 常见问题

### 数据库连接失败

```bash
# 检查MySQL状态
brew services list  # macOS
sudo systemctl status mysql  # Linux

# 检查配置
cat backend/.env
```

### 图片处理失败

```bash
# 检查OpenCV安装
python -c "import cv2; print(cv2.__version__)"

# 重新安装
pip install opencv-python
```

### 字体加载失败

```bash
# 下载字体文件到 backend/fonts/
# 或使用系统默认字体
```

更多问题请查看 [DEPLOYMENT.md](./DEPLOYMENT.md#常见问题)

## 许可证

MIT License

---

**开发愉快！** 🎉