这是一个适用hoshinobot的赛马娘功能插件，数据来自：

• 马娘官网
• bwiki
• 马娘基础数据库
• 台服马娘官网
• 乌拉拉大胜利

• 有空的话建议先看看已关闭的历史issue有没有类似的参考一下
• 可直接在本仓库提交issue，但请带上报错的日志完整截图，并说明清楚哦
• 如果按照我的教程搭建机器人遇到的问题可以前往 Discussions 进行讨论

（具体命令请看本页面下方功能命令和描述）

• 马娘新闻播报【已支持台/日服】
• 马娘模拟抽卡v2【已支持台/日/韩/B服】
• 马娘基础数据库【台/日通用】
• 支援卡节奏榜【已支持台/日服】
• 相性计算器【台/日通用】
• 马娘黄历【台/日通用】
• 马娘耐力计算器【台/日通用】
• 马娘表情包【台/日通用】
• 马娘漫画【台/日通用】
• 马娘限时任务
• 马娘技能查询【已支持台/日服】
• 育成目标查询【台/日差不多通用】

• v2.5.1为例：
• v2为大版本号，除非有超级有益的重构类大更新，一般不会更新
• 5为功能迭代版本号，有新功能或者某一功能重写了就会更新
• 1为BUG修复/数据更新版本号，有关键性的BUG修复或者重要的数据更新就更新
• 其余不刷版本号的更新，一般来说为不影响大局的BUG修复或小数据更新
• 末尾带f标识的为强制更新版本，需要手动git pull -f来更新

• 22-08-22 v2.6.4 常规数据更新，新增红宝石和凯斯的别名，更新后记得“手动更新马娘数据”或者等半夜自动更新

• 22-08-18 v2.6.3 新增图片可选发送形式properties.json，配置方法在本文末, issue #37

• 22-08-15 v2.6.2 修复台服节奏命名规则修改后产生的BUG

• 22-08-08 v2.6.1 修复卡池界面更新的BUG

• 22-08-02 v2.6.0 完全重写马娘抽卡功能，减少人为BUG率，且能切换服务器支持日台韩B服，且能切换卡池，缩减抽卡结果长度防刷屏，issue #27，issue #32

• 22-07-27 v2.5.2 同步官网更新马娘：谋勇兼备，敏锐奇才，北港火山，更新完插件后请使用命令“手动更新马娘数据”

• 22-07-20 v2.5.1 临时兼容一下最新的卡池，有BUG讲究一下吧，后续打算重写，不然实在不好整

• 22-07-17 v2.5.0 新增一个小功能“马娘速查”，方便萌新

• 22-07-16 v2.4.0 美化帮助界面，同时方便autohelp服务模式显示，详情本文末尾

• 22-07-16 v2.3.1 修复技能查询BUG同时新增繁中技能查询 by@Yui-xy，issue #28

• 22-07-08 v2.3.0 新增查询赛程的育成目标功能，使用命令 “查目标 角色名” 即可，结果图片仿自bwiki，issue #25

• 22-07-06 v2.2.2 修复台服支援卡命名方式变化后的BUG，更新后请务必手动删除uma_support_chart文件夹下的sup_config_tw.json再重启hoshino

• 22-07-05 v2.2.1 修复支援卡节奏榜网页更新后的BUG，更新后请务必手动删除uma_support_chart文件夹下的sup_config.json再重启hoshino，issue #24

• 22-06-30 v2.2.0 新增台服马娘新闻功能，整进了“马娘新闻帮助”里

• 22-06-30 v2.1.0 新增台服支援卡节奏榜功能，整进了“支援卡节奏榜帮助”里

• 22-06-24 v2.0.4 请务必更新！同步translators更新，以便修复马娘新闻翻译显示不全的BUG

• 22-06-23 v2.0.3 马娘新闻修复不具合翻译不了的BUG和其他遇不到的BUG，且现在支持配置代理，已添加进本文档的食用教程里

• 22-06-19 v2.0.2 马娘新闻部分代码改进优化，并且翻译结果默认采用转发消息发送，可以自行更换

• 22-05-05 v2.0.1 优化更新逻辑，当更新失败自动回退防止再次更新时出错，同时更换数据镜像站提高更新速度

• 22-04-25 v2.0 大版本更新！！！强烈推荐，之后可无需APIKEY，注意：更新后需要更新安装依赖，并重新“手动更新马娘数据”

• 22-04-24 v1.7 新增马娘技能查询功能

• 22-04-15 v1.6 新增马娘限时任务功能，并修复一些描述，此版本开始需要更新依赖

• 22-04-11 v1.5.3 修复图片文件夹的问题，并修复由于也文摄辉背景图分辨率过高导致OCR无结果的问题

• 22-04-10 v1.5.2 将所有的图片文件夹移动至umamusume文件夹下

• 22-03-30 v1.5.1 重构支援卡节奏榜代码，理论上性能更好，冗余更低

• 22-03-28 v1.5 新增马娘一格漫画功能

• 22-03-28 v1.4 新增马娘表情包功能

• 22-03-20 v1.3.3 节奏榜新增了 友人卡节奏榜

