基于 QueryBox 项目的实践,已经写了一系列文章,有兴趣可以先阅读:
- QueryBox:现代化智能 GraphQL 请求工具 🚀
- # 深入解析 QueryBox 的架构设计 🛠️
- # 使用 Zustand 优化 React 状态管理:性能与持久化实践
- # Codegen 加速开发:从数据结构到模版代码
现在,QueryBox 的基础功能已正式 Release 🎉,在这里也正式向大家介绍这个项目及未来规划。
🧭 为什么做这个项目?
在日常使用 GraphQL 的过程中,我常常会遇到这些问题:
- GraphiQL 太简陋,只能做基础操作;
- Postman / Insomnia 太重、启动慢、不适合日常频繁请求;
- 想多端点切换、管理历史、补全字段或 mock 数据时几乎无解;
- 而 AI 其实天然可以和 GraphQL 结合,提升效率,但工具链却没跟上。
于是我决定自己动手,构建一款现代化的 GraphQL 请求工具,基于 Rust + Tauri + React,打造属于自己的桌面应用:QueryBox。
🌐 GraphQL + AI 是天然适配的组合
GraphQL 的 schema 是强类型、结构化的,它就像一份完整的 API 说明书。
这让它非常适合被 AI 理解与操作:
- 🤖 自动生成 query/mutation
- ✍️ 智能补全字段、参数
- 🔍 自动理解类型结构,文档导航
- 📊 基于 schema 自动生成拓扑图、依赖关系图
- 🧪 甚至可以 mock 数据用于测试
QueryBox 就是为此而生 —— 不是简单的请求客户端,而是一个连接 GraphQL 与智能能力的入口。
🧰 技术选型
- 桌面框架: Tauri 2(Rust + Webview,支持 macOS / Windows / Linux)
- 主语言: Rust(后端逻辑 + 数据存储)
- UI 框架: React + Tailwind CSS + shadcn/ui
- 编辑器: CodeMirror + monaco-graphql
- 数据存储: SQLite + SQLx
- 构建与更新: Tauri Updater + GitHub Release
- 未来 AI 能力: 计划接入 OpenAI / Claude 等 Agent
✨ 已实现功能(v0.1.1)
- ✅ 多 Endpoint 管理(新增 / 编辑 / 删除 / 快速切换)
- ✅ Schema 自动获取(支持带 Basic Auth 认证)
- ✅ Schema 文档查看(点击字段跳转类型定义)
- ✅ GraphQL Query 编辑器(支持高亮、历史记录)
- ✅ 响应面板(Header、Body、状态码、耗时)
- ✅ 自动检测 Endpoint 可用性
- ✅ 持久化数据存储(所有 Endpoint / 历史记录等保存在 SQLite)
- ✅ 内置更新机制(Tauri Updater)
- ✅ 支持浅色 / 深色主题切换(自动跟随系统)
🧠 正在规划中的功能(重点是 AI)
下一阶段将是「智能增强」模块接入!
- 🤖 一键生成 query/mutation(基于 Schema + AI)
- 🔎 智能提示参数 / 类型 / 示例值
- 🧠 Schema 结构分析:生成拓扑图 / 关系图
- 🔁 自动 mock 数据返回(辅助前端联调)
- 📦 增加 REST API 请求能力,形成统一 API 工具链
📷 应用截图
📦 项目开源地址
GitHub 项目地址: 👉 github.com/zhnd/query-…
欢迎大家试用、提建议、点个 ⭐ 支持一下,也非常欢迎提 Issue / PR / Feedback。