> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 贡献指南

**欢迎！感谢您有兴趣参与贡献。**

LangChain 已帮助形成了生成式 AI 领域最大的开发者社区，我们始终欢迎新的贡献者。无论您是修复错误、添加功能、改进文档还是分享反馈，您的参与都有助于让 LangChain 和 LangGraph 对所有人变得更好 🦜❤️

## 贡献方式

<AccordionGroup>
  <Accordion title="报告错误" icon="bug">
    发现了一个错误？请按照以下步骤帮助我们修复它：

    <Steps>
      <Step title="搜索">
        检查该问题是否已存在于相应仓库的 GitHub Issues 中：

        <Columns cols={3}>
          <Card title="LangChain" icon="link" href="https://github.com/langchain-ai/langchainjs/issues">问题</Card>
          <Card title="LangGraph" icon="topology-ring" href="https://github.com/langchain-ai/langgraphjs/issues">问题</Card>
          <Card title="Deep Agents" icon="robot" href="https://github.com/langchain-ai/deepagentsjs/issues">问题</Card>
        </Columns>
      </Step>

      <Step title="创建问题">
        如果不存在相关问题，请创建一个新问题。撰写时，请务必遵循提供的模板，并包含一个[最小、可复现的示例](https://stackoverflow.com/help/minimal-reproducible-example)。创建最终问题后，请附加任何相关的标签。如果项目维护者无法复现该问题，则不太可能及时处理。
      </Step>

      <Step title="等待">
        项目维护者将对问题进行分类，并可能要求提供更多信息。由于我们处理的问题量很大，请耐心等待。除非您有新的信息需要提供，否则请不要顶帖。
      </Step>
    </Steps>

    如果您要添加一个问题，请尽量使其专注于单一主题。如果两个问题相关或相互阻塞，请[链接它们](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword)而不是合并它们。例如：

    ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
    此问题被 #123 阻塞，并与 #456 相关。
    ```
  </Accordion>

  <Accordion title="建议功能" icon="wand">
    对新功能或增强功能有想法？

    <Steps>
      <Step title="搜索">
        在相应仓库的问题中搜索现有的功能请求：

        <Columns cols={3}>
          <Card title="LangChain" icon="link" href="https://github.com/langchain-ai/langchainjs">问题</Card>
          <Card title="LangGraph" icon="topology-ring" href="https://github.com/langchain-ai/langgraphjs/labels?q=feature">问题</Card>
          <Card title="Deep Agents" icon="robot" href="https://github.com/langchain-ai/deepagentsjs/issues?q=is%3Aissue%20state%3Aopen%20label%3Aenhancement">问题</Card>
        </Columns>
      </Step>

      <Step title="讨论">
        如果不存在相关请求，请在[相关类别](https://forum.langchain.com/c/oss-product-help-lc-and-lg/16)下发起新的讨论，以便项目维护者和社区提供反馈。
      </Step>

      <Step title="描述">
        请务必描述用例以及它为何对他人有价值。如果可能，请提供示例或模型。概述应通过的测试用例。
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="改进文档" icon="book">
    欢迎改进文档！我们努力保持文档清晰全面，您的视角可以带来很大不同。

    <Card title="如何提出文档更改建议" href="/oss/javascript/contributing/documentation" arrow>指南</Card>
  </Accordion>

  <Accordion title="贡献代码" icon="code">
    由于用户基数庞大，我们的小团队可能难以跟上所有的功能请求和错误修复。如果您有技能和时间，我们非常乐意得到您的帮助！

    <Card title="如何创建您的第一个拉取请求" href="/oss/javascript/contributing/code" arrow>指南</Card>

    如果您开始处理某个问题，请将其分配给您自己或请维护者分配。这有助于避免重复工作。

    如果您正在寻找可以处理的内容，请查看我们仓库中标记为“help wanted”的问题：

    <Columns cols={3}>
      <Card title="LangChain" icon="link" href="https://github.com/langchain-ai/deepagents/labels?q=help+wanted">标签</Card>
      <Card title="LangGraph" icon="topology-ring" href="https://github.com/langchain-ai/langgraphjs/labels?q=help+wanted">标签</Card>
      <Card title="Deep Agents" icon="robot" href="https://github.com/langchain-ai/deepagentsjs/labels?q=help+wanted">标签</Card>
    </Columns>
  </Accordion>

  <Accordion title="构建新的集成" icon="plug-connected">
    任何人都可以构建并发布自己的 LangChain 集成包。新的集成不会作为 PR 被接受到 `langchain-ai` 仓库中——它们必须独立发布到 PyPI 或 npm。

    <Card title="LangChain" icon="link" href="/oss/javascript/contributing/integrations-langchain" arrow>构建 LangChain 集成的指南</Card>
    <Card title="Deep Agents 沙盒" icon="cube" href="/oss/javascript/contributing/integrations-langchain" arrow>构建沙盒集成的指南</Card>
  </Accordion>
</AccordionGroup>

## 拉取请求要求

<Warning>
  **所有拉取请求必须链接到一个已由维护者批准解决方案的问题或讨论。** 未经事先批准的 PR 将被关闭。
</Warning>

所有拉取请求都应展示有意义的努力和上下文理解。**如果创建拉取请求所需的努力小于维护者审查它所需的努力，则不应提交该贡献。** 低努力的“路过式”贡献——无论其如何产生——通常在上下文相关性、准确性和质量方面达不到要求。大规模的自动化贡献对我们的人力工作构成了拒绝服务攻击。

所有外部拉取请求必须满足以下要求：

* 拉取请求必须链接到一个已由维护者批准解决方案的问题或讨论。
* 拉取请求必须填写仓库的拉取请求模板。

如果这些要求未得到满足，维护者保留不加评论关闭 PR 的权利。**我们将关闭那些看起来是低努力或垃圾信息的拉取请求和问题。**

## 语言政策

所有贡献——问题、拉取请求、代码审查和讨论——必须使用英语。这使得沟通在全球贡献者群体中易于访问和搜索。

如果英语不是您的母语，请不要担心。我们重视清晰的沟通胜过完美的语法，并且欢迎使用翻译工具。

## LLM 的可接受用途

当您**验证每一项更改**时，您可以使用 AI 助手来帮助起草或修改贡献：运行和测试代码，根据代码库和官方提供商文档检查事实，并确保结果符合仓库风格。不要提交未经审查的批量生成内容。我们将关闭那些读起来像低努力或垃圾信息的拉取请求，无论其如何产生。

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/contributing/overview.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>
