docs: 重写 README,完整描述新增功能

- 新增 AI 早安邮件三段式文案结构说明
- 新增附言功能介绍(AI 生成的"舔狗"风格小故事)
- 新增数据源说明(wttr.in、百度热搜、BBC/Sky News/NHK RSS)
- 更新文件结构,说明状态文件用途
- 新增 TARGET_IPS、WEATHER_LOCATION、NEWS_PROXY_URL 配置说明
- 新增 DEEPSEEK_API_URL、DEEPSEEK_MODEL、YOUR_NAME 配置项

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-11 23:46:54 +08:00
co-authored by Claude Opus 4.6
parent 685231fb56
commit 37ad6116b2
+51 -13
View File
@@ -1,19 +1,34 @@
# 太阳公公监控 # 太阳公公监控
监控局域网设备上线,配合 AI 生成个性化早安邮件。 监控局域网设备上线,配合 AI 生成个性化早安邮件。每天清晨,有人替你把天气、热点和一点碎碎念收进一封信里,轻轻铺开。
## 功能 ## 功能
### 设备监控
- **Ping 监控**:监控指定局域网 IP 是否在线 - **Ping 监控**:监控指定局域网 IP 是否在线
- **首次上线通知**:目标设备首次上线时,发送"太阳公公出来了"邮件,包含具体上线时间 - **首次上线通知**:目标设备首次上线时,发送"太阳公公出来了"邮件,包含具体上线时间
- **未到提醒**:每天 8:15 前目标仍未上线,发送"太阳公公还在睡觉"邮件 - **未到提醒**:每天 8:15 前目标仍未上线,发送"太阳公公还在睡觉"邮件
- **AI 早安文案**:三段式早安邮件
- 第一段:太阳公公状态(AI 单独生成)
- 第二段:今日天气(AI 生成,自然衔接)
- 第三段:今日热搜(AI 找关联,像说相声一样串联成自然段落)
- **每日重置**:状态文件每日自动重置,避免重复发送 - **每日重置**:状态文件每日自动重置,避免重复发送
## 运行时间 ### AI 早安邮件
三段式早安文案,全部由 DeepSeek AI 生成的个性化内容:
- **第一段**:太阳公公状态,AI 根据实际上线/未上线情况单独生成
- **第二段**:今日天气,AI 自然衔接第一段,温暖过渡
- **第三段**:今日热搜,AI 筛选国内外热点,像朋友聊天一样串联成段
### 附言
邮件末尾附带一段 AI 原创的"过来人"小故事,主题围绕单方面喜欢、错位理解,带一点自嘲和电影感。最后一句往往突然变得很舔、很心酸。
### 数据源
- **天气**wttr.in(免费无需 API Key
- **国内热点**:百度实时热搜
- **国际热点**BBC World、Sky News、NHK 国际(RSS 订阅)
### 运行时间
每天凌晨 2:00 至晚上 22:00 自动监控 每天凌晨 2:00 至晚上 22:00 自动监控
@@ -25,9 +40,9 @@ TaiYangGongGong/
├── test_ping.py # 测试脚本(单次测试) ├── test_ping.py # 测试脚本(单次测试)
├── config.py # 敏感配置(API密钥、邮件账号等)- 不上传 ├── config.py # 敏感配置(API密钥、邮件账号等)- 不上传
└── .ping_state/ # 状态文件目录 - 不上传 └── .ping_state/ # 状态文件目录 - 不上传
├── state.json ├── monitor_state.json # 监控状态
├── weather_cache.json ├── weather_cache.json # 天气缓存
└── news_cache.json └── news_cache.json # 新闻缓存
``` ```
## 首次使用 ## 首次使用
@@ -44,6 +59,8 @@ cp config.py config.py.bak
```python ```python
# DeepSeek API # DeepSeek API
DEEPSEEK_API_KEY = "your_api_key" DEEPSEEK_API_KEY = "your_api_key"
DEEPSEEK_API_URL = "https://api.deepseek.com/v1"
DEEPSEEK_MODEL = "deepseek-chat"
# 邮件配置 # 邮件配置
SMTP_SERVER = "smtp.qq.com" SMTP_SERVER = "smtp.qq.com"
@@ -52,21 +69,42 @@ SMTP_USER = "your_email@qq.com"
SMTP_PASSWORD = "your授权码" SMTP_PASSWORD = "your授权码"
FROM_NAME = "月亮姐姐" FROM_NAME = "月亮姐姐"
TO_EMAILS = ["target_email@example.com"] TO_EMAILS = ["target_email@example.com"]
YOUR_NAME = "收件人名字"
``` ```
3. 设置系统时区(邮件时间戳用系统时间): 3. 配置监控目标(`ping_monitor.py` 中的 `TARGET_IPS`):
```python
TARGET_IPS = [
"192.168.2.60",
]
```
4. 配置天气位置(默认成都):
```python
WEATHER_LOCATION = "成都"
```
5. 如需获取国际新闻,配置代理(可选):
```bash
export NEWS_PROXY_URL="http://127.0.0.1:7890"
```
6. 设置系统时区(邮件时间戳用系统时间):
```bash ```bash
sudo timedatectl set-timezone Asia/Shanghai sudo timedatectl set-timezone Asia/Shanghai
sudo ntpdate ntp.aliyun.com # 同步网络时间 sudo ntpdate ntp.aliyun.com # 同步网络时间
``` ```
4. 安装依赖并运行: 7. 安装依赖并运行:
```bash ```bash
pip install requests pip install requests
python test_ping.py # 测试 python test_ping.py # 测试(单次运行)
python ping_monitor.py # 正式运行 python ping_monitor.py # 正式运行(常驻)
``` ```
## 部署 ## 部署