# devtoolbox

**Repository Path**: arrowFish/devtoolbox

## Basic Information

- **Project Name**: devtoolbox
- **Description**: 纯AI开发：日常工具、命令合集
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-07
- **Last Updated**: 2026-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevToolbox · 开发者工具箱

一个**完全离线运行**的桌面开发者工具箱，基于 [Wails v2](https://wails.io/) + Vue3 构建。所有数据处理均在本地完成，不上传任何网络，适合日常开发、联调与排障。

---

## 功能特性

应用按功能分为「转换 / 格式化 / 生成 / 参考」四个分组，目前内置 **10 个可用工具 + 1 个规划中工具**。新增工具只需要在 `frontend/src/tools/registry.ts` 追加一条定义，左侧导航、路由、命令面板与快捷键会自动生效。

| 分组 | 工具 | 快捷键 | 能力 |
| --- | --- | --- | --- |
| 转换 | 时间戳转换 | `Ctrl+1` | Unix 时间戳 ↔ 日期时间互转、时区换算、时间差计算 |
| 转换 | 编解码 | `Ctrl+3` | Base64、URL、HTML 实体、Unicode、进制（2/8/10/16）互转 |
| 格式化 | JSON 工具 | `Ctrl+2` | 格式化、压缩、校验、YAML 互转、JSONPath 查询、树形视图 |
| 格式化 | XML 工具 | `Ctrl+4` | 格式化、压缩、校验、与 JSON 互转、树形视图 |
| 格式化 | 正则测试 | `Ctrl+5` | 实时匹配高亮、捕获组、替换测试、常用模板 |
| 格式化 | 文本处理 | `Ctrl+6` | 字数/行数统计、命名风格转换、去重排序、Diff 对比、Markdown 预览 |
| 生成 | UUID / ID | `Ctrl+7` | UUID v1/v4/v7、雪花 ID、NanoID、随机串批量生成 |
| 生成 | 哈希与加密 | `Ctrl+8` | MD5、SHA1/224/256/384/512、CRC32、HMAC，支持文件拖拽 |
| 生成 | 颜色工具 | `Ctrl+9` | HEX/RGB/HSL 互转、取色、调色板、对比度（WCAG）检测 |
| 参考 | Linux 命令 | `Ctrl+0` | 常用命令速查，支持搜索、分类浏览、收藏 |
| 参考 | HTTP 调试 | — | 接口调试工具（规划中，占位） |

### 通用能力

- **命令面板**：`Ctrl+K` 打开，支持按名称 / 说明 / 关键词模糊搜索并打分排序，快速跳转任意工具。
- **快捷键**：`Ctrl+1` ~ `Ctrl+0` 直达对应工具，`Ctrl+,` 打开设置，`Ctrl+Enter` 在编辑区一键复制 / 执行。
- **明暗主题**：支持深色 / 浅色 / 跟随系统，可自定义主题色、编辑区字号、紧凑模式。
- **历史记录**：各工具的操作输入可记录与回放（可在设置中开关、设置上限，默认 20 条，最多 200）。
- **设置持久化**：外观、默认行为、启动项等配置自动保存，下次启动恢复。
- **窗口记忆**：自动记住窗口尺寸与位置，支持最大化、置顶。
- **文件拖拽**：哈希工具支持把文件拖入窗口直接计算摘要。
- **离线优先**：纯本地桌面程序，无后端服务、无网络请求。

---

## 技术架构

- **后端**：Go + [Wails v2.12.0](https://wails.io/)，每个工具对应一个独立的 `internal/<tool>` 包，统一经 `api.go` 中的门面 struct（如 `TimestampAPI`）通过 Wails `Bind` 暴露给前端，前端调用形如 `window.go.main.TimestampAPI.FromTimestamp(...)`。
- **前端**：Vue 3（`<script setup>`）+ TypeScript + Vite 6 + Naive UI + Pinia + vue-router（hash 模式）。
- **内置资源**：前端构建产物 `frontend/dist` 通过 `//go:embed all:frontend/dist` 嵌入可执行文件；图标 `build/appicon.png` 通过 `//go:embed` 嵌入。
- **数据持久化**：本地 JSON，目录为 `os.UserConfigDir()/DevToolbox/`（`config.json` 配置、`history.json` 历史、`commands.json` 命令速查数据）。

```
devtoolbox/
├── main.go            # 程序入口、窗口与 Wails 配置、资源嵌入
├── api.go             # 暴露给前端的 API 门面（各工具 Service）
├── app.go             # 应用生命周期、事件绑定
├── wails.json         # Wails 工程配置（作者、版本、命令）
├── go.mod / go.sum    # Go 依赖
├── build/             # 构建资源（图标、Windows manifest、installer）
├── internal/          # 各工具后端实现（appcfg/cmdref/codec/colortool/...）
└── frontend/          # Vue3 + Vite 前端
    └── src/
        ├── tools/registry.ts   # 工具注册表（核心插件入口）
        ├── views/              # 各工具页面
        └── components/         # 侧边栏、命令面板、历史面板等
```

---

## 环境要求

- **Go**：1.25 及以上
- **Node.js**：18 及以上（含 npm）
- **Wails CLI**：`go install github.com/wailsapp/wails/v2/cmd/wails@latest`
- **WebView2 运行时**：Windows 平台通常需要（一般随 Microsoft Edge 预装；若缺失启动时会提示安装）

---

## 本地开发

```bash
# 1. 安装前端依赖
cd devtoolbox/frontend
npm install

# 2. 启动开发模式（自动编译前端并热重载，同时起一个 Go 后端）
cd devtoolbox
wails dev
```

`wails dev` 会启动 Vite 开发服务器并提供热重载；若想直接在浏览器中联调（调用 Go 方法），可访问 `http://localhost:34115`，在 DevTools 中即可调用后端接口。

---

## 编译构建

```bash
# 安装前端依赖（首次构建需要）
cd devtoolbox/frontend && npm install

# 构建可分发版本（默认平台）
cd devtoolbox
wails build
```

常用构建选项：

```bash
# 指定平台 / 架构
wails build -platform windows/amd64

# 生成 Windows 安装包（NSIS）
wails build -nsis

# 指定产物名称
wails build -o DevToolbox.exe

# 清理后重新生成前端再构建
wails build -clean
```

构建完成后，可执行文件位于 `build/bin/DevToolbox.exe`（Windows）。`wails build -nsis` 还会在 `build/bin` 下生成安装程序。

> 提示：前端构建脚本为 `npm run build`（即 `vite build`），类型检查可用 `npm run typecheck`（`vue-tsc --noEmit`），均由 `wails.json` 中的 `frontend:build` / 相关字段驱动。

---

## 使用说明

1. 运行 `DevToolbox.exe` 启动应用。
2. 左侧为分组导航栏；点击顶部搜索框或按 `Ctrl+K` 打开命令面板，输入关键词即可检索工具。
3. 在工具页输入内容，结果通常实时刷新；点击「复制」（`Ctrl+Enter`）可把结果写入剪贴板。
4. 按 `Ctrl+1` ~ `Ctrl+0` 可快速切换到对应工具，`Ctrl+,` 打开设置页。
5. 设置页可调整主题（深 / 浅 / 跟随系统）、主题色、字号、紧凑模式、默认时区、缩进风格、哈希输出大小写、自动复制、历史开关与上限、启动行为等，所有修改即时保存。
6. 哈希工具可直接把文件拖入窗口进行计算。

---

## 数据存放位置

| 内容 | 路径 |
| --- | --- |
| 配置 | `%APPDATA%/DevToolbox/config.json` |
| 历史记录 | `%APPDATA%/DevToolbox/history.json` |
| 命令速查数据 | 程序内 `internal/cmdref/data/commands.json` |

`%APPDATA%` 即 `os.UserConfigDir()`（Windows 下通常为 `C:\Users\<用户名>\AppData\Roaming`）。

---

## 许可证

[MIT](./LICENSE) © 2026 arrowFish