# dev-tools

**Repository Path**: phpfan/dev-tools

## Basic Information

- **Project Name**: dev-tools
- **Description**: 开发者工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-28
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 开发工具集 (Dev Tools)

一个功能全面的开发者工具集应用，使用 Wails、Vue 3 和 Go 构建。提供多种常用的开发工具，帮助开发者快速完成日常任务。

## 主要特性

- 📋 **JSON 格式化与验证** - 格式化、验证和美化 JSON 数据
- 🗄️ **SQL 转 Go 结构体** - 自动将 SQL 表结构转换为 Go 代码
- ⏰ **时间转换器** - Unix 时间戳与日期转换、多时区支持
- 🔤 **大小写转换** - 支持驼峰、蛇形、帕斯卡等多种命名约定
- 🔐 **Base64 编码/解码** - Base64 编码解码、URL 安全编码
- 📅 **Crontab 工具** - Crontab 表达式生成和解析
- 🖥️ **跨平台应用** - 支持 Windows、macOS、Linux 等多个平台
- 💎 **现代响应式界面** - 优雅的用户界面、深色/浅色主题支持

## 快速开始

### 环境要求

- **Go** 1.23+
- **Node.js** 16+ 及 npm/yarn
- **Wails CLI**: `go install github.com/wailsapp/wails/v2/cmd/wails@latest`

### 安装依赖

```bash
# 安装 Go 和前端依赖
npm install --prefix frontend
```

### 本地开发

启动开发服务器（支持热更新）：

```bash
wails dev
```

该命令会启动：
- Vue 3 + Vite 前端开发服务器（通常在 http://localhost:5173）
- Go 后端 API 服务（本地开发端口）

浏览器会自动打开应用，修改代码后会立即热更新

### 项目结构

```
dev-tool2/
├── frontend/               # Vue 3 前端应用
│   ├── src/
│   │   ├── components/    # Vue 组件（各工具模块）
│   │   ├── utils/         # 工具函数
│   │   ├── assets/        # 静态资源
│   │   ├── App.vue        # 根组件
│   │   ├── main.js        # 入口文件
│   │   └── style.css      # 全局样式
│   ├── package.json       # npm 依赖配置
│   └── vite.config.js     # Vite 配置
├── tools/                 # Go 后端核心逻辑
│   ├── json_formatter.go  # JSON 格式化工具
│   ├── sql_to_go.go       # SQL 转 Go 工具
│   ├── time_converter.go  # 时间转换工具
│   ├── case_converter.go  # 大小写转换工具
│   ├── base64.go          # Base64 编码解码
│   ├── crontab.go         # Crontab 工具
│   ├── state_manager.go   # 状态管理
│   └── *_test.go          # 单元测试
├── config/                # 应用配置
│   ├── config.go          # 配置文件处理
│   └── appinfo.go         # 应用信息
├── main.go                # Go 主入口
├── app.go                 # 应用逻辑
├── go.mod & go.sum        # Go 依赖管理
├── wails.json             # Wails 项目配置
└── build/                 # 构建相关文件
    ├── appimage/          # AppImage 打包脚本
    ├── darwin/            # macOS 构建配置
    └── windows/           # Windows 构建配置
```

## 构建打包

### Linux (AppImage 格式)

构建可移植的 Linux 应用：

```bash
# 首次构建需要进行一次性设置
./build/appimage/setup.sh

# 构建 AppImage
wails build
```

**输出位置：** `bin/Dev_Tools-1.0.1-x86_64.AppImage`

详细的 Linux 构建说明请参考 [build/appimage/README.md](build/appimage/README.md)

### macOS

```bash
wails build -m
```

### Windows

```bash
wails build -w
```

### 构建全部平台

```bash
wails build -all
```

## 项目配置

主要项目配置位于 `wails.json`：

```json
{
  "name": "Dev Tools",
  "outputfilename": "dev-tool",
  "author": {
    "name": "范钟",
    "email": "phpfan@yeah.net"
  },
  "info": {
    "companyName": "Dev Tools",
    "productName": "Dev Tools",
    "productVersion": "1.0.1",
    "copyright": "Copyright © 2024, 范钟"
  },
  "linux": {
    "package": "AppImage",
    "desktopFile": "build/dev-tool.desktop",
    "icon": "build/appicon.png"
  }
}
```

