# minitools

**Repository Path**: lutery/minitools

## Basic Information

- **Project Name**: minitools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-30
- **Last Updated**: 2025-12-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MiniTools - 实用小工具集合

MiniTools 是一个轻量级的前端工具集合，提供多种实用的小工具，帮助开发者和技术人员快速完成日常任务。

## 🚀 功能特性

### 当前工具
- **FinalShell 密码解密** - 解密 FinalShell 保存的加密密码，支持校准版算法(参考：（https://blog.csdn.net/qq_34707272/article/details/148146445）)
- **Mermaid 渲染出图** - 在线编辑和渲染 Mermaid 图表，支持流程图、时序图、类图等

### 即将推出
- **二维码生成** - 快速将文本字符串转换为二维码图片
- mp4转mp3：多种音频转换工具
- 文件对比工具：md5 hash值等多种
- 更多实用工具正在开发中...

## 🛠️ 技术栈（待定）

- **前端框架**: Vue.js 3 + Composition API
- **构建工具**: Vite 5（快速构建和热更新）
- **UI 框架**: Element Plus 2.x
- **路由**: Vue Router 4
- **图表渲染**: Mermaid 9.4.3
- **图片处理**: html2canvas
- **部署**: 支持静态部署，兼容 Nginx 部署

## 📦 安装与使用

### 快速开始
1. 克隆项目到本地
   ```bash
   git clone https://gitee.com/lutery/minitools.git
   ```
2. 进入项目目录
   ```bash
   cd minitools
   ```
3. 安装依赖
   ```bash
   npm install
   ```
4. 启动开发服务器
   ```bash
   npm run dev
   ```
5. 在浏览器中打开 `http://localhost:5173` 使用工具

### 开发模式
基于 Vue.js 的现代开发体验：
- 使用 Vite 提供快速的开发服务器
- 支持热模块替换（HMR）
- 现代化的组件化开发
- 自动构建和打包优化

### 构建与部署
```bash
# 安装依赖
npm install

# 开发模式
npm run dev

# 生产构建
npm run build

# 预览构建结果
npm run preview
```

## 🔧 项目结构（待定）

```
minitools/
├── public/            # 静态资源
├── src/
│   ├── components/    # 公共组件
│   ├── views/        # 页面视图
│   │   ├── Home.vue        # 主页
│   │   ├── FinalShellDecrypt.vue  # FinalShell 密码解密
│   │   └── MermaidRender.vue      # Mermaid 渲染出图
│   ├── router/       # 路由配置
│   │   └── index.js
│   ├── utils/        # 工具函数
│   │   ├── finalshell-decrypt-accurate.js  # FinalShell 解密算法
│   │   ├── mermaid-render.js    # Mermaid 渲染辅助
│   │   ├── mermaid-history.js   # 历史记录管理
│   │   └── mermaid-templates.js # 图表模板
│   └── assets/       # 资源文件
├── dist/             # 构建输出目录
├── tests/                      # 单元测试
├── package.json      # 项目配置
└── vite.config.js    # Vite 配置
```

## 🎯 使用场景

- **开发者工具** - 快速处理开发过程中的小任务，绘制流程图和架构图
- **系统管理员** - 便捷的密码解密和工具集合
- **文档编写** - 生成专业的流程图、时序图等图表
- **学习参考** - 现代化的 Vue.js 项目架构示例

## 🚀 部署方案

### 静态部署
构建后的 `dist` 目录可以直接部署到任何静态文件服务器：
```bash
npm run build
# 将 dist 目录上传到服务器即可
```

### Nginx 部署
```nginx
server {
    listen 80;
    server_name your-domain.com;
    root /path/to/minitools/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # 启用 gzip 压缩
    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
}
```

### 其他部署选项
- **GitHub Pages** - 直接推送构建文件到 gh-pages 分支
- **Vercel / Netlify** - 一键部署，支持自动构建
- **Docker** - 使用 nginx:alpine 镜像容器化部署

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来改进项目！

1. Fork 项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📝 更新日志

### v1.1.0 (2025-12-06)
- ✨ 添加 Mermaid 渲染出图功能
  - 支持流程图、时序图、类图等多种图表类型
  - 实时预览和手动预览模式
  - 多主题支持和配置选项
  - 导出 PNG 和复制图片功能
  - 分享链接和历史记录
- 🐛 修复 Mermaid 渲染预览空白问题
- 🔧 优化配置响应性和错误处理

### v1.0.0 (2025-10-30)
- ✨ 初始版本发布
- ✨ 添加 FinalShell 密码解密功能

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## ⭐ 支持项目

如果这个项目对你有帮助，请给个 Star ⭐ 支持一下！

---

**注意**: 本项目仅供学习和合法用途使用，请勿用于任何违法活动。