消息格式
每个事件格式化器都会产出一条平台中立的消息(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(默认开启)关闭后会全部去除。里程碑进度条不受影响。见消息语言。
来源平台标识
设置 Group.forgeSources(一组 { host, type, name? } 条目)后,消息底部会标注匹配的来源——即 type(github / gitea)与事件来源一致、且 host 与仓库 URL 主机名一致的第一条配置,标识文本为其可选 name(未填回退为 host)——便于区分来自不同 forge 的事件。见分组 → 来源平台标识。
原地更新
workflow_run 与 check_run 消息只发送一次,随运行进度原地编辑(queued → running → success/failure),不会重复发消息。追踪使用 KV msg:* 与每次运行的稳定 updateKey。