系统设置

路径：设置 → 系统设置。

这里配置外部服务、通知渠道和系统访问参数。保存后先使用页面提供的测试按钮确认连接或消息投递正常。

第一次安装建议先读首次设置：其中的“代理服务器”是 Mediora 访问 TMDB 等外部服务使用的网络代理；它和“播放服务 → 媒体代理”不是同一个功能。

服务设置

这里可添加下载器以及 Emby、Jellyfin 等媒体服务器。每条服务都建议在保存后点击“测试连接”。

字段	怎么填写	影响
服务类型	选择你实际安装的下载器、Emby 或 Jellyfin。	决定连接方式。
服务地址	填写 Mediora 所在机器能够访问到的完整地址，例如 http://192.168.1.2:8096。	地址不可达时无法测试，也不能被后续功能使用。
WebUI API Key	下载器页面提供时填写；没有则按下载器实际要求处理。	用于读取下载状态或监听下载结果。
用户名、密码	下载器要求账号登录时填写。	仅用于连接该下载器。
API 密钥	Emby 或 Jellyfin 必填，使用媒体服务器后台创建的 API Key。	媒体代理需要通过它读取媒体服务器信息。

服务地址从 Mediora 容器内访问，不是从你的浏览器访问。另一个容器的 localhost 不能直接使用；请填可达的服务名或内网地址。修改媒体服务器地址或密钥后，回到影音优化重新检测助手并保存处理范围；不要把媒体代理端口回填成它自己的上游地址。

下载器连接成功不代表下载文件已经能读取。下载器与 Mediora 需使用一致的容器内保存路径，具体挂载示例见首次设置。

通知管理

路径：设置 → 系统设置 → 通知管理。

通知管理支持企业微信、Telegram 和 PushPlus。每个渠道都可以单独保存、启用和测试；先完成一个渠道的测试，再把它用于工作流或下载助手。

通用操作：

1. 在通知管理中找到要使用的渠道，点击配置按钮。
2. 按下面对应渠道的说明填写字段。
3. 将“启用”设为“是”，点击“保存”。
4. 重新打开配置，点击“测试”，确认手机、群组或频道实际收到测试消息。

不要把下面的 Token、Secret 或加密密钥发到聊天记录、截图和公开文档中。

渠道	需要填写的字段	作用
企业微信	企业 ID、应用 AgentId、应用 Secret、Token、EncodingAESKey；代理地址可选。	前五项来自企业微信自建应用和接收消息设置；用于发送通知和接收回调。
Telegram	Bot Token、Chat ID；代理 API 地址可选。	Bot Token 用于机器人身份，Chat ID 决定消息发到哪个用户、群组或频道。
PushPlus	用户 Token；群组编码可选。	未填群组编码时发送给个人，填写后发到对应群组。
启用	保存后选择“是”。	停用后保留配置，但不会发送消息，也不能用于下载助手交互入口。

企业微信

企业微信可以接收 Mediora 的任务通知；启用后，也可以作为下载助手的私聊入口。

1. 登录企业微信管理后台，在“我的企业 → 企业信息”中复制“企业 ID”。

2. 打开“应用管理 → 自建 → 创建应用”，创建一个专门给 Mediora 使用的应用。记下应用详情中的“AgentId”和“Secret”，并把需要接收消息的成员加入应用可见范围。

3. 在该应用的“接收消息”或“API 接收消息”设置中启用接收消息，填写下面的 URL：

   https://你的公网域名/api/v1/message

   在企业微信接收消息设置中生成或填写 Token、EncodingAESKey，先暂不提交 URL 验证，将它们原样复制到 Mediora 的同名字段。回调 URL 无需附加 Mediora API 令牌。

4. 回到 Mediora 的通知配置中填写：

   Mediora 字段	从哪里获取
   企业 ID	企业微信“我的企业 → 企业信息”中的企业 ID。
   应用 AgentId	该自建应用的 AgentId。
   应用 Secret	该自建应用详情中的 Secret。
   Token	与企业微信接收消息设置完全相同，用于验签，不需要拼进 URL。
   EncodingAESKey	企业微信接收消息设置中的 EncodingAESKey。
   代理地址	只有企业微信接口需要通过代理访问时才填写；普通部署留空。

5. 先在 Mediora 保存并启用企业微信配置，再到企业微信后台提交 URL 验证。Mediora 需要用已启用配置中的 Token 和 EncodingAESKey 验签，未保存或未启用时会提示配置不存在。验证完成后再发送测试消息。

