跳至主要內容

基础设置

xylplm2023/9/27大约 23 分钟

🎛️ 基础设置

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

📌 重要提示

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

✨ 功能模块说明

模块说明包含字段数
⚙️ 基础配置系统级配置（代理、地址、目录等）15+
🎬 媒体配置TMDB 和资源相关的配置14+
🔍 订阅搜索搜索、订阅和过滤相关配置20+
📁 媒体整理文件整理、重命名和转移配置12+
🎨 刮削配置元数据和图片刮削配置8+
🤖 智能体配置AI 和 MCP 相关配置13+
🔌 服务配置第三方服务（NullBr、Google 等）6+

📑 快速导航

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

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

代理服务器

说明： 将使用代理访服务器访问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

默认值/示例： 空

  • http://your.domain:8443

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

内网访问地址

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

默认值/示例： 空

  • http://192.168.1.100:8888

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

登录后跳转页面

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

默认值/示例： 默认首页

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

User-Agent

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

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

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

存储空间目录

说明： 需要统计存储空间的目录, 多个以英文逗号分隔

默认值/示例： 空

  • /mnt/media,/mnt/downloads

操作建议： 用于空间统计展示。

文件管理目录

说明： 文件管理目录, 多个以英文逗号分隔

默认值/示例： 空

  • /mnt/downloads

操作建议： 用于文件管理页面操作。

临时文件保留天数

说明： /app/config/tmp 路径下的文件，永久保留填 0

默认值/示例： 3

操作建议： 定期清理临时文件，避免空间占用。单位为天数。

日志保留天数

说明： 永久保留填 0

默认值/示例： 无

操作建议： 定期清理日志文件，避免占用过多磁盘空间。

AES 加密密钥

说明： AES 加密默认密钥，用于文件加密场景，使用常用功能工具生成

默认值/示例： 空

操作建议： 点击箭头按钮自动生成。

GitHub Token

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

默认值/示例： 空

  • ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

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

显示所有文件类型

说明： 本地文件管理文件列表显示所有文件类型，不开启只显示媒体文件

默认值/示例： 关闭

操作建议： 需要管理非媒体文件时开启。

文件夹文件忽略

说明： 文件夹默认文件忽略配置，使用 .gitignore 规则过滤文件，多个换行分隔

默认值/示例： 空

操作建议： 用于忽略特定类型的文件不显示。

🎬 媒体配置

TMDB API Key

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

默认值/示例： 空

  • xxxxxxx

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

TMDB 接口地址

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

默认值/示例： https://api.themoviedb.org/3

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

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

TMDB 配置同步周期

说明： 从 Media Saber 的元数据自维护库拉取最新数据。主要目的是解决 TMDB 库被恶意修改导致识别错误的问题，通过社区协作维护高质量的媒体元数据。可设置自动同步周期。

默认值/示例： 空（支持 Cron 表达式）

操作建议： 可配置自动同步，避免手动同步。

TMDB 语言

说明： TMDB语言，将会影响媒体信息展示、文件整理及刮削等所有涉及使用TMDB数据的内容语言

默认值/示例： zh-CN

  • zh-CN (中文)
  • en-US (英文)

操作建议： 如需英文信息可填 en-US。

TMDB 匹配模式

说明： tmdb匹配模式.严格模式:严格匹配标题、媒体年份和类型 正常模式：若识别的年份和类型未获取到，则去掉年份和类型，根据名称再查一次进行匹配

默认值/示例： 正常模式

操作建议： 推荐正常模式，特殊需求可选严格。选项包括：

  • 正常模式
  • 严格模式

TMDB 电影缓存天数

说明： 缓存tmdb，提升系统流畅度。新媒体可能信息有误，缓存后可能更新不及时。

默认值/示例： 7

操作建议： 缓存过期后自动刷新。

TMDB 电视剧缓存天数

说明： 缓存tmdb，提升系统流畅度。新媒体可能信息有误，缓存后可能更新不及时。电视剧建议稍微短一点

默认值/示例： 1

操作建议： 缓存过期后自动刷新。电视剧建议稍微短一点。

TMDB 超时时间(秒)

说明： 请求超时时间, 单位秒，建议不超过30秒

