LangChain 项目总览

摘要

LangChain 当前是一个 Python monorepo,核心位于 libs/ 下,包含基础抽象、经典包、v1 包、第三方集成、文本切分、标准测试与模型配置等多个子包。

仓库位置

  • /home/zouhaipeng/work/agent/langchain

已确认的顶层结构

  • README.md
  • AGENTS.md
  • .github/
  • libs/
  • .devcontainer/
  • .vscode/

从仓库内开发说明提炼出的关键认识

  • libs/core/langchain-core 的基础抽象和协议
  • libs/langchain/langchain-classic,偏 legacy / 经典实现
  • libs/langchain_v1/:当前活跃维护的 langchain
  • libs/partners/:第三方集成,如 OpenAI、Anthropic、Ollama 等
  • libs/text-splitters/:文本切分工具
  • libs/standard-tests/:共享标准测试套件
  • libs/model-profiles/:模型配置画像

当前理解

  • 这是一个多包 monorepo,不适合按单包项目的方式粗暴阅读
  • 阅读重点应先聚焦 libs/ 分层,再顺着关键抽象精读
  • AGENTS.md 已经提供了很强的结构提示,可作为初始地图

推荐下一步

  1. 先完成 01-repo-map.md
  2. 明确 core / langchain_v1 / partners 的边界
  3. 梳理 Runnable、Agent、Tool、Model 等核心抽象
  4. 记录测试与示例如何反映设计意图