Skip to content

节点控制台 ​

节点控制台是 zqagent 的图形界面:管理节点、创建项目、与 AI 对话、审批操作、查看用量与成本, 都可以在这里完成,无需敲命令。

打开方式 ​

场景入口说明
桌面桌面应用内置本地节点,开箱即用
浏览器用户中心 → 节点管理 → 选择节点远程管理已接入的节点
手机手机浏览器打开用户中心响应式布局 + PWA,可「添加到主屏幕」

远程管理的前提是节点已接入用户中心,见启动节点。

节点与项目 ​

  • 节点管理:在用户中心创建,一个节点管理可容纳多台设备;节点列表显示在线状态, 点击进入节点控制台。
  • 项目管理:一个项目对应节点上的一个工作目录,是 AI 读写的范围。 新建项目时可浏览节点目录选择工作目录,避免手输路径出错。
  • 模型选择:既可在节点级设置默认模型,也可为单个会话单独指定。

顶栏可在节点与项目之间快速切换,并打开项目管理弹窗统一维护。

会话工作台 ​

  • 会话列表:支持置顶与搜索,快速定位历史会话。
  • 页签:同时打开多个会话,页签状态持久化(刷新后仍在),支持右键菜单与折叠。
  • 时间线:按时间线展示对话与工具调用,长会话可回看完整过程。
  • 输入草稿:未发送的内容会自动保存,切换会话、刷新页面后自动回填,不会白写。
  • 文件编辑:内置编辑器支持撤回/重做、Markdown 高亮与滚动同步。

审批与提问 ​

AI 请求有副作用的操作(写文件、执行命令等)或需要你补充信息时,会在会话中弹出卡片:

  • 审批可选四种决策:允许一次 / 总是允许此工具 / 总是允许此命令 / 拒绝; 「总是允许此命令」仅对 run_shell 出现,按具体命令放行,比放行整个工具更安全。
  • 提问支持内置选项与自由输入。

未决的卡片会一直保留,可稍后处理。与 CLI 的审批语义一致,详见 CLI 使用。

用量与成本 ​

zqagent 会为每次模型调用记账,汇总到节点与账号两个层面:

  • 查看用量:在项目首页的 token 卡片,或节点详情的「监控 → 查看用量」打开用量面板; 支持按时间范围筛选、按天柱状图、按模型统计与明细列表,并可导出 CSV。
  • 价格表:内置常见模型(OpenAI / DeepSeek / Qwen / 智谱 / Moonshot 等)的默认单价, 可在「价格表」中按需修改,成本即按你的价格换算。
  • 账号级用量:登录用户中心后,账号页可查看跨节点的用量汇总。

实时与稳定性 ​

  • 会话通过实时事件流推送,断线自动重连并按游标补齐增量:切到后台再回来、网络抖动恢复后, 会话内容不会丢失或重复。
  • 服务端定期发送心跳,长时间无操作也不会被误判为空闲而频繁重连。
  • 节点上下线、任务通知(审批/提问/错误)会实时提醒。

移动端 ​

  • 窄屏(≤ 720px)自动切换为单栏:页签在「概览 / 控制台」间切换,会话列表与对话互相跳转。
  • 支持「添加到主屏幕」,以独立窗口运行。

下一步 ​

Last updated: