LangChain 仓库地图

摘要

LangChain 是一个以 libs/ 为中心的 Python monorepo,当前研究重点应放在核心抽象层、实现层和 integrations 层。

顶层目录

  • .github/
  • .devcontainer/
  • .vscode/
  • libs/

libs/ 下已发现的重要目录

  • libs/core/
  • libs/langchain/
  • libs/langchain_v1/
  • libs/model-profiles/
  • libs/partners/
  • libs/standard-tests/
  • libs/text-splitters/

分层理解

1. Core layer

  • 路径:libs/core/
  • 作用:基础抽象、接口、协议
  • 阅读目标:弄清楚哪些类型和协议是全仓库共享的

2. Implementation layer

  • 路径:libs/langchain/libs/langchain_v1/
  • 作用:高层公共实现
  • 阅读目标:区分 classic 与 v1 的职责和边界

3. Integration layer

  • 路径:libs/partners/
  • 作用:模型与第三方服务集成
  • 阅读目标:理解 provider 适配层设计

4. Testing layer

  • 路径:libs/standard-tests/
  • 作用:为 integrations 提供共享测试标准
  • 阅读目标:通过测试理解对外契约

5. Utility layer

  • 路径:libs/text-splitters/libs/model-profiles/
  • 作用:文本处理与模型配置

优先阅读建议

  1. libs/core/
  2. libs/langchain_v1/
  3. libs/partners/
  4. libs/standard-tests/
  5. libs/langchain/