glimpseui

用系统原生 WebView 替代 Electron 或完整浏览器,为脚本和 Agent 提供可双向 JSON 通信的轻量微 UI 窗口。

安装命令
pi install npm:glimpseui
挂接事件钩子与注册入口
主要作为 Node 库与 ./skills 技能调用(非持续拦截 tool_call)
Node API open(html, options) 与 win.on("message" / "closed")页面内全局对象 glimpse.send(payload)窗口模式标志:frameless / floating / transparent / clickThrough / noDock / followCursor

1. 是什么

glimpseui(Glimpse)是 hazat 开源的跨平台原生微 UI 引擎。

它的体积和开销极小:不打包 Electron,也不强开外部完整浏览器标签页,直接用平台原生 WebView(macOS Swift + WKWebView、Linux Rust + GTK4/WebKitGTK 或零编译 Chromium CDP、Windows .NET 8 WebView2)打开独立小窗。

2. 解决什么问题

当 Agent 需要让用户填一个复杂配置表单、可视化看一张交互图表、或者在桌面角落放一个跟随光标的状态小圆环时,纯终端 TUI 画不出来,而起一个本地 HTTP 服务又太重且窗口管理松散。

3. 作用原理(事件钩子与工具注册层)

作为 Pi 技能包与 Node 原生桥接库分发,在需要界面交互时拉起原生子进程窗口并通过 stdin/stdout 双向 JSON Lines 协议传递数据。

  • 安装时 postinstall 钩子会按当前操作系统编译或准备对应的原生 WebView 桥接二进制文件(如果本地缺少编译工具链会发出警告并允许之后手动编译)。
  • 扩展或 Agent 脚本调用 open(html, options) 传入一段自包含的 HTML/CSS/JS,Glimpse 立即拉起对应尺寸的原生 WebView 窗口。
  • 前端 HTML 内用户点击或表单提交触发 window.glimpse.send(data),通过 stdout JSON Lines 实时回传给 Node/Pi 逻辑(win.on(“message”)),用完直接 win.close() 销毁。
  • 组合 frameless + transparent + floating + clickThrough + followCursor 参数还能做出不挡鼠标点击、随光标移动的桌面伴随状态浮窗(仓库内直接提供了 Pi 伴随状态胶囊示例)。

4. 怎么装与基本配置

  • 通过 pi install npm:glimpseui 安装后,Pi 会加载包内 ./skills,使 Agent 知道如何临时生成微 UI 弹窗与你交互。
  • 编译要求:macOS 需 Xcode Command Line Tools(swiftc);Linux 原生模式需 Rust + GTK4/WebKitGTK(或走 Chromium CDP 零编译路径);Windows 需 .NET 8 SDK。

5. 和同类怎么选

glimpseui 属于基础设施型的“微界面原语”,独立于固定的状态栏或仪表盘成品,适合用来解锁表单、预览图、悬浮伴随件等跨界交互。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
pi-webman pi-webman 是开箱即用的完整网页驾驶舱,监控整个 Pi 会话;glimpseui 是按需弹窗或悬浮微组件的底层原生窗口引擎。 需要全局看遥测与会话流选 pi-webman;想让 Agent 临时弹交互卡片或做桌面原生微窗选 glimpseui。

同方向对比包与顺序阅读

@heyhuynhgiabuu/pi-pretty

留守终端内部的全面视觉增强扩展:Shiki 语法高亮、树形 ls、内联图片预览、折叠工具输出与内嵌 FFF 检索。

阅读该包机制详评

pi-webman

零运行时依赖的 Pi 本地 Web 驾驶舱,为终端里正在运行的会话提供实时 SSE 对话流、遥测仪表盘与命令遥控。

阅读该包机制详评

09 终端 UI 与体验

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「glimpseui」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)