Phigros Bot 使用教程

Phigros Bot 使用教程

帮助

  • /pgr - 绘制 b19 成绩图
  • /chap <章节名> - 查看章节完成度
  • /song <歌曲名> - 查看歌曲分数详情
  • /info - 查看个人账户信息
  • /b19(+) - 以文字方式查看 b19（或更多）
  • /acc(all) <歌曲名> <难度> - 查看推分所需 acc
  • /judge <歌曲名> - 评判曲目的难度
  • /rand <定数范围> - 随机抽取一首曲子
  • /bind <sessionToken> - 绑定账号
  • /unbind - 解绑
  • /search ... - 搜索章节或歌曲名
  • /alias ... - 别名相关操作
  • /ping - 检查服务是否在线
  • /clear - 清理存档缓存
  • /logout - 登出
  • /about - 关于机器人
  • /help <命令?> - 查看全部或特定命令的帮助

绑定账号的具体说明见下。

绑定账号

注意！由于 sessionToken 包含隐私信息，请尽量通过私聊机器人的方式来完成绑定！如果 sessionToken 被泄露，应尽快在 Phigros 中退出登录，这样一来 sessionToken 就会失效。重新登录后再按照下面方式获得新的 sessionToken 也可以完成绑定。

sessionToken 是一个长度为 25 的，由小写英文字母和数字构成的串。注意它并不是在 Phigros 同步界面看到的 ID！

安卓

方案一 - 手动查找

  1. 找到 /sdcard/Android/data/com.PigeonGames.Phigros/files/.userdata 这个文件

可能部分设备的路径不同，在无法找到时请搜索 com.PigeonGames.Phigros 这一文件夹并找到 .userdata 文件进行后续操作
注意部分文件管理器会隐藏该文件，请先在设置中显示隐藏文件，具体方法请根据您的设备自行进行

  1. 以文本形式打开 .userdata 文件，文件内容中有一段 "sessionToken": "xxxxxx"，描述的就是您的 sessionToken 为 xxxxxx，把 xxxxxx 复制出来妥善保管

例如文件中该内容为 “sessionToken”: “abcdefghij1234567890abcde”
则您的 sessionToken 为 abcdefghij1234567890abcde
无文本阅读器的用户推荐使用 MT 管理器

  1. 私聊 群内的查分 bot 并输入 /bind xxxxxx 即可，其中 xxxxxx 即您在第二步中获得的 sessionToken

注意格式问题：
例如您的 sessionToken 为 abcdefghij1234567890abcde
则您输入的指令应为
/bind abcdefghij1234567890abcde
而非 /bind <abcdefghij1234567890abcde>
请注意其中的空格

方案二 - 使用频道内的一键获取 sessionToken 软件

下载安装软件后跟随软件指示操作即可。

iOS

iOS 用户使用的方法都相对复杂，我们鼓励使用者向 官方反馈邮箱 来建议官方将 sessionToken 显示在游戏中。

制作者团队均已发送且官方未回复，因而只能动员广大用户来引起官方注意，以此来方便大家的使用，增进大家对 rks 的了解。😔

方案一 - 导出备份

在爱思导出全存档备份，在里面找 AppDomain-games.Pigeon.Phigros/Documents，里面就是 .userdata。之后步骤同安卓。

方案二 - 抓包工具

此方案推荐有相关知识或类似经验的用户使用，相较于导出备份这一方案更为便捷。

对 Phigros 进行抓包，在游戏中点击同步，截取其中 URL 为 https://phigrosserver.pigeongames.cn/1.1/classes/_GameSave 的请求，其请求头中 x-lc-session 的值即为 sessionToken。此方案安卓也可以使用，不过相比之下直接到文件中寻找是更为方便的选择。

（注：某些抓包软件可能会因为代理设置的一些原因无法抓到相应的包，可以考虑利用下面的全流量转发的方式实现）

对于毫无经验的用户下面给出大致步骤：

  1. 首先在手机/平板上下载一个代理工具（作者使用的是小火箭 Shadowrocket，国内 AppStore 能免费下载的类似工具暂时没有，欢迎协助测试）并设置好相应的 vpn 设置与信任选项等。

  2. 接下来在电脑上下载 HTTP Toolkit 并将电脑与手机/平板接入同一 Wi-Fi（如果有条件使用公网ip就不必），并获取电脑的ip地址与 HTTP Toolkit 监听的端口（默认为 8000，可在其主界面查看 Proxy Port:8000）并在手机上安装HTTP Toolkit 工具导出的安全证书

  3. 在代理工具中设置新增代理项，ip地址与端口分别填入上述获得的电脑ip地址与监听端口，并开启代理工具，并打开 Phigros 进行同步，在 HTTP Toolkit 中找到相应请求，查看请求（Request）的请求头（Headers）中 x-lc-session 项的值，即是待获取的 sessionToken。

方案三 - 使用安卓

临时使用一台安卓设备登录自己的账号，然后使用安卓相关步骤绑定账号。

功能详情

/pgr

需要绑定 TapTap 账号

绘制用户的 b19 成绩图，也包括成绩最好的收歌。

