| 日期 | Bing 🔍 | Unsplash 📷 |
|---|
| 2026-07-31 |
基拉韦厄火山的威力 |
Hezar Masjed Mountains |
| 2026-07-30 |
穿越时光的足迹 |
Mother Nature |
| 2026-07-29 |
旷野无声，活态传承之境 |
a field of yellow flowers |
| 2026-07-28 |
虎啸归来，锐爪重临 |
FOLLOW ME: https://www.instagram.com/dark_indigox/
DONATE: paypal.me/darkindigo |
| 2026-07-27 |
生机律动，恒久之衡 |
a black and white photo of trees and mountains |
| 2026-07-26 |
仰望芝城，流光溢彩 |
brown field under blue sky during daytime |
| 2026-07-25 |
海陆际会，生机肇始 |
Nature art |
| 2026-07-24 |
加境幽廊 |
green trees on green grass field during daytime |
| 2026-07-23 |
缤纷多彩的一家人 |
Kalikuning Bridge, Sleman, Yogyakarta |
| 2026-07-22 |
瓣叠交响 |
a castle in the middle of a mountain surrounded by clouds |
---
## 🚀 快速开始
### 本地开发
```bash
# 1. 克隆仓库
git clone https://github.com/Hana19951208/DailyWallpaperHub.git
cd DailyWallpaperHub
# 2. 安装依赖（使用 conda 环境）
conda activate base
pip install -r requirements.txt
# 3. 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入以下配置：
# WEWORK_WEBHOOK=your_webhook_url
# LLM_API_KEY=your_api_key
# LLM_BASE_URL=https://api.openai.com/v1
# LLM_MODEL_NAME=gpt-4o
# UNSPLASH_ACCESS_KEY=your_unsplash_key
# 4. 快速抓取壁纸（跳过故事生成）
python fetch_bing_wallpaper.py --skip-story
python fetch_unsplash_wallpaper.py --skip-story
# 5. 异步生成故事（后台运行）
python scripts/generate_missing_stories.py
# 6. 批量抓取历史壁纸
python batch_fetch.py bing 2025-12 # 抓取 Bing 整月
python batch_fetch.py unsplash 2025-12-10 # 抓取 Unsplash 指定日期
```
### GitHub Actions 部署
1. **Fork 本仓库**
2. **配置 GitHub Secrets**（Settings → Secrets and variables → Actions）:
- `WEWORK_WEBHOOK`: 企业微信群机器人 Webhook URL
- `LLM_API_KEY`: LLM API 密钥
- `LLM_BASE_URL`: LLM API 基础 URL
- `LLM_MODEL_NAME`: LLM 模型名称
- `UNSPLASH_ACCESS_KEY`: Unsplash API 访问密钥
- `IMAGE_REPO`: 镜像图床仓库路径（如 `Hana19951208/blog-images`）
- `GITHUB_TOKEN`: GitHub Token (默认已提供，无需手动设置)
3. **启用 GitHub Pages**:
- Settings → Pages
- Source: Deploy from a branch
- Branch: `main` / `docs`
4. **手动触发或等待定时任务**:
- Actions → Daily Wallpaper Fetch → Run workflow
---
## 📁 项目结构
```
DailyWallpaperHub/
├── config/
│ └── sources.yaml # 数据源配置
├── prompts/
│ └── story_prompt.txt # AI 提示词模板
├── scripts/
│ ├── fill_unsplash_dec.py # Unsplash 数据补充脚本
│ └── generate_missing_stories.py # 异步故事生成脚本
├── src/
│ ├── config_loader.py # 配置加载器
│ ├── utils.py # 企业微信推送工具
│ ├── update_readme.py # README 更新器
│ └── update_gallery.py # Gallery 更新器
├── docs/
│ ├── index.html # GitHub Pages 画廊
│ └── wallpapers/ # 404 修复：由于部署源在 docs/，壁纸必须放在此目录下
│ ├── bing/
│ │ └── YYYY-MM-DD/
│ │ ├── image.jpg
│ │ ├── thumb.jpg
│ │ ├── meta.json
│ │ └── story.md
│ └── unsplash/
│ └── YYYY-MM-DD/
│ ├── image.jpg
│ ├── thumb.jpg
│ ├── meta.json
│ └── story.md
├── .github/workflows/
│ └── daily.yml # 自动化工作流
├── fetch_bing_wallpaper.py # Bing 抓取器
├── fetch_unsplash_wallpaper.py # Unsplash 抓取器
├── batch_fetch.py # 批量抓取工具
├── requirements.txt # Python 依赖
└── README.md # 项目文档
```
---
## 🎯 使用说明
### 异步故事生成
为了提升用户体验，本项目采用异步架构：
1. **快速模式**（默认推荐）:
```bash
python fetch_bing_wallpaper.py --skip-story
```
- 只下载图片和元数据
- 立即更新 README 和 Gallery
- 图片可立即查看
2. **后台生成故事**:
```bash
python scripts/generate_missing_stories.py
```
- 扫描所有缺失故事的壁纸
- 批量调用 LLM 生成故事
- 自动更新元数据和页面
### 批量抓取
```bash
# 抓取 Bing 壁纸
python batch_fetch.py bing 2025-12 # 整月
python batch_fetch.py bing 2025-12-10 # 指定日期
# 抓取 Unsplash 壁纸
python batch_fetch.py unsplash 2025-12 # 整月（多张当前精选）
python batch_fetch.py unsplash 2025-12-10 # 指定日期
# 源参数忽略大小写
python batch_fetch.py BING 2025-12
python batch_fetch.py Unsplash 2025-12-10
```
### 添加新数据源
1. 编辑 `config/sources.yaml`:
```yaml
sources:
- name: new_source
display_name: "新数据源 🎨"
enabled: true
api_key_env: "NEW_SOURCE_API_KEY"
fetcher_script: "fetch_new_source.py"
```
2. 创建 `fetch_new_source.py` 抓取脚本
3. 运行测试并提交
---
## 🤝 关注我
> 扫码关注「把知识变成系统」
## ⚖️ 开源协议
本项目基于 MIT 协议开源。仅供学习交流，壁纸版权归微软必应和 Unsplash 所有。