KhBot 使用文档

提示

本页面仅列出由 KhBot Core Service 提供的命令以及部分第三方命令，由第三方 Bot 或服务提供的所有命令不会在此列出，请参阅它们的官方文档或仓库主页。

Core

帮助

/help

查看 Bot 帮助文档。

Core 状态

/textstatus [img]

查看 KhBot Core Service 服务器运行状态。

参数说明

• img：可选，采用图片输出。

反馈 仅群聊

/fb <content>

发送 <content> 至 Bot 运营。

参数说明

• content：必填，反馈内容（可带图）。

随机猫狗

/cat
/dog

从 The Cat API 和 The Dog API 随机获取一张猫狗图片。

Project SEKAI 相关功能

/pjsk活动
/twpjsk活动

获取日服/台服当期活动信息。

/twpjsk卡池

获取台服当期卡池。

气象相关功能

/云图 [source]
/yt [source]

获取指定来源的最新云图。

参数说明

• source：可选，来源，默认为空并输出内建帮助。支持的来源如下：
  • fy2：风云二号全国云图
  • fy2f：风云二号西北太平洋地图
  • fy4a：风云四号全国云图
  • fy4af：风云四号全原盘云图
  • h9：向日葵9号机动观测云图

Kaho

Kaho 是一款功能型机器人，主要提供《Link! Like! ラブライブ！》相关查询服务，以及一些娱乐功能，目前仍在开发中。

Kaho 的 GitHub 仓库：https://github.com/bywhite0/Kaho

Bloom Garden Party 头像生成

/bgp_icon [chara] <img>

给传入图片添加指定角色的 Bloom Garden Party 头像框。

本功能有对应的 Web 版本：https://hasu-icon.kaho.top

参数说明

• chara：可选，角色，默认为 bgp。提供的头像框如下：
  • bgp：官方 BGP 头像框
  • kaho：日野下花帆
  • syk：村野さやか
  • kze: 乙宗梢
  • zzl：夕霧綴理
  • rrn：大沢瑠璃乃
  • megu：藤島慈
  • ginko：百生吟子
  • k7m7：徒町小鈴
  • hime：安養寺姫芽
  • gcq：桂城泉
  • sls：セラス 柳田 リリエンフェルト

指令示例

花帆

花帆

/bgp_icon kaho [图片]

KhBot BOT

示例：随命令发送的头像图片（此处为站点 logo）套上 kaho 框后的返回结果

花帆

花帆

/bgp_icon [图片]

KhBot BOT

不带 frame 参数时默认使用 bgp 官方头像框

花帆

花帆

/bgp_icon

KhBot BOT

用法: /bgp_icon [frame] [图片]，默认 frame 为 bgp

画廊

/看所有 [画廊]
/看 <画廊> [xN]
/看 <图片id...>
/看 #<图片id...>

查看画廊总览或该画廊的图片列表，从画廊随机抽图，或按图片 id 取图；存在同号纯数字别名时，加 # 前缀可显式按图片 id 取图。

/上传|添加图片 <画廊> [force]

向画廊添加图片：引用消息、随命令发图、合并转发均可，不带图片时会提示补发；入库自动查重，疑似重复的图片不会入库并返回对比图。

/图片信息 <图片id>
/打标签 <图片id> <#标签...>
/搜标签 <#标签...> [数量]

查看图片的上传者、入库时间等元数据，替换式设置标签（留空即清空），按标签抽图（多标签需同时满足）。

/添加画廊别名 <名称> <别名>

为画廊添加别名，之后可直接用别名操作该画廊。

提示

命令与第一个参数之间可以不写空格，如 /看表情包 等价于 /看 表情包；参数相互之间的空格不能省略。

参数说明

• 画廊：画廊名称或别名。
• xN：可选，一次抽取 N 张，同一批内不重复。
• 图片id：图片 id；-1 为最新入库的一张，-2 为次新。
• #图片id：可选前缀，显式按图片 id 取图，不被同号的纯数字别名遮蔽；# 与 id 之间的空格可省略。
• force：可选，跳过查重强制入库。
• #标签：标签，前缀 # 可省略。
• 数量：可选，搜标签 抽取的数量。
• 单次最多发送 10 张图片。

指令示例

花帆

花帆

/看所有

KhBot BOT

[画廊总览图：列出所有画廊、图片数与占用体积]

不带参数时返回总览图

花帆

花帆

/看表情包

KhBot BOT

[从「表情包」画廊随机抽出一张图片]

等价于 /看 表情包，命令与第一个参数之间的空格可以省略

花帆

花帆

/看 表情包 x3

KhBot BOT

[同一批内不重复地随机抽取 3 张图片]

单次最多 10 张

花帆

花帆

/看 -1

KhBot BOT

[最新入库的一张图片]

负数索引：-1 为最新，-2 为次新

花帆

花帆

/看 88

KhBot BOT

