快速开始
安装插件
通过 Koishi 控制台安装(通用)
- 打开 Koishi 控制台
- 进入插件市场
- 搜索
bash
adapter-bilibili-dm- 点击安装

通过命令行安装(项目模板)
bash
yarn add koishi-plugin-adapter-bilibili-dm基础配置
1. 获取 Bilibili UID
在配置插件之前,您需要获取您的 Bilibili 账号 UID。
手机端获取方法

WEB端获取方法

2. 配置插件
- 在 Koishi 控制台中找到
adapter-bilibili-dm插件 - 在
selfId中填入准备登录的 Bilibili 账号 UID - 启用插件
selfId 必须是扫码账号的 UID。适配器会在扫码得到 Cookie 后再次校验账号;如果扫码账号与配置项不一致,插件不会关闭,但前端会提示“扫码账号和配置项账号不一致,请更换账号”。
3. 登录认证
插件启用后,需要进行登录认证:
- 在插件配置页面会显示二维码
- 等待页面显示“请使用手机扫描二维码”
- 使用 Bilibili APP 扫描二维码
- 页面显示“二维码已扫描,请在手机上确认登录”后,在手机端确认登录
- 登录成功后 Cookie 会保存到本地,后续重启会优先使用缓存自动登录
二维码通常约两分钟后过期。二维码过期后,请在插件页面重新发起登录或刷新二维码。

验证安装
配置完成后,你可以:
- 在 Koishi 控制台查看适配器状态
- 向机器人发送一条测试私信(例如
help、inspect) - 在视频评论区或图文动态评论区 @ 机器人并发送指令
- 检查是否能正常接收消息并回复私信或评论
注意: 消息接收延迟 受轮询速率影响。