glimpseui
用系统原生 WebView 替代 Electron 或完整浏览器,为脚本和 Agent 提供可双向 JSON 通信的轻量微 UI 窗口。
pi install npm:glimpseui 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。 |
看完「glimpseui」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。