Skip to content

節點控制台 ​

節點控制台是 zqagent 的圖形介面:管理節點、建立專案、與 AI 對話、審核操作、檢視用量與成本, 都可以在這裡完成,無需敲命令。

開啟方式 ​

場景入口說明
桌面桌面應用內建本地節點,開箱即用
瀏覽器使用者中心 → 節點管理 → 選擇節點遠端管理已接入的節點
手機手機瀏覽器開啟使用者中心響應式佈局 + PWA,可「新增到主螢幕」

遠端管理的前提是節點已接入使用者中心,見啟動節點。

節點與專案 ​

  • 節點管理:在使用者中心建立,一個節點管理可容納多臺裝置;節點列表顯示線上狀態, 點選進入節點控制台。
  • 專案管理:一個專案對應節點上的一個工作目錄,是 AI 讀寫的範圍。 新建專案時可瀏覽節點目錄選擇工作目錄,避免手輸路徑出錯。
  • 模型選擇:既可在節點級設定預設模型,也可為單個會話單獨指定。

頂欄可在節點與專案之間快速切換,並開啟專案管理彈窗統一維護。

會話工作台 ​

  • 會話列表:支援置頂與搜尋,快速定位歷史會話。
  • 頁籤:同時開啟多個會話,頁籤狀態持久化(重新整理後仍在),支援右鍵選單與摺疊。
  • 時間線:按時間線展示對話與工具呼叫,長會話可回看完整過程。
  • 輸入草稿:未傳送的內容會自動儲存,切換會話、重新整理頁面後自動回填,不會白寫。
  • 檔案編輯:內建編輯器支援撤回/重做、Markdown 高亮與滾動同步。

審核與提問 ​

AI 請求有副作用的操作(寫檔案、執行命令等)或需要你補充資訊時,會在會話中彈出卡片:

  • 審核可選四種決策:允許一次 / 總是允許此工具 / 總是允許此命令 / 拒絕; 「總是允許此命令」僅對 run_shell 出現,按具體命令放行,比放行整個工具更安全。
  • 提問支援內建選項與自由輸入。

未決的卡片會一直保留,可稍後處理。與 CLI 的審核語義一致,詳見 CLI 使用。

用量與成本 ​

zqagent 會為每次模型呼叫記賬,彙總到節點與賬號兩個層面:

  • 檢視用量:在專案首頁的 token 卡片,或節點詳情的「監控 → 檢視用量」開啟用量面板; 支援按時間範圍篩選、按天柱狀圖、按模型統計與明細列表,並可匯出 CSV。
  • 價格表:內建常見模型(OpenAI / DeepSeek / Qwen / 智譜 / Moonshot 等)的預設單價, 可在「價格表」中按需修改,成本即按你的價格換算。
  • 賬號級用量:登入使用者中心後,賬號頁可檢視跨節點的用量彙總。

即時與穩定性 ​

  • 會話通過即時事件流推送,斷線自動重連並按游標補齊增量:切到後臺再回來、網路抖動恢復後, 會話內容不會丟失或重複。
  • 服務端定期傳送心跳,長時間無操作也不會被誤判為空閒而頻繁重連。
  • 節點上下線、任務通知(審核/提問/錯誤)會即時提醒。

移動端 ​

  • 窄屏(≤ 720px)自動切換為單欄:頁簽在「概覽 / 控制台」間切換,會話列表與對話互相跳轉。
  • 支援「新增到主螢幕」,以獨立視窗執行。

下一步 ​

Last updated: