> ## 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.

# 发布集成

**使您的集成可供社区使用。**

<Warning>
  **请勿向 LangChain 或 Deep Agents 仓库提交集成 PR。**

  新的集成应作为**独立的 PyPI 包**发布在您自己的 GitHub 组织或账户下（例如 `langchain-yourservice`），而不是作为 PR 提交到 [`langchain-ai/langchain`](https://github.com/langchain-ai/langchain) 仓库。

  主仓库仅包含由 LangChain 团队维护的一小部分第一方集成（如 OpenAI、Anthropic 和 Ollama）。
</Warning>

现在您的包已经实现并测试完毕，您可以发布它并添加文档，以便社区能够发现它。

## 发布您的包

<Info>
  本指南假设您已经实现了您的包并为其编写了测试。如果尚未完成，请参阅[实现指南](/oss/python/contributing/implement-langchain)和[测试指南](/oss/python/contributing/standard-tests-langchain)。
</Info>

出于本指南的目的，我们将使用 PyPI 作为包注册表。如果您愿意，也可以选择发布到其他注册表；具体说明会有所不同。

### 设置凭据

首先，确保您拥有一个 PyPI 账户：

<AccordionGroup>
  <Accordion title="如何创建 PyPI 令牌" icon="key">
    <Steps>
      <Step title="创建账户">
        访问 [PyPI 网站](https://pypi.org/) 并创建一个账户
      </Step>

      <Step title="验证邮箱">
        通过点击 PyPI 发送给您的链接来验证您的电子邮件地址
      </Step>

      <Step title="启用 2FA">
        转到您的账户设置并点击“生成恢复代码”以启用双因素认证。要生成 API 令牌，您**必须**启用 2FA
      </Step>

      <Step title="生成令牌">
        转到您的账户设置并[生成新的 API 令牌](https://pypi.org/manage/account/token/)
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

### 构建与发布

<Card title="如何发布包" icon="upload" href="https://docs.astral.sh/uv/guides/package/" arrow>
  来自 `uv` 的关于如何构建包并将其发布到 PyPI 的实用指南。
</Card>

## 添加文档

要将您的包的文档添加到本站的[集成选项卡](/oss/python/integrations/providers/overview)下，您需要创建相关的文档页面并在 [LangChain 文档仓库](https://github.com/langchain-ai/docs)中提交一个 PR。

### 编写文档

根据您构建的集成类型，您需要创建不同类型的文档页面。LangChain 为不同类型的集成提供了模板，以帮助您入门。

<CardGroup>
  <Card title="聊天模型" icon="message" href="https://github.com/langchain-ai/docs/blob/main/src/oss/python/integrations/chat/TEMPLATE.mdx" arrow />

  <Card title="工具/工具包" icon="tool" href="https://github.com/langchain-ai/docs/blob/main/src/oss/python/integrations/tools/TEMPLATE.mdx" arrow />

  <Card title="中间件" icon="plug" href="https://github.com/langchain-ai/docs/blob/main/src/oss/python/integrations/middleware/TEMPLATE.mdx" arrow />

  <Card title="向量存储" icon="database" href="https://github.com/langchain-ai/docs/blob/main/src/oss/python/integrations/vectorstores/TEMPLATE.mdx" arrow />
</CardGroup>

<Tip>
  要参考现有文档，您可以查看[集成列表](/oss/python/integrations/providers/overview)并找到与您的集成类似的文档。

  要查看给定文档页面的原始 Markdown，请使用页面右上角“复制页面”旁边的下拉按钮，然后选择“以 Markdown 查看”。
</Tip>

### 向文档仓库提交 PR

在个人 GitHub 账户下 fork [LangChain 文档仓库](https://github.com/langchain-ai/docs)（不是主 `langchain` 仓库），并将其克隆到本地。为您的集成创建一个新分支。复制模板并使用您喜欢的 Markdown 文本编辑器进行修改。编写文档时，请务必参考并遵循[文档指南](/oss/python/contributing/documentation)。

<Info>
  此 PR **仅用于文档**。您的集成包本身应位于您 GitHub 组织或账户下的独立仓库中，并作为独立包发布到 PyPI。
</Info>

<Warning>
  如果出现以下情况，我们可能会拒绝 PR 或要求修改：

  * CI 检查失败
  * 存在严重的语法错误或拼写错误
  * [Mintlify 组件](/oss/python/contributing/documentation#mintlify-components)使用不当
  * 页面缺少 [frontmatter](/oss/python/contributing/documentation#page-structure)
  * 缺少[本地化](/oss/python/contributing/documentation#localization)（如适用）
  * [代码示例](/oss/python/contributing/documentation#in-code-documentation)无法运行或存在错误
  * 未达到[质量标准](/oss/python/contributing/documentation#quality-standards)
</Warning>

由于我们处理大量 PR，请耐心等待。我们将尽快审查您的 PR 并提供反馈或合并它。**请勿反复标记维护者询问您的 PR 状态。**

<Note>
  如果您的 PR 包含 AI 生成的内容，您必须遵循我们的 [LLM 可接受使用政策](/oss/python/contributing/overview#acceptable-uses-of-llms)。
</Note>

***

## 后续步骤

**恭喜！** 您的集成现已发布并记录在案，可供整个 LangChain 社区使用。

<Card title="联合营销" icon="speakerphone" href="/oss/python/contributing/comarketing" arrow>
  联系 LangChain 营销团队，探讨联合营销机会。
</Card>

***

<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/publish-langchain.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>