QzAgent智能体平台 v2.0 核心功能升级

一、/goal 目标模式 —— Agent 自主循环执行

功能概述

/goal 模式是 QzAgent v2.0 引入的三大 Loop 模板之一（普通模式 / 任务模式 / 目标模式），允许用户设定一个目标后，Agent 围绕该目标持续执行，通过 Rubric 评估自动判断是否完成。

goal循环模式

技术架构

该模式基于炙手可热的 循环工程Loop Engineering 架构实现，核心由三层门控（Gate）协同控制循环终止：

核心代码路径

• 模式定义：[goal_mode.py]
• 门控实现：[gates.py]
• Rubric 评估：[rubric.py]
• 工具集：get_goal、create_goal、update_goal（[tools.py])

工作流程

1. 用户输入 /goal <目标描述> 激活模式
2. 系统创建 GoalSession，初始化迭代计数器和 Token 预算
3. Agent 每轮执行后，通过 GoalStatusRubric 检查 session.active 状态
4. Agent 可调用 update_goal(status="complete") 主动标记完成
5. 达到最大轮次或 Token 预算耗尽时自动终止

二、消息锚点导航 —— 用户轮次跳转器

功能概述

消息锚点（Message Anchor） 是 v2.0 新增的控制台交互特性，在长会话中自动提取所有用户轮次，提供快速跳转导航，解决大上下文会话中"找不到历史提问"的痛点。

技术实现

• 组件配置：在 Chat 页面配置中通过 userMessageAnchors 开启
• Variant 模式：navigator —— 以导航面板形式展示用户轮次列表

const userMessageAnchorsConfig = {
  ...defaultConfig.theme.bubbleList.userMessageAnchors,
  variant: "navigator" as const,
};

交互特性

• 自动汇总当前会话中的所有用户提问
• 点击任意锚点即可平滑滚动至对应消息位置
• 齿轮图标支持配置导航行为（如过滤条件）

三、会话抽屉日期分类 —— 智能会话管理

功能概述

v2.0 重构了会话列表的展示逻辑，引入日期分组 + 内联搜索机制，将历史会话按时间维度自动归类，大幅提升历史会话的查找效率。

分组策略

实现代码位于 [sessionGrouping.ts]

const order: Array<{ key: DateGroup; fallback: string }> = [
  { key: "pinned",   fallback: "Pinned" },
  { key: "today",    fallback: "Today" },
  { key: "week",     fallback: "Within 7 days" },
  { key: "month",    fallback: "Within 30 days" },
  { key: "older",    fallback: "Earlier" },
];

技术亮点

• Pinned 置顶：用户可固定重要会话，始终展示在顶部
• 时间桶分组：按更新时间自动落入 today / week / month / older 四个桶
• 虚拟化渲染：SidebarSessionList 采用 react-window 虚拟化，支持大量会话流畅滚动
• 内联搜索：支持按会话名称实时过滤，搜索时自动切换为扁平列表

性能优化

• 日期格式化结果缓存（避免重复 new Date()）
• 轮询去重机制
• ISO 8601 字符串直接字典序比较，无需解析

四、会话级工具审批策略

总结

QzAgent v2.0 围绕 "让 Agent 更自主、让交互更高效、让管理更智能" 三个维度进行了深度升级：

1. /goal 模式赋予 Agent 目标驱动的持续执行能力，通过多层门控保障安全
2. 消息锚点导航解决了长会话中的定位难题，提升用户操作效率
3. 日期分类会话抽屉结合虚拟化和缓存策略，实现了海量会话的高效管理
4. 会话级审批策略提供了精细化的安全控制能力，满足不同场景的风险偏好

这些升级均已在 v2.0.0 版本中完整发布。