用途:处理 langchain-ai/docs 中贡献者提交的集成文档 PR,使其符合 #4865 定义的托管指南资格政策。
主要能力:判断集成包月下载量(PyPI 或 npm)是否达到 50K,或是否存在维护者特批;据此决定保留托管 MDX 页面,还是删除托管页并改为外部文档条目。
使用方式:先查看当前分支与 PR 信息(git branch --show-current、gh pr view、git diff --stat upstream/main...HEAD),从 packages.yml、MDX 安装片段或注册表元数据确认包名。用 pypistats 或 npm API 统计近 30 天/上月下载量并报告。随后 git fetch upstream main 与 git rebase upstream/main,保留贡献者提交,把转换放在单独提交中。
外部转换(低于 50K):删除托管 MDX,在 scripts/data/integration_external_docs.yaml 对应语言与组件下添加 name、pypi/npm、docs_url;在对应 src/snippets/oss/*-downloads.mdx 增加下载行;all_providers 增加外链卡片;仅在存在公开 LangChain 相关包时追加 packages.yml(追加前确保末尾换行)。
托管/特批路径:保留或修复 MDX,遵循 TEMPLATE.mdx 的 frontmatter,除非维护者要求否则不设 featured: true;仅在要求时于 packages.yml 设 highlight: true,并用 partner_pkg_table 重新生成 overview,不手改 overview.mdx。
限制:不得编造下载量、文档 URL 或包名;不得编辑 build/;不得手改生成的 overview 表;除非用户要求否则不推送;维护者不可修改时需说明并询问是否另开 PR。改动 MDX 文案后运行 make lint_prose FILES="..."。
适用场景:LangChain 文档仓库集成 PR 的资格判定、rebase 与托管/外部转换。