6. CLI 與代理連動

在終端裡操作 Saba-chan,並讓 Claude Code、Codex 這樣的 AI 代理替你操作。

6. CLI 與代理連動

saba-chan-cli 是在終端裡操作 Saba-chan 的工具。終端是輸入指令的視窗。應用程式能做的事,CLI 都能做;CLI 和應用程式一樣只是向守護程序提出請求,不會直接改動伺服器檔案。它方便人使用,也能輸出便於機器讀取的結果,所以你可以用它把 Saba-chan 交給自己的 AI 代理。


使用 CLI

CLI 位於 Saba-chan 的安裝資料夾(預設 C:\Program Files\Saba-chan\saba-chan-cli.exe)。安裝程式不會修改系統 PATH(Windows 尋找指令的資料夾清單)。請用完整路徑呼叫 CLI,或自己把該資料夾加入 PATH。在 Linux 上,安裝程式會建立 ~/.local/bin/saba-chan-cli。

  • 不帶參數執行會開啟互動式介面。
  • 守護程序沒在執行時,會問你要不要啟動。關閉 CLI 後守護程序和伺服器仍會繼續執行。
  • 伺服器名稱只寫一部分也可以。
想做的事命令
整體狀態saba-chan-cli status
新增伺服器saba-chan-cli server add
啟動 · 停止 · 重新啟動saba-chan-cli start 帕魯 · stop 帕魯 · restart 帕魯
主控台 · 遊戲命令saba-chan-cli console 帕魯 · saba-chan-cli run 週末 say 你好
備份 · 排程工作saba-chan-cli backup … · saba-chan-cli schedule …
連線 Discordsaba-chan-cli bot pair(顯示代碼並等待連線完成)
命令權限 · 查看各等級指令saba-chan-cli perm … · perm commands
Discord 再確認階段saba-chan-cli bot confirm
Discord 伺服器前綴 · 斜線指令樣式saba-chan-cli bot prefix … · bot slash …
會朗讀的 Saba-chan · Discord 伺服器管理saba-chan-cli bot tts … · bot moderation · bot channel …
查看會說話的 Saba-chan 工具saba-chan-cli chatbot tools(變更:chatbot set tools=[lol,pubg] --guild …)
查看/中斷連線的 AI 代理(遠端)saba-chan-cli bot agent · bot agent --unlink
Saba-chan 更新saba-chan-cli update check · update apply
遠端常駐程式saba-chan-cli remote … · 任意指令加 --daemon <名稱>(遠端常駐程式)
切換到應用程式saba-chan-cli gui
刪除我的全部資料saba-chan-cli bot erase
詳細說明saba-chan-cli <命令> --help

與你的 AI 代理連動

只要是能執行終端命令的 AI 代理,比如 Claude Code、Codex,都可以把 Saba-chan 交給它。代理像人一樣接收用話語提出的請求,在背景執行 saba-chan-cli 並讀取結果。

我的 AI 代理(如 Claude Code、Codex)
›

為了方便代理使用,CLI 遵守以下規則。

  • --json:標準輸出只輸出一個 JSON 文件。提示和進度輸出到標準錯誤。失敗時包含 error、error_code 以及(如果有的話)suggestions。
  • 結束碼:0 成功,1 失敗,2 用法錯誤或匹配到多個目標,3 無法連線守護程序,4 找不到目標,130 已取消。
  • help --json:以 JSON 給出所有命令的樹、參數、全域選項和結束碼表。守護程序沒執行也能用。讓代理先讀這個,而不是死記命令。
  • --json-stream:耗時的操作(安裝伺服器、更新)每行輸出一個 JSON 表示進度,最後一行是結果。
  • events --json:逐行追蹤守護程序事件(伺服器啟動和停止、安裝進度等)。
  • do:守護程序開放的操作清單。用 do 操作 --plan 可以先看會改變什麼再執行。

需要人親自做的事

  • 需要確認的命令在非終端環境下不會詢問,而是停下來,必須加 --yes 才會執行。在刪除、重置伺服器這類無法撤銷的命令上加 --yes 之前,請讓代理先問你。
  • 同意遊戲條款(EULA),以及同意不隔離執行未經驗證的模組,不能用 --yes 或 --json 代替。要由人在終端或應用程式裡親自完成。

可以貼到代理指令裡的範例

在代理的指令檔案(例如 AGENTS.md、CLAUDE.md)裡寫上類似下面的內容即可。路徑請按你的安裝位置修改。

## Saba-chan 遊戲伺服器
- 遊戲伺服器只用 saba-chan-cli 操作:"C:\Program Files\Saba-chan\saba-chan-cli.exe"
- 先用 `saba-chan-cli help --json` 讀一遍命令和參數。
- 所有命令都加 --json,並檢查結束碼(0 成功,1 失敗,2 用法或有歧義,3 沒有守護程序,4 找不到目標)。
- 刪除、重置伺服器這類無法撤銷的命令,先問人再加 --yes。
- 同意條款和解除隔離交給人來做。

遠端連接 AI 代理(MCP)

即使 ChatGPT、Claude 這類 AI 代理無法使用電腦的終端,也能以遠端 MCP 連到 Saba-chan 雲端,把我電腦上的遊戲伺服器交給它。它能像在應用程式中一樣操作連接到我 Discord 帳號的所有電腦。

  1. 在代理的連接器(遠端 MCP 伺服器)新增畫面中填入 https://saba-chan.online/mcp。這個網址也能在應用程式的 設定 → 連線 畫面、/mysaba agent、saba-chan-cli bot agent 看到。
  2. 瀏覽器開啟 Discord 登入後,用已連接電腦的 Discord 帳號登入,並在 Saba-chan 的同意畫面中允許。
  3. 用話語拜託代理。例如:「告訴我 Minecraft 伺服器的狀態」、「把 Palworld 伺服器重新啟動」

值得注意的事:

  • 每個 Discord 帳號只能連接一個代理。允許另一個代理後,先前連接的代理會被中斷。
  • 危險指令與停止、重新啟動,會在執行前於代理畫面再次詢問(與應用程式相同的規則)。不會透過 Discord 詢問。
  • 在 Saba-chan 網頁 中被禁止的事(路徑、密碼等電腦專用設定,Saba-chan 更新等),代理也不能做。
  • 中斷連線:應用程式的 設定 → 連線 畫面的 中斷代理連線、Discord 的 /mysaba agent、saba-chan-cli bot agent --unlink。90 天沒有使用的連線會自動中斷。