📖 介绍
支持图像分析、生成、编辑的 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 模型,默认配置已选择支持图像生成的模型。
🎨 效果图
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| nonebot_plugin_gemini_vision-1.0.9.tar.gz | 9.5 kB | Without provenance | Details for nonebot_plugin_gemini_vision-1.0.9.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nonebot_plugin_gemini_vision-1.0.9-py3-none-any.whl | Python 3 | none | any | Details for nonebot_plugin_gemini_vision-1.0.9-py3-none-any.whl |
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
|
Security for nonebot-plugin-gemini-vision 1.0.9
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.