📖 介绍
「能不能好好说话？」—— 拼音首字母缩写翻译插件。
看不懂群友在说什么？直接问 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 |
否 | false |
是否将翻译结果以图片形式发送，避免因敏感词导致消息无法发送 |
同时需要在 .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.0
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.0.tar.gz | 18.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_nbnhhsh-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 37.9 kB
Release files / nonebot_plugin_nbnhhsh-0.2.0.tar.gz
| Download URL | nonebot_plugin_nbnhhsh-0.2.0.tar.gz |
|---|---|
| Size | 18.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72341b4a83e6612bb996b6a7412ecc4fca221c3f0aa7e2840b21b4112c34cb0b
|
|
BLAKE2b-256 checksum How to use checksums |
d702f2d19b0555483e02851a626cdea300b01b216bcddffad6ffe050b10c94d5
|
| 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.0-py3-none-any.whl
| Download URL | nonebot_plugin_nbnhhsh-0.2.0-py3-none-any.whl |
|---|---|
| Size | 19.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
202853d2255eca988d0742518891d75cf836689d13907f41ae3fc6262a244338
|
|
BLAKE2b-256 checksum How to use checksums |
a75a9bce6d61ec938b6a56c3ed2748fd6d47fa77adbaa86b4ace667e721bff8e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
