Skip to content
Allen95Wei edited this page Aug 17, 2024 · 29 revisions

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

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

通用參數

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

😀一般指令

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

help

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

ama <問題>

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

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

正向答案的示例:
正向答案的示例

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

中立答案的示例:
中立答案的示例

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

負向答案的示例:
負向答案的示例

random [範圍]

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

  • 不輸入參數:範圍預設為0~100
    不指定範圍的示例

  • 輸入minmax:範圍設為min~max
    指定範圍的示例

qrcode <文字>

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

daily [贈與使用者]

領取每日獎勵。獎勵為102050100點的文字經驗值。
獎勵的機率如下:

  • 10點:50%
  • 20點:40%
  • 50點:7.5%
  • 100點:2.5%

[贈與使用者]使用者未指定,則設為使用者本人。

如果指定了[贈與使用者]且對方允許陌生私人訊息,則對方會收到「贈禮通知」。而對方可在1小時內點擊按鈕,回贈10點文字經驗值做為謝禮。回禮不會從受贈方的經驗值扣除。
daily指令受贈方「贈禮通知」的示例
送出贈禮後,回贈按鈕會停用,原先的訊息也會被編輯。
daily指令受贈方送出回禮的示例
送出回禮後,如果原先贈禮方允許陌生私人訊息,則贈禮方會收到「回禮通知」。
daily指令贈禮方「回禮通知」的示例

注意:無論是否成功領取獎勵,回傳的訊息皆會顯示目前統計出來,獲得各獎勵的次數及機率。
daily指令的示例
注意:1天僅能領取一次獎勵。若在1天內使用2次,則機器人會回傳錯誤訊息。
daily指令的錯誤訊息示例

musicdl <連結> [加入後設資料] [位元率(96/128/160/192/256/320)]

將該影片下載為mp3檔案,並上傳至Discord。
目前支援下載的網頁請參考此清單
[位元率]未指定,則設為128(kb/s)。
musicdl指令的示例

關於後設資料

後設資料(metadata)可在mp3中加入歌曲的標題、演出者及縮圖,在支援的軟體中可提供更多資訊。
若「加入後設資料」為True,則在開始下載前需要手動確認資料。
後設資料編輯提示的示例

注意:在使用指令後,機器人會顯示「下載中」,此時請耐心等待機器人下載完成。
下載中的示例
注意:由於Discord有檔案大小限制,因此在下載長度較長的影片時,機器人會傳送確認訊息,以確認是否仍要下載。
確認訊息的示例
注意:若在影片過長時仍要下載,可能會因為檔案過大而導致上傳失敗。
上傳失敗的示例

user_info

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

show [使用者]

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

  • 未指定使用者:
    user_info show未指定使用者的示例
  • 指定使用者:
    user_info show指定使用者的示例

require [使用者]

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

  • 未指定使用者:
    user_info require未指定使用者的示例
  • 指定使用者:
    user_info show指定使用者的示例

about

顯示關於經驗值及等級的計算。
user_info about指令的示例
注意:此指令無法使用[私人訊息]參數。
注意:在使用指令後,機器人會提示「會分別以2則訊息傳送」。
user_info about的提示示例

anonymous

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

tos

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

agree_tos <同意(True/False)>

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

  • 同意:
    同意服務條款的示例
  • 不同意:
    不同意服務條款的示例

register <身分>

為自己建立一個匿名身分。
<身分>:你可以從選項中選取一個,作為你匿名身分的名稱。
注意:為避免匿名身分重複,你的匿名身分後方會帶著一個隨機4位數,以方便區隔。
anonymous register指令的示例
注意:若你已建立過匿名身分而使用了此指令,機器人會提醒你已經有匿名身分。
重複建立匿名身分的提醒示例

send <對象> <訊息>

使用匿名身分傳送訊息給指定使用者。
<對象>:從伺服器中的使用者中選取。
傳送成功後,機器人會回傳訊息如下:
anonymous send指令的示例
而對方所收到的訊息會像這樣:
匿名訊息接收者的示例
注意:如果你尚未建立過匿名身分,則會回傳錯誤。
未建立過匿名身分的錯誤示例
注意:若對方使用了anonymous allow設定「不接收匿名訊息」,則會回傳錯誤。
對方不接收匿名訊息的錯誤示例
注意:若對方的Discord設定「允許來自伺服器成員的私人訊息」為關閉,機器人將無法傳送訊息給該使用者,也會回傳錯誤。
不允許陌生人訊息的錯誤示例

