每日文献雷达技能
每日文献雷达是一项Codex技能,用于追踪目标期刊、工作论文来源、RSS订阅源和关注作者的经济学论文。它抓取开放的元数据,根据用户定义的研究概况对论文进行排名,并生成每日摘要。
基础版本生成Markdown格式。高级版本按每日计划运行,并以格式化的HTML邮件发送摘要,同时附带Markdown备选。
当前来源库包括用于目标期刊的Crossref、官方NBER工作论文元数据,以及通用RSS/Atom订阅源(如CEPR、RePEc/NEP、美联储的订阅源和期刊提醒)。其他工作论文库可作为RSS订阅源或来源适配器加入。
推荐:配合Codex配置
本技能设计为在Codex或Claude Code的帮助下进行配置。编码代理可以帮助您将研究兴趣转化为可用的 daily-econ-literature-radar.config.json,具体包括:
- 将您的研究主题转化为
fields、keywords、jel_codes、methods和geographies - 在您的研究概况确定后推荐领域顶级期刊,然后仅添加您选择的期刊
- 查找并验证期刊ISSN,然后再将其添加到
target_journals - 添加目标作者和姓名别名
- 添加RSS订阅源或NBER项目/工作组过滤器
- 为高级版本的固定时间每日邮件配置Gmail SMTP和调度器
基础设置仅需Markdown输出。高级设置在配置Gmail SMTP和调度器后,能每日自动发送HTML邮件摘要。
它的作用
- 通过Crossref ISSN查询监控目标期刊。
- 通过官方NBER元数据TSV文件监控NBER工作论文。
- 监控RSS/Atom订阅源,如CEPR、RePEc/NEP、美联储订阅源或期刊提醒。
- 在所有抓取的元数据中追踪目标作者。
- 根据来源、目标期刊状态、目标作者匹配、主题匹配、JEL/方法/地理匹配以及摘要/标题关键词匹配对候选论文进行排名。
- 通过DOI或标题/作者备选对论文进行去重。
- 每次运行最多输出
max_papers篇论文,默认为10。 - 生成Markdown格式摘要。
- 可选地通过Gmail SMTP或其他SMTP提供商在每日固定时间发送HTML邮件摘要。
- 不下载付费墙后的PDF或受限全文。
项目结构
daily-econ-literature-radar/
├── README.md
├── config.example.json
├── example-output/
│ ├── sample-digest.md
│ ├── sample-email.html
│ └── sample-email-preview.png
├── .gitignore
└── daily-econ-literature-radar/
├── SKILL.md
├── agents/openai.yaml
├── references/
│ ├── default-config.md
│ ├── journal-watchlist.md
│ └── source-notes.md
└── scripts/
├── economics_literature_radar.py
├── render_digest.py
├── send_digest.py
└── run_daily_radar.py
输入
在 daily-econ-literature-radar.config.json 中配置输入。
研究概况
用于相关性排名:
fields: 广泛的研究领域jel_codes: JEL代码或部分JEL分类keywords: 主题关键词methods: 方法或实证设计geographies: 国家、地区、数据集或设定
目标期刊
通过Crossref进行精确的期刊监控。经济学Top 5期刊默认启用。在研究概况设定后,技能可以推荐领域顶级期刊;用户应选择要添加的推荐项。每本期刊应包括:
nametierfieldissn
示例:
{
"name": "期刊名称",
"tier": "领域顶级",
"field": "劳动经济学",
"issn": ["0000-0000"]
}
添加前请验证ISSN。
目标作者
要优先关注的作者姓名和别名:
{
"name": "作者姓名",
"aliases": ["A. 姓名", "作者 M. 姓名"],
"notes": "可选备注"
}
来源
nber: 官方NBER元数据适配器rss_feeds: CEPR、RePEc/NEP、Fed、期刊提醒或其他RSS/Atom订阅源target_journals: Crossref ISSN查询
限制
max_papers: 最终摘要的大小per_source_rows: 每个来源查询请求的行数source_caps: 软限制,防止某类来源挤占摘要
邮件
邮件为可选。仅在配置SMTP凭据后将 email.enabled 设置为 true。
输出
示例输出包含在 example-output/sample-digest.md、example-output/sample-email.html 和 example-output/sample-email-preview.png 中。它们使用合成的论文元数据,同时保留了与实际运行相同的结构和邮件样式。

