BiliBiliTool 是一个 B 站自动执行任务的小工具,当我们忘记做 B 站的某项任务时,它会像一个小助手一样,按照我们预先吩咐她的命令,帮助我们完成计划的任务。
- 比如,当我们忘记每月领取 5 张 B 币券、忘记领取自己的大会员权益时,她会帮助我们每月自动领取
- 比如,当我们某天不小心忘记为自己喜欢的 up 的视频投币时,她会帮助我们自动观看、分享并投币(白嫖是不可能白嫖,这辈子都不可能白嫖的)
- 比如,当我们月底忘记使用 B 币券为喜欢的 up 充电时,帮助我们在 B 币券过期前进行充电(如果没有喜欢up,也可以为自己充个电啊,做个用爱为自己发电的人~)
另外,通过结合 GitHub Actions,可以实现每天线上自动运行,只要部署一次,小助手就会在背后一直默默地帮我们完成我们预先布置的任务。
还有其他一些小功能,比如漫画签到、直播签到等等,这里就不细说了,大家可以自己去慢慢探索~
Github 仓库地址:RayWangQvQ/BiliBiliTool
本应用仅用于学习和测试,自觉爱护小破站,请勿滥用!
(如果图片挂了,是因为 GitHub 的服务器在国外,经常会刷不出,有 VPN 的开启 VPN,没有的也可先先参考 我的博客,但博客内容不保证最新)
BiliBiliTool 实现自动任务的原理,是通过调用一系列 B 站开放的接口实现的。
举例来说,要实现观看视频的任务,只需要通过调用 B 站的上传视频观看进度 Api 即可, 接口 Api:"https://api.bilibili.com/x/click-interface/web/heartbeat", 入参:视频 Id、当前观看时间、用于身份认证的 Cookie。
BiliBiliTool 就是收集了一系列这样的接口,通过每日自动运行程序,依次调用接口,来实现功能的。
要使用 BiliBiliTool,我们只需要做两步,首先是获取自己的 Cookie 作为配置信息,然后将配置输入 BiliBiliTool 程序并运行即可。
- 浏览器打开并登录bilibili 网站
- 按 F12 打开"开发者工具",依次点击 应用程序/Application -> 存储-> Cookies
- 找到
DEDEUSERID
、SESSDATA
、bili_jct
三项,复制保存它们到记事本,待会儿会用到。
运行 BiliBiliTool 有两种方式,一种是通过 Github 的 Actions 实现线上的每天自动运行,一种是本地运行或调试。
对于熟悉 Github 的朋友,推荐使用方式一 Github Actions,可以实现线上的每天自动运行,不需自己动手,一劳永逸。
对于没有 Github 账号的、或者想先快速运行一下尝个鲜、或是要部署到自己服务器的朋友,可以跳转到方式二 Release 包运行,操作简单快速。
Github Actions 是微软(巨硬)收购 G 站之后新增的内置 CI/CD 方案,其核心就是一个可以运行脚本的小型服务器(2 核 CPU + 7G RAM + 14 G SSD)。
有了它,我们就可以实现每天线上自动运行我们的应用程序。
Ⅰ. 首先 fork 本项目到自己的仓库
Ⅱ. 进入自己 fork 的仓库,点击 Settings-> Secrets-> New Secrets 添加以下 3 个 Secrets。它们将作为应用启动时的命令行参数被传入程序。
要新增的 Secret Name 与之前的 Cookie Name 的对应关系如下:
Secret Name | Cookie Name | Secret Value |
---|---|---|
USERID | DEDEUSERID | 刚才浏览器获取的 |
SESSDATA | SESSDATA | 刚才浏览器获取的 |
BILIJCT | BILI_JCT | 刚才浏览器获取的 |
Ⅲ. 开启 Actions 并触发每日自动执行
Github Actions 默认处于关闭状态,前面都配置好后,请手动开启 Actions,执行一次工作流,验证是否可以正常工作,操作步骤如下图所示:
运行结束后,可查看运行日志:
workflow 的执行策略默认是每天晚上的23点05分自动执行一次,主分支(main分支)有 push 操作也会自动执行一次。
建议每个人都修改下每日执行时间!不要使用默认时间!最好也不要设定在整点,错开峰值,避免 G 站的同一个IP在相同时间去请求B站接口,导致 IP 被禁,任务执行失败! 想要修改策略,请详见下面3.常见问题中的Actions 如何修改定时任务的执行时间?
如果配置了 Server 酱微信推送,执行成功后微信会收到推送消息:
可以>>点击配置详细信息 查看如何配置微信推送。
如果执行出现异常,会收到了 GitHub Action 的错误邮件通知,请检查 Cookies 是不是失效了或者是否有 bug。
如果是 Cookies 失效了,请从浏览器重新获取并更新到 Secrets 中。用户主动清除浏览器缓存,会导致BILI_JCT
和DEDEUSERID
失效。
如果是发现 bug,可以提交 issue,我会尽快确认并解决。(如何正确的提交issue,请详见>>常见问题)
如果是 DotNet 开发者,直接 clone 源码然后 vs 打开解决方案,配置 Cookie 后直接运行调试即可。
对于不是开发者的朋友,可以通过下载 Release 包在本地运行,步骤如下。
Ⅰ. 下载应用文件
点击 BiliBiliTool/release,下载已发布的最新版本。
- 如果本地已安装
.NET 5.0
环境:
请下载 net-dependent.zip
文件,本文件依赖本地运行库(runtime-dependent),所以文件包很小。
P.S.这里的运行环境指的是 ASP.NET Core Runtime 5.0.0
与.NET Runtime 5.0.0
,安装方法可详见 常见问题 中的 本地或服务器如何安装.net环境
- 如果不希望安装或不知如何安装运行环境:
请根据操作系统下载对应的 zip 文件,此文件已自包含(self-contained)运行环境,但相较不包含运行时的文件略大(Github 服务器在国外,下载可能比较慢)。
如,Windows系统请下载 win-x86-x64.zip
,其他以此类推。
Ⅱ. 解压并填写配置
下载并解压后,找到 appsettings.json 文件,使用记事本编辑,填入之前获取到的 Cookie 信息,保存后关闭:
Ⅲ. 运行
对于选择已自包含运行环境版本的 Windows 用户,双击运行名称为 Ray.BiliBiliTool.Console.exe 的可执行文件;
对于选择依赖本地运行库版本的 Windows 用户,双击运行名称为 start.bat 的批处理文件,或运行命令:dotnet Ray.BiliBiliTool.Console.dll
;
对于选择已自包含运行环境版本的 Linux 用户,在终端中执行:Ray.BiliBiliTool.Console
;
对于选择从源码运行,并已安装相应版本 .NET SDK 的开发者,运行命令dotnet run -p ./src/Ray.BiliBiliTool.Console
。
运行结果图示如下:
P.S.如果自己有服务器,也可以将程序发布到自己的服务器,利用自己的任务系统实现每天自动运行。(有服务器的大佬应该就不需要我多 BB 了)
各配置的简略介绍可直接在 appsettings.json 文件中查看相关注释信息。
如还需了解配置项的详细信息,可点击 >>配置详细信息 查看每个配置的详细介绍。
目前支持的配置源有 3 种:appsettings.json
配置文件、环境变量、命令行参数,外加一种专用于 Actions 模式使用的 GitHub Secrets 配置源。
直接修改文件后保存即可,如章节 1.2.2 中所演示。
为了传递 GitHub Secrets 而加的配置源,一般不需要管它,感兴趣的可以查看源码和 workflows 中的 yml 文件,这里就不多讲了。
命令行参数与配置键的映射关系可以查看 Constants.cs 中的 CommandLineMapper,程序会将命令行参数映射为对应的配置键后注册到系统。仅以自包含运行环境的 Windows 版本为例(其他版本同理,参见上述章节 1.2.2),运行命令:
Ray.BiliBiliTool.Console.exe -userId=123 -sessData=456 -biliJct=789 -numberOfCoins=5
如上 1.2.1 中所演示,在 Github Secrets 中添加即可。
这些 Secrets 会通过 yml 脚本在运行时添加到系统的环境变量中,从而注册到应用程序的配置当中。
如下图所示:
以上 3 种配置源,其优先级由低到高依次是:文件 < 环境变量 < 命令行,其中 GitHub Secrets 本质是通过环境变量实现的。
即,如果既在配置文件中写入了配置值,又在命令行启动时使用命令行参数指定了配置值,则最后会使用命令行的。
对于使用 Github Action 线上运行的朋友,建议只使用 Secrets 进行配置。因为 Fork 项目后,不会拷贝源仓库中的 Secrets,可自由的在自己的仓库中进行私人配置。当有版本重大更新而需要将源仓库同步 PR 到自己 Fork 的仓库时,PR 操作会很顺滑,不会影响到已配置的值。
当然, Fork 之后自己改了 appsettings.json 文件再提交,也是可以实现配置的。但是一则你的配置值将被暴露出来(别人可通过访问你的仓库里的配置查看到值),二是以后如果需要 PR 源仓库的更新到自己仓库,则要注意保留自己的修改不要被 PR 覆盖。
当前正处于稳定的迭代开发中,正常情况下每周会发布一个小版本,详细待更新内容可参见源码中的 todo 任务列表。
关于版本发布更新后,如何同步最新的内容到自己 Fork 的仓库,可查看>>常见问题文档 中的 我 Fork 之后怎么同步原作者的更新内容?。
如果你有好的想法,欢迎向仓库贡献你的代码,贡献步骤:
Ⅰ. 搜索查看 issue,确定是否已有人提过同类问题
Ⅱ. 确认没有同类 issue 后,自己可新建 issue,描述问题或建议
Ⅲ. 如果想自己解决,请 fork 仓库后,在devlop 分支进行编码开发,完成后提交 pr 到 devlop 分支,并标注解决的 issue 编号
我会尽快进行代码审核,提前感谢你的贡献。
个人维护开源不易
如果觉得我写的程序对你小有帮助
或者,就是单纯的想集资给我买瓶霸王增发液
那么下面的赞赏码可以扫一扫啦
(赞赏时记得留下【昵称】和【留言】~)
微信扫码自动赞赏 1 元:
支付宝扫码自动赞赏 1 元: