📖 介绍
「能不能好好说话？」—— 拼音首字母缩写翻译插件。
看不懂群友在说什么？直接问 bot 就行。支持主动查询、自然语言问句触发，以及开启后的自动划词翻译。数据来源：itorr/nbnhhsh。
🎨 效果图
 |
 |
 |
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-nbnhhsh --upgrade
使用 pypi 源安装
nb plugin install nonebot-plugin-nbnhhsh --upgrade -i "https://pypi.org/simple"
使用清华源安装
nb plugin install nonebot-plugin-nbnhhsh --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令uv
uv add nonebot-plugin-nbnhhsh
安装仓库 master 分支
uv add git+https://github.com/ByteColtX/nonebot-plugin-nbnhhsh@master
pdm
pdm add nonebot-plugin-nbnhhsh
安装仓库 master 分支
pdm add git+https://github.com/ByteColtX/nonebot-plugin-nbnhhsh@master
poetry
poetry add nonebot-plugin-nbnhhsh
安装仓库 master 分支
poetry add git+https://github.com/ByteColtX/nonebot-plugin-nbnhhsh@master
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot_plugin_nbnhhsh"]
使用 nbr 安装(使用 uv 管理依赖可用)
nbr 是一个基于 uv 的 nb-cli，可以方便地管理 nonebot2
nbr plugin install nonebot-plugin-nbnhhsh
使用 pypi 源安装
nbr plugin install nonebot-plugin-nbnhhsh -i "https://pypi.org/simple"
使用清华源安装
nbr plugin install nonebot-plugin-nbnhhsh -i "https://pypi.tuna.tsinghua.edu.cn/simple"
⚙️ 配置
在 nonebot2 项目的.env文件中添加下表中的必填配置
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
NBNHHSH_AUTO |
否 | false |
开启自动划词翻译，bot 会自动识别消息中的缩写并回复 |
NBNHHSH_AUTO_MIN_LEN |
否 | 2 |
自动划词触发的最短缩写长度 |
NBNHHSH_TIMEOUT |
否 | 10 |
设置 HTTP 请求的超时时间（秒） |
NBNHHSH_TEXT2PIC |
否 | true |
是否将翻译结果以图片形式发送，避免因敏感词导致消息无法发送 |
同时需要在 .env 中配置命令分隔符（空格）以支持子命令：
COMMAND_SEP=[" ", "."]
图片渲染：
NBNHHSH_TEXT2PIC=true时结果画成图片发送。画图是直接用 Pillow 画的， 字体优先用系统里已有的中文字体（如fonts-noto-cjk），找不到会自动下载一份NotoSansSC.ttf缓存到系统用户缓存目录的nonebot-plugin-nbnhhsh/子目录；想手动指定，把字体文件放到那个目录即可。 系统没有中文字体且下载失败时，插件会退回发纯文本，不会中断回复。
🎉 使用
指令表
| 指令 | 权限 | 需要@ | 范围 | 说明 |
|---|---|---|---|---|
/nbnhhsh <缩写> |
群员 | 否 | 群聊/私聊 | 翻译缩写，别名：/好好说话 /hhsh /缩写 |
/nbnhhsh submit <缩写> <文字> |
群员 | 否 | 群聊/私聊 | 提交缩写的对应文字，审核通过后生效 |
| 自然语言问句 | 群员 | 否 | 群聊/私聊 | 发送「xx是什么」「xx是啥」「xx啥意思」等自动触发查询 |
自然语言触发示例
以下问法均可触发查询，无需命令前缀：
yyds是什么
gkd是啥
nbcs啥意思
yyds是什么意思
自动划词
开启 NBNHHSH_AUTO=true 后，bot 会自动识别消息中出现的缩写并翻译，只回复有实际翻译结果的词条，暂未录入的词条不会触发回复。
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-nbnhhsh 0.2.1
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_nbnhhsh-0.2.1.tar.gz | 18.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_nbnhhsh-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.1 kB
Release files / nonebot_plugin_nbnhhsh-0.2.1.tar.gz
| Download URL | nonebot_plugin_nbnhhsh-0.2.1.tar.gz |
|---|---|
| Size | 18.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f14a8a68de36f78419bb889c23a28dbcc3008e74132d756f8713a2b55809cfe2
|
|
BLAKE2b-256 checksum How to use checksums |
fd9ae64d46a5a4243cce09ca9501378462b421deeeb5308af4edb6a13a9824b6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / nonebot_plugin_nbnhhsh-0.2.1-py3-none-any.whl
| Download URL | nonebot_plugin_nbnhhsh-0.2.1-py3-none-any.whl |
|---|---|
| Size | 20.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6dd44f24c176dde783459c696fa195b87eb0d818b84349f3a4d6ac8e50f4b0ff
|
|
BLAKE2b-256 checksum How to use checksums |
142a77afd8a1ec5485a1f240f901af7430cd769e736297d5838d0f7b9e16ca00
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
