<div align="center">
# Tarot
_🔮 塔罗牌 🔮_
</div>
<p align="center">
<a href="https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/blob/master/LICENSE">
<img src="https://img.shields.io/github/license/MinatoAquaCrews/nonebot_plugin_tarot?color=blue">
</a>
<a href="https://github.com/nonebot/nonebot2">
<img src="https://img.shields.io/badge/nonebot2-2.0.0b3+-green">
</a>
<a href="https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/releases/tag/v0.4.0.post3">
<img src="https://img.shields.io/github/v/release/MinatoAquaCrews/nonebot_plugin_tarot?color=orange">
</a>
<a href="https://www.codefactor.io/repository/github/MinatoAquaCrews/nonebot_plugin_tarot">
<img src="https://img.shields.io/codefactor/grade/github/MinatoAquaCrews/nonebot_plugin_tarot/master?color=red">
</a>
<a href="https://github.com/MinatoAquaCrews/nonebot_plugin_tarot">
<img src="https://img.shields.io/pypi/dm/nonebot_plugin_tarot">
</a>
<a href="https://results.pre-commit.ci/latest/github/MinatoAquaCrews/nonebot_plugin_tarot/master">
<img src="https://results.pre-commit.ci/badge/github/MinatoAquaCrews/nonebot_plugin_tarot/master.svg" alt="pre-commit.ci status">
</a>
</p>
## 序
_“许多傻瓜对千奇百怪的迷信说法深信不疑：象牙、护身符、黑猫、打翻的盐罐、驱邪、占卜、符咒、毒眼、塔罗牌、星象、水晶球、咖啡渣、手相、预兆、预言还有星座。”——《人类愚蠢辞典》_
## 版本
🧰 [v0.4.0.post3](https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/releases/tag/v0.4.0.post3)
⚠ 适配nonebot2-2.0.0b3+
👉 [如何添加新的塔罗牌主题资源？](./How-to-add-new-tarot-theme.md)欢迎贡献！🙏
## 安装
1. 通过 `pip` 或 `nb` 安装。pypi无法发行过大安装包，由此安装的插件不包含 `./resource` 下**所有塔罗牌主题资源**。请在[v0.4.0 release](https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/releases/tag/v0.4.0)页面下载各主题资源，部署至本地后修改 `TAROT_PATH` 配置即可；
2. `env` 下设置 `TAROT_PATH` 以更改资源路径；`CHAIN_REPLY` 设置全局群聊转发模式（避免刷屏），亦可通过命令修改；`TAROT_AUTO_UPDATE` 开启则插件将在启动时自动检查更新（默认关闭）。例如：
```python
TAROT_PATH="path-to-your-resource"
CHAIN_REPLY=false
TAROT_AUTO_UPDATE=false
```
⚠ 请为塔罗牌资源分配单独的目录存放！即某一目录下仅有塔罗牌的所有资源。[#26](https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/issues/26)
3. 启动时，插件会自动下载repo中最新的 `tarot.json` 文件，`tarot.json` 不一定随插件版本更新；
4. 图片资源可选择**不部署在本地**，插件会自动尝试从repo中下载缓存。
⚠ 使用 `raw.fgit.ml` 进行下载，不确保次次成功
## 命令
1. 启用牌阵进行占卜：[占卜]；
2. 得到单张塔罗牌回应：[塔罗牌]；
3. [超管] 群聊转发模式全局开关：[开启|启用|关闭|禁用] 群聊转发模式，可降低风控风险。
## 资源说明
1. 韦特塔罗(Waite Tarot)包括22张大阿卡纳(Major Arcana)牌与权杖(Wands)、星币(Pentacles)、圣杯(Cups)、宝剑(Swords)各系14张的小阿卡纳(Minor Arcana)共56张牌组成，其中国王、皇后、骑士、侍从也称为宫廷牌(Court Cards)；
- BilibiliTarot：B站幻星集主题塔罗牌
- TouhouTarot：东方主题塔罗牌，仅包含大阿卡纳
⚠ 资源中额外四张王牌(Ace)不在体系中，因此不会在占卜时用到，因为小阿卡纳中各系均有Ace牌，但可以自行收藏。
2. `tarot.json`中对牌阵，抽牌张数、是否有切牌、各牌正逆位解读进行说明。`cards` 字段下对所有塔罗牌做了正逆位含义与资源路径的说明；
3. 根据牌阵的不同有不同的塔罗牌解读，同时也与问卜者的问题、占卜者的解读等因素相关，因此不存在所谓的解读方式正确与否。`cards` 字段下的正逆位含义参考以下以及其他网络资源：
- 《棱镜/耀光塔罗牌中文翻译》，中华塔罗会馆(CNTAROT)，版权原因恕不提供
- [AlerHugu3s/PluginVoodoo](https://github.com/AlerHugu3s/PluginVoodoo/blob/master/data/PluginVoodoo/TarotData/Tarots.json)
- [塔罗.中国](https://tarotchina.net/)
- [塔罗牌](http://www.taluo.org/)
- [灵匣](https://www.lnka.cn/)
🤔 也可以说是作者的解读版本
4. 牌面资源下载：
- BilibiliTarot：[阿里云盘](https://www.aliyundrive.com/s/cvbxLQQ9wD5/folder/61000cc1c78a1da52ef548beb9591a01bdb09a79)
⚠ 文件夹名称、大阿卡纳恶魔牌(The Devil)名称、权杖4名称、女皇牌(The Empress)名称有修改
- TouhouTarot：[Oeeder/PluginVoodoo-Touhou](https://github.com/Oeeder/PluginVoodoo-Touhou/releases/tag/PluginVoodoo)，原作：[燕山/切り絵東方タロットカード大アルカナ22枚](https://www.pixiv.net/artworks/93632047)
⚠ 文件名称有修改
## 本插件改自
1. [真寻bot插件库/tarot](https://github.com/AkashiCoin/nonebot_plugins_zhenxun_bot)
2. [haha114514/tarot_hoshino](https://github.com/haha114514/tarot_hoshino)
Raw data
{
"_id": null,
"home_page": "https://github.com/MinatoAquaCrews/nonebot_plugin_tarot",
"name": "nonebot-plugin-tarot",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "nonebot2,nonebot-plugin,Tarot,MinatoAquaCrews",
"author": "KafCoppelia",
"author_email": "k740677208@gmail.com",
"download_url": "",
"platform": null,
"description": "<div align=\"center\">\n\n# Tarot\n\n_\ud83d\udd2e \u5854\u7f57\u724c \ud83d\udd2e_\n\n</div>\n\n<p align=\"center\">\n\n <a href=\"https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/blob/master/LICENSE\">\n <img src=\"https://img.shields.io/github/license/MinatoAquaCrews/nonebot_plugin_tarot?color=blue\">\n </a>\n\n <a href=\"https://github.com/nonebot/nonebot2\">\n <img src=\"https://img.shields.io/badge/nonebot2-2.0.0b3+-green\">\n </a>\n\n <a href=\"https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/releases/tag/v0.4.0.post3\">\n <img src=\"https://img.shields.io/github/v/release/MinatoAquaCrews/nonebot_plugin_tarot?color=orange\">\n </a>\n\n <a href=\"https://www.codefactor.io/repository/github/MinatoAquaCrews/nonebot_plugin_tarot\">\n <img src=\"https://img.shields.io/codefactor/grade/github/MinatoAquaCrews/nonebot_plugin_tarot/master?color=red\">\n </a>\n\n <a href=\"https://github.com/MinatoAquaCrews/nonebot_plugin_tarot\">\n <img src=\"https://img.shields.io/pypi/dm/nonebot_plugin_tarot\">\n </a>\n\n <a href=\"https://results.pre-commit.ci/latest/github/MinatoAquaCrews/nonebot_plugin_tarot/master\">\n\t<img src=\"https://results.pre-commit.ci/badge/github/MinatoAquaCrews/nonebot_plugin_tarot/master.svg\" alt=\"pre-commit.ci status\">\n </a>\n\n</p>\n\n## \u5e8f\n\n_\u201c\u8bb8\u591a\u50bb\u74dc\u5bf9\u5343\u5947\u767e\u602a\u7684\u8ff7\u4fe1\u8bf4\u6cd5\u6df1\u4fe1\u4e0d\u7591\uff1a\u8c61\u7259\u3001\u62a4\u8eab\u7b26\u3001\u9ed1\u732b\u3001\u6253\u7ffb\u7684\u76d0\u7f50\u3001\u9a71\u90aa\u3001\u5360\u535c\u3001\u7b26\u5492\u3001\u6bd2\u773c\u3001\u5854\u7f57\u724c\u3001\u661f\u8c61\u3001\u6c34\u6676\u7403\u3001\u5496\u5561\u6e23\u3001\u624b\u76f8\u3001\u9884\u5146\u3001\u9884\u8a00\u8fd8\u6709\u661f\u5ea7\u3002\u201d\u2014\u2014\u300a\u4eba\u7c7b\u611a\u8822\u8f9e\u5178\u300b_\n\n## \u7248\u672c\n\n\ud83e\uddf0 [v0.4.0.post3](https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/releases/tag/v0.4.0.post3)\n\n\u26a0 \u9002\u914dnonebot2-2.0.0b3+\n\n\ud83d\udc49 [\u5982\u4f55\u6dfb\u52a0\u65b0\u7684\u5854\u7f57\u724c\u4e3b\u9898\u8d44\u6e90\uff1f](./How-to-add-new-tarot-theme.md)\u6b22\u8fce\u8d21\u732e\uff01\ud83d\ude4f\n\n## \u5b89\u88c5\n\n1. \u901a\u8fc7 `pip` \u6216 `nb` \u5b89\u88c5\u3002pypi\u65e0\u6cd5\u53d1\u884c\u8fc7\u5927\u5b89\u88c5\u5305\uff0c\u7531\u6b64\u5b89\u88c5\u7684\u63d2\u4ef6\u4e0d\u5305\u542b `./resource` \u4e0b**\u6240\u6709\u5854\u7f57\u724c\u4e3b\u9898\u8d44\u6e90**\u3002\u8bf7\u5728[v0.4.0 release](https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/releases/tag/v0.4.0)\u9875\u9762\u4e0b\u8f7d\u5404\u4e3b\u9898\u8d44\u6e90\uff0c\u90e8\u7f72\u81f3\u672c\u5730\u540e\u4fee\u6539 `TAROT_PATH` \u914d\u7f6e\u5373\u53ef\uff1b\n\n2. `env` \u4e0b\u8bbe\u7f6e `TAROT_PATH` \u4ee5\u66f4\u6539\u8d44\u6e90\u8def\u5f84\uff1b`CHAIN_REPLY` \u8bbe\u7f6e\u5168\u5c40\u7fa4\u804a\u8f6c\u53d1\u6a21\u5f0f\uff08\u907f\u514d\u5237\u5c4f\uff09\uff0c\u4ea6\u53ef\u901a\u8fc7\u547d\u4ee4\u4fee\u6539\uff1b`TAROT_AUTO_UPDATE` \u5f00\u542f\u5219\u63d2\u4ef6\u5c06\u5728\u542f\u52a8\u65f6\u81ea\u52a8\u68c0\u67e5\u66f4\u65b0\uff08\u9ed8\u8ba4\u5173\u95ed\uff09\u3002\u4f8b\u5982\uff1a\n\n ```python\n TAROT_PATH=\"path-to-your-resource\"\n CHAIN_REPLY=false\n TAROT_AUTO_UPDATE=false\n ```\n\n \u26a0 \u8bf7\u4e3a\u5854\u7f57\u724c\u8d44\u6e90\u5206\u914d\u5355\u72ec\u7684\u76ee\u5f55\u5b58\u653e\uff01\u5373\u67d0\u4e00\u76ee\u5f55\u4e0b\u4ec5\u6709\u5854\u7f57\u724c\u7684\u6240\u6709\u8d44\u6e90\u3002[#26](https://github.com/MinatoAquaCrews/nonebot_plugin_tarot/issues/26)\n\n3. \u542f\u52a8\u65f6\uff0c\u63d2\u4ef6\u4f1a\u81ea\u52a8\u4e0b\u8f7drepo\u4e2d\u6700\u65b0\u7684 `tarot.json` \u6587\u4ef6\uff0c`tarot.json` \u4e0d\u4e00\u5b9a\u968f\u63d2\u4ef6\u7248\u672c\u66f4\u65b0\uff1b\n\n4. \u56fe\u7247\u8d44\u6e90\u53ef\u9009\u62e9**\u4e0d\u90e8\u7f72\u5728\u672c\u5730**\uff0c\u63d2\u4ef6\u4f1a\u81ea\u52a8\u5c1d\u8bd5\u4ecerepo\u4e2d\u4e0b\u8f7d\u7f13\u5b58\u3002\n\n \u26a0 \u4f7f\u7528 `raw.fgit.ml` \u8fdb\u884c\u4e0b\u8f7d\uff0c\u4e0d\u786e\u4fdd\u6b21\u6b21\u6210\u529f\n\n## \u547d\u4ee4\n\n1. \u542f\u7528\u724c\u9635\u8fdb\u884c\u5360\u535c\uff1a[\u5360\u535c]\uff1b\n\n2. \u5f97\u5230\u5355\u5f20\u5854\u7f57\u724c\u56de\u5e94\uff1a[\u5854\u7f57\u724c]\uff1b\n\n3. [\u8d85\u7ba1] \u7fa4\u804a\u8f6c\u53d1\u6a21\u5f0f\u5168\u5c40\u5f00\u5173\uff1a[\u5f00\u542f|\u542f\u7528|\u5173\u95ed|\u7981\u7528] \u7fa4\u804a\u8f6c\u53d1\u6a21\u5f0f\uff0c\u53ef\u964d\u4f4e\u98ce\u63a7\u98ce\u9669\u3002\n\n## \u8d44\u6e90\u8bf4\u660e\n\n1. \u97e6\u7279\u5854\u7f57(Waite Tarot)\u5305\u62ec22\u5f20\u5927\u963f\u5361\u7eb3(Major Arcana)\u724c\u4e0e\u6743\u6756(Wands)\u3001\u661f\u5e01(Pentacles)\u3001\u5723\u676f(Cups)\u3001\u5b9d\u5251(Swords)\u5404\u7cfb14\u5f20\u7684\u5c0f\u963f\u5361\u7eb3(Minor Arcana)\u517156\u5f20\u724c\u7ec4\u6210\uff0c\u5176\u4e2d\u56fd\u738b\u3001\u7687\u540e\u3001\u9a91\u58eb\u3001\u4f8d\u4ece\u4e5f\u79f0\u4e3a\u5bab\u5ef7\u724c(Court Cards)\uff1b\n\n - BilibiliTarot\uff1aB\u7ad9\u5e7b\u661f\u96c6\u4e3b\u9898\u5854\u7f57\u724c\n - TouhouTarot\uff1a\u4e1c\u65b9\u4e3b\u9898\u5854\u7f57\u724c\uff0c\u4ec5\u5305\u542b\u5927\u963f\u5361\u7eb3\n\n \u26a0 \u8d44\u6e90\u4e2d\u989d\u5916\u56db\u5f20\u738b\u724c(Ace)\u4e0d\u5728\u4f53\u7cfb\u4e2d\uff0c\u56e0\u6b64\u4e0d\u4f1a\u5728\u5360\u535c\u65f6\u7528\u5230\uff0c\u56e0\u4e3a\u5c0f\u963f\u5361\u7eb3\u4e2d\u5404\u7cfb\u5747\u6709Ace\u724c\uff0c\u4f46\u53ef\u4ee5\u81ea\u884c\u6536\u85cf\u3002\n\n2. `tarot.json`\u4e2d\u5bf9\u724c\u9635\uff0c\u62bd\u724c\u5f20\u6570\u3001\u662f\u5426\u6709\u5207\u724c\u3001\u5404\u724c\u6b63\u9006\u4f4d\u89e3\u8bfb\u8fdb\u884c\u8bf4\u660e\u3002`cards` \u5b57\u6bb5\u4e0b\u5bf9\u6240\u6709\u5854\u7f57\u724c\u505a\u4e86\u6b63\u9006\u4f4d\u542b\u4e49\u4e0e\u8d44\u6e90\u8def\u5f84\u7684\u8bf4\u660e\uff1b\n\n3. \u6839\u636e\u724c\u9635\u7684\u4e0d\u540c\u6709\u4e0d\u540c\u7684\u5854\u7f57\u724c\u89e3\u8bfb\uff0c\u540c\u65f6\u4e5f\u4e0e\u95ee\u535c\u8005\u7684\u95ee\u9898\u3001\u5360\u535c\u8005\u7684\u89e3\u8bfb\u7b49\u56e0\u7d20\u76f8\u5173\uff0c\u56e0\u6b64\u4e0d\u5b58\u5728\u6240\u8c13\u7684\u89e3\u8bfb\u65b9\u5f0f\u6b63\u786e\u4e0e\u5426\u3002`cards` \u5b57\u6bb5\u4e0b\u7684\u6b63\u9006\u4f4d\u542b\u4e49\u53c2\u8003\u4ee5\u4e0b\u4ee5\u53ca\u5176\u4ed6\u7f51\u7edc\u8d44\u6e90\uff1a\n\n - \u300a\u68f1\u955c/\u8000\u5149\u5854\u7f57\u724c\u4e2d\u6587\u7ffb\u8bd1\u300b\uff0c\u4e2d\u534e\u5854\u7f57\u4f1a\u9986(CNTAROT)\uff0c\u7248\u6743\u539f\u56e0\u6055\u4e0d\u63d0\u4f9b\n - [AlerHugu3s/PluginVoodoo](https://github.com/AlerHugu3s/PluginVoodoo/blob/master/data/PluginVoodoo/TarotData/Tarots.json)\n - [\u5854\u7f57.\u4e2d\u56fd](https://tarotchina.net/)\n - [\u5854\u7f57\u724c](http://www.taluo.org/)\n - [\u7075\u5323](https://www.lnka.cn/)\n\n \ud83e\udd14 \u4e5f\u53ef\u4ee5\u8bf4\u662f\u4f5c\u8005\u7684\u89e3\u8bfb\u7248\u672c\n\n4. \u724c\u9762\u8d44\u6e90\u4e0b\u8f7d\uff1a\n\n - BilibiliTarot\uff1a[\u963f\u91cc\u4e91\u76d8](https://www.aliyundrive.com/s/cvbxLQQ9wD5/folder/61000cc1c78a1da52ef548beb9591a01bdb09a79)\n\n \u26a0 \u6587\u4ef6\u5939\u540d\u79f0\u3001\u5927\u963f\u5361\u7eb3\u6076\u9b54\u724c(The Devil)\u540d\u79f0\u3001\u6743\u67564\u540d\u79f0\u3001\u5973\u7687\u724c(The Empress)\u540d\u79f0\u6709\u4fee\u6539\n\n - TouhouTarot\uff1a[Oeeder/PluginVoodoo-Touhou](https://github.com/Oeeder/PluginVoodoo-Touhou/releases/tag/PluginVoodoo)\uff0c\u539f\u4f5c\uff1a[\u71d5\u5c71/\u5207\u308a\u7d75\u6771\u65b9\u30bf\u30ed\u30c3\u30c8\u30ab\u30fc\u30c9\u5927\u30a2\u30eb\u30ab\u30ca22\u679a](https://www.pixiv.net/artworks/93632047)\n\n \u26a0 \u6587\u4ef6\u540d\u79f0\u6709\u4fee\u6539\n\n## \u672c\u63d2\u4ef6\u6539\u81ea\n\n1. [\u771f\u5bfbbot\u63d2\u4ef6\u5e93/tarot](https://github.com/AkashiCoin/nonebot_plugins_zhenxun_bot)\n\n2. [haha114514/tarot_hoshino](https://github.com/haha114514/tarot_hoshino)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tarot divination!",
"version": "0.4.0.post3",
"split_keywords": [
"nonebot2",
"nonebot-plugin",
"tarot",
"minatoaquacrews"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a357e843708e2b1ca71ffd7b6860bb8ede1a5f23e1b108bbe85ffed2aff45b81",
"md5": "8d033c2c756165c5d4a47a2a14652187",
"sha256": "738a9bfab40de17a73b8589645b47b881c99fe22fd97f33ae005d8aa293a3b40"
},
"downloads": -1,
"filename": "nonebot_plugin_tarot-0.4.0.post3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8d033c2c756165c5d4a47a2a14652187",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 17614,
"upload_time": "2023-03-28T08:53:21",
"upload_time_iso_8601": "2023-03-28T08:53:21.331483Z",
"url": "https://files.pythonhosted.org/packages/a3/57/e843708e2b1ca71ffd7b6860bb8ede1a5f23e1b108bbe85ffed2aff45b81/nonebot_plugin_tarot-0.4.0.post3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-28 08:53:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "MinatoAquaCrews",
"github_project": "nonebot_plugin_tarot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nonebot-plugin-tarot"
}
JSON
