【KOOK】阿狸机器人 | 使用文档
时光匆匆，自从 2022 年 6 月 20 日，阿狸的 GIT 仓库创建第一个 commit 开始，已经过去了一年零 64 天，这么长的时间里，我接受到了不少朋友的支持，也有不少朋友对代码编写的帮助，在此衷心地对大家表示感谢！
但，由于拳头公司给 auth 鉴权接口新增了 Cloudflare 防火墙和人机验证，导致类似阿狸这种集中式的机器人会被直接封禁云服务器 IP 而无法继续使用，所以，阿狸只能和大家说拜拜了！
自 2023-08-24 起，KOOK 阿狸机器人和 QQ 频道阿狸机器人均停止服务。
感谢！
欢迎来到 Kook-Valorant-Bot 机器人使用文档
- 开源代码：Github | Gitee
- 机器人状态页：api/v2/bot
- 爱发电支持页：点我发电
有任何问题，欢迎在本页下方评论（推荐）或加入阿狸帮助频道
0. 免责声明
1. 查询接口
老生常谈了，目前 valorant 查询的接口是使用拳头官方的登录接口获取到账户 token 后，用账户 token 请求对应的商店、任务、战绩等接口。
该接口官方没有正式公布，目前的查询操作是在官方默许下进行的。根据外网开发者的经验（他们使用的更久）目前暂时还没有听说过有人因为该接口查询信息而被 ban 号。
但，没有不代表封号风险不存在！
所以，使用了登陆查询功能之后，即代表您愿意承担此类风险。
2. 账户安全
机器人的代码完全开源，输出的日志中不会包含用户的账户 / 密码 / 邮箱验证码，所有信息均通过 kook 的私聊和 kook 的 api 传输到机器人进行处理。
- 传输过程中的私密性将由 https 协议来保证；
- 您的账户密码只有 kook 的后台能看到；
如果您担心您的账户安全，请一定要开启邮箱双重验证；或不要使用机器人。
3. 自动重登
机器人什么时候会进行重登？
在查询的时候，机器人会先判断账户 token 是否有效，无效则 cookie 重登。具体场景如下:
- 执行需要登录的查询命令
- 早八的 notify 皮肤提醒功能会触发重登
- 早八的 vip 商店提醒功能会触发重登
1. 帮助命令
1.hello
执行本命令，阿狸会回复你好。可用于测试阿狸是否在线
1 | /hello |
2.@阿狸
在频道内 @机器人，会触发一个语句
1 | @打瓦的阿狸 |
1 | 呀，听说有人想我了，是吗？ |
如果是开发者 @，则会返回只有开发者才能执行的命令帮助面板
3.ahri
阿狸基础帮助命令
1 | /ahri 或 /Ahri |
4.vhelp
valorant 相关命令帮助
1 | /vhelp |
2. 基础命令
01.val 错误码
以下两个命令完全相同，van 是 val 的别名
1 | /val 错误码编号 |
用这个命令可以查询游戏常见错误码的解决办法
1 | /val 1067 |
同时支持查询 van 开头的错误码
1 | /val 9001 |
02.DX 弹窗错误
如果你发现有人在咨询 DirectX Runtime 相关的错误，可以执行此命令
1 | /dx |
03.saveid/myid
此命令用于保存（修改）用户的游戏 id
1 | /saveid 游戏id |
保存后，在和别人开黑的时候，可以用 myid 命令快捷发出自己的游戏 id
1 | /myid |
04.bundle
查询一个皮肤系列包含什么皮肤（捆绑包）
1 | /bundle 皮肤名 |
举个例子
1 | /bundle RGX # 查询显卡套 |
05.login
登录命令
1 | /login 账户 密码 |
登录您的拳头账户，如果开启了邮箱验证，机器人将提示您使用 /tfa 命令进行验证
1 | /login 账户 密码 save |
后追 save，即代表您愿意将账户密码存储到机器人后台的临时变量（内存）中。存在内存中的数据会在机器人进程退出后清空，他人无法获取。
- 保存账户密码后，机器人将在尝试 cookie 重新登录失败后，使用账户密码进行重新登录
- 不管是 vip 用户还是普通用户，该功能都生效
- 不支持邮箱登录用户
save密码。开了邮箱登录的用户，指定 save 后依旧不会缓存
该功能主要服务于机器人长时间开机的时候（不过目前经常需要维护重启，存的数据会丢失）
06.tfa
用于进行邮箱验证
1 | /tfa 邮箱验证码 |
如下，刚开始发送验证码，机器人会提示验证码 xxx 收到
如果登录成功，机器人会反馈您的游戏 id
如果输入了一个错误的验证码，机器人会提示您重新输入
07.login-l
目前机器人支持至多 3 个拳头账户的同时登录，使用该命令可以查看当前已登录账户的游戏名和登录时间
1 | /login-l |
08.login-ap
前面提到，login 登录可以指定 save 保存账户密码。
机器人后台会在使用账户密码重登的时候对时间进行记录，用如下命令即可查询
1 | /login-ap |
这样你就能知道机器人啥时候用过你的账户密码操作了
09.logout
如果你不希望机器人在后台操作你的账户
那就可以用这个命令登出所有账户
1 | /logout |
10.shop
查询每日商店
1 | /shop |
如果你登录了多个账户，则需指定编号（编号为 /login-ap 中显示的账户序号）默认查询的是编号为 0 的账户商店
1 | /shop 1 |
11.night
查询夜市
1 | /night |
多账户操作和 shop 相同
1 | /night 账户序号 |
12.uinfo
查询用户信息（等级、经验值、玩家卡片、玩家称号、vp、rp 等）
1 | /uinfo |
该命令会自动查询所有已登陆账户，无须指定编号
13.match
查询最近 5 场的战绩
1 | /match |
多账户查询和 shop 相同
绿色边框代表本场胜利，红色代表负
14.mission
查询你的每日 / 每周任务
1 | /mission |
目前任务 uuid 尚未完全收录，很多任务都处于未知状态。
需要大家在执行本命令后，帮助填写表单，尽早集齐所有任务信息。感谢！
3. 皮肤提醒
1.notify-a
查询皮肤，机器人会返回一个皮肤选择表，用 sts 命令选择指定的皮肤，加入皮肤提醒队列
1 | /notify-a 皮肤名 |
比如我想在商店刷出显卡暴徒的时候，让机器人私聊提醒我，那就可以用如下命令
1 | /sts 0 |
这里的 0 是上图中显卡暴徒的编号
2.notify-l
1 | /notify-l |
查看已添加的皮肤提醒
3.notify-d
删除 notify-l 中不需要提醒的皮肤
1 | /notify-d 皮肤uuid |
示例
1 | /notify-d 6f2aefab-439d-140a-4dc6-87818e2d72cd |
4. 皮肤评价
所谓皮肤评价，就是查询商店的时候，显示在结果之下的信息。采用 leancloud 存储皮肤评价，数据库已在 kook 和 qq 频道的阿狸机器人中共用。
目前尚有大量皮肤未评价，计算而出的商店评分参考价值低。还需各位多多帮助！
1.rate
该命令和 notify-a 类似，需要先通过皮肤名查找需要评论的皮肤
1 | /rate 皮肤名 |
示例
1 | /rate 离子 |
2.rts
执行过 rate 命令后，用 rts 命令进行选择
1 | /rts 序号 打分 吐槽 |
3.kkn
执行本命令，查看昨日评分最高 / 最低用户
1 | /kkn |
由于目前皮肤评价数据不足，所以参考性低
5.VIP 专属
阿狸的 VIP 基础权益如下
- 「全新商店展示图」vip 用户将获取到 16-9 的超帅商店返回值
- 「商店图片背景自定义」vip 用户可自定义商店查询结果的图片背景
- 「保存登录信息」vip 用户登陆后，阿狸会自动保存您的 cookie。在阿狸维护重启的时候，您的登录信息不会丢失（注：cookie 内并不包含你的账户密码）
- 「早八商店提醒」阿狸将在早 8 点获取 vip 用户的每日商店并私聊发图给用户。同时会对这张图片进行缓存，当天使用
/shop命令的时候，只需 2s 获取结果，三倍于普通用户的响应速度！
一些说明
- 目前商店查询 diy 背景图支持 16-9 (横屏) 的图片
- 请不要设置违规图片 (擦边也不行)！若因为您上传违禁图片后导致阿狸被封，您将被剥夺 vip 权益并永久禁止兑换 vip
1.vip-u
该命令用于兑换 vip 的激活码
1 | /vip-u 激活码 |
当您在爱发电购买 vip 后，爱发电会给您私聊一个 vip 的激活码。私聊阿狸，使用该激活码即可激活 vip。同一激活码只可使用一次。
2.vip-c
查看 vip 的剩余时间
1 | /vip-c |
3.vip-shop
目前支持保存 4 张背景图
3.1 查看已保存背景图
查看已保存的商店自定义背景图
1 | /vip-shop |
3.2 切换背景图
这里出现了图片的编号，如果需要切换图片，使用如下命令
1 | /vip-shop-s 图片编号 |
就可以切换到对应的背景图
3.3 删除背景图
由于仅支持 4 个背景图，所以添加更多背景图之前，需要先删除已有的
1 | /vip-shop-d 图片编号 |
示例如下
3.4 添加背景图
图片 url 获取看
3.5
请尽量使用 kook 上传图片后设置背景图，或使用国内能直连的图床图片 url，否则背景图设置很可能出错。
1 | /vip-shop 图片url |
示例
1 | /vip-shop https://img.kookapp.cn/assets/2023-04/QUGTtwWxuv6bk2l4.jpg |
3.5 如何获取图片 url
1 | PC端将图片上传到kook → 点击图片 → 底部...处复制图片链接 → 使用/vip-shop命令设置背景 |
6. 娱乐命令
01.roll 骰子
该命令可以掷骰子（生成随机数）
1 | /roll 左边界 右边界 生成数量 |
示例
1 | /roll 1 100 3 |
如果不给第三个数量参数，则默认只生成一个随机数
1 | /roll 1 100 |
02.countdown 倒计时
在本频道触发一个倒计时
1 | /countdown 秒数 |
示例
1 | /countdown 120 |
生成一个 120 秒的倒计时
03.tl 翻译
该命令为 translate 的缩写，用于翻译。支持中英互译，以及部分外国语言翻译成中文
1 | /tl 内容 |
机翻，图一乐
1 | /tlon |
这两个命令是在本频道开启 / 关闭实时翻译
开启后，用户发送的所有信息都会被翻译出来
用 /tloff 关闭实时翻译
04.we 天气
该命令可以用于查询城市的天气情况
1 | /we 城市 |
The end
阿狸的命令就这些啦，有任何问题都可以在下方留言！
爱发电
- 最新
- 最热
- 最早
- 作者
点击重新获取 | 打开控制台