仓库：https://github.com/MEMZGBL/AstrBiliRelay#

一个从零实现的 AstrBot Bilibili 私信接入项目，包含：

• 原生 AstrBot 平台适配器 bilibili_native
• 原生 Bilibili 私信 HTTP 客户端
• WBI 参数签名实现
• Windows 桌面启用/关闭控制器

本项目不依赖任何现成的 Bilibili AstrBot 适配器，也不会下载第三方适配器源码

功能#

• 使用 Bilibili Cookie 登录
• 轮询 Bilibili 私信会话
• 接收文本私信并提交给 AstrBot
• 把 AstrBot 的文本回复发送回 Bilibili 私信
• 桌面 GUI 一键启用/关闭 bilibili_dm
• 自动重启 AstrBot 后端使配置生效

当前版本聚焦文本私信闭环。图片、文件、表情和群聊不是本版本目标。

环境要求#

• Windows 10/11
• AstrBot Desktop
• AstrBot 已配置可用 LLM Provider
• PowerShell
• Python 依赖：aiohttp

快速开始#

1
powershell -ExecutionPolicy Bypass -File .\scripts\install_bilibili_adapter.ps1 `
2
  -SessData "PASTE_YOUR_SESSDATA" `
3
  -BiliJct "PASTE_YOUR_BILI_JCT" `
4
  -Enable

1
powershell -ExecutionPolicy Bypass -File .\scripts\install_bilibili_adapter.ps1 `
2
  -AstrBotRoot "D:\path\to\.astrbot" `
3
  -SessData "PASTE_YOUR_SESSDATA" `
4
  -BiliJct "PASTE_YOUR_BILI_JCT" `
5
  -Enable

1
powershell -ExecutionPolicy Bypass -File .\scripts\create_desktop_shortcut.ps1

1
powershell -ExecutionPolicy Bypass -File .\scripts\restart_astrbot_backend.ps1

配置模板#

见 configs/bilibili_platform.template.json。

核心字段：

1
{
2
  "id": "bilibili_dm",
3
  "type": "bilibili_native",
4
  "enable": true,
5
  "SESSDATA": "...",
6
  "bili_jct": "...",
7
  "polling_interval": 5
8
}

项目结构#

1
AstrBiliRelay/
2
  astrbot_plugin_bilibili_native/
3
    bilibili_client.py
4
    bilibili_event.py
5
    main.py
6
    metadata.yaml
7
    platform_adapter.py
8
    requirements.txt
9
    wbi.py
10
  configs/
11
  scripts/
12
  src/
13
  README.md

原生实现说明#

AstrBot 侧通过 register_platform_adapter("bilibili_native", ...) 注册平台适配器。收到 Bilibili 私信后，适配器构造 AstrBotMessage 和 AstrMessageEvent，提交到 AstrBot 事件队列。AstrBot 生成回复后，事件对象的 send() 方法调用本项目内置客户端发送文本私信。

Bilibili 侧实现：

• x/web-interface/nav：登录校验、获取 UID、获取 WBI key
• session_svr/get_sessions：轮询私信会话
• svr_sync/fetch_session_msgs：拉取会话消息
• web_im/send_msg：发送文本私信
• wbi.py：WBI 参数签名

安全注意事项#

• Cookie 泄露后可能导致账号被他人登录
• 建议使用单独 Bilibili 账号测试
• 自动回复可能触发平台风控，请控制频率和内容

License#

MIT