用途:指导复杂 Langfuse 迁移,包括云到自托管、自托管到云、LangSmith 到 Langfuse、跨实例数据迁移,以及 SDK 升级。
主要能力:提供从源实例导出 traces、scores、prompts、datasets 的脚本,导入到目标实例;通过双写实现零停机迁移;校验两侧数据一致性;制定切换与回滚方案;输出迁移回执。
使用方式:先准备源与目标实例及 API 密钥、迁移分支与回滚计划。运行导出脚本 scripts/export-langfuse.ts,再运行导入脚本 scripts/import-langfuse.ts;用 src/lib/dual-write-langfuse.ts 配置双写;用 scripts/validate-migration.ts 校验;切换时更新 LANGFUSE_PUBLIC_KEY、LANGFUSE_SECRET_KEY、LANGFUSE_BASE_URL 并移除源处理器。
适用场景:Langfuse 实例迁移、平台切换、历史数据迁移。
限制:资料未提供具体定价与平台细节;traces 与 scores 为历史数据,引用旧 trace ID;回执中不应记录密钥或 trace 负载。