B站评论自动回复机器人

使用 DeepSeek API 自动回复 B 站账号下视频新增评论的 Python 机器人，现已集成完整的 Web UI 管理界面。

功能特性

🐳 Docker 部署超轻量：内存占用平均仅约 50M，最高不超过 100M
🌐 Web UI 管理界面：启动后自动打开浏览器，所有功能通过图形界面操作
🤖 自动监控 B 站视频的新增评论
🎯 仅回复指定视频：支持配置只回复某个特定视频的评论
🧠 使用 DeepSeek API 生成智能回复
📝 链式回复支持（楼中楼）：监控并回复主评论下的子评论，实现多层对话互动
👍 支持自动点赞评论（可选）
🔥 回复后点赞用户视频：可自动点赞评论用户的最新视频
👥 仅给粉丝视频点赞：支持只给关注了你的用户的视频点赞
🔄 Cookie 自动刷新，避免登录过期
📝 实时日志查看，支持按级别过滤
📚 回复历史记录查看
🛡️ 智能频率控制和重试机制
💾 视频列表缓存，减少 API 请求
📱 扫码登录获取 Cookie
⚙️ 配置热更新，修改后立即生效无需重启
📊 详细的操作日志：所有关键操作都有完整的日志记录
🔒 登录密码保护：可设置访问密码，支持自定义或随机生成

API 版本

为降低频率限制，以下接口已切换至 B 站 APP 端（模拟 BiliDroid 客户端）：

功能	旧接口 (Web)	新接口 (APP)
视频列表	`api.bilibili.com/x/space/arc/search`	`app.bilibili.com/x/v2/space/archive/cursor`
点赞视频	`api.bilibili.com/x/web-interface/archive/like`	`app.bilibili.com/x/v2/view/like`
BVID→AID	`/x/web-interface/view` (API)	本地算法转换 (零网络开销)

APP 端接口需携带 appkey+sign 签名及 BiliDroid UA，程序已自动处理。

快速开始

方式一：本地运行

1. 安装依赖

pip install -r requirements.txt

2. 启动程序

双击 启动机器人.bat 或执行：

python main.py

程序会自动打开浏览器访问 http://127.0.0.1:5000，你可以通过 Web UI 完成所有配置和操作。

方式二：Docker 部署

1. 使用 Docker Hub 镜像（推荐）

项目已发布至 Docker Hub，可以直接拉取使用：

docker pull janson20/bilicommentbot:latest

运行容器（所有数据存储在 ./data 目录，只需挂载一个卷）：

mkdir -p ./data
docker run -d \
  --name bilicomment-bot \
  -p 5000:5000 \
  -v $(pwd)/data:/app/data \
  -e TZ=Asia/Shanghai \
  -e BILI_DATA_DIR=/app/data \
  janson20/bilicommentbot:latest

首次启动会自动在 ./data 目录下生成配置文件，之后编辑 ./data/config.toml 填入配置即可。

访问 http://localhost:5000 使用 Web UI。

2. 使用 GitHub Container Registry 镜像

项目也已发布至 GitHub Container Registry：

docker pull ghcr.io/janson20/bilicommentbot:main

运行容器：

mkdir -p ./data
docker run -d \
  --name bilicomment-bot \
  -p 5000:5000 \
  -v $(pwd)/data:/app/data \
  -e TZ=Asia/Shanghai \
  -e BILI_DATA_DIR=/app/data \
  ghcr.io/janson20/bilicommentbot:main

访问 http://localhost:5000 使用 Web UI。

3. 使用 Docker Compose（推荐）

编辑 docker-compose.yml，修改镜像为 Docker Hub 镜像：

version: '3.8'

services:
  bilicomment:
    image: janson20/bilicommentbot:latest
    container_name: bilicomment-bot
    ports:
      - "5000:5000"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Asia/Shanghai
      - BILI_DATA_DIR=/app/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:5000/"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

启动服务：

docker-compose up -d

访问 http://localhost:5000 使用 Web UI。

常用命令：

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 查看日志
docker-compose logs -f

# 重启服务
docker-compose restart

# 拉取最新镜像并重启
docker-compose pull
docker-compose up -d

4. 本地构建镜像

如需自行构建镜像：

docker build -t bilicomment-bot .

运行容器：

