HuggingFace Papers Skill
获取 HuggingFace Papers (https://huggingface.co/papers) 热门 AI 论文并生成分析报告。
使用场景
当用户询问以下问题时，使用本 skill：
- "最近有什么热门论文？"
- "有什么 AI 论文推荐？"
- "帮我看看 HuggingFace 上的热门论文"
- "本周/本月有什么新论文？"
- "介绍一下最近的 AI 研究趋势"
依赖
- Python 3.8+
python-dotenv— 加载.env文件
pip3 install python-dotenv
使用方法
前置条件：配置翻译后端
脚本支持 DeepLX 和 OpenAI 兼容 API 两种翻译后端，通过 .env 文件配置：
cp .env.example .env
# 然后编辑 .env
方式一：DeepLX（默认）
TRANSLATE_BACKEND="deeplx"
DEEPLX_URL="https://api.deeplx.org/你的token/translate"
方式二：OpenAI 兼容 LLM
兼容任何 OpenAI 格式的 API（OpenAI、Azure、硅基流动、DeepSeek 等）：
TRANSLATE_BACKEND="openai"
OPENAI_BASE_URL="https://api.openai.com/v1"
OPENAI_API_KEY="sk-your-key-here"
OPENAI_MODEL="gpt-4o-mini"
降级策略：主后端失败时自动降级到另一后端，都失败则保留英文原文。
.env 已加入 .gitignore，不会提交到 GitHub。
常用命令
# 获取论文列表（默认今日热门）
python3 scripts/get_papers.py
# 生成完整分析报告并保存到本地（推荐）
mkdir -p reports && python3 scripts/generate_report.py --period weekly --output reports/HuggingFace_本周热门论文_$(date +%Y-%m-%d).md
# 只查看不保存
python3 scripts/generate_report.py
# 指定时间范围和数量
python3 scripts/generate_report.py --period weekly --limit 10
# 输出纯英文报告（不翻译）
python3 scripts/generate_report.py --period weekly --no-translate
# 保存到文件
python3 scripts/generate_report.py --period weekly --output report.md
脚本在 skill 目录下的 scripts/ 文件夹中，所有命令均从 skill 根目录执行。
参数说明
generate_report.py
| 参数 | 说明 | 默认值 |
|---|---|---|
--period | 时间范围: daily/weekly/monthly | weekly |
--limit | 论文数量 | 10 |
--output | 输出文件路径 | stdout |
--no-translate | 不翻译为中文，输出英文原文 | false |
get_papers.py
| 参数 | 说明 | 默认值 |
|---|---|---|
--period | 时间范围: daily/weekly/monthly | daily |
--limit | 返回论文数量 | 10 |
--format | 输出格式: md/json | md |
--output | 输出文件路径 | stdout |
输出语言
- 默认中文：脚本通过 DeepLX API 自动将论文摘要翻译为中文，中文摘要与英文原文同时显示
- 论文标题：保留英文原文
- 保留原始数据：upvotes 数值和论文链接保持原样
- 英文模式：使用
--no-translate参数跳过翻译，输出纯英文原文
DeepLX 翻译
报告使用 DeepLX API 将摘要自动翻译为中文：
- 批量翻译，逐条显示进度
- 单条翻译失败时自动降级，保留英文原文
- 无需手动翻译，开箱即用
网络问题处理
如果获取失败：
- 检查网络连接
- 稍后重试