> For the complete documentation index, see [llms.txt](https://miulien.gitbook.io/bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://miulien.gitbook.io/bot/utilities/logs.md).

# 監聽紀錄（logs）

使用 `/logs` 或 `m!logs` 設定 Discord 伺服器的即時事件紀錄，把指定監聽頻道的事件傳送到指定輸出頻道。

## 支援類型

* `message`（🗑️ 訊息刪除）：若原訊息仍在快取，可記錄作者與原始內容；否則只提供可取得的識別資訊。
* `edit`（✏️ 訊息編輯）：紀錄編輯前、後內容與訊息連結。
* `reaction`（↩️ 反應撤回）：紀錄撤回成員、表情與原訊息連結。

## 指令操作

* `/logs` 或 `m!logs`：一次查看三種紀錄的目前設定。
* `status`：查看指定種類的監聽與輸出頻道。
* `set`：指定監聽頻道及輸出頻道，開始監聽。
* `off`：有指定監聽頻道時僅停止該頻道；未指定時關閉該種類全部監聽。

前綴指令範例：`m!logs reaction set #聊天頻道 #紀錄頻道`。也可以用 `m!logs edit status` 查看編輯紀錄狀態。

## 權限與限制

需要伺服器的**管理訊息**權限，或透過 `permissions` 明確授權。監聽與輸出頻道不能相同；Miulien 必須可以查看監聽頻道並在輸出頻道傳送訊息。

資料庫只保存監聽／輸出**設定**，不保存事件歷史。刪除訊息若不在快取中，就無法恢復原始內容；實際紀錄也受 Discord 權限和事件資料限制。
