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）——这串字符很重要，要妥善保管  ### 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为例  - **Plex用户**：需要Plex Token（在Plex设置里找） - **Emby用户**：类似Jellyfin的配置方式 输入上面获得的 TMDB 的 API 密钥，点击右侧的按钮，如果正确，nextStep 按钮会变绿，就可以点击了  ### 配置Jellyfin 的 URL 和 api key 这一步要配置Jellyfin的 URL 和 key  打开Jellyfin应用，进入控制台   进入 API Keys，新建一个密钥  URL 填：https://jellyfinsingle.你的懒猫.heiyu.space/ 选择一个你的 library，进入下一步  #### 配置Jellyseer/Overseer 这里要填入Jellyseer或Overseer的地址和API Key。  打开Jellyseer 应用  进入到设置  在这里复制自己的 apikey  注意，这里直接填入 Jellyseer的 URL 是不行的，会报错误  要先对 URL 进行转发一下，打开局域网转发工具 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward  在左侧填入转发后的地址，类似这样：http://你的懒猫.heiyu.space:5055 这时候再点击右侧的按钮，可以看到已经通了，下方的按钮可以进行下一步  选默认 sqlite 数据库就可以  第 6 步可以进行一些高级配置、语言、剧集等等，可以选择默认  #### 设置自动运行时间（Cron Job） 第 7 步，这里决定了SuggestArr多久检查一次你的观看记录。常用设置： - `0 */6 * * *` - 每6小时运行一次（推荐） - `0 2 * * *` - 每天凌晨2点运行 - `0 */12 * * *` - 每12小时运行一次  **新手建议**：刚开始用每6小时一次比较合适，既不会错过新内容，也不会太频繁。 点击 Save 保存之后，就已经配置完了。点击 Run 就会自动运行  ### 日志监控  通过Web界面的实时日志功能，你可以： - 查看INFO级别日志了解正常运行状态 - 查看ERROR日志排查问题 - 查看DEBUG日志深入了解运行细节  **实用技巧**：如果推荐效果不理想，看看DEBUG日志，可能是TMDb返回的相似影片不够精准。 ## 写在最后 SuggestArr不是要取代你的选片能力，而是成为你的影视助手。它观察你的喜好，默默推荐可能喜欢的内容，让你的影视库始终保持新鲜。 最棒的是，这一切都是自动的。设置好之后，你要做的就是享受源源不断的好内容。当朋友问你"最近有什么好看的"时，打开你的媒体库，里面早就准备好了答案。 --- **项目地址**：https://github.com/giuseppe99barchetta/SuggestArr **Discord社区**：https://discord.gg/cpjBJ5sK（有问题可以去这里交流） 祝你观影愉快！🎬