做了一个轻量的 GraphQL 桌面客户端: QueryBox(Tauri + Rust 构建) - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
zhnd18
V2EX    分享创造

做了一个轻量的 GraphQL 桌面客户端: QueryBox(Tauri + Rust 构建)

  •  1
     
  •   zhnd18
    zhnd 112 天前 1402 次点击
    这是一个创建于 112 天前的主题,其中的信息可能已经有所发展或是发生改变。

    大家好,我最近开源了一个桌面 App ,叫 QueryBox ,是我用 Rust + Tauri 写的 GraphQL 请求客户端工具,目前已经实现基础功能,并在积极探索如何让 GraphQL 和 AI 更好地结合。


    背景:GraphQL + AI ,是天然适配的组合

    GraphQL 的最大优势之一,是它「自描述」的强类型 Schema 。

    这意味着你拿到一个 GraphQL 接口,不需要看文档、不需要猜字段名,只要有 schema ,就能:

    • 自动生成查询语句
    • 自动补全字段、变量、嵌套关系
    • 可视化字段关系、依赖、拓扑图
    • …这些其实都是 AI 很擅长的事情!

    但目前大多数 GraphQL 客户端工具(如 GraphiQL 、Insomnia 、Postman ):

    • 都是「手工驱动」的 自己查 schema ,自己拼 query
    • 不支持多 endpoint 管理,不方便调试复杂系统
    • 缺乏更现代的交互体验和智能辅助

    所以我做了 QueryBox 一个为 AI 时代准备的 GraphQL 请求工具链。


    技术栈

    • Rust + Tauri 2 构建桌面客户端(跨平台、高性能)
    • React + Tailwind CSS + shadcn/ui 构建前端
    • monaco-editor + monaco-graphql 实现智能编辑器
    • SQLite + SQLx 做数据存储
    • 后续支持 AI Agent 接入(基于 schema 自动生成 query )

    当前已实现功能( v0.1.1 )

    • 多 Endpoint 管理(新增 / 编辑 / 删除 / 切换)
    • 自动获取 GraphQL Schema (含 Basic Auth 支持)
    • Schema 文档预览(支持点击跳转类型)
    • Query 编辑器(智能高亮 + 历史记录)
    • 响应面板( Header / Body / 状态码 / 耗时)
    • 内置 Updater 、主题切换、CI 构建
    • 数据持久化到 SQLite

    接下来要做的事(重点是 AI 能力)

    • 内置 AI agent:一键生成 query / mutation
    • Schema 结构分析:生成拓扑图 + 实时导航
    • 自动提示字段、mock 数据、查询建议
    • 增加 RESTful 接口支持,统一 API 管理入口

    界面预览

    screenshot

    如果你习惯 GraphQL Explorer + Playground 工具链,那这个界面应该不陌生,但我们会更轻量、更智能。


    GitHub 开源地址

    https://github.com/zhnd/query-box

    欢迎试用、提建议、提 issue 、提 PR ,也非常欢迎点个 支持一下


    项目背后

    我是前端出身,非科班出身,自学 Rust 、Tauri 、数据库相关技术,想用这款 App 把自己对工具、智能交互和 API 工作流的理解落地,也作为一次完整的产品设计 + 技术实践。

    欢迎感兴趣的朋友交流、讨论。


    感谢看到这里,希望这个项目也能在未来给你带来一点点便利。

    项目地址再次放一遍: https://github.com/zhnd/query-box

    8 条回复    2025-07-16 14:20:57 +08:00
    chekun
        1
    chekun  
       112 天前
    Yaak 可以自动获取,目前在用,还行
    zhnd18
        2
    zhnd18  
    OP
       112 天前
    @chekun 是的,Yaak 我也关注过,功能确实不错,自动化体验做得挺用心
    QueryBox 这个项目主要是想简化使用逻辑,更专注在 GraphQL 和 AI 结合的方向,后续会持续探索像智能生成 query 、Schema 可视化、拓扑分析等能力。
    这也是我学习和实践的一部分,希望慢慢把它打磨成一个有趣又有用的工具
    chekun
        3
    chekun  
       112 天前
    @zhnd18 #2 嗯,加油~
    hugewilliam
        4
    hugewilliam  
       112 天前
    强啊,支持一下
    ssqygyddxfsh
        5
    ssqygyddxfsh  
       112 天前
    强啊,支持一下
    w2zsuperb
        6
    w2zsuperb  
       112 天前
    结合 AI 确实有一些想象空间,持续关注下
    zhnd18
        7
    zhnd18  
    OP
       112 天前
    @w2zsuperb 感谢关注
    zhnd18
        8
    zhnd18  
    OP
       91 天前
    在最新的 release v0.1.4 中,重构了 GraphQL 文档功能,现在可以:
    1. 完整的显示 operation 的参数和响应结构
    2. 废弃字段标识以及 reason 显示
    3. 更好的和 query editor 交互,在编辑器内可点击点选的字段,自动跳转到对应结构声明
    4. 基于高性能的初衷,优化 documention 的缓存计算逻辑,保证交互不卡顿。

    欢迎大家试用。
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5477 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 25ms UTC 07:13 PVG 15:13 LAX 00:13 JFK 03:13
    Do have faith in what you're doing.
    ubao snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86