Fjord 文档
模块
01
欢迎
欢迎新成员、送别离开的用户，并自动分配身份组。
包含的功能
- 自定义欢迎和告别消息
- 自定义欢迎卡片
- 为新成员自动分配身份组
- 为加入和离开分别设置频道
02
自动管理
AutoMod 检测不需要的内容并按照服务器规则采取操作。
- 针对内容、刷屏、链接和提及的十种过滤器
- 分别设置身份组和频道的适用范围
- 最多十级警告，可删除内容、禁言、踢出或封禁
03
活动日志
在选定的 Discord 频道中清晰记录重要事件。
- 支持 89 种事件类型
- 共用一个日志频道
- 可单独启用的日志
04
嵌入内容
使用可视化编辑器创建结构化消息，无需编写 JSON。
- 标题、描述、字段和媒体
- 编辑时实时预览
- 保存并再次编辑
自选身份组
成员通过按钮和下拉菜单选择身份组。配置身份组组合、V1/V2 消息以及可管理的发布消息。
包含的功能
- 两种格式均支持预览、强调色、图片、多个嵌入内容及展开、复制、删除、排序嵌入。V1 使用 Discord 固定字段，V2 使用自由排列的块。后续章节说明输入内容及差异。
- 身份组按钮支持标签、表情、四种样式及每个选项一个或多个身份组
- 下拉菜单支持提示文本、描述、表情及单选或多选
- V1 支持在整条消息下方添加多个独立身份组选择器，共用最多五个操作行。每个菜单占一行，最多五个按钮共用一行。因此只有没有额外按钮行时才能使用五个菜单。每个选择器最多 25 选项。V2 的每个容器有自己的按钮或菜单选择器，计入共用组件额度。移动 V1 嵌入不会移动独立选择器。本模块提供蓝、灰、绿、红身份组按钮，但没有网站链接按钮编辑器和单次发送。
- 实时预览可模拟身份组选择，不会更改成员的真实身份组
- 命名和复制消息组合、保存草稿、发布和更新消息以及移除发布消息
- 提供身份组权限和层级、图片大小、文本上限及共享组件上限的说明
05
设置
在设置中，你可以选择语言、时区和嵌入消息的默认颜色，委派控制面板访问权限，并管理已保存的模块数据。
- 机器人嵌入消息的默认颜色
- 语言和时区
- 委托管理控制面板
- 管理已保存的模块数据
06
命令
Fjord 的所有斜杠命令、所需权限及故障排查方法。
使用斜杠命令
斜杠命令属于 Fjord 本身，不需要在控制面板中开启独立模块。在 Discord 服务器频道输入 /，搜索并选择命令。Discord 随后会显示可用参数。
- 选择正确的服务器，以及允许你使用命令的频道。
- 输入 / 并选择 Fjord 命令。填写 user 等必填参数。
- 发送前核对目标用户、时长和可选原因。
- 阅读 Fjord 的回复。缺少权限或条件时，回复也会说明。
条件与权限
这些命令只能在服务器中使用。审核命令会在执行时检查调用者权限。能看到命令并不代表有权使用。服务器所有者执行大多数审核命令时不受自身身份组权限限制。
| 命令 | 你的权限 | Fjord 需要 |
|---|---|---|
/help | 所有服务器成员 | 无需额外的审核权限 |
/ban | 封禁成员 | 封禁成员 |
/kick | 踢出成员 | 踢出成员 |
/mute | 管理成员 | 管理成员 |
/unmute | 管理成员 | 管理成员 |
/warn | 管理消息 | 如配置了后续操作，需有相应的管理、踢出或封禁权限 |
/warnings | 管理成员 | 无需额外的审核权限 |
/clear-last-violation | 管理消息 | 无需额外的审核权限 |
/clear-all-violations | 管理员或服务器所有者 | 无需额外的审核权限 |
/user-profile | 所有服务器成员 | 无需额外的审核权限 |
ban、kick、mute 和 unmute 需要 Fjord 拥有相应的 Discord 权限。Fjord 的最高身份组必须高于目标成员的最高身份组。还会检查调用者的身份组顺序，服务器所有者除外。服务器所有者不能成为这些操作的目标。
全部命令
| 命令 | 作用 | 参数 |
|---|---|---|
/help | 列出可用的审核命令。 | 无 |
/ban | 封禁成员，并可删除其过去 0 至 7 天的消息。 | user 必填, reason 可选, delete_days 可选（0–7） |
/kick | 将成员踢出服务器。对方可通过新邀请返回。 | user 必填, reason 可选 |
/mute | 施加最长 28 天的 Discord 暂时禁言。 | user 必填, minutes、hours、days 可选，但合计至少 1 分钟, reason 可选 |
/unmute | 结束仍有效的暂时禁言。是 /mute 的反向命令。 | user 必填, reason 可选 |
/warn | 记录警告。已配置的警告等级可能触发额外操作。 | user 必填, reason 可选 |
/warnings | 显示成员的警告次数和历史。 | user 必填 |
/clear-last-violation | 删除成员最近一次记录的警告。 | user 必填 |
/clear-all-violations | 删除某成员的全部警告。不填 user 则删除全服务器的警告。 | user 可选, 不填则针对整个服务器 |
/user-profile | 显示可见的个人资料。警告历史仅本人或获授权的审核员可见。 | user 可选, 不填则查看自己 |
重要区别
/mute 的总时长至少 1 分钟，最多 28 天。/unmute 只对仍有效的暂时禁言起作用。
/warn 使用自动管理模块配置的警告等级。根据等级，Fjord 还可能执行暂时禁言、踢出或封禁。
/clear-last-violation 只删除最近一次警告。/clear-all-violations 删除所选成员的全部警告。不填 user 则删除全服务器的警告。
警告历史为空不会撤销过去的封禁或踢出。/unmute 只解除当前的暂时禁言。
排查问题
| 问题 | 检查与解决 |
|---|---|
| 找不到命令。 | 确认当前位于服务器、Fjord 已安装，且 Discord 已刷新斜杠命令。改名后的命令可能稍后才显示。 |
| Fjord 提示缺少权限。 | 检查你自己对该命令的权限，以及服务器设置中机器人对应的权限。能看到命令不代表有使用权。 |
| 身份组层级阻止操作。 | 将 Fjord 身份组移到目标身份组上方。除非你是服务器所有者，你的最高身份组也必须高于目标。 |
| Mute 拒绝时长。 | 输入至少 1 分钟、最多 28 天。三个时间参数全为 0 无效。 |
| /unmute 提示没有有效的暂时禁言。 | 检查成员是否仍处于 Discord 暂时禁言中。已到期的禁言无法再次解除。 |
| 警告缺失或无法删除。 | 检查目标用户和你的权限。/clear-last-violation 需要已有警告。/clear-all-violations 删除已保存的警告。 |
| Fjord 返回通用错误。 | 检查机器人权限、身份组和 Discord 服务状态。重试后仍失败，请联系支持。 |