执行摘要

本 PR 将 Rust 前端的 MiniJinja 与 minijinja-contrib 从 2.18.0 升级到 2.22.0，借助上游对同名 map key 遮蔽 dict 方法问题的修复（minijinja#903），删除此前在 #44311 中引入的 TemplateMap/TemplateValue 自定义包装，工具定义与工具调用参数改以普通 serde_json::Value 直接进入模板。同时采纳 Jinja2 风格的布尔直接渲染（True/False）并同步更新三处单测期望。16 个真实模型配置的 roundtrip 套件 prompt hash 全部稳定，无文档变更。

功能与动机

PR body 明确说明 "MiniJinja 2.22 fixes method lookup precedence for mappings with keys such as items"，这正好解决本地 Rust 前端在 HF chat 模板渲染中遇到的关键字遮蔽问题。此前 #44311 通过自定义 TemplateMap 强制在方法调用时返回 UnknownMethod，把 dict 方法路由交给 pycompat 回调；升级后该 workaround 不再需要，工具定义与工具调用参数可以以原生 serde_json::Value 传递。此外 2.22 引入 Jinja2 风格布尔渲染，需要对测试期望做同步调整。

实现拆解

1. 依赖升级：rust/Cargo.toml 中 minijinja/minijinja-contrib 版本从 2.0（Cargo.lock 实际锁定 2.18.0）提升到 2.22，并同步更新 rust/Cargo.lock。
2. 删除绕行实现：整个删除 rust/src/chat/src/renderer/hf/value.rs，其中 TemplateValue 递归包装 JSON 值、TemplateMap 基于 IndexMap 保序并在 call_method 中固定返回 UnknownMethod。
3. 接线简化：rust/src/chat/src/renderer/hf/mod.rs 中 TemplateToolFunction::arguments 与 TemplateToolDefinition::parameters 从 TemplateValue 改回 serde_json::Value，去掉 to_template_value 调用、mod value; 声明与相关 use；rust/src/chat/Cargo.toml 同步移除 indexmap 依赖。
4. 测试同步：mod.rs 内三处单元测试断言从 "true"/"none|true" 更新为 "True"/"none|True"，以匹配新渲染行为。
5. 回归验证：cargo test -p vllm-chat --lib（255 个）、chat 测试（17 个）、clippy 与 fmt 全部通过；真实模型 roundtrip 套件 16/16 通过，所有 prompt hash 在升级前后保持一致，MiniMax-M3 覆盖了原始 items 键冲突场景。

rust/src/chat/src/renderer/hf/value.rs

整个文件被删除，包含 TemplateValue 包装类型与 TemplateMap 自定义对象，是本次取消 workaround 的核心。

// 本文件在 PR 中整体删除（rust/src/chat/src/renderer/hf/value.rs）。
// 它当初是为了规避 minijinja#903：旧版 MiniJinja 的 Object::call_method
// 会先解析同名 map key，导致 map 中叫 `items` 的字段遮蔽 Python dict 方法。
// TemplateMap 通过强制返回 UnknownMethod，把 dict 方法交给 pycompat 回调。
use std::sync::Arc;
use indexmap::IndexMap;
use minijinja::value::{Enumerator, Object, ObjectExt, ObjectRepr};
use minijinja::{Error as TemplateError, ErrorKind as TemplateErrorKind, State};
use serde::Serialize;
use serde_json::Value as JsonValue;
​
#[derive(Debug, Serialize)]
#[serde(transparent)]
pub(super) struct TemplateValue(minijinja::Value);
​
pub(super) fn to_template_value(value: JsonValue) -> TemplateValue {
    TemplateValue(match value {
        JsonValue::Array(values) => values
            .into_iter()
            .map(to_template_value)
            .map(|v| v.0)
            .collect::<minijinja::Value>(),
        JsonValue::Object(values) => minijinja::Value::from_object(TemplateMap(
            values
                .into_iter()
                .map(|(k, v)| (k, to_template_value(v).0))
                .collect(),
        )),
        // 原始值直接走 from_serialize，保持数值表示不受 arbitrary_precision 影响
        value => minijinja::Value::from_serialize(value),
    })
}
​
#[derive(Debug)]
struct TemplateMap(IndexMap<String, minijinja::Value>);
​
impl Object for TemplateMap {
    fn repr(self: &Arc<Self>) -> ObjectRepr {
        ObjectRepr::Map
    }
​
    fn get_value(self: &Arc<Self>, key: &minijinja::Value) -> Option<minijinja::Value> {
        self.0.get(key.as_str()?).cloned()
    }
​
    // 所有方法调用一律返回 UnknownMethod，让 pycompat 的
    // unknown_method_callback 统一处理 dict 方法（items/keys/values 等）
    fn call_method(
        self: &Arc<Self>,
        _state: &State<'_, '_>,
        _method: &str,
        _args: &[minijinja::Value],
    ) -> std::result::Result<minijinja::Value, TemplateError> {
        Err(TemplateError::from(TemplateErrorKind::UnknownMethod))
    }
}

