模块

组合消息与身份组选择

两种格式均支持预览、强调色、图片、多个嵌入内容及展开、复制、删除、排序嵌入。V1 使用 Discord 固定字段，V2 使用自由排列的块。后续章节说明输入内容及差异。

设置身份组组合

只允许低于机器人最高身份组及你自身最高身份组的身份组，服务器所有者不受自身层级限制。@everyone、受管理身份组及具有服务器管理或审核权限的身份组，包括审计日志访问权限，都不能公开自选。无标签选项先选择身份组时，会自动填入首个身份组名作为可修改建议。本模块不动态替换成员及服务器占位符，但 V2 时间标记例外。

所需的 Discord 权限

Fjord 需要目标频道的查看频道、发送消息和嵌入链接权限，以及管理身份组权限。Fjord 的身份组必须高于所有待分配身份组。托管身份组、@everyone 和具有管理权限的身份组不可选择。

内部名称即使保存草稿也必填，最多 100 字符。没有目标频道时仅保存草稿。发布需要可访问频道及可见文本、嵌入内容或至少一个完整身份组选项。每个新增选项必须有 1–80 字符标签及 1–25 个可分配身份组。表情可选，最多 100 字符描述只在菜单显示。选择前的提示文本可选，最多 150 字符，留空使用默认值。多选时设置同时选择的最大选项数，最多 25。草稿中的不完整选项也必须补全或删除。

消息内容与提及

普通消息最多 2,000 个字符。使用插入工具，在光标处插入服务器身份组、频道和表情。此模块发布的提及不会发送通知，也不能代替身份组选项。

设计嵌入

只有同时填写作者名称时，Discord 才会显示作者图标。请在上方输入名称，使图标出现在预览中。 只有同时填写页脚文本时，Discord 才会显示页脚图标。请在上方输入文本，使图标出现在预览中。

V2

图片块可包含最多十张图片的图库。使用“+ 添加图片”添加图片，每张图片均可单独移除。每张图片和缩略图可选填最多 80 个字符的描述，并设置剧透。段落最多支持三个文本，每个最多 4000 个字符。使用“+ 添加文本”增加最多两个额外文本。在附加组件中选择缩略图或链接按钮。链接按钮必须填写最多 80 个字符的标签和最多 512 个字符的完整 HTTP(S) URL。表情符号及禁用选项为可选项。额外文本和附加按钮计入组件总数。图库中的单张图片不计为额外组件。

在 V2 中，可以将容器和图片（包括缩略图）标记为剧透。内容最初隐藏，点击后显示。

V2 提供最多十个容器，各有强调色。文本块或右侧可选缩略图的段落各支持最多 4000 个字符及 Markdown。分隔线可显示线条或仅留白，间距可选小或大。可添加、复制、删除及通过箭头排序块。空文本和图片块不会产生可见内容。 V2 文本区域提供身份组、频道及服务器表情选择器。

V2 没有经典作者字段、标题链接输入框、行内字段、页脚图标或时间戳开关。请在文本块中用 Markdown 设置标题及链接。下方示例可制作小号页脚，时间标记可插入时间戳。V1 不支持自由排列的 V2 块。同一条消息不能混合两种格式。

-# ... · {time.full}

V2 的整条消息合计最多 40 个组件。容器、文本、段落、缩略图、图片画廊、分隔线、操作行、按钮及菜单都分别计数。菜单选项不单独计数。自动添加的分隔线及控件也占用额度。例如，包含文本、图片、分隔线以及带操作行按钮的容器需要六个组件。 因此十个容器不能无限填充。

上传与检查图片

图片限制按每个文件计算。V1 作者图标、缩略图和页脚图标各最多 5 MB。大图上限与下方 V2 图片块上限相同。支持 PNG、JPG/JPEG、WebP 和 GIF。选择文件替换图片，删除清空位置。作者和页脚图标没有对应文本时不可见。

可选 PNG、JPG/JPEG、WebP 或 GIF，保存时上传图片。 缩略图最大 5 MB，图片块最大 8 MB。

身份组组合、按钮和下拉菜单

内部名称即使保存草稿也必填，最多 100 字符。没有目标频道时仅保存草稿。发布需要可访问频道及可见文本、嵌入内容或至少一个完整身份组选项。每个新增选项必须有 1–80 字符标签及 1–25 个可分配身份组。表情可选，最多 100 字符描述只在菜单显示。选择前的提示文本可选，最多 150 字符，留空使用默认值。多选时设置同时选择的最大选项数，最多 25。草稿中的不完整选项也必须补全或删除。

按钮切换其身份组组合。如果成员已拥有组合中的全部身份组，则移除它们；否则仅添加缺少的身份组。其他身份组不变。预览不会更改真实身份组。

设置按钮

选择按钮，添加选项并填写标签和身份组。可选择表情和四种样式之一。为其他组重复操作，并使用移动控件调整顺序。每个选项对应一个按钮，即使包含多个身份组。

设置选择菜单

多选的最大值可设置为 2–25 个选项。已有选项更少时，发送的消息自动将可选数量限制为实际选项数。

选择下拉菜单。每个选项设置身份组、标签，以及可选的描述和表情。菜单标签在选择前显示。启用多选后，成员可以同时选择多个选项。最大选择数量限制同时选中的选项，而非每个身份组包中的身份组数量。未启用多选时，成员可以选择一个选项。

菜单将整份提交的选择与成员身份组进行对照：添加缺少的已选身份组，保留已有的已选身份组，移除此菜单中未选择的身份组。空选择移除此菜单的全部身份组。菜单以外的身份组不变。对于重叠组合，只要某个已选选项需要共享身份组，该身份组就会保留。

