LangChain TypeSafe 0.1.0:分类器接口迁移,Python 与 JS 依赖要求调整
Air Explorer Pro是一款跨平台多网盘管理工具,可实现一站式完成不同网盘间文件的互传、搜索和同步等操作。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。
LangChain TypeSafe 0.1.0将TypeSafeClassifier对齐决策模型接口。JavaScript的问题改为随请求传入,响应和usage字段调整,旧中间件入口弃用;Python版最低Python 3.11、langchain-core 1.8.0,跨语言依赖要求需要分别核对。
LangChain TypeSafe 0.1.0将TypeSafeClassifier对齐决策模型接口。JavaScript的问题改为随请求传入,响应和usage字段调整,旧中间件入口弃用;Python版最低Python 3.11、langchain-core 1.8.0,跨语言依赖要求需要分别核对。
公告时间:2026年11月12日 06:03:10(北京时间)。
来源:官方版本记录。
TypeSafe 0.1.0 为什么需要迁移
LangChain的Python和JavaScript TypeSafe包在本次窗口内均发布0.1.0,涉及分类器接口和中间件入口变化。JavaScript发布说明明确标记为破坏性变更:TypeSafeClassifier扩展@langchain/core/decisions中的BaseDecisionModel,并要求@langchain/core至少1.4.0。它与Python包的最低core版本不同,不能只按同一0.1.0版本号推断兼容环境。

JavaScript 问题改为随请求传入
新版使用 new TypeSafeClassifier().invoke({ state, questions }),替代在构造函数传questions后再invoke(state)的方式。每个question都要求instructions。修改时应同时检查实例创建、单次请求和问题定义,避免只更改构造函数却仍传旧的调用参数。发布说明还新增Box问题及图像内容作为TypeSafe图像资产的处理。

响应类型、usage与错误位置发生变化
JavaScript响应改为core的ClassifierResponse,token用量通过usage_metadata中的input_tokens、output_tokens、total_tokens表示,替代旧usage及驼峰字段。多项旧类型被移除;无效问题现在由invoke抛出普通Error,而不是构造阶段的TypeSafeError。依赖旧错误类型或旧用量字段的日志与统计代码需要一起调整。
旧 middleware 入口进入弃用阶段
@langchain/typesafe/middleware中的autoModeMiddleware和modelRouterMiddleware被弃用,调用时警告一次,计划在0.2.0移除。官方建议改用langchain中的对应中间件,并配置classifier: new TypeSafeClassifier()。这是版本计划,不是已经公布的日历下线日期,不能自行编造截止时间。
Python版运行条件与验证重点
Python langchain-typesafe 0.1.0最低要求Python 3.11、langchain-core 1.8.0,experimental额外依赖涉及langchain 1.5.0;Python 3.10仍解析到0.0.x。迁移可先固定各语言依赖,验证代表性问题、无效问题、图片输入和用量统计,再单独调整中间件。本文没有运行真实分类API,示例仅解释官方发布的参数结构。
常见问题
Python与JS的core最低版本一样吗?
不一样,Python为1.8.0,JS发布说明要求@langchain/core至少1.4.0。
旧中间件已经立即删除了吗?
当前为弃用并警告,说明计划在0.2.0移除,未给出日历日期。































