# @gang-of-beads/pi-web 中文文档 规范地址：https://npmcn.com/package/%40gang-of-beads/pi-web/ 版本：2\.202611\.1 npm 元数据更新时间：2026-11-15T08:16:12.354Z 中文译文更新时间：2026-11-15T22:36:57.320Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40gang-of-beads/pi-web 原文对照：https://npmcn.com/package/%40gang-of-beads/pi-web/?lang=original 项目主页：https://github.com/Gang-of-Beads/pi-web 源码仓库：https://github.com/Gang-of-Beads/pi-web ## 关键信息（来自 npm 元数据） - 包体积（解压后）：16.7 MB，901 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22\.19\.0 - 运行依赖：27 个 - peer 依赖：@earendil-works/pi-ai ^1\.5\.2，@earendil-works/pi-tui ^1\.5\.2，@earendil-works/pi-agent-core ^1\.5\.2，@earendil-works/pi-coding-agent ^1\.5\.2 - 首次发布：2026-09-01T17:08:04.234Z - 最新版本发布：2026-11-15T08:16:11.630Z - 近 30 天下载量：4490（2026-10-16 至 2026-11-14，npm 官方下载统计） - 已发布版本数：70（近 12 个月 70 个） ## 中文简介 Web UI用于在真实工作空间中持续进行 Pi 编码代理会话. ## 安装 ```sh npm install @gang-of-beads/pi-web ``` 也可以使用：`pnpm add @gang-of-beads/pi-web`、`yarn add @gang-of-beads/pi-web`、`bun add @gang-of-beads/pi-web` ## README # PI WEB (英语) 页:1 [简体中文](https://npmcn.com/package/%40gang-of-beads/pi-web/README.zh-CN.md) [![Release](https://github.com/Gang-of-Beads/pi-web/actions/workflows/publish.yml/badge.svg)](https://github.com/Gang-of-Beads/pi-web/actions/workflows/publish.yml) [![npm version](https://img.shields.io/npm/v/@gang-of-beads/pi-web)](https://www.npmjs.com/package/@gang-of-beads/pi-web) [![Node.js](https://img.shields.io/node/v/@gang-of-beads/pi-web)](https://npmcn.com/package/%40gang-of-beads/pi-web/package.json) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://npmcn.com/package/%40gang-of-beads/pi-web/LICENSE) **PI WEB 是一个网络用户界面 [Pi 编码代理](https://github.com/earendil-works/pi/tree/main/packages/coding-agent) 使代理会话在机器或服务器上运行.** 运行您的代码、 工具、 证书和缓存所在的代理 。 从任何浏览器中监督它们. ![PI WEB](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/assets/pi-web-banner.png) [https://github.com/user-attachments/assets/21ae3e58-6706-4108-afca-5fa4e265104a 互联网档案馆的存檔,存档日期2014-12-20](https://github.com/user-attachments/assets/21ae3e58-6706-4108-afca-5fa4e265104a) ![PI WEB on a desktop: sessions, a conversation and the project's files](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/assets/pi-web-desktop.png) ![The session board on a phone](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/assets/pi-web-mobile.png) ![The Go to menu on a phone](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/assets/pi-web-mobile-goto.png) ![A conversation on a phone in Material Light](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/assets/pi-web-mobile-light.png) _电话:会话板"去菜单"和"光"主题的对话._ ## 为什么是PIWEB? 当工作环境持续时,代理发展效果更好。 PI WEB让你: - 在浏览器断开后保持 Pi 编码代理会话的活性; - \* 在真正的仓库和工作地内经营特工; - 平行监督若干会议; - 手提电脑、电话、平板电脑和桌面之间的切换; - 使用服务器、工作站或远程 dev 框作为代理运行时间; - 管理一个网络用户界面的项目、工作空间、文件、终端、会话和其他机器; - 将您的 Pi 设置带回原样: Pi 包、 扩展、 技能和快捷模板负载在每次会话中, 扩展对话框、 通知和部件会在浏览器中显示( )[PI WEB 下的 Pi 扩展](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/pi-extensions.md)(三); - 以 [PI WEB 插件](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/plugins.md): 页面、动作、标签、主题和文本渲染器,可选服务器的一半; 文件、 Git、终端和目标被捆绑插件,并且像任何 Pi 软件包一样安装更多; - 在不同地点跨机工作:将你的家用服务器、工作站、笔记本电脑和云德夫盒放入一个Tailscale尾网,并加入一个PI WEB页面([机器](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/machines.md)在 HTTPS 上打开每个设备 [纹章服务](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#remote-access)而不打开一个端口 互联网。 您的电话、平板电脑和笔记本电脑可以远程到达相同的会话:在您的办公桌开始一个任务,然后从您的电话中跟踪并回答. 您的浏览器是控制表面 。 工作还是能继续运转的 见 [远程第一发展](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/remote-first.md)。 。 。 . ## 快开始 所需经费: - 登入壳上的节点22.19.0或更新和npm `PATH` 并且能够 `npm install -g` 无 `sudo`; 见 [所需资源](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#requirements) nvm 和分发包 - Pi 编码代理 1. 5.2 或更新, 为您的用户配置 - git 和您的代理工具所需的开发工具; 在 Linux 上, 也有 python3, make 和一个 C++ 编译器( 例如) `build-essential`),npm用于建造终端 - Linux 或 macOS 有用户服务管理器( 系统或启动), Windows 10 或 11( 用户计划任务) , 或 [Android 上的 Termux 软件](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#termux-android) (临时服务) ### 建议设置 运行PI WEB与"Beads之帮"预设在您的代码所在的机器上,用"Tailscale Service"发布到您的尾网,并从您的手机中使用. 1. 安装 PI WEB 作为用户服务, 并配备代理工具和网络插件 [红蜂帮预设](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#gang-of-beads-preset)数字 : ```bash curl -fsSL https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/install.sh | sh -s -- --preset gang-of-beads ``` 在 Linux 服务器上, 也运行 `sudo loginctl enable-linger "$USER"` 因此,服务持续运行 在您登录后. 在Windows上,在PowerShell中运行此选项: ```powershell $env:PI_WEB_PRESET = "gang-of-beads"; irm https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/install.ps1 | iex ``` 2. 发布到您的尾网 [纹章服务](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#remote-access) (MagicDNS和HTTPS证书启用). PI WEB 保持回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回 ```bash tailscale serve --bg --https=8504 http://127.0.0.1:8504 ``` 3. 在你的手机上,注册到同一个尾网,打开 `https://..ts.net:8504` 并把它添加到家用屏幕上 **共享 – 添加到家用屏幕**) (中文(简体) ). 它作为一个应用程序打开: [在 iPhone 或 iPad 上安装](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#install-on-iphone-or-ipad)。 。 。 . PI WEB独自一人,没有预设: ```bash curl -fsSL https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/install.sh | sh ``` 在 Windows 上,在 PowerShell ([窗口](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#windows) 详细情况: ```powershell irm https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/install.ps1 | iex ``` 然后打开 [http://127.0.0.1:8504 (中文(简体) )](http://127.0.0.1:8504/),或作为步骤2发布. npm, Nix, 主管理器, Docker, 通过 Pi, WSL 和手动运行安装 : 见 [安装指南](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md)。 。 。 . 每天的命令 : ```bash pi-web status pi-web logs pi-web restart pi-web doctor pi-web version pi-web uninstall ``` ## 核心模式 ```text Machine a PI WEB runtime: the one you opened, or another one you added Project a folder on that machine Workspace a working folder of the project: the project folder, or with Git, each worktree Session a Pi Coding Agent chat running inside a workspace ``` 一个典型的流程:添加一个工程,选择一个工作空间或 git worktree,开始一个会话,让代理工作,然后从任何浏览器返回. ## 警卫 PI WEB没有用户账户,并假定可以信任的用户,寄存器和服务器路径;它不是一个沙盒或多用户平台. 保留在本地主机、私人网络、SSH隧道或经认证的倒置代理上,绝不直接在公共互联网上;可选 [访问令牌](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md#require-an-access-token) 增加第二层. 见 [警卫](https://npmcn.com/package/%40gang-of-beads/pi-web/SECURITY.md) 威胁模式以及如何报告脆弱性. ## 文档 - [安装](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/install.md):要求,安装选项,服务,更新,远程访问 - [配置](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/config.md): 配置文件、 密钥、 环境变量、 重新启动规则 - [机器](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/machines.md): 使用一页的多台 PI WEB 机 - [远程第一发展](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/remote-first.md) - [插件](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/plugins.md): PI WEB 插件和 Pi 套件 - [FAQ 和解决问题](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/faq.md) 与 PI WEB 一起维护的插件和软件包 : [文件/插件.md](https://npmcn.com/package/%40gang-of-beads/pi-web/docs/plugins.md#packages)。 。 。 . ## 捐款 见 [捐款额](https://npmcn.com/package/%40gang-of-beads/pi-web/CONTRIBUTING.md) 用于开发设置,检查和拉动请求预期. ## 许可证 麻省理工学院 2026"Beads帮"撰稿人. 见 [自由主义](https://npmcn.com/package/%40gang-of-beads/pi-web/LICENSE) 财务报告和审定财务报表 [通知](https://npmcn.com/package/%40gang-of-beads/pi-web/NOTICE)。 。 。 . ## 常见问题 ### @gang-of-beads/pi-web 是什么？ Web UI用于在真实工作空间中持续进行 Pi 编码代理会话\. ### 如何安装 @gang-of-beads/pi-web？ 在项目目录运行 npm install @gang-of-beads/pi-web，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@earendil-works/pi-ai（^1\.5\.2）、@earendil-works/pi-tui（^1\.5\.2）、@earendil-works/pi-agent-core（^1\.5\.2）、@earendil-works/pi-coding-agent（^1\.5\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 pi-web、pi-web-server、pi-web-sessiond，可以用 npx pi-web 直接运行。 ### @gang-of-beads/pi-web 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @gang-of-beads/pi-web 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @gang-of-beads/pi-web 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @gang-of-beads/pi-web 可以商用吗？ @gang-of-beads/pi-web 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @gang-of-beads/pi-web 的下载量有多少？ 根据 npm 官方下载统计，@gang-of-beads/pi-web 在 2026/10/16 – 2026/11/14 这 30 天内被下载 4,490 次，日均约 150 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @gang-of-beads/pi-web 还在维护吗？ 最新版本 2\.202611\.1 发布于 2026/11/15（今天）；至今共发布 70 个版本，其中过去 12 个月发布了 70 个；首次发布于 2026/09/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。