常見問題
訊息守門員誤判了怎麼辦?
開啟「訊息守門員」後,nekoHaru 會比對訊息中的圖片是否為已知的詐騙圖,並留意短時間內把同一張圖洗到多個頻道的行為。 一般聊天圖片被誤判的機率很低,但任何比對系統都不可能保證零誤判。
當 nekoHaru 採取動作(隱藏訊息、暫時禁言)時,會在管理員指定的頻道發出一張通知卡片。若確認是正常圖片:
- 按下卡片上的 「❌ 非詐騙」,回報會同步送到我們這裡。
- 若成員被禁言,按下 「🔓 解除禁言」 即可立即解除,不用等禁言時間結束。
每一次回報都會被記錄並用來調整判斷邏輯;同樣的情況若在不同伺服器重複出現,我們會優先處理。你按下的按鈕,也在幫所有使用 nekoHaru 的伺服器變得更準。
想事先避免誤判?需要貼出詐騙案例圖片討論時,請加上 Discord 的劇透(spoiler)標記,nekoHaru 就不會拿它比對詐騙圖庫。 但若在短時間內把同一張圖貼到多個頻道,仍可能觸發洗版偵測。
設定頻道時出現「頻道無法使用」
這代表選擇的頻道目前無法被使用,常見原因:
- 頻道已被刪除,或頻道類型不符合這個功能(例如選到了語音頻道)。
- 機器人沒有該頻道的「檢視頻道」權限。
- 頻道是剛建立或剛修改的,但頁面上的頻道清單還是舊資料。
請依序嘗試:
- 確認機器人在該頻道有「檢視頻道」與「發送訊息」權限。
- 重新整理頁面,並點擊頻道清單旁的「刷新」按鈕。
- 把這個功能中所有與頻道有關的欄位重新選一次再儲存,即使顯示的是同一個頻道也要重新選取。
若仍然出現錯誤,歡迎聯繫開發者。
YouTube 自訂範本通知沒有送出已修復
過去若自訂訊息範本包含 @everyone 或 @here,而機器人在該頻道沒有「提及 @everyone、@here 和所有身分組」權限,Discord 會拒絕整則通知。
2026/09/06 起,遇到這種情況時 nekoHaru 會改為不帶提及重新發送,通知本身會正常送出,只是不會 @ 到成員。若希望提及生效,請授予機器人上述權限。
錯誤訊息對照
控制面板跳出錯誤提示時,可依提示的標題對照下表處理。若問題持續,請記下提示標題與當時的操作步驟並聯繫我們。
登入與授權
- 尚未登入
UNAUTHORIZED - 登入狀態已失效,請重新登入。
- 登入已失效
DISCORD_OAUTH_INVALID_GRANT - Discord 授權已過期,請重新登入並完成授權流程。
- 授權已失效
OAUTH_STATE_INVALID - 授權頁面停留太久或已經用過,請回到控制面板重新點一次授權。
- 沒有權限
FORBIDDEN - 您的帳號沒有執行這個操作的權限,請確認您是該伺服器的管理員。
- 無法管理此伺服器
DISCORD_BOT_NOT_IN_GUILD_OR_NO_ACCESS - 機器人不在這個伺服器內,或您沒有管理權限。請重新邀請機器人,或確認您的伺服器權限。
Twitch 授權
- 需要 Twitch 授權
TWITCH_AUTH_REQUIRED - 這個功能需要先連結 Twitch 帳號;若之前授權過,可能已過期或被撤銷,請重新授權。
- Twitch 權限不足
TWITCH_SCOPE_MISSING - 授權時有項目未勾選,請重新授權並允許所有要求的權限。
- Twitch 帳號不符
TWITCH_BINDING_MISMATCH - 目前授權的 Twitch 帳號不是這個頻道的擁有者,請改用該頻道的 Twitch 帳號授權。
頻道與機器人權限
- 頻道無法使用
CHANNEL_FORBIDDEN - 選擇的頻道已刪除、類型不符,或機器人看不到該頻道。請參考上方「設定頻道時出現『頻道無法使用』」。
- 機器人無法存取
DISCORD_BOT_MISSING_ACCESS - 機器人沒有該頻道或伺服器的存取權限,請在頻道權限中允許機器人「檢視頻道」。
- 機器人權限不足
DISCORD_BOT_MISSING_PERMISSIONS - 機器人缺少執行這個操作所需的權限,請調整機器人身分組的權限。
- 找不到資源
DISCORD_RESOURCE_NOT_FOUND - 指定的頻道、身分組或訊息可能已被刪除,請重新設定。
- Discord 連線失敗
DISCORD_API_ERROR - Discord 目前無法正常回應,請稍後再試。
功能設定
- 尚未選擇頻道
SETTING_CHANNEL_REQUIRED - 這項設定需要指定頻道,請先選擇頻道再儲存。
- 訊息內容過長
SETTING_TEMPLATE_TOO_LONG - 自訂訊息超過長度上限,請縮短後再儲存。
- 找不到設定
SETTING_NOT_FOUND - 找不到對應的設定資料,請重新整理頁面後再試。
- 已達數量上限
GUILD_SOURCE_MAX_REACHED - 這個伺服器可新增的通知來源已達上限,請先移除不需要的項目。
- 項目已存在
GUILD_SOURCE_ALREADY_EXISTS - 這個來源已經新增過了,直接使用既有的設定即可。
- 找不到項目
GUILD_SOURCE_NOT_FOUND - 這個來源可能已被刪除,請重新整理頁面。
- 資源使用中
RESOURCE_LOCKED - 這個項目正在更新中,請稍候幾秒再試一次。
連線與系統
- 操作過於頻繁
RATE_LIMIT - 操作太頻繁觸發了限制,請稍候片刻再試。
- 無法連線至伺服器
— - 請檢查網路連線後再試;若網路正常,可到伺服器狀態頁確認服務狀況。
- 伺服器無回應
BAD_GATEWAY - 伺服器暫時無法回應,請稍後再試。
- 伺服器發生錯誤
INTERNAL_SERVER_ERROR - 請稍後再試;若持續發生,請記下當時的操作步驟並聯繫我們。
- 請求內容有誤 / 找不到資料 / 格式不支援
BAD_REQUEST 等 - 通常是頁面資料過舊,請重新整理頁面後再試。
- 發生未預期的錯誤
— - 請稍後再試;若持續發生,請記下當時的操作步驟並聯繫我們。
特別感謝
名單順序不代表貢獻程度。
首頁開發
- tbk_lteaa
- imacheng
- aka_flybear
技術支援
- final_9.30_percent
- aka_flybear
社群支持
- xiaorui1206
- HightPingStore
- imacheng
- tbk_lteaa
如有任何遺漏或需修正之處,請及時聯繫負責人以進行更新。