Skip to content

v2.0 | 工具升级+体验优化

Latest

Choose a tag to compare

@finch04 finch04 released this 28 Jun 11:48
· 226 commits to main since this release

Added

  • 对话可靠性增强:SSE 心跳保活、断线重连、事件恢复和结构化流式错误事件。
  • 对话流式体验增强:平滑流式输出、打字光标、重连提示、模型调用可恢复错误重试和友好错误提示。
  • 对话基础体验增强:消息引用回复、引用消息跳转、消息收藏、消息编辑重发、重新生成、快捷键、输入历史回溯和对话导出。
  • 对话数据能力增强:Token 实时统计、Token 预算控制、消息反馈、RAG 引用反馈、工具调用元数据展示和参数详情展示。
  • ask_user 用户追问能力:Agent 可在信息不足时主动向用户提问,前端弹窗收集回答,并将用户补充与原工具调用消息建立关联。
  • 工具调用展示增强:对话页支持展示工具调用状态、工具参数、工具结果、错误块和工具调用摘要。
  • 图片生成能力增强:支持 AI 图片生成,并优化前端图片展示、预览和消息关联资源清理。
  • 附件与多模态体验增强:聊天附件支持图片、视频、文档预览,文档内容可解析后注入对话上下文。
  • Agent 能力增强:Agent 克隆、系统提示词变量预览、版本配置快照预览、模型能力配置预览和绑定依赖提示。
  • SubAgent 能力增强:SubAgent 执行过程可观测,支持展示 token、工具调用、工具结果和最终结果,并增加墙钟超时控制。
  • Skill 能力增强:Skill 在线编辑、Markdown 预览、文件树管理、Skill 依赖检查、远程安装预览和安装提交流程。
  • MCP 能力增强:MCP 工具热更新、工具刷新、最后同步时间展示和 Skill / Agent 依赖提示。
  • 沙箱能力增强:新增代码执行工具,支持 Java、JavaScript、Python 调用;脚本执行统一接入沙箱服务。
  • 沙箱文件能力增强:支持基于 MinIO 的虚拟文件系统,区分 Skill 只读目录和会话工作区可写目录。
  • RAG 能力增强:URL 文档增量同步、重复文档检测、查询参数推荐配置、查询改写、RAG 反馈闭环和检索结果缓存大小限制。
  • 知识库文档能力增强:URL 预览、自定义请求头、同步间隔、内容 hash 检测、文档预览和 chunk 预览能力。
  • 工作流可靠性增强:条件分支默认路径校验、变量面板、节点超时配置、失败重试能力和脚本节点错误策略。
  • 工作流调试体验增强:测试执行时可查看中间变量快照,节点配置面板支持更多运行时参数。
  • API Key 能力增强:API Key 认证、Agent 作用域、调用限流、每日 Token 配额、Token 用量扣减和重新生成能力。
  • API Key 管理增强:前端支持配置限流、配额、Agent 绑定,并展示 Key 前缀、启用状态和用量信息。
  • 模型提供商扩展:新增 DeepSeek、Ollama、小米 MiMo 等模型提供商接入能力。
  • 模型提供商预设增强:新增 OpenAI、DeepSeek、智谱、Moonshot、MiniMax、DashScope 兼容模式、SiliconFlow、OpenRouter、ModelScope、Z.AI、火山 AgentPlan 等 OpenAI 兼容预设。
  • 模型提供商管理增强:支持表单配置默认模型、模型列表拉取、连通性检查指定模型、Ollama 无 API Key 检查和高级请求头配置。
  • 模型调用增强:默认优先使用提供商配置中的默认模型,未指定时回退到 Handler 内置低成本模型。
  • 观测能力增强:增强观测功能界面和数据追踪能力,优化 LLM Trace、Tool Call 等链路数据展示。
  • 生产环境优化:数据库复合索引、pgvector HNSW 调优、Milvus 集合检查缓存、Redis 缓存体系、MinIO 文件存储优化和消息列表虚拟滚动。
  • 前端工程体验增强:暗色主题、CSS 变量体系、实体卡片组件优化、工具选择弹窗详情、MarkdownPreview 组件增强和页面交互简化。
  • 发布工程增强:版本号升级到 2.0.0,补充发布说明、CHANGELOG、ROADMAP、ARCHITECTURE、QUICKSTART 和初始化 SQL 合并脚本。

