# @demigodmode/pi-web-agent 中文文档 规范地址：https://npmcn.com/package/%40demigodmode/pi-web-agent/ 版本：1\.17\.0 npm 元数据更新时间：2026-11-09T00:34:28.489Z 中文译文更新时间：2026-11-12T12:37:46.391Z 软件包许可：AGPL-3\.0-only 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40demigodmode/pi-web-agent 原文对照：https://npmcn.com/package/%40demigodmode/pi-web-agent/?lang=original 项目主页：https://github.com/demigodmode/pi-web-agent#readme 源码仓库：https://github.com/demigodmode/pi-web-agent ## 关键信息（来自 npm 元数据） - 包体积（解压后）：799 kB，209 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：7 个 - peer 依赖：typebox \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \* - 首次发布：2026-04-20T16:54:54.055Z - 最新版本发布：2026-11-09T00:34:28.203Z - 近 30 天下载量：2532（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：31（近 12 个月 31 个） ## 中文简介 用于可靠网页访问的 Pi 软件包,有明确的搜索、取取和无头边界. ## 安装 ```sh npm install @demigodmode/pi-web-agent ``` 也可以使用：`pnpm add @demigodmode/pi-web-agent`、`yarn add @demigodmode/pi-web-agent`、`bun add @demigodmode/pi-web-agent` ## README ![pi-web-agent: bounded web research for Pi](https://raw.githubusercontent.com/demigodmode/pi-web-agent/main/docs/public/pi-web-agent-banner.png) # 网络代理商 [![CI](https://img.shields.io/github/actions/workflow/status/demigodmode/pi-web-agent/ci.yml?branch=main&style=flat-square&logo=github&label=CI)](https://github.com/demigodmode/pi-web-agent/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/@demigodmode/pi-web-agent?style=flat-square&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@demigodmode/pi-web-agent) [![npm downloads](https://img.shields.io/npm/dm/@demigodmode/pi-web-agent?style=flat-square&color=0A7BBB&label=downloads)](https://www.npmjs.com/package/@demigodmode/pi-web-agent) ![Platform: macOS, Linux, Windows](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-475569?style=flat-square) [![Docs](https://img.shields.io/badge/docs-github%20pages-2088FF?style=flat-square&logo=readthedocs&logoColor=white)](https://demigodmode.github.io/pi-web-agent/) [![License](https://img.shields.io/npm/l/@demigodmode/pi-web-agent?style=flat-square&color=6F42C1)](https://github.com/demigodmode/pi-web-agent/blob/main/LICENSE) ![Search backends](https://img.shields.io/badge/search%20backends-475569?style=flat-square) ![DuckDuckGo](https://img.shields.io/badge/DuckDuckGo-475569?style=flat-square&logo=duckduckgo&logoColor=white) ![SearXNG](https://img.shields.io/badge/SearXNG-475569?style=flat-square&logo=searxng&logoColor=white) ![Brave Search](https://img.shields.io/badge/Brave-475569?style=flat-square&logo=brave&logoColor=white) ![You.com](https://img.shields.io/badge/You.com-475569?style=flat-square&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8%2F9hAAABZElEQVQ4jX2TP0sDQRDF3ywbcROCF8HKQgstUiWFX8BWm4BYaJVGERE89AuYzkY4mxQ2WqUQBBtt%2FQIpEhsbG%2Btg%2FiDehhB2LBLD5TKXBwsD835v2dldgqCS3%2FEWh%2B6cAB8AGAj6Wt0%2BB7lu3EtzQC%2Fm7UpBNA%2Fc2zEAgKdXmxhEh6edIiv3JuyYFDAJIqe2tVPugQQYANZWNULrpBYAeEzuXhNQkLppQ8hv6nEdIrQ8ayIUVRJ8cZRFxhAy4zptSLKCDs6%2BGRidlxlYWVbYKiwgEwN%2BLaPeHKDVnj6Snkqj8ZJ2ivTFgOik0ybE5XEW%2BY1R%2B%2BNziJu7H3EO4gxCyxMgWkvSDDSlmwgto%2F4%2BmNSSGGgq5VSZGT3J0Gq7maFF6C%2FlVFnVqrlGP6XWGagkBU1xjB4DFZtSxVo115A%2Bkw%2BGT4Sl6FNmRg%2BEoK9VMPOZ4ir5Hc8M3dX%2BrjkBgMcXex0H%2F%2FUHatWr2uEU4ZoAAAAASUVORK5CYII%3D) ![Exa](https://img.shields.io/badge/Exa-475569?style=flat-square&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAACgUlEQVR42u2XXUiTYRTHf8%2Feuem7V6sbQcFMsgyJQoigizDqIuhDiW6iksBISrGS7MsP3JhWlBUqWnThjX2RBGlSRCREF0UEkURkGWYSUhCpe7e5ue3pQmaY6Eq3hNq5ex8O5%2Flxzvn%2FeR%2BRuu6bZA7DwBxHFCAKYAyVUF%2Bhkb06ZkbFS07pdD4bnR2AGieYFy8YdEhudHhCXmo2wZ5tsSgG0F1y9h0Ixvx4QW%2B%2Fn1v3p4ewH7agGOB6h4fnXb7w7ICU0NPnx3ZIZUmqMmXexrUm8nLNvOnxY2twhW8JpYQim44AGq0acWYxKScp0cCZUgtOl6TYruPxyvCqoLvXT80lF0sXKVQUqhPnqEBDpcaCBMHRs04%2BfPJHRoYtbR7udnrZlWMmZ4Np%2FPxIvsqq5Uaab49w77E3sj5QftFJ%2F0CAmhILKUkG1mTFULAjlldvfZy%2B7Aq%2FD%2Fwaw7rkYLVOa10CjVUayYkGHE5JoVVn1EdkAISAq7XxE850t2RFhhEpYW%2BZg89fAv%2BoFQdluLvUMf6dlWmktS6Brm4fyYkGLpRpbN43NKMu%2FHEHEjRBfYWG2yMpsukU253EWwRNVo0Y418YQXD7g2p4%2BnKUKzdHWLnMyMn9amQB8nLNbF1v4lq7h%2FZHP%2FV%2BvtnFi9c%2B8rfHsinbFBmAjDSF8gMq7z76qW6aqHefH4rtOt%2BHJeeOWVi8UAkvgBDQWKUhgSKrjtsz2ecHvgY4UevEogoaKjXMJhFegPRUhao6F%2B%2F7pvb5B0%2B8tLR5yExXqCpWw%2BuEgw5JWorC8YLpC4%2F6JP4A7Nxi5s7D0P8EIQFcbsmQQyIYK%2Fo7oTvHRqSpoccgoi%2BjKMB%2FD%2FADRpbjdBgK8S0AAAAASUVORK5CYII%3D) ![Tavily](https://img.shields.io/badge/Tavily-475569?style=flat-square&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA1NSA1NSIgd2lkdGg9IjU1IiBoZWlnaHQ9IjU1Ij4KPHBhdGggZD0iTTM4LjgwODggMEM0NC40NzYyIDAgNDcuMzEwMSA5LjE4OTVlLTA1IDQ5LjQ3NDggMS4xMDMwNkM1MS4zNzg4IDIuMDczMjYgNTIuOTI3IDMuNjIxMzUgNTMuODk3MSA1LjUyNTQ0QzU1LjAwMDEgNy42OTAxMyA1NSAxMC41MjQgNTUgMTYuMTkxNFYzOC44MDg4QzU1IDQ0LjQ3NjEgNTUuMDAwMSA0Ny4zMDk5IDUzLjg5NzEgNDkuNDc0NkM1Mi45MjcgNTEuMzc4NiA1MS4zNzg4IDUyLjkyNjcgNDkuNDc0OCA1My44OTY5QzQ3LjMxMDEgNTQuOTk5OSA0NC40NzYyIDU1IDM4LjgwODggNTVIMTYuMTkxNEMxMC41MjM5IDU1IDcuNjkwMTQgNTQuOTk5OSA1LjUyNTQ0IDUzLjg5NjlDMy42MjEzMyA1Mi45MjY3IDIuMDczMjUgNTEuMzc4NyAxLjEwMzA2IDQ5LjQ3NDZDMC4wMDAxMDk5NTggNDcuMzA5OSAwIDQ0LjQ3NjIgMCAzOC44MDg4VjE2LjE5MTJDMCAxMC41MjM4IDAuMDAwMTA3NjE0IDcuNjkwMTIgMS4xMDMwNiA1LjUyNTQ0QzIuMDczMjUgMy42MjEzMyAzLjYyMTMzIDIuMDczMjYgNS41MjU0NCAxLjEwMzA2QzcuNjkwMTQgOC44ODQzNmUtMDUgMTAuNTIzOSAwIDE2LjE5MTQgMEgzOC44MDg4WiIgZmlsbD0iIzFGMUUxRSIvPgo8cGF0aCBkPSJNMjMuMzg2MyAzMC40MDVDMjMuMDg4NSAzMC40MDUgMjIuNzkzNCAzMC40NjM4IDIyLjUxODMgMzAuNTc4MkMyMi4yNDMzIDMwLjY5MjYgMjEuOTkzMyAzMC44NjAzIDIxLjc4MjcgMzEuMDcxNkwxNy40NTM0IDM1LjQxODhMMTYuMzAyOSAzNC4yNjM4QzE1LjQ1NzMgMzMuNDE1IDE0LjAwOTkgMzMuODM0NiAxMy43NDcxIDM1LjAwNjRMMTIuMTA3MyA0Mi4zMDIzQzEyLjA0OTggNDIuNTUzMiAxMi4wNTY4IDQyLjgxNDggMTIuMTI4IDQzLjA2MjFDMTIuMTk5IDQzLjMwODUgMTIuMzMxMyA0My41MzI3IDEyLjUxMjMgNDMuNzEzNkwxMi41MTA4IDQzLjcxNTlDMTIuNjkxNSA0My44OTg3IDEyLjkxNTUgNDQuMDMyMSAxMy4xNjE5IDQ0LjEwMzdDMTMuNDA4MyA0NC4xNzUyIDEzLjY2ODggNDQuMTgyNCAxMy45MTg4IDQ0LjEyNDZMMjEuMTg2MiA0Mi40Nzc2QzIyLjM1MjcgNDIuMjEzNyAyMi43NzE1IDQwLjc2MTQgMjEuOTI1OSAzOS45MTI0TDIwLjc3NTQgMzguNzU3NEwyNS4xMDU2IDM0LjQxMUMyNS41MzA2IDMzLjk4NDIgMjUuNzY5NSAzMy40MDQ5IDI1Ljc2OTUgMzIuODAxM0MyNS43Njk1IDMyLjE5NzcgMjUuNTMwNiAzMS42MTg1IDI1LjEwNTYgMzEuMTkxNkwyNS4wNDc2IDMxLjEzMzRMMjUuMDQ5NyAzMS4xMzE5TDI0Ljk4OTYgMzEuMDcxNkMyNC43NzkxIDMwLjg2MDMgMjQuNTI5IDMwLjY5MjYgMjQuMjU0IDMwLjU3ODJDMjMuOTc5IDMwLjQ2MzggMjMuNjg0IDMwLjQwNTEgMjMuMzg2MyAzMC40MDVaIE0zOS4wMDU0IDI3LjY2NjNDMzcuOTk0MSAyNy4wMjQ1IDM2LjY3NjggMjcuNzU0NiAzNi42NzY2IDI4Ljk1NTZWMzAuNTg4NEgyNy4zOTgxQzI3LjcwODEgMzEuMTgzMiAyNy44ODQ3IDMxLjg1OTYgMjcuODg0NyAzMi41Nzc0QzI3Ljg4NDYgMzMuNjE1MiAyNy41MTgxIDM0LjU2NzIgMjYuOTA4IDM1LjMwOTlMMzYuNjc1OCAzNS4zMDk2TDM2LjY3NTIgMzYuOTQyNEMzNi42NzUzIDM4LjE0MzQgMzcuOTk0MSAzOC44NzM2IDM5LjAwNTQgMzguMjMxOUw0NS4zMDQ1IDM0LjIzODdDNDUuNzc1NyAzMy45Mzg0IDQ2LjAxMTQgMzMuNDQzIDQ2LjAxMTUgMzIuOTQ4QzQ2LjAxMDkgMzIuNDUzNiA0NS43NzUyIDMxLjk1OTIgNDUuMzAzIDMxLjY2MDFMMzkuMDA1NCAyNy42NjYzWiBNMjMuNjEwNCAxMC4yMjA2QzIzLjM1MzkgMTAuMjE5NCAyMy4xMDEgMTAuMjgzOSAyMi44NzYzIDEwLjQwODFDMjIuNjUxNCAxMC41MzI1IDIyLjQ2MTQgMTAuNzEzMiAyMi4zMjUzIDEwLjkzMThMMTguMzQ3MiAxNy4yNTQ5SDE4LjM0NThDMTcuNzA2NyAxOC4yNzAxIDE4LjQzNDYgMTkuNTkzMyAxOS42MzA3IDE5LjU5MzZIMjEuMjU3OFYyOC45ODY5QzIxLjkzMjcgMjguNTQwNiAyMi43NDAzIDI4LjI4MDEgMjMuNjA5IDI4LjI4MDFDMjQuNDc4MSAyOC4yODAxIDI1LjI4NjQgMjguNTQwNyAyNS45NjE1IDI4Ljk4NzVWMTkuNTkzNkgyNy41ODg0QzI4Ljc4NDkgMTkuNTkzNiAyOS41MTEyIDE4LjI3MDIgMjguODcyOCAxNy4yNTQxTDI0Ljg5MzkgMTAuOTMxOEMyNC41OTUxIDEwLjQ1ODQgMjQuMTAyOSAxMC4yMjEyIDIzLjYxMDQgMTAuMjIwNloiIGZpbGw9IiNGRkZDRjYiLz4KPC9zdmc%2BCg%3D%3D) ![Parallel](https://img.shields.io/badge/Parallel-475569?style=flat-square) ![Google SERP](https://img.shields.io/badge/Google%20SERP-475569?style=flat-square&logo=google&logoColor=white) 一个公共工具, `web_explore`,这确实为Pi做了限定的网页研究:搜索,取回,定向浏览器渲染,排名,以及诚实的提醒,所有这一切都是在一个呼叫背后. > 大多数代理网络工具模糊了搜索、取取、渲染和合成到一个模糊的东西. `pi-web-agent` 保持边界的简单, 并且更严格地说它实际上做了什么: bot检查页面, 狭义的源集, 无法读取的线程, 和相冲突的证据 显示作为警告而不是假信心. ## 你得到的东西 - **一个工具.** `web_explore` 处理直接链接、发现、 HTTP 读取、 定向无头渲染、 源排名、 源质量检查和内部提醒. - **阅读链接后的真实内容.** 粘贴一个 GitHub, PDF, 或 YouTube URL 并拉出实际内容( GitHub 文件/ 问题/ PRs from the API, PDF text, YouTube driev). 公共 GitHub 内容为无密钥; 私人 GitHub 内容需要 `GITHUB_TOKEN` 或者说 `gh auth login`,因此"概括这个PDF"或"这个Repo做什么"在源头而不是页面外壳上有效. - **解答关于 GitHub repo 代码的问题 .** 粘贴一个 repo 或文件夹链接, 并复制精确执行( shallow, over HTTPS) , 搜索您提问的代码, 并引用附加执行的链接的节选 。 需求 `git` 2.32+. 公共寄存器可匿名读取;私人寄存器的使用 `gh auth login` 或者说 `GITHUB_TOKEN`。如果无法读取回放,它说明为什么,而不是从读取回放中猜测. - **埃斯克,别这样.** 取消运行中 `web_explore` 停止搜索、页面阅读和无头浏览器。 Page读取了15秒后放弃(PDFs 60,Firecrawl 45),一页没有加载不会使整个运行失败. - **八寻后端.** DuckDuckGo(无键默认),SearXNG,Brave,You.com,Exa,Tavily,并行(无键,选入),以及您指向的任何Google SERP端点. - **可选搜索粉丝出道.** 一次查询数个后端,去dupe,并排出一个以上提供者同意的页面. 默认关闭; 翻到 `on` 或者说 `auto`。 。 。 . - **诚实的默认.** 弱小、狭窄、被封锁或警告的证据被标出而不是装扮成自信. - **不受信任的页面安全.** 链接模型选择,或在其读取的页面上找到,无法到达本地主机,您的局域网,或云元数据端点. 包括重定向和一切无头页面负载. 您配置的地址不受影响, 允许列表覆盖您想要的私有区域 . - **后退知道为什么.** 限制速率或配置错误的后端被跳过一段时间,有片面的后端被重试一次,回答时会说一些搜索后端没有可用. - **列报和结果长度是分开的.** `compact` 编号 : `preview` 编号 : `verbose` 控制终端; 自动结果长度保留适合调用模型的工具结果. - **零配置开始.** 从框中运行无密钥(DuckDuckGo搜索,本地浏览器,内置阅读器). 当您想要更多控制时,通过配置选择主机后端,倒置,搜索扇出,以及每个工具输出模式. ## 为什么是网友 与其他代理工具相比: - **手举起.** 没有管理员,没有浏览器窗口可以批准,没有步骤让你退出会话. 询问 `web_explore` 一回而后答清净回向. 没什么好照顾的. - **默认无键 .** 搜索,页面读取,而GitHub/PDF/YouTube读取器都是在没有API密钥的情况下工作的. 仅在您需要时添加主机提供者 . - **被束缚和诚实.** 终端默认是紧凑的;工具结果使用他们自己的模型意识长度限制,并说当一个读数不够好而不是返回假信心时. ## 安装 > `pi-web-agent` 需要 Pi 0.74+ 键 (Pi 软件包移至 `@earendil-works/*` 范围。 在更新此软件包之前更新 Pi 。 老皮,继续 `@demigodmode/pi-web-agent@0.6.x`扩展工程为Pi 0.99和1.0; `typebox` 是Pi已经提供的对等依赖. CI运行在22号节点上. 锁定的运行时间依赖 `undici@8.10.2` 宣布节点 `>=22.19.0`; 见 [安装要求](https://demigodmode.github.io/pi-web-agent/install#requirements)。 。 。 . ```bash pi install npm:@demigodmode/pi-web-agent ``` 安装后重新装入或重新启动 Pi, 然后 : ```text /web-agent doctor # check it loaded and show configured backends /web-agent # action menu ``` 稍后更新为 `pi update --extensions`。 。 。 . **浏览器渲染 :** 无头先尝试被检测出Chrome-family浏览器(Chrome,Chrome,Chrome,Edge,Brave). 如果找不到, 它会尝试 Playwright 管理的 Chromium, 它必须已经安装 。 见 [浏览器设置](https://demigodmode.github.io/pi-web-agent/install#browser-rendering) 用于匹配的安装命令。 Firefox/Safari-只读系统仍然得到搜索和普通HTTP读取. ## 使用量 询问 `web_explore` 网络问题: > 查找当前关于 V8 提供者配置 Vitest 覆盖的文件和讨论 . 或者用链接来读取: > 概括此 PDF : [https://arxiv.org/pdf/1706.03762 (中文(简体) )](https://arxiv.org/pdf/1706.03762) 如果传球传回来,请打电话 `web_explore` 以一个更窄的查询. 简短、具体的询问最有效。 诸如 `vs`,一个版本编号或 `user opinions` 改变研究方式,所以值得保留 结果还列出了被搜索的内容,当一个人回来时,部分内容仍然开放,再加上几个后续搜索Pi可以尝试. ## 后端 默认为 DuckDuckGo 搜索, plain HTTP 获取,以及本地浏览器无头. 切换提供者从 `/web-agent settings → Backends`。UI不写入 API 密钥。 手动防火 `apiKey` 和代理服务器 `password` 配置值被支持,但后端保存从该范围的文件中删除它们. 环境变量能活过这些节省. | 后端 | 作用 | 启用方式 | | --- | --- | --- | | 鸭子走 | 搜索( 默认) | 没什么,没有钥匙 | | 安全XNG | 搜索(自办) | 基础 URL | | 勇敢点 | 搜索(托管) | `PI_WEB_AGENT_BRAVE_API_KEY` | | You.com (英语) | 搜索(托管) | `YDC_API_KEY` | | 欧克萨 | 搜索(托管) | `EXA_API_KEY` | | 塔维利 | 搜索(托管) | `TAVILY_API_KEY` | | 平行 | 搜索(托管) | 选择 `parallel`无键 | | Google SERP (搜索器) | 搜索(托管) | 基础 URL + `PI_WEB_AGENT_GOOGLE_SERP_API_KEY` | | 纵火 | 获取( 自主办) | 基础 URL + `PI_WEB_AGENT_FIRECRAWL_API_KEY` | | GitHub 读取器 | 内容 | 公共内容无密钥; 私人内容需求 `GITHUB_TOKEN` 或者说 `gh auth login` | | GitHub 回波研究 | 内容 | `git` 2.32+ 在您的路径上; `GITHUB_TOKEN` 或者说 `gh auth login` 供私人收回 | 完整配置形状( 回落、 SearXNG / Firecrawl 选项、扇出):见 [自备后端](https://demigodmode.github.io/pi-web-agent/self-hosted-backends)。 。 。 . ## 设置 ```text /web-agent settings # main UI /web-agent doctor # health check /web-agent show # effective config /web-agent changelog /web-agent mode web_explore verbose # per-tool presentation mode /web-agent reset project | global ``` 配置是 JSON, 而项目配置覆盖全局 : ```text Global: ~/.pi/agent/extensions/pi-web-agent/config.json Project: .pi/extensions/pi-web-agent/config.json ``` ```json { "results": { "lengthLimit": "short" }, "presentation": { "defaultMode": "compact", "tools": { "web_explore": { "mode": "verbose" } } } } ``` 演示文稿模式 : - `compact`: 短摘要, 处处默认 - `preview`: 边框视图略为丰富 - `verbose`: 更充分的限定视图 模式只更改终端显示 。 它们不会缩短模型收到的工具结果。 结果长度控制,分别: 自动是默认的,或者选择Short(4,000个字符),Medium(8,000个字符),Standard,或者在JSON中精确的数字(数字低于1000变为1000个). 见 [结果长度](https://demigodmode.github.io/pi-web-agent/tools#result-length) 用于计算和标定源顶. 在演示文稿或后端设置中, Ctrl+S 保存, Esc 丢弃编辑, Ctrl+R (按了两次) 重排选定范围的全部配置文件. 在“结果”中,Ctrl+R只重置该范围的成果长度设置。 明确重置菜单和 `/web-agent reset project` 或者说 `/web-agent reset global` 重置整个范围文件,包括结果长度设置. ## 文档 完整文档 : [https://demigodmode.github.io/pi-web-agent/ 页面存档备份,存于互联网档案馆](https://demigodmode.github.io/pi-web-agent/). 在当地与 `npm run docs:dev`。 。 。 . ## 发展 ```bash npm install npm test npm run lint npm run build ``` 本地 Pi 工作用途 `.pi/extensions/pi-web-agent.ts`; 运行 `/reload` 变化后. 特性和固定 PR 目标 `develop`· ; `main` 只有释放后移动。 见 [释放](https://demigodmode.github.io/pi-web-agent/releases)。 。 。 . ## 许可证 AGPL-3.0 -仅限. 见 [自由主义](https://npmcn.com/package/%40demigodmode/pi-web-agent/LICENSE)。 。 。 . ## 常见问题 ### @demigodmode/pi-web-agent 是什么？ 用于可靠网页访问的 Pi 软件包,有明确的搜索、取取和无头边界\. ### 如何安装 @demigodmode/pi-web-agent？ 在项目目录运行 npm install @demigodmode/pi-web-agent，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（\*）、@earendil-works/pi-tui（\*）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @demigodmode/pi-web-agent 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @demigodmode/pi-web-agent 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @demigodmode/pi-web-agent 可以商用吗？ @demigodmode/pi-web-agent 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。 ### @demigodmode/pi-web-agent 的下载量有多少？ 根据 npm 官方下载统计，@demigodmode/pi-web-agent 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,532 次，日均约 84 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @demigodmode/pi-web-agent 还在维护吗？ 最新版本 1\.17\.0 发布于 2026/11/09（3 天前）；至今共发布 31 个版本，其中过去 12 个月发布了 31 个；首次发布于 2026/04/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。