Docs

教學文檔

nekoHaru 的完整教學文檔正在構建中,敬請期待!在那之前,這裡整理了常見問題,以及控制面板錯誤提示的處理方式。

目錄 常見問題

常見問題

訊息守門員誤判了怎麼辦?

開啟「訊息守門員」後,nekoHaru 會比對訊息中的圖片是否為已知的詐騙圖,並留意短時間內把同一張圖洗到多個頻道的行為。 一般聊天圖片被誤判的機率很低,但任何比對系統都不可能保證零誤判。

當 nekoHaru 採取動作(隱藏訊息、暫時禁言)時,會在管理員指定的頻道發出一張通知卡片。若確認是正常圖片:

  • 按下卡片上的 「❌ 非詐騙」,回報會同步送到我們這裡。
  • 若成員被禁言,按下 「🔓 解除禁言」 即可立即解除,不用等禁言時間結束。

每一次回報都會被記錄並用來調整判斷邏輯;同樣的情況若在不同伺服器重複出現,我們會優先處理。你按下的按鈕,也在幫所有使用 nekoHaru 的伺服器變得更準。

想事先避免誤判?需要貼出詐騙案例圖片討論時,請加上 Discord 的劇透(spoiler)標記,nekoHaru 就不會拿它比對詐騙圖庫。 但若在短時間內把同一張圖貼到多個頻道,仍可能觸發洗版偵測。

設定頻道時出現「頻道無法使用」

這代表選擇的頻道目前無法被使用,常見原因:

  • 頻道已被刪除,或頻道類型不符合這個功能(例如選到了語音頻道)。
  • 機器人沒有該頻道的「檢視頻道」權限。
  • 頻道是剛建立或剛修改的,但頁面上的頻道清單還是舊資料。

請依序嘗試:

  1. 確認機器人在該頻道有「檢視頻道」與「發送訊息」權限。
  2. 重新整理頁面,並點擊頻道清單旁的「刷新」按鈕。
  3. 把這個功能中所有與頻道有關的欄位重新選一次再儲存,即使顯示的是同一個頻道也要重新選取。

若仍然出現錯誤,歡迎聯繫開發者。

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

設計團隊

  • .josh0324
  • tbk_lteaa

技術支援

  • final_9.30_percent
  • aka_flybear

社群貢獻

  • lulumi_0930
  • hi90865

社群支持

  • xiaorui1206
  • HightPingStore
  • imacheng
  • tbk_lteaa

如有任何遺漏或需修正之處,請及時聯繫負責人以進行更新。