SuggestArr 使用指南：让你的影视库自动推荐新片

## 这玩意儿到底是啥？

简单来说，SuggestArr是个自动化推荐工具。它会监控你在Jellyfin、Plex或Emby上看过的内容，然后通过TMDb（全球最大的影视数据库）找到类似的影片，最后自动向Jellyseer或Overseer发起下载请求。整个过程完全自动化，你只需要躺着等新片就行了。

打个比方：如果你是个美剧迷，最近在追《权力的游戏》，SuggestArr就会自动帮你找到《维京传奇》《最后的王国》这类史诗剧集。

如果你喜欢看日本动画，看完《进击的巨人》，它可能会推荐《东京喰种》或《约定的梦幻岛》。


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.suggestarr


## 开始之前，你需要准备什么

### 1. 获取TMDb API密钥（必须的）

TMDb就像影视界的维基百科，所有电影电视剧的信息都在这里。要使用SuggestArr，你得先拿到一把"钥匙"：

1. 访问 https://www.themoviedb.org 注册账号
2. 登录后点击右上角头像，进入Settings（设置）
3. 找到API选项，点击"Request an API Key"
4. 选择"Developer"（开发者）选项
5. 填写简单的申请表（应用名称随便写，比如"My Media Server"）
6. 拿到你的API Key（v3 auth）——这串字符很重要，要妥善保管

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/7ef8d874-ecdd-4457-ba8d-f98932804627.png "image.png")
### 2. 确保你的影视服务器在运行

- **Jellyfin/Plex/Emby**：这是你的影视播放器，至少要有一个在运行


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.jellyfinsingle


- **Jellyseer/Overseer**：这是管理下载请求的工具，负责接收SuggestArr的推荐


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.jellyseerr


### 第一次进入系统

打开浏览器，你会看到一个友好的配置向导。

### 配置要点详解

#### 选择你的媒体服务器

系统会让你选择使用哪个媒体服务器：
- **Jellyfin用户**：以Jellyfin为例

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/f4fcd797-fd3d-4bef-a324-0e29f6e76de8.png "image.png")
- **Plex用户**：需要Plex Token（在Plex设置里找）
- **Emby用户**：类似Jellyfin的配置方式

输入上面获得的 TMDB 的 API 密钥，点击右侧的按钮，如果正确，nextStep 按钮会变绿，就可以点击了

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/9a3abb0f-dfe0-407c-b581-8e987b693087.png "image.png")

### 配置Jellyfin 的 URL 和 api key

这一步要配置Jellyfin的 URL 和 key
![image.png](https://dl.playground.lazycat.cloud/guidelines/496/ec7e57e2-fb21-4e06-847b-027ea680d8ca.png "image.png")

打开Jellyfin应用，进入控制台

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/76c4285c-8776-49a7-a1a3-4c53ed5f7644.png "image.png")

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/b4e838bf-ae3d-4042-b344-7bf199d81468.png "image.png")

进入 API Keys，新建一个密钥

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/ffbe4839-5cae-4f80-835b-29dbc370bdcd.png "image.png")

URL 填：https://jellyfinsingle.你的懒猫.heiyu.space/

选择一个你的 library，进入下一步

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/0258fb25-ed2f-4323-ae08-9063790f71a2.png "image.png")
####  配置Jellyseer/Overseer

这里要填入Jellyseer或Overseer的地址和API Key。

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/14665671-9d65-415b-8d8d-95630796af21.png "image.png")

打开Jellyseer 应用

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/109ac09c-1bf9-487b-8ecf-2a79a83568d7.png "image.png")

进入到设置

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/ce12f9b6-0c49-4da1-b8dd-db705da2a6ed.png "image.png")

在这里复制自己的 apikey

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/e4d4aa44-3e18-466b-baf1-c2d4c4cf7260.png "image.png")

注意，这里直接填入 Jellyseer的 URL 是不行的，会报错误

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/7afd023f-390a-4a5f-9e26-cdf96c3d8a43.png "image.png")

要先对 URL 进行转发一下，打开局域网转发工具


https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward


![image.png](https://dl.playground.lazycat.cloud/guidelines/496/d7128a67-89ba-4f93-b213-6770ea9c819c.png "image.png")

在左侧填入转发后的地址，类似这样：http://你的懒猫.heiyu.space:5055

这时候再点击右侧的按钮，可以看到已经通了，下方的按钮可以进行下一步

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/297ce3b0-d777-48f1-9f7f-0d0d0a0a0ffd.png "image.png")

选默认 sqlite 数据库就可以

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/9ab74628-dbc7-4b66-a8b5-a08e18aca6b8.png "image.png")

第 6 步可以进行一些高级配置、语言、剧集等等，可以选择默认

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/1bce4672-bdff-4a27-9dd1-7a4526d106db.png "image.png")


#### 设置自动运行时间（Cron Job）

第 7 步，这里决定了SuggestArr多久检查一次你的观看记录。常用设置：

- `0 */6 * * *` - 每6小时运行一次（推荐）
- `0 2 * * *` - 每天凌晨2点运行
- `0 */12 * * *` - 每12小时运行一次

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/557a2f5b-6ac2-4acd-b172-1e2018045e74.png "image.png")
**新手建议**：刚开始用每6小时一次比较合适，既不会错过新内容，也不会太频繁。

点击 Save 保存之后，就已经配置完了。点击 Run 就会自动运行

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/81b996d6-0ef1-45ad-96ed-249fc0c18864.png "image.png")

### 日志监控

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/bca70d6a-7cb2-4870-b92a-5d8d7fdb0488.png "image.png")
通过Web界面的实时日志功能，你可以：
- 查看INFO级别日志了解正常运行状态
- 查看ERROR日志排查问题
- 查看DEBUG日志深入了解运行细节

![image.png](https://dl.playground.lazycat.cloud/guidelines/496/3f135b49-3028-4308-bb04-6b793fb8aa9a.png "image.png")
**实用技巧**：如果推荐效果不理想，看看DEBUG日志，可能是TMDb返回的相似影片不够精准。


## 写在最后

SuggestArr不是要取代你的选片能力，而是成为你的影视助手。它观察你的喜好，默默推荐可能喜欢的内容，让你的影视库始终保持新鲜。

最棒的是，这一切都是自动的。设置好之后，你要做的就是享受源源不断的好内容。当朋友问你"最近有什么好看的"时，打开你的媒体库，里面早就准备好了答案。

---

**项目地址**：https://github.com/giuseppe99barchetta/SuggestArr  
**Discord社区**：https://discord.gg/cpjBJ5sK（有问题可以去这里交流）

祝你观影愉快！🎬