# Universe Bot 能做什麼

> 每個 agent 自選模型、用訊息委派、獨立用量面板、例行任務與補跑、瀏覽器接手、Telegram／iMessage 通道、權限分級、錯誤自動重試與備用模型。

## 每個 agent 可以用不同的模型和訂閱嗎？

可以。每個 agent 各自設定要用哪一家、哪一個模型，同一個團隊裡可以混用。用訂閱帳號的方式是由 Universe Bot 去執行你自己電腦上、你自己登入好的官方命令列工具，我們不碰你的帳號密碼。

| 接法 | 你需要準備 | 能做的事 |
|---|---|---|
| Claude（Claude Code CLI） | Claude 付費訂閱，或 Claude Code 能用的登入 | 對話、讀寫工作資料夾、執行指令、瀏覽器操作、外部 MCP 伺服器、圖片附件、上網搜尋 |
| ChatGPT（Codex CLI） | ChatGPT 付費訂閱 | 對話、讀寫工作資料夾、執行指令、圖片附件、上網搜尋 |
| Gemini（Gemini CLI） | Google 帳號 | 對話、讀取工作資料夾、完整權限模式、上網搜尋（不能收圖片附件） |
| 相容 OpenAI 格式的 API（例如 OpenRouter） | 你自己申請的 API key（可以用免費層） | 對話、跟隊友傳訊息與團隊工具（不能讀寫檔案） |

模型快選：Claude 有 haiku／sonnet／opus；Gemini 有 auto／pro／flash／flash-lite；Codex 會列出你的帳號查得到的模型。快選裡沒有的，可以直接輸入模型名稱。

## 委派與 mailbox 是什麼？

委派就是 agent 之間互傳訊息。總管把工作傳給隊員之後不用等，可以繼續做自己的事。隊員做完會回報，回報送到時總管會被叫醒繼續處理。

- 每個 agent 有一條自己的工作佇列，收到訊息就依序處理。
- 總管可以一次交辦給好幾個隊員，大家同時做。
- 隊員忘了回報時，系統會把它最後的回覆自動送回給交辦的人，不會讓總管一直等。
- 有防止無限來回的機制：訊息轉手超過上限就停下來，並在對話中提示你。
- 可以設「指揮官」：讓某個隊員管理自己底下的隊員，最多三層。
- 你可以打開任兩個 agent 之間的對話來看，隨時對任何一個 agent 插話。

## 用量面板和 Clear session 是什麼？

每個 agent 都有自己的用量面板，看得到這個 agent 用了多少 token。Clear session 是讓某個 agent 從全新的對話重新開始，記憶、人格、規則都會保留，用來省額度。

| 項目 | 說明 |
|---|---|
| 統計區間 | 目前 session、今天、累計 |
| 數字 | 輪數、輸入 token、輸出 token、快取讀取、費用（有回報費用的服務才顯示） |
| 訂閱額度 | 顯示 5 小時、7 天的額度與重置時間。這是帳號層級，同一家的所有 agent 共用（目前只有 Claude 會回報） |
| Clear session 會保留 | 記憶、人格、規則、頭像、用量歷史；舊對話封存，仍可在歷史裡查看 |
| 規則或記憶改了 | 下一輪就生效，不用 Clear |

## 例行任務怎麼運作？會補跑嗎？

例行任務會在你設定的時間，把一段固定內容自動交給指定的 agent，投進它原本的對話裡。如果時間到了 app 沒在跑，下次開起來會補跑錯過的最近一場，並標示「補跑，原定 HH:MM」。

| 項目 | 規格 |
|---|---|
| 頻率 | 每天、每週（可選多天）、每月（1～31 號；那個月沒有那一天就在當月最後一天跑） |
| 時間 | 24 小時制，以 5 分鐘為單位，依你電腦的時區 |
| 補跑 | 只補錯過的最近一場，不會一次補好幾場 |
| 上限 | 每個 agent 最多 20 個 |
| 誰能建立 | 你在畫面上，或你指定為指揮官的 agent |
| 刪除 | agent 要刪例行任務時會在對話裡出確認卡，你按下去才會真的刪 |
| 背景執行 | 關掉視窗時 app 會縮到系統列繼續跑；要完全結束請從系統列選「結束」 |

## 瀏覽器接手是什麼？

瀏覽器接手是 agent 操作網頁遇到登入、驗證這類需要人處理的步驟時，請你在 Universe Bot 畫面裡直接操作它的瀏覽器，你做完它再接著做。

| 項目 | 規格 |
|---|---|
| 適用 | Claude CLI 的 agent，而且要在設定裡打開瀏覽器開關（預設關） |
| 瀏覽器 | 用你電腦上已經安裝的 Google Chrome；每個 agent 有自己獨立的設定檔，登入狀態分開保存，不碰你平常用的 Chrome 資料 |
| agent 能做的事 | 開網址、讀頁面結構、點擊、輸入、按鍵、捲動、上一頁、分頁、截圖 |
| 不做的事 | 下載與上傳檔案；開本機檔案（`file://`）等非網頁網址 |
| 同時執行 | 最多 3 個瀏覽器，閒置 10 分鐘自動關 |
| 接手 | agent 送出「需要你接手瀏覽器」卡片，按「開啟電腦」就能看到即時畫面、點擊和打字；做完按完成或跳過 |

⚠️ 打開瀏覽器開關之後，agent 可以用你已登入的帳號做事。網頁裡的惡意內容有可能誤導它，請只對信任的任務打開。

## 可以用 Telegram 或 iMessage 跟總管對話嗎？

可以。設定好之後，你可以在手機的 Telegram 或 iMessage 傳訊息、傳照片給總管、收它的回覆，對話跟桌面版是同一串。iMessage 是經由第三方服務 Photon（photon.codes）收發。

