2.7.0 迭代增量与版本记录
| 版本 | 2.7.0 |
|---|---|
| 源 tag / 仓库 | v2.7.0(peeled commit 7a557ac5affe318bcc00bd57496fea8d49ccb65c)@ git@code.alipay.com:obai/appbase.git |
| 本迭代源 commit | 34b7c8633813a8fe75cc58e8348bd4a9efdd0e21(release-2.7.0 分支尖端,含 tag 后 4 个修复与版本 bump 提交) |
| 上一迭代源 commit | 8c9beb4713496d051a477f03fd843365145d3b86(tag v2.6.0) |
| 文档基线 commit | a6f611542333b396c1bdbeffaf8cc0832ed1ca67(迭代分支 v2.7.0 自 origin/master 冻结) |
| 生成日期 | 2026-09-18 |
| 服务版本 / Migration | APP_VERSION_STABLE 在分支上经 2.7.0 → 2.7.1 → 2.7.2 三次 cut(尖端 = 2.7.2,后两次为 SDK release cut bump);Migration V54(升级迁移基线 1.9.0 不变) |
新增能力
Knowledge Wiki 与 GraphRAG(影响面:Console / Server API / SDK):知识库新增 Wiki 面——页面(pages)的生成、版本(revisions)与恢复、提案(proposals)接受、冲突(conflicts)解决、推荐上限(recommended-limits)与重置;支持 Wiki 页导出到 Memory(export-to-memory)。新增 GraphRAG 图浏览(graph / entities 邻居 / community-reports)与索引治理面(index-capabilities 按能力清理、index-operations 任务查询与取消)。Server spec 新增 26 个知识库端点。
项目级 Agent Runtime API(影响面:Server API / SDK):新增项目下 Agent Runtime 数据面 29 个端点——AgentVersion 的 config / gateway / models / readiness / skills,Run 的创建 / 取消 / 事件流 / 消息 / 模型调用 / 工具消息,Thread 及其消息与上下文压缩(context-compactions),Agent 级评估(evaluations)。Web / Node / Python / Go / Java Server SDK 均新增
AgentRuntimeservice。知识库摄取增强(影响面:Console / Server API / SDK):摄取支持 Excel 工作表解析与图片增强;新增嵌入输入限制配置与索引输出语言配置;摄取进度阶段保留 UTF-8 文案。
Custom OAuth2 增强(影响面:Console / 登录流):内置 Gitee 提供商接入(字段提示与识别),登录测试支持自定义 Scope 且强化 Scope 隔离;回调状态与邮箱错配直接阻断。
AI Gateway 治理(影响面:Console / Server API):凭据治理(credential governance)、工具审批(tool approvals)与托管模板(managed templates)。
Observability 监控与评估(影响面:Console / Server API):新增 Agentbase 监控面板与 Function 指标(含 Redis / Memory 合并面板);完成 Agent 轨迹评估(trajectory evaluation,含数据集评估支持 Agent 目标);OpenCode 摄取修复丢事件与轨迹身份问题,轨迹消息角色按
type归一化(assistant 不再显示为 user)。商业订单页恢复与加固(影响面:Console,商业环境):订单购买流程重建并完成 Agentbase 订单履约、安全配置绑定与运维恢复;订单页恢复并加固(动态适配商业环境、LAN 身份校验)。该能力属商业环境 Console 面,手册不设专章(退役清单口径不变)。
行为变化
JsonTable 索引字段必填放宽(影响面:Console / Server API):允许放宽 JsonTable 索引字段的必填约束(required-only 更新直达适配层;混合放宽请求被拒)。
组织用量页(影响面:Console):用量聚合过滤删除态项目;消除 legacy N+1 阻塞(有 metering 时跳过 legacy 组织用量路径),页面加载明显提速。
团队 owner 标识(影响面:Console / Server API):修复 owner membership 用户标识导致的 404;跨域 userId 冲突被拒。
数据库 Schema 回滚一致性(影响面:Server API):回滚期间保持 collection 一致性。
Console 等待列可用后再保存注释(影响面:Console):避免列未就绪时注释保存失败。
内容审核图片提交(影响面:Server API):私有存储的图片经 base64 提交审核,不再依赖可外网访问的 URL。
项目创建性能(影响面:Console / Server API):sharedV2 项目延迟初始化,创建耗时优化。
Console 可观测导航:切换页面保持当前选中项目上下文。
品牌与命名:服务与官网统一 Agentbase 品牌(隐藏 legacy AppBase 标识);Console 内 Agentbase skill 改名并暴露隔离短路由。兼容标识(
X-Appwrite-*等)保持原值。
配置与部署
项目元数据库迁移进入
V54(含商业订单 issuer 修复CommerceOrderIssuerRepair;平台 Schema 调和与项目迁移 runner 增强,迁移汇总不完整时 fail-closed)。SDK 侧精确交付坐标见sdks/changelogs/2.7.0.md。VLM 解析器超时与并发设置对齐 Compose / Helm 配置;Redis Lua 脚本缓存依赖修复。
废弃与迁移
V53已发布不回写;升级到 2.7.0 的项目元数据库变化由V54承接。Function API Key 的 query string 传递方式自 2.6.0 起废弃,本迭代无新增废弃面。
已知问题
无。
手册侧(本迭代 products/ 变化)
功能点增删:新增
knowledge-base/wiki.md子页(Wiki 页面管理 / 更新建议 / 冲突裁决 / 导出到 Memory / Wiki 链接图 / Graph 图谱浏览 / 知识索引治理);无删除。「功能点骨架基线」表需 PR 评审时补登该行(products/AGENTS.md为政策文件,生成角色不改写)。正文上刷(zh-CN):
knowledge-base/overview.md(能力表补 Wiki/图谱/索引治理)、knowledge-base/documents.md(Excel 工作表解析、图片增强配置、嵌入输入限制落点)、observability/evaluations.md(数据集评估支持 Agent 目标 + 模板目录截图)、functions.md(新增「用量与资源监控」小节:ACS 容器组资源面板)、models-ai-gateway/ai-gateway.md(API Key 硬性限额、OPA dry-run、新增两个托管模板、用量维度表)、auth/overview.md(Custom OAuth2 邮箱端点字段、Gitee 域名识别与字段提示、登录测试自定义 Scope、测试页截图)、organization/org-account.md(组织用量过滤删除态项目)。逐语言状态:zh-CN 上刷完成;en-US、ja-JP 未产出(骨架态),事实源为中文同名文件。
截图台账:沿用 2.6.0 实拍 23 张(页面结构未变);本迭代 2026-09-18 SIT 新增实拍 2 张——
observability/fig-2-observability-evals.png(评估模板目录)、auth/fig-3-auth-test-oauth.png(OAuth 登录测试页,真实空态:未启用公共 Provider),均经逐张判读确认主区域为预期内容、不含凭据。缺口:知识库详情新增页签/indexes、/graph、/wiki在 SIT 为空白渲染(innerText 为空,探查复核确认),未拍摄;knowledge-base/wiki.md只写源码可证的操作步骤。注意 SIT 当前部署版本为 2.8.0(页脚实测),新增截图的侧栏chrome 可能包含 2.8.0 入口。核验缺口:手册正文事实以 appbase
release-2.7.0(尖端34b7c863…)Console 路由与组件 diff(PR 531/534/538/545/556/562/565/526/520 等)为准逐篇核对;SIT 走查覆盖了可拍页面(2 张新增实拍),KB 新页签的页面级交互细节以源码为准、待 SIT 部署可用后补拍。