# @cat-factory/observability-langfuse 中文文档

规范地址：https://npmcn.com/package/%40cat-factory/observability-langfuse/

版本：0\.11\.86
npm 元数据更新时间：2026-11-06T13:56:38.488Z
中文译文更新时间：2026-11-09T05:59:18.541Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cat-factory/observability-langfuse
原文对照：https://npmcn.com/package/%40cat-factory/observability-langfuse/?lang=original
源码仓库：https://github.com/kibertoad/cat-factory

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：12.1 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-06-24T15:21:55.128Z
- 最新版本发布：2026-11-06T13:56:38.076Z
- 近 30 天下载量：5493（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：520（近 12 个月 520 个）

## 中文简介

Opt -in Langfuse追踪槽 为代理建筑委员会。 工人安全的OTLP/HTTP出口商指向了Langfuse的"OpenTeleometry"端点,因此LLM世代和容器工具在Cloudflare Worker和Node外观上都横跨了没有改变的流.

## 安装

```sh
npm install @cat-factory/observability-langfuse
```

也可以使用：`pnpm add @cat-factory/observability-langfuse`、`yarn add @cat-factory/observability-langfuse`、`bun add @cat-factory/observability-langfuse`

## README

# @ cat-factory/可观察性-langfuse

选入 [兰福斯](https://langfuse.com/) 代理建筑局的追踪水槽.

它执行运行时间中立 `LlmTraceSink` 端口从 `@cat-factory/kernel`这样 当连接到每个 LLM 调用: 容器代理调用( 通过 LLM 代理) **财务报告和审定财务报表** 内置调用( 需要审查、 文件规划员、 碎片选择器、 内置调用) 物剂:在Langfuse的地表上,作为一代人, 归在它的追踪之下 可选容器工具跨度.

## OTLP出口商指着Langfuse

这个水槽是 `@cat-factory/observability-otel`以取取为基础的 OTLP/ HTTP 出口国, 有3个 构造器中朗福斯特定决定:终点 `{baseUrl}/api/public/otel` (出口者附上) `/v1/traces`), HTTP Basic 认证在键对之上 `x-langfuse-ingestion-version: 4` v4需要实时摄入的页眉. 计量 因为Langfuse只执行追踪信号.

以前是自己的客户 说Langfuse的批次 **摄取 API** (单位:千美元)`POST /api/public/ingestion`) (中文(简体) ). API堕落了 朗福斯云上日落了 **2026-11-16 (英语)**,则 `trace-create` 编号 : `generation-create` 编号 : `span-create` 它发送的事件 v4 数据模型中已不支持。 OTLP 是支持的路径, 而这个 repo 已经说过了.

两者都不取决于官方 `langfuse` 节点 SDK 或任何 `@opentelemetry/*` 软件包: 依赖Cloudflare Worker 运行时间上无法使用的仅节点 API (workerd),它使水槽字节在两个外观上都保持了一模一样.

## 行为

-   从不向呼叫者丢入:每个冲浪会吞下自己的错误(最多博客 a) )),该词的原意是: 观察力绝不能中断代理工作.
-   同样的荣誉 `LLM_RECORD_PROMPTS` 隐私切换为本地的公制商店 : 即时录音被关闭,世代携带使用/计时/元数据,但没有即时或 反应机构.

## 使用量

```ts
import { createLangfuseSink } from '@cat-factory/observability-langfuse'

const sink = createLangfuseSink({
  publicKey: env.LANGFUSE_PUBLIC_KEY,
  secretKey: env.LANGFUSE_SECRET_KEY,
  baseUrl: env.LANGFUSE_BASE_URL, // optional; defaults to Langfuse Cloud
})
```

通过其容器接入外表 `selectLangfuseSink(config)`; 缺少配置 {} 水槽从未建造过,也没有外部排放或行为变化.

## 常见问题

### @cat-factory/observability-langfuse 是什么？

Opt -in Langfuse追踪槽 为代理建筑委员会。 工人安全的OTLP/HTTP出口商指向了Langfuse的"OpenTeleometry"端点,因此LLM世代和容器工具在Cloudflare Worker和Node外观上都横跨了没有改变的流\.

### 如何安装 @cat-factory/observability-langfuse？

在项目目录运行 npm install @cat-factory/observability-langfuse，或使用 pnpm add / yarn add / bun add。

### @cat-factory/observability-langfuse 支持 TypeScript 吗？

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

### @cat-factory/observability-langfuse 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cat-factory/observability-langfuse 可以商用吗？

@cat-factory/observability-langfuse 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @cat-factory/observability-langfuse 的下载量有多少？

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

### @cat-factory/observability-langfuse 还在维护吗？

最新版本 0\.11\.86 发布于 2026/11/06（2 天前）；至今共发布 520 个版本，其中过去 12 个月发布了 520 个；首次发布于 2026/06/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。