allow <允許(True/False)>

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

  • 允許匿名訊息:
    允許匿名訊息的示例
  • 不允許匿名訊息:
    不允許匿名訊息的示例

jail

關於「監獄」功能的指令。
入獄的使用者在進入此伺服器的任一語音頻道後,即會被強制移動至指定的語音頻道,直到被解除。\

lock_in <囚犯> <監牢>

將指定的使用者(囚犯)綁定在語音頻道(監牢)中。
jail lock_in指令的示例
注意:若該使用者目前未在語音頻道中,機器人會出現提示。
使用者未在語音頻道時的提示

kick <囚犯>

將使用者解除綁定。
jail kick指令的示例

list

查看目前被綁定的使用者及其語音頻道。
jail list指令的示例

holodex

使用Holodex API所製作的相關指令。
Holodex: https://holodex.net/

download <直播連結> [位元率(96/128/160)] [加入音樂機器人佇列]

從Holodex API中取得該直播的時間軸、取得歌曲片段後,再下載所選的片段。
[位元率]未指定,則預設為128(kb/s)。
[加入音樂機器人佇列]未指定,則預設為False
「加入音樂機器人佇列」會在下載完成後,自動使用Allen Music Bot的指令點歌。
holodex download指令的示例
下載中的示例
注意:提供的連結僅能來自YouTube,否則會回傳錯誤。
直播連結不是YouTube時的錯誤
注意:若該直播影片沒有標記任何片段,機器人將會回傳錯誤。
沒有任何片段的錯誤
注意:若啟用「加入音樂機器人佇列」但未在音樂指令頻道使用,機器人將會回傳錯誤。
啟用「加入音樂機器人佇列」但未在音樂指令頻道使用的錯誤

bullshit <關鍵字> [字數] [顯著標示關鍵字]

透過唬爛產生器API生成一篇廢話。
[字數]未指定,則預設使用200字。
[顯著標示關鍵字]未指定,則預設為True
「顯著標示關鍵字」會使用等寬字型標記唬爛內容中的關鍵字。

  • 顯著標示關鍵字:
    bullshit指令(顯著標示關鍵字)的示例
  • 不顯著標示關鍵字:
    bullshit指令(不顯著標示關鍵字)的示例
    注意:唬爛產生器通常會產生多於指定字數的內容。你可以從「實際字數」欄查看。
    注意:若唬爛內容超過1024字,機器人會自動使用程式碼區塊回傳,而不是包含在指令回覆中。
    字數過多的示例

rc [ID]

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

  • 不指定頻道:
    rc指令(不指定頻道)的示例
  • 指定頻道:
    rc指令(指定頻道)的示例

dc

嘗試從目前的語音頻道中斷連接。
dc指令的示例

ping

查詢機器人的延遲(毫秒)。
ping指令的示例

dps

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

chat <訊息> (已棄用)

與ChatGPT對話。
chat指令的示例
注意:如果在短時間內有過多的chat指令要求,系統會阻止你使用此指令。
短時間過多要求時,出現錯誤的示例
注意:由於模組並非由我維護,此功能經常因為模組的問題而停止運作,而機器人會在啟動時檢查;若初始化遭遇問題,則機器人會顯示警示。
初始化遇到問題時的錯誤示例

sizecheck (已棄用)

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

📱應用程式指令

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

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

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

查看升等仍需經驗值

/user_info require相同,但是會自動查詢該使用者的資料。
查看升等仍需經驗值的示例

查看經驗值

/user_info show相同,但是會自動查詢該使用者的資料。
查看經驗值的示例

🔧開發指令

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

restart

重啟機器人。
restart指令的示例
注意:機器人重啟時,也會更改上線狀態。
狀態更改的示例

screenshot

在機器人伺服器端截圖。
screenshot指令的示例
注意:若機器人在學校電腦端執行而未登入,則可能會回傳錯誤。
無法截圖的示例

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

在機器人伺服器端執行指令,並傳回結果。
[模組]未指定,則預設為subprocess
cmd指令的示例
注意:在使用指令後,機器人會顯示「思考中」,此時請耐心等待機器人完成。
思考中的示例
注意:部分程式在執行後,並不會有文字輸出。此時,機器人會回應「終端未傳回回應。」
cmd指令(未傳回回應)的示例
注意:cmd指令基於安全原因,無法執行。
cmd指令(執行cmd)的示例

update

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