执行摘要

• 一句话：添加自动同步 LMSYS 博客到文档的工作流
• 推荐动作：值得关注工作流设计模式：利用 GitHub Actions 定时同步外部内容并通过条件提交实现自动化。删除冗余元数据的设计也体现了持续简化。不过建议后续补充断链检查等配套验证。

功能与动机

PR 描述指出 'This PR is aim to add a github workflow to automatically sync LMSYS blog to the SGLang documentation and also update the blog cards to the latest.' 目的是自动化博客同步，减少手动更新工作量。

实现拆解

1. 简化同步脚本：在 docs_new/scripts/update_lmsys_sglang_blogs.py 中删除 write_metadata 函数及相关导入 (asdict, datetime)，停止生成 lmsys_sglang_blogs.json 元数据文件。
2. 迁移并调整工作流：将工作流从 docs_new/.github/workflows/ 移至 .github/workflows/，修改运行路径为 python docs_new/scripts/...，将 git add 范围缩小至仅 docs_new/index.mdx，并调整无变更检测条件，仅当 index.mdx 有改动时才提交。
3. 删除冗余元数据文件：删除 docs_new/src/generated/lmsys_sglang_blogs.json，该静态 JSON 已不再需要。
4. 更新博客卡片内容：在 docs_new/index.mdx 中替换 6 条博客卡片，加入最新文章（如 DeepSeek-V4、HiSparse），包括标题、URL、图片和日期。
5. 更新标签器配置：在 .github/labeler.yml 中为 documentation 标签添加 .mdx 文件和 docs_new/**/* 路径，确保文档变更被正确标记。
   注意：本 PR 未包含测试变更，因为工作流依赖外部 API 且为基础设施代码。

关键文件：

• docs_new/scripts/update_lmsys_sglang_blogs.py（模块 同步脚本；类别 source；类型 core-logic；符号 write_metadata）: 核心同步脚本，删除了 write_metadata 函数及相关导入，简化逻辑。
• docs_new/src/generated/lmsys_sglang_blogs.json（模块 生成数据；类别 config；类型 deletion）: 被删除的元数据文件，不再需要。
• .github/workflows/sync-lmsys-sglang-blogs.yml（模块 CI工作流；类别 infra；类型 rename-or-move）: 工作流定义，从 docs_new/.github/workflows/ 移动并调整路径和 git 逻辑。
• docs_new/index.mdx（模块 文档首页；类别 other；类型 core-logic）: 博客卡片更新，反映最新博客内容。
• .github/labeler.yml（模块 仓库配置；类别 infra；类型 infrastructure）: 更新 labeler 规则，包括 .mdx 文件和 docs_new 目录。

关键符号：write_metadata, main

关键源码片段

docs_new/scripts/update_lmsys_sglang_blogs.py

核心同步脚本，删除了 write_metadata 函数及相关导入，简化逻辑。

def main() -> None:
    sources = download_blog_sources()
    relevant_posts: list[BlogPost] = []
​
    for filename, content in sources:
        post = parse_blog_post(filename=filename, content=content)
        if post is not None:
            relevant_posts.append(post)
​
    relevant_posts.sort(key=lambda post: post.slug, reverse=True)
    selected_posts = relevant_posts[:MAX_CARDS]
​
    generated_cards = render_cards(selected_posts)
    current_index = INDEX_PATH.read_text(encoding="utf-8")
    updated_index = replace_generated_block(
        index_text=current_index, generated_cards=generated_cards
    )
​
    # 仅在 index.mdx 有变化时才写回文件
    if updated_index != current_index:
        INDEX_PATH.write_text(updated_index, encoding="utf-8")
​
    # 此处之前调用 write_metadata()，现已移除
    print(
        "Scanned "
        f"{len(sources)} blog files, matched {len(relevant_posts)} posts, "
        f"published {len(selected_posts)} cards."
    )

评论区精华

在 review 中，ping1jing2 建议同步更新 lint.yml 以将 docs_new 纳入 lychee 链接检查。作者回应 Mintlify 自带链接检查工具，计划另开 PR 处理，ping1jing2 同意。双方决定将链接检查改进延后到后续 PR。

• 将 docs_new 加入 lychee 链接检查 (documentation): 不在本 PR 处理，后续 PR 单独完成。

风险与影响

• 风险：主要风险在于工作流依赖外部 GitHub API（lm-sys 仓库），若 API 限频或变更可能导致同步失败。但博客卡片更新非关键，失败影响有限。另外，删除 lmsys_sglang_blogs.json 可能影响依赖该文件的其他工具，但当前文档生成流程已重构为直接嵌入卡片，该文件已无必要。
• 影响：对系统运行时无影响，仅影响文档自动更新流程。降低维护成本，使博客卡片保持最新。对用户透明。
• 风险标记：外部API依赖, 文档自动更新可靠性

关联脉络

• 暂无明显关联 PR