mkdir -p ./data
docker run -d \
  --name bilicomment-bot \
  -p 5000:5000 \
  -v $(pwd)/data:/app/data \
  -e TZ=Asia/Shanghai \
  -e BILI_DATA_DIR=/app/data \
  bilicomment-bot

提示：推荐使用 Docker Hub 镜像 janson20/bilicommentbot:latest，无需自行构建。

5. Docker 数据目录结构

所有配置和数据文件统一存储在 ./data 目录下，只需挂载一个卷：

./data/
├── config.toml              # 配置文件
├── history.json             # 回复历史记录
├── bilibili_cookie.json     # Cookie 持久化文件
├── video_cache.json         # 视频列表缓存
└── logs/
    └── bot.log              # 程序运行日志

3. 配置并启动

获取凭证：在 Web UI 的「登录」页面，点击「扫码登录」，用 B 站 APP 扫描二维码获取 Cookie
配置 DeepSeek API：在「配置」→「DeepSeek」填入你的 API 密钥
启动机器人：在「控制台」页面点击「启动机器人」
查看日志：在「实时日志」页面监控运行状态

Web UI 功能页面

页面	功能说明
📊 控制台	机器人启动/停止控制、登录状态验证、实时统计（回复数/视频数/状态）、清空缓存
⚙️ 配置	6个分类 Tab：B站、DeepSeek、回复策略、频率控制、缓存、日志 —— 支持热更新
🔑 登录	扫码登录获取 Cookie，登录成功后自动写入配置
📝 历史记录	分页查看所有回复历史，支持清空
📋 实时日志	WebSocket 实时推送日志，可按级别过滤（INFO/WARNING/ERROR/DEBUG），支持自动滚动

配置说明

配置文件为 config.toml，你可以通过 Web UI 的「配置」页面修改，也可以直接编辑文件。以下是主要配置项说明：

B站配置

配置项	说明	默认值
`uid`	你的 B 站用户ID（从主页URL获取）	-
`cookie`	B 站登录 Cookie（通过扫码登录自动获取）	-
`refresh_token`	Cookie 刷新令牌（自动刷新时需要）	-
`check_interval`	检查评论的间隔时间（秒）	60
`auto_refresh_cookie`	是否自动刷新 Cookie	true
`cookie_refresh_interval`	Cookie 刷新间隔（分钟）	30
`max_comment_pages`	获取评论的最大页数	10
`max_video_pages`	获取视频列表的最大页数	10

DeepSeek API 配置

配置项	说明	默认值
`api_key`	DeepSeek API 密钥	-
`base_url`	API 基础 URL	https://api.deepseek.com/v1
`model`	使用的模型	deepseek-chat
`max_tokens`	最大回复长度	200
`temperature`	温度参数（0-1）	0.7
`system_prompt`	系统提示词，定义 AI 回复风格	友善的 B 站 UP 主

回复配置

配置项	说明	默认值
`enabled`	是否启用自动回复	true
`prefix`	回复前缀	-
`only_new`	是否只回复未处理的评论	true
`max_process`	每次最多处理的评论数	10
`reply_delay`	回复延迟（秒）	3
`like_enabled`	是否在回复前先点赞评论	false
`context_comments_count`	上下文评论数（生成回复时参考前 N 条评论）	0
`only_bvid`	仅回复指定视频的 BVID（留空则回复所有视频）	-
`like_user_video_enabled`	是否在回复后点赞评论用户的最新视频	false
`like_user_video_only_followers`	是否仅点赞关注了你的用户的视频	false
`chained_reply_enabled`	是否启用链式回复（楼中楼）	true
`max_reply_depth`	最大回复深度（层数），设置楼中楼回复的最大嵌套层数	3

请求频率控制

配置项	说明	默认值
`min_request_interval`	最小请求间隔（秒）	3.0
`max_retries`	最大重试次数	3
`retry_delay`	重试基础延迟（秒）	5

智能频率控制机制：

指数退避：根据连续失败次数按 2^n 倍增长请求间隔，最大可达基础间隔的 10 倍
频率限制检测：同时检测 HTTP 429 和 B 站 JSON 响应体中的频率限制错误码（-509/-412/-799 等）
随机抖动：添加随机延迟避免多客户端同步重试
请求头随机化：模拟真实用户行为，轮流使用多种 User-Agent
视频列表 API 已切换至 B 站 APP 端接口，大幅降低频率限制触发概率

缓存配置

配置项	说明	默认值
`enabled`	是否启用缓存	true
`expire_time`	缓存过期时间（秒）	300

