遠端控制

透過 Discord 或 Telegram bot 遠端控制你的 Termdock 終端。建立 session、傳送指令、讀取輸出、接收互動提示通知。

總覽

遠端控制讓你用手機或任何裝置，透過 Discord 或 Telegram 管理 Termdock 終端 session。可以建立 session、執行指令、讀取輸出、擷取螢幕截圖，並在出現互動提示時收到帶可點按鈕的通知。

Discord Bot

斜線指令搭配互動按鈕

Telegram Bot

Inline keyboard 控制

Telegram 設定

  1. 打開 Telegram，跟 @BotFather 開始對話。傳送 /newbot 並依提示建立你的 bot。
  2. 複製 BotFather 給你的 bot token。
  3. 在 Termdock：設定 > 遠端控制 > Telegram > 貼上 token。
  4. 跟你的 bot 開始對話並傳送任意訊息。Termdock 會自動偵測你的 chat ID，也可以在設定中手動輸入。
  5. 在設定中填入 chat ID 並啟用 Telegram 整合。

Discord 設定

  1. 前往 Discord Developer Portal 建立新的 application。
  2. 進入 Bot 頁建立 bot，複製 bot token。
  3. 在 OAuth2 勾選這些 scope：
    botapplications.commands
  4. 設定 bot 權限：
    Read MessagesSend MessagesSend EmbedsAttach FilesManage Messages
  5. 啟用 Gateway Intents：Guilds
  6. 用產生的 OAuth2 URL 把 bot 邀進你的伺服器。
  7. 在 Termdock：設定 > 遠端控制 > Discord > 貼上 token、guild ID 與 channel ID。

指令一覽

指令說明
/ws列出 workspace
/new [workspace]建立新的終端 session
/list列出運作中的 session
/send {session} {content}傳送指令到終端
/read {session} [lines] [raw]讀取輸出（預設 50 行）
/watch {session}監聽提示通知
/unwatch {session}停止監聽 session
/key {session} {key}傳送特殊鍵（ctrl+c、enter、tab、up、down、esc）
/kill {session}關閉 session（僅 Telegram）
/snap [session]擷取終端螢幕截圖

注意事項

Telegram 限制

  • 單則訊息上限 4096 字元
  • Inline 按鈕的 callback data 上限 64 bytes

Discord 限制

  • 單則訊息上限 2000 字元
  • 每則提示通知最多 5 個互動按鈕

互動提示

兩個平台都支援互動提示按鈕，用於 CLI 選項選擇。偵測到終端提示時（例如套件管理器的選擇畫面），會把可點的按鈕傳到你的聊天視窗，快速回應。