🖼️ bili_app_splash - B站壁纸与开屏图自动同步

这是一个由 darkd-idk fork 的镜像项目，原始项目由 zjkwdy 创建

本项目通过 GitHub Actions 自动同步 B站壁纸娘的美图合集和 B站应用的开屏图（启动图），所有图片将保存在仓库中方便下载使用。每日自动更新，无需手动操作。

📦 项目目录结构

bili_app_splash/
├── bizhiniang/          # 壁纸娘壁纸（按时间分类的相册）
│   └── YYYYMMDDHHMMSS/  # 相册文件夹（格式：年月日时分秒）
│       ├── image1.jpg
│       └── image2.jpg
├── splash/              # B站开屏图片
│   └── splash_YYYYMMDD.jpg
├── .github/             # GitHub Actions 工作流配置
│   └── workflows/
│       ├── BIZHINIANG.yml               # 壁纸娘同步任务
│       └── bilibili_splash_download.yml # 开屏图下载任务
├── getwallpaper.py      # 壁纸同步脚本
├── splash_downloader.py # 开屏图下载脚本
├── urls.txt             # 所有壁纸的原始 URL 记录
├── requirements.txt     # Python 依赖项
└── README.md            # 项目说明文档

⚡ 主要功能

• 每日壁纸同步：每天自动下载 B站壁纸娘的最新相册
• 开屏图定时更新：每小时检查并下载最新的 B站开屏图
• 智能分类整理：壁纸按相册上传时间分类存放
• 完整 URL 记录：保存所有图片的原始 B站链接
• 自动化工作流：GitHub Actions 全自动处理下载和提交
• 代理支持：内置代理机制确保网络连接可靠性
• 详细日志：生成完整的下载过程日志

🚀 快速开始

GitHub Actions 自动使用（无需配置）

项目配置了全自动任务：

1. 壁纸娘同步：每天北京时间 09:10 运行
2. 开屏图下载：每小时运行一次

自动更新后的图片可在以下目录查看：

• 壁纸：bizhiniang/
• 开屏图：splash/

本地运行指南

1. 克隆仓库到本地：

   git clone https://github.com/darkd-idk/bili_app_splash.git
   cd bili_app_splash

2. 安装 Python 依赖：

   pip install -r requirements.txt

3. 同步壁纸（需要 B站 SESSDATA）：

   python getwallpaper.py --sessdata YOUR_SESSDATA

   如何获取 SESSDATA：

   1. 登录 B站网页版
   2. 打开开发者工具（F12）
   3. 进入 Application > Cookies
   4. 复制 SESSDATA 的值

4. 下载开屏图：

   python splash_downloader.py

🔍 图片查找方法

1. 最新壁纸：

   • 查看 bizhiniang/ 目录中按时间排序的最新文件夹

2. 特定日期壁纸：

   • 使用文件名格式：YYYYMMDDHHMMSS（年月日时分秒）
   • 例如：bizhiniang/20230615120000/

3. 开屏图片：

   • 在 splash/ 目录查找以日期命名的文件
   • 格式：splash_YYYYMMDD.jpg

4. 原始链接查询：

   • 打开 urls.txt 文件
   • 按相册名或图片名搜索对应 URL

⚠️ 注意事项

网络连接机制

1. 脚本包含智能代理系统，自动绕过网络限制
2. 内置 7 次重试机制应对连接失败
3. 随机延迟设计避免请求频率过高被封禁

错误排查

1. 同步失败处理：

   • 检查 GitHub Actions 的作业日志
   • 查看 Artifacts 中的 wallpapers.log 文件
   • 更新可能过期的 SESSDATA（有效期为 1-3 个月）

2. 常见问题：

   Q: 为什么有时看不到最新图片？
   A: 同步任务北京时间 09:10 运行，新建相册需要等待下次运行
   
   Q: 下载速度慢如何解决？
   A: GitHub Actions 服务器位置限制，可尝试本地运行获得更好速度

版权声明

1. 本项目仅用于学习和技术演示目的
2. 所有图片版权归属于 Bilibili 及原创作者
3. 禁止用于任何商业用途
4. 下载后 24 小时内请自觉删除

📊 最新统计（手动更新）

统计项	值
壁纸相册	查看数量
开屏图片	查看数量
最后同步	请查看最新提交时间

当前统计功能正在完善中，建议直接浏览相关目录获取最新图片

🤝 贡献指南

如何与上游同步

# 添加上游仓库
git remote add upstream https://github.com/zjkwdy/bili_app_splash.git

# 获取上游更新
git fetch upstream

# 合并到您的分支
git merge upstream/main

# 推送更新
git push origin main

贡献途径

1. 报告问题：

   • 网络连接问题
   • 脚本执行错误
   • API 接口变更

2. 功能建议：

   • 添加按主题分类功能
   • 优化下载算法
   • 改进用户界面

3. 代码改进：

   1. Fork 本仓库（您已完成此步骤）
   2. 创建特性分支 (`git checkout -b feature/your-feature`)
   3. 提交变更 (`git commit -am 'Add some feature'`)
   4. 推送到分支 (`git push origin feature/your-feature`)
   5. 创建 Pull Request

开发规范

1. 遵循 PEP8 Python 编码规范
2. 添加必要的代码注释
3. 保持代码清晰和模块化
4. 提交前测试所有变更

📜 开源协议

本项目采用 MIT License 发行，核心条款如下：

MIT License

Copyright (c) 2023-2025 darkd-idk (forked from zjkwdy)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

ℹ️ 项目维护

• 维护者: darkd-idk
• 原始作者: zjkwdy
• 项目链接: https://github.com/darkd-idk/bili_app_splash
• 上游仓库: https://github.com/zjkwdy/bili_app_splash

重要提示：此项目是原始仓库的 fork，您可以通过定期运行 git fetch upstream 和 git merge upstream/main 来同步上游更新。