# @bizmyth/pi-vertex-gemini-search 中文文档

规范地址：https://npmcn.com/package/%40bizmyth/pi-vertex-gemini-search/

版本：0\.2\.0
npm 元数据更新时间：2026-10-08T21:04:51.190Z
中文译文更新时间：2026-11-08T05:16:50.913Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bizmyth/pi-vertex-gemini-search
原文对照：https://npmcn.com/package/%40bizmyth/pi-vertex-gemini-search/?lang=original
项目主页：https://github.com/drew-council/pi-vertex-gemini-search#readme
源码仓库：https://github.com/drew-council/pi-vertex-gemini-search

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：24 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：typebox 1\.3\.27，@earendil-works/pi-ai 1\.0\.4，@earendil-works/pi-tui 1\.0\.4，@earendil-works/pi-coding-agent \*
- 首次发布：2026-10-08T17:43:55.571Z
- 最新版本发布：2026-10-08T20:57:36.334Z
- 近 30 天下载量：1966（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

Vertex AI 双子座基于Pi的网络搜索和研究工具,使用Pi的google-vertex提供者

## 安装

```sh
npm install @bizmyth/pi-vertex-gemini-search
```

也可以使用：`pnpm add @bizmyth/pi-vertex-gemini-search`、`yarn add @bizmyth/pi-vertex-gemini-search`、`bun add @bizmyth/pi-vertex-gemini-search`

## README

# @bizmyth/pi-vertex-gemini-搜索

互联网搜索和研究工具 [Pi 编码代理](https://pi.dev/)由Vertex AI 双子座支持 谷歌搜索通过Pi的内置定位 `google-vertex` 供养.

从 [`@nilskluewer/pi-vertex-gemini-search`](https://github.com/nilskluewer/pi-vertex-gemini-search)。这个叉子会放下它自己的符号处理、端点和环境配置,并使用Vertex AI设置的 Pi 聊天模式使用的任何工具.

## 安装

```sh
pi install npm:@bizmyth/pi-vertex-gemini-search
```

安装后重新启动 Pi. 在安装前审查扩展; Pi 扩展以您的用户全部权限运行 .

## 工具

-   **`web_search`**:快速核实或核实事实。 返回简明的答案和源 URL.
-   **`web_research`**:对复杂课题进行深入研究. 返回结构化的答案和源 URL.

两个工具:

-   用 Google 搜索进行地面回答, 并读取通过双子座查询通过的 URL `url_context`。 。 。 .
-   决定 `vertexaisearch.cloud.google.com` 重定向链接到目的地 URL .
-   将答案和源 URL 返回模型,以及结构化结果(`answer`, (中文(简体) ), `sources`, (中文(简体) ), `searchQueries`, (中文(简体) ), `model`, (中文(简体) ), `location`, (中文(简体) ), `serviceTier`, (中文(简体) ), `costUsd`)去编码脚本.
-   在双子座写时将答案流入记录稿中,然后显示一个模型/成本/定价层次的总结并有崩溃的预览;扩展结果以获得完整的答案和来源.
-   报告它们作为工具使用的象征性成本和地基成本,因此搜索算作会议成本.

## Vertex AI 设置

这些工具需要Pi的 `google-vertex` 要配置的提供者, 与 Vertex AI 聊天模式完全相同 。 见 [Google Vertex AI (谷歌Vertex AI) 互联网档案馆的存檔,存档日期2013-10-02](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/providers.md#google-vertex-ai) 在Pi的提供者文件。 例如, 应用程序默认证书 :

```sh
export GOOGLE_CLOUD_PROJECT=your-project
export GOOGLE_CLOUD_LOCATION=global
gcloud auth application-default login
```

Vertex AI API 密钥 (`GOOGLE_CLOUD_API_KEY`)或证书存储于 `/login google-vertex` 还行 搜索在工程和位置中运行, 当Vertex AI没有配置时会因 Pi 的认证错误而失败 .

目前双子座模型来自 `global` 地点.

## 配置

-   `PI_VERTEX_SEARCH_MODEL`页:1 `google-vertex` 用于搜索的模型。 默认 : `gemini-3.8-flash`。它必须是在 Pi 的模型目录(`pi --list-models google-vertex`) (中文(简体) ).

Pi 价格标志 从它的模型目录。 Google搜索地面定位估计为每1 000个查询中14美元.

## 定价等级

```text
/search-pricing            # show the current preference
/search-pricing standard   # default
/search-pricing flex       # Flex PayGo, falling back to standard
```

标准是默认的,因为Flex请求可以排队直到超时,而地面占搜索成本的主导. 当一个Flex请求失败或时断时,搜索按标准重试,之后的搜索按标准进行,直到 `/search-pricing flex` 被再次运行。 在整个皮会中,这种偏好并不持续存在.

## 发展

```sh
bun install
bun run check
```

`bun run check` 运行 Biome, TypeScript 7 (`tsc`和Bun测试.

## 释放

信任的出版必须已经配置 `publish.yml`。要发布新版本:

```sh
bun pm version patch # or: minor / major
git push origin main --follow-tags
gh release create "$(git describe --tags --exact-match)" --generate-notes
```

发布 GitHub 发行会运行检查,并使用 OIDC 发布匹配包版本到 npm. 没有长寿 `NPM_TOKEN` 需要时间.

## 许可证

麻省理工学院

## 常见问题

### @bizmyth/pi-vertex-gemini-search 是什么？

Vertex AI 双子座基于Pi的网络搜索和研究工具,使用Pi的google-vertex提供者

### 如何安装 @bizmyth/pi-vertex-gemini-search？

在项目目录运行 npm install @bizmyth/pi-vertex-gemini-search，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typebox（1\.3\.27）、@earendil-works/pi-ai（1\.0\.4）、@earendil-works/pi-tui（1\.0\.4）、@earendil-works/pi-coding-agent（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bizmyth/pi-vertex-gemini-search 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bizmyth\_\_pi-vertex-gemini-search 是否存在。

### @bizmyth/pi-vertex-gemini-search 支持 ESM 还是 CommonJS？

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

### @bizmyth/pi-vertex-gemini-search 可以商用吗？

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

### @bizmyth/pi-vertex-gemini-search 的下载量有多少？

根据 npm 官方下载统计，@bizmyth/pi-vertex-gemini-search 在 2026/10/08 – 2026/11/06 这 30 天内被下载 1,966 次，日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bizmyth/pi-vertex-gemini-search 还在维护吗？

最新版本 0\.2\.0 发布于 2026/10/09（30 天前）；至今共发布 3 个版本，其中过去 12 个月发布了 3 个；首次发布于 2026/10/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。