勾选标记显示 Discord 客户端中的选择，并不一定表示当前身份组。重启客户端或使用其他客户端后，标记可能消失。在这种情况下只选择一个选项，会保留或添加该选项的身份组，并移除此菜单的其他身份组。再次选择已有身份组会保留它。机器人不会在操作后重置菜单。

组件 V1 / V2

V2 每个操作行同样最多五个按钮，菜单需要独立一行。V2 使用总组件额度，而非 V1 的五行上限。

新组合默认使用 V2。

首次保存前选择 V1 或 V2。保存后版本固定，草稿及移除发布后也无法更改。需要其他格式时请新建组合。复制会保留版本。已保存的 V1 消息不会自动转换或删除。

V1 支持在整条消息下方添加多个独立身份组选择器，共用最多五个操作行。每个菜单占一行，最多五个按钮共用一行。因此只有没有额外按钮行时才能使用五个菜单。每个选择器最多 25 选项。V2 的每个容器有自己的按钮或菜单选择器，计入共用组件额度。移动 V1 嵌入不会移动独立选择器。本模块提供蓝、灰、绿、红身份组按钮。没有用于额外网站链接按钮行的独立编辑器，也没有单次发送功能。不过，V2 分区可以使用链接按钮作为附件替代缩略图。此按钮打开网站，不修改身份组。

V1

V1 使用 Discord 经典嵌入内容，包含强调色和固定区域。最多十个嵌入内容。表中的数字是字符上限。所有嵌入内容的作者、标题、描述、页脚以及全部字段名和字段值合计最多 6000 个字符。普通消息文本有单独的上限。 每个 V1 嵌入最多支持 25 个字段。

所有设计区域均可选。添加字段后，字段名和字段值均为必填。请删除不用的字段。并排显示启用行内字段，实际布局由 Discord 和屏幕宽度决定。作者链接和图标需要作者名，标题链接需要标题，页脚图标需要页脚文本。可选链接必须是完整 HTTP(S) 地址。时间戳显示发送时间。

普通文本、V1 描述和字段值支持身份组及频道选择器。作者、标题、页脚和字段名不提供这些提及选择器，但可使用服务器表情。作者 URL 和标题链接只接受网址，不能插入身份组、频道或表情。经典嵌入内容中的提及不会发送通知。

限制和图片

每个服务器最多 50 个组合，每个组合最多十个嵌入。每个身份组选择最多 25 个选项。V2 总共最多 40 个组件，包含容器、文本、图片、操作行和控件。菜单选项不单独计数。图片文件最多 8 MB。保存前请检查组件预算。

使用 Discord 预览

预览按所选格式显示文本、顺序、图片和控件。打开菜单或点击按钮可模拟选择，不会改变真实成员的身份组。先加载服务器资源以使用身份组和表情。发布后请在 Discord 中测试实际分配。

管理嵌入

展开嵌入即可编辑，也可排序、复制和删除。复制 V2 容器时会复制其身份组控件。删除容器也会删除这些控件。超过嵌入或组件限制的复制操作会被阻止。

组合的内部名称最多 100 个字符，仅在控制面板显示。副本独立于原始组合。发布前检查频道和选项。保存应用修改，取消放弃待保存的修改。

编辑其他组合、创建新组合、复制或删除前，请先保存或放弃待保存的修改。

管理草稿和发布消息

不选择目标频道时保存为草稿。选择频道后，保存会发布消息，后续修改更新同一条消息。更换频道时先在新频道发布，再移除旧消息。再次保存会重新发布已丢失的 Discord 消息。修改仅在保存后生效。

移除发布只删除 Discord 消息并保留草稿。删除组合也会移除关联的发布消息。复制会创建独立副本，其发布需单独设置。

排查问题

如果缺少身份组，请检查管理身份组权限、层级及目标身份组的管理权限。发布失败时检查频道和权限。超出组件预算时删除部分元素。请在 Discord 中使用普通成员测试分配。控制面板预览不会更改成员身份组。

要求与限制

有效设计不需要填写所有可选区域。仅颜色或空块不能代替发布所需的可见内容。预览不会发送消息，也不能代替目标频道的实际测试。两个编辑器都不提供投票、贴纸、表单或自由编程的操作。数据及编辑权限也取决于你获得的控制面板授权。

预览、剧透与图片文件

V2 预览中的单张图库图片保留原始宽高比。多张图片以统一的 16:9 裁切区域组成网格。两张或四张图片使用两列，三张以及五至十张图片使用三列。缩略图位于分区文字右侧。图片描述用作替代文字，不会成为额外可见的图片说明。

图片和容器的剧透开关属于 V2 编辑器。每张图库图片及缩略图可以独立隐藏。容器剧透隐藏内容，但保留可见的外框。点击会在预览中显示内容，不会更改已保存的剧透设置。成员也可以在 Discord 中点击显示剧透内容。

消息图片支持 PNG、JPG/JPEG、WebP 和 GIF。文件类型必须与图片内容一致。更改 HTML 或 SVG 文件的扩展名不会让它成为受支持的图片。图片表格中的大小限制仍适用于每个文件。如果本地图片被拒绝或无法读取，请重新选择原始文件并再次保存。

Markdown 文字区域支持网页和电子邮件链接。预览可以打开 HTTP(S) 和 mailto 链接，但不会打开本地文件或 Blob 地址。作者链接、标题链接和链接按钮必须使用完整的 HTTP(S) URL。预览不会发布消息。请在 Discord 中检查保存后的结果，显示效果可能因客户端和屏幕宽度而异。