KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

astrbot_plugin_bilibili

★ 92 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# astrbot_plugin_bilibili

这是一个为 [AstrBot](https://github.com/AstrBotDevs/AstrBot) 设计的多功能 Bilibili 插件。

## ✨ 功能特性

- **Bilibili 视频解析**：自动识别消息中的 `BV` 号，并返回视频的详细信息。
  - **UP 主动态订阅**：
      - 支持订阅 `视频动态`、`图文动态` 和 `直播`。
      - 提供灵活的关键词和类型过滤。
      - 默认每个 UP 主检测周期为 `300` 秒（5 分钟），任务间最小间隔为 `20` 秒，可根据需要在插件配置中修改。
   - **推荐番剧**
      - 试着对 LLM 说 `推荐一些催泪的番剧，2016年之后的`。
      - 支持类别、番剧起始年份、番剧结束年份、番剧季度（一月番等）
      - 需要支持函数调用的 LLM。如 gpt-4o-mini
  - **QQ 小程序解析**：自动识别并解析 QQ 聊天中分享的 Bilibili 小程序，提取并返回直链。
  - 后续还会增加更多功能！！

![image](https://github.com/user-attachments/assets/972b2b99-b801-45cf-a882-6d841c9e8137)
## 🚀 安装

- 在插件市场下载
- 通过以下指令进行安装：

```shell
plugin i https://github.com/Soulter/astrbot_plugin_bilibili
```

## ⚙️ 配置

插件至少需要配置 `sessdata` 才能正常获取 Bilibili 数据。
以下是两种配置方式：
1. 参考 [此指南](https://nemo2011.github.io/bilibili-api/#/get-credential) 获取你的 `sessdata`。

2. 使用`/bili_login`指令获取登录二维码，扫码登录后插件会自动获取并保存凭据。
此方式有利于解决[issue #58](https://github.com/Soulter/astrbot_plugin_bilibili/issues/58)所述412问题。不推荐使用主账号登录。

## 📖 使用说明

### 动态订阅指令

#### 参数说明

**1. 过滤器（过滤不感兴趣的内容）**

- `forward`：过滤掉转发动态。
  - `lottery`：过滤掉互动抽奖动态。
  - `video`：过滤掉视频发布动态。
  - `article`：过滤掉专栏动态。
  - `draw`：过滤掉图文动态。
  - `live`：过滤掉直播动态。
  - `forward_lottery`：过滤掉转发的互动抽奖动态。
  - **正则表达式**：任何不属于上述保留关键字的字符串都将被视为正则表达式，用于过滤动态文本内容。

**2. 提醒选项（控制群聊 @ 提醒）**

- `at_all`：开启后，在群聊中检测到该 UP 主发布动态或开播时，将尝试 `@全体成员`。
  - `live_atall`：开启后，仅在检测到该 UP 主**开播**时尝试 `@全体成员`（发布普通动态时不会）。
  - `at_sub`：设置后，会将当前发送指令的用户加入特定提醒列表。UP 主推送动态或开播时会专门 `@该用户`。
  - `unat_sub`：取消当前用户对该 UP 主的特定 `@` 提醒。

> **⚠️ 注意**：
> - 使用 `@全体成员` 相关的配置（`at_all` 和 `live_atall`）需要发送指令的用户拥有群管理员及以上权限，且机器人自身也必须具备群管理员权限，否则将降级为普通推送。
> - 为避免打扰群友，在检测到 UP 主**下播**时，不会触发任何形式的 `@` 提醒。

**示例**：
`/订阅动态 123456 lottery 关注`
`/bili_sub 123456 lottery 关注`
这条指令会订阅 UID 为 `123456` 的 UP 主，但会过滤掉**抽奖动态**以及动态内容中包含“**关注**”二字的动态。

> **提示**：该指令也用于更新已订阅 UP 主的过滤条件。

## 适用平台/适配器

- aiocqhttp
  - nakuru

## 常见问题

1. 渲染图片失败  
一般是公共接口不稳定性导致，详见[issue43](https://github.com/Soulter/astrbot_plugin_bilibili/issues/43)

2. 错误代码-352 / 412  
先查看以下issue中解决方案[issue34](https://github.com/Soulter/astrbot_plugin_bilibili/issues/34)、[issue58](https://github.com/Soulter/astrbot_plugin_bilibili/issues/58)、[issue72](https://github.com/Soulter/astrbot_plugin_bilibili/issues/72)

3. AstrBot更新到4.0版本后订阅失效  
UMO结构发生了变化，已为"全局列表"指令添加了具体订阅信息，使用该指令查看后重新订阅即可。  
简便的方法是进入data/plugin_data/astrbot_plugin_bilibili文件夹修改UMO的第一部分（使用"/sid"指令了解区别）。

4. 使用新渲染模板发不出图片  
由于图文动态布局采用了纵向布局，如果图片过长，受限于qq本身机制，需以文件形式发送。  
你很可能需要在AstrBot"配置文件-系统配置"配置"对外可达的回调接口地址"

5. 生成的图片被错误裁剪或有多余区域  
始终推荐[自部署](https://docs.astrbot.app/others/self-host-t2i.html)，并且由于t2i服务更新，推荐及时更新到最新的镜像。  
本插件会始终在合适时支持更新的版本。

## 模板开发

详见[PR#53](https://github.com/Soulter/astrbot_plugin_bilibili/pull/53)
```bash
# 启动UI开发模式
cd astrbot_plugin_bilibili
python dev_ui.py
```

[astrbot-t2i-playground](https://github.com/AstrBotDevs/astrbot-t2i-playground) 也可以帮助开发和调试模板。

## Contributors

## 更新日志

见 [CHANGELOG.md](CHANGELOG.md)

astrbot_plugin_bilibili

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README