| 項目 | Telegram | iMessage |
|---|---|---|
| 適用手機 | 任何能裝 Telegram 的手機 | iPhone |
| 你要準備 | 用 @BotFather 建一個自己的 bot | 註冊 Photon（photon.codes）帳號、建專案（Apple 沒有開放 iMessage 給第三方，所以要透過 Photon） |
| 配對 | 畫面產生 6 位數配對碼（10 分鐘有效），用手機傳給 bot | 同左，傳給 Photon 給你的號碼 |
| 對話對象 | 只有總管（隊員由總管去找） | 同左 |
| 照片 | 可以 | 可以；Linux 收不了 iPhone 的 HEIC 格式，要改成「最相容」或傳截圖，Mac 會自動轉 |
| 手機指令 | `/start` 看說明、`/clear` 清掉總管的對話重新開始 | 同左 |

- 電腦和 app 要開著才收得到訊息。
- 只有配對過的那支手機能下指令。
- 手機上看到的是純文字；需要按按鈕的事（例如刪除確認、登入網站）會請你到桌面版處理。
- 訊息會經過 Telegram 或 Photon 的伺服器（不經過我們），詳見[隱私說明](https://universebot.si/zh-tw/privacy/)。

## 權限檔位、上網開關和沙箱是什麼？

每個 agent 有一個權限檔位，決定它能碰你電腦上的哪些東西。上網搜尋是另外一個開關，預設關閉。權限能不能升級只由你決定，agent 不能替自己或別人提高權限。

| 檔位 | 能做的事 | 說明 |
|---|---|---|
| 僅對話 | 只能聊天和使用團隊工具 | 最安全，新建 agent 的預設檔位 |
| 讀取工作區 | 讀工作資料夾裡的檔案 | 不能改檔 |
| 讀寫工作區 | 讀寫工作資料夾、在沙箱裡執行指令 | 有沙箱隔離；網路預設不通，要連外可以設允許網域清單（例如一鍵套用「GitHub 常用」） |
| 完整權限 | 執行任意指令、存取整台電腦 | 沒有沙箱；只在沙箱工具不能用、而且你完全信任這個任務時才用 |

- 各家能選的檔位不一樣：Gemini CLI 沒有沙箱，所以不提供「讀寫工作區」；API key 型的 agent 只有「僅對話」。
- **工作資料夾**：全隊共用你家目錄底下的 `UniverseBot/workspace`，也可以替個別 agent 另外指定。
- **沙箱預設擋住的地方**：app 自己的資料夾、`~/.ssh`、`~/.config`、`~/.gnupg` 等。
- **允許上網搜尋**：每個 agent 一個開關，預設關，只有你能在畫面上打開。打開後 agent 可以用各家 CLI 內建的搜尋和開網頁，不受網域清單限制。
- agent 可以替別人調整權限，但最高只到「讀取工作區」。指揮官身分、外部 MCP、瀏覽器、上網開關、允許網域，都只有你能在畫面上給。
- Linux 要用「讀寫工作區」，需要先安裝 bubblewrap 和 socat；macOS 內建沙箱。

## 出錯時會怎樣？會自動重試嗎？

會先把錯誤分類。過載、伺服器錯誤、網路中斷這類暫時性錯誤會自動重試最多 2 次；額度用完、沒登入、模型不能用、對話太長則不重試，直接告訴你原因，並給你可以按的處理按鈕。

| 錯誤類別 | 畫面標示 | 處理方式 |
|---|---|---|
| 暫時性錯誤 | 連線錯誤 | 自動重試最多 2 次 |
| 額度用完 | 額度用完 | 顯示預計恢復時間；有設備用模型就自動切換 |
| 登入或金鑰錯誤 | 登入錯誤 | 請你檢查模型設定 |
| 模型無法使用 | 模型錯誤 | 提供「更換模型」按鈕 |
| 對話太長 | 對話過長 | 提供「清除對話」按鈕 |
| 其他 | 執行錯誤 | 顯示原因 |

## 備用模型是什麼？

備用模型是你替某個 agent 預先指定的第二個模型。主模型額度用完時會自動改用備用模型，工作不會中斷。預設關閉，每次切換都會在對話裡留下提示。

- 只有在「額度用完」時才會切換，其他錯誤不切。
- 切換時會把最近的對話一起帶過去，讓備用模型接得上。
- 主模型恢復後就換回來，也會補上備用期間的對話。
- ⚠️ 備用模型可能另外計費；免費模型可能會拿對話內容訓練。設定時請留意。

## 頭像可以用動圖嗎？

可以。頭像支援 GIF、WebP、APNG 動圖（檔案上限 5 MB），只在 agent 正在思考、工作或傳訊息時才會動。如果系統開了「減少動態效果」，就只顯示第一格。

## 其他

- **圖片附件**：一則訊息最多 10 張、單張 5 MB（Gemini CLI 的 agent 不支援）。
- **外部 MCP 伺服器**：可以替 Claude CLI 的 agent 掛上你自己的 MCP 伺服器（支援 stdio 與 HTTP），貼上 JSON 就能匯入。外部 MCP 伺服器不受沙箱限制，權限跟你本人一樣。
- **專案說明檔**：agent 的工作資料夾裡如果有 `AGENTS.md`／`CLAUDE.md`，會自動讀進去（合計上限 8 KB）。

## 即將推出

以下功能還沒有提供，完成後會在這裡更新。

- **從手機遠端使用桌面版（透過 Tailscale）**：目前桌面版只接受本機連線。
- **LINE 通道**：在 LINE 跟總管對話。
- **更多命令列工具**：例如 opencode、hermes。