Documentation

功能手冊說明

本手冊詳細記載海棠旗下機器人(海棠、社群幫手)的所有斜線指令與 Discord 右鍵擴充功能。部分指令在設定時會因為所要求的權限、角色階層關係而有特定先決條件,請核對各指令右方的權限標章。

工具與功能選單

實用的生活工具、換算功能與多方平台通知,能大幅度擴充您伺服器的基礎功能性。

/menu
多功能按鈕選單

開啟整合式按鈕工具箱。輸入後會彈出一個 Embed 與 5 排互動按鈕,點擊即可觸發對應的 22 項子功能:

/欠錢要還
限特定伺服器

開啟簡單的帳務管理面板,可在 Discord 中直接記錄、還款與查詢與其他伺服器成員之間的欠款狀態。

/alarm_clock [公開]
選填參數

讓機器人在特定時間發送提醒訊息。可選擇設定之鬧鐘是否公開發送於目前頻道上。

參數定義
公開 可選擇鬧鐘訊息是否公開於頻道中 (預設為公開)
> /alarm_clock 公開:否
/divider
需發送訊息權限

傳送一條精美的分隔線,可用於調整頻道內排版、區隔不同主題的公告訊息。

/邀請數 member
必填參數 限伺服器內

查詢特定成員在當前伺服器中,邀請其他成員進群的數量與成功統計(僅供參考)。

參數定義
member 欲查詢邀請數量的 Discord 成員對象
/bots

自動彙整並輸出當前伺服器中已加入的所有機器人名單與其對應的 Discord 官方邀請連結。

/set_youtube_notification channel yt_input
必填參數 需管理權權限

設定 YouTube 頻道新影片通知。系統每 30 秒自動偵測一次,若有新片將會直接傳送通知至指定頻道。

參數定義
channel 接收新影片通知的 Discord 文字頻道
yt_input 可輸入 @帳號 (如 @richard_0916)、完整 URL、或舊版 Channel ID
> /set_youtube_notification channel:#影片通知 yt_input:@richard_0916
/remove_youtube_notification
需管理權權限

移除當前伺服器的 YouTube 新片訂閱通知。使用時會以選單自動跳出目前已綁定的訂閱清單供點選。

伺服器設定與管理

伺服器管理與維護命令,提供多種群規限制指令,以及快速的伺服器資訊檢索。

/set 功能
必填參數 限伺服器內

設定當前頻道為特定系統功能專用。設定後,機器人將在該頻道記錄相應日誌或遊戲數據。

參數定義
功能 可選擇:訊息紀錄 (儲存對話日誌)、管理紀錄 (儲存惩處紀錄)、數數遊戲頻道 (綁定數數功能)
/set_welcome
需管理權權限 限伺服器內

設定新成員加入伺服器時的自動歡迎訊息樣式、圖卡與發布頻道。

/set_reaction message_id emoji
必填參數 需管理權權限 限伺服器內

反應獲取身份組設定。成員點擊指定訊息的表情反應,機器人會自動分發或收回對應的身份組。

參數定義
message_id 點擊反應的目標訊息 ID
emoji 點擊對應的表情符號
/user member
必填參數 需管理成員權限

懲處控制面板。輸入成員後可選擇對其執行禁言(Timeout)、解除禁言、停權(Ban)或踢出(Kick)之處置。

參數定義
member 欲實施管理懲處之目標成員
/clean num [reason]
必填: num 選填: reason 需管理訊息權限

清理歷史訊息。批量刪除頻道中指定數量的近期訊息,並可選填刪除原因。

參數定義
num 要刪除的訊息數量
reason 刪除之原因,將記錄於伺服器管理日誌中
> /clean num:50 reason:"清除垃圾廣告"
/server
限伺服器內

查詢當前 Discord 伺服器的基本資訊(如伺服器 ID、擁有者、創建時間及成員數統計)。

/userinfo member
必填參數 限伺服器內

查詢特定使用者在 Discord 平台上的註冊資訊、伺服器加入時間以及擁有的身份組清單。

/roleinfo role
必填參數 限伺服器內

查詢特定身份組的詳細配置資訊、權限清單列表以及該身份組包含的成員數量。

右鍵應用程式 (Message Context Menu)

整合於 Discord 的原生右鍵擴充選單中。在任何訊息上點擊右鍵並選擇「應用程式」即可使用。

提取 Emoji 或貼圖
右鍵選單

若目標訊息中含有自訂表情符號或貼圖,系統將自動解析出對應的高解析度圖片連結並發送於頻道中。

Emoji/貼圖 複製到本伺服器
右鍵選單 需管理表情與貼圖權限

自動抓取目標訊息中的自訂表情或貼圖,並將其直接新增上傳至目前所在的伺服器,省去手動下載上傳的繁雜程序。

輸入法切換
右鍵選單

修復未切換輸入法時產生的鍵盤注音符號順序英文亂碼(如輸入 `dj94` 自動轉譯為對應中文字,無法確保 100% 正確,僅供參考)。

翻譯成繁體中文
右鍵選單

呼叫翻譯介面,直接將目標訊息之內容翻譯成繁體中文並在本地輸出(採用 Google 翻譯,僅供參考)。

遊戲與娛樂

包含個人經濟系統面板與多款益智互動小遊戲,提升社群的娛樂趣味與活躍度。

/eco_panel

開啟個人虛擬經濟系統面板。提供每日簽到、跨伺服器金幣轉帳、財富排行榜查詢等基本經濟操作。

/count_game

若伺服器中有配置「數數遊戲頻道」,此指令可查詢該頻道目前的計數狀態、最新進度與歷史最高數數紀錄。

/1a2b_game repeatable
必填參數

開啟一局 1A2B 猜數字益智遊戲。可選擇產生的數字是否可以包含重複的數值。

參數定義
repeatable 可選擇是否允許輸入猜測數字時包含重複數字 (是/否)
/1a2b_leaderboard

查詢當前伺服器中 1A2B 遊戲的最快通關步數與用時排行榜。

/catch

開啟一局靈敏度互動小遊戲。玩家將透過 Discord 按鈕控制紅色方塊移動,在限定介面內抓取隨機出現的綠色方塊。

/number_game
需建立討論串及發送權限 限一般文字頻道

終極密碼。機器人將於頻道中新增一個獨立討論串,並在該討論串中開啟一局「猜數字大小」互動遊戲。

/number_leaderboard

查詢終極密碼(猜數字大小)遊戲的通關次數與幸運排行。