<div align="center">
# nonebot-plugin-sendpic
_✨ 基于图片api的发图插件，支持定时任务 ✨_
</a>
<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
</div>
## 📖 介绍
本插件使用Anosu API获取图片，API网站：https://docs.anosu.top/
支持关键词搜索、定时发送图片到群里
## 💿 安装
<summary>使用 nb-cli 安装</summary>
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
nb plugin install nonebot-plugin-sendpic
## ⚙️ 配置
单纯发送功能无需额外配置
如需设置定时发送，请在 nonebot2 项目的`.env`文件中添加下表中的所有配置
| 配置项 | 必填 | 默认值 | 说明 |
| :-------: | :--: | :----: | :-------------: |
| pic_num | 否 | 无 | 发图数量 |
| pic_tag | 否 | 无 | 图片关键词 |
| pic_time | 否 | 无 | 发图时间 |
| pic_group | 否 | 无 | 需要发送到的群号 |
其中，发图时间的配置请严格按照 `"x-hh-mm-ss"`的格式填写。
注：`x` 为定时模式，填"0"为每日定时发送，填"1"为按一定时间间隔发送
多个关键词请用 `|` 进行分隔
四个配置项均以列表形式填写，并 严格一一对应，例：
```
pic_num = [8,4,6]
pic_tag = ["御姐","","萝莉|金发"]
pic_time = ["0-18-00-00","0-08-00-00","1-00-00-30"]
pin_group = ["123456789","1145141919","123456789"]
```
上述配置表示
```
于每天18:00:00向群号123456789的群发送8张关键词为"御姐"的图
于每天08:00:00向群号1145141919的群发送4张无关键词的随机图
每隔00:00:30（即30秒）向群号123456789的群发送6张关键词为"萝莉"、"金发"的图
```
## 🎉 使用
发送 `发图` 即可获取随机图片，若bot有设置命令前缀，需加命令前缀，如 `/`
支持的参数：数量、关键词
使用方法： `发图 关键词 数量` ，多个关键词请用 `|` 进行分隔
不声明数量默认为1，不声明关键词则为随机发图
示例：
```
发图 原神 5
发图 碧蓝档案|爱丽丝
发图 3
```
定时发送功能目前只能在bot端配置
## 可能遇到的问题
### 定时任务不执行
可能是apscheduler线程数满了，可以尝试在`.env`文件中添加
```
apscheduler_config={ "apscheduler. executors. processpool": {"type": "processpool","max_workers":"61"},"apscheduler. job_defaults. coalesce":"false","apscheduler. job_defaults:misfire_grace_time":"60","apscheduler. job_defaults. max_instances":"61" }
```
## 将来可能支持的功能
□支持使用指令直接设置定时任务
□接入更多图片api
□编写插件自带指令文档
...
## 还有些想说的
本仓库使用了nonebot-plugin-template的模板，谨向作者表示感谢
本人为普通大学生，并非计算机类的专业，水平有限，如有问题或建议请直接发issue，如能解决我会尽量解决
Raw data
{
"_id": null,
"home_page": "https://github.com/Funny1Potato/nonebot-plugin-sendpic",
"name": "nonebot-plugin-sendpic",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Funny1Potato",
"author_email": "funny_potato@126.com",
"download_url": "https://files.pythonhosted.org/packages/ea/66/cb867de9d15084e790c2185103419958205d43585ef63fc993e3fe2d6f34/nonebot_plugin_sendpic-0.2.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\r\n\r\n# nonebot-plugin-sendpic\r\n\r\n_\u2728 \u57fa\u4e8e\u56fe\u7247api\u7684\u53d1\u56fe\u63d2\u4ef6\uff0c\u652f\u6301\u5b9a\u65f6\u4efb\u52a1 \u2728_\r\n\r\n\r\n\r\n</a>\r\n<img src=\"https://img.shields.io/badge/python-3.9+-blue.svg\" alt=\"python\">\r\n\r\n</div>\r\n\r\n\r\n\r\n## \ud83d\udcd6 \u4ecb\u7ecd\r\n\r\n\u672c\u63d2\u4ef6\u4f7f\u7528Anosu API\u83b7\u53d6\u56fe\u7247\uff0cAPI\u7f51\u7ad9\uff1ahttps://docs.anosu.top/\r\n\u652f\u6301\u5173\u952e\u8bcd\u641c\u7d22\u3001\u5b9a\u65f6\u53d1\u9001\u56fe\u7247\u5230\u7fa4\u91cc\r\n\r\n## \ud83d\udcbf \u5b89\u88c5\r\n\r\n\r\n<summary>\u4f7f\u7528 nb-cli \u5b89\u88c5</summary>\r\n\u5728 nonebot2 \u9879\u76ee\u7684\u6839\u76ee\u5f55\u4e0b\u6253\u5f00\u547d\u4ee4\u884c, \u8f93\u5165\u4ee5\u4e0b\u6307\u4ee4\u5373\u53ef\u5b89\u88c5\r\n\r\n nb plugin install nonebot-plugin-sendpic\r\n\r\n\r\n\r\n## \u2699\ufe0f \u914d\u7f6e\r\n\u5355\u7eaf\u53d1\u9001\u529f\u80fd\u65e0\u9700\u989d\u5916\u914d\u7f6e\r\n\u5982\u9700\u8bbe\u7f6e\u5b9a\u65f6\u53d1\u9001\uff0c\u8bf7\u5728 nonebot2 \u9879\u76ee\u7684`.env`\u6587\u4ef6\u4e2d\u6dfb\u52a0\u4e0b\u8868\u4e2d\u7684\u6240\u6709\u914d\u7f6e\r\n\r\n| \u914d\u7f6e\u9879 | \u5fc5\u586b | \u9ed8\u8ba4\u503c | \u8bf4\u660e |\r\n| :-------: | :--: | :----: | :-------------: |\r\n| pic_num | \u5426 | \u65e0 | \u53d1\u56fe\u6570\u91cf |\r\n| pic_tag | \u5426 | \u65e0 | \u56fe\u7247\u5173\u952e\u8bcd |\r\n| pic_time | \u5426 | \u65e0 | \u53d1\u56fe\u65f6\u95f4 |\r\n| pic_group | \u5426 | \u65e0 | \u9700\u8981\u53d1\u9001\u5230\u7684\u7fa4\u53f7 |\r\n\r\n\u5176\u4e2d\uff0c\u53d1\u56fe\u65f6\u95f4\u7684\u914d\u7f6e\u8bf7\u4e25\u683c\u6309\u7167 `\"x-hh-mm-ss\"`\u7684\u683c\u5f0f\u586b\u5199\u3002\r\n\u6ce8\uff1a`x` \u4e3a\u5b9a\u65f6\u6a21\u5f0f\uff0c\u586b\"0\"\u4e3a\u6bcf\u65e5\u5b9a\u65f6\u53d1\u9001\uff0c\u586b\"1\"\u4e3a\u6309\u4e00\u5b9a\u65f6\u95f4\u95f4\u9694\u53d1\u9001\r\n\r\n\u591a\u4e2a\u5173\u952e\u8bcd\u8bf7\u7528 `|` \u8fdb\u884c\u5206\u9694\r\n\r\n\u56db\u4e2a\u914d\u7f6e\u9879\u5747\u4ee5\u5217\u8868\u5f62\u5f0f\u586b\u5199\uff0c\u5e76 \u4e25\u683c\u4e00\u4e00\u5bf9\u5e94\uff0c\u4f8b\uff1a\r\n```\r\npic_num = [8,4,6]\r\npic_tag = [\"\u5fa1\u59d0\",\"\",\"\u841d\u8389|\u91d1\u53d1\"]\r\npic_time = [\"0-18-00-00\",\"0-08-00-00\",\"1-00-00-30\"]\r\npin_group = [\"123456789\",\"1145141919\",\"123456789\"]\r\n```\r\n\u4e0a\u8ff0\u914d\u7f6e\u8868\u793a\r\n```\r\n\u4e8e\u6bcf\u592918:00:00\u5411\u7fa4\u53f7123456789\u7684\u7fa4\u53d1\u90018\u5f20\u5173\u952e\u8bcd\u4e3a\"\u5fa1\u59d0\"\u7684\u56fe\r\n\u4e8e\u6bcf\u592908:00:00\u5411\u7fa4\u53f71145141919\u7684\u7fa4\u53d1\u90014\u5f20\u65e0\u5173\u952e\u8bcd\u7684\u968f\u673a\u56fe\r\n\u6bcf\u969400:00:30\uff08\u537330\u79d2\uff09\u5411\u7fa4\u53f7123456789\u7684\u7fa4\u53d1\u90016\u5f20\u5173\u952e\u8bcd\u4e3a\"\u841d\u8389\"\u3001\"\u91d1\u53d1\"\u7684\u56fe\r\n```\r\n## \ud83c\udf89 \u4f7f\u7528\r\n\u53d1\u9001 `\u53d1\u56fe` \u5373\u53ef\u83b7\u53d6\u968f\u673a\u56fe\u7247\uff0c\u82e5bot\u6709\u8bbe\u7f6e\u547d\u4ee4\u524d\u7f00\uff0c\u9700\u52a0\u547d\u4ee4\u524d\u7f00\uff0c\u5982 `/`\r\n\u652f\u6301\u7684\u53c2\u6570\uff1a\u6570\u91cf\u3001\u5173\u952e\u8bcd\r\n\u4f7f\u7528\u65b9\u6cd5\uff1a `\u53d1\u56fe \u5173\u952e\u8bcd \u6570\u91cf` \uff0c\u591a\u4e2a\u5173\u952e\u8bcd\u8bf7\u7528 `|` \u8fdb\u884c\u5206\u9694\r\n\u4e0d\u58f0\u660e\u6570\u91cf\u9ed8\u8ba4\u4e3a1\uff0c\u4e0d\u58f0\u660e\u5173\u952e\u8bcd\u5219\u4e3a\u968f\u673a\u53d1\u56fe\r\n\u793a\u4f8b\uff1a\r\n```\r\n\u53d1\u56fe \u539f\u795e 5\r\n\u53d1\u56fe \u78a7\u84dd\u6863\u6848|\u7231\u4e3d\u4e1d \r\n\u53d1\u56fe 3\r\n```\r\n\u5b9a\u65f6\u53d1\u9001\u529f\u80fd\u76ee\u524d\u53ea\u80fd\u5728bot\u7aef\u914d\u7f6e\r\n\r\n## \u53ef\u80fd\u9047\u5230\u7684\u95ee\u9898\r\n### \u5b9a\u65f6\u4efb\u52a1\u4e0d\u6267\u884c\r\n\u53ef\u80fd\u662fapscheduler\u7ebf\u7a0b\u6570\u6ee1\u4e86\uff0c\u53ef\u4ee5\u5c1d\u8bd5\u5728`.env`\u6587\u4ef6\u4e2d\u6dfb\u52a0\r\n```\r\napscheduler_config={ \"apscheduler. executors. processpool\": {\"type\": \"processpool\",\"max_workers\":\"61\"},\"apscheduler. job_defaults. coalesce\":\"false\",\"apscheduler. job_defaults:misfire_grace_time\":\"60\",\"apscheduler. job_defaults. max_instances\":\"61\" }\r\n```\r\n\r\n## \u5c06\u6765\u53ef\u80fd\u652f\u6301\u7684\u529f\u80fd\r\n\u25a1\u652f\u6301\u4f7f\u7528\u6307\u4ee4\u76f4\u63a5\u8bbe\u7f6e\u5b9a\u65f6\u4efb\u52a1\r\n\u25a1\u63a5\u5165\u66f4\u591a\u56fe\u7247api\r\n\u25a1\u7f16\u5199\u63d2\u4ef6\u81ea\u5e26\u6307\u4ee4\u6587\u6863\r\n...\r\n\r\n## \u8fd8\u6709\u4e9b\u60f3\u8bf4\u7684\r\n\u672c\u4ed3\u5e93\u4f7f\u7528\u4e86nonebot-plugin-template\u7684\u6a21\u677f\uff0c\u8c28\u5411\u4f5c\u8005\u8868\u793a\u611f\u8c22\r\n\u672c\u4eba\u4e3a\u666e\u901a\u5927\u5b66\u751f\uff0c\u5e76\u975e\u8ba1\u7b97\u673a\u7c7b\u7684\u4e13\u4e1a\uff0c\u6c34\u5e73\u6709\u9650\uff0c\u5982\u6709\u95ee\u9898\u6216\u5efa\u8bae\u8bf7\u76f4\u63a5\u53d1issue\uff0c\u5982\u80fd\u89e3\u51b3\u6211\u4f1a\u5c3d\u91cf\u89e3\u51b3\r\n",
"bugtrack_url": null,
"license": null,
"summary": "\u57fa\u4e8e\u56fe\u7247api\u7684nonebot\u53d1\u56fe\u63d2\u4ef6\uff0c\u652f\u6301\u5b9a\u65f6\u4efb\u52a1",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/Funny1Potato/nonebot-plugin-sendpic"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "94c80af17f17fb8d254beaa84761c5bc5ac59f6a32f71b822edea13ec0a12e14",
"md5": "c713c5a427d5e370793ab19c5efa0345",
"sha256": "1b985a6e8d2854be1424e46939b119a7618af309978bb4bc408448dd15365098"
},
"downloads": -1,
"filename": "nonebot_plugin_sendpic-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c713c5a427d5e370793ab19c5efa0345",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6887,
"upload_time": "2024-10-15T12:30:49",
"upload_time_iso_8601": "2024-10-15T12:30:49.051990Z",
"url": "https://files.pythonhosted.org/packages/94/c8/0af17f17fb8d254beaa84761c5bc5ac59f6a32f71b822edea13ec0a12e14/nonebot_plugin_sendpic-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ea66cb867de9d15084e790c2185103419958205d43585ef63fc993e3fe2d6f34",
"md5": "3e76b3a4d0e422cced476b16533154e4",
"sha256": "13ba2c437236e6344507ee92080678f52cf37a6a656d933cfa983149ea35a10b"
},
"downloads": -1,
"filename": "nonebot_plugin_sendpic-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "3e76b3a4d0e422cced476b16533154e4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6767,
"upload_time": "2024-10-15T12:30:50",
"upload_time_iso_8601": "2024-10-15T12:30:50.829256Z",
"url": "https://files.pythonhosted.org/packages/ea/66/cb867de9d15084e790c2185103419958205d43585ef63fc993e3fe2d6f34/nonebot_plugin_sendpic-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-15 12:30:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Funny1Potato",
"github_project": "nonebot-plugin-sendpic",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nonebot-plugin-sendpic"
}
JSON
