B站粉丝列表搜索 · 脚本介绍

给 B 站粉丝页补上一个和关注页一模一样的搜索框。输了字就搜，搜的是整个粉丝列表，不是当前这一页。

版本：1.0.0
类型：用户脚本（ScriptCat / Tampermonkey / Violentmonkey）
文件：dist/bfs-fans-search.user.js（约 397 KB，拼音库已内联，离线可用）
匹配站点：https://space.bilibili.com/*、https://www.bilibili.com/space/*
权限：@grant none，不加载任何远程脚本

解决的问题

B 站的空间页里，「关注」有搜索框，「粉丝」没有。

粉丝页的头部其实和关注页是同一个组件，只是它是空的：

<!-- 关注页 -->
<div class="relation-content-header__right">
  <div class="vui_input fav-list-header-filter__search">
    <input placeholder="输入关键词">
  </div>
</div>

<!-- 粉丝页：同一位置，空的 -->
<div class="relation-content-header"><!----><!----></div>

于是粉丝一多，想找某个人只能一页一页翻，而每页只有 24 个。

这个脚本做的，就是把粉丝页里那个空位置填上同款搜索框，并且让搜索范围覆盖整个粉丝列表。

效果

默认状态 —— 只是多了一个搜索框，不打扰原有列表：

粉丝页头部多了搜索框

搜索中文昵称：

搜索中文昵称

搜索拼音（qinuo 命中「奇诺比奥和奇诺比珂qs」）：

搜索拼音

安装

安装脚本管理器（任选其一）：
- ScriptCat 脚本猫（推荐，国人多用，支持后台脚本）
- Tampermonkey
- Violentmonkey
安装脚本，两种方式任选：
- 打开管理器面板 →「添加新脚本」→ 把 dist/bfs-fans-search.user.js 的内容整个粘贴进去 → 保存；
- 或者直接把 .user.js 文件拖进浏览器窗口，管理器会弹出安装页。
打开 https://space.bilibili.com/<你的UID>/fans（或从「我的粉丝」点进去），头部就会多出搜索框，不需要登录脚本管理器账号，也不需要额外配置。

首次安装后如果没反应，刷新一次页面即可。脚本是 document-idle 注入，站点是单页应用，之后在空间内跳转不需要再刷新。

用法

搜什么

输入	结果
`小明`	昵称里含「小明」的粉丝
`xiaoming`	拼音全拼，同样命中「小明」「小明明同学」
`xm`	拼音首字母
`qinuobiao`	「奇诺比奥和奇诺比珂qs」
`qnbahqnbk`	同上，首字母连写
`老师 qin`	两个关键词同时命中（AND，空格分隔）
`3706975095359970`	按 UID 精确查找
`A-SOUL`	英文昵称，不区分大小写

拼音命中时，卡片上会有一个蓝色小标签（例如 qinuobiao），告诉你 这条是靠拼音搜出来的，避免出现「我没搜这个名字，它怎么出来了」的疑惑。
昵称、签名里的命中部分会高亮成黄色。
支持中文输入法：拼音组合期间不触发搜索，选完字才搜。

筛选

搜索框左边是四个筛选条，带实时计数：

全部 / 互关 / 单向 / 大会员

它们可以和搜索词叠加使用，例如「只看互关的、名字带老师的」。

排序

不输关键词时，结果按关注时间从近到远排列；输了关键词时，按相关度排列（UID 精确 > 昵称完全匹配 > 昵称前缀 > 昵称包含 > 拼音 > 首字母 > 签名）。

其他

显示更多：一次先渲染 60 条，点「显示更多」继续追加，避免一次插入上千个 DOM 节点导致卡顿。
导出 CSV：把当前搜索结果导出成表格，带 BOM，Excel / WPS 直接打开不乱码。
刷新：清掉本地缓存重新扫描。
清空：把搜索框清空、筛选切回「全部」，页面立刻还原成站点原生的分页列表（包括底部页码），不会有残留的隐藏样式。

它和「站内搜索」有什么区别

	站内搜索	本脚本
搜索范围	全站用户	当前这个人的粉丝列表
匹配方式	昵称关键词	昵称 / 拼音 / 首字母 / UID / 签名
结果排序	平台算法	关注时间或相关度
能否筛选互关	不能	能

