> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 播客通知

> 在您的 Discord 服务器中公告新的播客剧集，附带封面和剧集详情。

<Info>
  需要 **Basic**。每服务器最多 **10 个播客**。共享规则请参见 [通知如何工作](/zh-CN/notifications/overview)。
</Info>

## 添加播客

按名称搜索。Vetox 在播客目录中查找节目并存储其动态。

## 设置

| 设置             | 默认值        | 说明              |
| -------------- | ---------- | --------------- |
| **Discord 频道** | —          | 必需              |
| **新剧集时通知**     | **开启**     |                 |
| **自定义消息**      | 无          | 纯文本，最长 2,000 字符 |
| **提及角色**       | 无          |                 |
| **自定义通知嵌入**    | Podcast 默认 | 紫色              |

## 变量

| 变量                      | 解析为  |
| ----------------------- | ---- |
| `{episode.title}`       | 剧集标题 |
| `{episode.url}`         | 剧集链接 |
| `{episode.description}` | 剧集说明 |
| `{podcast.name}`        | 节目名  |

<Warning>
  **提供的三个变量从不产生值：**

  | 变量                   | 行为                           |
  | -------------------- | ---------------------------- |
  | `{episode.duration}` | 始终为空 —— 剧集长度未从动态中读取          |
  | `{podcast.author}`   | 始终为空                         |
  | `{podcast.artwork}`  | 除非动态本身携带频道级封面，否则为空；目录的封面不被使用 |

  它们出现在变量下拉菜单中但解析为空，**任何仅由它们构建的嵌入字段会被从消息中丢弃**。这是播客嵌入到达时字段少于预期的最常见原因。

  请不要围绕它们构建嵌入。
</Warning>

<Tip>
  可靠的播客嵌入使用 `{episode.title}` 作为标题，`{episode.description}` 作为正文，`{episode.url}` 作为链接，`{podcast.name}` 位于页脚。其他一切都不可靠。
</Tip>

## 会公告什么

每 **5 分钟** 检查一次，每个节目 **5 分钟冷却**，直接读取节目的动态而非目录。

行为与 [RSS](/zh-CN/notifications/rss) 相同：无每轮询上限、对可读日期的项目有 2 小时年龄截断，以及 7 天已见列表。节目动态同样受这些抓取上限约束 —— 必须在 10 秒内响应、小于 5 MB，且重定向不超过 3 次。

<Note>
  如果您添加节目时目录查询失败但动态有效，播客仍会被添加 —— 但它可能列在其动态 URL 下而非名称。如果名称看起来不对，请移除并重新添加。
</Note>

## 疑难解答

<AccordionGroup>
  <Accordion title="时长字段从未出现">
    `{episode.duration}` 始终为空，其字段被丢弃。请将其从嵌入中移除。
  </Accordion>

  <Accordion title="封面缺失">
    只使用动态内的频道级封面。许多动态不包含它。请改用嵌入中的静态图片 URL。
  </Accordion>

  <Accordion title="节目列在 URL 下而非名称">
    动态成功但目录查询失败。请移除并重新添加。
  </Accordion>

  <Accordion title="什么都没到达">
    服务器设置的播客开关、高级会员，以及频道的嵌入链接权限。
  </Accordion>
</AccordionGroup>

<Card title="RSS" icon="rss" horizontal href="/zh-CN/notifications/rss">
  直接跟踪播客动态可获得更可靠的变量。
</Card>