Docs

使用教學

第一次使用只要完成下方三步。之後選擇你想做的事,不需要啟用所有功能。

1. 邀請 Bot

使用公開邀請連結將 Corgi Bot 加入伺服器。邀請連結使用細項權限,不要求 Discord「管理員」權限。

邀請 Corgi Bot

2. 登入並選擇伺服器

加入後可以先打開 管理儀表板,選擇伺服器並確認常用功能的頻道設定。

如果某個功能沒有反應,通常是尚未指定頻道、功能被關閉,或 Bot 在該頻道缺少查看與發送訊息權限。

儀表板的健康檢查會逐一檢查已設定頻道,列出頻道名稱與缺少的權限;即使伺服器身分組有權限,頻道的禁止覆寫仍可能阻擋 Bot。

3. 檢查必要權限

開啟逐頻道健康檢查,修正你要使用功能的缺少權限即可。未使用的功能顯示「未設定」是正常的,不必全部開啟。

使用 /setup view 查看目前設定,再依需求設定音樂、遊戲、日誌、通知、生日與 Ticket 頻道。

常用範例:/setup auditlog #頻道、/setup msglog #頻道、/setup music #頻道。

選用:私人語音

開啟私人語音設定 →

管理員先建立一個分類和一個語音大廳,再使用 /voice setup 指定它們。

之後成員加入語音大廳時,Bot 會自動建立私人語音並移動成員;空房會自動刪除。

我要放音樂

開啟音樂控制 → · 設定音樂權限

加入語音頻道後使用 /play 測試播放。如果沒有聲音或無法加入,先執行 /musicdoctor。

播放後可用 /musicpanel 開啟按鈕面板,控制暫停、跳過、循環、音量、待播清單與停止播放;需要歌詞時使用 /lyrics 取得歌詞來源與中文歌詞搜尋連結。

/radio 會排除近期 7 天、最多 300 首已加入電台的歌曲,以及目前待播的重複歌曲;紀錄在重啟後保留。歌曲以影片 ID 或歌名與歌手比對,不是聲音辨識。

管理員可用 /radio action:block_song value:歌名 或 /radio action:block_artist value:歌手 設定排除;解除使用 unblock_song/unblock_artist,查看使用 /radio action:list。排除只影響之後加入的電台歌曲,已在佇列的歌曲請手動移除。

我要開客服單

設定 Ticket 面板頻道 →,再於 Discord 執行下列指令。

先設定 /setup ticket #頻道,再使用 /ticket panel 發送客服單面板。

Bot 需要管理頻道權限,才能建立和關閉 Ticket 頻道。

管理員可在客服單內認領、切換處理中/等待回覆、匯出對話。結案需填寫原因,Bot 會先保存 JSON 對話檔,再刪除頻道;保存失敗會保留頻道,快速連點也不會重複開單。

使用 /ticket history 查看最近 15 筆紀錄,/ticket export ticket_id:客服單ID 下載結案檔。匯出上限為 5000 則訊息/7 MiB,超出時需另行保存;附件只記錄名稱與網址,網址可能到期。

我要設定歡迎訊息

開啟歡迎訊息設定 →

使用 /welcome channel 設定歡迎/退出頻道,再用 /welcome message 與 /welcome image 設定文字和圖片。

設定完成後可用 /welcome test 預覽,不需要真的讓成員進出伺服器。

我要接收台灣資訊通知

開啟通知頻道設定 →。沒有新公告時不會重複發送;停班停課請以政府公告為準。

台灣新聞使用 /news setchannel #頻道;停班停課使用 /notify closure #頻道;地震和天氣通知使用 /setup earthquake 與 /setup weather。

通知頻道需要允許 Bot 查看、發送訊息、嵌入連結和讀取訊息紀錄。

選用:YouTube / Twitch 通知

先用 /notify channel #頻道 指定通知頻道,再用 /notify youtube_add 或 /notify twitch_add 加入要追蹤的來源。

YouTube 可填 UC 開頭頻道 ID、/channel/UC... 連結或 @頻道代號;Twitch 可填帳號或頻道連結。

選用:LFG 自動組隊

開啟 LFG 設定 →

先建立一個分類、一個等待大廳語音頻道,以及一個 LFG 專用文字頻道,再使用 /lfg setup 綁定。

建立者與加入者都要先在等待大廳,Bot 才能把人移進組隊語音。只有隊長或管理員能關閉組隊,組隊文 30 分鐘後會自動清理。

選用:跨群聊天室

開啟跨群設定 →

管理員可使用 /crosschat create 建立房間,再用 /crosschat join 指定要連接的文字頻道。

跨群聊天只會轉發已設定頻道的訊息,所有轉發都停用提及通知,並支援 /report、/crosschat modlog、封鎖使用者與封鎖伺服器。

公開前檢查

公開使用前建議確認網站的服務條款、隱私權政策、權限用途與支援方式都可以被查看。

伺服器內也可以使用 /privacy、/terms、/support 直接取得審核方常看的連結。

查看條款與隱私

遇到問題,從這裡排除

已登入,卻沒有伺服器?

先確認登入的是正確 Discord 帳號。你需要「管理伺服器」權限或為擁有者;Bot 也必須已加入。邀請後等待新的 Bot 心跳,再按儀表板重新整理。若仍沒有資料,請向伺服器擁有者確認身分組權限。

沒有權限的指令會怎樣?

Discord 可能直接隱藏指令;執行時 Bot 仍會再檢查,拒絕時通常顯示只有你可見的「你需要『管理伺服器』權限才能使用此指令」。Bot 自己缺權限則需到該頻道的權限覆寫修正,不能只看伺服器層級。

音樂有連線卻沒有聲音?

確認你與 Bot 在同一語音頻道、Bot 沒有被伺服器靜音,且有「連接」「說話」權限。執行 /musicdoctor,再測試另一首歌。Lavalink 已連線只代表節點可連接,不保證每個第三方音源能播放。仍失敗時,提供歌曲網址、時間及錯誤訊息給支援群。

設定顯示已送出,但沒有變更?

「已送出」不等於套用成功;請等待 Bot 回報。逾時或失敗會保留草稿,可重新整理確認。分類切換不會代替儲存;每一類設定請分別確認變更內容後儲存。

開啟健康檢查 · 搜尋完整指令