nonebot-plugin-color

A specified color image generator for Nonebot2


Keywords
nonebot, nonebot2, color
License
MIT
Install
pip install nonebot-plugin-color==0.3.2

Documentation

NoneBotPluginLogo

NoneBotPluginText

NoneBot-Plugin-Color

✨ 用于生成指定色彩图片的 NoneBot2 插件 ✨

python pdm-managed
Pydantic Version 1 Or 2 license pypi pypi download
NoneBot Registry Supported Adapters

💿 安装

以下提到的方法 任选其一 即可

[推荐] 使用 nb-cli 安装 在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
nb plugin install nonebot-plugin-color
使用包管理器安装 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
pip
pip install nonebot-plugin-color
pdm
pdm add nonebot-plugin-color
poetry
poetry add nonebot-plugin-color
conda
conda install nonebot-plugin-color

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分的 plugins 项里追加写入

[tool.nonebot]
plugins = [
    # ...
    "nonebot_plugin_color"
]

⚙️ 配置

在 NoneBot2 项目的 .env 文件中添加下表中的必填配置

配置项 必填 默认值 说明
COLOR_REPLY True 是否回复用户消息
COLOR_SHOW_DESC True 是否在图片下方追加文字形式的颜色值便于复制使用
COLOR_SHOW_TEXT True 是否在生成的图片中显示色号
COLOR_ENABLE_ON_MESSAGE True 是否响应符合格式的非指令消息
COLOR_HEX_WITH_SIGN True 是否在 HEX 颜色代码前有 # 才进行响应
COLOR_ON_MESSAGE_PRIORITY 5 非指令消息响应优先级
COLOR_TEXT_BLACK_N_WHITE False 图片中的文字是否只使用黑色和白色

🎉 使用

插件基于 pydanticColor 类解析颜色,将下方支持的颜色值格式作为指令 color / 色图 的参数发送即可

  • 颜色别名:yellow / / 黄色(插件对部分中文颜色别名做了处理,支持的名称列表见 const.py
  • 十六进制(HEX):#ff0 / #ff0f / #ffff00 / #ffff00ff / 0xff0 / ff0
  • CSS RGB / RGBA:rgb(255, 255, 0) / rgba(255, 255, 255, 0.5)
  • CSS HSL:hsl(60, 100%, 50%) / hsl(60, 100%, 50%, 0.5)
  • RGB / RGBA(空格分隔):255 255 0 / 255 255 0 128 / 255 255 0 0.5(A 小于 1 时代表百分比)

插件还支持渐变色,将上面支持的颜色格式使用 ; 分隔即可生成渐变色图片,同样支持透明度,例:color f00;0f0;00f
不!够!色!我要五彩斑斓的黑和五颜六色的白!

哎哟这个色啊!好色!

色图来咯
色图又来咯

📞 联系

QQ:3076823485
Telegram:@lgc2333
吹水群:1105946125
邮箱:lgc2333@126.com

💡 鸣谢

💰 赞助

赞助我

感谢大家的赞助!你们的赞助将是我继续创作的动力!

📝 更新日志

0.4.2

  • 修复 #7 (可能)

0.4.1

  • 添加配置 COLOR_TEXT_BLACK_N_WHITE 以使图片中文字仅为黑色和白色
  • 优化渐变色展示

0.4.0

  • 适配 Pydantic V1 & V2

0.3.2

  • 新增配置项 COLOR_HEX_WITH_SIGN

0.3.1

  • 修复标题字号不会被正确缩小的 bug
  • 新增配置项 COLOR_SHOW_TEXT

0.3.0

  • 支持了渐变色(#1
  • 添加了一些配置项:
    • COLOR_REPLY
    • COLOR_SHOW_DESC
    • COLOR_ENABLE_ON_MESSAGE
    • COLOR_ON_MESSAGE_PRIORITY

0.2.0

  • 重构项目