跳至主要內容

基础设置

xylplm2023/9/27大约 17 分钟

🎛️ 基础设置

本文档详细介绍 Media Saber 系统的各项基础配置。系统设置页面已组织为 7 个功能模块，每个设置字段都配有详细的用途说明、默认值示例和操作建议，帮助你快速上手和高效配置。

📌 重要提示

  • TMDB API Key 是必配项，没有它系统无法正常运行
  • 某些配置（如代理、超时时间）需要根据你的网络环境调整
  • 标有 ⚠️ 的配置项为高级调试选项，非必要情况下建议保持默认值
  • 部分字段修改后需要重启应用才能生效

✨ 功能模块说明

模块说明
⚙️ 基础配置系统级配置（代理、地址、User-Agent 等）
🎬 媒体配置TMDB 和背景图片相关的配置
🔍 订阅搜索搜索、订阅和过滤相关配置
📁 媒体整理文件整理、重命名和转移配置
🎨 刮削配置元数据和图片刮削配置
🤖 智能体配置AI 相关配置
🔌 服务配置第三方服务（Pansou、HDHive、Google CSE 等）

📑 快速导航

⚙️ 基础配置🎬 媒体配置🔍 订阅搜索
📁 媒体整理🎨 刮削配置🤖 智能体配置
🔌 服务配置💡 推荐服务📝 速查表

⚙️ 基础配置 (系统配置)

代理服务器

说明： 将使用代理访服务器访问themoviedb、telegram、google等境外网站和服务，站点默认不使用代理，如需使用需在站点维护中开启；配置格式示例：http://127.0.0.1:7890（Http协议）、socks5://127.0.0.1:8018、socks5h://127.0.0.1:8018(remote DNS)

默认值/示例： 空

  • http://127.0.0.1:7890
  • socks5://127.0.0.1:8018

操作建议： 如需访问 TMDB、Telegram、程序更新等境外服务，需配置代理。

外网访问地址

说明： 用于外网访问访问本系统使用的地址，通常为http协议://域名:端口，如：http://www.example.com:8888

⚠️ 修改警告

修改此地址会影响：消息提示中的图片链接、外部访问资源的URL、Strm文件内部的访问路径。如果已使用 Strm 功能，修改后请前往：云存储 → Strm生成 → Strm修复 → 修复Host。

默认值/示例： 空

  • http://your.domain:8443

操作建议： 填写完整协议和端口，Telegram Webhook 推荐 88 或 8443。

内网访问地址

说明： 用于内网访问访问本系统使用的地址

⚠️ 修改警告

修改此地址同样会影响消息链接、资源 URL 和 Strm 文件路径，修改前请确认影响范围。

默认值/示例： 空

  • http://192.168.1.100:8888

操作建议： 通知等场景可用内网地址。

登录后跳转页面

说明： 可以指定登录跳转指定页面菜单，不再是默认首页

默认值/示例： 默认首页

操作建议： 可选填，如 我的媒体库、寻影探剧、搜索任务、站点数据、站点签到、站点资源、站点公告、站点消息、电影订阅、电视剧订阅、正在下载、目录同步、小工具等。

User-Agent

说明： 程序所有对外请求都将默认使用此User-Agent。如发现被豆瓣、PT站等封堵，请适当修改此项

默认值/示例： 当前浏览器 UA

操作建议： 如被豆瓣/PT站封禁可自定义 UA。可点击输入框后的箭头按钮获取当前浏览器的User-Agent。

GitHub Token

说明： GitHub 个人访问令牌（PAT），用于访问 GitHub API。突破 GitHub API 的匿名访问限制（60 次/小时），提升至 5000 次/小时，确保程序更新、站点配置文件拉取、CTMD 自建 TMDB 信息文件获取等功能的稳定性和速度。详细获取教程请参见 GitHub Token 生成获取教程

默认值/示例： 空

  • ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

操作建议： 用于程序更新、站点配置文件拉取、CTMD 信息文件获取等功能。强烈推荐配置此项以获得更好的使用体验。Token 建议设置 30-90 天的有效期并定期轮换。点击查看详细教程

🎬 媒体配置

TMDB API Key

说明： 在themoviedb.org网站申请API Key，该项必须配置，否则所有功能无法正常运行

默认值/示例： 空

  • xxxxxxx

操作建议： 无此项无法正常匹配媒体。必须配置此项才能使用系统功能。

TMDB 接口地址

说明： TMDB 接口地址，可自建代理服务，留空默认使用 TMDB 官方地址。第三方代理域名地址不保证完全可用，请斟酌使用。

默认值/示例： 空（留空使用官方地址）

  • https://api.themoviedb.org/3 (官方地址)
  • https://api.tmdb.org/3 (官方地址)

