scheduled-task

参考 daily_stock_analysis 的「GitHub Actions 定时 + 邮件推送」模式，每天自动发送两封邮件：

1. GitHub 热榜：抓取 GitHub Trending 日榜 / 周榜 / 月榜，项目描述翻译为中文后推送
2. AI 前沿突破速览：从 arXiv 筛选世界模型 / Agent / AI 机器人 / 大模型 / 社会智能等前沿方向，按「突破性与实际效果」精排，并做效果向中文解读

• 主源：github.com/trending?since=daily|weekly|monthly
• 一封邮件包含三段：日榜、周榜、月榜
• 失败时回退：社区备份 JSON → GitHub Search API
• 描述默认译为简体中文（需配置 LLM；未配置则保留原文；跨榜去重翻译）

当前不按期刊引用 / Accepted 等同行评议信号筛选。流程是：

1. 拉取近期 AI 相关分类论文（cs.AI / cs.LG / cs.CL / cs.CV 等）
2. 主题粗筛：命中世界模型、Agent、AI 机器人/具身智能、大模型、社会智能、多模态等关键词（见 src/topics.py）
3. LLM 精排：按突破性与实际效果打分，弱化纯刷榜 / 小改方法类工作
4. 效果向解读：写清解决什么问题、带来什么新能力、对产品/产业意味着什么；不写技术细节

arXiv 以预印本为主，内容未经正式同行评议。本邮件用于发现前沿线索，不构成已验证结论。

将本仓库推送到 GitHub，在 Settings → Actions → General 中启用 Actions。

路径：Settings → Secrets and variables → Actions

原则：不必全配。 未设置的项使用程序默认值；发信至少要有邮箱相关配置，LLM 强烈建议配置。

发信需要

邮件可选（有默认）

发件显示名由程序按任务固定：热榜为「GitHub 热榜」，论文为「AI 前沿速览」。

LLM（要用翻译 / 精排 / 解读时必须全部指定，无默认值）

三项缺一则视为未启用 LLM：热榜描述保留原文；论文按主题词得分排序，解读退化为摘要截断。任务仍可运行并发信。

业务可选（均可不配，用默认）

打开 Actions，选择 GitHub Daily Trending 或 arXiv Daily Papers，点击 Run workflow。
成功后查收邮件；HTML 报告会作为 Artifact 上传。

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
# source .venv/bin/activate

pip install -r requirements.txt
copy .env.example .env   # 或 cp .env.example .env
# 按需填写即可：未写/留空的项自动用默认值（LLM 除外）
# 正式发信需邮箱；启用 LLM 需同时指定 OPENAI_API_KEY / OPENAI_BASE_URL / OPENAI_MODEL

# 只抓取生成 HTML，不发信
python -m src.main github --dry-run
python -m src.main arxiv --dry-run

# 实际发送
python -m src.main github
python -m src.main arxiv
python -m src.main all

预览文件：reports/github-trending.html、reports/arxiv-digest.html。

.
├── .github/workflows/
│   ├── daily-github-trending.yml   # 热榜定时任务
│   └── daily-arxiv.yml             # AI 前沿速览定时任务
├── src/
│   ├── main.py                     # CLI 入口
│   ├── github_trending.py          # 热榜抓取与描述翻译
│   ├── arxiv_papers.py             # 论文抓取、精排、效果解读
│   ├── topics.py                   # 前沿主题关键词
│   ├── email_sender.py             # SMTP 发送
│   ├── llm.py                      # OpenAI 兼容调用
│   ├── templates.py                # 邮件 HTML 模板
│   └── config.py
├── reports/                        # 本地 / CI 预览输出
├── requirements.txt
├── .env.example
└── README.md

未配置 SMTP_HOST / SMTP_PORT 时，按 EMAIL_SENDER 域名自动推断：

QQ / 163 使用邮箱授权码；Gmail 使用应用专用密码。需要时仍可手动覆盖 SMTP_HOST / SMTP_PORT。

说明：GitHub Actions 托管 Runner 多在海外， QQ、163邮箱 SMTP 可能被风控；若 Actions 发信失败，可改用 Gmail。

MIT