$ cat ~/map/pi-web.md

Pi Web

Pi 的本地网页界面：在浏览器中浏览会话、实时聊天并管理技能。

tools✓ 10月16日

事实速查

安装

npx @agegr/pi-web@latest

## 速览

pi 的本地浏览器界面，直接复用 pi 自己的配置与会话文件——在浏览器里浏览和恢复会话、执行 agent 轮次、管理模型与技能、查看项目文件。

$会话工作台：按项目分组浏览、恢复、重命名、导出和删除会话，每个会话可见运行状态、上下文占用、成本与压缩详情。
$两种分支方式：新会话从历史消息生成独立会话文件；从这里编辑在当前会话内开分支。
$项目文件工具：浏览和上传文件、查看 Git diff、预览源码、Markdown、图片、音频、PDF 与 DOCX；侧栏可直接切换 Git worktree。
$网页端配置：provider 登录与 API key、模型、模型测试、插件包与技能都在界面里管理，与 pi 共享凭据存储。
$需要 Node.js 22.19.0+；默认监听 127.0.0.1:30141。界面支持英文、简体中文与繁体中文。

Q 能直接用我现有的 pi 会话吗？

能。Pi Web 从 ~/.pi/agent 读取 pi 数据（可用 PI_CODING_AGENT_DIR 覆盖），已有的会话、模型与凭据全部沿用——Models 面板用的就是 pi 自己的存储。

Q 可以远程访问吗？

默认只绑定 127.0.0.1。绑定 0.0.0.0 会暴露一个可高权限执行的 agent，务必在可信内网设置 PI_WEB_PASSWORD（HTTP Basic Auth，用户名 pi），并前置 HTTPS 或 VPN——绝不要用明文 HTTP 暴露到公网。

Q 怎么换端口运行？

pi-web --port 8080（或 PORT 变量）；--hostname/-H 或 PI_WEB_HOSTNAME 改绑定地址，--no-open 跳过自动开浏览器。