2.6.0 迭代增量与版本记录
| 版本 | 2.6.0 |
|---|---|
| 源 tag / 仓库 | v2.6.0 @ git@code.alipay.com:obai/appbase.git |
| 本迭代源 commit | 8c9beb4713496d051a477f03fd843365145d3b86 |
| 文档基线 commit | 675d1b0(迭代分支 v2.6.0 实际基线:固定路径多语言框架迁移后的本仓 master;origin/master 尖端 08f1d0d5e98b5bcb19ce00216f603a6fe4f831eb 与本分支经 PR 人工合并) |
| 生成日期 | 2026-09-14 |
| 服务版本 / Migration | APP_VERSION_STABLE = 2.6.0,Migration V53(升级迁移基线 1.9.0 不变) |
首次迭代说明:products/<lang>/ 语言树由本迭代首次产出(zh-CN 源语言全量首产;en-US、ja-JP 为骨架态,目录不存在),无更早的固定路径正文可作差分;产品侧增量以 v2.5.0 → v2.6.0 的服务与 Console 变化为准。
新增能力
Custom OAuth2(影响面:Console / 登录流):项目可配置标准 Authorization Code 自定义身份 Provider,不再要求新增服务端 Provider 类;Console 可对项目已启用的公共 OAuth Provider 做登录测试,测试 Session 与 Console Session 相互隔离。
AI Gateway——统一 AI 数据面(影响面:Console / Server API / SDK):与既有 LLM Gateway 并存的新数据面(Gateway / Target / Tool / Consumer / Policy / MCP / A2A),不提供旧路由别名;两者名称、凭据、路径不可混用。
Agent Runtime(影响面:Console / 组织级):托管 AgentVersion、ReAct、Workflow、Tool/MCP 与运行事实,支持 Memory / Knowledge 挂载。
富文档 RAG(影响面:Console / Server API / SDK):知识库摄取支持 PDF、Office、表格、MinerU 与图片资产及可选图片理解;Python Server SDK 15.4.0 补齐 Knowledge Bases 调用面。
三级用量页(影响面:Console):Account / Organization / Project 三级用量固定展示最近 30 个 UTC 日,并区分「0」「缺失」「不完整」三种取值。
行为变化
安全默认值收紧(影响面:Console / Function / Sites / Server API):外部 URL(Migration source、自定义 OAuth2 endpoint、远程预览等)拒绝本机 / 私网 / 元数据地址,仅接受可公开验证的 HTTPS;远程 Avatar / Favicon / Screenshot 默认不可用;Function 与 Site 用户命令按受限身份运行,不满足安全条件直接失败、不回退高权限执行。
Function API Key 传递方式(影响面:Function / Server API):不再接受 query string 传递,改用受保护 header 或平台注入的运行时认证路径。
Console SQL 页(影响面:Console):不再展示 MySQL wire host、CA、连接串或自动创建直连密码;项目成员改用页面内 SQL 终端。
数据库 Schema(影响面:Console / Server API):结构变更以 Schema 版本提交,激活前校验物理结构,失败保留原 active 版本;支持版本列表与回滚(回滚仅切换生效指针,不执行物理 DDL、不改数据);删除重放与并发 metadata 更安全。
Memory(影响面:Console / Server API / SDK):初始化有界重试,范围删除与写入串行,quota 条件更新,身份与 revision 绑定更严格。
数据库连接韧性(影响面:Server API):OceanBase 空闲连接失效后,新的非事务请求可自动恢复连接;已进入事务的请求不自动重放,需调用方确认结果后按幂等策略处理。
产品命名:Console、服务与技术文档统一使用 Agentbase;兼容标识(
X-AppBase-SDK、APPBASE_*、X-Appwrite-*、appbase-*-sdk包名)保持原值。
配置与部署
项目元数据库迁移进入
V53;SDK 侧精确交付坐标见sdks/changelogs/2.6.0.md。
废弃与迁移
V52、V51已发布不回写;升级到 2.6.0 的项目元数据库变化由V53承接。Function API Key 的 query string 传递方式废弃,迁移到受保护 header / 运行时注入。
依赖内网地址或跨域重定向的旧外部 URL 流程在 2.6.0 安全默认值下会失败,需改为可公开验证的 HTTPS 地址。
已知问题
无。
手册侧(本迭代 products/ 变化)
功能点骨架:按
../AGENTS.md「功能点骨架基线」首次产出全量 22 个功能点文档(根 6 +account/1 +organization/1 +project/14),无章节编号;退役清单(部署运维、版本迁移、Agent Runtime/Skill 专题、商业订单、SDK/API 接入)不设章。逐语言状态:zh-CN 22/22 首产完成(本页为唯一版本记录);en-US、ja-JP 未产出(骨架态 = 目录不存在),已产出功能点的事实源为中文同名文件。
截图台账:SIT 环境(
https://appbuild-sit.oceanbase.com/,凭据经AGENTBASE_DOCS_GEN_*环境变量注入)2026-09-14 实拍 23 张(Playwright + Chromium,1440×900,Pillow 压缩至 ≤300KB),覆盖 20 个功能点页——what-is-agentbase、core-concepts、getting-started、routes、account/register-login、organization/org-account、project/overview(2 张:Overview、API keys)、project/auth(2 张:Users、Security)、databases、storage、functions、models-ai-gateway(2 张:LLM Gateway、AI Gateway)、knowledge-base、memory、observability、moderation、settings、messaging、sites、limits 各 1 张;front-matter.md与faq.md无 UI 不配图。均按assets/<功能点路径>/fig-<序号>-<slug>.png归属并由对应正文相对链接引用(无未引用图、无跨语言引用);截图为 SIT 实机页面,不含凭据或 secret。核验缺口:手册正文事实以 appbase
v2.6.0源码树(Console 路由与服务端配置)与skills/ob-agentbase/references/release-2.6.0.md为准逐篇核对;SIT 实机走查已执行(上述 23 张实拍截图即实机证据),页面级交互细节以实拍当日 SIT 环境状态为准。