视频缓存配置

配置项	说明	默认值
`expire_time`	视频列表缓存过期时间（秒）	43200（12小时）
`cache_file`	视频缓存文件路径	video_cache.json

日志配置

配置项	说明	默认值
`level`	日志级别（DEBUG/INFO/WARNING/ERROR）	INFO
`file`	日志文件路径	logs/bot.log
`console`	是否输出到控制台	true

安全配置

配置项	说明	默认值
`enabled`	是否启用登录密码保护	false
`password`	登录密码（SHA-256哈希值，通过Web UI设置）	""

完整配置示例

参考 config.example.toml 文件：

[bilibili]
uid = "你的B站用户ID"
cookie = "SESSDATA=xxx; bili_jct=xxx; ..."
refresh_token = "刷新令牌（可选）"
check_interval = 300  # 5分钟检查一次
auto_refresh_cookie = true
cookie_refresh_interval = 30
max_comment_pages = 10
max_video_pages = 10

[deepseek]
api_key = "sk-xxx"
base_url = "https://api.deepseek.com/v1"
model = "deepseek-chat"
max_tokens = 200
temperature = 0.7
system_prompt = "你是一个友善的B站游戏区Minecraft UP主，请对评论做出自然、友好的回复。回复要简洁明了，控制在100字以内。"

[reply]
enabled = true
prefix = ""
only_new = true
max_process = 10
reply_delay = 3
like_enabled = false
context_comments_count = 0
only_bvid = ""  # 留空则回复所有视频，填写 BVID（如 BV1xx411c7mD）则仅回复该视频
like_user_video_enabled = false  # 回复后自动点赞评论用户的最新视频
like_user_video_only_followers = false  # 仅点赞关注了你的用户的视频（需要配置 uid）
chained_reply_enabled = true  # 启用链式回复（楼中楼）
max_reply_depth = 3  # 最大回复深度（层数）

[rate_limit]
min_request_interval = 3.0
max_retries = 3
retry_delay = 5

[cache]
enabled = true
expire_time = 300

[video_cache]
expire_time = 43200  # 12小时
cache_file = "video_cache.json"

[logging]
level = "INFO"
file = "logs/bot.log"
console = true

获取凭证

获取 B 站 Cookie（推荐方式：扫码登录）

启动程序后访问 Web UI 的「登录」页面
点击「扫码登录」按钮
使用 B 站 APP 扫描二维码并确认登录
登录成功后 Cookie 自动填入配置

手动获取方式（备用）：

登录 B 站网页版
按 F12 打开开发者工具
切换到 Network 标签
刷新页面
找到任意请求，查看 Request Headers 中的 Cookie
复制完整的 Cookie 字符串

重要：Cookie 中必须包含 bili_jct 字段，这是 CSRF 校验必需的。

获取 B 站用户 ID

访问你的 B 站主页
查看 URL 中的数字部分（如：space.bilibili.com/123456789）
这个数字就是你的用户 ID

获取 DeepSeek API 密钥

访问 DeepSeek 官网
注册并登录
在 API 管理页面创建新的 API 密钥
将密钥填入配置

功能详解

Cookie 自动刷新

机器人支持 Cookie 自动刷新功能，可避免因 Cookie 过期而需要重新获取的问题：

在配置中设置 auto_refresh_cookie = true
提供有效的 refresh_token 参数
设置 cookie_refresh_interval 控制刷新间隔（默认 30 分钟）
Cookie 和 refresh_token 会自动保存到 bilibili_cookie.json 文件

Cookie 持久化

Cookie 状态会保存到 bilibili_cookie.json
包含 cookie、refresh_token 和时间戳
程序退出前自动保存
启动时优先从文件加载

链式回复支持（楼中楼）

机器人支持监控并回复主评论下的子评论（即"楼中楼"），实现真正的多层对话互动：

功能特性：

自动获取主评论下的所有子评论
支持配置最大回复深度（防止无限递归）
回复子评论时，会自动将父评论作为上下文
默认启用，可在配置中关闭

配置说明：

chained_reply_enabled: 是否启用链式回复（默认 true）
max_reply_depth: 最大回复深度，例如设置为 3 表示最多回复到第 3 层评论（默认 3）

技术实现：

使用 B 站 API https://api.bilibili.com/x/v2/reply/reply 获取子评论
递归获取子评论，支持配置最大深度
回复时正确使用 root 和 parent 参数，确保回复显示在正确的位置

