每日文獻雷達技能
每日文獻雷達 (Daily Literature Radar) 是一個 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 電子郵件摘要。
- 不會下載付費論文或受限的全文內容。
專案結構
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 精確監控期刊。預設啟用經濟學前五大期刊。設定研究設定檔後,該技能可以推薦領域頂級期刊;使用者應選擇要添加哪些推薦。每個期刊應包含:
nametierfieldissn
範例:
{
"name": "Journal Name",
"tier": "field_top",
"field": "labor",
"issn": ["0000-0000"]
}
在添加 ISSN 之前,請務必驗證其正確性。
關注作者
要優先關注的作者姓名及其別名:
{
"name": "Author Name",
"aliases": ["A. Name", "Author M. Name"],
"notes": "Optional note"
}
來源
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 中。它們使用合成的論文元數據,同時保留了與真實運行相同的結構和電子郵件樣式。

擷取的 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,填入您的研究設定檔、作者和來源。如果需要,保留預設的前五大期刊,然後在從推薦中選擇後,添加領域頂級期刊。
擷取論文:
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": "Daily Literature Radar <[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="your-app-password"
忽略的本地檔案:
mkdir -p .secrets
printf '%s' 'your-app-password' > .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/
此技能僅使用來源提供的元數據和摘要。它不會下載付費論文或受限的全文內容。如果來源沒有摘要,摘要會將論文標記為「無摘要/僅有標題」,而不會推測其發現。
自訂注意事項
- 保持
max_papers值夠小,使摘要易於閱讀。 - 預設啟用前五大期刊;在從推薦中選擇後,透過已驗證的 ISSN 添加領域頂級期刊。
- 添加帶有別名(用於姓名首字母或姓名變體)的關注作者。
- 逐步添加 RSS 訂閱源,並在排程每日傳送前,先評估其內容品質。
- 使用來源上限 (
source_caps) 防止單一來源壟斷摘要內容。
