KhBot Docs

Appearance

KhBot 使用文档 ​

提示

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

Core ​

帮助 仅群聊 ​

/help

查看 Bot 帮助文档。

Core 状态 ​

/textstatus [img]

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

参数说明
  • img：可选，采用图片输出。

反馈 仅群聊 ​

/report <content>

发送 <content> 至 Bot 运营。

参数说明
  • content：必填，反馈内容（仅支持纯文本）。

随机猫狗 ​

/cat
/dog

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

Project SEKAI 相关功能 ​

/pjsk活动
/twpjsk活动

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

/pjsk卡池
/twpjsk卡池

获取日服/台服当期卡池。待修复

气象相关功能 ​

/云图 [source]
/yt [source]

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

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

获取全国降水量预报图。

参数说明
  • time：可选，预报时效，默认为 24，可用值：24，48，72。

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：セラス 柳田 リリエンフェルト

HarukiBot(NEO) ​

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

注意

HarukiBot v1 将于 2026 年 5 月 1 日 00:00 起下线，目前 KhBot 已接入 HarukiBot NEO，在 v1 下线前您仍可使用 v1 服务，但我们建议您尽早迁移至 NEO。

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

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 [数字] [决定]
1d [数字] [决定]

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

参数说明
  • 数字：想要限制的点数大小。
    • 不输入默认 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

Bilibili Service ​

此功能由 Colter23/bilibili-dynamic-mirai-plugin 提供，提供了哔哩哔哩链接解析、订阅推送功能。

更多内容请参阅 GitHub 仓库。

帮助 ​

!bili help

查看帮助图片。

Copyright © 2022-2026 KhBot Team