BiliBiliTool是一个B站自动执行任务的工具，通过它可以实现B站帐号的每日自动观看、分享、投币视频，获取经验，每月自动领取会员权益、自动为自己充电等功能，帮助我们轻松升级会员到Lv6并赚取电池。

通过结合GitHub Actions，可以实现每天线上自动运行，一劳永逸。

详细功能目录如下:

• 每天自动登录，获取经验
• 每天自动观看、分享、投币视频 （支持指定想要支持的up主，优先选择配置的up主的视频，不配置则随机选取视频）
• 每天漫画自动签到
• 每天自动直播签到，领取奖励 （直播可以不看，但是奖励不领白不领~）
• 每天自动使用直播中心银瓜子兑换B币，避免浪费
• 每月自动使用快过期的B币券为自己充电 （你懂的~）
• 每个月自动领取5张B币券和大会员权益 （既然买了会员就要领取该有的奖励啊~）

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）。

有了它，我们就可以实现每天线上自动运行我们的应用程序。

a. 首先fork本项目到自己的仓库

b. 进入自己fork的仓库，点击 Settings-> Secrets-> New Secrets 添加以下3个Secrets。它们将作为应用启动时的命令行参数被传入程序。

要新增的 Secret Name 与之前的 Cookie Name 的对应关系如下：

c. 开启Actions并触发每日自动执行

Github Actions默认处于关闭状态，前面都配置好后，请手动开启Actions，执行一次工作流，验证是否可以正常工作，操作步骤如下图所示：

运行结束后，可查看运行日志：

workflow 的执行策略默认是每天中午14点10分自动执行一次，主分支（main分支）有 push 操作也会自动执行一次。想要修改策略详见下面3.常见问题中的Actions 如何修改定时任务的执行时间？

如果配置了 Server 酱微信推送，执行成功后微信会收到推送消息：

可以>>点击配置详细信息 查看如何配置微信推送。

如果执行出现异常，会收到了GitHub Action的错误邮件通知，请检查Cookies是不是失效了或者是否有bug。

如果是 Cookies 失效了，请从浏览器重新获取并更新到 Secrets 中。用户主动清除浏览器缓存，会导致BILI_JCT和DEDEUSERID失效。

如果是发现 bug，可以提交 issue，我会尽快确认并解决

如果是 DotNet 开发者，直接 clone 源码然后 vs 打开解决方案，配置 Cookie 后直接运行调试即可。

对于不是开发者的朋友，可以通过下载 Release 包在本地运行，步骤如下。

a. 下载应用文件

点击 BiliBiliTool/release，下载已发布的最新版本

本地如果已经安装了 DotNet 5 的环境，推荐下载net-dependent.zip文件，因为依赖了本地库（runtime-dependent），所以文件包很小；

没有环境或不确定有没有的，可以根据操作系统下载对应的zip文件（window是win-x86-x64.zip），因为是自包含的（self-contained），文件会大些（Github服务器在国外，下载可能比较慢），但是好处是不需要额外安装NetCore的运行时或SDK。

b. 解压并填写配置

下载并解压后，找到appsettings.json文件，使用记事本编辑，填入之前获取到的Cookie信息，保存后关闭：

c. 运行

找到名称为 Ray.BiliBiliTool.Console 的可执行文件（Win 环境下是 Ray.BiliBiliTool.Console.exe），双击运行（Linux 使用命令行运行），结果如下：

P.S.如果自己有服务器，也可以将程序发布到自己的服务器，利用自己的任务系统实现每天自动运行。（有服务器的大佬应该就不需要我多BB了）

各配置的简略介绍可直接在 appsettings.json 文件中查看相关注释信息。

如还需了解配置项的详细信息，可点击 >>配置详细信息 查看每个配置的详细介绍。

目前支持的配置源有3种：appsettings.json配置文件、环境变量、命令行参数，外加一种专用于Actions模式使用的 GitHub Secrets 配置源。

直接修改文件后保存即可，如上1.2.2中所演示。

为了传递 GitHub Secrets 而加的配置源，一般不需要管它，感兴趣的可以查看源码和 workflows 中的 yml 文件，这里就不多讲了。

命令行参数与配置键的映射关系可以查看 Constants.cs 中的CommandLineMapper，程序会将命令行参数映射为对应的配置键后注册到系统。

dotnet run -p ./src/Ray.BiliBiliTool.Console -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 的仓库，可查看上面的3.常见问题列表。

如果你有好的想法，欢迎向仓库贡献你的代码，贡献步骤：

a. 搜索查看issue，确定是否已有人提过同类问题

b. 确认没有同类issue后，自己可新建issue，描述问题或建议

c. 如果想自己解决，请fork仓库后，在devlop分支进行编码开发，完成后提交pr到devlop分支，并标注解决的issue编号

我会尽快进行代码审核，提前感谢你的贡献。

>>点击查看已捐赠列表和留言

个人维护开源不易

如果觉得我写的程序对你小有帮助

或者，就是单纯的想集资给我买瓶霸王增发液

那么下面的赞赏码可以扫一扫啦

（赞赏时记得留下【昵称】和【留言】~）

微信扫码自动赞赏1元：

支付宝扫码自动赞赏1元：

JunzhouLiu/BILIBILI-HELPER

happy888888/BiliExp