Changed

  • 版本号从 v1.0 升级到 v2.0.0,发布重点从基础功能可用升级为稳定性、可观测性、企业级可靠性治理和模型接入体系扩展。
  • 对话服务进一步中间件化,统一处理初始化、敏感词、工作流短路、Skill 准备、消息构建、工具准备、追踪和流式输出。
  • 聊天链路从“只返回模型文本”调整为“文本 + 工具事件 + 工作流事件 + SubAgent 事件 + 错误事件”的统一事件流。
  • 前端 UI 样式统一迁移到 CSS 变量,增强暗色主题适配和组件一致性。
  • 模型调用默认优先使用提供商配置中的默认模型,未指定时回退到处理器内置低成本模型。
  • 模型提供商配置继续保持 JSONB 扩展方式,默认模型、completionsPath 等动态参数不单独拆列。
  • Skill 运行时从“直接注入完整提示词”调整为“摘要注入 + 按需读取完整 Skill”的懒激活方式。
  • 工作流节点配置从静态编排扩展为可配置超时、重试、错误策略的运行时治理模型。
  • RAG 从基础向量检索升级为“同步、去重、改写、参数预设、反馈闭环”的持续优化链路。
  • Trace 概览统计从 Java 内存聚合调整为 SQL 聚合,降低大数据量下的 JVM 和数据库传输压力。
  • 工具选择、实体卡片、模型供应商管理、Agent 绑定等页面交互进一步简化。
  • 前端搜索、防抖、列表渲染、消息滚动和长对话展示做了体验优化。

Fixed

  • 修复流式模型调用失败时前端只看到连接关闭、无法识别错误原因的问题。
  • 修复 SSE 连接在长时间工具调用或模型推理期间容易被代理空闲断开的问题。
  • 修复工具执行超时、消息跳转、消息关联和文件清理相关问题。
  • 修复聊天界面和会话管理中的若干交互问题。
  • 修复工具结果显示组件纯文本渲染问题。
  • 修复知识库工具绑定校验和界面组件样式问题。
  • 修复 ask_user 工具弹窗发送按钮禁用态继承 primary 黑色背景的问题,统一使用全局按钮禁用态样式。
  • 修复暗色主题下部分组件颜色、边框和背景不一致问题。
  • 修复工作流克隆和部分 UI 暗色适配问题。
  • 修复版本配置 JSON 解析失败静默丢失、排查困难的问题,增加 warn 日志提示。
  • 修复消息附件、AI 生图资源、工具调用元数据等关联清理不完整的问题。
  • 修复多个 N+1 查询问题,减少重复查询导致的性能下降。
  • 修复部分 Java 内存聚合导致的大数据量统计性能问题。
  • 修复模型供应商、工具选择、AgentDetail 等页面部分交互和样式问题。
  • 修复安全漏洞和权限控制相关问题,降低越权访问风险。

Security

  • API 工具执行链路加入 SSRF 防护、认证头构建和参数位置校验。
  • API Key 增加限流、作用域校验和配额控制,降低外部调用滥用风险。
  • API Key 明文只在创建和重新生成时返回,数据库只存 hash 和 keyPrefix。
  • 沙箱代码执行增加危险关键字、危险 import、执行超时、环境变量清理和路径白名单限制。
  • 沙箱文件系统限制 skills/ 只读、sessions/ 可写,避免 Agent 任意读写服务器路径。
  • 业务错误信息统一通过后端友好提示返回,前端优先展示业务错误信息,避免 HTTP 状态码覆盖业务语义。
  • 多处权限控制和资源归属校验增强,例如引用消息必须属于当前会话、API Key 必须满足 Agent 作用域。
  • 远程 Skill 安装流程增加草稿区和 ZIP 路径安全检查,降低远程包直接污染正式 Skill 的风险。

Removed

  • 移除已合并的 CUSTOM 工具类型概念,统一纳入 API 工具体系。
  • 移除部分硬编码颜色值,统一迁移到 CSS 变量体系。
  • 移除部分无界缓存和高风险内存聚合写法,改为有边界缓存或数据库聚合。
  • 移除部分重复 UI 逻辑和分散的绑定管理逻辑,改为更统一的组件和交互结构。