Fetch JSON
由 fetch 生成:
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
每条论文记录可包含:
titleauthorssourcesource_kinddatedate_typedoiurlabstractkeywordsmatched_termspriorityscorenotes
Markdown摘要
由 render_digest.py 生成:
daily-econ-literature-radar-output/YYYY-MM-DD.md
每篇论文包含标题、作者、来源、出版/更新日期、DOI/URL、匹配词、优先级、摘要和备注。
邮件摘要
由 send_digest.py 或 run_daily_radar.py 在启用邮件时生成。邮件包括:
- 适合Gmail/Outlook显示的HTML正文
- 纯文本Markdown备选
使用方法
提示:请Codex或Claude Code帮助配置研究概况、领域顶级期刊选择、目标作者以及定时邮件发送。Gmail SMTP配合Google应用密码已经过测试并成功运行。
基础版本:仅Markdown
从项目根目录执行:
cp config.example.json daily-econ-literature-radar.config.json
编辑 daily-econ-literature-radar.config.json,填写您的研究概况、作者和来源。如果需要,保留默认的Top 5期刊,然后在从推荐中选择后添加领域顶级期刊。
抓取论文:
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py fetch --config daily-econ-literature-radar.config.json
渲染Markdown:
python3 daily-econ-literature-radar/scripts/render_digest.py \
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json \
--output daily-econ-literature-radar-output/YYYY-MM-DD.md
审阅摘要后,标记处理成功:
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py mark-success \
--config daily-econ-literature-radar.config.json \
--data daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
mark-success 会更新 state.json,使未来的运行不会重复相同的论文。
高级版本:固定时间每日邮件
高级版本是一个按计划运行的工作流。脚本本身不会作为后台守护进程运行;应使用调度器(如Codex自动化、cron、macOS LaunchAgent或Windows任务计划程序)在每天所需时间调用 run_daily_radar.py。
在调度器中配置期望的投递时间。您也可以将其记录在配置中:
"push_time": "09:00",
"timezone": "America/Toronto"
Gmail SMTP
当前实现已通过Gmail SMTP和Google应用密码测试。
在 daily-econ-literature-radar.config.json 中设置:
"email": {
"enabled": true,
"provider": "gmail_smtp",
"from": "每日文献雷达 <[email protected]>",
"to": "[email protected]",
"smtp_host": "smtp.gmail.com",
"smtp_port": 587,
"smtp_username": "[email protected]",
"smtp_password_env": "DAILY_RADAR_GMAIL_APP_PASSWORD",
"smtp_password_file": ".secrets/gmail_app_password",
"use_starttls": true
}
Gmail通常要求使用Google应用密码,而不是您的普通Google密码。从您的Google账户安全设置创建一个应用密码,然后通过以下方式之一存储。
环境变量:
export DAILY_RADAR_GMAIL_APP_PASSWORD="您的应用密码"
忽略的本地文件:
mkdir -p .secrets
printf '%s' '您的应用密码' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password
.gitignore 文件会排除 .secrets/、.env、本地配置和输出。
发送一份摘要
python3 daily-econ-literature-radar/scripts/send_digest.py \
daily-econ-literature-radar-output/YYYY-MM-DD.md \
--config daily-econ-literature-radar.config.json
运行完整邮件管道
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
这会运行:
抓取 -> 渲染Markdown -> 发送HTML邮件 -> 标记成功
它仅在邮件发送成功后才标记成功。
安排每日投递
将以下命令安排在每天所选时间运行一次:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
该命令执行完整的每日邮件工作流:
抓取 -> 渲染Markdown -> 发送HTML邮件 -> 标记成功
调度选项
Codex自动化
创建一个每日cron自动化,从该项目目录运行:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
使用用户偏好的本地时区和时间,例如每天09:00。
macOS Cron或LaunchAgent
该项目在MacBook/macOS环境下使用Python 3开发和测试。最简单的macOS调度选项包括:
- Codex自动化
cronlaunchd/ LaunchAgent
对于 cron,确保作业从项目目录启动,并使用测试中有效的同一Python可执行文件。
Windows兼容性
当前版本在MacBook/macOS上测试。Python脚本仅使用标准库,应可移植,但Windows用户应注意调整:
- 使用
python或py -3代替python3。 - 使用PowerShell路径语法,并对包含空格的路径加引号。
- 使用Windows任务计划程序代替cron/launchd。
- 将
chmod 600替换为Windows文件权限,或通过环境变量存储应用密码。 - 如果使用文件密钥,在Windows路径中使用
.secrets\gmail_app_password。 - 确认本地防火墙或防病毒软件允许TLS SMTP连接。
示例PowerShell命令:
cd "C:\path\to\daily-econ-literature-radar"
py -3 daily-econ-literature-radar\scripts\run_daily_radar.py --config daily-econ-literature-radar.config.json
隐私与安全
不要提交:
daily-econ-literature-radar.config.json.secrets/.envdaily-econ-literature-radar-output/
该技能仅使用来源提供的元数据和摘要。它不会下载付费墙后的PDF或受限全文。如果来源没有摘要,摘要会将论文标记为无摘要/仅标题,而不是推断其发现。
自定义注意事项
- 保持
max_papers足够小,以便摘要保持可读性。 - Top 5期刊默认启用;在从推荐中选择后,通过验证的ISSN添加领域顶级期刊。
- 添加目标作者及其别名,以处理姓名缩写或变体。
- 逐步添加RSS订阅源,并在安排每日投递前评估质量。
- 使用来源软限制防止单一来源主导摘要。
