pi-webman
零运行时依赖的 Pi 本地 Web 驾驶舱,为终端里正在运行的会话提供实时 SSE 对话流、遥测仪表盘与命令遥控。
安装命令
pi install npm:pi-webman 临时试用 / 替代安装命令
pi -e npm:pi-webman 挂接事件钩子与注册入口
session_start / session_shutdown / session_info_changedagent_start / agent_end / agent_settledturn_start / turn_endmessage_start / message_update / message_endtool_execution_start / tool_execution_update / tool_execution_endmodel_select / thinking_level_selectsession_before_compact / session_compact / session_compact_failedsession_tree / ui_prompt_start / ui_prompt_end
pi.registerCommand("/web" / "/webman" / "/web-session")pi.registerFlag("--web" / "--web-port" / "--web-host" / "--web-token" / "--web-open")ctx.ui.setStatus() / notify()(页脚显示 ◈ WEB :4747) 1. 是什么
pi-webman(Pi // Cockpit)是 steelburn 开发的零第三方依赖本地 Web UI 扩展。
它在你终端正常跑 Pi 时同步开启本地 HTTP + SSE 服务(默认 127.0.0.1:4747),把会话实时镜像并遥控到浏览器里。
2. 解决什么问题
在多步骤复杂任务中,纯终端屏幕很难同时看清上下文压力环、缓存 token、费用流速、完整推理过程、各工具耗时及彩色 diff,也不方便在大量工具和模型间快速检索切换。
3. 作用原理(事件钩子与工具注册层)
仅用 Node 内置模块启动本地 Web 服务,订阅全量 Pi 生命周期事件并通过 Server-Sent Events(SSE)实时推送到前端驾驶舱,同时双向桥接控制与弹窗。
- 通过 /web(或启动参数 —web)拉起本地 Web 服务;页面打开或断线重连时先拉取完整会话快照,随后通过 SSE 持续接收助手文本、隐藏推理块与工具卡片(含输入、输出、耗时和彩色 diff)。
- 页面顶部与遥测区实时汇总上下文容量环、输入/输出/缓存 token、推理 token、预估费用、吞吐速率和任务计时。
- 控制面支持直接从浏览器发送、steer 或 follow-up 消息、中断运行、切换模型/thinking 级别、压缩上下文以及 Ctrl/Cmd+K 命令面板;同时具备弹窗桥接(Extension popups),可以把其他扩展在终端弹出的交互转发到浏览器模态框完成。
4. 怎么装与基本配置
- 运行 pi install npm:pi-webman 安装,进入 Pi 后执行 /web open 即可启动服务并打开浏览器。
- 如要通过非本机环回接口(—web-host)访问,务必配置 —web-token 或环境变量 PI_COCKPIT_TOKEN 启用认证。
- 支持在 /reload 后自动恢复驾驶舱服务,无需重新手动打开。
5. 和同类怎么选
在终端 UI 与体验方向里,pi-webman 主打“浏览器零依赖大屏驾驶舱”;glimpseui 主打“轻量原生 OS 微窗口”;pi-pretty 则留在纯终端内部升级渲染。
与同类方案的选型对照
聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。
| 对比对象 | 机制差异 | 怎么选 |
|---|---|---|
glimpseui | glimpseui 定位为可编程的原生系统 WebView 弹窗引擎,用来给脚本或扩展画自定义小窗口或悬浮指示器,有别于完整的会话驾驶舱。 | 想要现成的会话监控与遥控网页选 pi-webman;自己写扩展或脚本需要弹出原生小组件选 glimpseui。 |
pi-studio(方向 05) | pi-studio 偏向双栏浏览器工作区、主动测验与 tmux REPL;pi-webman 偏向随终端会话伴生的遥测 HUD 与实时控制面板。 | 主力仍留在终端编码、把浏览器当作副屏仪表盘时选 pi-webman。 |
看完「pi-webman」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。