v0.6.1

新增

• 合并知识库导航入口：左侧导航仅保留"知识库"，文档知识库与图知识库在页面 header 中通过同一组轻量切换入口切换
• 抽象页面轻量切换 header：知识库与扩展管理页直接共用 ViewSwitchHeader，收敛文档知识库、知识图谱、Tools、MCP、Subagents、Skills 等入口的信息层级
• 调整任务中心交互：入口移动到 GitHub 按钮下方，并将右侧抽屉展示改为居中弹窗
• 将 yuxi 从 uv workspace 成员调整为 backend/package 下可独立构建的本地 Python 包，backend 通过 path dependency 以已安装包形式发现依赖
• 新增 Skills 远程安装能力：Skills 管理页支持填写 owner/repo 或 GitHub URL，后端通过隔离的临时 HOME 调用 npx skills add 下载指定 skill
• 调整部门删除语义：删除部门时不再要求用户数为 0，而是将部门下用户迁移到默认部门
• 扩展 viewer 工作区文件操作：/home/gem/user-data/workspace 支持从文件系统面板新建文件夹和上传文件
• 为历史线程补充前端本地配置变更提示：当已有历史消息的对话中切换 Agent、切换配置或编辑配置项时，插入非持久化的信息提示
• 调整 Worker run 模式下的消息首屏反馈：前端发送消息时先乐观渲染用户消息，再将前端生成的 request_id 透传给 /api/chat/runs 与服务端 init 对账
• 调整聊天首页的智能体切换入口：当智能体数量 >= 4 或内容区宽度小于 380px 时自动收敛为"当前智能体 + 下拉按钮"形式
• 调整智能体对话中的工具调用展示：连续工具调用默认折叠为"调用了 N 个工具"的轻量摘要
• 调整输入框配置入口与侧边栏头尾交互：输入区配置按钮改为轻量 dropdown 触发器

修复

• 修复沙盒 workspace 隔离粒度：宿主机目录从共享 saves/threads/shared/workspace 收敛为用户级 saves/threads/shared/<user_id>/workspace
• 收紧文件系统安全边界：viewer/chat 下载与删除路径统一基于解析后的真实路径做允许目录校验，阻止通过软链接逃逸工作区/线程目录
• 修复 OIDC 原始用户名绑定中的占位用户解析：解析目标用户 ID 时改为从右侧拆分，避免 sub 中包含冒号时把已绑定账号误判成冲突账号
• 修复 DOCX 解析中的图片回插顺序：Docling 导出的多个 <!-- image --> 占位符现在按文档图片顺序替换
• 修复前端依赖安全告警：通过 pnpm.overrides 将传递依赖 flatted 锁定到 3.4.2、lodash-es 锁定到 4.18.1
• 修复对话摘要中间件的工具结果卸载链路：摘要触发时改为将大体积 ToolMessage 写入当前 agent 可见的 sandbox outputs 路径
• 修复 agents 页对话侧边栏在 keep-alive 路由切换后的误关闭问题
• 调整 Milvus 混合检索实现：集合 schema 增加 BM25 稀疏向量字段、BM25 函数和中文 analyzer 配置
• 重构 MCP 运行时配置加载模型：移除 MCP_SERVERS 作为运行正确性前提的设计，改为每次直接从数据库读取最新 MCP 配置
• 为知识库检索工具补充 metadata.filepath 注入：在 query_kb 统一出口基于会话可见知识库构建 file_id -> /home/gem/kbs/... 映射并回填 Milvus 检索结果

What's Changed

• feat: Enhance skill management with remote installation and file upload by @xerrors in #601
• feat (auth): 添加第三方登录认证（OIDC） by @DSYZayn in #592
• fix: 修复 sandbox 网络名称不匹配导致 agent 执行超时的问题 by @Utopin in #613
• 修复前端依赖高危漏洞：锁定 flatted / lodash-es 到安全版本 by @Copilot in #620
• docs(skills): add MiniMax-AI/cli as default skill tap by @octo-patch in #639
• Feature/OIDC enhancements by @szmadd in #644
• fix(auth): handle ':' in OIDC raw-username binding placeholders by @shaun0927 in #646

New Contributors

• @DSYZayn made their first contribution in #592
• @Utopin made their first contribution in #613
• @shaun0927 made their first contribution in #646

Full Changelog: v0.6.0...v0.6.1

v0.6.0 正式版

发布日期: 2026-04-02
发布类型: 正式版（Stable）

版本概览

v0.6.0 是围绕“智能体工程化 + 沙盒文件系统 + 扩展管理能力”完成的一次关键发布。核心能力已从 beta 阶段收敛到正式发布基线。

本版重点（基于 roadmap 汇总）

