nonebot-plugin-taozi 0.2.0__tar.gz

nonebot_plugin_taozi-0.2.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 nonebot-plugin-taozi contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

nonebot_plugin_taozi-0.2.0/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-taozi
+Version: 0.2.0
+Summary: 图片化的有出处桃系词典与可选轻互动 NoneBot2 插件
+License-Expression: MIT
+License-File: LICENSE
+Keywords: nonebot,nonebot2,onebot,bilibili,taozi
+Author: TonyLiangP2010405
+Requires-Python: >=3.12,<3.14
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: nonebot-adapter-onebot (>=2.4.6,<3.0.0)
+Requires-Dist: nonebot-plugin-localstore (>=0.7.4,<1.0.0)
+Requires-Dist: nonebot2 (>=2.5.0,<3.0.0)
+Requires-Dist: pillow (>=11.0,<13.0)
+Requires-Dist: pydantic (>=2.0,<3.0)
+Requires-Dist: qrcode (>=8.2,<9.0)
+Requires-Dist: skia-python (>=144.0.post2,<145.0)
+Project-URL: Homepage, https://github.com/TonyLiangP2010405/nonebot-plugin-taozi
+Project-URL: Issues, https://github.com/TonyLiangP2010405/nonebot-plugin-taozi/issues
+Project-URL: Repository, https://github.com/TonyLiangP2010405/nonebot-plugin-taozi
+Description-Content-Type: text/markdown
+
+# nonebot-plugin-taozi
+
+图片化的有出处桃系词典与可选轻互动 NoneBot2 插件。
+
+本项目是**非官方粉丝插件**。词典根据公开内容整理，明确显示所指对象、可信度、
+语境边界、核验日期和代表出处；轻互动文案仅供娱乐，不冒充主播原话。正常回复会渲染
+为 PNG 卡片，词典卡片附代表出处二维码；渲染失败时默认自动回退为纯文本。
+
+## 功能
+
+- 查询桃系词条，显示来源和语境边界；
+- 使用 Skia 直接生成 PNG，无需安装 Chromium、Playwright 或启动浏览器；
+- 卡片标题区使用基于 UID `6867955` 当前公开头像角色绘制的淡背景插画；
+- 词典图片附第一条代表出处的二维码，方便从图片继续查看来源；
+- 随机抽取一个有出处的桃系词条；
+- 每位用户每天获得稳定一致的“今日桃签”；
+- 用户主动选择或取消自己的玩笑桃色；
+- 群主、群管理员或 NoneBot 超级用户可按群关闭轻互动；
+- 关闭轻互动后，词典查询仍然可用；
+- 状态使用 `nonebot-plugin-localstore` 持久化，不需要数据库。
+
+内置词条：
+
+`黑桃`、`白桃`、`黄桃`、`红桃`、`学霸桃`、`AI 桃`、`嘟嘟桃`
+
+## 安装
+
+使用 nb-cli：
+
+```bash
+nb plugin install nonebot-plugin-taozi
+```
+
+使用 pip：
+
+```bash
+pip install nonebot-plugin-taozi
+```
+
+使用 Poetry：
+
+```bash
+poetry add nonebot-plugin-taozi
+```
+
+从源码参与开发：
+
+```bash
+git clone https://github.com/TonyLiangP2010405/nonebot-plugin-taozi.git
+cd nonebot-plugin-taozi
+poetry install
+```
+
+在机器人项目的 `pyproject.toml` 中加载插件：
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot_plugin_taozi"]
+```
+
+## 运行要求
+
+- Python `3.12` 或 `3.13`
+- NoneBot2 `>=2.5.0`
+- OneBot V11 适配器
+
+插件采用 OneBot V11，是因为群主和群管理员权限属于适配器能力。词典和互动核心逻辑
+已与命令层分离，后续可以增加其他适配器入口。
+
+图片由 `skia-python` 原生绘制。锁定版本在 Linux x86_64、Linux aarch64、macOS 和
+Windows 上均提供 Python 3.12/3.13 预编译 wheel，云端不需要编译 Skia。
+
+### 云端中文字体
+
+插件会自动寻找常见中文字体。Linux 镜像建议安装 Noto CJK，例如 Debian/Ubuntu：
+
+```bash
+apt-get update && apt-get install -y fonts-noto-cjk
+```
+
+如果镜像中的字体位置不同，可以显式配置：
+
+```dotenv
+TAOZI_FONT=/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc
+```
+
+多个候选路径用半角分号分隔。字体缺失时插件仍会启动，并在日志中提示；若图片生成失败，
+默认发送原始文字回复。
+
+## 配置
+
+所有配置均为可选项，插件可以零配置加载。
+
+| 配置项 | 默认值 | 说明 |
+|---|---:|---|
+| `TAOZI_FUN_ENABLED` | `true` | 全局开启轻互动；关闭后词典仍可使用 |
+| `TAOZI_FUN_COOLDOWN_SECONDS` | `8` | 同一用户、同一互动指令的冷却秒数，范围 0–300 |
+| `TAOZI_LEXICON_SHOW_SOURCES` | `true` | 词典和随机词条是否显示来源链接 |
+| `TAOZI_TIMEZONE` | `Asia/Shanghai` | 今日桃签使用的日期时区 |
+| `TAOZI_IMAGE_ENABLED` | `true` | 将正常回复渲染为 PNG 图片 |
+| `TAOZI_IMAGE_FALLBACK_TEXT` | `true` | 图片生成失败时回退为纯文本 |
+| `TAOZI_FONT` | 空 | 可选中文字体路径；多个路径以分号分隔 |
+
+配置示例见 [`.env.example`](.env.example)。
+
+## 指令
+
+是否需要命令前缀取决于机器人项目的 `COMMAND_START` 配置。下表用 `/` 演示。
+
+| 指令 | 权限 | 范围 | 说明 |
+|---|---|---|---|
+| `/桃纸帮助` | 所有人 | 群聊/私聊 | 查看帮助 |
+| `/桃系词典` | 所有人 | 群聊/私聊 | 列出已收录词条 |
+| `/桃系词典 黑桃` | 所有人 | 群聊/私聊 | 查询解释、边界与出处 |
+| `/随机桃词` | 所有人 | 群聊/私聊 | 随机展示一个有出处的词条 |
+| `/今日桃签` | 所有人 | 群聊/私聊 | 获取当日稳定桃签 |
+| `/我的桃色` | 所有人 | 群聊/私聊 | 查看自己的自选桃色 |
+| `/我的桃色 黑桃` | 所有人 | 群聊/私聊 | 主动选择一个玩笑身份 |
+| `/我的桃色 取消` | 所有人 | 群聊/私聊 | 移除自选桃色 |
+| `/取消桃色` | 所有人 | 群聊/私聊 | 移除自选桃色的快捷指令 |
+| `/桃趣状态` | 所有人 | 群聊/私聊 | 查看当前会话的互动开关 |
+| `/桃趣 开启` | 群主/群管理/超级用户 | 群聊 | 开启本群轻互动 |
+| `/桃趣 关闭` | 群主/群管理/超级用户 | 群聊 | 关闭本群轻互动 |
+
+词典卡片展示词条、所指对象、可信度、核验日期、解释、语境边界和代表出处；第一条来源
+会生成二维码。关闭 `TAOZI_LEXICON_SHOW_SOURCES` 后，来源文字与二维码会同时隐藏。
+
+### 自选桃色的边界
+
+插件不会分析聊天内容，也不会自动给任何群友贴“黑桃”或“黑粉”标签。桃色只能由用户
+主动选择，并且可以随时取消。`红桃`的稳定社区含义尚未核实，选择它时插件会明确提示。
+
+## 词典数据
+
+词典位于：
+
+```text
+nonebot_plugin_taozi/resources/lexicon.json
+```
+
+每个词条必须提供：
+
+- 标准名称和别名；
+- 解释与所指对象；
+- 高、中或低可信度；
+- 不应越过的解释边界；
+- 最后核验日期；
+- 至少一个 HTTPS 公开来源。
+
+数据在插件加载时通过 Pydantic 校验。格式错误、重复别名或缺少来源会使测试失败，避免
+把未经核验的说法静默带入发布版本。
+
+更完整的背景研究见
+[调研报告](docs/小小桃纸哟_博主调研报告_2026-07-30.md)。
+
+## 开发与测试
+
+```bash
+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](https://github.com/TonyLiangP2010405/nonebot-plugin-daily-attendance)：
+沿用“Skia 原生绘制 + 系统中文字体探测 + 直接发送 PNG 字节”的部署思路。本插件的卡片
+版式、动态高度、来源二维码、异步线程封装和降级逻辑均按自身需求实现。
+
+## 隐私与版权
+
+- 不收集聊天内容或构建群成员画像；
+- 只保存群级互动开关和用户主动选择的桃色；
+- 不直接内置或搬运主播音频、原始头像，不做 AI 声音克隆或第一人称拟态回复；
+- 卡片角色图是依据账号当前公开头像重新绘制的非官方装饰素材，不表示主播授权；
+- 来源链接指向原始 B 站页面，不搬运完整视频；
+- 公开发布或使用名称、形象素材前，仍应确认授权和平台规则。
+
+## License
+
+[MIT](LICENSE)
+

nonebot_plugin_taozi-0.2.0/README.md

@@ -0,0 +1,188 @@
+# nonebot-plugin-taozi
+
+图片化的有出处桃系词典与可选轻互动 NoneBot2 插件。
+
+本项目是**非官方粉丝插件**。词典根据公开内容整理，明确显示所指对象、可信度、
+语境边界、核验日期和代表出处；轻互动文案仅供娱乐，不冒充主播原话。正常回复会渲染
+为 PNG 卡片，词典卡片附代表出处二维码；渲染失败时默认自动回退为纯文本。
+
+## 功能
+
+- 查询桃系词条，显示来源和语境边界；
+- 使用 Skia 直接生成 PNG，无需安装 Chromium、Playwright 或启动浏览器；
+- 卡片标题区使用基于 UID `6867955` 当前公开头像角色绘制的淡背景插画；
+- 词典图片附第一条代表出处的二维码，方便从图片继续查看来源；
+- 随机抽取一个有出处的桃系词条；
+- 每位用户每天获得稳定一致的“今日桃签”；
+- 用户主动选择或取消自己的玩笑桃色；
+- 群主、群管理员或 NoneBot 超级用户可按群关闭轻互动；
+- 关闭轻互动后，词典查询仍然可用；
+- 状态使用 `nonebot-plugin-localstore` 持久化，不需要数据库。
+
+内置词条：
+
+`黑桃`、`白桃`、`黄桃`、`红桃`、`学霸桃`、`AI 桃`、`嘟嘟桃`
+
+## 安装
+
+使用 nb-cli：
+
+```bash
+nb plugin install nonebot-plugin-taozi
+```
+
+使用 pip：
+
+```bash
+pip install nonebot-plugin-taozi
+```
+
+使用 Poetry：
+
+```bash
+poetry add nonebot-plugin-taozi
+```
+
+从源码参与开发：
+
+```bash
+git clone https://github.com/TonyLiangP2010405/nonebot-plugin-taozi.git
+cd nonebot-plugin-taozi
+poetry install
+```
+
+在机器人项目的 `pyproject.toml` 中加载插件：
+
+```toml
+[tool.nonebot]
+plugins = ["nonebot_plugin_taozi"]
+```
+
+## 运行要求
+
+- Python `3.12` 或 `3.13`
+- NoneBot2 `>=2.5.0`
+- OneBot V11 适配器
+
+插件采用 OneBot V11，是因为群主和群管理员权限属于适配器能力。词典和互动核心逻辑
+已与命令层分离，后续可以增加其他适配器入口。
+
+图片由 `skia-python` 原生绘制。锁定版本在 Linux x86_64、Linux aarch64、macOS 和
+Windows 上均提供 Python 3.12/3.13 预编译 wheel，云端不需要编译 Skia。
+
+### 云端中文字体
+
+插件会自动寻找常见中文字体。Linux 镜像建议安装 Noto CJK，例如 Debian/Ubuntu：
+
+```bash
+apt-get update && apt-get install -y fonts-noto-cjk
+```
+
+如果镜像中的字体位置不同，可以显式配置：
+
+```dotenv
+TAOZI_FONT=/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc
+```
+
+多个候选路径用半角分号分隔。字体缺失时插件仍会启动，并在日志中提示；若图片生成失败，
+默认发送原始文字回复。
+
+## 配置
+
+所有配置均为可选项，插件可以零配置加载。
+
+| 配置项 | 默认值 | 说明 |
+|---|---:|---|
+| `TAOZI_FUN_ENABLED` | `true` | 全局开启轻互动；关闭后词典仍可使用 |
+| `TAOZI_FUN_COOLDOWN_SECONDS` | `8` | 同一用户、同一互动指令的冷却秒数，范围 0–300 |
+| `TAOZI_LEXICON_SHOW_SOURCES` | `true` | 词典和随机词条是否显示来源链接 |
+| `TAOZI_TIMEZONE` | `Asia/Shanghai` | 今日桃签使用的日期时区 |
+| `TAOZI_IMAGE_ENABLED` | `true` | 将正常回复渲染为 PNG 图片 |
+| `TAOZI_IMAGE_FALLBACK_TEXT` | `true` | 图片生成失败时回退为纯文本 |
+| `TAOZI_FONT` | 空 | 可选中文字体路径；多个路径以分号分隔 |
+
+配置示例见 [`.env.example`](.env.example)。
+
+## 指令
+
+是否需要命令前缀取决于机器人项目的 `COMMAND_START` 配置。下表用 `/` 演示。
+
+| 指令 | 权限 | 范围 | 说明 |
+|---|---|---|---|
+| `/桃纸帮助` | 所有人 | 群聊/私聊 | 查看帮助 |
+| `/桃系词典` | 所有人 | 群聊/私聊 | 列出已收录词条 |
+| `/桃系词典 黑桃` | 所有人 | 群聊/私聊 | 查询解释、边界与出处 |
+| `/随机桃词` | 所有人 | 群聊/私聊 | 随机展示一个有出处的词条 |
+| `/今日桃签` | 所有人 | 群聊/私聊 | 获取当日稳定桃签 |
+| `/我的桃色` | 所有人 | 群聊/私聊 | 查看自己的自选桃色 |
+| `/我的桃色 黑桃` | 所有人 | 群聊/私聊 | 主动选择一个玩笑身份 |
+| `/我的桃色 取消` | 所有人 | 群聊/私聊 | 移除自选桃色 |
+| `/取消桃色` | 所有人 | 群聊/私聊 | 移除自选桃色的快捷指令 |
+| `/桃趣状态` | 所有人 | 群聊/私聊 | 查看当前会话的互动开关 |
+| `/桃趣 开启` | 群主/群管理/超级用户 | 群聊 | 开启本群轻互动 |
+| `/桃趣 关闭` | 群主/群管理/超级用户 | 群聊 | 关闭本群轻互动 |
+
+词典卡片展示词条、所指对象、可信度、核验日期、解释、语境边界和代表出处；第一条来源
+会生成二维码。关闭 `TAOZI_LEXICON_SHOW_SOURCES` 后，来源文字与二维码会同时隐藏。
+
+### 自选桃色的边界
+
+插件不会分析聊天内容，也不会自动给任何群友贴“黑桃”或“黑粉”标签。桃色只能由用户
+主动选择，并且可以随时取消。`红桃`的稳定社区含义尚未核实，选择它时插件会明确提示。
+
+## 词典数据
+
+词典位于：
+
+```text
+nonebot_plugin_taozi/resources/lexicon.json
+```
+
+每个词条必须提供：
+
+- 标准名称和别名；
+- 解释与所指对象；
+- 高、中或低可信度；
+- 不应越过的解释边界；
+- 最后核验日期；
+- 至少一个 HTTPS 公开来源。
+
+数据在插件加载时通过 Pydantic 校验。格式错误、重复别名或缺少来源会使测试失败，避免
+把未经核验的说法静默带入发布版本。
+
+更完整的背景研究见
+[调研报告](docs/小小桃纸哟_博主调研报告_2026-07-30.md)。
+
+## 开发与测试
+
+```bash
+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](https://github.com/TonyLiangP2010405/nonebot-plugin-daily-attendance)：
+沿用“Skia 原生绘制 + 系统中文字体探测 + 直接发送 PNG 字节”的部署思路。本插件的卡片
+版式、动态高度、来源二维码、异步线程封装和降级逻辑均按自身需求实现。
+
+## 隐私与版权
+
+- 不收集聊天内容或构建群成员画像；
+- 只保存群级互动开关和用户主动选择的桃色；
+- 不直接内置或搬运主播音频、原始头像，不做 AI 声音克隆或第一人称拟态回复；
+- 卡片角色图是依据账号当前公开头像重新绘制的非官方装饰素材，不表示主播授权；
+- 来源链接指向原始 B 站页面，不搬运完整视频；
+- 公开发布或使用名称、形象素材前，仍应确认授权和平台规则。
+
+## License
+
+[MIT](LICENSE)

nonebot_plugin_taozi-0.2.0/nonebot_plugin_taozi/__init__.py

@@ -0,0 +1,30 @@
+from nonebot import require
+from nonebot.plugin import PluginMetadata
+
+from .config import Config, plugin_config
+from .render import init_font_config
+
+require("nonebot_plugin_localstore")
+init_font_config(plugin_config.taozi_font)
+
+__plugin_meta__ = PluginMetadata(
+    name="桃纸助手",
+    description="图片化的有出处桃系词典与可选轻互动",
+    usage=(
+        "桃系词典 [词条]｜随机桃词｜今日桃签｜我的桃色 [桃色/取消]｜"
+        "桃趣状态｜桃趣 开启/关闭"
+    ),
+    type="application",
+    homepage="https://github.com/TonyLiangP2010405/nonebot-plugin-taozi",
+    config=Config,
+    supported_adapters={"~onebot.v11"},
+    extra={
+        "authoritative": False,
+        "disclaimer": "非官方粉丝插件；词条含义以公开来源和具体语境为准。",
+    },
+)
+
+from .commands import fun as fun
+from .commands import help as help
+from .commands import lexicon as lexicon
+from .commands import settings as settings

nonebot_plugin_taozi-0.2.0/nonebot_plugin_taozi/commands/__init__.py

@@ -0,0 +1,2 @@
+"""NoneBot command matchers for 桃纸助手."""
+

nonebot_plugin_taozi-0.2.0/nonebot_plugin_taozi/commands/common.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+from datetime import datetime
+from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
+
+import nonebot_plugin_localstore as store
+from nonebot.adapters.onebot.v11 import GroupMessageEvent, MessageEvent
+from nonebot.matcher import Matcher
+
+from ..config import plugin_config
+from ..fortune import Cooldown
+from ..output import finish_message_card
+from ..state import TaoziStateStore
+
+state_store = TaoziStateStore(store.get_plugin_data_file("state.json"))
+fun_cooldown = Cooldown(plugin_config.taozi_fun_cooldown_seconds)
+
+
+def get_group_id(event: MessageEvent) -> str | None:
+    if isinstance(event, GroupMessageEvent):
+        return str(event.group_id)
+    return None
+
+
+def get_scope_id(event: MessageEvent) -> str:
+    group_id = get_group_id(event)
+    if group_id is not None:
+        return f"group:{group_id}"
+    return f"private:{event.get_user_id()}"
+
+
+def get_today():
+    try:
+        timezone = ZoneInfo(plugin_config.taozi_timezone)
+    except ZoneInfoNotFoundError:
+        timezone = ZoneInfo("Asia/Shanghai")
+    return datetime.now(timezone).date()
+
+
+async def is_fun_enabled(event: MessageEvent) -> bool:
+    if not plugin_config.taozi_fun_enabled:
+        return False
+    group_id = get_group_id(event)
+    if group_id is None:
+        return True
+    return await state_store.is_group_enabled(group_id, default=True)
+
+
+async def require_fun(
+    matcher: type[Matcher],
+    event: MessageEvent,
+    *,
+    command_key: str,
+) -> None:
+    if not await is_fun_enabled(event):
+        await finish_message_card(
+            matcher,
+            "桃趣互动已关闭",
+            "本会话的桃趣互动已关闭；桃系词典仍可正常使用。",
+            chips=("词典仍可用",),
+        )
+
+    cooldown_key = f"{command_key}:{get_scope_id(event)}:{event.get_user_id()}"
+    remaining = fun_cooldown.acquire(cooldown_key)
+    if remaining > 0:
+        await finish_message_card(
+            matcher,
+            "稍等一下",
+            f"桃趣冷却中，请等待约 {remaining:.0f} 秒再试。",
+            chips=("冷却中",),
+        )

nonebot_plugin_taozi-0.2.0/nonebot_plugin_taozi/commands/fun.py

@@ -0,0 +1,144 @@
+import secrets
+
+from nonebot import on_command
+from nonebot.adapters.onebot.v11 import Message, MessageEvent
+from nonebot.params import CommandArg
+
+from ..config import plugin_config
+from ..fortune import pick_daily_fortune, render_fortune
+from ..interactions import (
+    ALLOWED_SELF_COLORS,
+    is_cancel_request,
+    parse_self_color,
+    render_color_selected,
+)
+from ..lexicon import BUILTIN_LEXICON, render_entry
+from ..output import finish_fortune_card, finish_lexicon_card, finish_message_card
+from .common import get_scope_id, get_today, require_fun, state_store
+
+daily_fortune = on_command(
+    "今日桃签",
+    aliases={"桃签"},
+    priority=10,
+    block=True,
+)
+random_term = on_command(
+    "随机桃词",
+    aliases={"随机桃梗"},
+    priority=10,
+    block=True,
+)
+self_color = on_command(
+    "我的桃色",
+    aliases={"我是桃"},
+    priority=10,
+    block=True,
+)
+cancel_color = on_command("取消桃色", priority=10, block=True)
+
+
+@daily_fortune.handle()
+async def handle_daily_fortune(event: MessageEvent) -> None:
+    await require_fun(daily_fortune, event, command_key="daily_fortune")
+    day = get_today()
+    fortune = pick_daily_fortune(event.get_user_id(), day)
+    await finish_fortune_card(
+        daily_fortune,
+        fortune,
+        day.isoformat(),
+        render_fortune(fortune),
+    )
+
+
+@random_term.handle()
+async def handle_random_term(event: MessageEvent) -> None:
+    await require_fun(random_term, event, command_key="random_term")
+    entry = secrets.choice(BUILTIN_LEXICON.entries)
+    await finish_lexicon_card(
+        random_term,
+        entry,
+        render_entry(
+            entry,
+            show_sources=plugin_config.taozi_lexicon_show_sources,
+            compact=True,
+        ),
+        compact=True,
+    )
+
+
+@self_color.handle()
+async def handle_self_color(event: MessageEvent, args: Message = CommandArg()) -> None:
+    await require_fun(self_color, event, command_key="self_color")
+    value = args.extract_plain_text().strip()
+    scope_id = get_scope_id(event)
+    user_id = event.get_user_id()
+
+    if not value:
+        selected = await state_store.get_self_color(scope_id, user_id)
+        if selected is None:
+            body = (
+                "你还没有自选桃色。\n"
+                f"可选：{'、'.join(ALLOWED_SELF_COLORS)}\n"
+                "用法：/我的桃色 黑桃"
+            )
+            await finish_message_card(
+                self_color,
+                "我的桃色",
+                body,
+                chips=("自愿选择", "随时取消"),
+            )
+        body = (
+            f"你当前自选的桃色是：{selected}。\n"
+            "这是插件内的自愿玩笑身份，不代表机器人评价。"
+        )
+        await finish_message_card(
+            self_color,
+            "我的桃色",
+            body,
+            chips=(selected or "未选择", "自愿选择"),
+        )
+
+    if is_cancel_request(value):
+        removed = await state_store.remove_self_color(scope_id, user_id)
+        message = "已取消你的自选桃色。" if removed else "你目前没有自选桃色。"
+        await finish_message_card(
+            self_color,
+            "桃色设置",
+            message,
+            chips=("已更新",),
+        )
+
+    color = parse_self_color(value)
+    if color is None:
+        body = (
+            f"不支持“{value}”。可选桃色：{'、'.join(ALLOWED_SELF_COLORS)}；"
+            "也可以发送“/我的桃色 取消”。"
+        )
+        await finish_message_card(
+            self_color,
+            "无法识别桃色",
+            body,
+            chips=("请重新选择",),
+        )
+
+    await state_store.set_self_color(scope_id, user_id, color)
+    await finish_message_card(
+        self_color,
+        "桃色设置成功",
+        render_color_selected(color),
+        chips=(color, "自愿选择"),
+        footer="这只是插件内的玩笑身份；发送“/我的桃色 取消”即可移除。",
+    )
+
+
+@cancel_color.handle()
+async def handle_cancel_color(event: MessageEvent) -> None:
+    await require_fun(cancel_color, event, command_key="cancel_color")
+    removed = await state_store.remove_self_color(get_scope_id(event), event.get_user_id())
+    message = "已取消你的自选桃色。" if removed else "你目前没有自选桃色。"
+    await finish_message_card(
+        cancel_color,
+        "桃色设置",
+        message,
+        chips=("已更新",),
+    )