rust/src/chat/src/renderer/hf/mod.rs

工具参数接线从 TemplateValue 改回 JsonValue，删除 to_template_value 调用与 value 模块声明，并更新布尔渲染相关单测期望。

// rust/src/chat/src/renderer/hf/mod.rs 升级后的新接线：
// 工具参数不再经过 to_template_value 包装，而是以原生 JSON 直接进入模板。
use serde_json::Value as JsonValue;
​
#[derive(Debug, Serialize)]
struct TemplateToolFunction {
    name: String,
    // Tool call arguments 是普通 JSON Value；MiniJinja 2.22 起
    // 同名字段不会再遮蔽 dict 方法，故这里直接传递
    arguments: JsonValue,
}
​
#[derive(Debug, Serialize)]
struct TemplateToolDefinition {
    name: String,
    description: Option<String>,
    parameters: JsonValue,
    strict: Option<bool>,
}
​
fn to_template_tools(tools: &[ChatTool]) -> Vec<TemplateTool> {
    tools
        .iter()
        .map(|tool| TemplateTool {
            tool_type: "function",
            function: TemplateToolDefinition {
                name: tool.name.clone(),
                description: tool.description.clone(),
                // 保留原始 JSON，键序由 serde_json 的 preserve_order 特性保证
                parameters: tool.parameters.clone(),
                strict: tool.strict,
            },
        })
        .collect()
}

评论区精华

本 PR 没有实质性 review 讨论，只有自动化与审批记录：

• claude[bot]：仅提示仓库配置了手动 review 模式。
• njhill：APPROVE 并留言 "Thanks @BugenZhao"。
• WoosukKwon 与 njhill 各触发一次 /ci run，Buildkite CI 均通过。

风险与影响

• 行为变更：MiniJinja 2.22 将模板内直接渲染的布尔值从 true/false 改为 True/False。roundtrip 覆盖的 16 个模型 hash 稳定，但未覆盖全部自定义模板，依赖小写布尔输出的场景可能受影响。
• 依赖上游修复：删除 TemplateMap 后，items 等字段遮蔽问题完全依赖 MiniJinja 2.22 的修复。本项目未新增针对性单测，仅靠 roundtrip 的 MiniMax-M3 覆盖该场景，后续上游行为变化时可能静默回归。
• 序列化语义变化：工具参数从自定义 Object 改走原生 serde_json::Value，对象 repr、枚举方式等细节与之前不同；preserve_order 与 arbitrary_precision 配置保持不变，但若模板依赖对象类型特征需重新验证。
• 影响面：主要影响 Rust 前端（vllm-chat）的 HF 模板渲染链路，代码净减约 90 行，维护成本降低。

关联脉络

本 PR 直接回退了 #44311 引入的 workaround。#44311 当时是为了修复 HF chat 模板渲染中同名字段遮蔽 dict 方法的问题，并追加了 serde_json 的 arbitrary_precision 回归保护；本次升级 MiniJinja 2.22 后，上游已从根因修复，本地只需删除绕行代码。结合仓库近期多个 Rust 前端 PR（如 #51178 的 DP rank 路由、#51276 的 Buf schema 发布），可以看到 Rust 前端的依赖与基础设施正在持续走向成熟，这类"上游修复-回退本地绕行"的节奏也会越来越常见。