配置说明

[目录]

• 1. 配置方式
  • 1.1. 方式一：修改配置文件
  • 1.2. 方式二：命令启动时通过命令行参数配置
  • 1.3. 方式三：添加环境变量（推荐）
  • 1.4. 方式四：托管在青龙面板上，使用面板的环境变量页或配置文件页进行配置
• 2. 优先级
• 3. 详细配置说明
  • 3.1. Cookie字符串
  • 3.2. 安全相关的配置
    • 3.2.1. 是否跳过执行任务
    • 3.2.2. 随机睡眠的最大时长
    • 3.2.3. 两次调用B站Api之间的间隔秒数
    • 3.2.4. 间隔秒数所针对的HttpMethod
    • 3.2.5. 请求B站接口时头部传递的User-Agent
    • 3.2.6. App请求B站接口时头部传递的User-Agent
    • 3.2.7. WebProxy（代理）
  • 3.3. 每日任务相关
    • 3.3.1. 是否开启观看视频任务
    • 3.3.2. 是否开启分享视频任务
    • 3.3.3. 每日投币数量
    • 3.3.4. 投币时是否同时点赞
    • 3.3.5. 优先选择支持的up主Id集合
    • 3.3.6. 每月几号自动领取会员权益
    • 3.3.7. 每月几号进行直播中心银瓜子兑换硬币
    • 3.3.8. Lv6后开启硬币白嫖模式
    • 3.3.9. 是否开启专栏投币
  • 3.4. 天选时刻抽奖相关
    • 3.4.1. 根据关键字排除奖品
    • 3.4.2. 根据关键字指定奖品
    • 3.4.3. 天选抽奖后是否自动分组关注的主播
    • 3.4.4. 天选筹抽奖主播Uid黑名单
  • 3.5. 批量取关相关
    • 3.5.1. 想要批量取关的分组名称
    • 3.5.2. 批量取关的人数
    • 3.5.3. 取关白名单
  • 3.6. 大积分相关
    • 3.6.1. 自定义观看番剧
  • 3.7. 免费B币券充电
    • 3.7.1. 充电对象
  • 3.8. 推送相关
    • 3.8.1. 是否开启每个账号单独推送消息
    • 3.8.2. Telegram机器人
      • 3.8.2.1. botToken
      • 3.8.2.2. chatId
      • 3.8.2.3. proxy
    • 3.8.3. 企业微信机器人
      • 3.8.3.1. webHookUrl
    • 3.8.4. 钉钉机器人
      • 3.8.4.1. webHookUrl
    • 3.8.5. Server酱
      • 3.8.5.1. TurboScKey（Server酱SCKEY）
    • 3.8.6. 酷推
      • 3.8.6.1. sKey
    • 3.8.7. 推送到自定义Api
      • 3.8.7.1. api
      • 3.8.7.2. placeholder
      • 3.8.7.3. bodyJsonTemplate
    • 3.8.8. PushPlus[推荐]
      • 3.8.8.1. PushPlus的Token
      • 3.8.8.2. PushPlus的Topic
      • 3.8.8.3. PushPlus的Channel
      • 3.8.8.4. PushPlus的Webhook
    • 3.8.9. Microsoft Teams
      • 3.8.9.1. Microsoft Teams的Webhook
    • 3.8.10. 企业微信应用推送
      • 3.8.10.1. 企业微信应用推送的corpId
      • 3.8.10.2. 企业微信应用推送的agentId
      • 3.8.10.3. 企业微信应用推送的secret
  • 3.9. 日志相关
    • 3.9.1. 日志输出等级
    • 3.9.2. 日志输出样式
    • 3.9.3. 定时任务相关
    • 3.9.4. 定时任务

<a id="markdown-1-配置方式" name="1-配置方式"></a>

1. 配置方式

<a id="markdown-11-方式一修改配置文件" name="11-方式一修改配置文件"></a>

1.1. 方式一：修改配置文件

推荐使用Release包在本地运行的朋友使用，直接打开文件，将对应的配置值填入，保存即可生效。

默认有3个配置文件：appsettings.json、appsettings.Development.json、appsettings.Production.json，分别对应默认、开发与生产环境。

对于不是开发人员的大部分人来说，只需要关注appsettings.Production.json即可。

<a id="markdown-12-方式二命令启动时通过命令行参数配置" name="12-方式二命令启动时通过命令行参数配置"></a>

