配置指南
基础设置
selfId
类型: string（必需）
格式: 纯数字 UID
描述: 要登录的 Bilibili 账号 UID。扫码登录成功后，Cookie 中的账号 UID 必须与此配置一致。
如果账号不一致，适配器会保留插件运行状态，并在前端显示“扫码账号和配置项账号不一致，请更换账号”，同时在 Koishi 日志中记录原因。
如何查找 UID？点我查看方法
进阶设置
pollInterval
类型: number
默认值: 3000
范围: 1000 - 60000
单位: 毫秒
描述: 私信轮询间隔。数值越小，私信响应越快，但 API 请求会更频繁。
maxCacheSize
类型: number
默认值: 1000
范围: 100 - 10000
单位: 条
描述: 缓存已处理的消息 ID 数量，用于避免轮询造成重复处理。
ignoreOfflineMessages
类型: boolean
默认值: true
描述: 开启后，只响应机器人上线之后产生的未读私信；关闭后可能会处理机器人离线期间积累的历史未读消息。
requestTimeout
类型: number
默认值: 10000
范围: 3000 - 30000
单位: 毫秒
描述: 请求 Bilibili API 的超时时间。
监听设置
enableCommentPolling
类型: boolean
默认值: true
描述: 是否轮询 Bilibili 的评论通知。启用后，视频评论区和图文动态评论区中提及机器人或回复相关评论的消息会作为 Koishi Session 下发。
commentPollInterval
类型: number
默认值: 30
范围: 10 - 300
单位: 秒
描述: 评论通知轮询间隔。
评论频道使用以下命名规则：
- 视频评论区：
video:BV号 - 图文动态评论区：
opus:动态ID
机器人发送评论时会回复触发通知的目标评论，而不是发送帖子下的一级评论。评论内容中的 @ 会解析成 Koishi at 元素，并保留被 @ 用户的 UID。
enableDynamicPolling
类型: boolean
默认值: true
描述: 是否监听关注 UP 主的动态更新。该功能是动态事件监听，不等同于评论通知监听。
dynamicPollInterval
类型: number
默认值: 30
范围: 10 - 300
单位: 秒
描述: 动态事件轮询间隔。
enableLivePolling
类型: boolean
默认值: true
描述: 是否监听关注 UP 主的直播状态变化。
livePollInterval
类型: number
默认值: 30
范围: 10 - 300
单位: 秒
描述: 直播状态轮询间隔。
屏蔽设置
nestedblocked.blockedUids
类型: Array<{ name: string; uid: string }>
默认值: 预设的 Bilibili 官方账号列表
描述: 不响应其私信的用户 UID 列表。表格中的 name 仅用于标识，实际匹配使用 uid。
uid 支持使用 * 匹配所有用户。示例：
[
{ "name": "测试用户", "uid": "123456789" },
{ "name": "全部用户", "uid": "*" }
]轮询容错
pollFailureThreshold
类型: number
默认值: 10
范围: 1 - 29
描述: 连续轮询失败达到此次数后，适配器会增加轮询间隔。
pollAutoShutdownThreshold
类型: number
默认值: 30
范围: 30 - 100
描述: 连续轮询失败达到此次数后，适配器会自动关闭，避免在 Cookie 失效或网络异常时持续请求。
开发调试选项
loggerinfo
类型: boolean
默认值: false
标记: 实验性功能
描述: 输出私信、登录、评论等功能的详细调试日志，用于定位问题。
loggerLiveInfo
类型: boolean
默认值: false
标记: 实验性功能
描述: 输出直播间弹幕的详细调试日志，可能产生大量日志，仅建议开发者临时开启。
头像处理
ilibili 图片通常要求特定请求头，机器人头像会通过 Koishi 本地服务反代后再提供给控制台；普通用户头像仍使用 Bilibili 原始链接。