Emily

Discord 社群管理工具

功能

身份組群組 (Metaroles)

利用指令製作由多個身份組組成的身份組，便於管理權限。例如透過自動產生「幹部」身份組群組來同時管理所有歷屆幹部身份組。

社員 (Membership)

透過對話框填寫資料，並分配身份組，自動化社員加入流程；幹部可於後臺管理社員的加入請求。

私人聯絡討論串

伺服器管理員可使用 /私訊 設定 指定文字頻道和幹部身份組，Emily 會在頻道中張貼操作說明。伺服器成員按下說明下方的按鈕後，Emily 會建立私人討論串並通知雙方。

開發

請依照慣例式提交規範用中文或英文寫提交說明。

技術棧

• Discord.js：Discord API 的 Node.js 實作
• ESBuild：超高速的 JavaScript 和 TypeScript 打包工具和轉譯器。
• pnpm：Node.js 的套件管理工具
• Drizzle ORM：輕量級且強型別的 ORM（物件關聯映射工具）
• TypeScript：JavaScript 的超集，提供型別檢查和其他語言功能
• tsx：執行 TypeScript 檔案

斜線指令

所有斜線指令位於 src/commands（index.ts 除外）。要增加斜線指令，請在 src/commands 新增一個預設匯出 Command 型別的檔案，並在 src/commands/index.ts 註冊。Command 型別位於 src/types.ts。

部屬

你可以用 Dockerfile 和 examples 目錄的各種範例 compose.yaml 在 Docker 部屬這個機器人。大略步驟如下：

git clone https://github.com/NTUT-NPC/emily
cd emily
cp examples/compose.prod.yaml compose.yaml
cp examples/db.env db.env
cp examples/emily.env emily.env
# 用文字編輯器填寫 `.env` 檔案
docker compose up -d

到 Discord Developers 網站建立一個機器人。啟用 Privileged Gateway Intents 中的 Presence Intent 和 Server Members Intent。

最後，用邀請連結來將機器人加入您的Discord伺服器。將「你的_Client_ID」替換為您機器人的 Client ID：

https://discord.com/api/oauth2/authorize?client_id=你的_Client_ID&permissions=361045691392&scope=bot%20applications.commands

私訊操作說明的指定頻道必須讓機器人擁有「查看頻道」、「傳送訊息」、「建立私人討論串」、「在討論串中傳送訊息」和「管理討論串」權限。幹部身份組必須擁有「查看頻道」、「在討論串中傳送訊息」和「讀取訊息歷史」權限，並設為可提及；一般使用者也必須能查看頻道、在討論串中傳送訊息和讀取訊息歷史。

部屬到 K2

如果要部屬到社團的伺服器，可以參考以下這些指令：

docker build . -t emily
docker save emily | docker -H ssh://k2.ntut.club load
ssh k2.ntut.club 'docker compose -f /srv/emily/compose.yaml up -d'