啟動
vibex status 在出問題時應該第一個執行:它會說明這個 home 會用哪種執行階段、連哪個端點,以及為什麼。
本機模式與遠端模式
如果 home 被鎖住、桌面端又沒允許 TUI 接入,客戶端會列印它嘗試過的端點和三種出路:在桌面端開啟 設定 → 常規 → Vibex TUI、退出桌面端,或連線到另一個執行階段。
介面
介面是一列全寬橫帶:狀態、對話流、回合狀態、輸入框和快捷鍵欄。視窗變窄時,裝飾、佇列和狀態帶會先讓位,對話流和輸入框保留;沒有最小尺寸,也不會彈“視窗太小”。- 結束的回合折在
▸ Worked for 12s分隔線後面,點它或按e展開。 - 滾走的使用者訊息會釘在視口上方,不會隨著滾動消失。
/在對話流裡搜尋,支援智慧大小寫正則;n/p跳轉匹配。- 拖選文本會通過 OSC 52 複製,SSH 和 tmux 裡也能用。
- 長貼上收成
[Pasted: 42 lines]晶片,圖片從剪貼簿、貼上或拖入檔案變成晶片。 - 狀態帶顯示工作區、連線狀態和當前模式;回合狀態行顯示正在執行的工具、耗時和核准數。
輸入框
執行中寫下的訊息會進入佇列,回合結束後自動發出。佇列屬於它寫入的會話:切走再回來,它還在原處。
會話
vibex 開啟時預設落在當前目錄的新會話頁,目錄和上次使用的執行階段已經填好。直接輸入第一條訊息即可建立會話;標題來自這條訊息。
n新建會話,Ctrl+W改工作區,Ctrl+G開啟 Agent 設定。Ctrl+L或1開啟會話列表;Esc在輸入頁和列表之間切換。- 會話列表按桌面端的排布繪製,支援置頂、重新命名、分叉、歸檔、分組和拖動排序。
- 委派的子會話以樹形分支顯示,行尾的開關展開分支。
e開啟選中行的詳情,c關閉所有詳情卡,y複製會話資訊。
核准、提問與佇列
Agent 的請求就地出現:- 核准是頁面上的卡片:
a允許,d拒絕,Ctrl+A本會話始終允許。 - 提問佔據輸入框橫帶,用
Tab在欄位間移動,Enter提交。 - 自動繼續保留桌面端的五秒倒計時;
t停止本次自動繼續。 - 佇列用
Alt+↑↓選行,Alt+E拉回草稿,Alt+X刪除,Alt+J/K調整順序,Alt+Enter打斷當前回合並立即傳送。 Alt+D開啟 Dock,集中顯示正在執行的子 Agent、計劃和被持有的訊息。
管理、配對與設定
管理頁是桌面風格的配置中心,包含 Agent、Providers、Model、MCP、Skill、Prompt 和 配對與遠端訪問。只顯示當前執行階段真的能提供的操作;沒有權限的操作會說明原因,而不是消失。 配對頁把 配對、已配對裝置 和 遠端訪問 放在同一個標籤條裡:- 二維碼、一次性配對碼和連結都在面板裡生成。
- 一次配對會攜帶執行階段釋出的所有路由,用
[/]切換。 - 本機區域網配對視窗用
a允許、r拒絕。 - 已配對裝置可以撤銷,並檢視遠端協議審計。
en / zh-CN / zh-TW)、圖示集、著陸 logo、動效、推理顯示、預設工作區和鍵位繫結。所有選擇寫入 ~/.vibex/tui-interface.json,鍵位寫入 ~/.vibex/tui-keys.toml。
快捷鍵速查
鍵位可以在設定裡逐項修改;衝突的鍵位會被拒絕,並指出已經佔用它的動作。TUI 也會讀取
~/.vibex/tui-keys.toml。
通知與終端機行為
通知通過終端機轉義序列送達。附著到桌面端時,通知通道會讓給桌面端,同一個事件只從一個通道來。 TUI 會接管終端機的鍵盤協議:支援擴充套件鍵的終端機能區分Enter 和 Shift+Enter;不支援的終端機退回 Ctrl+J 換行。複製使用 OSC 52,所以在 SSH 和 tmux 裡也能工作。
限制
TUI 專注於會話和執行階段的可操作性,不是桌面工作台的完整替代:- 不提供檔案編輯器、Markdown/PDF/Office 預覽、內嵌瀏覽器或電腦操作面板。
- 圖片附件以終端機能顯示的方式呈現,複雜圖片仍建議在桌面端檢視。
- 遠端模式下沒有原生引導,
Ctrl+S會退化為打斷並重發。 - 電腦操作和瀏覽器面板的即時畫面不在 TUI 中提供。