典型场景：想在自己的 400 多个粉丝里找出某个眼熟的人，但只记得读音、或者只记得名字里有个字。站内搜索做不到，脚本可以。

它是怎么工作的

识别页面：从 URL 解析出 UID（/123456/fans、/123456/relation/fans、/zh-CN/123456/fans 以及旧版 www.bilibili.com/space/123456#/fans），只在这些页面上激活。
注入组件：找到 .space-fans .relation-content-header，把搜索框和筛选条插进站点预留的 __left / __right 插槽。类名、图标字体、尺寸（310px）全部沿用站点的，颜色取站点 CSS 变量，所以亮色 / 暗色皮肤都自动跟随。
拉全量数据：以 ps=50 逐页请求 x/relation/fans，去重后合并。第一页会做一次预检：如果接口把 ps 悄悄压小，就按真实页大小重新分页，避免漏人。
边扫边搜：每拿到一页就增量建索引并渲染，不用等全部扫完。
本地缓存：扫完写进 localStorage，下次进同一个页面秒开，点「刷新」才重扫。

关于风控

B 站对短时间内的密集请求比较敏感，翻页太快会返回 -352。

脚本的处理：

每页之间间隔 260–380ms，并叠加随机抖动，不呈现固定节奏；
遇到 -352 / -412 / -799 自动退避重试，间隔依次为 1.5s → 3s → 6s → 12s → 20s → 30s；
状态条会显示「第几次重试」，最多 6 次；
即使最终失败，已经扫到的人也不会丢，搜索照样能用，状态条会显示「已获取 N 位，找到 M 位」，并给一个「重试」入口。

如果连续失败，建议：隔几分钟再点「重试」，或者先去正常刷几个视频，让账号行为看起来正常一些。

隐私与安全

不收集任何数据，不向任何第三方服务器发送请求。所有网络请求只发往 api.bilibili.com。
只读取你自己有权限看到的粉丝列表（依赖你浏览器里已登录的 cookie，脚本不接触、不存储 cookie）。
扫描结果只存在你本机的 localStorage（键名 bfs:v1:fans:<UID>，压缩存储，1000 人约 120KB）。
不注入远程脚本，拼音库（pinyin-pro，MIT）直接内联在文件里。
「移除粉丝」按钮只在你自己的粉丝页出现，且必须二次确认——判断依据是运行时请求 /x/web-interface/nav 拿到的登录 UID 与 URL 里的 UID 是否一致，脚本里没有任何写死的 UID。

常见问题

Q：搜索框没出现？ A：确认你打开的是粉丝页（地址栏以 /fans 结尾）。在个人主页、关注页、动态页都不会注入。另外确认脚本管理器里这个脚本是启用状态。极少数情况下站点改版会导致选择器失效，可以反馈。

Q：搜不到某个明明存在的粉丝？ A：先看状态条里的「共 N 位粉丝」。如果 N 明显小于你实际粉丝数，说明接口只返回了前一部分—— 网页端前端只展示前 1000 位，接口在部分账号上能翻得更深，脚本不会主动截断，但接口不给的它也没办法。另外确认这个人没有被你搜索词之外的筛选条件排除。

Q：为什么数量显示 439，但只找到 400 多？ A：total 是接口声明的总数，实际能取到的以扫描结果为准；两者不一致时状态条会说明。

Q：未登录能用吗？ A：不能。粉丝列表接口需要登录态，未登录会返回 -101，搜索框会提示你先登录。

Q：会不会拖慢页面？ A：不会。只有打开粉丝页时才工作，扫描是异步的、边扫边渲染；离开粉丝页会停掉扫描并移除注入的节点。

Q：和「B站粉丝列表搜索」扩展版有什么区别？ A：功能完全一致，代码同源。扩展版只是给装不了脚本管理器的浏览器（同样是 Chromium 内核）用的。

兼容性

Chrome / Edge / 其他 Chromium 内核浏览器：完全可用
Firefox：理论可用（脚本同样能在 Firefox 的 Tampermonkey 里跑），未逐一验证
移动端浏览器：未适配（B 站手机版空间页结构不同）

版本

1.0.0

在粉丝页头部内联搜索框，与关注页视觉一致
支持筛选条、导出 CSV、拼音命中提示

许可

MIT。内联的 pinyin-pro 版权归其作者，同样为 MIT。

加载中…