核心变化
LangChain.js 在上海时间 2026 年 9 月 22 日发布 langchain@1.5.12 正式补丁，官方记录的发布时间为 2026 年 9 月 21 日 23 时 56 分 37 秒（UTC），对应北京时间 9 月 22 日 7 时 56 分，落在当日 00:00 至 23:59 窗口内。该版本在发布页中仅记录一项修复：保留 ReactAgent 回调在其编译图被提取时的传递，并避免经过智能体时出现重复调用，对应变更为 #11682，由 @casparb 贡献。发布标记为正式版而非预发布，附件列表为空，说明本次为轻量补丁更新，未附带额外二进制分发，也未在说明中提及新功能、性能变化或安全事项。
适用对象
该补丁面向使用 JavaScript 或 TypeScript 版 LangChain 构建智能体的开发者，特别是已在工程中使用 ReactAgent 并会将其编译图提取出来复用、封装或二次调度的场景。命中该路径时，回调丢失或重复触发会干扰日志记录、链路追踪、用量统计与业务埋点，升级后可减少此类重复调用带来的排查成本。对中国用户而言，若项目已上线 JS 智能体且依赖回调做观测或计费，更值得验证该修复；仅做简单链式调用、未使用 ReactAgent 或从未提取编译图的项目不受该问题直接影响，可按常规发版节奏评估是否跟进，不必为此单独紧急升级。
兼容性与升级条件
版本说明仅列出上述回调修复，未提及破坏性变更、新增依赖、最低运行环境调整或迁移脚本，可按补丁级别理解。仓库归属为 langchain-ai 名下的 langchainjs，版本标签为 langchain@1.5.12，可通过官方发布标签获取，许可证为 MIT 且本次未发生变化。已有项目建议先在测试环境验证 ReactAgent 回调次数、编译图提取后的行为与追踪链路是否符合预期，确认无回归后再更新生产依赖。同一仓库同期还有其他分包更新，各自独立编号与发布记录，本条仅覆盖 langchain@1.5.12，不代表其他分包状态，升级时应核对包名避免装错。
限制与下一步
本次可核验信息限于单项回调修复，不包含性能对比、安全修复声明、兼容矩阵与失败率数据，官方也未给出影响范围与复现条件之外的补充说明，不能据此推断其他智能体或图的稳定性变化。中国用户无需为此调整整体架构，重点是核对自身是否走通编译图提取路径。下一步可在测试环境复现原有重复调用场景，对比升级前后回调触发次数，并观察日志与追踪是否一致，同时继续关注官方后续补丁。若当前未使用相关能力，可暂不升级，等待更集中的版本再统一跟进，以降低频繁小版本带来的验证负担。