📖 介绍
支持图像分析、生成、编辑的 Gemini 对话插件，并且带有连续上下文，消息回复功能。
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-gemini-vision --upgrade
使用 pypi 源安装
nb plugin install nonebot-plugin-gemini-vision --upgrade -i "https://pypi.org/simple"
使用清华源安装
nb plugin install nonebot-plugin-gemini-vision --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令uv
uv add nonebot-plugin-gemini-vision
安装仓库 master 分支
uv add git+https://github.com/X-Zero-L/nonebot-plugin-gemini-vision@master
pdm
pdm add nonebot-plugin-gemini-vision
安装仓库 master 分支
pdm add git+https://github.com/X-Zero-L/nonebot-plugin-gemini-vision@master
poetry
poetry add nonebot-plugin-gemini-vision
安装仓库 master 分支
poetry add git+https://github.com/X-Zero-L/nonebot-plugin-gemini-vision@master
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot_plugin_gemini_vision"]
⚙️ 配置
在 nonebot2 项目的.env文件中添加下表中的必填配置
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| gemini_api_key | 是 | 无 | Gemini API 密钥，必须提供 |
| gemini_model | 否 | "gemini-2.5-flash-image-preview" | Gemini 模型名称，默认使用支持图像生成的模型 |
| gemini_preset | 否 | "" | 系统预设提示词，用于设置 AI 角色 |
如需要代理访问，在环境变量中设置HTTP_PROXY和HTTPS_PROXY或ALL_PROXY，如：
export HTTP_PROXY=localhost:7890
export HTTPS_PROXY=localhost:7890
export ALL_PROXY=localhost:7890
如使用 Windows 系统，设置环境变量的命令为：
set HTTP_PROXY=localhost:7890
set HTTPS_PROXY=localhost:7890
set ALL_PROXY=localhost:7890
🎉 使用
指令表
| 指令 | 权限 | 需要@ | 范围 | 说明 |
|---|---|---|---|---|
| /gemini <问题> | 所有人 | 否 | 私聊/群聊 | 与 Gemini 对话，可包含图片分析、编辑等功能 |
| @gemini <问题> | 所有人 | 是 | 私聊/群聊 | 同上，别名形式 |
| /g <问题> | 所有人 | 否 | 私聊/群聊 | 简短命令形式 |
| gemini <问题> | 所有人 | 否 | 私聊/群聊 | 无斜杠的简便形式 |
| /gemini 清除历史 | 所有人 | 否 | 私聊/群聊 | 清除当前用户的对话历史 |
| /gemini_help | 所有人 | 否 | 私聊/群聊 | 查看帮助信息 |
| /ghelp | 所有人 | 否 | 私聊/群聊 | 查看帮助信息的简短形式 |
特殊功能
- 图片分析：回复一张或多张图片发送问题，Gemini 将分析图片内容
- 图片生成：模型支持生成图片，直接提问即可生成相关图片，也支持上传图片进行编辑
- 连续对话：支持上下文连续对话，保持 10 分钟的会话状态
- 清除历史：使用"清除历史"、"clear"或"exit"命令可清除会话记录
使用示例
- 文本对话:
/gemini 介绍一下自己的功能 - 图片分析: 回复一张图片 +
/gemini 这张图片里有什么？ - 图片生成:
/gemini 画一幅夕阳下的海滩风景画 - 清除对话历史:
/gemini 清除历史 - 查看帮助:
/gemini_help
注意：图像生成功能需要使用支持该功能的 Gemini 模型，默认配置已选择支持图像生成的模型。
🎨 效果图
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-gemini-vision 1.0.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nonebot_plugin_gemini_vision-1.0.9.tar.gz | 9.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_gemini_vision-1.0.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 19.2 kB
Release files / nonebot_plugin_gemini_vision-1.0.9.tar.gz
| Download URL | nonebot_plugin_gemini_vision-1.0.9.tar.gz |
|---|---|
| Size | 9.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
304e92e7cbbfd943382830bfd82b48dff97c180a1e2930d8822f66cc5aba4efd
|
|
BLAKE2b-256 checksum How to use checksums |
a733ed159c41d71afabdc76851142399564838c6da876b31ba254ba7452e0225
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / nonebot_plugin_gemini_vision-1.0.9-py3-none-any.whl
| Download URL | nonebot_plugin_gemini_vision-1.0.9-py3-none-any.whl |
|---|---|
| Size | 9.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
718bc5848dc73a917dbc81e74528783912657bc53e552209eff468e3565cf236
|
|
BLAKE2b-256 checksum How to use checksums |
86a4d6d38b82f6a2a82ab9176ac09df0ba1c6d45f269a52d4a39fe394f8347c5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
