Langflow 发行说明
本页面总结了每个版本中 Langflow 的重大变化。 有关所有更改，请参阅 Changelog (更新日志)。
由于严格的 SemVer 要求，Langflow Desktop 可能与核心 Langflow OSS Python 包具有不同的修订版本号（patch versions），但主版本号（major）和次版本号（minor）是保持一致的。
准备升级
Langflow 团队建议，在升级主安装版本之前，尽可能在新的虚拟环境或虚拟机中安装新的 Langflow 版本。 这允许您从现有安装中 导入流 (flows) 并在新版本中进行测试，而不会干扰您现有的安装。 如果出现重大变更或错误，您现有的安装将保持在稳定状态。 如果您正在将 Windows Desktop 升级到 1.6.0，请勿使用应用内的 Update 按钮进行自动升级。相反，请按照 已知问题：请勿自动升级 Windows Desktop 中的说明操作。
为了避免潜在重大变更的影响并测试新版本，Langflow 团队建议遵循以下升级流程：
-
建议操作：导出您的项目 以创建流的备份：
_10curl -X GET \_10"$LANGFLOW_SERVER_URL/api/v1/projects/download/$PROJECT_ID" \_10-H "accept: application/json" \_10-H "x-api-key: $LANGFLOW_API_KEY"要从可视化编辑器导出流，请参阅 导入和导出流。
-
安装新版本：
- Langflow OSS Python 包：在新的虚拟环境中安装新版本。有关说明，请参阅 安装并运行 Langflow OSS Python 包。
- Langflow Docker 镜像：在单独的容器中运行新镜像。
- Langflow Desktop：要进行原地升级，请打开 Langflow Desktop，然后点击 Langflow 页眉中的 Upgrade Available。如果您想隔离新版本，则必须在单独的物理机或虚拟机上安装 Langflow Desktop，然后将 流导入 到新安装中。
-
升级组件时，如果 您之前没有导出流，可以使用 Create backup flow before updating（更新前创建备份流）选项。
-
如果您是隔离安装的新版本，在测试新版本后，请升级您的主安装。
如果您在隔离安装中对流进行了更改，您可能希望将这些流导出并重新导入到升级后的主安装中，这样您就不必重复组件升级过程。
1.7.x
1.7.0 版本因存在严重错误已被撤回。1.7.0 版本已被 1.7.1 版本取代，后者包含针对此问题的修复。
本版本的亮点包括以下更改。 有关所有更改，请参阅 Changelog (更新日志)。
已知问题：升级到 1.7.0 版本时无法访问数据
在升级到 1.7.0 版本的过程中发现了一个严重问题。
流、项目和全局变量没有被删除或损坏。数据仍然存在，但由于流定位路径的更改，1.7.0 版本无法找到它。 所有升级到 1.7.0 的 Langflow 版本都会受到影响。
请勿升级到 Langflow 1.7.0 版本。 相反，请直接升级到 1.7.1 版本，其中包含针对此错误的修复。
如果您在修复发布之前安装了 1.7.0 版本，请按照以下步骤恢复您的流：
-
将 Langflow 还原到 1.6.9 版本：
_10uv pip install langflow==1.6.9 -
验证您的流、项目和全局变量是否可以访问。
-
直接升级到 1.7.1 版本，其中包含此问题的修复：
_10uv pip install langflow==1.7.1
新功能与增强
-
支持 MCP 客户端和服务器的流式 HTTP 传输
Langflow 现在支持 MCP 客户端和服务器的 流式 HTTP 传输 (streamable HTTP transport)。 当将 Langflow 用作 MCP 客户端 时，您可以连接到具有流式 HTTP 传输的 MCP 服务器。 当将 Langflow 用作 MCP 服务器 时，客户端可以使用流式 HTTP 传输进行连接。 为了向后兼容，仍然支持 SSE 传输作为备选方案。
-
Webhook 身份验证
添加了
LANGFLOW_WEBHOOK_AUTH_ENABLE环境变量，用于对/webhook端点 的请求进行身份验证。当LANGFLOW_WEBHOOK_AUTH_ENABLE=TRUE时，webhook 端点需要 API 密钥身份验证，并验证经过身份验证的用户是否拥有正在执行的流。当为FALSE时，不需要 Langflow API 密钥，所有发送到 webhook 端点的请求都将被视为由流所有者发送。有关更多信息，请参阅 使用 Webhook 触发流。 -
可配置的 API 密钥验证
添加了
LANGFLOW_API_KEY_SOURCE环境变量，以控制 Langflow 如何验证 API 密钥。设置为db时，Langflow 会根据存储在数据库中的密钥验证 API 密钥。设置为env时，Langflow 会根据LANGFLOW_API_KEY环境变量验证 API 密钥。有关更多信息，请参阅 API 密钥与身份验证。 -
SSRF 防护
为 API Request 组件 添加了 SSRF（服务器端请求伪造）防护。默认情况下禁用 HTTP 重定向以防止 SSRF 绕过攻击。要启用 SSRF 防护，请设置
LANGFLOW_SSRF_PROTECTION_ENABLED=TRUE。使用LANGFLOW_SSRF_ALLOWED_HOSTS配置允许的主机。依赖自动重定向的流需要手动启用它。 -
Langflow Desktop 中的电子邮件注册
Langflow Desktop 现在在启动时包含一个电子邮件注册屏幕。注册的电子邮件地址有助于跟踪用户注册情况并了解用户群体。更多信息请参见 遥测。
-
读/写文件组件的更 改
Save File 组件已重命名为 Write File，现在可以保存到 S3 和 Google Drive。 File 组件已重命名为 Read File。 这两个组件都支持 工具模式 (Tool Mode)。
-
新的集成、捆绑包 (Bundles) 和组件：
DataFrame Operations 组件的新过滤器操作符
DataFrame Operations 组件 现在包含一个
not contains过滤器操作符。 使用它通过仅提取 不 包含特定值的记录来清洗数据。 例如，您可以过滤掉不包含@的无效电子邮件地址。Data Operations 组件的新 JSON 操作
Data Operations 组件 现在包含两个用于高级 JSON 数据操作的操作。 Path Selection 操作从嵌套的 JSON 结构中提取值，而 JQ Expression 操作使用
jq查询语言来执行高级 JSON 过滤、投影和转换。LLM Router 组件现在称为 LLM Selector 组件。
Web Search 组件 现在将 Web Search、News Search 和 RSS Reader 合并为一个带有不同搜索模式标签的单一组件。您可以从一个组件中使用 DuckDuckGo 搜索网络、搜索 Google 新闻或阅读 RSS 提要。独立的 News Search 和 RSS Reader 组件已被移除。
1.6.0
此版本的亮点包括以下更改。 有关所有更改，请参阅 Changelog。
已知问题，潜在安全漏洞：版本 1.6.0 到 1.6.3 中未加载 .env 文件
Langflow 版本 1.6.0 到 1.6.3 存在一个关键错误，即无法读取 .env 文件中的环境变量。
这会影响所有使用环境变量进行配置（包括安全设置）的部署。
如果您的 .env 文件包含 AUTO_LOGIN=false，升级到受影响的版本会导致 Langflow 回退到默认设置，可能会在升级后立即授予所有用户超级用户访问权限。
此外，数据库凭据、API 密钥和其他敏感配置无法从 .env 文件加 载。
如果您使用 .env 文件进行配置，请 不要 升级到 1.6.0 到 1.6.3 之间的任何 Langflow 版本。
相反，请升级到 1.6.4，其中包含此错误的修复。
已知问题：请勿自动升级 Windows Desktop
Langflow Desktop 的 Windows 用户 不应 使用应用内更新功能升级到 Langflow 1.6.0 版本。 仅升级到 Langflow 1.6.0 版本的 Windows Desktop 用户受影响。
Langflow Desktop 中的 Update 按钮对 Windows 用户不起作用，并可能导致数据丢失。
相反，当新版本可用时，请从 Langflow 网站 下载全新安装包。
请遵循以下说明以最大程度地降低丢失流的风险。
这些说明假设 Langflow 数据库的默认路径为 C:\Users\YOUR_USERNAME\AppData\Roaming\com.langflow\data\database.db 或 C:\Users\%YOUR_USERNAME%\AppData\Roaming\com.langflow\data\database.db。请将 YOUR_USERNAME 替换为您的 Windows 用户名。
- 确保您拥有管理员权限。
- 确保您有足够的磁盘空间用于第二次安装 Langflow。
- 关闭 Langflow，并确保任务管理器中没有 Langflow 进程正在运行。
- Langflow 1.6.0 安装程序在稍后的步骤中会自动执行数据库备份，但额外的手动备份提供了额外的冗余，建议执行。
要手动备份您的 Langflow 数据库文件，请执行以下操作：
- 在 Windows 资源管理器中，导航到
C:\Users\YOUR_USERNAME\AppData\Roaming\com.langflow\data\。将YOUR_USERNAME替换为您的 Windows 用户名。 - 复制此位置的
database.db，并将其粘贴到安全位置。
- 在 Windows 资源管理器中，导航到
- 从 Langflow 网站 下载 Windows 安装程序。
- 以管理员身份运行 Windows 安装程序。要以管理员身份运行安装程序，请右键单击可执行文件并选择 以管理员身份运行 (Run as administrator)。
- 遵循 Windows 安装程序的指导步骤。 Langflow 1.6.0 安装程序会自动执行数据库备份。 这些步骤会从头开始安装 Langflow，并产生两个 Langflow 安装：之前安装的版本和 1.6.0 版本。 这是预期行为。
- 启动 1.6.0 版本的 Langflow，并确认您的流表现符合预期。
- 如果流丢失，请通过执行以下操作从手动备份中恢复您的流：
- 关闭 Langflow。
- 导航到您的备份位置，并复制
database.db文件。 - 替换新安装的
data目录中的数据库文件。 - 启动 Langflow，并确认您的流表现符合预期。
- 确认后，卸载之前版本的 Langflow，并保留 1.6.0 版本。
重大变更
-
默认情况下对 Langflow API 请求强制执行身份验证
在 Langflow 1.6 版本中，默认情况下
LANGFLOW_AUTO_LOGIN=True且LANGFLOW_SKIP_AUTH_AUTO_LOGIN=False。 这强制对 Langflow API 请求进行身份验证，同时仍会在可视化编辑器中自动将所有用户身份验证为超级用户。这是与 1.5 版本相比的一个重大变更，在 1.5 版本中，这两个环境变量默认均为
true，从而绕过了所有身份验证。为了临时的向后兼容性，您可以通过将这两个变量都设置为
true来恢复到之前的未授权行为。 然而，未来的发行版将设置LANGFLOW_AUTO_LOGIN=False并移除LANGFLOW_SKIP_AUTH_AUTO_LOGIN。 届时，Langflow 将严格强制对 API 请求进行 API 密钥身份验证，您可以通过设置LANGFLOW_AUTO_LOGIN=True来手动禁用某些功能（如可视化编辑器）的身份验证。更多信息请参见
LANGFLOW_AUTO_LOGIN的文档。
新功能与增强
-
OpenAI Responses API 兼容性
Langflow 现在包含一个兼容 OpenAI Responses API 的端点，路径为
POST /api/v1/responses。 这允许您通过将model名称替换为您的flow_id，以最小的代码更改来使用现有的 OpenAI 客户端库。 该端点支持流式响应、会话连续性、工具调用结果以及通过标头传递全局变量。 更多信息请参见 OpenAI Responses API。 -
内置 Docling 支持的高级文档解析
Read File 组件支持使用 Docling 库进行高级解析。
为了更轻松地使用 Docling 组件 和 Read File 组件的新高级解析功能，Langflow 现在为除 macOS Intel (x86_64) 以外的所有操作系统内置了 Docling 依赖项。
更多信息请参见 高级解析。
-
重新组织的组件菜单和可视化编辑器控件
- 工作区 侧边栏分为以下几个独立部分： 搜索、 核心组件、 MCP 服务器、 捆绑包 (Bundles) 和 添加注释。
- 锁定/解锁控件已移至 项目 (Projects) 中的流详情中。
- 缩放和帮助控件已移至工作区的右下角。
- 向量存储组件已移至特定提供商的 捆绑包 (Bundles) 中。
- Serper Google Search API 组件已移至 Serper 捆绑包中。
-
将默认最大文件上传限制从
100 MB提高到1024 MB。 -
新的集成和捆绑包：
弃用
- Local DB 组件现在处于旧版 (legacy) 状态。 请使用 Chroma DB 组件 替换此组件。
1.5.0
此版本的亮点包括以下更改。 有关所有更改，请参阅 Changelog。
新功能与增强
-
Langflow API 请求可以要求身份验证
为了增强安全性并确保自动登录功能的正确身份验证，Langflow API 端点现在需要使用 Langflow API 密钥进 行身份验证，即使
LANGFLOW_AUTO_LOGIN=True。 此更改将在未来的版本中强制执行。 为了临时的向后兼容性，此版本添加了LANGFLOW_SKIP_AUTH_AUTO_LOGIN环境变量。 默认值为true，这会禁用 API 身份验证强制执行。 要强制执行 API 身份验证，请设置LANGFLOW_SKIP_AUTH_AUTO_LOGIN=False。 更多信息请参见LANGFLOW_AUTO_LOGIN的文档。 -
集中化的 Language Model 和 Embedding Model 组件
Language Model 组件 和 Embedding Model 组件 现在是您 LLM 和嵌入流的核心组件。它们支持多个模型和模型提供商，允许您在不更换单一提供商组件的情况下尝试不同的模型。 在可视化编辑器的 Models 类别中可以找到它们。
单一提供商组件已移至 Bundles 部分。 您可以使用它们替换 Language Model 和 Embedding Model 核心组件，或者使用 Connect other models 提供商选项将它们连接到 Agent 组件。
-
MCP 服务器一键安装
在 Langflow 项目的 MCP server 页面上，点击 Auto install，即可一键将您的 Langflow MCP 服务器安装到 MCP 客户端。 macOS、Windows 和 WSL 均提供使用 JSON 配置文件安装的选项。 更多信息请参见 将 Langflow 用作 MCP 服务器。
-
MCP 服务器管理
您现在可以在 MCP Tools 组件中以及通过 Langflow Settings 页面添加、删除和编辑您的 MCP 服务器。 更多信息请参见 将 Langflow 用作 MCP 客户端。
-
输入模式 (Input schema) 取代临时覆盖 (temporary overrides)
Input schema 面板取代了在 API access 面板中管理微调 (tweak) 值的需求。当您在 Input schema 面板中启用一个参数时，该参数会自动添加到您流的代码片段中，为您提供在首选编程语言中发起请求的即用型模板。
-
工具组件重新分配
Tools 类别中的所有组件都已移至其他组件类别，例如 Helpers 和 Bundles，或被标记为旧版 (legacy)。
MCP Tools 组件 现在位于 Agents 类别下。
执行相同功能的工具被合并为支持多个提供商的单一组件，例如 Web Search 组件 和 News Search 组件。
-
稳定性改进
一般的稳定性改进和错误修复，以增强可靠性。 发现问题？在 GitHub 上提交。
-
新的集成和捆绑包
1.4.2
此版本的亮点包括以下更改。 有关所有更改，请参阅 Changelog。
新功能与增强
- 具有改进批量功能的增强文件和流管理系统。
- 添加了 BigQuery 组件
- 添加了 Twelve Labs 捆绑包 (Bundle)
- 添加了 NVIDIA System-Assist 组件
弃用
- 弃用了 Combine Text 组件。
1.4.1
此版本的亮点包括以下更改。 有关所有更改，请参阅 Changelog。
新功能与增强
- 添加了增强的 重大变更 (Breaking Changes) 功能，以帮助在更新 Langflow 后更新组件而不破坏流。
1.4.0
此版本的亮点包括以下更改。 有关所有更改，请参阅 Changelog。
新功能与增强
- 引入了 MCP 服务器功能，以便向兼容 MCP 的客户端提供 Langflow 工具。
- 在可视化编辑器中将 Folders 重命名为 Projects。
/folders端点现在重定向到/projects。
弃用
- 弃用了 Gmail、Google Drive 和 Google Search 组件。 有关替代方案，请参见 Google 捆绑包 (Bundle)。
早期版本
请参阅 Changelog。
