# mytools

**Repository Path**: gxwang/mytools

## Basic Information

- **Project Name**: mytools
- **Description**: 我的工具集合
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-25
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MyTools 小工具集合

个人常用工具集合，前后端分离。

## 部署

服务器一体化部署（Docker）见 [DEPLOY.md](DEPLOY.md)。

## 项目结构

- `mytools-web/`：前端（Vue 3 + Vite），开发端口 5173
  - 证件照处理、JSON / XML / SQL 格式化、常用 SQL 命令、URL 编码解码、图片 Base64 转换
- `MyToolsApi/`：后端（ASP.NET Core，.NET 10），端口 5051
  - 证件照处理接口（OpenCvSharp）、SQL 速查条目存储

## 本地运行

```bash
# 后端
cd MyToolsApi && dotnet run

# 前端
cd mytools-web && npm install && npm run dev
```

## 高校数据库接入

高校数据库位于本仓库 `universities_database/` 子目录（Python FastAPI + Vue 3），前后端独立运行，以链接形式接入：

- 其前端端口为 **5174**（与本项目 5173 错开，可同时运行），首页「高校数据库」卡片新窗口跳转 `http://localhost:5174`
- 一键启动两套服务：`./start.sh`（仅本项目 `./start.sh --mytools-only`，仅高校数据库 `./start.sh --uni-only`，项目路径不同时用 `UNI_DIR=/path/to/universities_database ./start.sh` 指定）

## Linux 下编译 OpenCvSharp 原生库

证件照处理依赖 OpenCvSharp。官方 `OpenCvSharp4.runtime.linux-x64` 包（最新 4.10，针对 Ubuntu 20.04 构建）在 Deepin 25 等新发行版上因系统库版本不匹配无法加载，需本机编译：

```bash
# 1. 安装 OpenCV 开发包（Deepin 25 / Debian 系）
sudo apt-get install -y libopencv-dev libopencv-contrib-dev

# 2. 下载 OpenCvSharp 源码（选择与系统 OpenCV 版本一致的标签，如 4.6）
git clone --depth 1 --branch 4.6.0.20220608 https://github.com/shimat/opencvsharp.git

# 3. Debian 系裁剪了 nonfree 的 xfeatures2d 模块，需排除：
#    - 注释 src/OpenCvSharpExtern/include_opencv.h 中的 #include <opencv2/xfeatures2d.hpp>
#    - 移走 src/OpenCvSharpExtern/xfeatures2d.cpp / xfeatures2d.h

# 4. 编译并放入项目
cd opencvsharp/src/OpenCvSharpExtern && mkdir -p build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release && make -j$(nproc)
cp libOpenCvSharpExtern.so ~/codes/mytools/MyToolsApi/nativelibs/
```

编译产物放在 `MyToolsApi/nativelibs/`（已加入 .gitignore），csproj 会自动将其复制到输出目录，Program.cs 启动时显式预加载。Windows 下无需此步骤，仍使用 NuGet 的 win 运行时包。