跳至主要內容

Discord

接入前,在 Discord Developer Portal 建立 Application、新增 Bot User,再把 Bot 安裝到目標伺服器。保管好 Bot Token,只授予它讀取和傳送目標頻道訊息所需的權限。

先準備 Intents​

Anyy 按帳號策略計算所需 Gateway Intents:私訊啟用時需要 Direct Message,伺服器訊息啟用時需要 Guild Message;群策略為 open 或 allowlist 時還需要 Message Content。Dashboard 會列出相關平台前置條件,但本機儲存不能替代 Discord 端授權。

連線與配對​

Dashboard 入口是 通訊管道 → 新增 → Discord,預設採用 Bot Gateway,填寫帳號 ID 和 bot_token。CLI 可執行 anyy setup channel 後選擇 Discord;預設帳號 ID 為 work。接入會核對 Bot 與 Application 身分。

預設私訊為 pairing,群組對話為 mention。修改策略要用 CLI 精靈;目前公開目錄允許私訊 pairing/open/allowlist/disabled,群組對話 mention/open/allowlist/disabled,沒有群組對話 pairing 選項。認證資料表單也沒有名單編輯器,詳見通用設定限制。

傳送私訊觸發配對後,在 CLI 操作:

anyy channel pairing list --channel discord
anyy channel pairing approve --request REQUEST_ID

核對請求對應的 Bot 帳號與使用者 ID,批准後再傳送新訊息。不要只按顯示暱稱授予存取權。

Thread 與檔案​

Discord Thread 會保留到回覆路由中,回覆發回原 Thread。通過大小檢查的入站附件會作為工作階段附件暫存。更改伺服器策略後,應同步核對 Intents、Bot 安裝權限和頻道成員關係,再 Reload。

anyy channel reload
anyy channel doctor discord

驗證時分別測試一則私訊、一則伺服器頻道提及訊息,再測試需要的 Thread/附件。某一項成功不能說明其他路徑也已驗證。

現象優先檢查
Bot 身分有效但沒有伺服器訊息Guild Intents、安裝範圍、頻道權限
僅在提及時回覆預設 mention 策略
私訊一直等待CLI 配對請求和 DM 策略
附件缺失下載權限、大小上限與 Doctor 診斷