• 22-03-19 v1.3.2 新增了更新数据时自动下载语音文件，更新到此版本后需要手动更新一下数据，当然等半夜的自动更新也行

• 22-03-18 v1.3.1 调整了自动更新策略，将在更新时生成一个缓存文件，更新完再复制过去，以防止更新期间部分功能不能用，顺便新增手动更新相性信息功能

• 22-03-09 v1.3 新增了“马娘耐力计算器”功能，但数据为 根性与下坡 改版前的数据，且为非常理想的数值

• 22-03-09 v1.2 一些调整，以及修改部分文件使之规范化github储存库，方便 git pull, pull #4

• 22-03-06 v1.1 新增了“马娘签到”功能

• 22-03-04 v1.0 first commit

1. git clone本插件（注：一定要git clone，不要下载压缩包，另外请确保git环境变量正常）：

   在 HoshinoBot\hoshino\modules 目录下使用以下命令拉取本项目

   git clone https://github.com/azmiao/uma_plugin
   

2. 安装依赖：

   到HoshinoBot\hoshino\modules\uma_plugin目录下，管理员方式打开powershell

   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple --user
   

3. 在 HoshinoBot\hoshino\config\ __bot__.py 文件的 MODULES_ON 加入 'uma_plugin'

   然后重启 HoshinoBot

   装完插件后首次启动时会更新马娘各种数据，按带宽的大小可能需要3-10分钟不等，请耐心等待，您可以看着控制台看他有没有报错。

4. 额外功能：（自动提醒）

   在某个群里发消息输入下文以开启马娘生日提醒（提醒当天哪知马娘生日）

   开启 uma_bir_push
   

   在某个群里发消息输入下文以开启马娘新闻播报，一个日服，一个台服（推送新闻更新）

   开启 umamusume-news-poller
   

   开启 umamusume-news-poller-tw
   

   可以通过发消息输入"lssv"查看这个功能前面是不是⚪来确认是否开启成功

5. 马娘新闻配置代理（可选）

   配置代理方法已集成至统一配置里，请看下文额外定制配置

该功能的所有配置均在插件目录下的 properties.json 里

可选图片发送形式：

如果你使用docker，且hoshino和gocqhttp不在一个容器里，可选base64，默认file

    "image_send_form": {
        "notes": "图片发送形式，可选值有 [ file | base64 ]",
        "current": "file"
    },

可选是否自动更新插件代码：

默认auto，自动更新，将会自动更新插件的代码，不会影响资源的更新，更新完会有私聊消息提醒。【注意】自动更新后也需要手动重启bot，因为插件内部没法实现自动重载

如果想从默认的自动更新换为手动更新，需要更改下面的配置即可。

但是，如果换成手动更新后，又想回自动更新了，那就需要先改下方配置，然后删除插件目录下的version.json，没有的话就不用删了，接着git pull手动更新一下，再重启bot方可恢复成自动更新

    "code_auto_update": {
        "notes": "插件代码自动更新，默认auto，可选自动更新、不自动更新，对应的可选值是 [ auto | no ]",
        "current": "auto"
    },

可选默认服务器

如果你主要玩的不是日服，可以将所有子模块修改至你玩的服务器，可选[ jp | tw | ko | bili ]，切换之后节奏榜和马娘新闻等功能的命令前不加服务器名时，将回复所选的服务器内容

    "default_server": {
        "notes": "一键切换所有子的模块的服务器，可选值有 [ jp | tw | ko | bili ]",
        "current": "jp"
    },

可选资源更新周期

默认每天更新一次，同时也会影响插件代码的更新周期

    "res_update_cycle": {
        "notes": "调整图片等资源的数据更新周期，单位：天，默认1，可选值 [ 1 | 2 | 3 | 4 | 5| 6 | 7 ]",
        "current": 1
    },

可选是否全插件使用代理

默认不使用，如果你检查马娘插件遇到链接不到Github或查马娘新闻链接官网失败等问题，可以尝试开启

    "if_use_proxy":{
        "notes": "是否全插件均使用代理，默认false",
        "current": false
    }

附：代理的设置在插件目录下的proxy.json里，默认代理配置如下，1081记得改成你自己的代理端口

{
    "http": "http://localhost:1081",
    "https": "http://localhost:1081"
}

安装 autohelp 即可，可显示更好看的帮助界面

关于本马娘插件推荐添加的black.json：

{
    "uma_bir_push",
    "umamusume-news-poller",
    "umamusume-news-poller-tw",
}

推荐添加的replace.json：

{
    "uma_almanac": "马娘黄历",
    "uma_comic": "马娘漫画",
    "uma_compatibility": "马娘相性",
    "uma_endurance": "马娘耐力",
    "uma_face": "马娘表情包",
    "uma_gacha_v2": "马娘抽卡V2",
    "uma_info": "马娘基础数据查询",
    "uma_skills": "马娘技能查询",
    "uma_support_chart": "马娘支援卡节奏榜",
    "uma_target": "马娘育成目标查询",
    "uma_tasks": "马娘限时任务查询",
    "umamusume_news": "马娘新闻",
    "uma_help": "马娘帮助汇总",
}