# @chainingintention/pi-web-cn 中文文档 规范地址：https://npmcn.com/package/%40chainingintention/pi-web-cn/ 版本：2\.202611\.9 npm 元数据更新时间：2026-11-09T09:52:30.966Z 中文译文更新时间：2026-11-09T09:28:05.997Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40chainingintention/pi-web-cn 原文对照：https://npmcn.com/package/%40chainingintention/pi-web-cn/?lang=original 项目主页：https://github.com/nayuto-wakusei/pi-web-ChineseTranslation#readme 源码仓库：https://github.com/nayuto-wakusei/pi-web-ChineseTranslation ## 关键信息（来自 npm 元数据） - 包体积（解压后）：18.6 MB，1416 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=22\.19\.0 - 运行依赖：34 个 - peer 依赖：@earendil-works/pi-ai 0\.86\.1 \|\| 0\.87\.0 \|\| 1\.3\.0 \|\| 1\.4\.0，@earendil-works/pi-agent-core 0\.86\.1 \|\| 0\.87\.0 \|\| 1\.3\.0 \|\| 1\.4\.0，@earendil-works/pi-coding-agent 0\.86\.1 \|\| 0\.87\.0 \|\| 1\.3\.0 \|\| 1\.4\.0 - 首次发布：2026-06-05T09:40:35.726Z - 最新版本发布：2026-11-09T09:52:30.586Z - 近 30 天下载量：3901（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：88（近 12 个月 88 个） ## 中文简介 Web UI用于在真实工作空间中持续进行 Pi 编码代理会话. ## 安装 ```sh npm install @chainingintention/pi-web-cn ``` 也可以使用：`pnpm add @chainingintention/pi-web-cn`、`yarn add @chainingintention/pi-web-cn`、`bun add @chainingintention/pi-web-cn` ## README # PI WEB PI WEB 的中文本地化分支，保留上游功能，并将核心界面与内置插件的显示内容本地化为中文。 [![CI](https://github.com/nayuto-wakusei/pi-web-ChineseTranslation/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/nayuto-wakusei/pi-web-ChineseTranslation/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/%40chainingintention%2Fpi-web-cn)](https://www.npmjs.com/package/@chainingintention/pi-web-cn) [![Node.js](https://img.shields.io/node/v/%40chainingintention%2Fpi-web-cn)](https://npmcn.com/package/%40chainingintention/pi-web-cn/package.json) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://npmcn.com/package/%40chainingintention/pi-web-cn/LICENSE) **PI WEB 是 [Pi Coding Agent](https://github.com/earendil-works/pi/tree/main/packages/coding-agent) 的 Web 界面，让代理会话持续运行在机器或服务器的真实工作区中。** 运行时复用宿主 Pi SDK，支持 Pi `0.86.1`、`0.87.0`、`1.3.0` 或 `1.4.0`，开发依赖使用 `1.4.0`。每个会话守护进程独占 `PI_WEB_DATA_DIR`，并发实例必须使用独立数据目录和 daemon endpoint。 让代理在代码、工具、凭据和构建缓存所在的机器工作，从任何浏览器监督。 上游网站与文档：[https://pi-web.dev/](https://pi-web.dev/)。本分支的包名、项目认证与管理隔离等差异以仓库中的[配置参考](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/config.md)和[插件指南](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/plugins.md)为准。 ![PI WEB](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/assets/pi-web-banner.png) ![PI WEB 桌面截图](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/assets/pi-web-desktop.png) ## 为什么使用 PI WEB？ 持久的工作环境适合代理开发。PI WEB 可以： - 浏览器断开后继续运行代理会话； - 在真实仓库与 Git 工作树中工作； - 并行监督多个会话； - 在电脑、手机和平板间切换； - 使用服务器、工作站或远端开发机运行代理； - 从一个界面管理项目、工作区、文件、终端、会话及远端机器。 浏览器负责监督，工作留在能够持续运行的机器。 ## 快速开始 需要 Node.js 22.19.0 或更新版本、npm、为当前用户配置的 Pi Coding Agent `0.86.1`、`0.87.0`、`1.3.0` 或 `1.4.0`，以及 Git 和项目所需开发工具。 也可使用 [Bun（尽力支持）](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/install.html#bun)；Node.js 仍为推荐运行时。 安装并启动用户服务： ```bash npm install -g @chainingintention/pi-web-cn --allow-scripts=node-pty pi-web install pi-web doctor ``` npm 12 的限定开关只允许 node-pty 准备所需原生模块，不为其他依赖开启安装脚本。 打开： ```text http://127.0.0.1:8504 ``` 常用命令： ```bash pi-web status pi-web logs pi-web restart pi-web doctor pi-web version pi-web uninstall ``` 安装变体、Pi 包安装、WSL/手动启动与远端访问见[安装指南](https://pi-web.dev/install)。 ## 核心模型 ```text Machine 本地或远端 PI WEB 运行时 Project 该机器上的项目目录 Workspace 提供器拥有的工作目录；内置 Git 发现工作树，无提供器时使用项目目录 Session 工作区中运行的 Pi Coding Agent 对话 ``` 典型流程：添加项目 → 选择工作区 → 启动会话 → 让代理工作 → 稍后从任何浏览器返回。 ## 远端优先 让代理运行在保持在线的服务器、桌面机、云主机、家用实验室或远端开发机，不依赖笔记本浏览器会话。远端连接使用私有网络、SSH 隧道、可信反向代理或 PI WEB 机器联邦。 详见[远端优先开发](https://pi-web.dev/remote-first)。 ## 机器与联邦 一个浏览器网关可代理可信远端机器的项目、工作区、文件、Git、会话、终端、活动、Pi 包与设置。设置页标明目标机器：包、插件、daemon 能力、文件访问和上传默认值针对所选机器；网关监听地址/端口/允许主机、机器注册/令牌和快捷键仍在网关。 详见[机器指南](https://pi-web.dev/machines)。 ## PI WEB 插件 可信插件可提供面板、工具和工作区工作流，从 **设置 → PI WEB 插件** 管理所选机器的启用状态。Pi 包的安装与插件启用是独立操作。服务端插件变更需手动重启会话守护进程，再刷新浏览器；仅 Web 重启或 `/reload` 不会激活。 详见[插件指南](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/plugins.md)。 ## 配置 机器配置在 `$PI_WEB_CONFIG` 或 `~/.config/pi-web/config.json`，项目配置在 `/.pi-web/config.json`。包括网络、路径访问、上传/附件、插件、快捷键和会话工具。普通模型认证与默认值按项目托管，管理嵌入独立，详见[配置参考](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/config.md)。 ## 开发 克隆仓库后： ```bash npm install npm run dev ``` 打开 Vite URL，通常为 `http://localhost:8505`。拆分开发启动使用三个独立终端，先启动 Web： ```bash npm run dev:web npm run start:sessiond npm run dev:client ``` daemon 等待 Web 拥有的插件构建就绪，不自动重载。构建/重启顺序见[服务启动说明](https://pi-web.dev/install#manage-services)。 验证改动： ```bash npm run verify ``` 交付构建与产物检查见[开发检查](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/development-checks.md)。 ## 安全模型 普通模式假定用户、仓库与服务器路径可信，不是多租户平台或代理沙箱。不要在没有可信网络、防火墙、VPN、SSH 隧道或认证代理时直接暴露到公网。管理嵌入使用独立授权资源、受控工具、沙箱与审计，不与普通模式共享权限。 ## 文档 - [代码库维护文档：架构、模块契约、改动地图与验证](https://github.com/nayuto-wakusei/pi-web-ChineseTranslation/blob/main/docs/maintenance.md) - [上游网站](https://pi-web.dev/) - [安装](https://pi-web.dev/install) - [远端优先](https://pi-web.dev/remote-first) - [机器](https://pi-web.dev/machines) - [配置](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/config.md) - [插件](https://npmcn.com/package/%40chainingintention/pi-web-cn/docs/plugins.md) - [常见问题](https://pi-web.dev/faq) ## 许可 MIT © 2026 Federico Jaramillo Martinez，见 [LICENSE](https://npmcn.com/package/%40chainingintention/pi-web-cn/LICENSE)。 ## 常见问题 ### @chainingintention/pi-web-cn 是什么？ Web UI用于在真实工作空间中持续进行 Pi 编码代理会话\. ### 如何安装 @chainingintention/pi-web-cn？ 在项目目录运行 npm install @chainingintention/pi-web-cn，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pi-web、pi-web-server、pi-web-sessiond，可以用 npx pi-web 直接运行。 ### @chainingintention/pi-web-cn 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @chainingintention/pi-web-cn 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @chainingintention/pi-web-cn 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.19\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @chainingintention/pi-web-cn 可以商用吗？ @chainingintention/pi-web-cn 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @chainingintention/pi-web-cn 的下载量有多少？ 根据 npm 官方下载统计，@chainingintention/pi-web-cn 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,901 次，日均约 130 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @chainingintention/pi-web-cn 还在维护吗？ 最新版本 2\.202611\.9 发布于 2026/11/09（今天）；至今共发布 88 个版本，其中过去 12 个月发布了 88 个；首次发布于 2026/06/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。