1.2. 方式二：命令启动时通过命令行参数配置

在使用命令行启动时，可使用-key=value的形式附加配置，所有可用的命令行参数均在 命令行参数映射表 中。

• 使用跨平台的依赖包

各个系统只要安装了net5环境，均可使用dotnet命令启动，命令样例：

dotnet Ray.BiliBiliTool.Console.dll -cookieStr=abc -numberOfCoins=5

• Windows系统

使用自包含包（win-x86-x64.zip），命令样例：

Ray.BiliBiliTool.Console.exe -cookieStr=abc -numberOfCoins=5

• Linux系统

使用自包含包（linux.zip），命令样例：

Ray.BiliBiliTool.Console -cookieStr=abc -numberOfCoins=5

如映射文件所展示，支持使用命令行配置的配置项并不多，也不建议大量地使用该种方式进行配置。使用包运行的朋友，除了改配置文件和命令行参数配置外，还可以使用环境变量进行配置，这也是推荐的做法，如下。

<a id="markdown-13-方式三添加环境变量推荐" name="13-方式三添加环境变量推荐"></a>

1.3. 方式三：添加环境变量（推荐）

所有的配置项均可以通过添加环境变量来进行配置。如：

Linux下运行Web：

# 添加环境变量作为配置：
export RunTasks="Daily"
export BiliBiliCookies__1="abc"
export BiliBiliCookies__2="efg"
export DailyTaskConfig__NumberOfCoins="3"

# 开始运行程序：
dotnet BiliBiliTool.Web.dll

Linux下运行Console：

# 添加环境变量作为配置：
export Ray_RunTasks="Daily"
export Ray_BiliBiliCookies__1="abc"
export Ray_BiliBiliCookies__2="efg"
export Ray_DailyTaskConfig__NumberOfCoins="3"

# 开始运行程序：
dotnet Ray.BiliBiliTool.Console.dll

注意Console需要添加Ray_前缀，win系统使用set关键字代替export。

<a id="markdown-14-方式四托管在青龙面板上使用面板的环境变量页或配置文件页进行配置" name="14-方式四托管在青龙面板上使用面板的环境变量页或配置文件页进行配置"></a>

1.4. 方式四：托管在青龙面板上，使用面板的环境变量页或配置文件页进行配置

青龙面板配置，其本质还是通过环境变量进行配置，有如下两种方式。

• 环境变量页[推荐]

例如：

名称：Ray_BiliBiliCookies__1

值：abcde

• 配置文件页

例如，配置Cookie和推送：

export Ray_BiliBiliCookies__1="_uuid=abc..."
export Ray_Serilog__WriteTo__9__Args__token="abcde"

配置文件页添加、修改配置，需要重启青龙容器使之生效，环境变量页则可以立即生效，所以推荐使用环境变量页配置。

<a id="markdown-2-优先级" name="2-优先级"></a>

2. 优先级

以上 4 种配置源，其优先级由低到高依次是：json文件 < 环境变量 < 命令行。

高优先级的配置会覆盖低优先级的配置。

<a id="markdown-3-详细配置说明" name="3-详细配置说明"></a>

3. 详细配置说明

Console项目（青龙）的环境变量需要添加Ray_前缀，其他不用。 比如，原始配置Key为BiliBiliCookies__1，Console则为Ray_BiliBiliCookies__1。

<a id="markdown-31-cookie字符串" name="31-cookie字符串"></a>

3.1. Cookie字符串

必填，数组，可以多个。

<a id="markdown-32-安全相关的配置" name="32-安全相关的配置"></a>

3.2. 安全相关的配置

<a id="markdown-321-是否跳过执行任务" name="321-是否跳过执行任务"></a>

3.2.1. 是否跳过执行任务

用于特殊情况下，通过配置灵活的开启和关闭整个应用。

配置为关闭后，程序会跳过所有任务，不会调用B站任何接口。

<a id="markdown-322-随机睡眠的最大时长" name="322-随机睡眠的最大时长"></a>

3.2.2. 随机睡眠的最大时长

用于设置程序启动后，随机睡眠时间的最大上限值，单位为分钟。

这样可以避免程序每天准点地在同一时间运行太像机器。

配置为0则不进行睡眠。

<a id="markdown-323-两次调用b站api之间的间隔秒数" name="323-两次调用b站api之间的间隔秒数"></a>

