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 … |
| 連線 Discord | saba-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 帳號的所有電腦。
- 在代理的連接器(遠端 MCP 伺服器)新增畫面中填入
https://saba-chan.online/mcp。這個網址也能在應用程式的 設定 → 連線 畫面、/mysaba agent、saba-chan-cli bot agent看到。 - 瀏覽器開啟 Discord 登入後,用已連接電腦的 Discord 帳號登入,並在 Saba-chan 的同意畫面中允許。
- 用話語拜託代理。例如:「告訴我 Minecraft 伺服器的狀態」、「把 Palworld 伺服器重新啟動」
值得注意的事:
- 每個 Discord 帳號只能連接一個代理。允許另一個代理後,先前連接的代理會被中斷。
- 危險指令與停止、重新啟動,會在執行前於代理畫面再次詢問(與應用程式相同的規則)。不會透過 Discord 詢問。
- 在 Saba-chan 網頁 中被禁止的事(路徑、密碼等電腦專用設定,Saba-chan 更新等),代理也不能做。
- 中斷連線:應用程式的 設定 → 連線 畫面的
中斷代理連線、Discord 的/mysaba agent、saba-chan-cli bot agent --unlink。90 天沒有使用的連線會自動中斷。