企业官网建设流程全解析

BiliBiliToolPro 批量取关功能使用指南：按分组清理 B 站关注列表

【免费下载链接】BiliBiliToolProB 站（bilibili）自动任务工具，支持docker、青龙、k8s等多种部署方式。全面拥抱AI。敏感肌也能用。项目地址: https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro

BiliBiliToolPro 的批量取关任务按 B 站关注分组倒序取消关注，支持白名单保留和定时执行，适合关注列表里有几百个 UP、只想批量清掉某个分组（如"天选时刻"）的用户。

图：Web 管理端配置页面，批量取关任务可按上述参数逐项填写并保存

功能边界

• 只处理指定分组内的关注关系，不会扫你全部关注列表；想清理全部关注，需要先把目标移入同一个分组
• 取关顺序是分组内倒序（最早关注的先被取），逐条调用取关接口
• 支持白名单 UID 跳过，单次运行有明确的数量上限
• 不恢复误取关：取关是单向操作，取错了只能重新关注
• 支持多账号：配置多个 Cookie 时逐账号执行同一套参数

若执行完发现分组人数没变，先确认 B 站里该分组是否真的存在且非空。

使用前置条件

• 已按 docs/runInLocal.md 或 Dockerfile 任一方式部署好程序，Web 管理端可访问
• 环境变量Ray_BiliBiliCookies已填入有效 B 站 Cookie（bili_jct 字段必须存在，取关接口依赖它），获取方法见 docs/configuration.md
• 登录 B 站，把要清理的 UP 移入同一个关注分组，并记下分组名
• 建议先在 B 站 App 或网页里手动抽查该分组内容，确认没有想保留的 UP，或提前记下其 UID 备填入白名单
• 青龙面板部署者使用脚本 qinglong/DefaultTasks/bili_task_unfollowBatched.sh，脚本内 Cron 默认每月 1 号中午 12 点

若 Cookie 过期，取关接口会逐条失败并返回错误信息，日志里能直接看到原因。

参数逐项配置

分组名称 GroupName

• 作用：指定要清理的 B 站关注分组名，代码按名称精确匹配
• 推荐值：与你 B 站里分组名一字不差，默认值"天选时刻"
• 踩坑点：区分大小写和空格，匹配不到时日志输出"分组名称不存在"后直接结束，不会误伤其他分组

取关数量 Count

• 作用：本次运行的取关上限，从分组倒序取
• 推荐值：首次填 10-20 验证，确认后放大；填-1表示清空整个分组
• 踩坑点：-1 无回滚，分组人数上千时建议分几次运行；填 0 则一次都不取

白名单 RetainUids

• 作用：英文逗号分隔的 UID 列表，命中的 UP 跳过不取
• 推荐值：把分组里少数要保留的 UP 的 UID 填入，不填表示全部清理
• 踩坑点：UID 是数字（B 站个人空间地址里的 mid），写错会静默失效；跳过的条目不消耗 Count 额度，但日志会标记"白名单，跳过"

定时表达式 Cron 与开关 IsEnable

• 作用：控制是否启用及何时自动执行
• 推荐值：每月一次的低频，如0 0 6 1 * ?
• 踩坑点：Cron 是 6 段式 Quartz 表达式，写错时任务不报错也不执行，保存后先在调度页核对下次触发时间

完整参数定义见 src/Ray.BiliBiliTool.Config/Options/UnfollowBatchedTaskOptions.cs。

图：调度页面可手动触发 UnfollowBatchedJob，并查看 Cron 与上次执行状态

首次执行与结果核对

在调度页找到UnfollowBatchedJob手动触发，然后看执行日志：开头会打印分组人数和目标数量，中间每个 UP 一行"取关结果"，结尾输出"本次共取关 N 人"和"分组下剩余 M 人"。

量化核对标准：成功条数 = 目标数 - 白名单命中数 - 失败条数；执行后去 B 站确认分组人数从 T 降到 T - N。若两者不符，逐条对照日志里的失败原因。

图：执行历史可展开查看批量取关的逐条日志与剩余分组人数

确认无误后把 Cron 设为每月一次即可，每天跑没必要：取关没有收益累积，频繁调用接口反而增加被风控的概率。首次建议挑工作日上午执行，避开 B 站高峰时段。

高频问题

• 日志显示"分组名称不存在"？GroupName 与 B 站分组名不精确一致，连空格一起复制一遍再保存
• 取关结果全是"失败"？看日志里的"原因"字段，多为 bili_jct 缺失或 Cookie 过期，更新 Cookie 后重跑
• 想清空整个分组？Count 填 -1，但建议分 2-3 批，每批 200-300，中间核对一次剩余人数
• 白名单的 UP 被取了？确认填的是数字 UID 而非昵称，且逗号是英文逗号

参数细节和部署方式可自行查阅 docs/ 文档与 src/Ray.BiliBiliTool.Application/ 源码，按上面步骤配置后即可跑通。

【免费下载链接】BiliBiliToolProB 站（bilibili）自动任务工具，支持docker、青龙、k8s等多种部署方式。全面拥抱AI。敏感肌也能用。项目地址: https://gitcode.com/GitHub_Trending/bi/BiliBiliToolPro