Files
Auto_Bangumi/docs/en/dev/plugins/points/message-template.md
Estrella Pan 776abfa896 docs(4.0): 更新 API 参考与开发者文档,新增获取 SDK 页
- API 参考按实际路由重写,修正认证方式、请求方法与设置向导端点
- 数据库指南改为异步 Database 与 MIGRATIONS
- E2E 指南改为指向 e2e/README.md
- 插件快速上手补上安装 SDK 轮子的步骤,ab-plugin dev 加 --config-dir
- 发布流程改为手动推送标签触发
2026-10-08 17:36:53 +02:00

26 lines
1.3 KiB
Markdown

# Message Template (message_template)
A transform hook. Before AB pushes a system event to an external channel, the event passes through these hooks in order. A hook receives the default text, the event and the channel type. Return a new `RenderedMessage` to rewrite the text. `None` means no change.
```python
from ab_sdk import Plugin, hook, points
from ab_sdk.notify import RenderedMessage
class Alerts(Plugin):
@hook(points.MESSAGE_TEMPLATE)
def template(self, message: RenderedMessage, event, channel: str):
if event.kind != "rss_failure":
return None
if channel == "telegram":
return RenderedMessage(
f"[ALERT] {message.title}", f"<b>{event.rss_name}</b>\n{event.error}"
)
return None
```
- The hook affects only the external push. The frontend renders the text in the notification center from `i18n()`, so it does not change.
- AB calls the hook one time for each enabled channel. `channel` is the channel type, for example `telegram`.
- If a hook fails, times out or returns a value that is not a `RenderedMessage`, AB keeps the text of the previous step. The failure counts toward the breaker. The next hooks run as usual.
- "New episode" notifications do not pass through this hook yet. They still use the single-episode template of the notification channel.