langchain-ai维护的langchain-openrouter于上海时间2026年9月22日12时16分发布0.2.9正式补丁。GitHub发布页标称自langchain-openrouter==0.2.8起的增量,GitHub API标称published_at为2026-09-22T04:16:11Z,对应北京时间2026年9月22日12时16分;PyPI同版本轮子包与源码包上传时间为2026-09-22T04:15:57Z与04:15:59Z,对应北京时间同日12时15分,均落在当日00:00至23:59窗口内。仓库地址为https://github.com/langchain-ai/langchain,维护方为langchain-ai,版本为0.2.9,非预发布,对比基线为0.2.8。许可证为MIT,发布说明未声明许可证变更。中国开发者可通过PyPI的langchain-openrouter包升级验证,不改变OpenRouter服务端模型可用范围与计费规则。

关键变化

  • - 发布提交:release(openrouter): 0.2.9(#40736),确认自0.2.8起的增量为本补丁 - 画像刷新:多笔chore(model-profiles)提交集中刷新模型画像数据,同步OpenRouter侧模型目录与能力描述 - 依赖升级:chore(deps): bump anyio from 4.13.0 to 4.14.2 in /libs/partners/openrouter(#40627)

适用对象与价值

面向已在Python侧通过langchain-openrouter接入OpenRouter统一接口的开发者与团队,特别是需要调用多家模型、依赖模型画像做路由与参数适配,以及在异步链路中使用该集成包的场景。本次集中刷新模型画像有助于减少因本地画像过期导致的模型不可见、能力描述不一致与路由偏差;anyio同步至4.14.2有助于保持与LangChain生态其他包的异步依赖一致,减少因版本分散导致的安装冲突。对仅使用固定单一模型、未依赖画像自动同步的用户,影响较小,可按常规节奏评估升级。

兼容性与安装条件

本次为常规补丁更新,发布说明未声明破坏性接口变更与许可证变更,对比区间为0.2.8至0.2.9的小集合,可按常规小版本评估升级。PyPI元数据显示需要Python大于等于3.10、小于4.0,分类器覆盖3.10至3.14,许可证为MIT;运行依赖包括langchain-core小于2.0且大于等于1.5.5、openrouter小于1.0且大于等于0.9.2,anyio在本次同步至4.14.2。安装沿用PyPI体系,仓库为https://github.com/langchain-ai/langchain,可执行pip install -U langchain-openrouter==0.2.9或uv add langchain-openrouter,需公网访问GitHub与PyPI,内网环境需提前同步轮子包langchain_openrouter-0.2.9-py3-none-any.whl与源码包。实际模型可用范围、区域与配额以OpenRouter账户权限与服务端为准。

限制与注意事项

发布说明仅列出画像刷新与依赖升级,未提供基准性能、成功率或成本对比数据,不应将其理解为性能提升承诺。画像结果仍受OpenRouter服务端目录、账户权限与所选模型实现影响,服务端差异可能影响模型可见性与调用稳定性。本次未提及安全修复,不应视为安全公告,也不改变已知安全边界。许可证效果、长期维护与后续版本兼容不作超出发布说明的保证。升级前建议在预发环境验证模型发现、画像同步、异步调用与基本Agent流程回归。

下一步

已使用该集成包的项目可将版本固定至0.2.9,在预发环境验证单模型与多模型路由、画像同步结果、异步并发行为与异常重试流程后发布。未接入的团队可按仓库说明完成OpenRouter密钥配置与初始化。更多细节见Release langchain-openrouter==0.2.9说明、提交#40736与#40627,以及GitHub API中的published_at与PyPI中的upload_time对应北京时间2026年9月22日的归一验证。