# @fre4x/gemini 中文文档

规范地址：https://npmcn.com/package/%40fre4x/gemini/

版本：1\.1\.29
npm 元数据更新时间：2026-10-23T05:55:49.245Z
中文译文更新时间：2026-11-15T14:30:16.153Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fre4x/gemini
原文对照：https://npmcn.com/package/%40fre4x/gemini/?lang=original

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

- 包体积（解压后）：3.2 MB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2026-02-28T02:10:56.913Z
- 最新版本发布：2026-10-23T05:55:48.937Z
- 近 30 天下载量：2683（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：61（近 12 个月 61 个）

## 中文简介

提供多模式分析和图像/视频生成的双子座 MCP 服务器.

## 安装

```sh
npm install @fre4x/gemini
```

也可以使用：`pnpm add @fre4x/gemini`、`yarn add @fre4x/gemini`、`bun add @fre4x/gemini`

## README

# gemini——情报桥

> _能够看见、听到和想象的特工是无法超越的特工._

部分 **[FRE4X-B1TE (法语)](https://npmcn.com/package/%40fre4x/)** ——为自主代理所建造的MCP服务器的单列.

Google的双子座不是聊天人 这是一个多式联运推理引擎。 这个B1TE将你的代理直接连接到那个引擎上——文本,图像,视频,音频——这样它就可以将世界看做是人类做的,然后超越它.

## 工具

| 工具 | 能力 |
| --- | --- |
| `analyze_media` | 通过 URL 分析图像或音频文件 `file://` 路径。 提示是可选的. |
| `list_models` | 列表支持的模式 `analyze_media`, (中文(简体) ), `generate_image`,以及 `generate_video`过滤器 `analyze`, (中文(简体) ), `image`, (中文(简体) ), `video`,或 `all`。 。 。 . |
| `generate_image` | 通过纳米香蕉图像合成 `generateContent` 与 `imageConfig.aspectRatio`可选保存到 `output_dir`。 。 。 . |
| `generate_video` | 通过 REST 互动 API 启动 ASync 双子座 Omni 视频生成(`gemini-omni-1.1-flash` (默认情况下). 返回交互身份以进行民调 . |
| `get_video_status` | **单接** 状态检查( 返回) `done: false` 时 `queued`编号 :`in_progress`) (中文(简体) ). 设定 `wait=true` 以屏蔽到完整或超时。 准备时通过文件 API 下载 。 可选保存到 `output_dir`。 。 。 . |

## 所需资源

A 类 [谷歌 AI Studio API 密钥](https://aistudio.google.com/) - 设为 `GEMINI_API_KEY`。 。 。 .

## 环境变量

| 变量 | 目的 |
| --- | --- |
| `GEMINI_API_KEY` | API 实时通话( 除非 `MOCK=true`) (中文(简体) ). |
| `GEMINI_IMAGE_MODEL` | 覆盖默认图像模型( E)`gemini-3.1-flash-image`) (中文(简体) ). |
| `GEMINI_VIDEO_MODEL` | 覆盖默认 Omni 视频模型 (`gemini-omni-1.1-flash`) (中文(简体) ). |
| `GEMINI_VIDEO_POLL_TIMEOUT_MS` | Max 等会儿 `get_video_status.wait=true` (默认为60万ms. |
| `GEMINI_MEDIA_FETCH_TIMEOUT_MS` | 交互/ Files HTTP 调用( 默认 30000 ms) 的每个请求超时 . |

在建视频的投票间隔是 **`GEMINI_VIDEO_POLL_INTERVAL_MS` (5秒)** 使用时 `wait=true` 或文件 API 处理.

## 模拟模式

没有 API 密钥( 返回形状相同的固定数据) 运行 :

```bash
MOCK=true npx @fre4x/gemini
```

## 部署

```json
{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["-y", "@fre4x/gemini"],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## 页:1

-   **图像生成** 用纳米香蕉 `generateContent` 与 `responseModalities: ["IMAGE"]` 财务报告和审定财务报表 `imageConfig.aspectRatio` (不是图像). 检查 [AI 工作室](https://aistudio.google.com/) 为模型访问.
-   **视频生成** 使用该 [互动 API](https://ai.google.dev/api/interactions-api) 与 `x-goog-api-key` 页眉认证( 绝不 `?key=` 在 URL 上). 流量 : `generate_video` 打电话 `get_video_status` 每个~**5号** 直至 `done: true`,或通过 `wait=true` 进行状态检查直到完成.
-   工具错误包括 `recovery_class`数字 : **`agent_recoverable`** (用已更正的段落/模型重审) vs **`user_action_required`** (修改、认证、配额、, `requires_action`) (中文(简体) ).
-   `analyze_media` 接受 `file://` 从 URL 扩展名(jpg, png, mp4, mp3, wav, pdf等)中自动检测本地文件和 MIME 类型的路径 。 如果你遗漏 `prompt`,它默认为“描述此媒体”并使用 `gemini-3.8-flash` 默认.
-   `analyze_media` 拒绝已退休的文本模型化名,例如: `gemini-1.5-*` 财务报告和审定财务报表 `gemini-2.0-*`操作 `model`,使用当前支持的 `generateContent` 型号.
-   `output_dir` 打开 `generate_image` 财务报告和审定财务报表 `get_video_status` 将文件保存到磁盘中。 若不存在则创建目录.
-   模式默认故意被固定在最新核实的当前日期的双子座官方文件上. 不要用陈旧的模型知识取而代之.

## 发展

```bash
npm install
npm run dev      # tsx, no build
npm run build    # esbuild → dist/
npm test         # vitest unit tests
npm run inspector # MCP inspector in mock mode
```

## 许可证

麻省理工学院 - **我们是FRE4X.**

## 常见问题

### @fre4x/gemini 是什么？

提供多模式分析和图像/视频生成的双子座 MCP 服务器\.

### 如何安装 @fre4x/gemini？

在项目目录运行 npm install @fre4x/gemini，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 gemini，可以用 npx gemini 直接运行。

### @fre4x/gemini 支持 TypeScript 吗？

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

### @fre4x/gemini 支持 ESM 还是 CommonJS？

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

### @fre4x/gemini 需要什么版本的 Node\.js？

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

### @fre4x/gemini 可以商用吗？

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

### @fre4x/gemini 的下载量有多少？

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

### @fre4x/gemini 还在维护吗？

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