# itools

**Repository Path**: iotxiaohu/itools

## Basic Information

- **Project Name**: itools
- **Description**: 面向 Windows 的一个工具集, 包括串口调试助手, 网络调试助手, mqtt调试助手等
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  <img src="public/icon.png" alt="iTools Logo" width="96" />

  <h1>iTools</h1>

  <p>面向 Windows 的串口、网络与 MQTT 调试助手。</p>

  <p>
    <img src="https://img.shields.io/badge/platform-Windows%2010%20%7C%2011-0078D4?logo=windows" alt="Windows 10/11" />
    <img src="https://img.shields.io/badge/Tauri-2-24C8DB?logo=tauri&logoColor=white" alt="Tauri 2" />
    <img src="https://img.shields.io/badge/Vue-3-42B883?logo=vuedotjs&logoColor=white" alt="Vue 3" />
    <img src="https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript&logoColor=white" alt="TypeScript 5" />
  </p>

  <p>
    <a href="https://gitee.com/iotxiaohu/itools/releases">下载</a>
    ·
    <a href="#主要功能">功能</a>
    ·
    <a href="#本地开发">开发</a>
  </p>
</div>

---

iTools 将常用的设备与网络调试能力集中在一个桌面应用中，适合嵌入式开发、物联网联调和协议排查。连接配置与发送偏好保存在本机，运行时密码、串口和临时对端不会写入配置文件。

## 下载与安装

前往 [Releases](https://gitee.com/iotxiaohu/itools/releases) 下载最新的 Windows 安装包并运行。

- 支持 Windows 10/11，目前发布流程生成 x64 NSIS 安装包。
- 应用启动时会静默检查更新，也可以在“关于”页手动检查。
- 新版本下载前会保存当前配置，安装包会使用内置 minisign 公钥验证。

## 主要功能

- **串口调试**：选择串口与波特率，配置数据位、校验位和停止位。
- **TCP 客户端**：连接远端 TCP 服务并进行双向收发。
- **TCP 服务端**：监听本地端口、查看在线客户端并选择发送目标。
- **UDP 调试**：绑定本地地址，记录对端并向指定地址发送数据。
- **MQTT 调试**：支持 MQTT 3.1.1/5.0、TCP/WebSocket、TLS、订阅、QoS 与保留消息。
- **收发辅助**：多发送槽、定时发送、HEX 输入、校验和、编码切换、方向与时间戳显示。
- **本地配置**：自动保存非敏感连接参数和界面偏好。
- **应用内更新**：自动或手动检查新版本，展示下载进度并完成升级安装。

## 快速上手

1. 从左侧选择串口、TCP 客户端、TCP 服务端、UDP 或 MQTT。
2. 填写连接参数并连接设备或服务。
3. 在下方发送区填写文本或 HEX 数据，按需设置定时发送与校验方式。
4. 在通信区查看收发内容、字节数和帧数。
5. 在“设置”查看应用与更新策略，在“关于”检查新版本。

## 本地开发

### 环境要求

- Windows 10/11
- Node.js 18+ 与 npm 9+
- Rust stable
- Microsoft C++ Build Tools

Tauri 的完整系统依赖请参考 [Tauri prerequisites](https://v2.tauri.app/start/prerequisites/)。

```powershell
git clone https://gitee.com/iotxiaohu/itools.git
cd itools
npm install
npm run tauri dev
```

### 常用命令

| 命令 | 说明 |
| --- | --- |
| `npm run tauri dev` | 启动桌面应用开发模式 |
| `npm run build` | 执行 Vue/TypeScript 检查并构建前端资源 |
| `cargo test --manifest-path src-tauri/Cargo.toml` | 运行 Rust 测试 |
| `npm run tauri build` | 构建 Windows NSIS 安装包与更新签名 |
| `npm run test:release` | 运行发布脚本测试 |

## 项目结构

```text
itools/
├─ src/                 # Vue 前端、工具面板与更新交互
├─ src-tauri/           # Rust 通信能力与 Tauri 配置
├─ scripts/             # 签名发布、Gitee Release 与清单测试
├─ public/              # 静态资源
└─ README.md
```

## 参与贡献

欢迎通过 [Issues](https://gitee.com/iotxiaohu/itools/issues) 报告问题或提出建议，也欢迎提交 Pull Request。提交前请确保 `npm run build`、`npm run test:release` 和相关 Rust 测试通过。