arxiv-paper-tracker
這是一個專為 Agent 設計的可設定 arXiv 論文追蹤技能。當此倉庫被克隆到支援 SKILL.md 的 Agent 系統後，只要使用者想要根據自訂條件搜尋、追蹤、去重、摘要或定期監控 arXiv 論文，Agent 就應使用此技能。
適用情境包括：
- 使用 Agent 產生的臨時設定進行一次性 arXiv 搜尋。
- 使用持久化的已見狀態檔案進行定期論文追蹤。
- 監控任意可設定的查詢條件組合，包括作者、機構、關鍵字、arXiv 分類、日期範圍與結果數量限制。
- 產生 Markdown 摘要，可透過外部通知系統、電子郵件管道、排程器或聊天機器人發送。
此檔案中的範例僅供參考。主題、作者、機構、分類、時間範圍與結果數量限制皆可在 config.yaml 中設定。
此技能的功能
此技能可以：
- 查詢 arXiv。
- 依作者、機構、關鍵字與分類篩選論文。
- 透過 arXiv ID 對論文進行去重。
- 維護本地已見狀態檔案，避免重複通知。
- 產生 Markdown 摘要。
- 在本地設定檔中啟用時，可選地傳送電子郵件通知。
此技能無法：
- 自動翻譯整篇論文。
- 下載並深入閱讀 PDF。
- 取代使用者對論文品質或相關性的判斷。
- 儲存或管理使用者的電子郵件密碼、應用程式密碼、API 金鑰或其他機密資訊。
安裝方式
如果套件尚未安裝於目前的 Agent 執行環境中，請在倉庫根目錄執行：
python -m pip install -e .
這將會安裝下列控制台指令：
arxiv-paper-tracker
若控制台指令無法使用，等效的模組進入點為：
python -m arxiv_paper_tracker.cli
建議使用方式
建立本地設定檔：
arxiv-paper-tracker init-config config.yaml
等效指令：
python -m arxiv_paper_tracker.cli init-config config.yaml
編輯 config.yaml 後，執行掃描：
arxiv-paper-tracker scan \
--config config.yaml \
--state outputs/arxiv_tracker/state.json \
--output outputs/arxiv_tracker/latest.md
等效指令：
python -m arxiv_paper_tracker.cli scan \
--config config.yaml \
--state outputs/arxiv_tracker/state.json \
--output outputs/arxiv_tracker/latest.md
Agent 使用指引
如果使用者尚未提供完整的設定檔，Agent 可以根據使用者請求建立臨時的本地設定檔。下列欄位僅為範例，應根據要求的主題、作者、機構、分類、時間範圍與結果數量限制進行調整：
queries:
authors: []
categories: []
keywords: []
institutions: []
limits:
max_results_per_query: 20
days_back: 7
state:
path: outputs/arxiv_tracker/state.json
email:
enabled: false
接著執行：
arxiv-paper-tracker scan \
--config config.yaml \
--state outputs/arxiv_tracker/state.json \
--output outputs/arxiv_tracker/latest.md
如果使用者只需要一次性搜尋而非長期追蹤，Agent 可以使用臨時路徑：
arxiv-paper-tracker scan \
--config /tmp/arxiv_tracker_config.yaml \
--state /tmp/arxiv_tracker_state.json \
--output /tmp/arxiv_tracker_digest.md
輸出處理
掃描指令會：
- 將摘要輸出至標準輸出（stdout）。
- 當提供
--output參數時，將摘要寫入 Markdown 檔案。
Agent 應讀取 stdout 或 --output 檔案，然後將 Markdown 轉換為適合目標介面的格式，例如終端機、網頁 UI、電子郵件、飛書、釘釘、Slack、Discord 或其他聊天介面。
排程
此倉庫不依賴特定 Agent 框架。若要定期執行，可從任何排程器或自動化執行環境觸發 scan 指令，例如：
- OpenClaw 或其他支援技能的 Agent 執行環境。
- Claude Code 或其他本地程式碼 Agent。
- 其他 Agent 排程器。
- cron。
- GitHub Actions。
- 自訂排程器。
排程器只需要執行 scan 指令，並透過其自身的通知管道傳送產生的 Markdown 摘要。
安全規則
- 公開倉庫僅提供
config.example.yaml。 - 請勿提交個人的
config.yaml檔案。 - 電子郵件通知預設為停用。
- 若啟用電子郵件，SMTP 使用者名稱與應用程式密碼必須僅儲存在本地設定檔中。
- 本地設定檔應被 git 忽略。
- 請勿在提示、日誌、GitHub 議題或公開輸出中暴露電子郵件應用程式密碼、API 金鑰、Cookie 或令牌。