Skip to content
Back to search

hermes-arxiv-agent

一个基于 Hermes 的 agent skill:每天自动从 arXiv 抓取论文,用 AI 生成中文摘要和作者单位,推送到飞书,并提供本地静态阅读网站。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/genggng/hermes-arxiv-agent with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/genggng/hermes-arxiv-agent'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/genggng--hermes-arxiv-agent/badge.svg)](/listings/genggng--hermes-arxiv-agent)

HTML

<a href="/listings/genggng--hermes-arxiv-agent"><img src="/api/listings/genggng--hermes-arxiv-agent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 202 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # hermes-arxiv-agent
  2. 一个基于 Hermes 的 agent skill:每天自动检索 arXiv 论文、补全中文摘要和作者单位,并将结果推送到飞书,同时提供本地或 GitHub Pages 的网页阅读入口。项目支持两种模式:
  3. - 本地模式:默认模式。每天自动检索并处理论文,推送到你自己的飞书,并通过 `python3 viewer/run_viewer.py` 在本机启动网页阅读页
  4. - GitHub Pages 模式:增强模式,包含本地模式的全部功能,并额外把静态网站自动发布到你自己 fork 的 GitHub Pages
  5. ## 安装目录
  6. - [本地模式安装](#本地模式)
  7. - [GitHub-Pages-模式安装](#github-pages-模式)
  8. ## 效果展示
  9. ### 飞书推送
  10. ![Feishu Push](images/feishu.png)
  11. 每天自动推送论文日报,包含标题、作者、单位、PDF 链接和中文摘要。
  12. ### Web 阅读网站
  13. ![Web Viewer](images/web.png)
  14. 支持按日期筛选、关键词检索、查看中文总结与 Abstract,以及本地收藏。
  15. ## 功能
  16. - 每天按关键词监控 arXiv 新论文
  17. - 自动下载 PDF,维护本地 Excel 记录
  18. - 由 Hermes/LLM 补全作者单位和中文摘要
  19. - 自动推送飞书日报
  20. - 提供静态阅读网站,支持本地运行或 GitHub Pages 发布
  21. - 以 Hermes skill 的形式完成部署和日常运行
  22. ## 前提条件
  23. 使用本项目前,必须先安装 Hermes,并完成飞书配置。
  24. ### Hermes 安装
  25. ```bash
  26. curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 43 on GitHub
  27. source ~/.bashrc
  28. hermes
  29. ```
  30. ### 飞书配置
  31. ```bash
  32. hermes gateway setup
  33. ```
  34. ## 本地模式
  35. 这是默认模式,适合希望每天自动检索并处理论文、推送飞书日报,同时在本机浏览网页阅读页的人。
  36. 这个模式下:
  37. - 可以直接使用上游公开仓库
  38. - 不要求 fork
  39. - 不要求 GitHub 写权限
  40. - 定时任务不会执行 `bash scripts/publish_viewer.sh`
  41. - 网站依然可用,但通过本地 Python 脚本启动
  42. ### 安装方法
  43. 在 Hermes 对话中直接说这句固定安装话术:
  44. ```text
  45. 请从该地址 https://github.com/genggng/hermes-arxiv-agent/blob/main/AGENT_SKILL.md 安装 skill,并按本地模式部署。不要配置 GitHub Pages 发布。
  46. ```
  47. Hermes 会自动完成:
  48. - 克隆仓库
  49. - 安装依赖
  50. - 生成本地模式的 `cronjob_prompt.generated.txt`
  51. - 创建定时任务
  52. ### 本地网站
  53. 启动方式:
  54. ```bash
  55. cd viewer
  56. python3 run_viewer.py
  57. ```
  58. 浏览器访问:
  59. ```text
  60. http://localhost:8765
  61. ```
  62. 支持:
  63. - 日期筛选
  64. - 关键词全文检索
  65. - 收藏(浏览器本地保存)
  66. - Abstract 展开查看
  67. ### 更新定时任务
  68. 如果你已经有可用的本地仓库,只想刷新 cron prompt 和定时任务,不要删仓库重装。
  69. 可以在 Hermes 对话里直接说:
  70. ```text
  71. 请使用当前仓库里的 UPDATE_CRON_SKILL.md,只更新 hermes-arxiv-agent 的本地模式定时任务。不要重新克隆仓库,不要重装依赖。请基于当前本地仓库运行 prepare_deploy.sh,读取最新 cronjob_prompt.generated.txt,并将现有 cron 更新到最新版本;如果不能直接编辑,就删除旧任务后重建一个新的同名任务。
  72. ```
  73. ## GitHub Pages 模式
  74. 这是增强模式,包含本地模式的全部功能,并额外自动发布静态网站到你自己的 GitHub Pages。
  75. 这个模式下:
  76. - 必须先 fork 项目
  77. - `origin` 应该指向你自己的 fork,而不是上游仓库
  78. - 推荐 `origin` 使用 SSH
  79. - 定时任务会在补全完成后执行 `bash scripts/publish_viewer.sh`
  80. - push 到你自己的 fork 后会触发 GitHub Actions 更新 GitHub Pages
  81. ### 安装方法
  82. 先 fork 本项目到你自己的 GitHub 账号,然后把下面占位符替换成你自己的 fork 地址,在 Hermes 对话中直接说这句固定安装话术:
  83. ```text
  84. 请从该地址 https://github.com/<your-github-id>/hermes-arxiv-agent/blob/main/AGENT_SKILL.md 安装 skill,并按 GitHub Pages publishing 模式部署。请使用当前 fork 仓库作为发布仓库,不要使用上游仓库作为推送目标。
  85. ```
  86. Hermes 会自动完成:
  87. - 克隆你自己 fork 的仓库
  88. - 安装依赖
  89. - 生成 GitHub Pages 模式的 `cronjob_prompt.generated.txt`
  90. - 创建带发布步骤的定时任务
  91. ### GitHub 配置
  92. 建议让仓库 `origin` 使用 SSH:
  93. ```text
  94. git@github.com:<your-github-id>/hermes-arxiv-agent.git
  95. ```
  96. 如果当前仓库 remote 还是 HTTPS,可以切换为:
  97. ```bash
  98. git remote set-url origin git@github.com:<your-github-id>/hermes-arxiv-agent.git
  99. ```
  100. 首次启用时还需要在你自己 fork 的 GitHub 仓库设置中将 Pages 的 source 切到 `GitHub Actions`。
  101. ### 日常发布链路
  102. GitHub Pages 模式下,定时任务会在 LLM 补全完成后自动发布。
  103. 如果你手动执行,流程是:
  104. ```bash
  105. cd /path/to/hermes-arxiv-agent
  106. DEPLOY_MODE=pages bash prepare_deploy.sh
  107. python3 viewer/build_data.py
  108. python3 monitor.py --sync-pending-state
  109. bash scripts/publish_viewer.sh
  110. ```
  111. 说明:
  112. - `viewer/papers_data.json` 会随提交推送到 GitHub
  113. - push 到 `main` 后会触发 `.github/workflows/pages.yml`
  114. - 推送目标应当是你自己 fork 的仓库
  115. - 公开站点的收藏功能使用浏览器 `localStorage`,不再依赖服务器端 `favorites.json`
  116. ### 更新定时任务
  117. 如果你已经有可用的 GitHub Pages 模式仓库,只想刷新 cron prompt 和定时任务,不要删仓库重装。
  118. 可以在 Hermes 对话里直接说:
  119. ```text
  120. 请使用当前仓库里的 UPDATE_CRON_SKILL.md,只更新 hermes-arxiv-agent 的 GitHub Pages 模式定时任务。不要重新克隆仓库,不要重装依赖。请基于当前本地仓库以 DEPLOY_MODE=pages 运行 prepare_deploy.sh,读取最新 cronjob_prompt.generated.txt,并将现有 cron 更新到最新版本;如果不能直接编辑,就删除旧任务后重建一个新的同名任务。请保留当前 fork 仓库作为发布仓库,不要改回上游仓库。
  121. ```
  122. ## 定时任务说明
  123. 定时任务相关逻辑以 [AGENT_SKILL.md](AGENT_SKILL.md) 和 prompt 模板为准。
  124. 现在有两种不同的定时任务模板:
  125. - 本地/飞书模式:使用 [cronjob_prompt.txt](cronjob_prompt.txt)
  126. - GitHub Pages 模式:使用 [cronjob_prompt.pages.txt](cronjob_prompt.pages.txt)
  127. `prepare_deploy.sh` 会根据部署模式生成对应的 `cronjob_prompt.generated.txt`,并在仓库根目录写入 `.deploy_mode` 记录当前模式。
  128. ## 关键词默认配置
  129. 默认监控方向是 LLM 量化相关论文。
  130. 如需修改监控方向,编辑 [search_keywords.txt](search_keywords.txt) 即可。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.