3.2.3. 两次调用B站Api之间的间隔秒数

用于设置两次Api请求之间的最短时间间隔，避免程序在1到2秒内连续调用B站的Api过快。

<a id="markdown-324-间隔秒数所针对的httpmethod" name="324-间隔秒数所针对的httpmethod"></a>

3.2.4. 间隔秒数所针对的HttpMethod

间隔秒数所针对的HttpMethod类型，服务于上一个配置。服务器一般对GET请求不是很敏感，建议只针对POST请求做间隔就可以了。

<a id="markdown-325-请求b站接口时头部传递的user-agent" name="325-请求b站接口时头部传递的user-agent"></a>

3.2.5. 请求B站接口时头部传递的User-Agent

获取浏览器中自己的UA的方法见下图：

<a id="markdown-326-app请求b站接口时头部传递的user-agent" name="326-app请求b站接口时头部传递的user-agent"></a>

3.2.6. App请求B站接口时头部传递的User-Agent

获取浏览器中自己的UA的方法见下图：

<a id="markdown-327-webproxy代理" name="327-webproxy代理"></a>

3.2.7. WebProxy（代理）

支持需要账户密码的代理。

<a id="markdown-33-每日任务相关" name="33-每日任务相关"></a>

3.3. 每日任务相关

<a id="markdown-331-是否开启观看视频任务" name="331-是否开启观看视频任务"></a>

3.3.1. 是否开启观看视频任务

当该配置被设置为false时会导致大积分任务中的签到领额外10点经验的任务不能自动完成。

<a id="markdown-332-是否开启分享视频任务" name="332-是否开启分享视频任务"></a>

3.3.2. 是否开启分享视频任务

<a id="markdown-333-每日投币数量" name="333-每日投币数量"></a>

3.3.3. 每日投币数量

每天投币的总目标数量，因为投币获取经验只与次数有关，所以程序每次投币只会投1个，也就是说该配置也表示每日投币次数。

<a id="markdown-334-投币时是否同时点赞" name="334-投币时是否同时点赞"></a>

3.3.4. 投币时是否同时点赞

<a id="markdown-335-优先选择支持的up主id集合" name="335-优先选择支持的up主id集合"></a>

3.3.5. 优先选择支持的up主Id集合

通过填入自己选择的up主ID，以后观看、分享和投币，都会优先从配置的up主下面挑选视频，如果没有找到,则会去你的特别关注列表中随机再获取，再然后会去普通关注列表中随机获取，最后会去排行榜中随机获取。

注意：该配置的默认值是作者的upId，如需换掉的话，直接更改即可。

获取UP主的Id方法：打开bilibili，进入欲要选择的UP主主页，在url中和简介中，都可获得该UP主的Id，如下图所示：

<a id="markdown-336-每月几号自动领取会员权益" name="336-每月几号自动领取会员权益"></a>

3.3.6. 每月几号自动领取会员权益

<a id="markdown-337-每月几号进行直播中心银瓜子兑换硬币" name="337-每月几号进行直播中心银瓜子兑换硬币"></a>

3.3.7. 每月几号进行直播中心银瓜子兑换硬币

<a id="markdown-338-lv6后开启硬币白嫖模式" name="338-lv6后开启硬币白嫖模式"></a>

3.3.8. Lv6后开启硬币白嫖模式

<a id="markdown-339-是否开启专栏投币" name="339-是否开启专栏投币"></a>

3.3.9. 是否开启专栏投币

<a id="markdown-34-天选时刻抽奖相关" name="34-天选时刻抽奖相关"></a>

3.4. 天选时刻抽奖相关

<a id="markdown-341-根据关键字排除奖品" name="341-根据关键字排除奖品"></a>

3.4.1. 根据关键字排除奖品

<a id="markdown-342-根据关键字指定奖品" name="342-根据关键字指定奖品"></a>

3.4.2. 根据关键字指定奖品

<a id="markdown-343-天选抽奖后是否自动分组关注的主播" name="343-天选抽奖后是否自动分组关注的主播"></a>

3.4.3. 天选抽奖后是否自动分组关注的主播

<a id="markdown-344-天选筹抽奖主播uid黑名单" name="344-天选筹抽奖主播uid黑名单"></a>

3.4.4. 天选筹抽奖主播Uid黑名单

