nonebot-plugin-taozi

图片化的有出处桃系词典与可选轻互动 NoneBot2 插件。

本项目是非官方粉丝插件。词典根据公开内容整理，明确显示所指对象、可信度、 语境边界、核验日期和代表出处；轻互动文案仅供娱乐，不冒充主播原话。正常回复会渲染 为 PNG 卡片，词典卡片附代表出处二维码；渲染失败时默认自动回退为纯文本。

功能

• 查询桃系词条，显示来源和语境边界；
• 使用 Skia 直接生成 PNG，无需安装 Chromium、Playwright 或启动浏览器；
• 卡片标题区使用基于 UID 6867955 当前公开头像角色绘制的淡背景插画；
• 词典图片附第一条代表出处的二维码，方便从图片继续查看来源；
• 从中、高可信度词条中随机抽取一个有出处的桃系词条，同一用户在同一群默认每小时一次；
• 每位用户的“今日桃签”当天固定，次日独立重新抽取，卡片标明昵称与账号；
• 内置 224 条研究启发的娱乐化桃签文案，覆盖 28 类内容主题，不冒充主播原话；
• 用户主动选择或取消自己的玩笑桃色，桃签会显示对应徽章、配色与附言；
• 群桃图鉴 只统计本群各桃色人数，不公开账号或昵称；
• 群主、群管理员或 NoneBot 超级用户可按群关闭轻互动；
• 关闭轻互动后，词典查询仍然可用；
• 状态使用 nonebot-plugin-localstore 持久化，不需要数据库。

内置 81 条词条：

黑桃、白桃、黄桃、红桃、桃纸、桃神、第八神桃神、头部主播、 五冠王、六冠王、Taoker、老农民、帽险家、师父、桃莱美、金桃曲、 桃曲、桃醉、耀斑、双玛头、哈基桃、学霸桃、小小桃大学习、AI 桃、 嘟嘟桃、桃区、桃国、叛桃、桃跑、桃犯、小小桃纸做小小的事、 保姆级、红字、不恰米、深度体验、币战、登神之路、纯萌新、 甜桃王朝、桃喆、Rap桃、突然的桃播、嚎桃、公式桃、软桃派、 黑桃猫猫、夹竹桃、黄桃大将军、今日桃李运势、桃神十曲、桃莱AI美、 蒙古包小区、桃神牛肉干、双桃狂喜、巴桃有别、小小桃是块砖、 A0翻车第一人、小黄鸭教、币战桃神、桃红温、大鹅运蛋、 桃声按摩大脑、小桃丝、快桃、桃饱、桃头、水蜜桃、每日桃哲、 满级萌新、桃神歌粉、星露谷歌姬、冰冷的648、 超击破、桃姥姥、水仙十字后遗症、芙芙厨、i达TV、米游大冒险、 德艺双馨小小桃、掉小珍珠、原学家命途

安装

使用 nb-cli：

nb plugin install nonebot-plugin-taozi

使用 pip：

pip install nonebot-plugin-taozi

使用 Poetry：

poetry add nonebot-plugin-taozi

从源码参与开发：

git clone https://github.com/TonyLiangP2010405/nonebot-plugin-taozi.git
cd nonebot-plugin-taozi
poetry install

在机器人项目的 pyproject.toml 中加载插件：

[tool.nonebot]
plugins = ["nonebot_plugin_taozi"]

运行要求

• Python 3.12 或 3.13
• NoneBot2 >=2.5.0
• OneBot V11 适配器

插件采用 OneBot V11，是因为群主和群管理员权限属于适配器能力。词典和互动核心逻辑 已与命令层分离，后续可以增加其他适配器入口。

图片由 skia-python 原生绘制。项目依赖支持 Python 3.12/3.13；部署前可在目标平台用 pip download --only-binary=:all: skia-python 检查当前解析版本是否提供预编译 wheel。

云端中文字体

插件会自动寻找常见中文字体。Linux 镜像建议安装 Noto CJK，例如 Debian/Ubuntu：

apt-get update && apt-get install -y fonts-noto-cjk

如果镜像中的字体位置不同，可以显式配置：

TAOZI_FONT=/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc

多个候选路径用半角分号分隔。字体缺失时插件仍会启动，并在日志中提示；若图片生成失败， 默认发送原始文字回复。

配置

所有配置均为可选项，插件可以零配置加载。

配置示例见 .env.example。

指令

所有指令都直接发送文本触发，不使用 /，也不受机器人项目 COMMAND_START 配置影响。 带参数指令使用一个或多个空格分隔指令名与参数。

词典卡片展示词条、所指对象、可信度、核验日期、解释、语境边界和代表出处；第一条来源 会生成二维码。关闭 TAOZI_LEXICON_SHOW_SOURCES 后，来源文字与二维码会同时隐藏。

自选桃色的边界

插件不会分析聊天内容，也不会自动给任何群友贴“黑桃”或“黑粉”标签。桃色只能由用户 主动选择，并且可以随时取消。桃色只改变桃签卡片的主题和附言，不改变抽签结果或概率； 群桃图鉴只展示统计数量。红桃的稳定社区含义尚未核实，选择它时插件会明确提示。

词典数据

词典位于：

nonebot_plugin_taozi/resources/lexicon.json

每个词条必须提供：

• 标准名称和别名；
• 解释与所指对象；
• 高、中或低可信度；
• 不应越过的解释边界；
• 最后核验日期；
• 至少一个 HTTPS 公开来源。

数据在插件加载时通过 Pydantic 校验。格式错误、重复别名或缺少来源会使测试失败，避免 把未经核验的说法静默带入发布版本。低可信词条仍可指定查询，但不会进入随机桃词池。

更完整的背景研究见 调研报告。 桃签扩充的主题证据、96 条内容与产品边界见 今日桃签扩充调研。 2026-08-01 第二轮扩充（66 条词条、160 条桃签、红桃与白桃含义核查）见 桃签桃词第二轮扩充调研。 2026-08-10 第三轮扩充（81 条词条、224 条桃签、随机池可信度分层）见 桃签桃词第三轮扩充调研。

开发与测试

poetry install
poetry run python -m compileall nonebot_plugin_taozi
poetry run pytest
poetry run ruff check .
poetry build

GitHub Actions 会分别在 Python 3.12 和 3.13 下执行。测试覆盖 PNG 生成和动态高度、 词典图片命令、别名与建议、每日桃签稳定性、冷却、桃色输入边界、状态持久化，以及 NoneBot 插件加载。

实现参考

图片渲染方案参考了 MIT 许可的 nonebot-plugin-daily-attendance： 沿用“Skia 原生绘制 + 系统中文字体探测 + 直接发送 PNG 字节”的部署思路。本插件的卡片 版式、动态高度、来源二维码、异步线程封装和降级逻辑均按自身需求实现。

隐私与版权

• 不收集聊天内容或构建群成员画像；
• 只保存群级互动开关和用户主动选择的桃色；
• 不直接内置或搬运主播音频、原始头像，不做 AI 声音克隆或第一人称拟态回复；
• 卡片角色图是依据账号当前公开头像重新绘制的非官方装饰素材，不表示主播授权；
• 来源链接指向原始 B 站页面，不搬运完整视频；
• 公开发布或使用名称、形象素材前，仍应确认授权和平台规则。

License

MIT