操作建议： 官方无法访问时可填写代理地址。

默认背景图片地址

说明： 缺省图片地址，适用场景：图文通知等

默认值/示例： 空

操作建议： 用于补充媒体信息缺失时显示的默认背景。

默认背景图片使用代理

说明： 开启后默认背景图片请求将走系统代理

默认值/示例： 关闭

操作建议： 如背景图片地址需要代理访问可开启。

默认背景图片是否动态

说明： 开启后默认背景图片将动态展示

默认值/示例： 关闭

操作建议： 按需开启。

🔍 订阅搜索

媒体搜索结果包含成人内容条目

说明： 开启该选项后将会在刮削或者检索时包含TMDB数据库的成人内容请谨慎开启！服务来自TMDB，本程序并没有成人资源，仅做API参数开关。请勿用于非法用途，责任自负！需要先去TMDB个人设置中将【搜索结果中包含成人内容条目】选项开启，开启该选项后将会在刮削或者检索时包含成人内容

默认值/示例： 关闭

操作建议： 请谨慎开启，仅在合法使用场景下启用。

媒体库缺失

说明： 订阅时只订阅媒体库缺失的电影剧集，多个媒体服务时记得打开默认

默认值/示例： 开启

操作建议： 开启后可避免重复订阅已入库内容。

手动搜索过滤规则

说明： 手动搜索、消息交互等非订阅搜索的种子过滤规则

默认值/示例： 无

操作建议： 与订阅搜索过滤规则独立配置。可在 过滤规则 页面创建过滤规则组。

手动搜索排序规则

说明： 手动搜索的默认种子排序规则

默认值/示例： 无

操作建议： 可在 种子排序 页面创建自定义排序规则。

RSS 周期

说明： RSS 订阅刷新的时间间隔，需要在订阅管理中设置订阅站点。为了减小站点压力，该功能最小周期建议大于 10 分钟。低于 10 分钟的频率会使用缓存数据。支持 Cron 表达式。

默认值/示例： 空（支持 Cron 表达式，如 0 */30 * * * ? 表示每 30 分钟执行一次）

操作建议： 建议设置合理的刷新周期，避免对站点造成过大压力。

搜索周期

说明： 定时对电影/电视剧订阅进行站点存量资源检索下载，用于对 RSS 订阅进行查漏补缺。该项会对站点造成压力，应尽量通过维护站点 RSS 实现订阅追新。如非必要请不要开启。该功能最小周期建议大于 6 小时，一天一次为宜！过低的频率会使用缓存数据。支持 Cron 表达式。

默认值/示例： 空（支持 Cron 表达式，如 0 0 0 * * ? 表示每天午夜执行一次）

操作建议： 建议设置合理的搜索周期，避免对站点造成过大压力。

搜索前缀

说明： 指定前缀，在消息渠道端搜索媒体和种子。例如：搜索 流浪地球2.2023

默认值/示例： 搜索

操作建议： 可自定义命令前缀。

订阅前缀

说明： 指定前缀，在消息渠道端订阅媒体。例如：订阅 流浪地球2.2023

默认值/示例： 订阅

操作建议： 可自定义命令前缀。

搜索种子缓存时间(分)

说明： 站点种子相同搜索条件的搜索结果缓存时间，低于该时间频率，结果将直接从缓存中获取，避免站点警告。单位：分，建议不低于10分钟

默认值/示例： 0

操作建议： 建议设置合适的缓存时间，避免频繁请求站点。

相同种子分组

说明： 来自不同站点的种子，按照标题分组显示

默认值/示例： 开启

操作建议： 开启后搜索结果更整洁，相同资源合并展示。

过滤规则详细日志

说明： ⚠️ 警告：临时查找过滤问题使用，严禁长时间开启，日志可能会爆炸，后果自负！ 开启后将在日志中显示过滤规则过滤种子详细日志，以查找过滤原因。

默认值/示例： 关闭

操作建议： 仅排查问题时开启。

RSS 订阅任务并发数

说明： 订阅数量太多可以考虑调大，修改后需要重启服务生效

默认值/示例： 1

操作建议： 订阅数量多时可适当调大，但需重启服务生效。

📁 媒体整理

电影重命名格式

说明： 定义电影文件/目录命名格式，支持占位符。点击输入框后的问号按钮可查看详细说明。

支持的占位符：{title}标题、{en_title}英文标题、{original_title}原语种标题、{original_name}原文件名、{rev_name}识别词处理后的原文件名、{year}年份、{edition}版本、{videoFormat}分辨率、{videoCodec}视频编码、{audioCodec}音频编码及声道、{tmdbid}、{imdbid}、{part}、{releaseGroup}制作组、{name}识别名称

