Skip to content

Latest commit

 

History

History
132 lines (107 loc) · 4.49 KB

SetupBot[zh_TW].md

File metadata and controls

132 lines (107 loc) · 4.49 KB

Telegram Bot Framework - 機器人使用入門

(注意!) 我大概不能每次更新一次機器人框架就改一次這裡 的教學文件,但假如你發現到教學離現實已經差太遠了,開 Issues 給我,我會盡快修的!

使用前提

  • 不支援 Windows 和 BSD
    • 目前的 Go plugin 功能還不支援以上兩個系統 QAQ,所以以上兩個 作業系統的使用者就先暫時開 Bash 子系統或是直接開台虛擬機囉…… 十分抱歉!

下載或編譯

下載

可以在 Releases 下載目前最新的機器人框架。

但假如你想要最新的版本,那就來看看底下的編譯教學吧!

編譯

  1. 確保你已經安裝了 Golang,下載網址點此
  2. 複製 TGBotFramework 函式庫:git clone --depth=1 https://github.com/go-tgbot-framework/TGBotFramework
  3. 進入 clone 完的路徑。
  4. 輸入 go build -o TGBotFramework.out *.go(註 1)
  5. 接著執行:./TGBotFramework.out
  6. 完成~~~

(註 1) 假如你發現編譯時跳出了錯誤… 建議先不要提 Issues 而是下載目前已有的 Releases,因為我可能就只是暫時傳上版本,而不是完全可供使用。orz

但如果你對某個尚未編入 Releases 的 Commit 記錄很有興趣,可以聯絡我,我會盡所能幫你編譯好 XD。

(聯絡我) 參考 Menu[zh_TW].md 的「聯絡作者」

使用

初始化

正常你第一次開啟,會出現以下的訊息:

$ ./TGBot.out
modules 資料夾不存在。將自動建立。   
正在解析 settings.json 的資料…… [錯誤]     
將重新建立 settings.json 檔案。
請重新啟動程式套用設定。

這裡的意思是已經初始化好機器人框架了,接著重新執行即可~

功能說明

 ^TGBot 框架v
版號:0.1.0-beta
貢獻者列表:
pan93412 <[email protected]>, 2018

(1) 開啟/關閉 機器人
(2) 設定機器人
(3) 模組管理
(4) 關閉此程式

請輸入功能編號 (1-4):
  • (1):這裡是控制機器人的部份,當你已經設定好機器人並且模組也 設定好之後就能進入此處開啟你的機器人囉!
  • (2):這裡是設定機器人的地方,你能在這裡設定機器人 Token。 離開前記得先儲存設定!
  • (3):這裡是設定機器人模組的地方,下載好模組並放置在 modules 資料夾 之後就可以在這裡設定了。
  • (4):功能就如名稱一樣,就是關閉程式 XDD。

如何安裝模組?

  1. 確保機器人框架已經初始化過。

  2. 將 so 格式的機器人模組檔案放進去 modules 資料夾中。

  3. 開啟程式,之後按 3 (模組管理)

  4. 之後你會看到下方的畫面,請按 1 (變更模組)。

    ^TGBot 框架v
    [模組設定介面]
    目前載入之模組:
    
    (1) 變更模組
    (2) 設定模組
    (3) 模組資訊
    (4) 返回上一頁
    
    請輸入功能編號 (1-4):
    
  5. 之後會出現以下畫面,請輸入您想用的模組檔名 (此例為 Toolbox.so)。

    以下為所有可以使用的模組,請輸
    入以下所顯示的模組之模組名稱。
    ==============================
    
    模組 | Toolbox.so (對話資訊)
    
    目前使用的模組:
    請輸入要使用的模組名稱 (留空代表不變更):
    
  6. 再確認一次是否為此模組。

    確定是這個模組:對話資訊?(Y/n):Y
    
  7. 確保「目前載入之模組」正確。

    儲存設定值成功,將返回設定介面……
    ^TGBot 框架v
    [模組設定介面]
    目前載入之模組:Toolbox.so
    
  8. 接著按 2 設定模組。

  9. 接著就可以開啟機器人了,按 4 返回上一頁。

  10. 先確保你的 Token 是否設定好了 (在「設定機器人」區塊設定)

  11. 1 (開啟/關閉 機器人)

  12. 再按一次 1 (開啟機器人)

  13. 確保 目前狀態:false 的 false 已經變成 true 了。

  14. 打開你的機器人,看看模組能不能用。

  15. 如果能用,恭喜!

接下來?

下載更多模組,讓這框架更加有用吧!假如你在使用時碰到了 Bug,立刻開 Issues 給我 (語言隨便,但建議中文 or 英文),我會在我所能的時間趕快幫你解決問題的!:)