# AniHermes

> 仓库地址：https://github.com/rodmarkun/anihermes
> 作者/组织：rodmarkun
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
基于 Hermes Agent 的自然语言动漫媒体服务器，通过对话方式管理动漫下载、追踪和媒体库组织。

## 项目定位与架构
AniHermes 解决的核心问题是将动漫资源的搜索、下载、追踪和库管理统一到一个自然语言交互界面中。用户通过 Telegram、Discord 或 CLI 发出指令，Hermes Agent 编排多个专用工具完成任务。

架构以 Hermes Agent 为核心调度器，下游编排：SubsPlease / Nyaa 的 web scraping、qBittorrent WebUI 的种子下载、Anilist API 的追踪同步、Vision 分析的截图识别，以及 CRON job 的周更自动监控。多源搜索使用 subagent 并行化。

## 关键技术特性
- **自然语言下载**：搜索 SubsPlease 和 Nyaa、获取 magnet link、通过 qBittorrent 下载
- **自动追踪**：CRON job 实现每周新集监控
- **Anilist 集成**：同步 watchlist、自动追踪未观看系列
- **视觉识别**：从截图识别动漫作品
- **并行搜索**：subagent 跨多平台并行检索
- **推荐系统**：基于 Anilist 数据的推荐引擎

## 设计亮点与创新
巧妙利用了 Hermes Agent 的多项核心能力：subagent 做并行搜索、CRON scheduling 做追踪、vision tool 做截图识别、persistent memory 存储用户偏好。是一个 "小而美" 的领域应用典范，展示了 agent 如何将碎片化的工具链整合为统一体验。

## 局限性与风险
依赖 SubsPlease / Nyaa 等资源站的可用性和法律合规性（种子下载在部分地区有法律风险）。qBittorrent 为硬依赖，需用户自行部署。作为 beta 项目，错误处理和边界情况覆盖可能不够完善。

## 与生态系统的关联
典型的 Hermes skill/tool 应用示例，展示了 CRON scheduling、subagent、vision、gateway（Telegram/Discord）等核心功能在特定领域的组合使用。可作为构建类似媒体管理 agent 的参考模板。
