🚀 QueryBox:一个为 AI 时代打造的 GraphQL 桌面客户端(Tauri + Rust)

220 阅读2分钟

基于 QueryBox 项目的实践,已经写了一系列文章,有兴趣可以先阅读:

现在,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 工具链

📷 应用截图

image.png

📦 项目开源地址

GitHub 项目地址: 👉 github.com/zhnd/query-…

欢迎大家试用、提建议、点个 ⭐ 支持一下,也非常欢迎提 Issue / PR / Feedback。