Skip to content

消息格式

每个事件格式化器都会产出一条平台中立的消息(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? } 条目)后,消息底部会标注匹配的来源——即 typegithub / gitea)与事件来源一致、且 host 与仓库 URL 主机名一致的第一条配置,标识文本为其可选 name(未填回退为 host)——便于区分来自不同 forge 的事件。见分组 → 来源平台标识

原地更新

workflow_runcheck_run 消息只发送一次,随运行进度原地编辑(queued → running → success/failure),不会重复发消息。追踪使用 KV msg:* 与每次运行的稳定 updateKey

基于 MIT 许可发布。