BiliTidy

2026.03 - 2026.04 58 views

BiliTidy — B站关注清理助手

通过 AI 分析你关注的 UP 主最近视频标题，告诉你哪些值得保留、哪些可以取关。

快速开始

方式一：Web UI（推荐）

pip install flask
python source/scripts/web_ui.py
# 浏览器打开 http://localhost:5000

在网页上配置 API key 和 Cookie，点击"开始分析"，表格中可直接编辑分数和操作。

方式二：命令行

# 先配置 API
copy source\scripts\config.json.example source\scripts\config.json
# 编辑 config.json，填入 VOLCENGINE_API_KEY 和 BILIBILI_COOKIE

# 运行
python source/scripts/quick_review.py

终端直接显示结果：按 1-5 分打分，分三栏显示"建议取关 / 观望 / 建议保留"，同时生成取关清单。

============================================================
  B站关注清理 · 分析报告
============================================================
  分析数量: 120
  保留: 45  │  观望: 20  │  取关: 55
============================================================

━━━ 建议取关 (55) ━━━
  ★☆☆☆☆ UP名1 (mid:xxx)
       内容低质的营销号
       标题全是"震惊！""必看！"，无实质内容
  ...

━━━ 建议保留 (45) ━━━
  ★★★★★ UP名2 (mid:xxx)
       深度技术教程
       持续输出高质量编程内容，不可替代

输出文件：

source/output/unfollow_list.txt — 取关 UID 清单（逗号分隔）
source/output/full_report.json — 完整结构化数据

常用参数

# 只看 30 个 UP
python source/scripts/quick_review.py --max-ups 30

# 只处理某个标签的 UP
python source/scripts/quick_review.py --only-tag 准备取关

# 8 并发加速
python source/scripts/quick_review.py --workers 8

参数	默认值	说明
`--input-json`	`source/resources/export_uids.json`	UP列表
`--workers`	4	AI并发数
`--max-ups`	0（全部）	限制数量
`--only-tag`	（空）	只处理含该标签的UP
`--bili-cookie`	（空）	B站Cookie
`--titles-per-up`	10	每个UP抓取标题数
`--output-dir`	`source/output`	输出目录
`--json-only`	false	只输出JSON，不显示终端

完整流水线（高级）

run_pipeline.py 提供 7 步完整流程，每步可单独运行：

python source/scripts/run_pipeline.py

步骤	脚本	输出
1	`analyze_up_content.py`	`1_up_titles_report.md`
2	`batch_ai_summary_from_report.py`	`2_up_analysis_full_auto.md`
3	`extract_keep_follow_doc.py`	`3_up_keep_follow_only.md`
4	`extract_unfollow_list.py`	`4_unfollow_mids_list.txt`
5	`sort_up_main.py`	`5_sorted_up_analysis.md`
6	`extract_group_info.py`	`6_group_info.md`
7	`remove_10content.py`	`7_no_titles.md`

支持 --skip-fetch、--skip-analyze、--skip-sort、--skip-group、--skip-remove 跳过各阶段。

输入数据格式

source/resources/export_uids.json：

[
  {"mid": 12345, "name": "UP名称", "tag": ["标签1"]},
  {"mid": 67890, "name": "另一个UP", "tag": []}
]

打包发行版

python build_release.py
# 生成 release/FollowList.zip

油猴脚本

根目录 .js 文件是 Tampermonkey 脚本，用于浏览器中直接操作：

油猴脚本_关注分组.js — 抓取关注列表、AI分类、应用分组标签
油猴脚本.js — AI 书签整理器