不想参与抽奖的主播Upid集合，多个用英文逗号分隔，配置后不会参加黑名单中的主播的抽奖活动。默认值是目前已知的中奖后拒绝发奖的Up，后期还会继续补充，也反映反馈。

<a id="markdown-35-批量取关相关" name="35-批量取关相关"></a>

3.5. 批量取关相关

<a id="markdown-351-想要批量取关的分组名称" name="351-想要批量取关的分组名称"></a>

3.5.1. 想要批量取关的分组名称

<a id="markdown-352-批量取关的人数" name="352-批量取关的人数"></a>

3.5.2. 批量取关的人数

<a id="markdown-353-取关白名单" name="353-取关白名单"></a>

3.5.3. 取关白名单

<a id="markdown-36-大积分相关" name="36-大积分相关"></a>

3.6. 大积分相关

<a id="markdown-361-自定义观看番剧" name="361-自定义观看番剧"></a>

3.6.1. 自定义观看番剧

<a id="markdown-37-免费b币券充电" name="37-免费b币券充电"></a>

3.7. 免费B币券充电

<a id="markdown-371-充电对象" name="371-充电对象"></a>

3.7.1. 充电对象

充电对象的upId，-1表示不指定，默认为自己充电；其他Id则会尝试为配置的UpId充电。

注意：之前可以不配置，默认为自己充电，但后来阿B改了规则，不再允许自己冲自己。。。

建议配置为自己小号（小号需要认证为作者并开启充电），或者也可以配置为 -1，以支持作者~

<a id="markdown-38-推送相关" name="38-推送相关"></a>

3.8. 推送相关

v1.0.x仅支持推送到Server酱，v1.1.x之后重新定义了推送地概念，将推送仅看作不同地日志输出端，与Console、File没有本质区别。

配置多个，多个端均会收到日志消息。推荐Telegram、企业微信、Server酱。

<a id="markdown-381-是否开启每个账号单独推送消息" name="381-是否开启每个账号单独推送消息"></a>

3.8.1. 是否开启每个账号单独推送消息

<a id="markdown-382-telegram机器人" name="382-telegram机器人"></a>

3.8.2. Telegram机器人

<a id="markdown-3821-bottoken" name="3821-bottoken"></a>

3.8.2.1. botToken

点击 https://core.telegram.org/api#bot-api 查看如何创建机器人并获取到机器人的botToken。

<a id="markdown-3822-chatid" name="3822-chatid"></a>

3.8.2.2. chatId

点击 https://api.telegram.org/bot{TOKEN}/getUpdates 获取到与机器人的chatId（需要用上面获取到的Token替换进链接里的{TOKEN}后访问）

P.S.访问链接需要能访问"外网"，有vpn的挂vpn。

<a id="markdown-3823-proxy" name="3823-proxy"></a>

3.8.2.3. proxy

使用代理

<a id="markdown-383-企业微信机器人" name="383-企业微信机器人"></a>

3.8.3. 企业微信机器人

在群内添加机器人，获取到机器人的WebHook地址，添加到配置中。

<a id="markdown-3831-webhookurl" name="3831-webhookurl"></a>

3.8.3.1. webHookUrl

<a id="markdown-384-钉钉机器人" name="384-钉钉机器人"></a>

3.8.4. 钉钉机器人

在群内添加机器人，获取到机器人的WebHook地址，添加到配置中。

机器人的安全策略，当前不支持加签，请使用关键字策略，推荐关键字：Ray 或 BiliBili

<a id="markdown-3841-webhookurl" name="3841-webhookurl"></a>

3.8.4.1. webHookUrl

<a id="markdown-385-server酱" name="385-server酱"></a>

3.8.5. Server酱

官网： http://sc.ftqq.com/9.version

<a id="markdown-3851-turbosckeyserver酱sckey" name="3851-turbosckeyserver酱sckey"></a>

3.8.5.1. TurboScKey（Server酱SCKEY）

获取方式请参考官网。

<a id="markdown-386-酷推" name="386-酷推"></a>

3.8.6. 酷推

https://cp.xuthus.cc/ <a id="markdown-3861-skey" name="3861-skey"></a>

3.8.6.1. sKey

该平台可能还在完善当中，对接时我发现其接口定义不规范，且机器人容易被封，所以不推荐使用，且不接受提酷推推送相关bug。

