少女祈祷中...
凉思录-Ryodoku's Blog
技术分享

蔚蓝档案战绩,一键挂上你的 Halo 博客

有一天我突发奇想想要在博客上挂上BlueArchive的游戏数据,就像steam展示页那样,但由于游戏官方未提供公开数据接口,在我即将放弃之时,我发现了哔哩哔哩上有数据展示页且逆向难度较低,于是便有了这个Halo插件

效果预览

当插件成功安装并配置启用后,即可在“你的域名/ba”进行访问,可以查看游戏天数,角色,好感度和大决战总力战战绩等

Screenshot_2026-10-11-10-57-14-837_com.limelight.qiin_1791688976912edit.webp

功能特性

  1. 前台短链接:/ba、/stats 直达战绩页,免登录公开访问

  2. 档案图录风战绩页:暖纸底 + 衬线大数字 + 编号分节,学员立绘装裱展品,官方星级/属性图标(图片直链 B站 CDN,referrerpolicy=no-referrer)

  3. 双侧栏:桌面(≥1440px)左右两栏;移动端(<1440px)转为悬浮按钮 + 抽屉/底部弹层——章节索引(scrollspy)、学员速查(直达展品)、好感 Top5、属性分布版画、战果批注

  4. 自动刷新:Cookie → 签名 URL → 战绩 API;stale-while-revalidate 读路径不阻塞;ETag/304 复访零字节

  5. 后台可配:Cookie/UID、刷新周期、主题色、标题、显示开关;配置持久化,重启不丢

  6. 优雅降级:Cookie 失效时返回 200 空态页 + 可读原因,不白屏不 500

  7. 演示模式:/stats/html?demo=1 用脱敏存档渲染完整样式(无需 Cookie)

  8. 公开访问:RBAC role-template 聚合到 anonymous,读者免登录

适用范围与服务器说明

本插件仅支持国服(中国大陆服务器),由 Bilibili 代理运营。国际服(日服/韩服/台服/全球服)数据不在 B站 接口内,无法使用

国服内支持两个渠道,前提是游戏账号已绑定至 Bilibili

未绑定的账号请先去 B站 App → 游戏中心 → 蔚蓝档案 → 绑定角色,绑定后插件才能查询到数据

B服和官服可以同时绑定在同一个 B站账号下,但只能设置一个「主显示」。本插件通过 B站游戏中心的绑定接口取数,拿到的永远是当前主显渠道的数据

安装和使用教程

  • 首先需要在电脑浏览器打开b站登录账号(请确保b站账号有绑定游戏数据),按 F12 打开开发者工具 → 切到「网络(Network)」标签 → 刷新页面 → 点击任意一条发往 bilibili.com 的请求 → 在「请求标头」中找到 Cookie: 一行,整行复制保存

Screenshot_2026-10-11-11-03-59-183_com.limelight.qiin_1791689071132edit.webp
  • 然后在Halo的后台安装该插件并启用,在侧边菜单栏的工具目录下的蔚蓝档案战绩输入b站账号的UID和Cookie并保存就安装完成了,保存配置后必须点右上角「立即刷新」才拉取数据

Screenshot_2026-10-11-10-56-54-308_com.limelight.qiin_1791689171364edit.webp

免责声明

  1. 非官方性质:本插件是社区第三方开源工具,与 bilibili(上海宽娱数码科技)、Yostar(悠星网络)、NEXON 及《蔚蓝档案 / Blue Archive》官方无任何关联、授权、赞助或背书关系

  2. 商标与素材归属:"蔚蓝档案 / Blue Archive" 及相关角色名称、立绘、图标等素材的著作权与商标权归其各自权利人(NEXON / Yostar / bilibili)所有。本插件不分发任何素材文件——所有图片均以 URL 形式直链 bilibili 官方 CDN,由最终用户浏览器自行加载

  3. 接口不稳定风险:数据获取依赖 Bilibili 的非公开网页接口,可能随时变更、限流或失效,恕不保证持续可用

  4. 账号风险自担:使用 Cookie 调用接口属于自动化访问,可能违反 Bilibili 用户协议并导致账号被风控、封禁等后果。请仅用于个人低频展示自己账号的数据;由此产生的一切后果由使用者自行承担,作者不承担任何责任

  5. 无担保:软件按 “AS IS”(现状提供) 分发,在适用法律允许的最大范围内,作者不提供任何明示或暗示的担保(包括但不限于适销性、特定用途适用性、不侵权)

  6. 责任限制:在任何情况下,作者不对因使用或无法使用本软件导致的任何损害(数据丢失、账号受限、业务中断等)负责,即使已被告知发生损害的可能性

  7. 合规使用:请遵守你所在司法辖区及 Bilibili 服务条款的相关规定;不得用于批量爬取、查询他人账号或其他可能损害平台/第三方权益的用途

  8. AI 辅助开发:如上文披露,本仓库代码大量由 AI 编程工具生成、经人工审阅与实测;这既是一种透明,也意味着欢迎任何形式的审查与 fork

注意:战绩页是公开页面,任何访客都能看到上面展示的数据,发布前先确认这些内容你愿意公开

使用本插件即视为你已阅读并同意上述全部条款

插件获取和项目地址

GitHub地址:https://github.com/Ryodoku092/halo-plugin-blue-archive-stats

Issue地址:https://github.com/Ryodoku092/halo-plugin-blue-archive-stats/issues

下载地址:https://github.com/Ryodoku092/halo-plugin-blue-archive-stats/releases

编辑:独凉生

校对:Qwen3.8Flash

评论