使用建议：

建议保持默认启用状态，以增强社区互动感
如果视频评论量很大，可适当降低 max_reply_depth 以减少 API 请求
配合 only_new = true 使用，避免重复回复

视频列表缓存

为了减少 API 请求频率，机器人会将视频列表缓存到 video_cache.json 文件中，默认缓存时间为 12 小时。

缓存机制：

首次运行时自动获取视频列表并缓存
每 12 小时自动更新视频列表
如果获取失败，会使用过期缓存
缓存保存到文件，重启后仍然有效

清除缓存：

在 Web UI 的「控制台」页面点击「清空缓存」
或删除 video_cache.json 文件后重启程序

历史记录

机器人会自动将回复过的评论保存到 history.json 文件中，包含以下信息：

评论 ID 和内容
评论用户信息
回复内容和时间
原始评论时间

你可以在 Web UI 的「历史记录」页面查看所有回复历史。

实时日志

程序运行时会生成详细的日志，包括：

评论获取和处理信息
API 调用和响应
错误和警告信息
Cookie 刷新状态

在 Web UI 的「实时日志」页面可以：

实时查看日志输出
按级别过滤日志
支持自动滚动到最新日志

故障排除

Cookie 相关错误

错误提示：未找到 CSRF token，无法回复评论

原因：Cookie 中缺少 bili_jct 字段
解决：重新通过扫码登录获取 Cookie

错误提示：Cookie 已过期，需要重新登录

原因：Cookie 失效且无法自动刷新
解决：重新扫码登录获取新的 Cookie

API 请求错误

错误提示：请求过于频繁 (-509/-412/-799 或 HTTP 429)

原因：请求频率超过 B 站限制；视频列表接口为 APP 端 API，对频率限制已较宽松
解决：增大 min_request_interval 值（建议 ≥ 5s），减少 max_video_pages，或利用视频缓存减少请求

错误提示：JSON 解析失败

原因：B 站 API 返回格式变更或响应被压缩
解决：检查日志中的响应内容，或清除缓存重试

DeepSeek API 错误

错误提示：DeepSeek API 调用失败

原因：API 密钥无效、配额不足或网络问题
解决：检查 api_key 配置，确保账户有足够配额

回复内容为空或不合理

原因：system_prompt 设置不当
解决：调整 system_prompt，使其更符合预期回复风格

其他问题

无法获取视频列表

检查 uid 是否正确
确保网络连接正常
查看日志中的详细错误信息

评论未回复

检查 reply.enabled 是否为 true
查看日志中是否有错误信息
确认评论未被历史记录过滤

Web UI 无法打开

检查端口 5000 是否被占用
确认已安装 Flask 和 Flask-SocketIO
查看控制台错误信息

技术实现

核心架构

后端：Flask + Flask-SocketIO，提供 RESTful API 和 WebSocket 实时通信
前端：纯 HTML/CSS/JS，内嵌在 Python 字符串中
机器人核心：后台线程运行，响应停止信号

API 技术细节

视频列表：使用 B 站 APP 端 API (app.bilibili.com)，携带 appkey+sign 签名和 BiliDroid UA 模拟 Android 客户端
BVID↔AID 互转：纯本地数学算法（异或+查表），无需 API 请求，零网络开销
评论/回复：使用 B 站 Web 端 API (api.bilibili.com)，基于 Cookie 认证
频率控制：指数退避 + B站错误码检测（-509/-412/-799/10403）+ 部分结果缓存

主要模块

BilibiliCookieManager

管理 B 站 Cookie 的生命周期
自动刷新过期的 Cookie
持久化 Cookie 状态到文件

BiliCommentBot

机器人主逻辑控制器
管理视频列表和评论获取
协调 API 请求和回复生成
实现智能频率控制

WebServer

Flask 应用服务器
提供 Web UI 界面
WebSocket 实时日志推送
配置 API 接口

请求处理流程

初始化阶段
- 加载配置文件
- 初始化 Cookie 管理器
- 加载历史记录
- 加载视频缓存
监控循环
- 检查 Cookie 状态
- 获取视频列表（使用缓存）
- 获取视频评论
- 过滤已处理评论
- 生成 AI 回复
- 发送回复（可选点赞）
- 保存历史记录
错误处理
- 自动重试失败的请求
- 智能退避避免频率限制
- 降级到使用缓存
- 记录详细日志