这里的企业微信 Token 是回调验签用的值，不是“设置 → 系统设置 → 常规设置”中的 API 令牌；两者建议使用不同的随机值。公网域名必须能从企业微信访问，反向代理不能拦截 /api/v1/message/ 或改写查询参数。

Telegram

Telegram 的普通通知是 Mediora 发给指定用户、群组或频道的消息；如果要从 Telegram 私聊发送下载链接，还需要再绑定下载助手交互入口。

1. 在 Telegram 中打开 @BotFather，发送 /newbot，按提示创建机器人并复制 Bot Token。

2. 打开刚创建的机器人，先发送一条消息。使用 Chat ID 查询机器人或 Telegram Bot API 找到接收消息的 Chat ID：个人通常是一串正数，群组通常是一串负数。

3. 在 Mediora 中填写：

   Mediora 字段	怎么填写
   Bot Token	@BotFather 返回的完整 Token。
   Chat ID	接收通知的个人、群组或频道 Chat ID。
   代理 API 地址	通常留空，默认使用 https://api.telegram.org；只有使用兼容 Telegram Bot API 的代理时才填写代理地址。

4. 将“启用”设为“是”，保存后点击“测试”。确认机器人已经被允许向目标群组或频道发消息；向频道发送消息时，通常还需要先把机器人加入频道并授予发消息权限。

如果要使用下载助手的 Telegram 私聊交互：先在“存储管理 → 下载助手 → 使用设置 → 交互入口”绑定这个已启用的 Telegram 配置。保存后 Mediora 会自动向 Telegram 注册 Webhook，页面会显示生成的回调地址。该地址不是上面的企业微信地址，而是包含交互入口 ID 和随机密钥的专用地址；必须为公网 HTTPS，端口只能使用 80、88、443 或 8443。

PushPlus

PushPlus 只负责把 Mediora 的通知推送到微信等接收端，不接收 Mediora 的回调，所以不需要填写回调地址，也不需要配置公网域名。

1. 登录PushPlus，在个人中心复制“用户 Token”。
2. 在 Mediora 的 PushPlus 配置中填写“用户 Token”。
3. 如果要把消息发送到 PushPlus 群组，再填写“群组编码（Topic）”；只发给自己的微信时留空。
4. 将“启用”设为“是”，保存并点击“测试”。

PushPlus 测试成功但工作流没有消息时，检查工作流中的“通知”步骤是否已启用，并确认该渠道仍处于启用状态。

常规设置

字段	什么时候填写	影响
访问域名	需要固定访问地址时填写完整地址，例如 https://media.example.com 或局域网的 http://192.168.1.20:3000；不能只写域名。	用于生成链接、企业微信回调和 Telegram 下载助手 Webhook；Telegram 入站交互需要公网 HTTPS 地址。PushPlus 仅发送通知，不需要回调地址。
API 令牌	外部服务调用消息接收入口时使用，可复制或重置。	使用 Authorization: Bearer 请求头，不放进 URL；重置后旧令牌立即失效。它与企业微信 Token、智能体凭证不同，普通网页不需填写。
代理服务器	Mediora 访问外部服务需要走网络代理时填写。	会用于访问如 TMDB 等外部服务；可用“测试连接”检查。
页签激活刷新	通常保持开启。	浏览器从后台切回页面时自动刷新当前页面的主要数据；关闭后需要手动刷新。

通知投递记录与重试

通知页的投递记录用于查看下载助手和工作流等已接入事件的各渠道结果，不是所有历史消息的完整收件箱。失败时先修复渠道配置，再从原记录重试；如果对方已收件但成功回执未能保存，重试仍可能重复发送。

发送测试消息成功只证明出站通知可达，不证明企业微信 / Telegram 的入站私聊回调已经可用。入站交互还需在下载助手绑定入口，并完成公网地址和渠道侧设置。

凭据	用在哪儿
Mediora API 令牌	普通外部消息接收请求的 Bearer 请求头。
企业微信 Token / EncodingAESKey	企业微信签名校验与消息解密。
Telegram Bot Token	Telegram 机器人连接和 Webhook 注册。
Agent 手动凭证 / 浏览器授权	智能体 MCP 接入。

保存提示配置已被其他页面修改时，先重新读取并核对差异再保存；不要凭旧页面反复覆盖。更换服务地址后，原密码或密钥的掩码不能作为新服务的完整凭据，按页面要求重新填写。