2.12.182026-11-22
新增
- 平台管理 › 运维任务新增每日数据库备份(默认开启):元数据库与图谱库分别导出并保留最新 7 份,可配置外部 S3 备份目标,页面提供备份清单、存储用量和恢复命令。
- 通知规则新增两类平台告警:依赖不可用(按依赖去重、恢复后自动关闭)与维护任务失败;API 进程内置直发兜底,数据库不可读或索引 worker 心跳中断持续数分钟时直接向已启用渠道发送一次告警。
- 接入方:
apemindCLI 检索结果全部只有弱命中时不再隐藏候选(会列出候选与下一步提示);apemind grep新增-l/--files-with-matches只列命中文档,并对几个常见误猜参数给出更正提示。
改进
- 代码模式的知识检索(search / read / grep)与沙箱命令启动更快:文档锚点元数据缓存、锚点查询批量化、沙箱配置与出网桥轮询优化。
- 平台管理 › 运维任务:备份目标与备份历史分开显示错误并可单独重试,首次读取期间显示容量加载状态,页面隐藏时减少轮询、收起或切换历史时取消在途读取。
- 组织设置页转移所有权时的候选成员列表更精简,大组织下打开更快。
修复
- 未开启知识图谱的知识库调用图谱实体查询不再报 400,正常返回「图谱未开启」;dac 隔离档位下文件工具不再拒绝工作区自身的真实路径。
- 已删除文档的清理重试改为按上次尝试时间指数退避,重试预算从约 50 分钟拉长到约 23 小时,可覆盖迁移 / 维护窗口;清理死信积压新增告警。
不兼容变更
- 私有化部署:每日数据库备份默认开启,导出文件会占用本地存储并保留最新 7 份;不需要时可在「平台管理 › 运维任务」关闭该任务,或改配外部 S3 目标。
2.12.172026-11-21
新增
- 平台管理新增「运维任务」页:定时清理(审计日志、LLM / API 调用账本、限流拒绝明细、图谱治理记录等)改为应用内调度,可以在页面上开关任务、调整执行时间和保留天数,并支持立即执行、试运行和查看执行历史。
- 创建邮箱连接时按邮箱地址自动识别服务商;「连接」的 MCP / HTTP 创建表单按步骤引导重做。
改进
- 组织模型、组织配额等管理页面在读取期间显示加载状态;管理后台读取 IM 设置时先显示中性加载状态,不再闪出默认值。
- 切到后台的标签页不再自动轮询工作区状态和授权用量,回到前台时再刷新。
修复
- 通知渠道面板里未发送的搜索草稿不再误标到投递明细行。
- 授权用量页在多次刷新重叠时保留最新一次的结果。
不兼容变更
- 私有化部署:五项定时清理任务由 Chart 的独立 CronJob 改为应用内调度(见「平台管理 › 运维任务」),升级后旧 CronJob 自动移除,原有清理配置继续作为默认值生效,无需改动。
2.12.162026-11-20
改进
- 「连接」页按新设计重做:连接名称直接作为标题编辑,字段默认值跟随自动识别结果,创建过程按步骤引导,缺少必需凭据时给出明确提示。
- 管理后台「可观测性」的进程指标区块和通知渠道面板在筛选与切换时更快。
修复
- 图谱自动合并现在按归一后的实体类型比较:同一对象在不同解析窗口被识别为近义类型(如「技术」与「技术术语」)时,别名证据可以生效,不再被拆成两个实体。
2.12.152026-11-20
改进
- 工作区七个配置页按新设计简化:新建 / 编辑知识库把低频选项收进「处理与模型」并显示摘要,空知识库直接给上传入口,定时任务计划改成一句话设置并显示「下次运行」时间,函数「能访问什么」只列已授权资源,添加数据源从五步缩成两步,提示词管理改为列表加抽屉编辑并在保存前校验。
- 管理后台失败任务、组织角色和组织标签等页面在筛选和编辑时更快;切换索引层时先到的结果先显示,不再等无关层返回。
修复
- 知识库「图谱实体合并裁决」提示词的用户自定义版本此前不生效,现在按知识库所有者解析。
2.12.142026-11-20
新增
- 新建连接改为按服务商分步引导:邮箱按服务商给出设置步骤并支持粘贴分组授权码;飞书 / Lark 支持粘贴应用凭证、按用途生成授权链接;GitHub、数据库、MCP、HTTP、Telegram、Slack 可以从连接串、JSON、curl 或令牌自动识别填表。
- 飞书连接支持扫码创建:扫码后在企业里自动建好应用并配齐权限;已有连接缺权限时可以再扫码补开,向导里的「应用能读到的内容」面板实时显示权限开通情况和可见的知识空间。GitHub 连接支持一键授权,MCP 连接可以直接探测服务端提供的操作。
- 接入方:MCP 类连接发现的操作会直接成为智能体的原生工具;智能体编辑页的 MCP 区只管理内置 MCP,第三方 MCP 统一在「连接」里维护。
- 云端解析器新增 DeepSeek OCR(只做纯文字识别),默认关闭,启用后接在 Mistral OCR 之后参与解析链。
- 私有化部署:新增多节点高可用预设,可把 API、前端和索引 worker 分散到至少两个节点并启用指标采集,需要 Kubernetes 1.30+。
改进
- 新建 / 编辑智能体页简化:「资源权限」只列已授权的资源,代码模式、交互方式等低频设置折叠成单行,「技能」独立成段。
- 组织成员、审计时间线、用量统计、模型批测和默认模型选择器等管理与组织页在筛选和编辑时明显更快。
- 管理员搜索用户时,未保存的新建草稿不再被搜索结果覆盖。
修复
- 解析失败的图谱维护运行不再每分钟反复重建,改为推迟到下一个预算窗口再试。
- 知识库和知识市场里较早解析的文档预览不再报 500。
- 管理后台排障页一组问题:失败任务逐条显示读取结果、批量重试按实际回执计数、不再跨知识库误重试、搜索和翻页的过期响应不再覆盖新结果。
2.12.132026-11-19
新增
- 智能体表单的「资源权限」里可以直接添加和管理连接(选择只读 / 可写入档位和可调用操作),连接详情页改为只读展示并可跳回智能体修改。
改进
- 知识库「添加数据源」页改为分步卡片:先选从哪里同步,再选账号和同步范围;飞书数据源缺权限时报错会写明需要开通的权限和开通入口,「测试连接」也会真实探测接口权限。
- 组织成员目录、角色列表、API Key 撤销确认和组合模型成员等管理页加载更快。
修复
- 组合模型在工具轮后遇到上下文超长时,改为向实际报超长的成员模型请求恢复。
- 知识图谱合并扫描在候选对判定失败时,不再把未扫描的候选误记为已覆盖。
2.12.122026-11-18
新增
- 知识库新增「数据源」页签:一个知识库可以挂多个数据源、每个数据源覆盖多个范围,按需手动同步或按计划自动同步。本版支持飞书(沿用原同步源)、网站(Firecrawl 整站 / 单页,按计划重抓)和邮箱(通用 IMAP,内置 QQ、163、腾讯/阿里/网易企业邮、飞书邮箱、Gmail、iCloud、Yahoo 预设,按文件夹同步邮件和附件)。
- 组合模型:平台管理 › 模型管理可以把 2~3 个对话模型按顺序组合成一个模型,成员可跨供应商;智能体对话中前一个成员端点失败时自动切换下一个成员继续回答。
- 连接详情「试运行」里,飞书操作可以直接粘贴浏览器地址栏的文档 / 表格 / wiki 链接作为参数,参数旁给出填写引导。
改进
- 知识库「模型」设置在未选择决策模型时不再显示决策相关的三个开关;新建知识库的语言改为下拉选择。
- 组织成员弹窗、服务账号弹窗和平台管理 › 模型管理列表的打开与编辑更快。
修复
- 数据源删除时的清理、文档归属与网站同步的边界问题。
- 邮箱数据源会拒绝各文件夹附件开关不一致的范围,避免同步结果难预期。
- 安全更新:前端框架升级到 Next.js 16.4.5。
不兼容变更
- 接入方:知识库同步源接口从单一
selector升级为多范围scopes模型,响应里不再返回selector和delete_policy;仍按旧字段读取的调用方需改读scopes。原有飞书同步源自动迁移为「飞书」类型数据源,同步行为不变。
2.12.02026-11-12
2.12 是本系列的第一个版本,同步切出长期支持分支。本系列的重点是连接平台(Connect):统一管理数据库、MCP、HTTP 等外部系统的连接并授权给智能体和函数调用;同时增强解析器可观测性与通知规则配置。
新增
- 连接平台(Connect):从连接目录添加 PostgreSQL、MySQL、MCP、GitHub、HTTP/OpenAPI、飞书等连接,凭据只写不读;可发现并批准连接操作、在线试运行,再把连接授权给智能体和函数,通过 REST、MCP 或 CLI 调用。控制台提供连接概览、操作、访问授权和调用记录页面,CLI 提供
apemind connector命令。 - 平台管理 › 通知:8 条内置通知规则的阈值、级别、重复提醒间隔和恢复通知都可以在页面上配置,通知页改为标签布局。
- 平台管理 › 可观测性 › 解析器:新增本地 ApeMind Parser 资源监控(worker 状态、排队页数、内存用量)和吞吐、排队等待趋势图;新增格式覆盖矩阵,按文件格式展示解析器的回退顺序,不可用的解析器和无可用解析器的格式会标红。
改进
- 私有化部署:自建 MinerU 4.x 解析的档位(flash / basic / standard / advanced)可在「解析配置」中选择,默认仍为 advanced。
修复
- 可观测性 › 解析器:PaddleOCR、Whisper 卡片按解析器或「自建」分组筛选时不再漏掉记录。
- 私有化部署:开启 NetworkPolicy 后,API 到解析服务端口的出站已放行。
2.11.122026-11-12
改进
- 平台管理 › 可观测性 › 概览:问题列表现在会提示不可用的解析器(含受影响的文件格式)和失败率升高的解析器,可直接跳到「解析器」页签查看详情。
- 评测:引用核对支持按模型启用 v1 请求形状(精简题目 + 资料精选 4 KB),自托管小模型上明显更快且评分不降;在评测配置的
citation_shape打开,默认关闭。 - 管理台智能体模板编辑者名称、组织服务账号与 Agent 列表等查询更快。
修复
- 接入方:修复声明式配置接口在真实数据上的问题——没有模型的智能体被意外填上默认模型、整项新增或删除在改动预览里显示不完整;配套 CLI 的列表与写操作默认输出可读摘要。
- 平台管理 › 模型管理:供应商名称过长时不再溢出侧栏。
2.11.112026-11-12
新增
- 接入方:智能体与知识库新增声明式配置接口(AgentSpec):智能体声明可整体读取、写回,写接口支持预演(dry_run)和版本乐观锁(revision / If-Match)。
- 平台管理 › 可观测性新增「解析器」页签,按次记录本地、自建和云端解析器的尝试耗时、页数与错误分类。
改进
- 组织目录、API Key 列表、账目分页等管理台查询更快。
- 安全更新:内置 CLI 的 Go 工具链升级到 1.26.11。
2.11.92026-11-11
改进
- 私有化部署:解析服务兼容 MinerU 4.1 及以上版本的 Tasks 协议。
- 管理台审计日志列表与详情、组织成员列表、用户分页等查询更快。
修复
- 评测:引用核对的来源资料按模型上下文上限装入,一段都放不下时返回 409 明确提示,不再产出缺少依据的结果。
2.11.82026-11-11
改进
- 文档切分:正文后紧跟标题的边界直接按标题切开,不再等决策模型判断;切分建议页这类边界显示「按标题切开」,不显示置信度百分比。
- 解析服务在高负载时对新请求的排队估算更准,大批量解析更不容易被误拒。
修复
- 修复包含表格区域的 PDF 页面整页解析失败:年报等每页带表格的财报文档此前反复解析失败,现已正常解析入库。
- 解析请求超时在错误信息里标为超时,不再被归为未知失败,方便定位问题。
2.11.72026-11-11
修复
- 平台管理 › 审计日志:操作记录包含附件等资源类型时,审计列表不再返回 400。
- 私有化部署:Chart 不再固定解析并发参数(INDEXING_PARSE_CONCURRENCY),未配置时按代码默认值生效,需要调整走管理通道覆盖。
2.11.62026-11-10
新增
- 平台管理 › 可观测性 › 问答页新增「用户反馈」面板:按时间堆叠的点赞 / 点踩柱状图、满意度占比和点踩原因分布。
改进
- 文档解析的内置文字 OCR 升级为进程内 PP-OCRv6 small:扫描页、单独图片和表格单元格默认都走内置引擎,不部署外部 PaddleOCR 也能识别,矮字准确率更高;管理后台「解析配置」的 OCR 选项去掉了不生效的「不做 OCR」项。
- 平台管理 › 可观测性:问答页「工具与检索」和知识库页「运行细节」默认展开;受影响的知识库名称单行显示,过长时截断。
- 平台管理 › 可观测性 › 索引:「需要处理的失败任务」改为按知识库和索引类型在表头下拉筛选,不再手填知识库 ID。
- 私有化部署:OCR 模型随 parser 镜像内置,离线环境无需额外准备模型文件。
2.11.52026-11-10
改进
- 平台管理 › 可观测性:折叠箭头统一,模型筛选改为下拉,并补上助手分析的入口。
- 接入方:更新智能体或知识库时,响应里的
warnings会指出被保存但不会生效的字段,以及不在可访问范围内的默认知识库。
修复
- 接入方:更新知识库时只传标题,说明不再被清空;只传一部分
config,CLI 会和现有配置合并后写回,不再关掉其他索引或清空模型。 - 接入方:用 CLI 只改智能体配置的一部分,其余配置不再丢失。
- 接入方:更新函数时只改请求里写出的
limits字段。 - 可观测性里同一次工具调用不再重复计数。
- 未发布知识库的匿名详情页返回 404。
- 私有化部署:单实例 PostgreSQL 的更新改为串行,清单与实际部署对齐。
2.11.42026-11-09
改进
- 可观测性看板更精简:部署拓扑改为连线图,悬停可看详情;失败任务显示名称。
- 接入方:CLI 新增智能体日志与监控、知识库使用方和挂载知识库的命令。
- 使用 Nebula 图库时,图谱计数改为持久维护,大库统计更快。
不兼容变更
- 接入方:知识库的
enable_summary已废弃。请求里仍可传入但会被忽略,响应里恒为false;管理页的索引默认值不再显示这一项。
2.11.32026-11-09
新增
- 文档站新增 API 参考:智能体、知识库与文档、会话、数据集与评测、API Key 等分组都有接口和字段说明,并可在线调试。
- 可观测性新增部署拓扑与进程心跳;问答页增加排队与执行耗时、降级率和每轮用量,索引页增加重试与心跳,模型调用看板增加首 token 时间、输出速度和缓存命中率。
- 接入方:
apemind function用声明式文件管理函数。
改进
- 接入方:用 CLI 发布函数时检查只跑一次,失败会自动撤销,上游故障会单独提示。
修复
- 进程重启后,组织的命令并发名额不再被永久占住,命令不会因此一直排队。
- 为智能体挂载没有权限的知识库时会明确报错,不再静默忽略。
- 组织定时任务发起的对话使用组织工作空间。
2.11.22026-11-08
改进
- 会话附件解析遇到可重试的失败时会自动再试一次。
- 私有化部署:知识库文档的本地解析和会话附件使用同一个解析服务。
不兼容变更
- 接入方:配额只按组织计算。个人配额接口(
/api/v2/quotas)、系统默认配额接口(/api/v2/system/default-quotas)和个人标签接口已移除,管理台用户列表不再显示个人配额。
2.11.12026-11-08
改进
- 组织助手可以调整智能体配置并发起测评,按「保存配置、测评、对比」迭代。已有的组织助手需要管理员补充绑定「执行测评」技能。
- 智能体可以明确选择用 Bash 执行工作区命令。
- 上传的 JSONL 数据集版本不对时,错误信息会说明怎么改。
修复
- 向量库故障导致的索引失败归为平台错误,不再算作文档本身的问题。
2.11.02026-11-07
2.11 系列的重点是函数:把 Python 代码发布成 API,用组织密钥访问外部服务,并能由定时任务触发。
新增
- 函数:把 Python 代码发布成 API,运行时可读取选中的组织密钥,可作为定时任务的目标。
2.10.272026-11-07
改进
- 平台管理 › 可观测性:首屏先给平台健康结论和待处理问题;解析、索引、图谱等失败任务合并到一处处理。
2.10.262026-11-07
修复
- 私有化部署:文档解析服务按内存预算决定页面进程数,不再因内存超限反复重启;API 派发解析任务时也会带上解析服务地址。
2.10.252026-11-07
新增
- 私有化部署:文档解析可以作为独立的 ApeMind Parser 服务部署。
修复
- 使用 Nebula 图库时,关键字检索、类型列表和计数改为分页读取索引,图库服务内存不再随库增大而上涨。
2.10.242026-11-07
新增
- 视频解析会识别画面里的文字。
修复
- 音频解析保留带背景音乐标签的片段,背景音乐下的旁白不再被整段丢弃。
2.10.232026-11-07
改进
- 网站知识库改为从新建知识库入口创建,不再有单独的网站聊天向导。
- 大知识库的图谱关键词、标签和计数查询更快,删除文档后的图谱清理不再全库扫描。
- 文档详情页的 PDF 打开更快。
- 「图解表达」技能画的图更简洁,强调更克制。
修复
- DeepSeek 等模型生成的会话标题不再为空。
- 没有字符映射表的中文 PDF 页面不再整页走 OCR。
- 抓取结果的筛选按钮显示文案,不再显示内部键名。
- 接入方:登录请求缺少密码时返回 400,不再是 500。
2.10.222026-11-06
新增
- 智能体新增内置技能「图解表达」,用图表说明结构和流程。
改进
- 列表统一支持筛选、排序和翻页,状态保存在网址里,刷新或分享链接后保持不变。
- 回答语言与知识库语言按同一规则决定,7 种界面语言的文案补齐。
- 大知识库的图谱总览、检索、最短路径和删除文档后的清理更快,不再随库的规模变慢。
- 后台任务轮询和索引相关的数据库查询改用索引,降低大库负载。
修复
- 使用 Nebula 图库时,删除文档不再超时。
- 使用推理模型时,知识库简介能正常生成。
- 多模态嵌入模型的探测和文本向量化恢复正常。
- 私有化部署:升级时数据库迁移不再因出现两个分支而失败。
不兼容变更
- 组织角色里单独的「Agent 工作区配置」权限并入 Agent 编辑权限:能编辑智能体的成员就能开启工作区和代码模式。
- Web 端不再提供 DeepSeek Harness 托管的 Computer。
2.10.192026-11-05
改进
- 文档站重做:补齐原理等栏目,页面规范统一。
2.10.182026-11-05
新增
- 私有化部署:API Pod 支持多个 worker 进程。
改进
- 回答里的图表换用新的渲染器,常见的 Mermaid 语法错误会自动修正后显示。
- 每个组织默认可同时运行的工作区命令从 4 个增加到 8 个。
修复
- 超大文档不再卡住索引:跳过知识图谱,向量只索引开头部分。
- 嵌入模型额度用尽时索引立即停止,不再逐批重试。
- 图谱关系标注把模型返回的“null”等空答案当作无关系。
2.10.162026-11-05
改进
- 接入方:MCP 搜索默认不包含图谱召回,实体卡片不再给关系标签。
修复
- 图谱关系标注兼容更多模型输出格式。
- 评测中的引用核对不再因 500 错误失败。
不兼容变更
- 组织权限项调整:新增「组织凭证」和「技能」管理权限,升级时自动授予 Owner、Admin,以及原来能增删成员或编辑智能体的自定义角色;配额管理不再是组织权限,由平台管理员在平台管理中设置;Editor 不再能归档数据集。
2.10.152026-11-04
改进
- 新建智能体默认关闭写前确认。
- 接入方:CLI 在代码模式下自动纠正常见的用法错误,并给出可运行的提示。
- 私有化部署:自托管决策模型按模型上限拆批,并支持超时和全局并发限制。
2.10.142026-11-04
修复
- 解析进程所在的 Pod 突然丢失后,文档解析会自动恢复,不再卡住。
2.10.132026-11-04
修复
- 私有化部署:文档解析按容器剩余内存准入并单独限制内存,避免解析把容器撑爆。
2.10.122026-11-03
修复
- 大文档的全文索引按大小分批写入,不再因单次写入过大失败。
- 经 OpenAI 兼容网关调用模型时,不再发送网关不支持的缓存参数。
2.10.112026-11-03
改进
- 同一次检索里查询向量化失败时只等待一次。
修复
- 组织助手执行测评时按工作区命令时限分段等待,发布版本前先征得同意。
2.10.102026-11-03
新增
- 接入方:CLI 可以驱动平台测评;测评详情与对比页给出实际运行的智能体配置。
- 代码模式的回答也带引用原文和来源材料。
改进
- 接入方:
fetch --kb自动翻页并发下载。
修复
- 最终回答只保留最后一次回复的文字,过程旁白存为思考。
2.10.92026-11-02
改进
- 智能体连续 8 次工具调用都没有新证据时,会提示模型直接作答。
- 接入方:
grep含.*的模式也能缩小扫描范围,更快。 - 安全更新。
修复
- 私有化部署:修复启动状态路径错误导致 Compose 无法启动。
- 接入方:CLI
list和fetch --kb按文档有无句柄列出,对旧服务端也兼容。
2.10.82026-11-02
改进
- 最终回复没有可见答案时,先让同一模型重答一次。
修复
- 接入方:CLI
grep支持 GNU 写法的\|,不再误报“没有”。
不兼容变更
- 不再支持子 Agent 委派。
2.10.72026-11-02
改进
- 接入方:
grep用全文索引先定位候选文档,只读可能命中的文档,更快。 - 接入方:CLI 文档列表返回带解析版本的句柄;句柄过期时提示可直接执行的
read命令;把文件名或标题当句柄传入时,提示用list --title找文档 ID。 - 管理页显示 grep 正文缓存上限。
2.10.52026-11-01
改进
- 执行诊断与评估抽屉更精简,改用白话,打开即评估。
- 会话输入框空闲时收成一行;核对引用改为图标开关,不再有核对摘要行。
修复
- 规划只保留一种写计划的方式,计划卡能正确显示批量更新。
- 删除文档时,旧版图谱数据也能清理干净。
- 单行超长的代码、表格和 HTML 块按预算切开,不再让索引失败。
2.10.42026-10-31
改进
- 长对话的跨轮摘要保留问答要点。
修复
- 模型服务返回额度不足时,提示凭据或配额问题,而不是“服务暂时不可用”。
2.10.32026-10-31
新增
- 智能体模板改为平台模板,由管理员在管理后台维护。
改进
- 上下文宽裕时,不再截断前几轮的工具返回。
修复
- 工具的不可恢复错误不再让整轮对话失败。
2.10.22026-10-30
新增
- 对话失败或暂停后可以点“继续”;流式输出中途的瞬时错误会自动续跑。
- 会话附件存入对象存储,可上传任意类型的文件;大文档和历史附件由智能体分页读取。
改进
- 代码模式智能体的写入在审计里可追溯到发起人。
修复
- 成功的定时任务会把回复正文写入运行结果。
- 评测报告在 token 全为 0 时不再报错。
2.10.12026-10-30
新增
- 评测会逐句核对回答的引用,并在句末渲染脚注。
- 接入方:CLI
document fetch-url支持--wait,导入后提示确认。
改进
- 智能体编辑器不再提供上下文策略选项。
- 删除智能体时归档它的定时任务;智能体不可用时暂停任务。
- 接入方:CLI 最少参数创建知识库和智能体时,默认行为与网页端一致;
list分页时提示不要对单页 grep,--title在全部文档中过滤。 - 安全更新。
修复
- 工作区上传在沙箱不可用时会拒绝,并隐藏暂存文件。
- 飞书读不到机器人身份时,不再把所有群消息当成 @ 机器人。
- 接入方:OAuth 令牌访问带路径参数的路由不再被误拒。
2.10.02026-10-29
2.10 是 LTS 系列的第一个版本。本系列的重点是会话附件、可继续的对话、平台管理的智能体模板和回答引用核对。
2.9.142026-10-30
新增
- 对话页「工作区」侧栏新增「上传」按钮,可一次上传最多 20 个本地文件交给智能体处理,同名文件会被覆盖。
- 接入方:新增会话工作区文件上传接口。
修复
- 智能体配置里重新选择资源范围时,恢复原来的权限级别。
2.9.132026-10-29
新增
- 智能体可以接入飞书、钉钉、企业微信:在智能体详情页的「IM 接入」页签用对应 App 扫码即可创建机器人,同事私聊机器人或在群里 @ 它提问。平台管理的「IM 接入」开关默认关闭,打开后组织设置里才会出现「允许接入 IM」(默认开启)。
改进
- 智能体配置页的知识库、智能体、问答集与测评三类资源统一为「范围 + 权限」两级设置;执行方式移到代码模式下。
2.9.122026-10-29
新增
- 知识库入库连续 3 小时没有任何进展时,会在知识库页横幅提示,并站内通知平台管理员;可在通知设置里关闭。
修复
- 只填标题创建知识库时,默认图谱绑定空间默认的补全模型。
- OpenAI 兼容网关不再收到它不支持的缓存参数。
2.9.112026-10-29
修复
- 接入方:CLI 创建知识库和上传文档一步完成,出错时带上服务端返回的原因。
- 被重建或重新解析占用的文档不再卡住图谱升级;解析中断后未恢复的文档不再占用兜底批次。
2.9.92026-10-29
改进
- 智能体的代码模式运行更快。
- 私有化部署:API 和 worker 容器以 tini 作为 1 号进程,回收残留子进程。
修复
- 已退役索引类型的残留记录不再被算作进行中;陈旧图谱数据清理失败的记录不再挡住后面的记录。
2.9.82026-10-29
改进
- 短文档的全文检索(grep)更快。
修复
- 模型端点几乎全部失败时也会熔断,不再只看过载。
- 查询向量化单次请求最多等待 10 秒。
- 联网搜索使用 DuckDuckGo 时,默认回退顺序不再包含 auto。
- 沙箱命令结束后不再留下僵尸进程。
2.9.72026-10-29
新增
- 点击 API Key 即可复制。
改进
- 私有化部署:许可证页常驻显示环境绑定区,签发和换绑共用同一份申请。
修复
- 评测轮次在执行租约丢失后能够被收敛,不再卡住。
2.9.62026-10-28
改进
- 图谱升级与后台关系标注更快更稳:重放时只处理有变化的实体,批次大小按模型端点调整,没有可用模型时会停止而不是空转。
2.9.52026-10-28
改进
- 私有化部署:许可证与环境绑定不匹配时,已有内容保持只读可查看,仍不允许新增内容。
- 私有化部署:许可证页会报告本环境能证明的绑定方式和缺少的材料。
修复
- 私有化部署:卸载再重装 Helm 发布后,安装标识不再丢失。
2.9.42026-10-28
改进
- embedding 调用按模型范围自动调整并发。
- 对持续失败的模型端点自动熔断:索引等待端点恢复后重新派发,不再消耗重试次数。
- 私有化部署:镜像内置预编译字节码,worker 进程启动更快。
修复
- 图谱关系的证据来源更分散,原先查不到的结果在资料变化后会重新检查。
- 图谱抽取调用不再叠加 SDK 自带的重试。
- 大并发下对象存储连接池不足的问题。
- 私有化部署:修复环境绑定签发与诊断中的三个缺陷;未交付的令牌路径视为缺失,并保留安装证书的入口。
2.9.22026-10-28
改进
- 索引和图谱抽取的大模型调用按模型端点自动调整并发,避免打满上游限流。
修复
- 图谱整理中,实体被合并到别的实体后,仍保留所选名称。
2.9.12026-10-28
修复
- 图谱重建只发布了部分窗口时,现在显示为失败。
- 接入方:智能体调用 MCP 工具时使用该轮对话的执行身份。
2.9.02026-10-27
2.9 系列的重点是知识图谱 v2、模型调用并发的自动调整与熔断,以及智能体接入飞书、钉钉、企业微信。
新增
- 知识图谱升级为 v2(实体提及图):抽取只识别实体名称、类型和别名,关系由同一文档中同句、表格行、列表项里的共现及原文引句得出;删除文档时对应证据同步清除。
2.8.292026-10-28
修复
- 接入方:智能体调用 MCP 工具时使用该轮对话的执行身份。
- 通过 HTTP 访问(非安全上下文)时,上传文档不再失败。
2.8.282026-10-27
修复
- 模型管理页中「允许用于」列错位。
2.8.272026-10-27
修复
- 通过 HTTP 访问(非安全上下文)时,上传文档不再失败。
2.8.262026-10-27
改进
- 模型设置项增加帮助提示。
修复
- 「重建失败索引」可以跨知识库执行。
- 校验账号时,某个模型不可用会改用备用模型重试。
2.8.242026-10-27
新增
- 可以停止新增选用某个模型,同时保留已有绑定。
- 平台管理的模型页显示每个模型被智能体、知识库及默认/备用配置引用的统计和明细;管理员可预览并一次性批量替换共享语言模型,替换全部成功或整体回滚。
- 评测列表支持任意多选:重跑失败题、新建测评、重新评分;恰好选两轮且评分标准一致时可对比。测评详情可只重跑所选失败题,草稿题目支持批量删除。
- 知识库详情页标题旁新增发布/下架快捷入口。
改进
- 选择或更换知识库决策模型时默认开启自动切分;决策模型出错时最多尝试两次,之后改用普通切分。
修复
- Nebula 图库遇到失效的缓存会话时自动恢复一次。
2.8.232026-10-26
修复
- 模型流式响应在网关两端都会正确关闭;Nebula 会话等待有了上限,被拒绝的连接池会被关闭。
2.8.222026-10-26
改进
- 私有化部署:Helm 的 PostgreSQL 连接预算把全文证据和 HPA 副本计算在内。
修复
- PostgreSQL、MySQL、对象存储、Redis 和大模型请求的连接与等待都有了上限,并会正确释放,避免连接泄漏和长时间卡住。
- 浏览器不支持 WebGL 时,图谱页显示可交互的替代视图。
- 评测的过程判分请求会按判分服务的请求大小上限裁剪。
2.8.202026-10-26
新增
- 问答集设置页、测评列表和详情页新增删除操作,需输入名称确认;仍被知识库绑定的问答集不能删除,运行中的测评需先停止。删除时对应的公开报告链接一并失效。
改进
- 定时任务原来的「归档」入口改为「删除定时任务」:停止后续调度,保留历史记录。
修复
- 批量提交的进度在完成前一直保持可见。
2.8.192026-10-26
改进
- 模型管理页的模型行更紧凑;模型配置改为显式保存或放弃,未保存时切换会提示。
修复
- CSV 数据集自动识别文件编码,语法错误仍会如实报出。
- 批量重新解析不再耗尽连接,也不再卡在提交阶段。
2.8.182026-10-26
新增
- 接入方:CLI 新增面向智能体的知识访问命令
search、grep、read、outline、fetch,输出为逐行文本,也可用--json。 - 平台管理员可录制并查看每轮对话的模型提示词:管理员自己的对话始终记录,指定用户或组织的对话按 1、3、7 天的规则记录,入口在「可观测性」诊断里的「提示词录制」。
改进
- 私有化部署:图谱事实处理的并发默认值提高到 16。
- 图谱总览的统计由缓存提供,不再拖慢页面。
修复
- 全文检索(grep)能匹配含非 ASCII 字母的整词,并能在读取预算用尽后从未扫描的文档继续。
- 大知识库的图谱总览会先统计实体存量,不再误报。
2.8.172026-10-25
改进
- 下载页重做:桌面端和 CLI 同页,直接给出可复制的一条命令安装 CLI,以及登录等入门步骤。
2.8.152026-10-25
改进
- 模型测试遇到限流会自动重试;图谱场景的测试会关闭思考;各使用场景的测试附带说明。
2.8.142026-10-25
改进
- 私有化部署:成功的健康探测不再刷日志,失败时保留诊断信息。
2.8.132026-10-25
新增
- 智能体可以移除内置的 ApeMind MCP,并在「添加 MCP」里一键加回。
2.8.122026-10-25
修复
- 测试模型时,不再把目录里的结论写回模型配置。
2.8.112026-10-25
修复
- 恢复个人提示词相关的中文标签。
2.8.102026-10-24
新增
- 模型提供商页改为分栏工作台:左边是已连接的提供商,右边是详情,连接、模型和凭据都在页内完成;填入 Key 后一步完成连接。后端会自动识别模型规格(类型、上下文长度、嵌入维度、视觉与工具调用等);「测试」和「探测能力」合并为一个按钮,结果会保存。
2.8.92026-10-24
改进
- 平台管理 › 系统配置:移除内部维护参数,所有配置在同一页按主题展示,可用浏览器查找跨章节搜索。
- 评测轮次可以重命名,进度、评分和指标详情展示更清晰;所有判分都已完成却卡住的轮次会自动恢复。
- API Key 可一键复制 MCP JSON 配置,新建的 Key 也可以。
修复
- 组织工作空间的决策模型能按自己的组织账号通过校验,已校验的模型不再被拒绝。
- 上游限流不再被误报为 API Key 无效。
2.8.82026-10-24
新增
- 知识库页显示当前索引的瓶颈和一条建议操作,例如检查模型设置或等待模型容量。
2.8.72026-10-24
新增
- 嵌入模型支持多模态时,知识库会自动建立图片索引;设置页和文档列表现在会显示这一项,并为各类索引加上说明。
- 文档列表的类型、状态、索引筛选作用于整个知识库,菜单数字为整库数量,并可按最近添加、最近更新、名称、大小排序。
- 模型提供商列表按账号名称显示;已保存的密钥只回显末四位;打开详情会自动拉取上游模型。
改进
- 图谱抽取对所有提供商默认关闭推理,并自动丢弃模型不支持的请求参数。
修复
- 模型列表刷新时,使用场景开关不再被重置。
- 「重建失败索引」的解析任务不再被丢弃。
- 接入方:CLI 接受不限额的组织配额。
- 私有化部署:经反向代理终止 HTTPS 时,OAuth 授权页可正常使用。
2.8.62026-10-24
修复
- 接入方:对话中,内置 MCP 的
list_documents可以读取该对话的附件。
2.8.52026-10-24
新增
- 站内通知中心:顶栏新增铃铛,向平台管理员推送模型提供商不可用、索引死信、许可证即将到期和错误激增等告警,问题恢复后自动标记;可在「通知」设置里按类型开关。
- 可观测性里模型调用失败时显示报错原文、错误码和通俗原因,并可一键进入诊断。
改进
- 无法关闭推理的模型做图谱抽取时,改用最低推理强度。
- 进入工作区的知识库列表少一次跳转。
修复
- 工作队列重连时不再断开同伴正在使用的 Redis 连接。
- 因账号类错误失败的图谱窗口,恢复后可以重试,不再锁死文档。
- 安全更新:升级图像处理依赖。
2.8.42026-10-23
修复
- 模型配额持续饱和时,图谱窗口不再无限等待。
2.8.32026-10-23
修复
- 图谱窗口排队等待不再算作模型超时;Redis 抖动时围栏写入会重试;只有图谱失败时,文档显示为部分完成。
- 诊断链接(带
?turn=)在工作区就绪后再打开,并能识别 402 配额用尽。 - 解析 MinerU 4.x 返回的无内容块页面不再报错。
2.8.22026-10-23
2.8 系列的重点是站内通知中心、模型提供商工作台、模型引用与批量替换,以及面向智能体的 CLI 知识访问。
改进
- 新上传文档的切分使用知识库设置的决策模型。
修复
- 登录后回到登录前打开的页面。
以下是 2.7 及更早系列的汇总,只列各系列里最重要的变化。
2.7 系列2026-10-13 – 2026-11-01
2.7 的重点是文档切分与知识图谱治理、Agent 与知识库的决策模型和独立身份,以及页面切换提速。2.7 是长期支持系列,补丁更新至 2.7.101。
新增
- 知识库支持智能切分:可显式插入分块边界、预览切分方案,每个分块边界都能合并、拆分或移动,并可由决策模型给出切分建议和 AI 复核。
- 知识图谱治理:系统会给出重复实体和噪声实体的合并、屏蔽建议,一键应用或拒绝;知识图谱下新增「治理」和「操作记录」,应用过的规则可撤销。
- Agent 和知识库可单独指定决策模型(也可使用工作区默认决策模型);回答详情新增决策模型评估、每轮上下文用量和工作过程评估。
- Agent 以自己的独立身份运行:工作台、公开链接、网站气泡、iframe 和 API 入口权限一致;每个组织 Agent 有私有角色,访问页可分别控制维护者、组织成员和公开访问。
- Agent 新增日志与监控页面,可按时间范围查看使用量、失败原因和反馈。
- 评测:测评自动评分改为选择决策模型;新增单次评测报告页、报告公开分享链接和导出 Excel。
- 接入方:Agent 可作为 A2A 1.0 智能体对外提供服务。
- 知识库上传支持 YAML、JSON 和 JSONL 文档;Agent 页面可对会话置顶,也可按条件排序、筛选和分组。
- 索引失败时显示用户可读的原因,重试只重建失败的部分;知识库可根据文档内容生成简短说明。
- 管理员诊断页:可按轮次 ID 查看失败证据,并直接探测模型是否可用。
- 接入方:新增自建 System One 端点的兼容模型供应商;用户 MCP 默认允许 HTTP 和私网地址。
- 私有化部署:MinerU 解析器同时支持 3.x 和 4.x;Compose 启动无需手填 JWT 密钥并有启动状态页;新增轻量 Nginx 统一入口并保持聊天请求亲和。
改进
- 各页面切换明显更快:工作区、知识库、Agent、技能、测评和定时任务等列表与详情会在导航前预取,文档预览和 PDF 首次打开更快。
- 文档重建索引时,内容没变的分块会复用已有向量和图谱抽取结果;块重叠默认改为 0。
- 索引队列按知识库分道轮转,批量导入不再挡住同一组织其他知识库的解析。
- Agent 回答的缓存命中更高,检索可并发,本轮范围会带上知识库概况和可检索目录;工具定义更精简。
- 平台管理 › 可观测性:MCP 调用显示分阶段耗时,模型调用失败显示报错原文、错误码和通俗原因,索引页展示 LLM 并发配额。
- 回答统计里显示耗时、输出速度和缓存命中;每个回答显示结束时间,工作过程时间线统一,步骤无需展开就能看到做了什么。
- 图谱抽取时关闭模型思考,降低耗时和成本;未变化的分块不再重复抽取。
- 网络搜索和网页读取统一契约,读取提供商链可配置,修正超时预算、发布时间和语言默认值。
- 接入方:CLI 账号参数统一为
--account,新增切分方案与建议、标签、知识迁移和网页抓取等命令。 - 工作区面板可手动保存到对象存储;管理员各配置页统一版式,必要字段旁增加就地说明。
修复
- 大 PDF 不再因配图数量过多而解析失败。
- 修复文档详情页文档编辑器循环刷新,网页文档保存不再 404。
- 知识库默认知识库被删除后,Agent 轮次不再误用或报错;已删除快照的会话仍显示在列表中。
- 修复反向代理、边缘 TLS 后公开地址识别错误,以及登录回跳到外部地址的问题。
- 供应商返回 401/403 时按认证错误归类;流式调用记录真实 token 用量。
- 安全更新:拦住阿里云和火山引擎的元数据地址访问;更新 Web 和 Python 依赖。
- 定时任务成功后把回复正文写入运行结果;评测报告在 token 全为 0 时不再出错。
- 非安全上下文(HTTP 访问)下上传文档不再失败;删除正在打开的会话不再提示「会话不存在」。
- 接入方:
grep_documents并发满时有界等待,非法正则按字面匹配;聊天附件集合可被list_documents读取。
不兼容变更
- 接入方:知识图谱原有的节点合并与合并建议接口已移除,改用治理的建议、规则和操作记录接口;旧建议数据会被清理。
- Agent 页面的「会话」标签和知识库的「分布图」标签已移除。
2.6 系列2026-09-03 – 2026-10-13
2.6 把组织作为唯一的工作区,退役个人空间;同时推出 Computer、桌面端授权登录与完整的 CLI,并重做可观测性和系统配置页。2.6 另有长期支持分支。
新增
- 组织成为基础能力,不再受授权功能开关限制;新用户自注册时自动创建组织,也可通过邀请加入组织,首次启动会创建默认管理员和组织。
- Computer:组织工作区可共享一台 Computer,管理员配置页管理配对、运行和开通,纳入组织权限与审计;聊天可使用工作区默认模型和模型网关。
- 桌面端和 CLI 通过 OAuth 和设备码登录,并能发现可用工作空间;可观测性页面重做,按根问答、模型和知识加工分层诊断。
- 模型管理统一为一个页面,供应商目录扩充到 59 个,覆盖 Messages、Gemini/Vertex、Responses 和 OpenAI 兼容协议;模型能力(看图、工具调用)可独立探测,保存与连通探测拆开。
- 授权升级为 v4:授权管理页展示功能启用状态,并新增用户、知识库和全平台每日提问额度。
- 知识库支持按集合设置解析策略,文档上传可选整个文件夹、显示去重提示和失败重试,支持 YAML 文档。
- 聊天回答可导出为 PDF;增加蒙古语界面;官网首页重写并新增下载页。
- 接入方:
apemindCLI 覆盖知识库、文档导入与索引、Agent、聊天、轮次、图谱、组织与成员、API Key、资源用量等操作;HTTP MCP 改为显式 Bearer 并提供 OAuth 发现,MCP 升级到新版传输协议。 - 接入方:新增 Agent 发布与网站问答组件的统一流程,以及网页读取、搜索的可续读和来源信息。
- 私有化部署:对象存储默认改用 RustFS;新增 PostgreSQL 全文检索的本地部署形态。
改进
- 系统配置页按管理员任务重新分组,附白话说明、生效值标签和保存人与时间;大量运行参数(缓存、索引队列、上传准入、图谱、维护任务)可在管理页热调整。
- 工作区、侧边栏聊天历史、知识库和文档列表、文档预览与分块的首屏等待明显缩短,聊天历史分页逐步加载。
- 文档解析:PDF 多栏阅读顺序、表格旋转与跨栏表格还原更准确,TextIn Markdown 图片得以保留。
- 知识图谱:更完整的关系抽取和导出,图谱检索超时后不再拖垮知识库搜索。
- 组织角色与权限更精细:按角色隐藏写按钮,组织可审查并吊销 API Key 与服务账号;数据 API Key 不再拥有账号或组织治理权限。
- 组织 Agent 的
@能看到组织知识库,个人 Agent 不再带出组织知识库;创建知识库自动补齐工作区向量模型。 - 知识库问答、检索和生成的限流跟随组织密钥;索引失败给出更多可追踪的信息。
- 私有化部署:系统配置里的 ONNX 路径固定为官方镜像路径,不再可改;配置页对已关闭的 MinerU 不会被旧环境变量重新启用。
修复
- 修复 API Key 工作区范围被放大成全组织、读写路径不一致的问题,并要求 Embeddings、模型网关在调用前选择工作区。
- 修复组织成员使用他人创建的组织 Agent 时找不到内部密钥、组织对话
@看不到知识库或漏出个人库的问题。 - 修复知识库设置页「更新知识库」点击无反应,组织新建知识库标签保存失败。
- 切换组织或工作区后,不属于新空间的详情页和对话页会回到列表,不再显示错误数据。
- 修复首位管理员没有工作区、注册时超出组织授权额度仍可注册等问题。
- 修复知识库导出的权限与源文件边界。
- 修复 LlamaParse 资产类型误判,并拒绝官方不支持的 Markdown 上传。
不兼容变更
- 个人空间运行时已退役:工作区只显示组织,新账号的默认 Agent 创建在开户组织内,API Key、知识库、模型、标签和市场统一按组织授权。存量个人数据需先迁移到组织;聊天仍仅创建者可见。
- 接入方:数据 API Key 不再能操作组织治理,也不能使用账号级与平台级接口,需要时改用 OAuth 登录或管理员账号。
2.5 系列2026-08-20 – 2026-09-02
2.5 是一个短系列,重点是首版 ApeMind CLI、组织邀请与个人知识库迁移,以及 PDF 解析质量。
新增
- 组织邀请链接:管理员可生成链接邀请成员加入组织。
- 个人知识库可迁移到组织。
- 接入方:新增
apemind单文件命令行客户端,提供跨平台安装入口,支持多服务端配置、站点和组织管理、创建聊天与提问和接受组织邀请。
改进
- PDF 解析:多栏阅读顺序、栏内短格子表格、配图裁切和位置更准确。
- 空会话欢迎图标换成会眨眼并跟随鼠标的机器人;侧栏只展示有会话的 Agent 分组,并用加号创建。
- 账号只读只限制个人资源写入,组织内写入看组织角色。
修复
- 修复 Agent 指定知识库时不勾选且显示 id 的问题。
- HTTP 429 但没有配额码时,不再被误判为密钥或配额错误。
- 修复管理员组织管理页 Owner 列显示用户名字。
- 修复组织 Agent 解析绑定知识库时缺少组织信息,以及组织成员使用他人创建的组织 Agent 时找不到内部密钥。
- 预设 Agent 创建时即挂上托管密钥,默认知识库权限为拥有的全部知识库。
2.4 系列2026-07-16 – 2026-09-02
2.4 是一次大版本更新:智能体可以委派给子智能体,对话支持附件、分享与导出,知识库开始支持图片和数据库,同时补齐了许可证、限流与额度,索引流水线更能自我恢复。升级涉及数据库迁移和若干默认值变化,请先看「不兼容变更」。
新增
- 智能体可以把任务委派给子智能体并行处理,对话里的子智能体面板能展开查看父智能体交代的任务、过程和结果。
- 新增托管的知识库问答预置和「资料研究员」预置;智能体的默认知识库范围可选「全部」,之后新建的知识库自动纳入。
- 对话支持上传附件、直接粘贴图片,输入框里
@知识库和#文档合并为一个带搜索和最近使用的上下文选择器。 - 回答里的脚注可以点开查看来源详情;对话或单轮回答可以生成可撤销的公开只读分享页,单条回答可以导出 PDF。
- 对话里可以预览 HTML、Markdown、文本和 PDF 成果,并渲染数学公式、Graphviz 和 Vega 图表。
- 知识库支持图片:独立图片和文档内嵌图片都会建立索引,检索时图文一起召回,智能体可以按需分析命中的图片。需要配置支持图片的向量模型。
- 文档解析新增多种解析器可选:ApeMind PDF、Mistral OCR、LlamaParse、Firecrawl、AnyDoc、Unlimited-OCR;超长 PDF 自动分段解析。
- 知识库详情页新增分块向量分布地图,可搜索、框选,并查看最近邻和前后文。
- 知识库支持打标签,工作区列表可按标签筛选;智能体也可以打标签。
- 接入方:知识库检索工具新增按正则或关键词扫描文档(
grep_documents)和文档差异比较(diff_documents);list_documents改用不透明游标分页。 - 平台管理新增许可证管理、请求限流策略、Token 周期额度、用量总览和审计日志;许可证可在未登录时首次配置,缺失或无效时管理员可恢复。
- 私有化部署:许可证随 Compose 与 Kubernetes 持久化交付,支持热更新;离线交付物按架构分别提供,并内置 tokenizer 缓存,不再依赖公网下载。
改进
- 知识库按块切分默认开启,表格和代码块不再被从中间切开;图谱抽取窗口会把同一表格放在一起。
- 文档详情页的 PDF 分为原文、解析后的 Markdown 和分块三个标签页,PDF 原文可分页预览,图片原文支持 TIFF。
- 重建索引和重新解析分开:重建索引只重跑索引,不再重新解析;文档列表里有独立的「重新解析」。重建期间状态不再假性显示为就绪,失败时旧索引继续可用。
- 索引失败后可自动恢复:解析失败有重试上限,任务不再因 Redis 中断或进程崩溃而丢失;死信列表支持分页和批量重置。
- 知识图谱构建改为内存有界的流水线并支持窗口失败容忍阈值,大知识库不再因单个窗口超时整体失败;图谱可视化改用 WebGL 渲染,浏览器不支持时给出明确提示。
- 智能体运行参数可在编辑页调整,系统预置智能体允许保留自己的配置;智能体的知识库权限统一按托管的 API Key 判定。
- 检索结果按稳定标识去重,图谱检索故障时其他召回路径仍可返回结果。
- 对话侧边栏对正在生成回答的会话显示运行指示;新会话欢迎区和模型选择器更简洁。
- 接入方:MCP 工具错误带错误码和纠正指引,智能体能据此自行修正调用;公开分享页中的知识库图片在创建时冻结,之后不受文档变更影响。
- 私有化部署:Chart 支持统一镜像仓库前缀,默认镜像标签与应用版本一致;API 启动探针放宽以适应首次冷启动;新增自托管 vLLM 对话与多模态向量、PaddleOCR 3.x 和 MinerU 3.4 的交付配置。
修复
- 修复 Elasticsearch 写入与读取分区不一致、批量写入失败被吞掉的问题,以及 pgvector 小租户召回塌缩;Qdrant 向量点标识迁移提供可续跑的命令行工具。
- 修复文档解析占用内存或超时不受控的问题:解析在可终止的子进程中执行,有内存和时间上限。
- 修复对话流式输出中断后无法恢复、标题并发改名、对话切换时状态残留等问题。
- 修复知识库导出、PDF 导出的并发无上限问题,现在受统一的并发上限约束。
- 修复子智能体沿用父智能体 API Key 的越权风险;子智能体读取知识库时按自己的授权判断。
- 修复网页读取可通过重定向访问内网的问题,日志中的凭证样式内容和 Redis 地址里的账号信息会被脱敏。
- 修复委派失败在调用统计里被记为成功的问题。
- 修复订阅知识库的 PDF 原文分页、文档预览中的图片显示,以及图片在登录态下无法显示的问题。
- 修复许可证相关页面在旧浏览器中请求未发出、可选的
key_id被前端误判为必填的问题。
不兼容变更
- 私有化部署:本系列包含大量数据库迁移,升级前备份主库、图库和对象存储,并先在测试环境跑通迁移。回退不能只换应用镜像。
- 私有化部署:启动时会校验
JWT_SECRET,空值和公开占位值会被拒绝;Compose 默认启用 Redis 认证,服务端和所有客户端要使用同一凭据;Chart 和 Compose 配置需用新版重新渲染,不要沿用 2.3 的产物。 - 私有化部署:功能访问、直接调用 MCP、每日 API 调用额度和管理页受许可证约束,升级前准备好有效的许可证材料。
- 私有化部署:不再隐式从公网下载 Hugging Face tokenizer 和 Elasticsearch 插件,需要随离线交付物提供;离线交付物需用 2.4 重新制作,不能混用 2.3 的。
- 知识库按块切分改为默认开启,新建或重建的文档分块边界会和旧文档不同,重要文档建议重建并抽查引用。
- 知识库摘要索引已移除,图片的「视觉转文字」索引停止写入,统一为多模态向量召回加按需分析。依赖这两类索引状态或检索结果的使用方需要调整;图片检索需要有效的多模态向量模型。
- 接入方:移除未注册的向量检索和全文检索 MCP 旁路,单一检索方式改用
search_knowledge的modes;list_documents的游标只能原样回传服务端返回的next_cursor。 - 接入方:图片分析工具默认关闭,且只能在已认证的智能体对话中使用,直接调用 MCP 不可用;第一版回答证据链已删除,历史证据在页面和 PDF 中不再显示。
- OpenSearch 不再被接受为 Elasticsearch 的替代,所有入口会明确报错。
2.3 系列2026-05-30 – 2026-07-16
2.3 是本页最早的系列,也是长期支持(LTS)系列,最后一个补丁版本是 2.3.70。本系列重点是智能体运行时的稳定性、检索工具面的收敛、知识图谱默认开启,以及可观测性和多语言支持。
新增
- 对话输入框支持
@引用知识库,支持复制自己发出的消息;回答可以展示文档中的图片,引用来源里也能看到文档图片。 - 文档详情页新增按分块查看的解析结果;文档列表每行可直接下载。
- 知识库摘要默认自动生成,随文档变化按比例重新生成,存量知识库会补生成。
- 视频解析的语音识别改为可配置的模型供应商,默认部署由 FunASR SenseVoice 替代 whisper。
- 新增多语言支持:界面、接口错误提示和智能体回答语言跟随用户语言,并支持从右向左排版的语言。
- 删除模型、供应商或账号前会检查是否被知识库引用,被引用时需要强制确认。
- 管理员可以启用只读模式横幅并自定义文案,在工作区和市场页面显示。
- 接入方:API Key 支持设置过期时间并可复制 MCP 配置,默认密钥受保护、可停用;新增网页搜索供应商 Brave。
- 接入方:公网
/api/docs提供过滤后的 OpenAPI 文档;新增 API 调用明细记录,覆盖直接 MCP 调用、OpenAI 兼容接口和对话;审计日志支持多条件筛选。 - 私有化部署:新增可选的可观测部署栈(Prometheus 和 Grafana,默认关闭,仅限 Kubernetes),附带 API、MCP、索引、对话等看板和告警规则,以及 ServiceMonitor。
改进
- 知识图谱索引默认开启,图索引显示窗口进度,抽取按窗口增量写入,图谱更早可见;大知识库的图谱构建内存占用有界。
- 检索工具面收敛为统一的知识库搜索加证据读取:搜索只负责定位,细节交给读取工具;工具返回会说明实际应用的上限和是否被截断;联网工具默认关闭。
- 智能体在上下文溢出时能保留已收集的证据继续回答,历史轮次的工具结果和对话摘要压缩更稳定,推理模型的思考内容不再混入标题和正文。
- 模型平台新增供应商模型目录和推荐,设置页显示已配置模型的供应商模型 ID,官方供应商的接入地址被锁定。
- 文档解析更稳:解析进程有硬超时和心跳,MinerU 超时延长到 1 小时并复用进行中的任务,文本导入自动识别非 UTF-8 编码,上传进度显示真实字节进度。
- 管理员配置页重新布局,保存失败的提示不再重复;设置里多个无实际作用的字段已移除,管理员配置的 Graph 索引和摘要提示词现在真正生效。
- 前端加入加载骨架和错误边界,页面异常时不再整页白屏。
- 接入方:MCP 工具补充了参数说明、输出结构和参数缺失时可自行纠错的错误提示。
- 私有化部署:API 增加启动探针,避免冷启动时被误判重启;多个实例同时启动时数据库迁移会串行执行;Compose 离线交付复用 Elasticsearch 中文分词插件,不再从公网下载。
修复
- 接入方:修复
/mcp不带结尾斜杠时重定向丢失授权头,以及 OpenAI 兼容接口误用model字段覆盖智能体所选模型的问题;长时间无输出时会发送心跳,连接不再被中断。 - 修复非 ASCII 文件名导致文档下载和知识库导出报错。
- 修复对话中 Markdown 表格白屏、对话切换状态残留、新建会话无反应和登录失效时点击对话显示 404。
- 修复智能体工具调用失败被记为成功、事件流重连后乱序丢失等问题。
- 修复知识库图片不显示和图片资源 403 的问题。
- 修复索引多处卡死或无限重试:已删除知识库的任务反复报错、图谱向量崩溃后无限重跑、Redis 断开后 worker 不恢复。
- 修复一批安全问题:Markdown 与链接中的脚本注入、网址域名黑名单可被绕过。
- 修复取消订阅市场知识库后页面报应用错误。
- 私有化部署:语音识别服务的升级不再因模型缓存卷无法重新挂载而卡住。
不兼容变更
- 接入方:搜索已发布到市场的知识库需要有效订阅,非所有者且未订阅时返回 404,以前仅发布即可检索。
- 接入方:MCP 默认工具面收窄,底层的单路检索工具不再注册,联网工具默认关闭;需要时在智能体的工具设置里开启,并改用统一的知识库搜索。
- 知识图谱索引和知识库摘要默认开启,新建知识库会占用更多模型调用;不需要时在知识库设置里关闭。