Langfuse v4.19.0 正式发布：组织级功能预览默认值与模型定义 API 上线

发布概览

Langfuse 是开源的 LLM 工程平台，帮助团队协同完成大语言模型应用的开发、监控与调试。2026 年 8 月 25 日，Langfuse 发布了 v4.19.0 版本，本次更新聚焦平台治理能力与 API 能力：新增组织级功能预览（Feature Preview）默认值设置，并开放模型定义（Model Definition）的 upsert 接口，同时修复了多项评估、仪表盘、链路追踪与鉴权体验问题。

核心亮点

1. 组织级功能预览默认值（Feature Preview）

此前功能预览（Feature Flag）默认值多按实例或用户维度控制，规模化团队难以统一治理。v4.19.0 引入组织（org）层级的功能预览默认值设置（PR #16426，由 @nimarb 贡献），管理员可在组织范围内集中配置预览特性的默认开关，让新特性的灰度与上手策略在团队内保持一致。

2. 模型定义 Upsert API

API 层新增模型定义 upsert 端点（PR #16516，由 @hassiebp 贡献）。这意味着在批量同步或更新模型元数据时，调用方可直接 upsert（存在则更新、不存在则创建），无需先查询再区分创建/更新，简化了与内部模型注册表、成本计费系统的集成流程。

3. 评估与链路追踪体验修复

评估（Evals）：隐藏代码评估器的变量映射展示，减少评测配置界面的干扰信息（PR #16527，@wochinge）。
仪表盘（Dashboard）：将指标标签堆叠在「大数字」下方，提升关键指标的可读性（PR #16266，@nkabardin）。
链路（Traces）：JSON 查看器跳转（jump-to）改为无动画瞬时定位，长链路浏览更顺滑（PR #16542，@nkabardin）。
成本拆分（Shared）：在链路明细表中分别统计缓存（cache）与推理（reasoning）的成本，让 Token 与花费归因更精确（PR #16544，@milanagm）。

4. 鉴权健壮性

修复了 next-auth 登录在 JSON 响应不含回调 URL（callback URL）时的处理逻辑（PR #16541，@cursor[bot]），提升了第三方登录流程的兼容性与稳定性。

5. 工程与依赖维护

扩展 ESLint 规则 @repo/no-abstracted-overlay-trigger（PR #16548，@bezbac）。
升级 @ferrucc-io/emoji-picker 至 0.1.2（PR #16512，@ktachibana-ca，同时也是本次版本的新贡献者）。
重构前端 DeleteAutomationButton 与 Callout 组件（PR #16523、#16539，@bezbac）。

发布产物

Langfuse 以容器镜像方式分发，本次 v4.19.0 未附带独立二进制发布包，请通过以下方式获取与升级：

Docker 镜像

langfuse/langfuse:4.19.0

自托管升级（Docker Compose）

# 拉取并更新到最新编排
docker compose pull
docker compose up -d

官方安装文档

自托管部署：https://langfuse.com/docs/deployment/self-host
完整变更对比：https://github.com/langfuse/langfuse/compare/v4.18.0…v4.19.0

关于 Langfuse

Langfuse 是一个开源的 LLM 工程平台，帮助团队在 LLM 应用的开发、监控与调试环节进行协同。它提供链路追踪（Tracing）、评估（Evaluations）、提示词管理（Prompt Management）与成本可观测能力，支持 Langfuse Cloud 托管与私有化自托管两种形态。

获取与升级

发布说明：https://github.com/langfuse/langfuse/releases/tag/v4.19.0
在线体验：https://langfuse.com/demo
自托管文档：https://langfuse.com/docs/deployment/self-host

使用最新镜像启动 / 升级：

docker run -p 3000:3000 -e DATABASE_URL=postgresql://user:password@localhost:5432/langfuse -e LANGFUSE_SALT=my-secret-salt langfuse/langfuse:4.19.0