[目录]
BiliBiliTool 是一个 B 站自动执行任务的工具，当我们忘记做 B 站的某项任务时，它会像一个小助手一样，按照我们预先吩咐她的命令，在指定时间、按照指定频率，帮助我们自动完成计划的任务。
比如，当我们忘记领取自己的大会员福利时，她会帮助我们在月初自动领取；当我们忘记完成每日任务时，她会辅助我们自动完成所有任务，获取每日的满额65点经验值，快速升级 Lv6 ；当然我们也可以用她来支持我们喜欢的up主，拒绝白嫖~
详细功能如下：
- 每日获取满额升级经验（登录、投币、点赞、分享视频）（支持指定支持up主）
- 每天漫画签到
- 每天直播签到
- 直播中心银瓜子兑换为硬币
- 每月领取大会员赠送的 5 张 B 币券和福利（忘记或者不领就浪费了哦）
- 每月领取大会员漫画福利
- 月底在 B 币券过期前进行充电（支持指定想要支持的up主，如果没有喜欢的up，也可以为自己充个电啊，做个用爱为自己发电的人~）
- 直播中心天选时刻自动参与抽奖
- 理论上支持所有远端的日志推送（默认支持推送到Telegram、企业微信、Server酱、钉钉、酷推，另外也支持自定义推送到任意api）
另外，通过结合 GitHub Actions，可以实现每天线上自动运行，只要部署一次，小助手就会在背后一直默默地帮我们完成我们预先布置的任务。
还有其他一些辅助小功能，大家可以自己去自由探索~
Github 仓库地址：RayWangQvQ/BiliBiliTool
注意：
- 本应用仅用于学习和测试，作者本人并不对其负责，请于运行测试完成后自行删除，请勿滥用！
- 所有代码都是开源且透明的，任何人均可查看，程序不会保存或滥用任何用户的个人信息
- 应用内几乎所有功能都开放为了配置（如任务开关、日期、upId等），请仔细阅读配置文档，自己对自己的配置负责
（如果图片挂了，是因为 GitHub 的服务器在国外，经常会刷不出，有梯子的可以架起梯子，没有的也可以先参考 我的博客，但博客内容不保证最新)
BiliBiliTool 实现自动完成任务的原理，是通过调用一系列 B 站开放的api实现的。
BiliBiliTool 就是收集了一系列api，通过每日自动运行程序，依次调用接口，来实现各任务的。
要使用 BiliBiliTool，我们只需要做两步：获取自己的 Cookie 作为配置，然后将其输入 BiliBiliTool 并运行即可。
- 浏览器打开并登录 bilibili 网站
- 登录成功后，访问
https://api.bilibili.com/x/web-interface/nav，按 F12 打开"开发者工具"，按 F5 刷新一下 - 在"开发者工具"面板中，点击 网络（Network），在左侧的请求列表中，找到名称为
nav的接口，点击它 - 依次查找 Headers ——> RequestHeader ——> cookie，可以看到很长一串以英文分号分隔的字符串，复制整个这个cookie字符串（不要使用右键复制，请使用 Ctrl+C 复制，右键会进行 UrlDecode ），保存它们到记事本，待会儿会用到。
运行 BiliBiliTool 主要有三种方式，一是通过 Github 的 Actions 实现线上的每天自动运行，二是通过下载Release包到本地或服务器运行，三是使用docker容器化运行。
对于熟悉 Github 的朋友，推荐使用方式一 Github Actions，可以实现线上的每天自动运行，不需自己动手，一劳永逸。
对于想先快速运行一下尝个鲜、或是要部署到自己服务器的朋友，可以跳转到方式二 Release 包运行，操作简单快速。
对于熟悉docker的朋友，可以跳转到方式三 docker容器化运行。
以下三种方式任选一种适合自己的即可。
Github Actions 是微软（巨硬）收购 G 站之后新增的内置 CI/CD 方案，其核心就是一个可以运行脚本的小型服务器。
有了它，我们就可以实现每天线上自动运行我们的应用程序，通过配置还可以实现版本的自动同步更新。
Ⅰ. 首先点击本页面右上角的 fork 按钮，复刻本项目到自己的仓库
Ⅱ. 进入自己 fork 的仓库，点击 Settings-> Secrets-> New Secrets， 添加 1 个 Secrets，其名称为COOKIESTR，值为刚才我们保存的 cookie 字符串。它们将作为配置项，在应用启动时传入程序。
Ⅲ. 开启 Actions 并触发每日自动执行
刚 Fork 完，所有 Actions 都是默认关闭的，都配置好后，需要手动点击 Enable 开启 Actions。开启后请手动执行一次工作流，验证是否可以正常工作，操作步骤如下图所示：
运行结束后，请查看运行日志：
Actions 的执行策略默认是每天 0 点整触发运行，如要设置为指定的运行时间，请详见下面常见问题章节中的《Actions 如何修改定时任务的执行时间？》
建议每个人都设置下每日执行时间！不要使用默认时间！最好也不要设定在整点，错开峰值，避免 G 站的同一个IP在相同时间去请求 B 站接口，导致 IP 被禁！
应用运行后，会进行0到30分钟的随机睡眠，是为了使每天定时运行时间在范围内波动。刚开始如果需要频繁调试，建议参考下面的个性化自定义配置章节，将其配置为1分钟，避免每次测试都需要等待半小时
如果配置了推送，执行成功后接收端会收到推送消息，如下所示为Server酱微信推送效果：
目前默认支持Telegram推送、企业微信推送、钉钉推送、PushPlus推送、Server酱推送和酷推QQ推送，如果需要推送到其他端，也可以配置为任意的可以接受消息的Api地址，关于如何配置推送请详见下面的个性化自定义配置章节。
如果是 DotNet 开发者，直接 clone 源码然后 vs 打开解决方案，配置 Cookie 后即可直接本地进行运行和调试。
对于不是开发者的朋友，可以通过下载 Release 包到本地或任意服务器运行，步骤如下。
Ⅰ. 下载应用文件
点击 BiliBiliTool/release，下载已发布的最新版本。
- 如果本地已安装
.NET 5.0环境：
请下载 net-dependent.zip 文件，本文件依赖本地运行库（runtime-dependent），所以文件包非常小（不到1M）。
P.S.这里的运行环境指的是 ASP.NET Core Runtime 5.0.0与.NET Runtime 5.0.0 ，安装方法可详见 常见问题 中的 本地或服务器如何安装.net环境
- 如果不希望安装或不知如何安装.net运行环境：
请根据操作系统下载对应的 zip 文件，此文件已自包含（self-contained）运行环境，但相较不包含运行时的文件略大（20M 左右，Github 服务器在国外，下载可能比较慢）。
如，Windows系统请下载 win-x86-x64.zip ，其他以此类推。
Ⅱ. 解压并填写配置
下载并解压后，找到 appsettings.json 文件，使用记事本编辑，填入之前获取到的 Cookie 字符串，保存后关闭：
Ⅲ. 运行
- Windows 系统
对于已安装.net环境，且使用的是依赖包，可在当前目录下执行命令：dotnet Ray.BiliBiliTool.Console.dll，或者直接双击运行名称为 start.bat 的批处理文件，均可运行。
对于使用自包含运行环境版本的，可直接双击运行名称为 Ray.BiliBiliTool.Console.exe 的可执行文件。
- Linux 系统
对于已安装.net环境，且使用的是依赖包，同上，可在终端中执行命令：dotnet Ray.BiliBiliTool.Console.dll
对于使用独立包的，可在终端中执行命令：Ray.BiliBiliTool.Console。
其他系统依此类推，运行结果图示如下：
除了修改配置文件，也可以通过添加环境变量或在启动命令后附加参数来实现配置，详细方法可参考下面的配置说明章节。
请确认已安装了docker所需环境（docker和docker-compose）。
Window系统推荐使用Docker Desktop，官方下载安装包，一路鼠标点下去就能装好，运行时也有可视化界面。
部分功能（比如拉取镜像）可能网速会非常慢，大家懂的，有梯子的可以架起梯子。
推荐使用 docker-compose 来运行镜像，步骤如下。
Ⅰ. 本地创建文件
在本地任意文件夹下，创建一个目录 bilibli_tool ,在其下新建docker-compose.yml文件和my_crontab文件，文件结构如下：
bilibli_tool
├── docker-compose.yml
└── my_crontab
Ⅱ. 编辑文件内容，填入相关配置
docker-compose.yml的文件内容请拷贝 默认docker-compose.yml 内容。其中 image（镜像名称）默认是我的，如果要使用自己创建的，请更换为自己创建的镜像名称。environment 下可以通过环境变量自由添加自定义配置，其中Cookie是必填的，所以请至少填入Cookie并保存。
my_crontab的文件内容请拷贝 默认my_crontab 内容。
Ⅲ. 启动并运行容器
在当前目录执行启动容器命令：docker-compose up -d
提示成功的话，即表示容器启动成功。
可以进入容器查看详细运行日志，当前目录也会生成日志文件。
每次容器启动会尝试运行一次，设定的cron之后也会定时自动触发，如需修改定时运行时间，请修改my_crontab，然后再次执行启动容器命令。
这里的任务是指一组功能的集合，是工具每次运行的最小单位。工具启动后会根据我们输入的任务编码，运行相应的任务，如：
dotnet Ray.BiliBiliTool.Console.dll -runTasks=Daily
程序启动后，会执行每日获取经验任务。
可以通过使用 & 符拼接多个任务，程序启动后会按顺序依次执行指定的任务集合，如
dotnet Ray.BiliBiliTool.Console.dll -runTasks=Daily&LiveLottery
会依次运行每日任务和天选抽奖任务。
一般来说，每个任务都有一个 GitHub Actions 的工作流脚本（workflow）对应，划分的依据主要是根据功能需求，其次是触发频率（比如，有些每天只需运行一次，有些需要允许多次）。列表如下：
| 任务名 | Code | 功能 | 默认WorkFlow文件 | GithHub Environments | 推荐运行频率 | 备注 |
|---|---|---|---|---|---|---|
| 每日任务 | Daily | 完成每日任务获取满额65点经验（登录、观看视频、分享视频、投币），以及签到、领福利和充电等附属功能 | bilibili-daily-task.yml | Production(用于Actions设置延时) | 每天一次 | |
| 天选时刻抽奖 | LiveLottery | 直播中心天选时刻抽奖 | live-lottery-task.yml | LiveLottery(用于Actions设置延时) | Docker或其他本地环境随意，Actions环境请保持每天运行0-4次内，避免被封 | 对应Actions工作流默认是关闭的，需要添加key为ISOPENLIVELOTTERYTASK、值为true的secret来手动开启；大部分抽奖都需要关注主播，介意的不要开启 |
如果有问题或是发现了 bug，请先确认是否可以通过升级到最新版本解决，然后搜索文档（特别是配置说明文档和常见问题文档）和issues，查看是否已有其他人遇到相同问题、是否已有解决方案，如果确认还未解决可以自己提交 issue，我会尽快确认并解决。（如何正确的提交issue，请详见下面常见问题文档）。
当前正处于稳定的迭代开发中，正常情况下每 2 周会发布一个小版本，详细待更新和计划内容可参见 projects 和 issues 。
关于新版本发布后，如何同步最新的内容到自己 Fork 的仓库，可参考常见问题文档中的 《我 Fork 之后如何同步原作者的更新内容？》章节，强烈建议每个人都开启自动同步更新，因为越新的版本功能越完善、对账号来说也越安全。
如果你有好的想法，欢迎向仓库贡献你的代码，贡献步骤：
-
搜索查看 issue，确定是否已有人提过同类问题
-
确认没有同类 issue 后，自己可新建 issue，描述问题或建议
-
如果想自己解决，请 fork 仓库后，在devlop 分支进行编码开发，完成后提交 pr 到 devlop 分支，并标注解决的 issue 编号
我会尽快进行代码审核，测试成功后会合并入 main 主分支，提前感谢您的贡献。
个人维护开源不易
如果觉得我写的程序对你小有帮助
或者，就是单纯的想集资给我买瓶霸王增发液
那么下面的赞赏码可以扫一扫啦
（赞赏时记得留下【昵称】和【留言】~ 另外我发现很多留言想要进群或者加好友的，一定一定要记得留下微信号哈，微信赞赏页面是看不到微信号的）
☟☟☟ 扫码自动赞赏 1 元：☟☟☟
另外，应用中的优先支持的UP主的配置项，默认是作者的 UpId （只是作为了 json 配置文件的默认值，代码是干净的），需要更改的话，直接修改相应配置即可（secrets或环境变量等各种方式都行）。
当然，不改的话，也算是另一种捐赠支持作者的方式啦。
感谢支持~