mirror of
https://github.com/ReCloudStudio/WebHooker.git
synced 2026-09-22 16:11:29 +00:00
RhenCloud
3f6f7f17b5
- forgeSources entries are now { host, type, name? }: the repository URL's
hostname is matched case-insensitively against host (github.com for GitHub,
distinct hosts for multiple Gitea instances); the footer label is the
optional name, falling back to the host
- GroupEditor renders one row per source: host input + type select + optional
display name (grid layout); hostname validation mirrors the server
- fix: apiFetch sends Content-Type: application/json — h3's readBody only
parses JSON bodies with that header, so every PUT/POST from the refactored
console arrived as a raw string and failed with 'groups must be an array'
- hardening: readJsonBody (admin + actions) JSON-parses string bodies so curl
and older clients without the content-type header still work
- regression test: groups PUT without content-type + forgeSources round-trip
- docs: groups.md/message-format.md (en/zh), AGENTS.md, config.example.yaml
36 lines
2.1 KiB
Markdown
36 lines
2.1 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)。
|
||
|
||
## 来源平台标识
|
||
|
||
设置 `Group.forgeSources`（一组 `{ host, type, name? }` 条目）后，消息底部会标注匹配的来源——即 `type`（`github` / `gitea`）与事件来源一致、且 `host` 与仓库 URL 主机名一致的第一条配置，标识文本为其可选 `name`（未填回退为 host）——便于区分来自不同 forge 的事件。见[分组 → 来源平台标识](./groups#来源平台标识)。
|
||
|
||
## 原地更新
|
||
|
||
`workflow_run` 与 `check_run` 消息只发送一次，随运行进度原地编辑（queued → running → success/failure），不会重复发消息。追踪使用 KV `msg:*` 与每次运行的稳定 `updateKey`。
|