新增

• 后端代码目录重构到 backend/package/yuxi，工程结构更清晰。
• 新增 LITE 模式，支持轻量启动路径。
• 新增沙盒文件系统与交付物能力（present_artifacts、保存到工作区）。
• 新增 SubAgents 与内置 Skills 体系增强（安装/更新/移除机制重构）。
• 新增 API Key 认证能力。
• 新增知识库 PDF/图片预览能力。
• 新增 Langfuse 集成文档与配置路径。

修复

• 收敛状态工作台展示与交互逻辑，减少误触发。
• 修复 thread 与 agent_config 绑定错位导致的会话配置错乱。
• 修复 viewer/sandbox 文件系统可见性与目录加载问题。
• 修复 LightRAG 同库并发入库冲突问题。
• 修复文档部署工作流因 lockfile 策略导致的失败。

发布一致性修复（本次发版执行）

• 版本号统一为 0.6.0（backend/package/web）。
• compose 镜像标签统一为 0.6.0 语义版本（dev/prod 编排已对齐）。
• /api/system/health 返回新增 version 字段。
• README 发布入口从 beta3 切换到 0.6.0。

兼容性与变更说明

• 目标运行环境: Python 3.12+
• 发布形态: Docker Compose（dev/prod）
• 已知结构性变化: 后端代码目录已从 src 重构至 backend/package/yuxi

升级建议

1. 升级前备份 saves 与环境配置文件。
2. 同步更新镜像标签与环境变量模板。
3. 升级后先验证 /api/system/health 返回 version=0.6.0。
4. 重点回归 Skills/SubAgents/文件系统/知识库链路。

What's Changed

• fix: 修复ask_user_question接受json格式的字符串 by @szmadd in #569
• feat: add MiniMax as first-class LLM provider by @octo-patch in #574
• fix: 修复MCP服务器测试失败时返回成功的问题 by @szmadd in #578
• Feat/sandbox provisioner shared storage by @supreme0597 in #581
• 修复智能体配置列表在无默认配置场景下的 500 错误 by @Copilot in #587

New Contributors

• @szmadd made their first contribution in #569
• @octo-patch made their first contribution in #574
• @Copilot made their first contribution in #587

Full Changelog: v0.5.3...v0.6.0

v0.5.0

新增

• 优化 OCR 体验并新增对 Deepseek OCR 的支持
• 优化 RAG 检索，支持根据文件 pattern 来检索（Agentic Mode）
• 重构智能体对于“工具变更/模型变更”的处理逻辑，无需导入更复杂的中间件
• 重构知识库的 Agentic 配置逻辑，与 Tools 解耦
• 将工具与知识库解耦，在 context 中就完成解耦，虽然最终都是在 Agent 中的 get_tools 中获取
• 优化chunk逻辑，移除 QA 分割，集成到普通分块中，并优化可视化逻辑
• 重构知识库处理逻辑，分为 上传—解析—入库 三个阶段
• 重构 MCP 相关配置，使用数据库来控制 #469
• 使用 docling 解析 office 文件（docx/xlsx/pptx）
• 优化后端的依赖，减少镜像体积 #428
• 优化 liaghtrag 的知识库调用结果，提供 content/graph/both 多个选项
• 优化数据库查询工具，可通过设计环境变量添加描述，让模型更好的调用
• 优化任务组件，改用 postgresql 存储，并新增删除任务的接口
• 重构知识库文件系统，将附件与文件系统整合，文件系统使用 StateStore 存储

修复

• 修复知识图谱上传的向量配置错误，并新增模型选择以及 batch size 选择
• 修复部分场景下获取工具列表报错 #470
• 修改方法备注信息 #478
• 修复多次 human-in-the-loop 的渲染解析问题 #453 #475
• 修复消息加载逻辑导致的前端消息渲染延迟问题

What's Changed

• 数据库调整为 postgres / 添加基于部门的 Agent Context 管理 by @xerrors in #492
• feat: add keyword and hybrid retrieval for milvus by @jonasHanhan in #503
• feat: 上传文件新增基于URL获取和处理功能，需要配置白名单环境变量 by @xerrors in #506
• docs: 修正知识库文档中的笔误 (智能 -> 只能) by @Serious-H in #507
• fix: 修复新增对话时内容直接作为标题长度超出表字段长度限制问题， titile 字段长度限制为255 by @1165506270 in #518
• fix(agent): 修复附件状态同步：上传文件后 Agent 调用 read_file 无法读取用户附件问题 by @1165506270 in #519
• fix: 将 DeepAgent 的断言改为警告，使其在没有 Tavily Key 时也能加载出智能体选项并正常使用 by @floating21 in #522
• Fix embedding 400 errors by @holenzzz in #523

