指令

Allen Bot (Slash)的所有操作，皆是透過在伺服器或DM(Direct Message，私人訊息)使用指令。
另外，有些指令僅允許開發者進行使用。請勿隨意嘗試，以免造成毀滅性的後果！

Allen Bot (Slash) 不再需要指令前綴，在支援的頻道中輸入斜線即可選擇指令。

通用參數

[私人訊息]：非必要，可以選擇是否要讓其他使用者看到機器人的回覆。
這是ping指令啟用私人訊息的示例：

😀一般指令

此處的指令可供所有人使用。

help

回傳所有指令的使用說明。

ama <問題>

隨機回應一個答案。答案有3種類型，分別是：

• 正向：開頭有1個綠色圓形(即🟢)

正向答案的示例：

• 中立：開頭有1個黃色圓形(即🟡)

中立答案的示例：

• 負向：開頭有1個紅色圓形(即🔴)

負向答案的示例：

random [範圍]

在指定的[範圍]中隨機選出1個數。選出的數以程式碼區塊方式顯示，字體黃色。 [範圍]的指定方式有2種：

• 不輸入參數：範圍預設為0~100。
  

• 輸入min、max：範圍設為min~max。
  

qrcode <文字>

將<文字>轉為QR Code的形式。使用https://chart.apis.google.com/。

ytdl <YouTube連結>

將該YouTube影片下載為mp3檔案，並上傳至Discord。

注意：在使用指令後，機器人會顯示「下載中」，此時請耐心等待機器人下載完成。

注意：由於Discord有檔案大小限制，因此在下載長度較長的影片時，機器人會傳送確認訊息，以確認是否仍要下載。

注意：若在影片過長時仍要下載，可能會因為檔案過大而導致上傳失敗。

user_info

關於使用者資訊、經驗值的指令。

show [使用者]

取得使用者的資訊。 若[使用者]未指定，則設為指令使用者。

• 未指定使用者：
  
• 指定使用者：
  

require [使用者]

查詢距離下次升等還差多少經驗值。 若[使用者]未指定，則設為指令使用者。

• 未指定使用者：
  
• 指定使用者：
  

about

顯示關於經驗值及等級的計算。

注意：此指令無法使用[私人訊息]參數。
注意：在使用指令後，機器人會提示「會分別以2則訊息傳送」。

anonymous

匿名訊息系統的指令。
注意：所有匿名系統指令的回應皆為私人訊息，以確保你的匿名身分保密。

tos

查看匿名訊息系統的服務條款。
注意：若你未同意服務條款就使用其他anonymous指令，你的指令將會被導向至此處。
注意：此服務條款可能會隨時變動。當此條款有變動時，我們將會取消所有人對服務條款的同意；這代表著，你可能會不定時就會看到此訊息。
注意：如果想要開始使用匿名訊息系統，請使用anonymous agree_tos指令來同意此條款。

agree_tos [同意(True/False)]

同意匿名訊息系統的服務條款。
若[同意]為True，則表示你同意了條款。False則代表你不同意。
注意：請務必先仔細閱讀服務條款再同意，以避免你的權利受到侵害！
注意：你必須先透過此指令同意條款，才能開始使用匿名訊息服務。

• 同意：
  
• 不同意：
  

register [身分]

為自己建立一個匿名身分。
[身分]：你可以從選項中選取一個，作為你匿名身分的名稱。
注意：為避免匿名身分重複，你的匿名身分後方會帶著一個隨機4位數，以方便區隔。

注意：若你已建立過匿名身分而使用了此指令，機器人會提醒你已經有匿名身分。

send [對象] [訊息]

使用匿名身分傳送訊息給指定使用者。
[對象]：從伺服器中的使用者中選取。
傳送成功後，機器人會回傳訊息如下：

而對方所收到的訊息會像這樣：

注意：如果你尚未建立過匿名身分，則會回傳錯誤。

注意：若對方使用了anonymous allow設定「不接收匿名訊息」，則會回傳錯誤。

注意：若對方的Discord設定「允許來自伺服器成員的私人訊息為關閉，機器人將無法傳送訊息給該使用者，也會回傳錯誤。

allow [允許(True/False)]

設定是否允許接收私人訊息。
若[允許]為True，你將會收到來自他人的匿名訊息。False則代表不允許匿名訊息，其他使用者在嘗試傳送匿名訊息給你時，他們會收到警告。

• 允許匿名訊息：
  
• 不允許匿名訊息：
  

rc [ID]

重新連接至語音頻道，以便使用Music Bot指令補全功能。
若[ID]未指定，則機器人將自動尋找Allen Music Bot及Allen Why所在的語音頻道，並嘗試加入。
注意：當機器人已經連接至其它語音頻道時，請先執行dc指令使其斷線。

• 不指定頻道：
  
• 指定頻道：
  

dc

嘗試從目前的語音頻道中斷連接。

ping

查詢機器人的延遲(毫秒)。

dps

查詢機器人伺服器電腦的CPU及記憶體使用率。
注意：由於不明原因，指令第1次使用時，CPU使用率可能會顯示為0。這時，請使用第2次，即可得知CPU使用率。

sizecheck

查詢"C:\MusicBot\audio_cache"的大小。(需搭配Music Bot使用)

📱應用程式指令

更快、更方便的指令功能。
注意：使用「應用程式指令」之回應強制啟用私人訊息，以避免指令回應訊息過多。

什麼是「應用程式指令」？

應用程式指令會在你對著使用者點擊右鍵(電腦)/點擊使用者(行動裝置)時出現。比起斜線指令，使用應用程式指令可以更快地查詢特定使用者的資料。

查看升等仍需經驗值

與/user_info require相同，但是會自動查詢該使用者的資料。

查看經驗值

與/user_info show相同，但是會自動查詢該使用者的資料。

🔧開發指令

此處的指令提供開發或進階使用者使用。
⚠️警告：請勿隨意嘗試下列指令，以免導致機器人運作異常！⚠️

restart

重啟機器人。

注意：機器人重啟時，也會更改上線狀態。

screenshot

在機器人伺服器端截圖。

注意：若機器人在學校電腦端執行而未登入，則可能會回傳錯誤。

cmd [模組(subprocess/os)] <指令>

在機器人伺服器端執行指令，並傳回結果。
若[模組]未指定，則預設為subprocess。

注意：在使用指令後，機器人會顯示「思考中」，此時請耐心等待機器人完成。

注意：部分程式在執行後，並不會有文字輸出。此時，機器人會回應「終端未傳回回應。」

注意：cmd指令基於安全原因，無法執行。

update

嘗試從GitHub取得最新程式碼，並將機器人重啟。
注意：指令正常執行時，不會在原頻道傳回任何訊息，僅會改變上線狀態。