欢迎!感谢你有兴趣参与贡献。 LangChain 帮助形成了生成式 AI 领域最大的开发者社区,并始终欢迎新的贡献者。无论你是在修复 bug、添加功能、改进文档,还是分享反馈,你的参与都会让 LangChain 和 LangGraph 对所有人变得更好。

贡献方式

发现 bug?请按以下步骤帮助修复:
1

搜索

检查相应仓库的 GitHub Issues 中是否已经存在该问题:

LangChain

Issues

LangGraph

Issues

Deep Agents

Issues
2

创建 issue

如果不存在相关 issue,请创建一个新的。撰写时请遵循提供的模板,并包含一个最小、可复现示例。创建后,请为最终 issue 添加任何相关标签。如果项目维护者无法复现问题,该问题很可能无法及时处理。
3

等待

项目维护者会分流该 issue,并可能请求更多信息。维护者需要处理大量 issue,请耐心等待。除非你有新信息要提供,否则不要顶帖。
如果你要添加 issue,请尽量让它聚焦于单个主题。如果两个 issue 相关或相互阻塞,请链接它们,而不是合并在一起。例如:
This issue is blocked by #123 and related to #456.
有新功能或改进想法?
1

搜索

在对应仓库的 issues 中搜索已有功能请求:

LangChain

Issues

LangGraph

Issues

Deep Agents

Issues
2

讨论

如果不存在相关请求,请在相关分类下开始新讨论,以便项目维护者和社区提供反馈。
3

描述

请务必描述用例,以及它为什么对其他人有价值。如有可能,请提供示例或 mockup。列出应通过的测试用例。
欢迎改进文档。LangChain 致力于让文档清晰而全面,你的视角可以带来很大帮助。

如何提出文档变更

指南
用户群体庞大,小团队很难跟上所有功能请求和 bugfix。如果你有技能和时间,LangChain 很希望得到你的帮助。

如何提交第一个 Pull Request

指南
如果你开始处理某个 issue,请将它分配给自己,或请维护者这样做。这有助于避免重复工作。如果你正在寻找可以处理的问题,请查看仓库中标记为 “help wanted” 的 issue:

LangChain

标签

LangGraph

标签

Deep Agents

标签
任何人都可以构建并发布自己的 LangChain 集成包。新集成不会作为 PR 接收到 langchain-ai 仓库,必须独立发布到 PyPI 或 npm。

LangChain

构建 LangChain 集成指南

Deep Agents sandboxes

构建 sandbox 集成指南

Pull request 要求

所有 pull request 都必须链接到已由维护者批准解决方案的 issue 或 discussion。 没有事先批准的 PR 会被关闭。
所有 pull request 都应展示有意义的投入和上下文理解。如果创建 pull request 所需的努力小于维护者审查它所需的努力,则不应提交该贡献。 低投入的随手贡献,无论如何生成,往往在上下文相关性、准确性和质量上都不达标。大规模自动化贡献会对人的精力构成拒绝服务攻击。 所有外部 pull request 都必须满足以下要求:
  • Pull request 必须链接到已由维护者批准解决方案的 issue 或 discussion。
  • Pull request 必须填写仓库的 pull request 模板。
如果不满足这些要求,维护者保留不作评论直接关闭 PR 的权利。LangChain 会关闭看起来像低投入垃圾内容的 pull request 和 issue。

语言政策

所有贡献,包括 issue、pull request、代码审查和讨论,都必须使用英文。这可以让全球贡献者都能访问和搜索沟通内容。 如果英语不是你的第一语言,不用担心。LangChain 重视清晰沟通胜过完美语法,也欢迎使用翻译工具。

可接受的 LLM 使用方式

你可以使用 AI assistant 帮助起草或修改贡献,但前提是你验证每项变更:运行并测试代码,根据代码库和官方提供商文档检查事实,并确保结果符合仓库风格。不要提交批量、未经审查的生成内容。对于读起来像低投入或垃圾内容的 pull request,无论其如何生成,LangChain 都会关闭。