完整的 Wails 配置文档：https://wails.io/docs/reference/project-config

## 发布分发

### Linux AppImage 格式

AppImage 格式的优势：
- ✅ 单文件可执行程序
- ✅ 兼容所有 Linux 发行版本
- ✅ 无需安装即可使用
- ✅ 支持桌面集成
- ✅ 便于分发和部署

详细信息请参考 [build/appimage/README.md](build/appimage/README.md)

## 工具详解

应用包含的各项工具，每个工具都可以独立启用/禁用配置。

### 📋 JSON 格式化器 (JSON Formatter)
**快速格式化和验证 JSON 数据**
- 格式化 JSON 并进行美化打印（支持自定义缩进）
- 实时 JSON 验证和错误检测
- 支持 JSON 压缩（移除所有空白）
- 支持可折叠的 JSON 树形查看器

### 🗄️ SQL 转 Go 结构体 (SQL to Go Struct)
**将数据库表结构自动转换为 Go 代码**
- 从 SQL DDL 语句智能生成 Go 结构体
- 自动类型映射（SQL 类型 → Go 类型）
- 生成结构体标签（struct tags）
- 自动生成注释说明

### ⏰ 时间转换器 (Time Converter)
**进行时间戳和日期转换**
- Unix 时间戳与可读日期互转
- 多时区转换支持
- 支持多种日期格式输出
- 显示当前时间和时区信息

### 🔤 大小写转换器 (Case Converter)
**支持多种编程命名约定转换**
- camelCase（驼峰命名）
- snake_case（蛇形命名）
- PascalCase（帕斯卡命名）
- kebab-case（短横线连接）
- UPPERCASE（大写）
- 空格分隔文本

### 🔐 Base64 编码解码器 (Base64)
**处理 Base64 编码和解码**
- Base64 标准编码/解码
- URL 安全编码/解码
- 二进制数据支持
- 实时编解码

### 📅 Crontab 工具
**Crontab 表达式生成和解析**
- 可视化生成 Crontab 表达式
- 解析并说明 Crontab 语法
- 计算下次执行时间

## 技术栈

| 技术           | 版本     | 说明         |
| -------------- | -------- | ------------ |
| **Go**         | 1.23+    | 后端开发语言 |
| **Wails**      | v2.10.2+ | 桌面应用框架 |
| **Vue**        | 3.x      | 前端框架     |
| **Vite**       | 最新     | 前端构建工具 |
| **TypeScript** | 最新     | 前端类型支持 |

## 开发建议

### 代码风格
- Go 代码：遵循标准的 Go 风格指南
- Vue 组件：使用 `<script setup>` 语法
- 类名和函数命名：遵循各语言的约定

### 测试
- 在 `tools/` 目录下为每个工具编写 `*_test.go` 单元测试
- 运行测试：`go test ./tools/...`

### 构建前检查
```bash
# 运行所有测试
go test ./...

# 代码格式化
gofmt -w .

# 安装依赖
npm install --prefix frontend
```

## 许可证

Copyright © 2024, 范钟

## 反馈与支持

- 如有问题或建议，欢迎提出反馈
- 查阅项目文档了解更多详情
- 各个工具的具体使用方法可参考相应的代码注释

## 常见问题

### 如何添加新的工具？
1. 在 `tools/` 目录下创建新的 `tool_name.go` 文件
2. 实现工具的核心逻辑
3. 在 `frontend/src/components/` 创建对应的 Vue 组件
4. 在 `app.go` 中注册新的工具方法
5. 在侧边栏中添加导航入口

### 开发时遇到热更新失效？
- 检查 `wails dev` 命令输出
- 确保前端依赖已安装：`npm install --prefix frontend`
- 尝试终止进程后重新启动开发服务器

### 如何修改应用主题？
- 主题配置位于 `frontend/src/utils/theme.js`
- 在组件中使用 `ThemeToggle.vue` 进行主题切换