# iotdb-client

**Repository Path**: hongzezhi/iotdb-client

## Basic Information

- **Project Name**: iotdb-client
- **Description**: iotdb 客户端
- **Primary Language**: Rust
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
  
# ⚡️ IoTDB Client Engine

**下一代高性能 Apache IoTDB 桌面客户端**

[![Tauri](https://img.shields.io/badge/Tauri-FFC131?style=for-the-badge&logo=Tauri&logoColor=white)](https://tauri.app/)
[![Rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=rust&logoColor=white)](https://www.rust-lang.org/)
[![Apache IoTDB](https://img.shields.io/badge/Apache_IoTDB-E36C09?style=for-the-badge&logo=apache&logoColor=white)](https://iotdb.apache.org/)
[![License](https://img.shields.io/badge/License-MIT-blue.style=for-the-badge)](LICENSE)

[English](README_EN.md) | **简体中文**

</div>

---

## 📖 简介 (Introduction)

**IoTDB Client Engine** 是一款基于 `Tauri` 和 `Rust` 构建的现代化、轻量级 Apache IoTDB 桌面管理工具。
它摒弃了传统 Electron 应用臃肿的体积，以极低的内存占用和原生级别的响应速度，为物联网开发者提供极致的时序数据查询、管理和分析体验。

无论你是进行日常的数据排查、复杂的 SQL 编写，还是需要快速的可视化条件过滤，本工具都能帮你极速完成。我们甚至引入了 **AI 推理引擎**，让时序数据库的探索变得前所未有的智能！

---

## 📸 界面预览 (Preview)

![IoTDB Client Engine Screenshot](./docs/images/screenshot.jpg) ---

## ✨ 核心特性 (Key Features)

* 🚀 **极致性能**: 底层采用 Rust 编写，结合 Tauri 框架，启动极快，内存占用不到传统客户端的十分之一。
* 🔌 **便捷连接管理**: 
    * 支持快速配置 Host, Port, Username, Password。
    * 一键 `CONNECT & LOAD`，实时感知数据库在线状态 (`ONLINE`/`OFFLINE`)。
* 🔍 **可视化条件构造器 (Visual Query Builder)**:
    * **精准时间范围**: 原生支持通过日历/时间组件快速选择时间范围，告别繁琐的 Timestamp 转换。
    * **动态过滤**: 一键添加/移除查询条件（`添加条件`）。
    * **排序控制**: 支持灵活的数据排序，例如一键设为最新优先 (`DESC`)。
* 💻 **极客 SQL 控制台 (SQL Editor)**:
    * 提供代码高亮体验的 SQL 编辑区。
    * 支持**保存常用 SQL** (`保存此 SQL`)，构建属于你自己的查询代码片段库。
    * 一键执行 (`EXECUTE SQL`)，响应迅速。
* ⚡ **时序专属功能**:
    * 深度整合 IoTDB 特性，内置 `查看最新 (LAST)` 查询快捷入口。
* 🤖 **AI 赋能 (AI Inference)**:
    * 内置 `AI 推理` 模块，可用自然语言辅助生成复杂的时序查询 SQL，或对查询结果进行趋势分析（*前沿探索功能*）。
* 🎨 **现代化暗黑 UI**: 专为极客和长期盯屏幕的开发者设计的护眼暗色主题，界面排版科学，信息层级分明。

---

## 🛠️ 技术栈 (Tech Stack)

* **应用框架**: [Tauri](https://tauri.app/)
* **后端核心**: [Rust](https://www.rust-lang.org/) 🦀
* **前端界面**: Vue 3 / React (根据你实际使用的填写) + TypeScript + Vite
* **目标数据库**: [Apache IoTDB](https://iotdb.apache.org/)

---

## 🚀 快速开始 (Getting Started)

### 前置要求
确保你的开发环境中已安装以下工具：
* [Node.js](https://nodejs.org/) (推荐 v18+)
* [Rust](https://www.rust-lang.org/tools/install) (建议最新稳定版)
* 构建 Tauri 所在操作系统的[原生依赖](https://tauri.app/v1/guides/getting-started/prerequisites)

### 本地开发运行

1. 克隆本仓库
```bash
git clone [https://github.com/yourusername/iotdb-client-engine.git](https://github.com/yourusername/iotdb-client-engine.git)
cd iotdb-client-engine