New Contributors

• @Serious-H made their first contribution in #507
• @1165506270 made their first contribution in #518
• @floating21 made their first contribution in #522
• @holenzzz made their first contribution in #523

Full Changelog: v0.4.4...v0.5.0

v0.4.0

相较于 v0.3

新增

• 新增对于上传附件的智能体中间件，详见文档
• 新增多模态模型支持（当前仅支持图片），详见文档
• 新建 DeepAgents 智能体（深度分析智能体），支持 todo，files 等渲染，支持文件的下载。
• 新增基于知识库文件生成思维导图功能（#335）
• 新增基于知识库文件生成示例问题功能（#335）
• 新增知识库支持文件夹/压缩包上传的功能（#335）
• 新增自定义模型支持、新增 dashscope rerank/embeddings 模型的支持
• 新增文档解析的图片支持，已支持 MinerU Officical、Docs、Markdown Zip格式
• 新增暗色模式支持并调整整体 UI（#343）
• 新增知识库评估功能，支持导入评估基准或者自动构建评估基准（目前仅支持Milvus类型知识库）详见文档
• 新增同名文件处理逻辑：遇到同名文件则在上传区域提示，是否删除旧文件
• 新增生产环境部署脚本，固定 python 依赖版本，提升部署稳定性
• 优化图谱可视化方式，统一图谱数据结构，统一使用基于 G6 的可视化方式，同时支持上传带属性的图谱文件，详见文档
• 优化 DBManager / ConversationManager，支持异步操作
• 优化 知识库详情页面，更加简洁清晰，增强文件下载功能
• 优化消息反馈信息的加载逻辑 44ede4d

修复

• 修复重排序模型实际未生效的问题
• 修复消息中断后消息消失的问题，并改善异常效果
• 修复当前版本如果调用结果为空的时候，工具调用状态会一直处于调用状态，尽管调用是成功的
• 修复检索配置实际未生效的问题 3b03a91
• 修复 SQL 工具重新加载的问题
• 修复前端异常多次调用智能体信息的问题

破坏性更新

• 移除 Chroma 的支持，当前版本标记为移除
• 移除模型配置预设的 TogetherAI

Full Changelog: v0.3.0...v0.4.0

v0.4.0-beta

相较于 v0.3

新增

• 新增对于上传附件的智能体中间件，详见文档
• 新增多模态模型支持（当前仅支持图片），详见文档
• 新建 DeepAgents 智能体（深度分析智能体），支持 todo，files 等渲染，支持文件的下载。
• 新增基于知识库文件生成思维导图功能（#335）
• 新增基于知识库文件生成示例问题功能（#335）
• 新增知识库支持文件夹/压缩包上传的功能（#335）
• 新增自定义模型支持、新增 dashscope rerank/embeddings 模型的支持
• 新增文档解析的图片支持，已支持 MinerU Officical、Docs、Markdown Zip格式
• 新增暗色模式支持并调整整体 UI（#343）
• 新增知识库评估功能，支持导入评估基准或者自动构建评估基准（目前仅支持Milvus类型知识库）详见文档
• 新增同名文件处理逻辑：遇到同名文件则在上传区域提示，是否删除旧文件
• 新增生产环境部署脚本，固定 python 依赖版本，提升部署稳定性
• 优化图谱可视化方式，统一图谱数据结构，统一使用基于 G6 的可视化方式，同时支持上传带属性的图谱文件，详见文档
• 优化 DBManager / ConversationManager，支持异步操作
• 优化 知识库详情页面，更加简洁清晰，增强文件下载功能

修复

• 修复重排序模型实际未生效的问题
• 修复消息中断后消息消失的问题，并改善异常效果
• 修复当前版本如果调用结果为空的时候，工具调用状态会一直处于调用状态，尽管调用是成功的
• 修复检索配置实际未生效的问题

破坏性更新

• 移除 Chroma 的支持，当前版本标记为移除
• 移除模型配置预设的 TogetherAI

Full Changelog: v0.3.0...v0.4.0-beta

v0.3.6

What's Changed

新增

• 优化知识库详情页面，更加简洁清晰
• 新增对于上传文件的智能体中间件
• 增强文件下载功能
• 新增多模态模型支持（当前仅支持图片，详见文档）
• 新建 DeepAgents 智能体（Demo），支持 todo，files 等渲染。
• 新增基于知识库文件生成思维导图功能（#335）
• 新增基于知识库文件生成示例问题功能（#335）
• 新增知识库支持文件夹/压缩包上传的功能（#335）
• 新增自定义模型支持、新增 dashscope rerank/embeddings 模型的支持
• 新增文档解析的图片支持，已支持 MinerU Officical、Docs、Markdown Zip格式
• 新增暗色模式支持并调整整体 UI（#343）
• agent 状态中的文件区域，新增可以下载
• 移除 Chroma 的支持，当前版本标记为移除
• 新增知识库评估功能，支持导入评估基准或者自动构建评估基准（目前仅支持Milvus类型知识库）

