> ## 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.

# RSS 通知

> 在您的 Discord 服务器中公告任何 RSS 或 Atom 动态的新条目。

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

RSS 是万能选项。只要网站发布动态，Vetox 就能公告它 —— 博客、更新日志、新闻站、论坛版块、发布说明。

## 添加动态

粘贴动态 URL。Vetox 保存前会先获取并解析它；任何不可读的动态会以 **Invalid RSS feed URL or unable to parse feed** 被拒绝。

<Tip>
  请使用动态 URL，而非站点 URL。它通常以 `/feed`、`/rss`、`/atom.xml` 或 `/index.xml` 结尾。如果不确定，请查看页面源代码并查找 `application/rss+xml` 链接。
</Tip>

## 设置

| 设置             | 默认值    | 说明                          |
| -------------- | ------ | --------------------------- |
| **Discord 频道** | —      | 必需                          |
| **新条目时通知**     | **开启** |                             |
| **自定义消息**      | 无      | 纯文本，最长 2,000 字符 —— 仅两个平台有此项 |
| **提及角色**       | 无      |                             |
| **自定义通知嵌入**    | RSS 默认 | 橙色                          |

## 变量

| 变量                   | 解析为       |
| -------------------- | --------- |
| `{item.title}`       | 条目标题      |
| `{item.url}`         | 条目链接      |
| `{item.description}` | 条目摘要或正文   |
| `{item.author}`      | 作者        |
| `{feed.name}`        | 动态标题      |
| `{feed.url}`         | 动态的站点 URL |

<Note>
  `{item.description}` 携带多少文本完全取决于发布者。有些动态给一行摘要，另一些给完整文章。Vetox 不会截断它，但 Discord 的 4,096 字符描述限额会应用。
</Note>

## 会公告什么

每 **5 分钟** 检查一次，每个动态 **5 分钟冷却**。

<Warning>
  **RSS 没有每轮询上限。** 其他平台查看最新的 5 个条目；RSS 将动态中的每个条目都视为候选。

  实际中 2 小时年龄截断和 7 天已见列表将其控制在合理范围内。但一个动态如果突然用新日期重新发布许多条目，可能产生一波公告。
</Warning>

<Note>
  没有可读发布日期的条目会绕过 2 小时年龄截断。因此格式不佳的动态可能公告较旧的条目。如果动态反复出现这种情况，那是动态的缺陷，而非 Vetox 的。
</Note>

Vetox 使用条件请求，因此未变化的动态检查开销几乎为零。

## 真实示例

<AccordionGroup>
  <Accordion title="游戏补丁说明">
    许多工作室发布更新日志动态。这通常比 Steam 集成更好，因为它只承载官方帖子。
  </Accordion>

  <Accordion title="状态页">
    大多数状态页公开动态。将其路由到员工频道，可以及早预警影响您社区的中断。
  </Accordion>

  <Accordion title="博客或简报">
    `{item.title}` 作为嵌入标题，`{item.description}` 作为正文，`{item.url}` 作为链接。
  </Accordion>
</AccordionGroup>

## 疑难解答

<AccordionGroup>
  <Accordion title="动态无法保存">
    Vetox 必须能够立刻获取并解析它。请在浏览器中检查 URL —— 如果它呈现为网页而非 XML，就不是动态 URL。

    抓取本身同样有上限。如果动态在 **10 秒**内没有响应、体积超过 **5 MB**，或重定向超过 **3 次**，都会被拒绝。地址必须是 `http://` 或 `https://`，并且要解析到公网主机 —— 私有、本地或内网地址会被拒绝。
  </Accordion>

  <Accordion title="旧条目被公告">
    该动态不提供可用的发布日期，因此年龄截断无法应用。
  </Accordion>

  <Accordion title="一次到达一波公告">
    发布者重新为多个条目设置了日期。除每动态冷却外没有速率限制。
  </Accordion>

  <Accordion title="描述为空">
    该动态未包含描述。请改用 `{item.title}` 和 `{item.url}`。
  </Accordion>
</AccordionGroup>

<Card title="播客" icon="podcast" horizontal href="/zh-CN/notifications/podcasts">
  同一动态机制的专门化视图。
</Card>