Pi-Web · Pi Agent Web UI 的 uTools 入口插件

一、插件定位
在 uTools 中为 Pi Coding Agent 本地 Web UI（pi-web，npm 包 @agegr/pi-web）提供一键入口。
无需记住端口、无需手动开终端——呼出 uTools 即用，退出自动回收，全程本机运行。

二、核心能力

1. 一键唤起，内嵌即用
搜索 "Pi Agent" / "Pi Web" / "Pi 控制台" 进入插件，自动启动本地服务（127.0.0.1:30141），
界面直接内嵌在插件窗口中；也可点顶部「新窗口打开」在独立窗口使用。
环境自适应：开发环境内嵌显示；受打包后平台限制的环境自动检测，提示引导新窗口打开（绝不自动弹窗）。

2. 环境检测与引导安装（首次使用）
进入自动检测三项环境：
- Node.js（要求 ≥ 22.19）
- pi-web（本地 Web UI，必需）
- pi 命令（可选，供终端独立使用）
缺失项一键安装：pi-web 安装到插件数据目录（不污染全局、无需管理员权限），
网络不佳可切换 npmmirror 镜像重试；Node.js 缺失引导下载安装。

3. 服务托管与可靠性
- 崩溃自动重启：服务异常退出自动重启，最多 3 次，指数退避（1s/2s/4s）
- 退出回收：插件退出后台服务保留（再次进入秒开）；插件进程销毁服务自动停止
- 进程树级清理：taskkill 进程树回收，不残留孤儿进程；清理前校验进程身份，防止误杀
- 端口复用：检测到已有 pi-web 服务在跑时直接复用，不重复启动

4. 检查更新与一键更新
顶部「检查更新」对比 pi-web / Pi CLI 的本地版本与 npm 最新版本，
有更新一键更新，pi-web 更新后自动重启服务使新版本生效。

5. 体验细节
- 日/夜双主题，跟随 uTools 主题自动切换
- 运行中可查看服务日志（滚动日志，1MB × 3）
- 服务地址在状态栏可点击，一键跳转浏览器
- 零依赖纯静态插件，体积小、无需构建

三、安全说明
- 服务仅监听 127.0.0.1，不对外网开放
- 安装/更新操作均在按钮确认后执行，执行前展示命令
- pi-web 数据（会话、模型配置）存于用户目录，与命令行版完全共享

四、适用场景
开发者日常使用 Pi Coding Agent 时，把 uTools 作为统一入口：
在 uTools 中搜索即用，退出即回收，无需手动管理服务进程。