HuggingFace Papers Skill#

获取 HuggingFace Papers ( https://huggingface.co/papers) 热门 AI 论文并生成分析报告。

使用场景#

当用户询问以下问题时，使用本 skill：

1. "最近有什么热门论文？"
2. "有什么 AI 论文推荐？"
3. "帮我看看 HuggingFace 上的热门论文"
4. "本周/本月有什么新论文？"
5. "介绍一下最近的 AI 研究趋势"

依赖#

• Python 3.8+
• python-dotenv — 加载 .env 文件

bash

pip3 install python-dotenv

使用方法#

前置条件：配置翻译后端#

脚本支持 DeepLX 和 OpenAI 兼容 API 两种翻译后端，通过 .env 文件配置：

bash

cp .env.example .env
# 然后编辑 .env

方式一：DeepLX（默认）

env

TRANSLATE_BACKEND="deeplx"
DEEPLX_URL="https://api.deeplx.org/你的token/translate"

方式二：OpenAI 兼容 LLM

兼容任何 OpenAI 格式的 API（OpenAI、Azure、硅基流动、DeepSeek 等）：

env

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。

常用命令#

bash

# 获取论文列表（默认今日热门）
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/monthlyweekly--limit论文数量10--output输出文件路径stdout--no-translate不翻译为中文，输出英文原文false

get_papers.py#

参数说明默认值--period时间范围: daily/weekly/monthlydaily--limit返回论文数量10--format输出格式: md/jsonmd--output输出文件路径stdout

输出语言#

• 默认中文：脚本通过 DeepLX API 自动将论文摘要翻译为中文，中文摘要与英文原文同时显示
• 论文标题：保留英文原文
• 保留原始数据：upvotes 数值和论文链接保持原样
• 英文模式：使用 --no-translate 参数跳过翻译，输出纯英文原文

DeepLX 翻译#

报告使用 DeepLX API 将摘要自动翻译为中文：

• 批量翻译，逐条显示进度
• 单条翻译失败时自动降级，保留英文原文
• 无需手动翻译，开箱即用

网络问题处理#

如果获取失败：

1. 检查网络连接
2. 稍后重试