內建指令

前往後台的「指令管理 → 內建指令」，可以啟用指令、設定別名、使用權限、冷卻時間與直播狀態限制。

內建指令的功能由系統提供，不需要自行填寫回覆模板。若想建立自己的回覆內容，請使用自訂指令。

指令一覽

指令	不加參數	加上參數
!開台時間	查詢本次直播已開台多久	不需要參數
!commands	取得頻道公開指令清單連結	使用 add、edit、delete 管理自訂指令
!title	查詢目前直播標題	!title 新標題 修改標題
!game	查詢目前直播分類	!game 分類名稱 修改分類
!scene	不會切換場景	!scene 場景名稱 或 !scene 1 切換小工具排版場景
!運勢	查看今日運勢籤詩與建議	不需要參數
!purge	清除自己的近期聊天訊息	不需要參數

以上指令預設啟用。查詢與一般使用預設開放所有人，!scene 預設限 mod；修改標題、分類與管理自訂指令固定需要實況主、mod 或主要 mod 身分。!purge 另有身分限制，見下方說明。

所有指令仍受啟用狀態、發送模式與冷卻設定限制。預設全域冷卻與使用者冷卻各為 5 秒。後台的權限設定可限制查詢或一般使用，但不會讓一般觀眾取得修改標題、分類、場景或管理指令的權限。

!開台時間

直接輸入 !開台時間，直播中回覆例如「已經開了 2 小時 30 分鐘」，未滿一分鐘顯示「已經開了 不到 1 分鐘」；未開台時回覆「目前尚未開台」。時間以 Twitch 本次直播開始時間計算，機器人重啟不會重新計時。查詢失敗時會提示稍後再試，不會當成未開台。

預設開放所有人、全域與個人冷卻各 5 秒，不提供預設縮寫。可在後台調整啟用狀態、權限、冷卻與發送模式；選擇僅直播中發送時，未開台或查詢失敗都不回覆。

若頻道原本已有自訂指令、其他內建指令縮寫或事件指令使用這個名稱，新內建指令會暫時不出現在目錄，也不接管原指令。原本的回覆、縮寫、開關與權限都保留，仍可編輯；停用原指令不會釋放名稱。移除名稱衝突後，內建指令會自動出現。內建指令自己已儲存的縮寫若被其他指令佔用，也會暫時退讓。

!commands

輸入 !commands 取得頻道公開指令清單。實況主與 mod 也可以使用 add、edit、delete 管理自訂指令；詳細語法與範例見在聊天室管理指令。管理操作僅限自訂指令，不能修改或刪除內建指令。

展開 !commands 後，查詢、新增、修改、刪除四個分頁各自保存使用權限、指令縮寫、發送模式與冷卻設定；切換分頁會切換下方設定。新增、修改、刪除的權限只能選 mod、主要 mod 或實況主。mod 權限包含主要 mod 與實況主，主要 mod 權限包含實況主。

!commands 列上的啟用開關是所有操作的總開關；管理操作也可以在自己的分頁個別停用。查詢的權限與發送模式不會限制管理操作。

內建操作縮寫

系統預設提供以下三個縮寫，直接指向 !commands 的管理操作，不需要先建立自訂指令，也不是把完整指令當成文字回覆。縮寫設定屬於對應的操作分頁。

內建縮寫用法	等同於	範例
!addcom !指令 回覆內容	!commands add !指令 回覆內容	!addcom !你好2 嗨
!editcom !指令 新回覆內容	!commands edit !指令 新回覆內容	!editcom !你好2 新回覆
!delcom !指令	!commands delete !指令	!delcom !你好2

例如 !addcom !你好2 嗨 中，!你好2 是要新增的自訂指令名稱，嗨 是回覆內容。成功後即可輸入 !你好2 取得回覆。修改、刪除同樣使用自訂指令本名。

在「內建指令 → !commands」選擇新增、修改或刪除，即可增減該操作的縮寫；每個操作最多 5 個，不能與既有指令或其他縮寫重複。移除 !addcom 等縮寫後，完整的 !commands add 等語法仍可使用。

縮寫會自動帶上後面的參數，並使用對應操作的權限與冷卻設定。不同操作的冷卻互相獨立；同一操作的完整指令與各個縮寫共用冷卻。

管理操作預設限 mod，也可改成主要 mod 或實況主。一般觀眾、VIP、訂閱者無法透過內建縮寫執行管理操作。停用總開關或對應操作時，完整語法與縮寫都不會執行。

也可以用自訂指令轉呼叫管理操作，設定方式見用短指令新增、修改或刪除。短指令仍以原始發話者的身分檢查對應操作的管理權限。

!title

直接輸入 !title 查詢目前的 Twitch 直播標題；查詢權限依後台設定。

實況主、mod 與主要 mod 可以在指令後填入新標題：

!title 今晚一起聊天與玩遊戲

成功時會回覆更新後的標題；更新失敗時會回覆失敗訊息。修改需要直播主帳號授權管理直播資訊（channel:manage:broadcast）；若尚未授權，請重新連結 Twitch。標題最多使用前 140 個字元。

!game

直接輸入 !game 查詢目前的 Twitch 直播分類；尚未設定分類時會顯示「未設定」。查詢權限依後台設定。

實況主、mod 與主要 mod 可以指定分類名稱：

!game Just Chatting

系統會搜尋 Twitch 分類並更新頻道；找不到分類或 Twitch 更新失敗時會回覆失敗訊息。修改同樣需要直播主帳號的管理直播資訊授權（channel:manage:broadcast）。

!scene

切換「直播小工具排版」中已建立的場景，可填場景名稱或編號：

!scene 聊天畫面
!scene 2

名稱必須是這個頻道已建立的場景；編號 1 到 5 對應排版頁中的場景順序。不加參數、找不到名稱或編號時會維持目前場景。此指令切換的是 HannyaStudio 的小工具排版場景，不會操作 OBS Studio 自身的場景集合。

使用者必須是實況主、mod 或主要 mod，且符合後台設定的指令權限。切換成功後會同步更新直播小工具的排版；聊天室不會另外回覆切換結果。

!purge

一般觀眾、訂閱者和 VIP 可以輸入 !purge，讓自己接受 1 秒禁言並清除近期聊天訊息。這個動作不會在聊天室另外回覆成功或失敗訊息。

!purge 不適用於 mod、主要 mod 和實況主，這些身分輸入指令時不會執行。直播主第一次使用這項功能前，需要重新連結 Twitch，授權系統管理聊天室禁言。

模組提供的指令

部分模組也會提供聊天指令，或允許在「觸發事件設定」綁定指令。這些指令的名稱、啟用狀態與權限由模組設定決定，不屬於上述固定內建目錄。請到對應模組查看設定；觀眾可以輸入 !commands 查看該頻道實際公開的可用指令清單。

!運勢

輸入 !運勢，機器人會回覆你的今日籤號、傳統六十甲子籤詩與固定建議。結果依 Twitch 帳號決定，同一帳號當天重複查詢、改名或到其他頻道查詢，都會得到同一支籤；每天以台灣時間（Asia/Taipei）午夜換日。

指令預設啟用、開放所有人，沒有預設縮寫。實況主可在「內建指令」調整啟用狀態、權限、發送模式、縮寫與冷卻時間。運勢內容僅供娛樂與日常參考。

若頻道原本已有名為 !運勢 的自訂指令、縮寫或自動化／模組指令，系統會保留原指令（包含停用的設定），不顯示或執行新的內建運勢指令。原指令釋出這個名稱後，內建運勢指令才會出現；其他已儲存設定不會被改名或刪除。