默认值/示例： 空

操作建议： 点击"?"按钮查看详细说明。

电视剧重命名格式

说明： 定义电视剧文件/目录命名格式，支持占位符。点击输入框后的问号按钮可查看详细说明。

支持的占位符：{title}标题、{en_title}英文标题、{original_title}原语种标题、{original_name}原文件名、{rev_name}识别词处理后的原文件名、{year}年份、{edition}版本、{videoFormat}分辨率、{videoCodec}视频编码、{audioCodec}音频编码及声道、{tmdbid}、{imdbid}、{season}季数、{episode}集数、{episode_title}集标题、{season_episode}剧集SxxExx、{part}、{releaseGroup}制作组、{name}识别名称

默认值/示例： 空

操作建议： 点击"?"按钮查看详细说明。

默认转移方式

说明： 文件整理转移方式。

默认值/示例： 硬链接

操作建议： 推荐硬链接，节省空间。

最小文件大小(M)

说明： 开启后文件整理转移时，会忽略小于配置文件大小的文件。避免预告片/MV等影响识别，单位M

默认值/示例： 0

操作建议： 单位为MB，避免转移小文件。

硬连接后触发变化

说明： 用于部分设备出现硬连接后文件不刷新的情况，比如极空间。其他设备无问题不建议开启，避免影响性能。

默认值/示例： 不操作

操作建议： 极空间等设备建议开启。选项：

  • 不操作：默认，不做额外处理
  • 文件移动触发：硬链接后触发文件移动以刷新

路径忽略

说明： 开启后文件整理转移时，会忽略匹配配置文件路径的文件。使用正则表达式匹配

默认值/示例： 空

操作建议： 路径包含指定内容则忽略。

文件名忽略

说明： 开启后文件整理转移时，会忽略匹配配置文件名的文件。正则表达式匹配

默认值/示例： 空

操作建议： 文件名包含指定内容则忽略。

查补漏集排除媒体库

说明： 查漏集、补漏集指令要排除的媒体库名称。

默认值/示例： 空

操作建议： 多个用换行分隔。

高质量文件覆盖

说明： 开启后非云存储文件整理转移时，会进行高质量文件覆盖，覆盖原文件

默认值/示例： 关闭

操作建议： 同名文件按体积覆盖。

识别词日志

说明： 识别词日志通常会很多，请酌情开启

默认值/示例： 关闭

操作建议： 仅排查问题时开启。

识别日志

说明： 识别日志通常会很多，请酌情开启

默认值/示例： 关闭

操作建议： 仅排查问题时开启。

已入库效果

说明： 开启已入库效果，已入库的媒体弱化显示

默认值/示例： 关闭

操作建议： 视觉区分已入库内容。

🎨 刮削配置

刮削模式

说明： 默认的刮削模式

默认值/示例： 覆盖所有元数据和图片

操作建议： 影响元数据来源。选项包括：

  • 仅刮削缺失的元数据和图片：只补充缺失的内容
  • 覆盖所有元数据：更新元数据但保留现有图片
  • 覆盖所有元数据和图片：全部更新

FanArt 代理

说明： 是否启用 FanArt 代理，开启后刮削图片会走代理

默认值/示例： 开启

操作建议： 加速图片下载。

TMDB 原语言图片

说明： TMDB 海报、背景图使用原语言图片

默认值/示例： 关闭

操作建议： 如需英文海报可开启。

电影刮削

说明： 设置需要刮削的电影元数据类型

默认值/示例： 全部关闭

操作建议： 可按需选择。包括：

  • nfo：元数据
  • poster：海报
  • backdrop：背景
  • logo：Logo

电视剧刮削

说明： 设置需要刮削的电视剧元数据类型

默认值/示例： 全部关闭

操作建议： 可按需选择。包括：

  • nfo：元数据
  • poster：海报
  • backdrop：背景
  • logo：Logo

季

说明： 设置需要刮削的季元数据类型

默认值/示例： 全部关闭

操作建议： 可按需选择。包括：

  • nfo：元数据
  • poster：海报

集

说明： 设置需要刮削的集元数据类型

默认值/示例： 全部关闭

操作建议： 可按需选择。包括：

  • nfo：元数据
  • thumb：缩略图

🤖 智能体配置

OpenAI API URL

说明： 支持所有 OpenAI 类型的服务商，记得加上版本号。配置后可使用智能体功能。

默认值/示例： 空

  • https://api.openai.com/v1

操作建议： 如用第三方服务需填写对应地址。

OpenAI API Key

说明： OpenAI API 密钥，用于智能体和 AI 功能

