@core-ai/langfuse

中文文档
0.38.0发布于 2026/11/06MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2876

@ core-ai/ core-ai 的 Langfuse 中间软件

中文使用文档
文档目录3 节
  1. 安装
  2. 设置
  3. 使用量

@core-ai/langfuse (英语)

npm

朗福斯中间软件 @core-ai/core-ai。 。 。 .

安装

npm install @core-ai/langfuse @langfuse/tracing @langfuse/otel @opentelemetry/sdk-node

@langfuse/tracing 财务报告和审定财务报表 @langfuse/otel 是同伴的依赖关系. @opentelemetry/sdk-node 需要登记 LangfuseSpanProcessor。 。 。 .

设置

创建一个仪器文件并在应用程序的入口处导入 :

import { NodeSDK } from '@opentelemetry/sdk-node';
import { LangfuseSpanProcessor } from '@langfuse/otel';

export const sdk = new NodeSDK({
    spanProcessors: [new LangfuseSpanProcessor()],
});

sdk.start();

使用量

import { wrapChatModel } from '@core-ai/core-ai';
import { createOpenAI } from '@core-ai/openai';
import { createLangfuseMiddleware } from '@core-ai/langfuse';

const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });

const model = wrapChatModel({
    model: openai.chatModel('gpt-5-mini'),
    middleware: createLangfuseMiddleware({ recordContent: true }),
});

recordContent 默认已禁用。 仅在您需要提示和输出时启用 附于Langfuse观察之后.

版本与发布记录

@core-ai/langfuse 共发布 39 个版本,首次发布于 2026/04/14;过去 12 个月发布了 39 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.38.0latest2026/11/064 天前
0.37.02026/11/055 天前
0.36.22026/10/2912 天前
0.36.12026/10/2813 天前
0.36.02026/10/2220 天前
0.35.02026/10/1427 天前

关于 @core-ai/langfuse 的常见问题

@core-ai/langfuse 是什么?

@ core-ai/ core-ai 的 Langfuse 中间软件

如何安装 @core-ai/langfuse?

在项目目录运行 npm install @core-ai/langfuse,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@langfuse/otel(^5.1.0)、@langfuse/tracing(^5.1.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@core-ai/langfuse 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@core-ai/langfuse 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@core-ai/langfuse 可以商用吗?

@core-ai/langfuse 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@core-ai/langfuse 的下载量有多少?

根据 npm 官方下载统计,@core-ai/langfuse 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,876 次,日均约 96 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@core-ai/langfuse 还在维护吗?

最新版本 0.38.0 发布于 2026/11/06(4 天前);至今共发布 39 个版本,其中过去 12 个月发布了 39 个;首次发布于 2026/04/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。