历史记录命令

查询某位成员在你的服务器上有哪些审核记录，让成员查看自己的记录，并在成员已经改过自新时清除其已结束的记录。

有三个命令可以做到：/history（工作人员）、/my-history（任何人）和 /clear-history（工作人员，会删除）。

🔎 查看成员的记录：/history

1. 复制该成员的 Discord 用户 ID：在 Discord 中开启 开发者模式（Developer Mode，位于用户设置的高级选项），右键点击该成员，选择 复制用户 ID（Copy User ID）。
2. 输入 /history，把 ID 粘贴到 user_id，按回车。
3. 机器人只对你私下回复，按从新到旧显示 最近 10 条 记录。

每一行形如：

1. BAN 🔴 (3d) - spamming invites - 2 hours ago #418

• 类型用大写（BAN、MUTE、KICK、WARN、SOFTBAN、UNBAN、UNMUTE）
• 记录仍然 生效 时显示 🔴
• 封禁、静音和软封禁的时长放在括号里
• 原因，或者“No reason”
• 发生的时间
• # 之后的案件编号。用 /reason 修改记录的措辞时要用到这个编号

你需要 Discord 的 Kick Members 权限才能看到该命令。面板上有内容更详细的同一份列表：审核 → 历史 标签页，每条记录一行的表格，可以按类型和状态筛选。

🙋 让成员查看自己的记录：/my-history

任何人都可以输入 /my-history。机器人会私下向他们显示服务器保存的关于 他们自己 的最近 10 条审核记录。这是解决“我当时因为什么被警告？”这类疑问的快捷方法，不用去打扰工作人员。

• 需要在你的服务器上启用 审核 功能。如果关闭，成员会收到相应的提示。
• 它会忽略你的 允许的审核员身份组 设置：不需要任何身份组。
• 如果设置了文本命令前缀，!my-history 也可以使用，但文本回复无法做到私密：机器人会把它发在频道里，并在 30 秒后删除。
• 没有记录的成员会收到“You have no moderation records on this server.”（你在此服务器上没有审核记录。）

成员在面板上的个人页面我的处罚会列出所有服务器上的同样记录。

🧹 清除成员已结束的记录：/clear-history

/clear-history 会删除你服务器上某位成员所有 不再生效 的记录。当某人已经服满处罚、你想让他的档案干干净净时使用。

1. 确认该成员没有生效中的记录（见下文）。
2. 输入 /clear-history，把成员的用户 ID 粘贴到 user_id，按回车。
3. 机器人会回复 Cleared N inactive records for @member（已清除 @member 的 N 条失效记录）或 No inactive records found for @member（未找到 @member 的失效记录）。

此操作无法撤销。 记录是被删除，而不是被隐藏。

什么算失效

生效中的记录不会被动。如果你也想清掉成员的警告，请先在面板上 删除 它们，再运行 /clear-history。

谁可以使用

以下条件必须全部满足：

• 服务器上已 启用 审核功能
• 此人拥有 Discord 的 Ban Members 权限（注意：比 /history 所需的 Kick Members 更高）
• 如果你在审核设置中设定了 允许的审核员身份组（斜杠命令），他们还必须拥有其中一个身份组

在面板上执行同样的操作

审核 → 历史 标签页，然后在该成员任意一条已结束（不生效）的记录上点击 清除全部：点击一次，再在显示 再次单击确认 时点击第二次。它会删除该成员所有已结束的记录，与命令执行的删除相同。

面板按钮会在你服务器的活动日志中写入一行（“Cleared N inactive sanction(s)...”），如果你设置了审核日志频道，也会在那里发布。/clear-history 命令 两者都不会做：它不会在活动日志中留下条目，也不会在日志频道发布任何内容。如果你的团队想要一份看得见的记录，请使用面板按钮，或者手动在日志频道里写一行。

💡 示例

某位成员在三月被警告了两次，四月被静音一天。现在是十月，他们表现良好。

1. /history user_id:123456789012345678 显示：MUTE（1d，无圆点，已结束）、WARN 🔴、WARN 🔴。
2. 两条警告仍是 🔴，所以单独运行 /clear-history 只会删除那条静音。
3. 在面板上：审核 → 历史 标签页，找到该成员，在每条警告所在行点击 删除。
4. 现在运行 /clear-history user_id:123456789012345678。机器人回复 Cleared 3 inactive records，该成员的档案就清空了。

🔧 出现问题时

🚨 “The Moderation feature is not enabled for this server”

在面板中开启该功能，然后再试一次。消息里包含链接。

🚨 “You do not have a role that is allowed to use moderation commands on this server”

你的服务器把审核命令限定给了某些身份组。请让管理员把你的身份组加入 允许的审核员身份组（斜杠命令），或者清空这份列表。

🚨 我在命令列表里看不到 /clear-history

Discord 会对没有 Ban Members 权限的人隐藏它。服务器管理员也可以在 服务器设置 → 整合 → YAWBDB（Server Settings → Integrations → YAWBDB）中更改谁能看到它。

🚨 显示“No inactive records found”，但 /history 里有记录

这些记录仍然生效。请先在面板上解除或删除它们（警告和软封禁只能手动删除）。

🚨 “Failed to clear history”或“Server not registered in panel”

机器人无法连接面板，或者该服务器尚未连接到面板。请一分钟后再试；如果服务器是新添加的，请先完成连接。

🚨 我清除了错误的成员

无法恢复。请根据你自己的笔记或活动日志重新创建这些记录；活动日志只会为从面板执行的清除保留一行。

🚨 /my-history 提示服务器未注册

原因同上：服务器没有连接到面板。