默认值/示例： 60

操作建议： 网络慢时可适当调高。

TMDB 索引保留天数

说明： 为 0 则永久保留

默认值/示例： 0

操作建议： 索引用于加速搜索。

媒体详情资源类型

说明： 媒体详情的资源链接列表要用到，目前主要来自 NullBr，可选择 ed2k、分享链接、magnet、m3u8 等资源类型，不勾选则不显示

默认值/示例： 空

操作建议： 可按需选择资源类型显示：

  • NullBr ed2k 链接：显示 ed2k 资源链接
  • NullBr 分享链接：显示网盘分享链接
  • NullBr magnet 链接：显示磁力链接
  • NullBr m3u8 链接：显示流媒体链接

默认背景图片地址

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

默认值/示例： 空

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

TMDB Web 搜索

说明： tmdb api 搜索不到时尝试 tmdb web 搜索(例如: 2099 2099 y:2025, 这样搜索如果只有一条记录则匹配成功)

默认值/示例： 关闭

操作建议： 极端场景下提升识别率，耗时增加。

🔍 订阅搜索

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

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

默认值/示例： 关闭

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

媒体种子精准搜索

说明： 媒体搜索时匹配 tmdb 精准过滤种子。

默认值/示例： 关闭

操作建议： 开启后可以提高搜索准确性。

手动搜索只搜 BT 站点

说明： 手动搜索时，例如：从媒体列表搜索、站点直搜，只搜索 BT 站点。

默认值/示例： 关闭

操作建议： 如只需 BT 资源可开启。

BT 资源排序优先

说明： 在排序规则的基础上, bt(网盘、磁力、ed2k等等) 资源的排序优先

默认值/示例： 开启

操作建议： 开启后BT资源将在排序中获得优先权。

BT资源走网盘

说明： 包括网盘分享链接、磁力链接、ed2k链接。默认走下载器下载

默认值/示例： 关闭

操作建议： 如需自动转存网盘可开启。

媒体库缺失

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

默认值/示例： 开启

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

订阅搜索间隔(分钟)

说明： 订阅搜索间隔，即每个媒体订阅任务的间隔时间。比如你有 10 部剧在订阅，这里设置 1 分钟，这 10 部剧每部之间间隔 1 分钟。单位：分钟，默认 1 分钟

默认值/示例： 1

操作建议： 根据订阅数量合理设置间隔，避免对站点造成压力。

资源搜索默认过滤规则

说明： 设置该选项后，搜索种子时将会使用过滤规则作为默认过滤规则过滤种子

默认值/示例： 无

操作建议： 可选择已创建的过滤规则组。可在 过滤规则 页面创建过滤规则组。

非订阅搜索过滤规则

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

默认值/示例： 无

操作建议： 与订阅搜索过滤规则独立配置。

种子排序规则

说明： 设置该选项后，搜索种子时将会使用该排序规则作为默认排序规则排序种子。（注：默认规则热种优先免费其次）

默认值/示例： 默认排序

操作建议： 可根据需要选择不同的排序规则。可在 种子排序 页面创建自定义排序规则。

站点超时时间(秒)

说明： 站点相关请求超时时间, 单位：秒，建议不超过30秒

默认值/示例： 10

操作建议： 网络慢时可适当调高。

站点下载超时时间(秒)

说明： 站点相关下载请求超时时间, 单位：秒，不配就走站点超时时间

默认值/示例： 60

操作建议： 下载慢时可适当调高。

订阅RSS任务周期

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

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

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

订阅搜索任务周期

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

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

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

搜索前缀

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

默认值/示例： 搜索

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

订阅前缀

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

默认值/示例： 订阅

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

种子RSS缓存时间(分)

说明： 站点种子RSS结果缓存时间，低于该时间频率，结果将直接从缓存中获取，避免站点警告。单位：分，建议不低于5分钟

默认值/示例： 0

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

种子搜索缓存时间(分)

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

默认值/示例： 0

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

搜索任务保留天数

说明： 根据自己情况适当设置天数，注意：已发布站点是根据搜索任务的种子来判断的。

默认值/示例： 0

操作建议： 定期清理历史任务，避免占用过多存储空间。

