@gang-of-beads/pi-web

中文文档
2.202611.1发布于 2026/11/15MITTypeScriptES Module构建来源已验证近 30 天下载 4490

Web UI用于在真实工作空间中持续进行 Pi 编码代理会话.

中文使用文档
文档目录8 节
  1. 为什么是PIWEB?
  2. 快开始
  3. 建议设置
  4. 核心模式
  5. 警卫
  6. 文档
  7. 捐款
  8. 许可证

PI WEB (英语)

页:1 简体中文

Release npm version Node.js License: MIT

PI WEB 是一个网络用户界面 Pi 编码代理 使代理会话在机器或服务器上运行.

运行您的代码、 工具、 证书和缓存所在的代理 。 从任何浏览器中监督它们.

PI WEB

https://github.com/user-attachments/assets/21ae3e58-6706-4108-afca-5fa4e265104a 互联网档案馆的存檔,存档日期2014-12-20

PI WEB on a desktop: sessions, a conversation and the project's files

The session board on a phone The Go to menu on a phone A conversation on a phone in Material Light

电话:会话板"去菜单"和"光"主题的对话.

为什么是PIWEB?

当工作环境持续时,代理发展效果更好。 PI WEB让你:

  • 在浏览器断开后保持 Pi 编码代理会话的活性;
  • * 在真正的仓库和工作地内经营特工;
  • 平行监督若干会议;
  • 手提电脑、电话、平板电脑和桌面之间的切换;
  • 使用服务器、工作站或远程 dev 框作为代理运行时间;
  • 管理一个网络用户界面的项目、工作空间、文件、终端、会话和其他机器;
  • 将您的 Pi 设置带回原样: Pi 包、 扩展、 技能和快捷模板负载在每次会话中, 扩展对话框、 通知和部件会在浏览器中显示( )PI WEB 下的 Pi 扩展(三);
  • 以 PI WEB 插件: 页面、动作、标签、主题和文本渲染器,可选服务器的一半; 文件、 Git、终端和目标被捆绑插件,并且像任何 Pi 软件包一样安装更多;
  • 在不同地点跨机工作:将你的家用服务器、工作站、笔记本电脑和云德夫盒放入一个Tailscale尾网,并加入一个PI WEB页面(机器在 HTTPS 上打开每个设备 纹章服务而不打开一个端口 互联网。 您的电话、平板电脑和笔记本电脑可以远程到达相同的会话:在您的办公桌开始一个任务,然后从您的电话中跟踪并回答.

您的浏览器是控制表面 。 工作还是能继续运转的 见 远程第一发展。 。 。 .

快开始

所需经费:

  • 登入壳上的节点22.19.0或更新和npm PATH 并且能够 npm install -g 无 sudo; 见 所需资源 nvm 和分发包
  • Pi 编码代理 1. 5.2 或更新, 为您的用户配置
  • git 和您的代理工具所需的开发工具; 在 Linux 上, 也有 python3, make 和一个 C++ 编译器( 例如) build-essential),npm用于建造终端
  • Linux 或 macOS 有用户服务管理器( 系统或启动), Windows 10 或 11( 用户计划任务) , 或 Android 上的 Termux 软件 (临时服务)

运行PI WEB与"Beads之帮"预设在您的代码所在的机器上,用"Tailscale Service"发布到您的尾网,并从您的手机中使用.

  1. 安装 PI WEB 作为用户服务, 并配备代理工具和网络插件 红蜂帮预设数字 :

    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中运行此选项:

    $env:PI_WEB_PRESET = "gang-of-beads"; irm https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/install.ps1 | iex
    
  2. 发布到您的尾网 纹章服务 (MagicDNS和HTTPS证书启用). PI WEB 保持回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回

    tailscale serve --bg --https=8504 http://127.0.0.1:8504
    
  3. 在你的手机上,注册到同一个尾网,打开 https://<machine>.<tailnet>.ts.net:8504 并把它添加到家用屏幕上 共享 – 添加到家用屏幕) (中文(简体) ). 它作为一个应用程序打开: 在 iPhone 或 iPad 上安装。 。 。 .

PI WEB独自一人,没有预设:

curl -fsSL https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/install.sh | sh

在 Windows 上,在 PowerShell (窗口 详细情况:

irm https://raw.githubusercontent.com/Gang-of-Beads/pi-web/main/install.ps1 | iex

然后打开 http://127.0.0.1:8504 (中文(简体) ),或作为步骤2发布.

npm, Nix, 主管理器, Docker, 通过 Pi, WSL 和手动运行安装 : 见 安装指南。 。 。 .

每天的命令 :

pi-web status
pi-web logs
pi-web restart
pi-web doctor
pi-web version
pi-web uninstall

核心模式

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隧道或经认证的倒置代理上,绝不直接在公共互联网上;可选 访问令牌 增加第二层. 见 警卫 威胁模式以及如何报告脆弱性.

文档

与 PI WEB 一起维护的插件和软件包 : 文件/插件.md。 。 。 .

捐款

见 捐款额 用于开发设置,检查和拉动请求预期.

许可证

麻省理工学院 2026"Beads帮"撰稿人. 见 自由主义 财务报告和审定财务报表 通知。 。 。 .

版本与发布记录

@gang-of-beads/pi-web 共发布 70 个版本,首次发布于 2026/09/02;过去 12 个月发布了 70 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.202611.1latest2026/11/15今天
2.202611.02026/11/097 天前
2.202610.272026/11/0511 天前
2.202610.262026/11/0411 天前
2.202610.252026/11/0312 天前
2.202610.242026/10/3016 天前

关于 @gang-of-beads/pi-web 的常见问题

@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 和提交记录判断。