版本与升级
版本号分别代表不同内容，不能互换：公开协议为 1.0；MCP 服务为 0.1.2；Python SDK、Client Core、ToolRunner 与聊天组件为 0.2.5。平台网站自身的版本不代替协议或包版本。更新记录。
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调用配置 REST。常规运行客户端仅按需传 limits.max_context_tokens，不要补回已删除字段；自建配置客户端需按当前规范生成类型。后续 npm 发布需使用新版本号，保留已有 0.2.5 归档。旧字段迁移。
客户端升级
JS 三包尽量固定同一版本一起升级，再核对产品代理、工具执行器和 Widget。浏览器独立脚本使用带版本的 URL 与 SRI；更换脚本文件后重新核对完整性。Python SDK 支持 Python 3.10+，JS 包要求 Node 22.12+ 或相应现代浏览器能力。
已发布 Agent 版本不可变，历史 Session 继续使用建立时的版本。新配置的发布不会更改已有会话；希望升级会话体验时新建会话并按产品流程记录迁移。停用/归档是逻辑 Agent 级状态，旧版本不能绕过。
协议字段需要未来发生不兼容改变时，应先发布新版本及迁移说明；既有 0.2.5 及更早包不能原地覆盖。每次升级分别核对实际已发布的服务、包和契约，避免把仓库 main 的开发进度当成网站已经提供的接口。
MIT 许可覆盖四个客户端包及相应随包示例/文档，版权为 GeekArt Inc.；它不包含平台托管服务或模型额度。模型费用以当前平台销售价格和账号余额为准。接入包选择。