/chap

需要绑定 TapTap 账号

以图片形式查看某个章节的完成度。格式为 /chap <章节名>。

每个难度右侧会显示图标，代表评级完成度。例如，当你在该章节的某个难度中全都获得了至少 S 的评价，那么该难度右侧将会显示 S 的图标。

/song

需要绑定 TapTap 账号

以文字形式查看某一首歌曲的分数信息。格式为 /song <歌曲名>。

输出格式如下：

1
2
<EZ 3.4> 1000000 100.000% 3.400
...

/info

需要绑定 TapTap 账号

查看当前用户的信息。输出格式如下：

1
2
3
用户名：XXX
RKS：15.000
存档更新时间：2008-01-01 00:00:00

/b19

需要绑定 TapTap 账号

以文字方式查看 b19（或更多），也包括成绩最好的收歌（这前面将加上 * 标注）。

例如，你可以使用 /b19，也可以 /b40 等等。最高上限为 60。

格式如下：

1
2
3
4
*<难度 定数> 曲名 ACC% 单曲RKS
<难度 定数> 曲名 ACC% 单曲RKS
<难度 定数> 曲名 ACC% 单曲RKS
...

/acc

需要绑定 TapTap 账号

以文字方式查看推分所需要的一首歌的 acc。格式为 /acc <歌曲名> <难度>。两个参数都可以忽略：如果忽略难度，则默认为 IN；如果忽略歌曲名和难度，则显示所有 b19 歌曲的信息。

如果想要查看全部歌曲的信息，可以使用 /accall。

格式如下：

1
2
3
[难度] 曲名 (ACC%)：推分需 ACC%
[难度] 曲名 (ACC%)：无法推分
...

/rand

随机抽取一首曲目。以下格式均可：

1
2
3
4
5
6
7
/rand（在所有曲目中随机）
/rand 14.3+（14.3 级以上）
/rand 14.3-（14.3 级以下）
/rand 14.3-15.3（指定范围之间）
/rand 14.3~15.3（指定范围之间）
/rand 14（14 级，即 14.0-14.9）
/rand 14.3（14.3 级）

/judge

根据全体玩家游玩情况评估一首曲目的玩家定数。格式为 /judge <歌曲名>。

格式如下：

1
2
3
4
曲名
[难度 实际定数] 玩家定数
[难度 实际定数] 玩家定数
...

/bind <sessionToken>

详见 绑定账号。

/unbind

需要绑定 TapTap 账号

解除当前账号的绑定。

搜索章节名或歌曲名。格式为 /search (chap|song) <关键词>，其中 chap 表示搜索章节名，song 表示搜索歌曲名。

例如，/search song 黑皇帝 可以搜索到名字中包含 黑皇帝 的曲目。

返回的数据最多有五条。其中标 * 号表示该条目为别名。

/alias

对别名进行相关操作，包括添加，投票，等等。

由于部分章节 / 歌曲的名字难以或不方便打出，用户可以为这些名字添加别名。别名的添加采用投票制。用户提出一个别名提案后，若获得 3 人同意（自己不能投票），则该别名获得批准。管理员（不是群管理员）拥有一票否决 / 批准权。

请注意章节别名与歌曲别名是不互通的。

/alias 后面第一个参数是 chap 或者 song，表示你想要对章节名还是歌曲名进行操作。

可用的章节名

可用的歌曲名（更新可能不及时）

/alias (chap|song) add <别名> <实际名称>

提案一个别名。请注意机器人至多支持同时维护 10 个提案。如果已经有 10 个提案而你想要添加新的提案，请先给现有的提案投票。

例如，/alias song add 火球 Cthugha.USAO.0 将添加一项将歌曲 Cthugha 代指为 火球 的提案。

管理员使用该命令无需投票，直接通过。

/alias (chap|song) vote

查看当前的所有提案。

/alias (chap|song) vote <别名>

为 别名 投票。沿用上面的例子，如果你想要为 火球 投票，则可以使用 /alias song vote 火球。

/alias (chap|song) approve <别名>

只有管理员可以使用该命令

直接通过一项别名提案。

/alias (chap|song) deny <别名>

只有管理员可以使用该命令

直接拒绝一项别名提案。

/alias (chap|song) delete <别名>

只有管理员可以使用该命令

删除一项存在的别名。

/ping

检查服务是否在线。若在线机器人将回复 服务在线。

/clear

清理存档缓存。如果遇到存档查询出现问题可以尝试此命令。

/logout

登出账号，使 sessionToken 失效，同时解绑。如果 sessionToken 泄漏后被他人恶意利用可使用此命令。

/about

查看有关机器人的信息。

/help

直接执行 /help 可以查看所有命令的简要帮助。若需要查看某一命令的详细帮助可以使用 /help <命令>。

Phigros Bot 使用教程

https://mivik.moe/pgr-bot-help/index.html

作者

Mivik

发布于

2022-11-05

更新于

2022-12-04

许可协议

#

喜欢这篇文章？打赏一下作者吧

评论

关注我

链接

最新文章

订阅更新

×