📁 媒体整理

电影重命名格式

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

默认值/示例： 空

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

电视剧重命名格式

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

默认值/示例： 空

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

整理默认转移方式

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

默认值/示例： 硬链接

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

整理最小文件大小(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

操作建议： 如用第三方服务需填写对应地址。配置完成后可在 智能体 中使用 AI 聊天功能。

OpenAI API Key

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

默认值/示例： 空

  • sk-xxxxxxx

操作建议： 用于 AI 聊天、识别等功能。获取后可使用 智能体 和 MCP 服务。

默认模型

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

默认值/示例： 空

  • gpt-3.5-turbo

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

智能体角色

说明： 智能体角色名称，会在对话界面显示

默认值/示例： 空

操作建议： 可自定义智能体的角色名称，如 影视助手、媒体管家 等。

系统提示词 (System Prompt)

说明： 此提示词将作为所有新对话的默认系统提示词，您可以在创建对话时修改，注意本设置修改后会在下一次创建新会话时生效。

默认值/示例： 空

操作建议： 可自定义智能体角色和行为风格。配置后在 智能体 中生效。

🎯 参考模板

你是影视达人，专门帮助用户管理和整理影视资源。
你熟悉各种影视作品的信息，包括电影、电视剧的详情、演员、导演、发行年份等。
你可以帮助用户识别影视文件、推荐影视作品、解答影视相关问题，
并协助用户更好地组织和管理他们的媒体库。
请用专业且友好的语调回答用户的问题。

消息渠道智能体记忆

说明： 消息渠道智能体记忆分钟数，该时间段内为 AI 提供完整上下文，默认为 5 分钟

默认值/示例： 5

操作建议： 可根据需要调整记忆时长。

消息渠道智能体结束词

说明： 消息渠道智能体结束词，结束后将会清空记忆。

默认值/示例： 空

  • bye
  • 退下

操作建议： 可自定义结束对话的关键词。

扣子罗盘空间 ID

说明： 用于智能体 Trace 观测，修改空间 ID 和 Token 都需要重启生效。

默认值/示例： 空

操作建议： 用于扣子罗盘观测功能。

扣子罗盘令牌

说明： 用于访问扣子罗盘

默认值/示例： 空

操作建议： 配合扣子罗盘空间 ID 使用。

启用 MCP

说明： 启用或禁用 MCP 功能和工具。启用后可在智能体中使用 Media Saber 的内置 MCP 服务。

默认值/示例： 关闭

操作建议： 开启后可在 智能体 中使用 MCP 服务，包括媒体服务、订阅管理等功能。详细配置请参考 MCP 服务文档。

AI 签到增强

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

默认值/示例： 关闭

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

AI 媒体识别增强

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

默认值/示例： 关闭

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

AI 订阅识别增强

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

默认值/示例： 关闭

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

🔌 服务配置

NullBr ApiKey

说明： 注册：https://nullbr.eu.org，添加 NullBr 站点、媒体详情的资源链接列表要用到

默认值/示例： 空

操作建议： 填写后可用 NullBr 资源。

NullBr 使用代理

说明： 开启后 NullBr 相关将使用系统配置-基础配置中的代理地址进行请求，默认关闭。

默认值/示例： 关闭

操作建议： 如需代理访问 NullBr 可开启。

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 接口代理
✅ NullBr 使用代理

📈 提升搜索质量

✅ 订阅搜索默认过滤规则
✅ 默认排序规则
✅ 媒体种子精准搜索

🤖 AI 功能增强

✅ 配置 OpenAI API URL 和 Key
✅ 设置系统提示词（System Prompt）
✅ 启用 MCP

⚡ 性能优化

✅ 调整 TMDB 缓存天数（电影7天，电视剧1天）
✅ 合理设置超时时间（建议 30 秒以内）
✅ 配置任务周期（RSS 10+ 分钟，搜索 6+ 小时）

🔗 相关文档链接

系统管理

AI 和第三方服务

其他模块

❓ 常见问题

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

Q: 修改配置后何时生效？
A: 大多数配置实时生效，涉及系统级别的配置（如 AES 密钥、扣子罗盘 Token）需要重启应用。

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

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