# 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**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 开发工具集 (Dev Tools)

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

## 主要特性

- 📋 **JSON 格式化与验证** - 格式化、压缩、转义/反转义、树形查看
- ⏰ **时间转换器** - Unix 时间戳与日期转换、多时区支持
- 🔤 **大小写转换** - 支持驼峰、蛇形、帕斯卡等多种命名约定
- 🔐 **Base64 编码/解码** - Base64 标准编码/解码
- 🖼️ **图片转换** - 图片与 Base64 互转、格式识别、预览
- 🖥️ **跨平台应用** - 支持 Windows、macOS、Linux 等多个平台
- 🎨 **深色/浅色主题** - 支持主题切换，配置持久化

## 快速开始

### 环境要求

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

### 安装依赖

```bash
npm install --prefix frontend
```

### 本地开发

```bash
wails dev
```

### 项目结构

```
dev-tool2/
├── main.go                          # Go 主入口，Wails v3 应用创建
├── app.go                           # AppService，所有导出方法注册
├── internal/
│   ├── domain/                      # 核心业务逻辑（每个工具一个子目录）
│   │   ├── jsonfmt/                 # JSON 格式化
│   │   ├── timeconv/                # 时间转换
│   │   ├── caseconv/                # 大小写转换
│   │   ├── base64tool/              # Base64 编解码
│   │   └── imageconv/               # 图片转换
│   ├── adapter/registry.go          # 工具注册器
│   └── port/                        # 端口接口定义
├── config/                          # 用户配置管理
├── frontend/
│   ├── src/
│   │   ├── components/              # Vue 组件
│   │   │   └── common/              # 共享组件（ToolActions、DualEditor 等）
│   │   ├── utils/theme.js           # 主题状态管理
│   │   ├── plugins/vuetify.js       # Vuetify 配置
│   │   └── main.js                  # 前端入口
│   ├── bindings/                    # Wails v3 自动生成绑定
│   └── package.json
├── build/                           # 构建相关文件
└── docs/                            # 文档
```

## 构建打包

```bash
wails build          # 构建当前平台
wails build -m       # macOS
wails build -w       # Windows
wails build -all     # 全部平台
```

### 构建 RPM 包（Linux）

前置依赖：

```bash
sudo dnf install rpm-build
```

构建并打包：

```bash
wails3 task linux:package
```

产出路径：`~/rpmbuild/RPMS/x86_64/dev-tool-<version>-<release>.x86_64.rpm`

安装与卸载：

```bash
sudo dnf install ~/rpmbuild/RPMS/x86_64/dev-tool-*.rpm   # 安装
sudo dnf remove dev-tool                                    # 卸载
```

## 工具详解

### 📋 JSON 格式化器
- 格式化 JSON 并美化打印（支持 2/4/8 空格缩进）
- JSON 压缩（移除所有空白）
- 添加/取消转义
- 可折叠 JSON 树形查看器

### ⏰ 时间转换器
- Unix 时间戳与可读日期互转
- 多时区转换支持（15 个常用时区）
- RFC3339 格式支持
- 一键获取当前时间

### 🔤 大小写转换器
- camelCase（驼峰命名）
- snake_case（蛇形命名）
- PascalCase（帕斯卡命名）
- kebab-case（短横线连接）
- UPPERCASE（全大写）
- 空格分隔文本

### 🔐 Base64 编码解码器
- 标准编码/解码模式切换
- 实时编解码
- 示例数据加载

### 🖼️ 图片转换器
- 图片导入并转 Base64
- Base64 文本转图片预览
- 自动识别图片格式（PNG/JPEG/GIF/WebP）
- 显示图片尺寸和大小信息

## 技术栈

| 技术          | 版本            | 说明     |
|-------------|---------------|--------|
| **Go**      | 1.26+         | 后端开发语言 |
| **Wails**   | v3 (alpha.74) | 桌面应用框架 |
| **Vue**     | 3.5+          | 前端框架   |
| **Vuetify** | 4.x           | UI 组件库 |
| **Vite**    | 8.x           | 前端构建工具 |

## 开发建议

### 代码风格
- Go 代码：遵循标准 Go 风格，使用 `gofmt -w .` 格式化
- Vue 组件：使用 `<script setup>` 语法，纯 JavaScript
- 通知提示：统一使用 `Notification.vue`（v-snackbar），不使用 `v-alert`

### 测试
```bash
go test ./...                          # 运行所有测试
go test ./internal/domain/xxx/...      # 运行单个工具测试
```

### 构建前检查
```bash
go test ./...
gofmt -w .
npm install --prefix frontend
```

## 如何添加新工具

1. 在 `internal/domain/` 下创建新子目录，实现 `service.go`、`types.go`、`service_test.go`
2. 实现 `port.Tool` 接口（`Meta()` 和 `Handle()` 方法）
3. 在 `internal/adapter/registry.go` 中注册新工具
4. 在 `app.go` 中添加导出方法
5. 运行 `wails dev` 自动生成前端绑定
6. 在 `frontend/src/components/` 创建对应的 Vue 组件

## 许可证

Copyright © 2026, koryfan