修复

• 修复重排序模型实际未生效的问题
• 修复消息中断后消息消失的问题，并改善异常效果
• 修复当前版本如果调用结果为空的时候，工具调用状态会一直处于调用状态，尽管调用是成功的
• 修复检索配置实际未生效的问题

New Contributors

• @supreme0597 made their first contribution in #332
• @Hisn00w made their first contribution in #343

Full Changelog: v0.3.0...v0.3.6-beta

v0.2.0

v0.2.0 (2025-08-25)

新功能与重要改进

知识库功能增强

• 实现知识库删除时自动清理Milvus和Neo4j数据
• 添加知识库数据导出功能（进行中）
• 支持Milvus、Chroma、LightRAG类型的知识库
• 添加文件处理队列管理功能，解决高并发处理时的显存资源不足问题
• 添加自动索引功能，优化文件处理流程
• 支持CSV、Excel和JSON文件格式
• 添加批量文件上传和转换为Markdown功能
• 检索内容以字典形式返回，包含filepath等metadata
• 文件列表按创建时间倒序排序

LightRAG 集成

• 添加LightRAG知识库的语言选择和LLM模型选择功能
• 支持动态选择LLM提供者和名称的环境变量配置
• 添加LightRAG图谱可视化功能
• 添加PostgreSQL支持和环境变量配置

智能体与工具系统

• 重构智能体相关逻辑至Pinia store
• 将智能体相关的名称参数统一更改为ID，优化API调用
• 添加异步工具支持，优化工具检索和LLM调用逻辑
• 重构工具工厂模块，优化工具管理和错误处理
• 添加工具路由，更新聊天和智能体相关功能

用户界面优化

• 重构智能体配置为侧边栏形式并优化交互
• 优化聊天界面样式和交互体验
• 重构登录页和主页UI设计，优化品牌信息配置
• 调整组件样式和布局细节，统一使用新的颜色变量
• 改进登录按钮样式并优化首页视觉效果
• 为文件名添加文件类型图标和颜色
• 优化助手消息组件和计算器结果展示
• 添加工具调用结果组件
• 添加系统信息配置功能

OCR 功能增强

• 增强OCR处理功能，支持图像解析和参数传递
• 添加PaddleX OCR支持及示例更新
• 添加OCR服务健康检查和统计功能
• 优化PDF解析逻辑，增强错误处理机制

知识图谱改进

• 改进智能体界面对于知识图谱检索结果的渲染稳定性和数据格式兼容性
• 重构知识图谱查询和格式化逻辑
• 改进图数据库查询逻辑和错误处理
• 在图数据库视图添加说明弹窗并优化界面

系统与部署优化

• 更新Docker配置，添加Milvus令牌支持，优化健康检查命令
• 更新docker-compose配置，优化GPU设备和环境变量设置
• 更新模型服务脚本和配置，支持Qwen3系列模型
• 添加健康检查接口和前端支持
• 添加分享对话功能，支持导出为HTML文件

Bug 修复

• 修正知识图谱查询日志中的类型判断错误
• 修正登录背景图片路径中的拼写错误
• 修复代理配置和文档错误，更新默认模型
• 修复创建数据库时缺少await导致的问题
• 修复当node_modules为空的时候无法挂载volumes的问题
• 过滤掉macOS的隐藏文件以避免上传错误
• 修复Thread Table没有自动创建的问题
• 修复重命名对话时未指定对话ID或标题的警告逻辑

重构与优化

• 重构API模块结构，合并智能体相关功能
• 移除未使用的HistoryManager类及其引用
• 移除qianfan模型相关代码和依赖
• 移除零一万物模型支持并更新相关文档和配置
• 优化知识库获取逻辑，提升性能和数据处理效率
• 简化文件路径处理逻辑
• 优化知识库检索结果组件，增强文件分组展示和详细信息弹窗
• 优化聊天组件功能，优化消息展示和滚动逻辑
• 优化时间格式化函数

文档更新

• 添加批量上传和解析脚本的使用说明到README
• 更新README，添加本地模型配置和常见问题解答
• 更新默认模型和文档说明
• 更新文档内容并添加相关图片
• 增加分支的说明

依赖更新

• 更新mineru依赖为mineru[core]，简化文档解析逻辑
• 更新Python版本和依赖项
• 在依赖组中添加ruff依赖，优化代码中的类型提示和异常处理