> 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/permissions.md).

# 指令權限設定（permissions）

**Permissions 讓伺服器管理員決定哪些身份組可以使用 Miulien 的特定指令。** 不需要為了開放某一項 Bot 功能，就把 Discord 的管理權限一併交給使用者。

例如，想讓協助管理自動回覆的成員使用 Reply，可以透過 Permissions 對指定身份組進行**額外指令授權**，無須直接授予該身份組「管理訊息」權限。

## 🔐 Permissions 能做什麼？

* **依指令授權**：每項指令可以設定不同的允許身份組，不需要全伺服器共用一套名單。
* **多個身份組**：同一項指令可以授權給多個身份組；成員擁有其中任一個符合條件的身份組，即可取得該項 Miulien 額外授權。
* **隨時調整**：可以新增、移除單一身份組，或一次清除某項指令的全部額外授權。
* **集中查看**：可透過「查看全部限制／查看全部」檢視目前設定過的指令與身份組。
* **配合功能擴充**：設定面板會從 Miulien 已註冊的指令產生清單，因此不需要自行輸入指令名稱，也不必依賴固定的支援指令表。

這套系統是**額外授權**，不是「僅限白名單使用」的封鎖機制。原本已符合指令要求的 Discord 權限者，不會因為不在額外授權名單內而失去使用資格。

## ⚙️ 如何設定？

1. 在 Discord 伺服器內輸入 `/permissions` 或 `m!permissions`，開啟指令權限管理面板。
2. 從指令清單選擇要設定的功能；指令較多時可切換頁面。
3. 使用「**新增允許使用的身份組**」選取要授權的身份組。
4. 如需收回額外授權，可使用「**移除已允許的身份組**」，或按「**清除授權**」移除該指令的全部額外授權。
5. 使用「**查看全部**」確認目前的授權設定。

管理的是**身份組**，不是單獨指定某位使用者。當使用者取得或失去該身份組時，對應的額外指令使用資格也會跟著改變。

## 🛡️ 與 Discord 原生權限有什麼不同？

| 項目          | Discord 原生權限          | Miulien Permissions             |
| ----------- | --------------------- | ------------------------------- |
| 作用範圍        | Discord 伺服器及頻道中的操作權限  | Miulien 支援額外授權的指令               |
| 設定方式        | 修改 Discord 身份組或頻道權限   | 在 Miulien 的 Permissions 面板授權身份組 |
| 是否改變身份組原有權限 | 會，依管理員設定而定            | **不會**                          |
| 適合用途        | 管理訊息、管理頻道等 Discord 操作 | 只開放特定 Bot 管理功能                  |

**重要：** 額外授權只能替代指令中支援此機制的**使用者權限檢查**，不代表取得 Discord 原生管理權限。若 Miulien 自己缺少執行操作所需的權限，指令仍可能無法正常完成。

此外，沒有設定額外身份組授權的指令，仍依原本的 Discord 權限要求運作。

## 👑 誰能管理授權？

使用 `/permissions` 設定指令授權，必須擁有 Discord 的\*\*「管理伺服器」\*\*權限，並且只能在伺服器內操作。

* 不能使用 Permissions 的額外身份組授權，來取代管理 Permissions 本身所需的「管理伺服器」權限。
* `@everyone` 不會被加入額外授權清單，以免變成對所有成員開放。
* 若已授權的身份組在 Discord 中被刪除，Miulien 會清理對應的授權紀錄。

> **建議做法：** 只授權真正需要操作該功能的身份組，並定期使用「查看全部」確認設定。
