Bilibili DM Adapter

Appearance

常见问题 ​

安装和配置 ​

Q: 如何获取 Bilibili UID？ ​

A: 有以下几种方法：

  1. 手机端：进入个人主页 → 查看资料 → 查看UID
  2. WEB端：进入个人主页 → 查看地址栏 / 后的数字

Q: 扫码登录失败怎么办？ ​

A: 请检查：

  1. 确保使用最新版本的 Bilibili APP
  2. 网络连接是否正常
  3. 二维码是否已过期（通常 2 分钟过期）
  4. 尝试刷新页面重新生成二维码

Q: 插件安装后无法启动？ ​

A: 可能的原因：

  1. 依赖问题：确保 Koishi 版本 >= 4.18.0
  2. 配置错误：检查 UID 是否正确填写
  3. 网络问题：确保能正常访问 Bilibili API
  4. 权限问题：确保 Koishi 有足够的文件读写权限

使用问题 ​

Q: 为什么消息发送/接收有延迟？ ​

A: 这是正常现象，原因包括：

  1. B站限制：为防止滥用，B站对私信 API 有频率限制
  2. 轮询机制：插件使用轮询方式获取新消息
  3. 网络延迟：网络环境可能影响响应速度

通常延迟在 3-30 秒属于正常范围。

Q: 头像图片无法显示怎么办？ ​

A: 解决方案：

  1. 启用 Base64 转换：在配置中开启 imageToBase64 选项
  2. 请求头：请求B站图片时，确保使用no-referrer
  3. 浏览器设置：某些浏览器可能阻止跨域图片

Q: 消息发送失败？ ​

A: 可能的原因：

  1. 内容被屏蔽：B站有内容审核机制，敏感内容可能被拦截
  2. 频率限制：发送过于频繁会被限制
  3. 登录过期：需要重新扫码登录
  4. 网络问题：检查网络连接

Q: 支持发送哪些类型的消息？ ​

A: 目前支持：

  • ✅ 纯文本消息
  • ✅ 图片消息（需先上传到 B站）
  • ❌ 视频消息（暂不支持）
  • ❌ 语音消息（暂不支持）
  • ❌ 表情包（部分支持）

获取帮助 ​

如果以上解答无法解决你的问题：

  1. 查看日志：详细的错误日志有助于定位问题
  2. 提交 Issue：在 GitHub 仓库 提交详细的问题报告
  3. 社区讨论：在 Koishi 社区寻求帮助
  4. 联系开发者：通过邮件或其他方式联系开发者

提交问题时请包含：

  • Koishi 版本
  • 插件版本
  • 详细的错误日志
  • 复现步骤
  • 系统环境信息