mirror of
https://github.com/ReCloudStudio/WebHooker.git
synced 2026-09-22 16:11:29 +00:00
32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# 消息格式
|
||
|
||
每个事件格式化器都会产出一条平台中立的消息（`NeutralMessage`），由平台驱动渲染为 Discord 嵌入或 Telegram HTML 消息。
|
||
|
||
## 标题
|
||
|
||
每个标题必须以仓库名开头，随后是可选的 `#number`，再是 `: 描述`：
|
||
|
||
```
|
||
{repo}{#number}: {subject} 例如 acme/widget#7: Add feature
|
||
```
|
||
|
||
仓库名取自 `payload.repository.full_name`（缺失时回退为通用的「repository」标签）。评论、审查与行内评论使用与其父对象相同的 `{repo}{#number}: {title}` 标题——绝不使用 `"Comment on org/repo"` 前缀。
|
||
|
||
## 链接
|
||
|
||
只有仓库头会被加超链接——整条标题永远不会整体链接：
|
||
|
||
- **Discord**（嵌入标题不支持局部链接）：标题为仓库头 `{repo}{#number}`，链接到仓库；`: {subject}` 文本作为描述首行渲染，不带链接。
|
||
- **Telegram**（HTML 支持行内链接）：单行标题保留描述文本，仅仓库头被包在链接中。
|
||
|
||
标题中不含冒号分隔符（`:` 后跟一个空格）的消息保持旧的整行链接行为。
|
||
|
||
提交哈希、分支与标签渲染为带超链接的行内代码（如 ``[`abc123d`](https://…/commit/abc123def456)``），仓库基地址不可用时回退为纯行内代码。
|
||
|
||
## 表情
|
||
|
||
事件专属表情由格式化器添加；分组级 `Group.emoji`（默认开启）关闭后会全部去除。里程碑进度条不受影响。见[消息语言](./i18n)。
|
||
|
||
## 原地更新
|
||
|
||
`workflow_run` 与 `check_run` 消息只发送一次，随运行进度原地编辑（queued → running → success/failure），不会重复发消息。追踪使用 KV `msg:*` 与每次运行的稳定 `updateKey`。
|