<div align="center">
<a href="https://v2.nonebot.dev/store"><img src="https://github.com/A-kirami/nonebot-plugin-template/blob/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo"></a>
<br>
<p><img src="https://github.com/A-kirami/nonebot-plugin-template/blob/resources/NoneBotPlugin.svg" width="240" alt="NoneBotPluginText"></p>
</div>
<div align="center">
# nonebot-plugin-FurIllustrated
_✨ 兽云祭官方API插件 ✨_
</a>
<a href="https://github.com/Ekac00/nonebot-plugin-RanFurryPic/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/Ekac00/nonebot-plugin-RanFurryPic.svg" alt="license">
</a>
<a href="https://pypi.python.org/pypi/nonebot-plugin-RanFurryPic">
<img src="https://img.shields.io/pypi/v/nonebot-plugin-RanFurryPic.svg" alt="pypi">
</a>
<img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
</div>
基于NoneBot2进行适配的FURRY图鉴（毛图，插画）插件
## 📖 介绍
本插件使用官方<a href="https://console-docs.apipost.cn/preview/6bf01cfebd3e5f96/c4e20a5d1a5db86c?target_id=83fb4f89-221c-4196-bb85-4abf73af73af"> API </a>进行编写，集成了随机兽图，名称查询，id查询，图片信息查询等一系列的吸毛功能。安装即用！！
如果你有兽云祭账号可以按照要求填入配置项来使用涉及账户操作相关功能。
若本插件存在bug请及时反馈~
目前只支持 onebotV11 暂时还未上传nonebot商店
## 💿 安装
<details open>
<summary>使用 nb-cli 安装（推荐）</summary>
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
```
nb plugin install nonebot-plugin-FurIllustrated
```
</details>
<details>
<summary>使用PIP安装</summary>
在 nonebot2 项目的插件目录下, 打开命令行, 输入安装命令
```
pip install nonebot-plugin-FurIllustrated
```
打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入
```
plugins = ["nonebot-plugin-FurIllustrated"]
```
</details>
## ⚙️ 配置
在 nonebot2 项目的`.env`文件中添加下表中的配置，不填任何配置则自动使用默认账户
```
# 你的兽云祭账户
syj_account = 账户
# 你的兽云祭密码
suj_password = 密码
# 令牌模式的token
image_token = 令牌
# 你的令牌用户名
image_token_user = "用户名"
# 你的令牌密码
image_token_key = "密码"
```
## 🎉 使用
### 指令表
| 指令 | 权限 | 是否需要参数 | 说明 |
| :--------: | :--: | :---------------: | :-------------------------: |
| 随机兽图 | 群员 | 否 | 随机获取一张兽图 |
| 来只 | 群员 | 可用sid或毛毛名字 | 根据名字或id搜图片 |
| 来只毛 | 群员 | 可空也可带名字 | 根据名字搜毛图 |
| 来只兽 | 群员 | 可空也可带名字 | 根据名字搜设定图 |
| 查sid | 群员 | 需要纯数字 | 根据关键字查询图片的sid列表 |
| 兽云搜索 | 群员 | 需要纯数字 | 查看此sid图片详情 |
| 兽云祭信息 | 群员 | 否 | 根据名字搜设定图 |
## 插件完成度
目前进度:
- [x] 随机毛图
- [x] 指定图片查询
- [x] 服务状态查询
- [x] 登录模块（自动登录）
- [ ] 上传图片
- [ ] 用户图片管理
Raw data
{
"_id": null,
"home_page": "https://github.com/huilongxiji/nonebot-plugin-FurIllustrated",
"name": "nonebot-plugin-FurIllustrated",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "huilongxiji",
"author_email": "huilongxiji <2601515849@qq.com>",
"download_url": "https://files.pythonhosted.org/packages/c7/fa/dd5588c96aa36fa0b69cde550adf1e555c89ed1be6e76acf8064f2cf1414/nonebot_plugin_furillustrated-1.4.0.tar.gz",
"platform": null,
"description": "<div align=\"center\">\r\n <a href=\"https://v2.nonebot.dev/store\"><img src=\"https://github.com/A-kirami/nonebot-plugin-template/blob/resources/nbp_logo.png\" width=\"180\" height=\"180\" alt=\"NoneBotPluginLogo\"></a>\r\n <br>\r\n <p><img src=\"https://github.com/A-kirami/nonebot-plugin-template/blob/resources/NoneBotPlugin.svg\" width=\"240\" alt=\"NoneBotPluginText\"></p>\r\n</div>\r\n\r\n<div align=\"center\">\r\n\r\n# nonebot-plugin-FurIllustrated\r\n\r\n_\u2728 \u517d\u4e91\u796d\u5b98\u65b9API\u63d2\u4ef6 \u2728_\r\n\r\n</a>\r\n<a href=\"https://github.com/Ekac00/nonebot-plugin-RanFurryPic/blob/main/LICENSE\">\r\n <img src=\"https://img.shields.io/github/license/Ekac00/nonebot-plugin-RanFurryPic.svg\" alt=\"license\">\r\n</a>\r\n<a href=\"https://pypi.python.org/pypi/nonebot-plugin-RanFurryPic\">\r\n <img src=\"https://img.shields.io/pypi/v/nonebot-plugin-RanFurryPic.svg\" alt=\"pypi\">\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\u57fa\u4e8eNoneBot2\u8fdb\u884c\u9002\u914d\u7684FURRY\u56fe\u9274\uff08\u6bdb\u56fe\uff0c\u63d2\u753b\uff09\u63d2\u4ef6\r\n\r\n## \ud83d\udcd6 \u4ecb\u7ecd\r\n\r\n\u672c\u63d2\u4ef6\u4f7f\u7528\u5b98\u65b9<a href=\"https://console-docs.apipost.cn/preview/6bf01cfebd3e5f96/c4e20a5d1a5db86c?target_id=83fb4f89-221c-4196-bb85-4abf73af73af\"> API </a>\u8fdb\u884c\u7f16\u5199\uff0c\u96c6\u6210\u4e86\u968f\u673a\u517d\u56fe\uff0c\u540d\u79f0\u67e5\u8be2\uff0cid\u67e5\u8be2\uff0c\u56fe\u7247\u4fe1\u606f\u67e5\u8be2\u7b49\u4e00\u7cfb\u5217\u7684\u5438\u6bdb\u529f\u80fd\u3002\u5b89\u88c5\u5373\u7528\uff01\uff01\r\n\u5982\u679c\u4f60\u6709\u517d\u4e91\u796d\u8d26\u53f7\u53ef\u4ee5\u6309\u7167\u8981\u6c42\u586b\u5165\u914d\u7f6e\u9879\u6765\u4f7f\u7528\u6d89\u53ca\u8d26\u6237\u64cd\u4f5c\u76f8\u5173\u529f\u80fd\u3002\r\n\u82e5\u672c\u63d2\u4ef6\u5b58\u5728bug\u8bf7\u53ca\u65f6\u53cd\u9988~\r\n\u76ee\u524d\u53ea\u652f\u6301 onebotV11 \u6682\u65f6\u8fd8\u672a\u4e0a\u4f20nonebot\u5546\u5e97\r\n\r\n## \ud83d\udcbf \u5b89\u88c5\r\n\r\n<details open>\r\n<summary>\u4f7f\u7528 nb-cli \u5b89\u88c5\uff08\u63a8\u8350\uff09</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```\r\nnb plugin install nonebot-plugin-FurIllustrated\r\n```\r\n\r\n</details>\r\n\r\n<details>\r\n<summary>\u4f7f\u7528PIP\u5b89\u88c5</summary>\r\n\u5728 nonebot2 \u9879\u76ee\u7684\u63d2\u4ef6\u76ee\u5f55\u4e0b, \u6253\u5f00\u547d\u4ee4\u884c, \u8f93\u5165\u5b89\u88c5\u547d\u4ee4\r\n\r\n```\r\npip install nonebot-plugin-FurIllustrated\r\n```\r\n\r\n\u6253\u5f00 nonebot2 \u9879\u76ee\u6839\u76ee\u5f55\u4e0b\u7684 `pyproject.toml` \u6587\u4ef6, \u5728 `[tool.nonebot]` \u90e8\u5206\u8ffd\u52a0\u5199\u5165\r\n\r\n```\r\nplugins = [\"nonebot-plugin-FurIllustrated\"]\r\n```\r\n\r\n</details>\r\n\r\n## \u2699\ufe0f \u914d\u7f6e\r\n\r\n\u5728 nonebot2 \u9879\u76ee\u7684`.env`\u6587\u4ef6\u4e2d\u6dfb\u52a0\u4e0b\u8868\u4e2d\u7684\u914d\u7f6e\uff0c\u4e0d\u586b\u4efb\u4f55\u914d\u7f6e\u5219\u81ea\u52a8\u4f7f\u7528\u9ed8\u8ba4\u8d26\u6237\r\n\r\n```\r\n# \u4f60\u7684\u517d\u4e91\u796d\u8d26\u6237\r\nsyj_account = \u8d26\u6237\r\n# \u4f60\u7684\u517d\u4e91\u796d\u5bc6\u7801\r\nsuj_password = \u5bc6\u7801\r\n# \u4ee4\u724c\u6a21\u5f0f\u7684token\r\nimage_token = \u4ee4\u724c\r\n# \u4f60\u7684\u4ee4\u724c\u7528\u6237\u540d\r\nimage_token_user = \"\u7528\u6237\u540d\"\r\n# \u4f60\u7684\u4ee4\u724c\u5bc6\u7801\r\nimage_token_key = \"\u5bc6\u7801\"\r\n```\r\n\r\n## \ud83c\udf89 \u4f7f\u7528\r\n\r\n### \u6307\u4ee4\u8868\r\n\r\n| \u6307\u4ee4 | \u6743\u9650 | \u662f\u5426\u9700\u8981\u53c2\u6570 | \u8bf4\u660e |\r\n| :--------: | :--: | :---------------: | :-------------------------: |\r\n| \u968f\u673a\u517d\u56fe | \u7fa4\u5458 | \u5426 | \u968f\u673a\u83b7\u53d6\u4e00\u5f20\u517d\u56fe |\r\n| \u6765\u53ea | \u7fa4\u5458 | \u53ef\u7528sid\u6216\u6bdb\u6bdb\u540d\u5b57 | \u6839\u636e\u540d\u5b57\u6216id\u641c\u56fe\u7247 |\r\n| \u6765\u53ea\u6bdb | \u7fa4\u5458 | \u53ef\u7a7a\u4e5f\u53ef\u5e26\u540d\u5b57 | \u6839\u636e\u540d\u5b57\u641c\u6bdb\u56fe |\r\n| \u6765\u53ea\u517d | \u7fa4\u5458 | \u53ef\u7a7a\u4e5f\u53ef\u5e26\u540d\u5b57 | \u6839\u636e\u540d\u5b57\u641c\u8bbe\u5b9a\u56fe |\r\n| \u67e5sid | \u7fa4\u5458 | \u9700\u8981\u7eaf\u6570\u5b57 | \u6839\u636e\u5173\u952e\u5b57\u67e5\u8be2\u56fe\u7247\u7684sid\u5217\u8868 |\r\n| \u517d\u4e91\u641c\u7d22 | \u7fa4\u5458 | \u9700\u8981\u7eaf\u6570\u5b57 | \u67e5\u770b\u6b64sid\u56fe\u7247\u8be6\u60c5 |\r\n| \u517d\u4e91\u796d\u4fe1\u606f | \u7fa4\u5458 | \u5426 | \u6839\u636e\u540d\u5b57\u641c\u8bbe\u5b9a\u56fe |\r\n\r\n## \u63d2\u4ef6\u5b8c\u6210\u5ea6\r\n\r\n\u76ee\u524d\u8fdb\u5ea6:\r\n\r\n- [x] \u968f\u673a\u6bdb\u56fe\r\n- [x] \u6307\u5b9a\u56fe\u7247\u67e5\u8be2\r\n- [x] \u670d\u52a1\u72b6\u6001\u67e5\u8be2\r\n- [x] \u767b\u5f55\u6a21\u5757\uff08\u81ea\u52a8\u767b\u5f55\uff09\r\n- [ ] \u4e0a\u4f20\u56fe\u7247\r\n- [ ] \u7528\u6237\u56fe\u7247\u7ba1\u7406\r\n\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\u57fa\u4e8eNoneBot2\u8fdb\u884c\u9002\u914d\u7684\u6bdb\u6bdb\u56fe\u9274\u63d2\u4ef6",
"version": "1.4.0",
"project_urls": {
"Bug Tracker": "https://github.com/huilongxiji/nonebot-plugin-FurIllustrated/issues",
"Homepage": "https://github.com/huilongxiji"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "41c35ba17ccf51500d21c2edca6a432eda97298c1a6ed1edd8c48c853c783e32",
"md5": "84dc1ad836db829c46c39b35f671f018",
"sha256": "606b0aca84dfe1d042a66359f23ea94188ab08588f2660265dd355c57c471069"
},
"downloads": -1,
"filename": "nonebot_plugin_FurIllustrated-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "84dc1ad836db829c46c39b35f671f018",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 11487,
"upload_time": "2024-10-30T18:16:24",
"upload_time_iso_8601": "2024-10-30T18:16:24.894039Z",
"url": "https://files.pythonhosted.org/packages/41/c3/5ba17ccf51500d21c2edca6a432eda97298c1a6ed1edd8c48c853c783e32/nonebot_plugin_FurIllustrated-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c7fadd5588c96aa36fa0b69cde550adf1e555c89ed1be6e76acf8064f2cf1414",
"md5": "a1b6342c8eb685566dc8fc72ca21e8f5",
"sha256": "6dc9f39681d6264d2199d22354a54e89ea91a1a09dbf86e2bca96a00499c9a91"
},
"downloads": -1,
"filename": "nonebot_plugin_furillustrated-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "a1b6342c8eb685566dc8fc72ca21e8f5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 11815,
"upload_time": "2024-10-30T18:16:25",
"upload_time_iso_8601": "2024-10-30T18:16:25.942786Z",
"url": "https://files.pythonhosted.org/packages/c7/fa/dd5588c96aa36fa0b69cde550adf1e555c89ed1be6e76acf8064f2cf1414/nonebot_plugin_furillustrated-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-30 18:16:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "huilongxiji",
"github_project": "nonebot-plugin-FurIllustrated",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nonebot-plugin-furillustrated"
}
JSON
