2.8.0 迭代增量与版本记录
| 版本 | 2.8.0 |
|---|---|
| 源 tag / 仓库 | v2.8.0(peeled commit ea835e462085decbbf49ab7fd6a0e99928be72a9)@ git@code.alipay.com:obai/appbase.git |
| 本迭代源 commit | ea835e462085decbbf49ab7fd6a0e99928be72a9(tag 即 release-2.8.0 尖端) |
| 上一迭代源 commit | 34b7c8633813a8fe75cc58e8348bd4a9efdd0e21(release-2.7.0 分支尖端) |
| 文档基线 commit | 1c1f7acff234232e1346742b90909273dd9b91ed(迭代分支 v2.8.0 自 origin/master 冻结) |
| 生成日期 | 2026-09-20 |
| 服务版本 / Migration | APP_VERSION_STABLE 单次 bump 2.7.2 → 2.8.0(无 2.7.x 中间 cut);Migration V55(知识库版本集合、KB 版本绑定属性、LLM Gateway 提供者头存储、桶 clientFileListing 属性;升级迁移基线 1.9.0 不变) |
新增能力
知识库版本管理(影响面:Console / Server API / SDK):知识库新增 Versions 页签与版本化数据面——创建工作副本(可指定源版本、标签、描述,失败可重试)、就绪封存(seal,就绪检查 readiness 通过后置 READY)、发布(publish,把 READY 版本切为当前激活版本)、回滚(rollback 到保留的 READY 版本)、版本删除(不可逆清理,以异步删除操作呈现并可查询)、旧库采纳版本化(adoption,操作可取消/查询)、历史版本保留数配置。Server spec 新增 16 个版本端点 + 1 个批量删除文档端点(单批最多 50 个文档,204 返回,按序删除、失败仅重试仍存在者)。Console 端为真实操作台(版本化未启用时显示启用引导与保留策略设置)。详见
sdks/changelogs/2.8.0.md与apis/zh-CN/knowledge-base/versions.md。Observability 评估技能与评估范围(影响面:Console / Server API / SDK):新增评估技能(Evaluation Skills)管理页(列表 / 详情 / 新建,支持 Markdown 创建与
.zip/.tar.gz/.tgz包导入,技能 ZIP 可下载;技能为只读指导,脚本、Shell、网络与写工具不可用);自定义 Agent 评估模板支持挂接 MCP 工具与调用过程展示;评估任务支持按类型与名称规则圈定评估范围;多评估器任务、轨迹持久化(ATIF)与数据预览增强。新增POST /observability/evals/mcp/tools(发现评估可用的只读 MCP 工具)。AI Gateway 连接诊断与逻辑模型挂载(影响面:Console / Server API / SDK):工具连接连通性测试(
POST /ai-gateway/tool-connections/{id}/test,Console 连接诊断面板同源:连接测试摘要、诊断详情、网关测试凭据保护);逻辑模型挂载查询与整体替换(GET/PUT /ai-gateway/resources/logical-models/{id}/mounts);模型路由提升为项目级作用域;支持提供者头配置(静态 / 受控:customHeaders、forwardHeaderAllowlist,V55落库);护栏回滚与私有端点(guarded rollback / private endpoints)。存储桶客户端列表开关(影响面:Console / Server API / SDK):桶新增 Client file listing 开关(
clientFileListing,默认开;关闭后仅授权管理客户端可列文件,上传权限与公开文件链接访问不变;V55为存量桶补齐属性)。详见products/zh-CN/storage.md「文件列表开关」。PowerContext 托管上下文(影响面:Console):项目侧栏新增 PowerContext 入口(托管上下文配置页:启用状态、就绪探测与配置下发;随项目变量与可用性开关灰度),未开放部署不显示入口。
Metering 计量加固(影响面:Console / Server):计量汇总(rollups)性能与运行韧性优化、队列重试上限与失败任务存储加固、Redis 清理服务生命周期治理;组织管理员 API Key 查看与复制修复。
行为变化
知识库摄取与文档操作(影响面:Console / Server API):MinerU 图表感知分块(figure-aware chunking)保留图表结构与来源角色;文档上传限额对齐;批量文档删除(见上);KB 版本上下文提升并在工作副本展示描述;数据源删除不再级联删除已生成文档(语义明确化)。
GraphRAG 稳定性(影响面:Console):round-0 抽取失败自动重采样(换模型抽签最多两次)并跳过全失败文档;人物消解候选枚举设界;gleaning 轮格式错误时保留已完成轮次;分片 checkpoint 与编码路径参数修复。
JsonTable 与 SQL Proxy 契约修复(影响面:Server API):required 预检在钉定连接上保持、整表原子性、复合索引成员属性过滤独立 JOIN、大整数跨端精度与历史索引一致性、JSON null 不进全文物化、nullable/unsigned 数值契约保留。
观测与追踪(影响面:Console / Server API):HTTP 错误率监控拆分与结构化单日志(错误保留在一个结构化日志里)、HTTP 时长直方图桶精简、Grafana 链接与告警诊断增强、Langfuse 面收敛为 OceanBase-only(去除 ClickHouse / PostgreSQL 路径)、链路详情展示完善。
Functions 构建缓存(影响面:Console):恢复可写构建缓存与 Console 实时更新(部署后状态即时刷新)。
Executor / 沙箱(影响面:Server):沙箱构建与运行生命周期加固、Provider 告警清理、OpenSandbox E2E 后端校验、滚动更新与请求排空(request draining)加固。
配置与部署
项目元数据库迁移进入
V55(知识库版本化集合与绑定属性、LLM Gateway 提供者头属性、桶clientFileListing;仅创建可空/静态存储契约,不迁移存量数据、不改变量运行时门控)。SDK 侧精确交付坐标见sdks/changelogs/2.8.0.md。生成 SDK 移出 appbase monorepo:生成与发布迁移至 agentbase-sdks 仓(appbase 内 monorepo 生成树删除,SDK 契约测试同步迁移)。文档侧坐标以 agentbase-sdks 发布报告为准。
商业订单:产品实例解耦、履约入口独立管理、IAM 上下文与来源信任恢复、legacy 项目 ID 格式对齐。
废弃与迁移
V54已发布不回写;升级到 2.8.0 的项目元数据库变化由V55承接。未启用版本化的存量知识库走 legacy 无版本读取路径;启用版本化须经采纳(adoption)流程(Console Versions 页签引导 / API
version-adoptions)。本迭代无新增 API 废弃面(Server spec 762 → 783 端点,纯新增)。
已知问题
无。
手册侧(本迭代 products/ 变化)
功能点增删:新增
knowledge-base/versions.md子页(工作副本 / 封存 / 发布与回滚 / 版本采纳 / 保留策略);无删除。「功能点骨架基线」表需 PR 评审时补登该行(products/AGENTS.md为政策文件,生成角色不改写)。正文上刷(zh-CN):
knowledge-base/overview.md(能力表补版本管理行)、knowledge-base/wiki.md(导航句补 Versions 入口)、storage.md(桶设置表补 Client file listing 行 + 新增「文件列表开关」小节,截图fig-2-storage-bucket-settings.png;审核小节标题规范化)、observability/evaluations.md(评估技能 ZIP 与 MCP 工具发现两条要点)、routes.md(侧栏入口补 PowerContext;Knowledge Base 行补 versions;Observability 行补 evaluation-skills)。models-ai-gateway/ai-gateway.md的连接诊断与逻辑模型挂载增量由sdks/、apis/承载(手册页签表为治理面概述,页面级交互未变),不在本迭代重复展开。逐语言状态:zh-CN 上刷完成;en-US、ja-JP 未产出(骨架态),事实源为中文同名文件。
截图台账:沿用 2.7.0 实拍 25 张(页面结构未变的图不重拍);本迭代 2026-09-20 SIT 新增实拍 3 张(1440×900,与存量分辨率一致,逐张经 DOM 文本判读确认主区域为预期内容、无错误页、不含凭据):
knowledge-base/fig-2-knowledge-base-versions.png(Versions 页签真实「未启用版本化」态:启用引导 + 默认保留 3 个历史版本设置)、observability/fig-3-evaluation-skills.png(评估技能页真实空态 "No Skills yet":创建 / 导入入口与只读边界说明;页脚显示 Version 2.8.0)、storage/fig-2-storage-bucket-settings.png(桶 Settings 的 Client file listing 卡)。SIT 当前部署版本为 2.8.0(页脚实测)。核验缺口:KB 版本页签的「已启用版本化」完整生命周期画面(工作副本 → seal → publish)需在测试库实际执行版本化流程后才能补拍(本迭代只拍默认未启用态,不伪造状态);评估技能「已导入」列表态同理待有真实技能包后补拍。产品侧事实以 appbase
v2.8.0(ea835e46…)Console 路由与组件 diff、Server spec(agentbase-sdksv2.8.0双 tag 对比:+21 端点)为准逐篇核对。