简体中文 | English

一个用 Rust 打包成 单文件可执行程序 的本地开发者工具箱：启动后自动在浏览器打开，内置 18 款常用开发工具，无需安装额外依赖，开箱即用。除 DNS 解析需向系统 DNS 服务器发起查询外，其余处理全部在本机完成，不上传数据、无遥测。

• 后端：Axum 0.8 + Tokio，静态资源通过 rust-embed 直接嵌入二进制
• 前端：Svelte 5 + Vite 6 + TypeScript
• 构建：cargo build 触发 build.rs，自动用 bun 构建前端产物并嵌入

• 单文件分发：一个可执行文件即可运行，前端资源已打包进二进制，无运行时依赖
• 本地优先：默认仅监听 127.0.0.1，可切换 0.0.0.0 供同网段访问；数据不出本机
• 自动打开浏览器：启动后自动唤起默认浏览器，可用 --no-browser 关闭
• 端口自动顺延：默认端口被占用时，自动向后尝试最多 20 个端口
• Rust 承担重活：DNS 解析、图片格式转换、JSON 互转 / Schema / 查询等计算交给后端处理

# 默认监听 127.0.0.1:8927，并自动打开浏览器
./dev-tools

# 常用参数
./dev-tools --port 9000            # 指定端口（被占用时自动顺延，最多 +20）
./dev-tools --host 0.0.0.0         # 允许同网段访问
./dev-tools --no-browser           # 启动后不自动打开浏览器
./dev-tools --help                 # 查看全部参数

前置依赖：

• Rust（stable，edition 2021）
• Bun：用于构建前端。若未安装，cargo build 会跳过前端构建并写入占位页。

# 克隆并构建 release 版本
git clone https://github.com/zzhtl/dev-tools.git
cd dev-tools
cargo build --release

# 产物位置
./target/release/dev-tools

在 web/ 目录下可用 Vite 开发服务器独立调试前端：

cd web
bun install
bun run dev       # 启动 Vite 开发服务器
bun run build     # 构建到 ../dist（供 rust-embed 嵌入）
bun run check     # svelte-check 类型检查

Cargo 构建脚本 build.rs 会监听 web/src、web/public 等目录的变更；正常情况下直接 cargo build 即可自动完成前端构建与资源嵌入。修改前端后需重新构建以重新嵌入产物。

dev-tools/
├── src/                # Rust 后端
│   ├── main.rs         # 入口：CLI 解析、端口绑定（自动顺延）、启动 axum
│   ├── server.rs       # 路由组装（/api/* 与静态资源回退）
│   ├── cli.rs          # clap 参数定义（--port / --host / --no-browser）
│   ├── assets.rs       # rust-embed 静态资源服务
│   └── handlers/       # 后端 API 处理器
│       ├── error.rs    # 共享 AppError（携带 HTTP 状态码）
│       ├── json.rs     # /api/json/{convert,schema,query}
│       ├── dns.rs      # /api/dns/resolve
│       └── image.rs    # /api/image/convert
├── web/                # Svelte 5 前端
│   ├── src/App.svelte  # 侧边栏分类与工具路由
│   └── src/tools/*     # 各工具独立模块
├── build.rs            # Cargo 构建脚本：驱动 bun 构建并嵌入产物
└── Cargo.toml

所有接口前缀为 /api，前端在需要时将计算委托给 Rust 处理：

最新构建产物见 GitHub Releases。

Apache-2.0