# 版本与升级 版本号分别代表不同内容，不能互换：公开协议为 1.0；MCP 服务为 0.1.2；Python SDK、Client Core、ToolRunner 与聊天组件为 0.2.5。平台网站自身的版本不代替协议或包版本。[更新记录](/docs/releases/changelog/)。 ## 2026-09-28 服务与客户端的边界 本次上线修改了服务端上下文配置，没有发布新客户端包。即使协议仍标为 1.0，已删除字段的请求也不兼容；不能据此假定 0.2.5 内附的全部配置类型仍与线上一致。 | 内容 | 当前状态与接入方法 | |---|---| | 已部署 API、控制台和 MCP | 已使用 `max_context_tokens` 与 `max_result_context_bytes`；新配置以本站 OpenAPI、MCP `tools/list` 和配置参考为准 | | 已发布 Python SDK 0.2.5 | Run 的 `limits` 与通用请求按传入字典发送；无需升级即可传当前合法字段，但接入方必须删除自己请求中的旧字段 | | 已发布 npm 三包 0.2.5 | 现有聊天、工具执行与恢复入口继续使用；归档内配置类型仍包含旧 `max_context_chars`、`max_result_bytes`，没有新 `max_result_context_bytes` / `context_preview` 类型，不能当作当前配置规范 | | 仓库生成类型 | 已与当前 Backend 契约同步；这些类型尚未作为新 npm 版本发布，不会自动进入已安装的 0.2.5 | 当前可以通过控制台或 MCP 配置字节预算，也可在产品服务端按[公开 OpenAPI](/docs/reference/openapi.json)调用配置 REST。常规运行客户端仅按需传 `limits.max_context_tokens`，不要补回已删除字段；自建配置客户端需按当前规范生成类型。后续 npm 发布需使用新版本号，保留已有 0.2.5 归档。[旧字段迁移](/docs/reference/configuration/)。 ## 客户端升级 JS 三包尽量固定同一版本一起升级，再核对产品代理、工具执行器和 Widget。浏览器独立脚本使用带版本的 URL 与 SRI；更换脚本文件后重新核对完整性。Python SDK 支持 Python 3.10+，JS 包要求 Node 22.12+ 或相应现代浏览器能力。 已发布 Agent 版本不可变，历史 Session 继续使用建立时的版本。新配置的发布不会更改已有会话；希望升级会话体验时新建会话并按产品流程记录迁移。停用/归档是逻辑 Agent 级状态，旧版本不能绕过。 协议字段需要未来发生不兼容改变时，应先发布新版本及迁移说明；既有 0.2.5 及更早包不能原地覆盖。每次升级分别核对实际已发布的服务、包和契约，避免把仓库 main 的开发进度当成网站已经提供的接口。 MIT 许可覆盖四个客户端包及相应随包示例/文档，版权为 GeekArt Inc.；它不包含平台托管服务或模型额度。模型费用以当前平台销售价格和账号余额为准。[接入包选择](/docs/integration/overview/)。