Langfuse 代码库导航图组织仓库映射与单体仓库路由指南【免费下载链接】langfuse Open source AI engineering platform: LLM evals, observability, metrics, prompt management, playground, datasets. Integrates with OpenTelemetry, LangChain, OpenAI SDK, LiteLLM, and more. YC W23项目地址: https://gitcode.com/GitHub_Trending/la/langfuse本文基于 Langfuse 仓库中langfuse-codebase-navigator技能的参考文档 repository-map.md系统讲解 Langfuse 组织级仓库清单、主产品单体仓库的关键代码区域、SDK/文档/部署仓库的目录地图以及跨仓库搜索的实操命令。读完后你可以在接手产品功能、摄取管道、共享查询层或任意周边仓库的任务前快速定位该去哪个仓库、从哪个目录开始、用什么rg命令搜索。一、Navigator 技能的定位与工作流程langfuse-codebase-navigator 是 Langfuse 团队为 Agent 设计的第一站导航技能在执行任何深度工作之前先完成三件事——选择正确的仓库、定位正确的代码区域、加载更具体的技能。其默认工作流见 SKILL.md 的 Default Workflow 一节为按领域对请求分类产品应用/API/后端/摄取/worker/ClickHouse/模型定价/评估/提示词/数据集/评分/traces →langfuse/langfuse文档/变更日志/博客 →langfuse/langfuse-docsSDK 行为 →langfuse-js、langfuse-python、langfuse-java部署与自托管 →langfuse-k8s、langfuse-terraform-*、oss-llmops-stackLangfuse Cloud 基础设施与运维 →infrastructure、analytics、langfuse-ops、platformGitHub Actions、CLI、MCP、n8n、示例、实验 → 查 repository-map.md 中对应的专业仓库。当路由不明显、任务跨仓库、或用户要求组织级导览时读取references/repository-map.md。编辑前先在目标仓库或兄弟仓库中查找更具体的技能如backend-dev-guidelines、clickhouse-best-practices若匹配则优先遵循它。优先在本地兄弟 checkout 中搜索缺少某仓库时用gh repo clone langfuse/repo $LANGFUSE_PARENT/repo克隆到同一父目录。以固定格式返回路由决策Route目标仓库及原因、Open first精确的技能路径或代码目录、Search next一到两条具体rg/gh命令、Caveat仅在依赖稀疏私有仓库元数据或仓库清单频繁变动时给出。这个先路由、后深挖的约定正是本文主体——仓库映射图repository map存在的意义它把组织内 28 个仓库、主单体仓库十余个关键目录、SDK 包结构、部署模块和搜索配方压缩成一张可查询的导航表。二、核心路由表从需求到起点目录repository-map.md 的第一张表是需求 → 起点 → 后续检查的映射。它按开发者最常见的任务域组织是整份地图的入口索引需求起点仓库应检查的目录产品 UI、API 路由、tRPC、认证、计费、提示词、数据集、评估、traces、sessions、scores、modelslangfuse/langfuseweb/src/features/**、web/src/pages/**、web/src/app/**、packages/shared/src/**摄取ingestion、队列、异步任务、导出、数据保留、评估运行器、后台 workerlangfuse/langfuseworker/src/**、packages/shared/src/server/**共享领域类型、仓储、服务、Postgres/ClickHouse 查询langfuse/langfusepackages/shared/src/domain/**、packages/shared/src/server/**、packages/shared/src/server/queries/**公开 API schema 及生成的服务端/客户端定义langfuse/langfusefern/apis/server/definition/**、fern/apis/client/definition/**、生成的客户端文档、变更日志、博客、手册、cookbook、集成、网站组件langfuse/langfuse-docscontent/**、app/**、components/**、components-mdx/**、cookbook/**JS/TS SDK 与集成langfuse/langfuse-jspackages/client、packages/core、packages/tracing、packages/otel、packages/openai、packages/langchainPython SDKlangfuse/langfuse-pythonlangfuse/**、langfuse/api/**、tests/**Java SDKlangfuse/langfuse-java生成的 Java 客户端与测试云基础设施、Terraform、ClickHouse 运维、负载测试、基础设施脚本langfuse/infrastructureterraform/**、clickhouse/**、scripts/**、load-tests/**Kubernetes / Helm 部署langfuse/langfuse-k8sHelm chart 与 Kubernetes 模板Terraform 部署模块langfuse/langfuse-terraform-aws、langfuse-terraform-gcp、langfuse-terraform-azure各云厂商特定模块文件Terraform providerlangfuse/terraform-provider-langfuseprovider 资源、生成的 schema、测试公开 agent 技能使用 Langfuselangfuse/skillsskills/langfuse/SKILL.md及其 references内部 Langfuse 团队技能langfuse/langfuse-internal-skills该仓库顶层技能文件夹CLIlangfuse/langfuse-clisrc/**、bin/**、openapi.ymlMCP 提示词管理服务器langfuse/mcp-server-langfusesrc/**n8n 节点langfuse/n8n-nodes-langfuse节点包源码实验 GitHub Actionlangfuse/experiment-actionaction.yml、src/**、schemas/**示例langfuse/langfuse-examples示例应用目录API 参考站点langfuse/langfuse-api-reference静态/生成的 API 参考资源对主仓库路由的直接印证上述主产品单体仓库三行产品 UI / 摄取与 worker / 共享查询层在当前 checkout 中可以直接验证这正是本地图最有价值的部分web/src/features/**与web/src/pages/**、web/src/app/**并存Langfuse 的 web 端同时保留了 Next.js Pages Router 路由web/src/pages/**含 100 个 API 处理器文件与 App Router 路由web/src/app/api业务功能则以 feature 目录组织如web/src/features/traces/200 文件、web/src/features/evals/400 文件、web/src/features/datasets/等。worker/src/**的三大分区与地图描述一致worker/src/features/放置异步功能处理器评估、实验、批量动作/导出、通知、trace 清理等worker/src/services/包含IngestionService/摄取服务、ClickhouseWriter/ClickHouse 写入器、dlq/死信队列三个服务原语worker/src/queues/定义 20 余个队列ingestionQueue.ts、otelIngestionQueue.ts、evalQueue.ts、batchExportQueue.ts、monitorQueue.ts等并带有分片队列注册表shardedQueueRegistry.ts。packages/shared/src/**的层级与路由表完全吻合domain/存放共享领域类型traces.ts、observations.ts、prompts.ts、scores.ts、dataset-items.ts等 17 个模块server/存放仓储、服务、认证、缓存、ClickHouse/Postgres 查询、S3、Redis、定价与 LLM 辅助模块server/queries/下按数据库拆分出clickhouse-sql/与postgres-sql/两个查询构建器目录features/存放提示词、数据集、评分、评估、模型定价、文件夹、评论、权益entitlements等共享特性逻辑。fern/apis/目录包含server/、client/、organizations/三个 API 定义域其中fern/apis/server/definition/含 39 个 OpenAPI 定义文件是公开 API 契约的源头web/public/generated/下则由 Fern 生成api/、api-client/、organizations-api/三份 YAML 产物。从源码结构看这张路由表不是静态的理想化描述而是与仓库当前目录结构逐项对应的活地图——这也是它在 SKILL.md 中被要求当路由不明显时必读的原因。三、组织仓库清单28 个仓库的可见性与用途repository-map.md 的第二张表是对 Langfuse 组织仓库快照文档标注快照来源为 2026-05-11 通过gh repo list langfuse --limit 1000 --json ...捕获快照时所有仓库均未归档且非 fork的完整索引。文档同时提醒当用户要求最新仓库状态时应刷新该清单。下表完整继承原文档内容Route When 一列说明何时应把任务路由到该仓库仓库可见性语言何时路由到此仓库.github公开n/a组织主页、默认社区健康度、组织级 GitHub 元数据202604-offsite-slides私有TypeScript内部 offsite 幻灯片工作。仅当用户点名或询问这些幻灯片时路由analytics私有Shell分析数据管道与文档、成本/数据集市、分析脚本background-jobs私有TypeScript元数据稀疏的早期私有后台任务工作。使用前先查看 READMEexperiment-action公开TypeScript运行 Langfuse 实验的 GitHub Action 工作流支持infrastructure私有HCLLangfuse Cloud 基础设施、Terraform、ClickHouse 运维、基础设施脚本、负载测试langfuse公开TypeScript主产品单体仓库web 应用、API、worker、共享包、生成的 API 定义langfuse-api-reference公开HTML生成或静态的 API 参考站点langfuse-cli公开TypeScriptLangfuse API 的 CLI 封装langfuse-docs公开MDX文档、变更日志、博客、集成、cookbook、手册、营销/文档网站langfuse-examples公开TypeScript展示部署与 Langfuse 用法的示例应用langfuse-ghsa-gccw-7cqr-2cjm私有TypeScript对应 GHSA 安全公告的修复/复现工作。按敏感信息对待langfuse-internal-skills私有Python内部团队技能支持、PR 漏斗、社交文案、会议纪要、Plain 搜索、写作与路由langfuse-java公开Java自动生成的 Langfuse API Java 客户端langfuse-js公开TypeScriptJS/TS SDK 包与集成tracing、OpenAI、LangChain、OTel、提示词、数据集、评分langfuse-k8s公开Go Template社区维护的 Kubernetes 配置与 Helm chartlangfuse-ops私有JavaScript私有运维工具。使用前查看 README/脚本langfuse-playground私有Python私有 playground/原型代码。用户点名或搜索证据指向时再用langfuse-python公开PythonPython SDK、生成的 API 客户端、装饰器、OTel、LangChain/OpenAI 集成测试langfuse-terraform-aws公开HCLAWS 部署的 Terraform 模块langfuse-terraform-azure公开HCLAzure 部署的 Terraform 模块langfuse-terraform-gcp公开HCLGCP 部署的 Terraform 模块mcp-server-langfuse公开TypeScriptLangfuse 提示词管理的 MCP 服务器n8n-nodes-langfuse公开JavaScriptLangfuse 提示词管理的 n8n 节点nofilter私有TypeScript黑客松/原型仓库。仅在点名或搜索证据指向时使用oss-llmops-stack公开n/a组合 LiteLLM 与 Langfuse 的模块化开源 LLMOps 技术栈platform私有Python元数据稀疏的私有平台仓库。非显然任务路由前先看 READMEskills公开Python公开可安装的 Langfuse agent 技能用于使用 Langfuse 及其文档/APItask-search-bar私有TypeScript小型私有任务/原型仓库。用户点名时使用terraform-provider-langfuse公开Go管理 Langfuse 资源的 Terraform providertmp-langfuse-otel-js私有TypeScript新 JS SDK v4 / OTel 工作的临时仓库。需确认工作是否已移入langfuse-js使用这张表时有一条明确的纪律原文档末段对私有、元数据稀疏的仓库只有在检查过其 README/根目录文件之后或用户明确点名时才路由进去。这是为了避免 Agent 在信息不足的私有仓库上做出错误假设。四、主产品单体仓库的关键区域详解文档对langfuse/langfuse的导航前提是一个约定从与当前 Langfuse 仓库同一父目录下的兄弟 checkoutlangfuse开始。地图随后列出 13 个重要区域并逐一对应源码职责web/src/features/**面向功能的 UI、hooks、服务端模块、页面与组件web/src/pages/**Next.js 页面与 API 路由web/src/app/**App-router 路由与 app 级 APIweb/src/components/**共享 UI、trace 展示、表格、布局、设计系统组件packages/shared/src/domain/**共享领域接口与业务类型packages/shared/src/server/**仓储、服务、认证、缓存、ClickHouse/Postgres 查询、S3、Redis、定价、LLM 辅助packages/shared/src/server/queries/**ClickHouse 与 Postgres 的 SQL 查询构建器packages/shared/src/features/**提示词、数据集、评分、评估、模型定价、文件夹、评论、权益的共享特性逻辑worker/src/features/**评估、实验、批量动作/导出、通知、traces、tokenization、清理的异步功能处理器worker/src/services/**摄取服务、ClickHouse 写入器、DLQ 与 worker 服务原语worker/src/queues/**队列定义与处理器fern/apis/server/definition/**服务端/公开 API 定义fern/apis/client/definition/**生成的客户端 API 定义ee/src/**与web/src/ee/**企业版专属代码。在当前 checkout 中ee/目录仅含ee-license-check/的许可校验逻辑企业特性的 UI 部分则位于web/src/ee/features/70 文件与地图企业代码分处两处的提示一致。而worker/src/features/下的实际子目录evaluation/、experiments/、batchAction/、batchExport/、notifications/、tokenisation/、batch-trace-deletion-cleaner/等也与地图描述的异步功能处理器清单逐项吻合——地图中的每一条路由都可以用ls或rg --files在本地直接验证这正是其可作为 Agent 决策依据的可信度来源。仓库本地技能清单.agents/skills地图同时把代码在哪个仓库与该任务应加载哪个技能绑定列出了主仓库.agents/skills下的 23 个仓库本地技能及其路由用途agent-setup-maintenanceagent 配置、生成的 shims、共享技能路由add-model-price模型价格默认值、provider 价格键、tokenizer ID、匹配模式其 references 目录下有provider-sources-and-price-keys.md、match-patterns.md等 7 份参考文档analyze-cloud-costsLangfuse Cloud 成本分析backend-dev-guidelinestRPC、API 端点、worker 处理器、Prisma、ClickHouse 服务、后端测试changelog-writing面向用户的发布说明clickhouse-best-practicesClickHouse schema/查询/迁移审查rules 目录含 30 条规则文档覆盖插入批量化、OPTIMIZE/FINAL规避、跳数索引、JOIN 策略、分区与主键基数字典等code-review仓库专属的正确性/回归审查cursor-agents-workflowCursor agent 的 Linear 分支命名、cursorGitHub 标签、人工测试步骤、PR 上的工作证明、Claude/Greptile/Codex 评审意见处理datadog-query-recipes生产排查可复用的 Datadog 查询形态debug-issue-with-datadog与 Langfuse 代码路径绑定的生产调试frontend-browser-review用户可见的web/**变更与浏览器验证frontend-large-feature-architecture大型前端功能、controller 状态与渲染性能git-workflowLangfuse 仓库的 Git/GitHub/分支/提交/PR/issue 工作流housekeeping跨 Linear、Pylon、GitHub 的周期性任务队列审查langfuse-codebase-navigator本导航技能本身组织、仓库、文件夹与技能路由linear-bug-triageLinear issue 去重与 bug 证据工作流pnpm-upgrade-packagepnpm 发布年龄约束下的依赖升级security-review用户提供的 URL、密钥、租户与认证范围的安全审查模式seed-test-data本地 Langfuse 种子场景traces、sessions、列表与事件数据skill-creator创建或更新仓库拥有的技能storybook编写或审查 React 组件 storiesturborepo任务图、缓存、包边界工作weekly-production-review跨 Datadog、incident.io、Linear 与修复项的每周生产审查。此外地图还指出web/.agents/skills下有两个前端专属技能vercel-react-best-practices与vercel-composition-patterns——当前仓库的web/.agents/skills/目录确实同时存在这两个技能文件夹。五、文档仓库与周边仓库的目录地图文档仓库langfuse-docs同样以同一父目录下的兄弟 checkout为前提文档仓库的关键区域为content/docs/**产品文档content/changelog/**变更日志条目content/blog/**博客文章content/integrations/**集成文档content/self-hosting/**自托管文档cookbook/**可运行的示例与 notebookapp/**文档、博客、变更日志、指南、集成、库的 Next.js 路由components/**与components-mdx/**文档站点 UI 与 MDX 组件。该 checkout 中还记录了一个仓库本地技能.claude/skills/add-yourself-to-team-langfuse/SKILL.md。SDK 与集成仓库langfuse-js的包结构地图packages/client高层客户端、提示词、数据集、评分、实验packages/core共享 API 客户端、常量、媒体、传播propagation、工具函数packages/tracingtracing 封装与 providerpackages/otelOpenTelemetry span processor 与媒体服务packages/openaiOpenAI 集成辅助packages/langchainLangChain 回调处理器tests/e2e与tests/integration行为覆盖。langfuse-python的模块地图langfuse/_client核心客户端、observe 装饰器、spans、数据集、传播langfuse/api生成的 API 客户端langfuse/langchain、langfuse/openai.py集成langfuse/_task_manager摄取与媒体上传队列tests/**SDK 行为与集成测试。其余集成仓库一行一个定位langfuse-javaJava API 客户端、langfuse-cli命令行 API 访问、mcp-server-langfuseMCP 提示词管理服务器、n8n-nodes-langfusen8n 提示词管理节点、experiment-action实验工作流 GitHub Action、terraform-provider-langfuseTerraform provider。部署与运维infrastructure仓库的关键区域terraform/environments/**环境特定的云资源terraform/modules/**可复用 Terraform 模块terraform/org/**组织级配置clickhouse/**ClickHouse 运维/配置scripts/**部署、迁移、一致性、性能与基础设施工具load-tests/**基础设施负载测试.agents/skills/infra-scaling/SKILL.md自动扩缩容与 RPM/容量工作流。部署类仓库langfuse-k8sHelm/Kubernetes chart 与模板、langfuse-terraform-awsAWS 模块、langfuse-terraform-gcpGCP 模块、langfuse-terraform-azureAzure 模块、oss-llmops-stack使用 LiteLLM 与 Langfuse 的参考开源 LLMOps 技术栈。技能仓库公开技能仓库langfuse/skills入口为skills/langfuse/SKILL.md文档/API/CLI/产品使用入口配套 references 共 7 份cli.md、instrumentation.md、prompt-migration.md、sdk-upgrade.md、error-analysis.md、user-feedback.md、skill-feedback.md内部技能仓库langfuse/langfuse-internal-skillsblog-writing文档博客写作与编辑、langfuse-pr-funnel功能公告分发草稿与草稿 PR、langfuse-support-triage一级支持问题排查与回复起草、langfuse-support-weekly-review每周支持/反馈趋势审查、meeting-notes日历与 Notion 会议纪要、摘要、行动项、plain-searchPlain 支持工单检索、social-post-drafterX/LinkedIn 文案、unslop以用户直接风格做简洁改写、langfuse-codebase-navigator本导航技能。六、搜索配方可直接复制的跨仓库检索命令repository-map.md 的最后一节给出四组实战搜索命令核心思路是先用git rev-parse定位兄弟仓库所在的父目录再在各仓库内用rg做限定目录的高密度搜索。以下完整继承原文档命令1. 主仓库功能搜索LANGFUSE_REPO_ROOT$(git rev-parse --show-toplevel) LANGFUSE_PARENT$(dirname $LANGFUSE_REPO_ROOT) cd $LANGFUSE_PARENT/langfuse rg -n prompt|dataset|score|trace|observation|session|eval web/src packages/shared/src worker/src限定在web/src、packages/shared/src、worker/src三个目录搜索能同时命中 UI、共享服务层与 worker 处理器三个平面。2. 文档仓库搜索cd $LANGFUSE_PARENT/langfuse-docs rg -n topic or feature name content app components components-mdx cookbook3. SDK 搜索cd $LANGFUSE_PARENT/langfuse-js rg -n observe|prompt|trace|span|score|dataset packages tests cd $LANGFUSE_PARENT/langfuse-python rg -n observe|prompt|trace|span|score|dataset langfuse tests两个 SDK 仓库都用同一组领域关键词observe/prompt/trace/span/score/dataset搜索体现以领域词而非符号名起步的检索习惯——这与主仓库的配方保持一致。4. 组织级搜索兜底gh repo list langfuse --limit 1000 --json name,description,isPrivate,primaryLanguage,pushedAt,url gh search code query org:langfuse --limit 50当本地兄弟 checkout 缺失或需要确认仓库清单是否过期对应文首刷新清单的提示时用gh重新拉取组织仓库清单跨仓库代码搜索优先使用本地克隆仅在本地缺失或需要确认当前默认分支时才回退到 GitHub 搜索SKILL.md 中对此有相同约束。SKILL.md 还补充了一条发现本地 checkout的命令可配合使用find $LANGFUSE_PARENT -mindepth 2 -maxdepth 2 -type d -name .git -print | sed s#/.git$##七、适用前提与使用边界使用这张导航图时有三点必须明确的边界均来自原文档自身的标注兄弟 checkout 前提地图中的langfuse-docs、langfuse-js、langfuse-python、infrastructure等条目指向与主仓库同一父目录的兄弟克隆而非当前仓库内部路径。在只有当前主仓库的单机环境中仅主产品单体仓库一节的路由与搜索配方可以直接落地其余仓库需按 SKILL.md 的建议先gh repo clone到同一父目录。快照时效仓库清单是基于 2026-05-11 的gh repo list捕获的快照且当时所有列出仓库均为未归档、非 fork 状态。清单中的私有仓库数量、tmp-langfuse-otel-js这类临时仓库的存续性都可能随时间变化涉及最新仓库状态的决策应重新执行组织搜索配方刷新。私有仓库纪律analytics、platform、background-jobs、langfuse-ops等元数据稀疏的私有仓库路由前必须先检查其 README 或根目录文件langfuse-ghsa-*安全公告仓库按敏感信息对待。综合来看repository-map.md 与 SKILL.md 共同构成了一套需求分类 → 仓库路由 → 目录定位 → 技能加载 → 定向搜索的完整导航协议。对主仓库部分其路由表可与web/src、packages/shared/src、worker/src、fern/apis的实际目录结构逐条对应验证对周边仓库部分它则以快照加刷新机制的方式管理时效性。掌握这张地图后任何涉及 Langfuse 代码定位的任务都可以从一个明确的起点目录 搜索命令出发而不必先做全仓库盲读。【免费下载链接】langfuse Open source AI engineering platform: LLM evals, observability, metrics, prompt management, playground, datasets. Integrates with OpenTelemetry, LangChain, OpenAI SDK, LiteLLM, and more. YC W23项目地址: https://gitcode.com/GitHub_Trending/la/langfuse创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考