文件说明

文件	说明
`main.py`	主程序，包含 Web UI 和机器人核心逻辑
`启动机器人.bat`	Windows 启动脚本
`config.toml`	配置文件（本地运行，首次运行自动生成）
`config.example.toml`	配置文件示例（本地）
`config.docker.example.toml`	Docker 配置文件示例
`data/`	Docker 模式数据目录（包含配置、历史、缓存、日志）
`requirements.txt`	Python 依赖
`history.json`	回复历史记录（本地运行）
`bilibili_cookie.json`	Cookie 持久化文件（本地运行）
`video_cache.json`	视频列表缓存（本地运行）
`logs/bot.log`	程序运行日志（本地运行）

运行要求

Python 3.11+ （本地运行）
Docker & Docker Compose 20.10+ （Docker 部署）
网络连接正常
已安装依赖（见 requirements.txt）

Docker 环境配置

在 Docker 环境中运行时，程序会自动检测并禁用浏览器自动打开功能。你需要手动访问 http://<宿主机IP>:5000 来使用 Web UI。

远程访问配置

如果需要在局域网内远程访问 Web UI，修改 docker-compose.yml 中的端口映射：

ports:
  - "0.0.0.0:5000:5000"  # 允许外部访问

然后通过 http://<服务器IP>:5000 访问。

健康检查

Docker 容器内置了健康检查，每 30 秒检查一次服务状态。可以通过以下命令查看健康状态：

docker inspect bilicomment-bot --format='{{.State.Health.Status}}'

注意事项

请确保 Cookie 和 API 密钥的正确性
Cookie 必须包含 bili_jct 字段，否则会出现 CSRF 校验失败
建议合理设置检查间隔，避免频繁请求
回复延迟设置可以防止被 B 站限制
首次运行建议先测试，确认配置正确后再长期运行
启用点赞功能会增加 API 请求频率，请谨慎使用
Web UI 默认运行在 http://127.0.0.1:5000，如需远程访问请修改代码中的 host 配置或使用 Docker 部署时绑定到 0.0.0.0
Docker 部署时，所有数据存储在 ./data 目录，确保宿主机有足够的磁盘空间
首次 Docker 部署时，容器会自动在 ./data 目录下生成配置文件，编辑 ./data/config.toml 即可

免责声明

本工具仅供学习和研究使用，请遵守 B 站的相关规定和 API 使用条款。使用本工具所产生的任何后果由用户自行承担。

Name		Name	Last commit message	Last commit date
Latest commit History 59 Commits
.github/workflows		.github/workflows
.dockerignore		.dockerignore
.gitignore		.gitignore
DOCKER.md		DOCKER.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
README_rate_limit.md		README_rate_limit.md
auto_launcher.py		auto_launcher.py
config.docker.example.toml		config.docker.example.toml
config.example.toml		config.example.toml
config_gui.py		config_gui.py
docker-compose.yml		docker-compose.yml
docker-entrypoint.sh		docker-entrypoint.sh
main.py		main.py
rate_limit_monitor.py		rate_limit_monitor.py
requirements.txt		requirements.txt
test.py		test.py
启动机器人.bat		启动机器人.bat

Folders and files

Latest commit

History

Repository files navigation

B站评论自动回复机器人

功能特性

API 版本

快速开始

方式一：本地运行

1. 安装依赖

2. 启动程序

方式二：Docker 部署

1. 使用 Docker Hub 镜像（推荐）

2. 使用 GitHub Container Registry 镜像

3. 使用 Docker Compose（推荐）

4. 本地构建镜像

5. Docker 数据目录结构

3. 配置并启动

Web UI 功能页面

配置说明

B站配置

DeepSeek API 配置

回复配置

请求频率控制

缓存配置

视频缓存配置

日志配置

安全配置

完整配置示例

获取凭证

获取 B 站 Cookie（推荐方式：扫码登录）

获取 B 站用户 ID

获取 DeepSeek API 密钥

功能详解

Cookie 自动刷新

Cookie 持久化

链式回复支持（楼中楼）

视频列表缓存

历史记录

实时日志

故障排除

Cookie 相关错误

API 请求错误

DeepSeek API 错误

其他问题

技术实现

核心架构

API 技术细节

主要模块

请求处理流程

文件说明

运行要求

Docker 环境配置

远程访问配置

健康检查

注意事项

免责声明

Star History

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 12

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages