節點控制台
節點控制台是 zqagent 的圖形介面:管理節點、建立專案、與 AI 對話、審核操作、檢視用量與成本, 都可以在這裡完成,無需敲命令。
開啟方式
| 場景 | 入口 | 說明 |
|---|---|---|
| 桌面 | 桌面應用 | 內建本地節點,開箱即用 |
| 瀏覽器 | 使用者中心 → 節點管理 → 選擇節點 | 遠端管理已接入的節點 |
| 手機 | 手機瀏覽器開啟使用者中心 | 響應式佈局 + PWA,可「新增到主螢幕」 |
遠端管理的前提是節點已接入使用者中心,見啟動節點。
節點與專案
- 節點管理:在使用者中心建立,一個節點管理可容納多臺裝置;節點列表顯示線上狀態, 點選進入節點控制台。
- 專案管理:一個專案對應節點上的一個工作目錄,是 AI 讀寫的範圍。 新建專案時可瀏覽節點目錄選擇工作目錄,避免手輸路徑出錯。
- 模型選擇:既可在節點級設定預設模型,也可為單個會話單獨指定。
頂欄可在節點與專案之間快速切換,並開啟專案管理彈窗統一維護。
會話工作台
- 會話列表:支援置頂與搜尋,快速定位歷史會話。
- 頁籤:同時開啟多個會話,頁籤狀態持久化(重新整理後仍在),支援右鍵選單與摺疊。
- 時間線:按時間線展示對話與工具呼叫,長會話可回看完整過程。
- 輸入草稿:未傳送的內容會自動儲存,切換會話、重新整理頁面後自動回填,不會白寫。
- 檔案編輯:內建編輯器支援撤回/重做、Markdown 高亮與滾動同步。
審核與提問
AI 請求有副作用的操作(寫檔案、執行命令等)或需要你補充資訊時,會在會話中彈出卡片:
- 審核可選四種決策:允許一次 / 總是允許此工具 / 總是允許此命令 / 拒絕; 「總是允許此命令」僅對
run_shell出現,按具體命令放行,比放行整個工具更安全。 - 提問支援內建選項與自由輸入。
未決的卡片會一直保留,可稍後處理。與 CLI 的審核語義一致,詳見 CLI 使用。
用量與成本
zqagent 會為每次模型呼叫記賬,彙總到節點與賬號兩個層面:
- 檢視用量:在專案首頁的 token 卡片,或節點詳情的「監控 → 檢視用量」開啟用量面板; 支援按時間範圍篩選、按天柱狀圖、按模型統計與明細列表,並可匯出 CSV。
- 價格表:內建常見模型(OpenAI / DeepSeek / Qwen / 智譜 / Moonshot 等)的預設單價, 可在「價格表」中按需修改,成本即按你的價格換算。
- 賬號級用量:登入使用者中心後,賬號頁可檢視跨節點的用量彙總。
即時與穩定性
- 會話通過即時事件流推送,斷線自動重連並按游標補齊增量:切到後臺再回來、網路抖動恢復後, 會話內容不會丟失或重複。
- 服務端定期傳送心跳,長時間無操作也不會被誤判為空閒而頻繁重連。
- 節點上下線、任務通知(審核/提問/錯誤)會即時提醒。
移動端
- 窄屏(≤ 720px)自動切換為單欄:頁簽在「概覽 / 控制台」間切換,會話列表與對話互相跳轉。
- 支援「新增到主螢幕」,以獨立視窗執行。
