用途：安装 Langfuse SDK 并配置认证，为 LLM 应用接入可观测性（追踪、提示词管理、数据集、评分）。
主要能力：
- 覆盖两套 SDK：v3 旧版单包（langfuse）与 v4+ 模块化 SDK（@langfuse/*，基于 OpenTelemetry）。
- 支持 TypeScript/JavaScript 与 Python。
- 提供环境变量配置、初始化与连接验证流程，并给出常见错误排查。
安装： TypeScript/JavaScript v4+（推荐）：npm install @langfuse/client（核心客户端）；npm install @langfuse/tracing @langfuse/otel @opentelemetry/sdk-node（追踪）；npm install @langfuse/openai（OpenAI 封装）；npm install @langfuse/langchain（LangChain 集成）。 v3 旧版：npm install langfuse。Python：pip install langfuse。
前置条件：Node.js 18+ 或 Python 3.9+；包管理器 npm/pnpm/pip；Langfuse 账户（云 https://cloud.langfuse.com 或自托管）；项目设置中的 Public Key（pk-lf-...）与 Secret Key（sk-lf-...）。
配置：在仪表盘 Settings > API Keys 创建密钥对，设置环境变量 LANGFUSE_PUBLIC_KEY、LANGFUSE_SECRET_KEY、LANGFUSE_BASE_URL（云默认 https://cloud.langfuse.com）。注意 v4+ 用 LANGFUSE_BASE_URL，v3 用 LANGFUSE_HOST 或 LANGFUSE_BASEURL。
验证：v4+ 通过 NodeSDK 注册 LangfuseSpanProcessor 并启动，创建 LangfuseClient，用 startActiveObservation 发送测试追踪；v3 用 langfuse.trace() 并 flushAsync；Python 用 Langfuse(...) 发测试追踪并 flush。
适用场景：新建 Langfuse 集成、配置 API 密钥、初始化 SDK，以及自托管主机变更后的验证。
限制：密钥需保密，Secret Key 具写权限；仅记录凭据是否设置，不打印密钥值、请求头或编译后的提示词。常见问题包括 401（密钥无效）、ECONNREFUSED（主机错误或服务不可用）、环境变量未加载、模块未安装、公私钥写反。具体收费、价格与效果资料暂未提供。