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

# 查詢資訊（id）

Miulien 的 `/id` 不只是查看 Discord ID，也能查詢**使用者、身份組、自訂 Emoji 和伺服器**的詳細資料。支援名稱、部分名稱、ID 搜尋，不必特別開啟 Discord 開發者模式。

## 🔎 使用方式

| 想查什麼     | 指令範例                                                          |
| -------- | ------------------------------------------------------------- |
| 自己的資訊    | `/id` 或 `m!id`                                                |
| 指定使用者    | `/id search:使用者名稱` 或 `m!id @使用者`                              |
| 身份組      | `/id category:身份組 search:管理員` 或 `m!id role 管理員`               |
| 自訂 Emoji | `/id category:自訂 Emoji search:miulien` 或 `m!id emoji miulien` |
| 目前伺服器    | `/id category:伺服器` 或 `m!id server here`                       |
| 其他伺服器    | `/id category:伺服器 search:名稱或ID` 或 `m!id server 名稱`            |

Slash 指令可選擇**分類**並填入**搜尋文字**。未指定分類時，預設以使用者為搜尋目標；文字指令可使用 `role`、`emoji`、`server` 等前綴切換搜尋類型。

## 🪪 使用者資訊

查詢伺服器成員時，Miulien 會顯示：

* **伺服器暱稱、使用者名稱、全域顯示名稱**與使用者 ID。
* **帳號建立日期**及**加入目前伺服器的日期**。
* 成員持有的**身份組**與帳號頭像；機器人帳號會標示為機器人資訊。

**查看全部身份組**：首頁預設列出最高的 10 個身份組；如果持有更多身份組，可以按「查看全部身分組」逐頁瀏覽。

**查看持有權限**：按「查看持有權限」後，可切換**一般權限、文字權限、語音權限**，每頁顯示最多 10 項。這裡查看的是成員的**有效伺服器權限**，不是單一身份組的原始權限。

若成員已擁有 Discord 的「管理員」權限，頁面會標示該分類擁有全部權限。

## 🎭 身份組資訊

查詢身份組時，可以查看：

* **身份組 ID**與可複製的提及格式。
* 身份組在伺服器內的**排序位置**（例如第 3 高）。
* 是否開放一般成員**提及該身份組**。
* 按下「查看身份組權限」後，分頁瀏覽該身份組本身的**一般、文字及語音權限**。

也會附上能搭配 Reply 使用的 `{hasrole}` 判斷範例，方便管理員製作依身份組觸發的自動回覆。

**注意：** 身份組排序位置代表階層高低，**不代表持有的權限一定比較多**；實際權限請使用「查看身份組權限」確認。

## 😀 自訂 Emoji 資訊

查詢伺服器的自訂 Emoji 時，可以取得：

* **Emoji ID**、名稱與 Discord 自訂表情代碼。
* 是否為**動態表情**，並顯示表情圖片。
* 可直接參考的 Reply `{react}` 模板範例。

這特別適合想在 Reply 使用自訂表情，卻不知道表情 ID 或完整代碼的管理員。

## 🏠 伺服器資訊

查詢伺服器時，可查看伺服器名稱、ID、建立日期、擁有者資訊，以及**成員數、頻道數、身份組數、自訂 Emoji 數與加成等級**。

* 使用 `m!id server here` 可以查看**目前伺服器**。
* 依名稱搜尋其他伺服器時，只會搜尋 **Miulien 已加入**的伺服器。
* 若提供精確的其他伺服器 ID，且該伺服器開放 Discord 公開預覽，Miulien 可能提供**有限的公開預覽資料**；不代表 Miulien 已加入該伺服器。

## 🧭 搜尋與操作小技巧

* **使用者搜尋**支援 Discord ID、使用者名稱、伺服器暱稱及全域顯示名稱；也支援部分文字比對。
* 搜尋身份組或 Emoji 時，可輸入**完整 ID、名稱或部分名稱**；身份組提及、自訂 Emoji 代碼也能用於對應搜尋。
* **找到多個結果時**，可以直接透過下拉選單選取；若匹配數量超過 **25 個**，需要縮小搜尋範圍。
* 若輸入的使用者 ID 對應到**已存在的 Miulien 經濟帳戶**，即使對方目前不在這個伺服器，仍有機會取得其 Discord 帳號的基本資訊；此時不會提供不存在的伺服器成員資料。
* `/id` 僅能在**Discord 伺服器**使用。資訊面板主要用來**查詢**，不會直接修改身份組或權限。

> 延伸功能：使用「身份組管理（role）」調整身份組；使用「自動回覆（reply）」搭配身份組與 Emoji 模板，建立更有彈性的自動互動。