[若「88」是某画廊的纯数字别名，这里命中画廊而非图片 id 88]

纯数字别名的遮蔽效果

花帆

花帆

/看 #88

KhBot BOT

[强制按图片 id=88 取图]

# 前缀不受纯数字别名遮蔽

花帆

花帆

/上传图片 表情包

KhBot BOT

[未携带图片时，Bot 提示补发图片；带图时自动查重入库，疑似重复返回对比图]

画廊管理 超级用户/群管理员

群聊中的群主与群管理员也可使用本节命令（标「仅超级用户」的除外），但同样受画廊模式与画廊权限的限制；私聊中群管理员权限不生效。

/添加画廊 <名称>
/删除画廊 <名称>         # 仅超级用户
/删除画廊别名 <别名>

创建与删除画廊及其别名。

/删除图片 <图片id>
/画廊查重 <画廊> [rehash]

删除指定图片；画廊查重 扫描画廊内已存在的重复图片并按组列出，确认后用 删除图片 逐个清理。

/设置封面 <画廊> <图片id|清除>

设置画廊在总览图中的封面。

/导出画廊 <画廊>         # 仅超级用户

将画廊全部图片打包为 zip 上传至群文件（仅群聊）。

参数说明

• 图片id|清除：用作封面的图片 id；写 清除 则恢复默认封面（图片 id 最小的一张）。
• rehash：可选，先重新计算全部哈希再扫描，耗时较长。
• 画廊与别名命名限制：长度 ≤ 32 个字符；不能包含空格、控制字符与 <>:"/\|?*；画廊名不能是纯数字，别名可以是纯数字，但会让 看 <该数字> 命中画廊而非同号图片，此时用 看 #<图片id> 取图。

画廊模式 超级用户

/画廊模式 [画廊] [读写|只读|关闭]

查看或设置单个画廊的开放程度，超级用户不受限制。

模式说明

• 读写：默认，全部命令可用。
• 只读：禁止添加/删除图片、打标签、添加别名，查看类命令不受影响。
• 关闭：画廊对超级用户以外的成员完全不可见，也不出现在总览图中。

画廊权限 超级用户

/画廊权限                    # 查看当前配置
/画廊权限 默认 <读写|只读|禁用>
/画廊权限 群 <群号|本群> <读写|只读|禁用|移除>
/画廊权限 用户 <QQ号|@某人> <读写|只读|禁用|移除>

按用户与群控制画廊功能的使用权限，判定顺序为 用户 → 群 → 默认策略，修改即时生效；群主与群管理员不豁免名单限制。

参数说明

• 读写：全部命令可用（默认）。
• 只读：仅可使用查看与抽图命令。
• 禁用：不响应任何画廊命令；默认策略设为 禁用 时即白名单模式，只有名单中的群/用户可以使用画廊功能。
• 移除：将群/用户移出名单，恢复默认策略。
• 本群：群聊中指代当前群；@某人：直接指定用户。

HarukiBot NEO

HarukiBot 是一款功能型机器人, 主要提供《世界计划 多彩舞台》相关查询服务，以及相关的娱乐功能。HarukiBot NEO 是其 v2 版本。

HarukiBot NEO 帮助文档：https://neo.haruki.seiunx.com

YumuBot

YumuBot 是连接 osu! 并处理数据的 bot 后端，同时提供了一部分舞萌/中二相关查询功能，以及一些娱乐功能。

此处仅列出部分辅助、娱乐功能命令。

其他功能请参阅雨沐机器人帮助文档：https://docs.365246692.xyz/

计算音符调值

!ymtrans <调值>
!tr <调值>

参考十二平均律，根据输入的音符调值，计算出以它为基音的自然大调内的其他音符的调值。

参数说明