<a id="markdown-387-推送到自定义api" name="387-推送到自定义api"></a>

3.8.7. 推送到自定义Api

这是我简单封装了一个通用的推送接口，可以推送到任意的api地址，如果有自己的机器人或自己的用于接受日志的api，可以根据需要自定义配置。 <a id="markdown-3871-api" name="3871-api"></a>

3.8.7.1. api

<a id="markdown-3872-placeholder" name="3872-placeholder"></a>

3.8.7.2. placeholder

<a id="markdown-3873-bodyjsontemplate" name="3873-bodyjsontemplate"></a>

3.8.7.3. bodyJsonTemplate

<a id="markdown-388-pushplus推荐" name="388-pushplus推荐"></a>

3.8.8. PushPlus[推荐]

官网： http://www.pushplus.plus/doc/

<a id="markdown-3881-pushplus的token" name="3881-pushplus的token"></a>

3.8.8.1. PushPlus的Token

获取方式请参考官网。

<a id="markdown-3882-pushplus的topic" name="3882-pushplus的topic"></a>

3.8.8.2. PushPlus的Topic

获取方式请参考官网。

<a id="markdown-3883-pushplus的channel" name="3883-pushplus的channel"></a>

3.8.8.3. PushPlus的Channel

获取方式请参考官网。

<a id="markdown-3884-pushplus的webhook" name="3884-pushplus的webhook"></a>

3.8.8.4. PushPlus的Webhook

获取方式请参考官网。

webhook编码(不是地址)，在官网平台设定，仅在channel使用webhook渠道和CP渠道时需要填写

<a id="markdown-389-microsoft-teams" name="389-microsoft-teams"></a>

3.8.9. Microsoft Teams

官网： https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook

<a id="markdown-3891-microsoft-teams的webhook" name="3891-microsoft-teams的webhook"></a>

3.8.9.1. Microsoft Teams的Webhook

webhook的完整地址，在Teams的Channel中获取，详细获取方式请参考官网。

<a id="markdown-3810-企业微信应用推送" name="3810-企业微信应用推送"></a>

3.8.10. 企业微信应用推送

官网： https://developer.work.weixin.qq.com/tutorial/application-message

当corpId、agentId、secret均不为空时，自动开启推送，否则关闭。

toUser、toParty、toTag3个配置非必填，但不可同时为空，默认toUser为@all，向所有用户推送。

<a id="markdown-38101-企业微信应用推送的corpid" name="38101-企业微信应用推送的corpid"></a>

3.8.10.1. 企业微信应用推送的corpId

<a id="markdown-38102-企业微信应用推送的agentid" name="38102-企业微信应用推送的agentid"></a>

3.8.10.2. 企业微信应用推送的agentId

<a id="markdown-38103-企业微信应用推送的secret" name="38103-企业微信应用推送的secret"></a>

3.8.10.3. 企业微信应用推送的secret

<a id="markdown-39-日志相关" name="39-日志相关"></a>

3.9. 日志相关

<a id="markdown-391-日志输出等级" name="391-日志输出等级"></a>

3.9.1. 日志输出等级

为了美观， BiliBiliTool 默认只输出最低等级为 Information 的日志，保证只展示最精简的信息。

通过更改等级，可以指定日志输出的详细程度。

BiliBiliTool 使用 Serilog 作为日志组件，所以其值域与 Serilog 的日志等级选项相同，这里只建议在需要调试时改为Debug，应用会输出详细的调试日志信息，包括每次调用B站Api的请求参数与返回数据。

<a id="markdown-392-日志输出样式" name="392-日志输出样式"></a>

3.9.2. 日志输出样式

这里的日志样式指的是 Console 的等级，即 GitHub Actions 里和微信推送里看到的日志。

通过更改模板样式，可以指定日志输出的样式，比如不输出时间和等级，做到最精简的样式。

BiliBiliTool 使用 Serilog 作为日志组件，所以可以参考 Serilog 的日志样式模板。

<a id="markdown-393-定时任务相关" name="393-定时任务相关"></a>

3.9.3. 定时任务相关

适用于 方式四：docker容器化运行（推荐），用于配置定时任务。

<a id="markdown-394-定时任务" name="394-定时任务"></a>

3.9.4. 定时任务

以下环境变量的值应为有效的 cron 表达式。

当被设置时，对应定时任务将开启。