agegr/pi-web

Pi Web – Pi coding-agent 的浏览器界面

简介 – Pi Web 是一个本地网页界面，让您可以使用 Pi coding-agent（一个用于代码的命令行 AI 助手）。它读取与 Pi CLI 相同的配置和会话文件，因此您可以从浏览器窗口中浏览、恢复和分支会话，管理模型凭证，并检查项目文件。

主要功能

会话工作区 – 按项目列出会话，查看使用统计（Token、成本、压缩），重命名、导出或删除会话，并从任何消息创建新分支。
文件浏览器 – 浏览会话所知的文件、上传新文件、查看 Git diff，并预览多种格式（Markdown、源代码、图片、音频、PDF、DOCX）并支持实时刷新。
Git 工作树支持 – 在不同的工作树检出之间切换，同时将会话按仓库分组。
配置面板 – 无需离开 UI 即可添加或编辑模型提供者、API 密钥、插件和技能。
多语言 UI – 支持英文、简体中文和繁体中文，并根据浏览器语言自动选择。

如何运行

配置与安全性

端口、主机名、空闲超时和密码保护可通过 CLI 标志或环境变量（PI_WEB_PASSWORD、PI_WEB_IDLE_TIMEOUT_MS 等）进行控制。
默认情况下，它仅绑定到 localhost；若要在网络上公开，需要强密码和用于 TLS 的反向代理。
UI 仅访问 Pi agent 已知的工作目录内的文件，而非整个文件系统。

开发 – 此仓库是一个使用 TypeScript 编写的 Next.js + React 应用程序。运行 npm install && npm run dev 以启动支持热重载的开发服务器。提供测试、类型检查和 Linting。

适用对象 – 任何使用 Pi coding-agent 并希望以更丰富、可视化的方式管理会话、文件和模型设置，而无需离开命令行的用户。

授权 – MIT。