BiliBiliToolPro项目在青龙v2.18.0版本中的Cookie持久化问题解决方案

问题背景

BiliBiliToolPro是一个基于.NET开发的B站自动化工具，常被部署在青龙面板中运行。近期随着青龙面板升级到v2.18.0版本，用户反馈在扫码登录后无法持久化Cookie的问题，导致每次运行都需要重新登录。

问题根源分析

经过技术团队调查，发现问题的根本原因是青龙v2.18.0版本进行了重大架构调整，移除了原有的auth.json授权文件存储机制。而BiliBiliToolPro原先依赖这个文件路径来存储和读取用户Cookie信息。

临时解决方案

对于急需使用的用户，我们提供了以下临时解决方案：

1. 手动获取Cookie：

   • 在浏览器中访问B站并登录
   • 按F12打开开发者工具
   • 在Application或存储选项卡中找到Cookie信息
   • 复制SESSDATA、bili_jct等关键Cookie值

2. 手动添加环境变量：

   • 在青龙面板的环境变量管理页面
   • 添加名为"Ray_BiliBiliCookies__0"的变量
   • 将复制的完整Cookie字符串作为值填入
   • 对于多账号，可依次创建Ray_BiliBiliCookies__1、Ray_BiliBiliCookies__2等变量

技术实现调整

开发团队已经对BiliBiliToolPro进行了紧急更新，在新版本中：

1. 当检测到青龙v2.18.0及以上版本时
2. 工具会主动识别并提示auth.json文件不存在
3. 在控制台输出完整的Cookie信息
4. 提供清晰的环境变量添加指引
5. 指导用户如何为多账号配置变量

长期解决方案展望

技术团队正在调研青龙新版本的API鉴权机制，计划在未来版本中实现：

1. 完全兼容青龙新版本的环境变量管理API
2. 自动化的Cookie存储和更新机制
3. 更友好的多账号管理界面
4. 增强的错误提示和恢复机制

用户操作建议

对于不同情况的用户，我们建议：

1. 新用户：直接使用最新版BiliBiliToolPro，按照控制台指引手动配置环境变量
2. 升级用户：检查现有Cookie是否仍然有效，必要时重新获取
3. 多账号用户：确保为每个账号分配独立的环境变量键名
4. 开发者：关注项目更新，及时调整自己的集成方案

总结

这次问题反映了开源生态中依赖关系管理的重要性。BiliBiliToolPro团队将持续跟进青龙面板的更新，确保工具兼容性，同时也会优化自身的架构设计，减少对特定实现的依赖，提高系统的健壮性。