• 调值：必填，需要计算的调值。
  • 合法参数：[音名] (# 升号) [音高]
    • 音名：A~G 的大写字母。
    • 升号：部分全音之间含有半音，加升号就是定位到这个半音。
    • 音高：1~7 的整数。代表了 do 到 si。
  • 它们合起来就组成了调值。比如，C4（中央 C，440 Hz）就是一个合法的参数。

扔骰子

免责声明

在扔骰子功能中，本 Bot 的一切回复均为系统随机生成。

如果您有医学方面的问题，请遵医嘱，不要轻信 Bot 的答案。开发者不担保结果的真实性。

用户误信 Bot 建议，并因此造成的一切损失，开发者将不予承担。

警告

请在让 Bot 做决定时，输入健康、积极、文明、符合社会主义核心价值观的言论！

否则，开发者将永远拒绝您使用 Bot。

!ymdice [数字] [决定]
!d [数字] [决定]

随机给出给定数字以内的数字（即扔一个该数字以内的骰子），或者随机返回给定两个决定中其中一个决定。

参数说明

• 数字：想要限制的点数大小。
  • 不输入默认 100 点。
• 决定：想要让 Bot 做的决定。
  • 支持含有中文常见关联词的句子。也支持部分英文。
  • 允许的句式有：
    • 多选：是享受游戏还是关闭游戏还是刷 PP？
    • 是谁：你是？
    • 是啥：我是什么 PP 图玩家？
    • 为啥：我为什么刷不到 PP？
    • 时间：我多久后能刷到 10000 PP？
    • 数量：这张图 PP 是多少？
    • 概率：我能刷到 PP 的几率是？
    • 范围：大于 50 刷 PP。
    • 比较：我和他比，谁会刷 PP？
    • 更加：我比他更会刷 PP 吗？
    • 或者：吃饭还是刷 PP？
    • 并列：一边享受游戏，一边刷 PP。
    • 喜好：宁可刷 PP，也不享受游戏。
    • 迟疑：与其享受游戏，不如刷 PP。
    • 即使：即使刷 PP，也要享受游戏。
    • 假定：如果我是 PP 刷子就好了。
    • 能够：我想刷 PP。
    • 条件：无论刷 PP 有多难，我也会继续的。
    • 定性：我是 PP 刷子吗？
    • 喜爱：你喜欢刷 PP 吗？
    • 思考：你觉得刷 PP 容易吗？
  • Bot 会随机返回答案。部分答案的概率会有微调。

GitHub Service

KhBot 与 GitHub 的集成服务，基于 QQ-GitHub-Bot 与 GitHub App Kaho Bot 对接，在聊天环境提供订阅、查看、处理 GitHub Issue 与 Pull Request 等功能。

更多内容请参阅 GitHub 仓库。

关于

/about

查看 GitHub Service 的仓库信息。

OpenGraph 卡片

[owner/repo]
[GitHub 仓库/Commit 链接]

查看对应仓库或 Commit 的 OpenGraph 卡片。

安装/授权 GitHub App

/install [check|revoke]
/auth [check|revoke]

安装 GitHub App 集成，用于 Issue/PR、Webhook 等管理；授权 GitHub App 以进行用户快捷操作。

参数说明

• check|revoke：可选，为 check 时检查状态，为 revoke 时移除安装/授权。

绑定仓库

/bind <owner/repo>

绑定仓库到当前会话，以进行仓库快捷操作。

参数说明

• owner/repo：必填，对应仓库。

订阅仓库事件

/subscribe <owner/repo> <event[/action]>

在当前会话订阅指定仓库的指定事件，可接多个事件同时订阅。

具体事件类型请参阅 GitHub 文档。

参数说明

• owner/repo：必填，对应仓库。
• event：必填，事件类型。
• action：选填，事件类型。

仓库快捷操作

注意

若当前会话未绑定对应仓库，此处的所有命令都需要使用 owner/repo 指定仓库。

提示

部分命令可以通过回复 Bot 发送的特定消息来快捷指定对应仓库/Issue/PR。

#number
[GitHub 链接]

查看对应的仓库 Issue/PR。

/link
/repo

获取 Issue/PR/仓库链接。

/readme
/license

查看仓库 README 与许可证。

/release [tag]

查看仓库最新或指定的 Release。

/diff                    # 查看 PR diff
/comment                 # 评论 PR
/label <label ...>       # 添加标签
/unlabel <label ...>     # 删除标签
/close [reason]          # 关闭 PR
/reopen                  # 重新开启 PR
/approve [message]       # 批准 PR
/merge [message]         # 合并 PR（创建合并提交）
/squash [message]        # 合并 PR（压缩合并）
/rebase                  # 合并 PR（变基合并）

仓库 Issue/PR 快捷操作。

/deployment

查看仓库 Deployment 列表。

用户快捷操作

/contribution

查看自己最近一年的贡献图。

/star <owner/repo>
/unstar <owner/repo>

快捷 Star/取消 Star 仓库。

注意

因目前技术限制，需要对应仓库安装了 GitHub App 才可进行该操作。

参数说明

• owner/repo：必填，对应仓库。

搜索

/search [code|repo|user] <query>

在 GitHub 上搜索代码、仓库、用户。

注意

本功能目前与 Kaho 的「卡牌搜索」冲突，会与该功能同时触发。

参数说明

• code|repo|user：可选，搜索类型，默认为 repo。

指令示例

花帆

花帆

[bywhite0/Kaho]

KhBot BOT

[该仓库的 OpenGraph 卡片图片]

直接发送 owner/repo 即可触发

花帆

花帆

/bind bywhite0/Kaho

KhBot BOT

[绑定成功提示，此后本会话的快捷命令无需再指定仓库]

花帆

花帆

#12

KhBot BOT

[当前绑定仓库的 Issue/PR #12 详情]

回复 Bot 发送的消息可快捷指定对应 Issue/PR

花帆

花帆

/subscribe bywhite0/Kaho push

KhBot BOT

[订阅成功提示，该仓库的 push 事件将推送至当前会话]