openlist-ani 1.0.0.dev260517

Automatically fetch anime updates from RSS feeds and download them offline to the corresponding cloud storage via OpenList.

Openlist-Ani

🎬 RSS 订阅 → 自动下载 → AI 重命名，一站式番剧自动化管理

Openlist-Ani，简称O-Ani，从动漫番剧相关的 RSS 订阅源中自动获取番剧更新，通过 Openlist 离线下载至对应网盘，
并结合 LLM 分析资源名，将资源重命名为 Emby / Jellyfin 可解析的格式。

---

✨ 特点

• 📡 自动追番 — 自动获取 RSS 番剧更新并下载
• 📦 多网盘支持 — 基于OpenList实现，支持 PikPak、115 等离线下载
• 🤖 AI 重命名 — AI 分析资源名 + TMDB 搜索，精准获取番剧名、季度、集数
• 💬 智能助理 — 挂载至 Telegram / 微信ClawBot / 飞书机器人，通过自然语言让 AI 帮你搜索并下载资源
• 🔔 更新通知 — 通过 PushPlus、Telegram、微信ClawBot、飞书等渠道推送更新

📋 准备工作

1. 参照 Openlist 官方文档 部署 Openlist，并搭建好离线下载
2. 准备好 RSS 订阅链接（如 Mikan Project）
3. 推荐准备好 LLM API Key（未配置时会使用本地正则解析 + TMDB 校验）

🚀 快速开始

方式一：源码安装（推荐）

前置：安装 uv

Linux / macOS curl -LsSf https://astral.sh/uv/install.sh | sh

Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

更多安装方式参考 uv 官方文档

1. 安装

git clone https://github.com/TwooSix/Openlist-Ani.git
cd Openlist-Ani

# 推荐切换到最新 Release tag；master 为开发分支，不保证稳定
# Release 版本以 tag 为准
git fetch --tags
git checkout tags/v***    # 将 v*** 替换为 Release 页面中的版本号

uv sync --no-dev --frozen

2. 创建配置文件

在运行目录下新建 config.toml，填入以下内容：

[rss]
urls = ["RSS订阅链接"]

[openlist]
url = "http://localhost:5244"       # Openlist 访问地址
token = ""                          # 令牌，见「设置 → 其他 → 令牌」
download_path = "/PikPak/Anime"     # 下载保存路径
offline_download_tool = "QBITTORRENT"  # 离线下载工具

[metadata_parser]
provider = "llm"                    # 推荐 llm + tmdb；未配置 LLM 时默认 regex + tmdb

[metadata_validator]
provider = "tmdb"

[llm]
openai_api_key = ""                 # LLM API Key；启用 AI 助理时也必填
openai_base_url = "https://api.deepseek.com/v1"
openai_model = "deepseek-chat"

完整配置项请参考 config.toml.example 及 配置说明

3. 启动

uv run openlist-ani

4.（可选）启动 AI 助理

在配置文件中补充助理配置后运行：

[assistant]
enabled = true

[assistant.telegram]
enabled = true
bot_token = ""        # 从 @BotFather 获取
allowed_users = []    # 允许的用户 ID 列表（留空则允许所有人，建议设置具体 ID）

uv run openlist-ani-assistant

内置 skills 会随程序包加载并自动更新；./skills 只用于新增自定义 skill，或放置同名 skill 来覆盖内置版本。

方式二：Docker 部署

1. 准备文件

在运行目录下创建：

• config.toml — 配置文件（内容同上）
• data/ — 数据目录

2. 启动容器

docker run -d \
  --name openlist-ani \
  --network host \
  -e ENABLE_ASSISTANT=false \
  -v /path/to/config.toml:/config.toml \
  -v /path/to/data:/data \
  twosix26/openlist-ani:latest

将 /path/to/ 替换为你的实际路径。
如需启用 AI 助理，填写好配置后将 ENABLE_ASSISTANT 设为 true。
详细说明见 Docker 部署指南。

方式三：PIP 安装

pip install openlist-ani
openlist-ani

# 可选：启动 AI 助理
openlist-ani-assistant

📖 文档

• 快速开始
• PIP 安装指南
• Docker 部署指南
• 源码编译指南
• 配置说明

🖼️ 效果展示

重命名结果	智能助理