LangChain TypeSafe 0.1.0：分类器接口迁移，Python 与 JS 依赖要求调整

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图像资产的处理。

依据：官方版本记录；Python包发布说明

响应类型、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包发布说明

常见问题

Python与JS的core最低版本一样吗？

不一样，Python为1.8.0，JS发布说明要求@langchain/core至少1.4.0。

旧中间件已经立即删除了吗？

当前为弃用并警告，说明计划在0.2.0移除，未给出日历日期。