@gfgghgftgffg/pi-web-access-lean

中文文档
0.1.17发布于 2026/11/11MITES Module构建来源已验证近 30 天下载 2919

A lighter wrapper for pi-web-access: one web_access tool, about 87% less tool text on the first call.

原始使用文档
文档目录8 节
  1. 优点
  2. 功能
  3. 来源
  4. 使用方法
  5. 安装
  6. 配置与限制
  7. 上下文占用(字符代理)
  8. 开发

@gfgghgftgffg/pi-web-access-lean

English

优点

为 pi-web-access 提供更轻量的封装。搜索、核验、抓取和续取收成一个 web_access,首轮就要带上的工具注册文本大约少 87%。

功能

  • 一个工具覆盖 search、check、fetch、get 和 help。执行仍走上游引擎,不把上游那几个工具再注册一遍。
  • 本地 PDF 路径和 file:/// 返回已保存的 Markdown 及路径。元数据含 Markdown 字符数,引擎提供时也含页数。这条路径只提取 Markdown,不是上游的结构化 extract。
  • 冷门参数留在 help 里,包括允许的搜索 Provider。调用时把它们写成 JSON 对象字符串放进 input。

来源

门面来自 kunkun9527/pi-web-access-lean。引擎是 Nico Bailon 的 pi-web-access。本包跟随上游发布,不复制引擎。两者都是 MIT,本包保留原始 LICENSE。它属于 amox-pi-extensions-lean。

使用方法

调用 web_access,传入 op 和 input。

搜索:

{ "op": "search", "input": "Pi coding agent extensions" }

核验一句话:

{ "op": "check", "input": "The paper was published in 2024" }

抓取网页或本地 PDF:

{ "op": "fetch", "input": "https://example.com/page" }

续取上次的结果。input 填之前返回的 response id:

{ "op": "get", "input": "response-id" }

查看某个操作的全部参数:

{ "op": "help", "input": "fetch" }

更多字段写进 input 字符串里的 JSON:

{ "op": "fetch", "input": "{\"url\":\"https://example.com/page\",\"redirects\":\"same-origin\"}" }

结果里如果点名上游工具,改调对应的 web_access 操作。页面正文不改写。

安装

这是公开的 npm 包,安装时不固定版本:

pi install npm:@gfgghgftgffg/pi-web-access-lean
pi update --extensions

需要 Git 回退安装时,在仓库 checkout 根目录执行:

node scripts/install-extension.mjs pi-web-access-lean

本地 Git 安装通过拉取 checkout 并重跑安装脚本更新,pi update 不更新本地内容。只保留一种安装来源。迁移时先备份 settings,移除 pi list 显示的精确旧来源,再安装 npm 来源。

请勿与其它 pi-web-access 包装扩展同时加载,以防重复注册工具。

配置与限制

Provider、凭据、搜索路由和抓取选项沿用上游的 web-search.json,通常位于 ~/.pi/agent/; 配置路径、环境变量、支持的服务和计费规则见上游文档。 外部服务可能接收查询和页面内容并产生费用,使用前检查对应服务的配置。 代理策略(包括可选 lockProxy)沿用上游;省略调用中的 proxy 以使用配置的路由。

本地 PDF 直读仅提取 Markdown,不支持上游结构化 extract 模式;远端 PDF 由上游处理。 web_access 始终直接注册,上游的动态工具加载设置不会延迟或移除这个入口。

上下文占用(字符代理)

PackageRegistered character proxy
@gfgghgftgffg/pi-web-access-lean149
pi-web-access1110

Fixed ceil(characters / 4), not provider billing tokens.

开发

开发检查与维护策略;适配细节见 MAINTENANCE.md。

版本与发布记录

@gfgghgftgffg/pi-web-access-lean 共发布 15 个版本,首次发布于 2026/10/17;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.17latest2026/11/115 天前
0.1.162026/11/115 天前
0.1.152026/11/0511 天前
0.1.142026/11/0214 天前
0.1.132026/10/3016 天前
0.1.122026/10/2719 天前

关于 @gfgghgftgffg/pi-web-access-lean 的常见问题

@gfgghgftgffg/pi-web-access-lean 是什么?

A lighter wrapper for pi-web-access: one web_access tool, about 87% less tool text on the first call.

如何安装 @gfgghgftgffg/pi-web-access-lean?

在项目目录运行 npm install @gfgghgftgffg/pi-web-access-lean,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:typebox(*)、@earendil-works/pi-ai(>=1.1.0)、@earendil-works/pi-tui(>=1.1.0)、@earendil-works/pi-coding-agent(>=1.1.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gfgghgftgffg/pi-web-access-lean 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gfgghgftgffg__pi-web-access-lean 是否存在。

@gfgghgftgffg/pi-web-access-lean 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gfgghgftgffg/pi-web-access-lean 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gfgghgftgffg/pi-web-access-lean 可以商用吗?

@gfgghgftgffg/pi-web-access-lean 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gfgghgftgffg/pi-web-access-lean 的下载量有多少?

根据 npm 官方下载统计,@gfgghgftgffg/pi-web-access-lean 在 2026/10/17 – 2026/11/15 这 30 天内被下载 2,919 次,日均约 97 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gfgghgftgffg/pi-web-access-lean 还在维护吗?

最新版本 0.1.17 发布于 2026/11/11(5 天前);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/10/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。