默认值/示例： 空

  • sk-xxxxxxx

操作建议： 用于 AI 聊天、识别等功能。

默认模型

说明： 智能体使用的默认 AI 模型

默认值/示例： 空

  • gpt-3.5-turbo

操作建议： 如需更高性能可填写 gpt-4 等模型。影响智能体回复质量。

AI 签到增强

说明： 部分需要问答类的站点，将使用 AI 处理提问，增强正确率。

默认值/示例： 关闭

操作建议： 如遇签到提问可开启。

AI 媒体识别增强

说明： 开启后，通过 TMDB 的 API 无法识别到媒体信息时，使用 AI 识别匹配，提高种子的识别率。

默认值/示例： 关闭

操作建议： 提升极端场景识别率。

AI 订阅识别增强

说明： 开启后，订阅通过 TMDB 的 API 无法识别到媒体信息时，使用 AI 识别匹配，提高种子的识别率。

默认值/示例： 关闭

操作建议： 提升极端场景下订阅识别率。

🔌 服务配置

Pansou Api 地址

说明： Pansou 服务地址，例如：http://192.168.1.1:8017，系统对外搜索网盘资源时会使用该地址。

默认值/示例： 空

  • http://192.168.1.1:8017

操作建议： 需要搜索网盘资源时配置。

HDHive Open ApiKey

说明： HDHive Open API Key。系统固定请求 https://hdhive.com，媒体详情页的 HDHive 资源卡片会直接使用该密钥。

默认值/示例： 空

操作建议： 填写后可在媒体详情页查看 HDHive 资源。

Google CSE API

说明： 豆列豆单搜索使用。获取 API 密钥：https://developers.google.com/custom-search/v1/introduction?hl=zh-cn

默认值/示例： 空

操作建议： 需配合 Google CSE ID 使用。

Google CSE ID

说明： 豆列豆单搜索使用。创建可编程搜索引擎后：https://programmablesearchengine.google.com/controlpanel/create，在概览页的基本部分找到搜索引擎 ID

默认值/示例： 空

操作建议： 需配合 Google CSE API 使用。

OCR 服务地址

说明： OCR 服务地址，用于网站登录更新 Cookie 以及特殊站点签到等识别验证码场景。可根据需要自行修改。配置完成后请点击"测试"按钮验证服务有效性。

默认值/示例： 空

操作建议： 请参考 OCR 服务配置指南。

说明： 需要用到 Cookie 的时候填上

默认值/示例： 空

操作建议： 如需访问豆瓣受限内容需填写。可点击"获取 Cookie"按钮自动获取。

💡 推荐服务

💰 硅基流动 AI 服务推荐

推荐使用硅基流动 AI 服务，享受高性价比的 API 调用。

🚀 智谱 BigModel 推荐

我正在智谱大模型开放平台 BigModel.cn 上打造AI应用，智谱新一代旗舰模型 GLM-5 已上线，在推理、代码、智能体综合能力达到开源模型 SOTA 水平，通过邀请链接注册即可获得 2000万Tokens 大礼包，期待和你一起在 BigModel 上畅享卓越模型能力！

💰 点击链接注册即可领取大礼包。

📝 配置建议速查表

快速找到特定场景下的推荐配置组合：

🚀 首次部署

✅ 填写 TMDB API Key 和代理服务器
✅ 设置外网/内网访问地址
✅ 配置 User-Agent

🌐 跨越防火墙

✅ 代理服务器
✅ TMDB 接口代理地址

📈 提升搜索质量

✅ 手动搜索过滤规则
✅ 手动搜索排序规则
✅ 相同种子分组

🤖 AI 功能增强

✅ 配置 OpenAI API URL 和 Key
✅ 设置系统提示词（System Prompt）
✅ 启用 AI 媒体识别增强 / AI 订阅识别增强

⚡ 性能优化

✅ 合理设置 RSS 周期（建议 10+ 分钟）
✅ 合理设置搜索周期（建议 6+ 小时）
✅ 配置搜索种子缓存时间（建议 10+ 分钟）

🔗 相关文档链接

系统管理

AI 和第三方服务

其他模块

❓ 常见问题

Q: 如何重置某个配置为默认值？
A: 点击对应输入框右侧的"重置"按钮，或参考本文的"默认值/示例"手动填入。

Q: 修改配置后何时生效？
A: 大多数配置实时生效，涉及系统级别的配置（如 RSS 订阅任务并发数）需要重启应用。

Q: 某个配置项找不到了？
A: 使用页面顶部的快速导航表格或按 Ctrl+F 搜索关键词，所有字段都在本文档中。

MIT License | Copyright © 2023-present xylplm
Copyright © 2026 xylplm