执行摘要

该 PR 修复了 Rust 前端 Kimi K3 渲染器在 tool 声明序列化上与 Python 前端及 checkpoint 编码不一致的问题：缺失的 description 不再被序列化为空字符串，显式的 strict 布尔值（含 false）得以保留，parameters schema 内的用户 null 值原样保留，并为 malformed 历史 tool 参数的 raw-text 回退补充了回归测试。改动范围集中在 rust/src/chat/src/renderer/kimi_k3/，行为对齐后同一请求在 Rust/Python 双栈下将产出一致的提示词。

功能与动机

PR body 明确表示："Align the Rust Kimi K3 renderer's tool declarations with the Python and checkpoint encoding behavior"，并指出对应 Python 修复为 PR#50228，本 PR 只覆盖 Rust renderer 行为。此前 Rust 渲染器将缺失的函数描述序列化为空字符串，且对所有 tool 都省略 strict 字段，这与 Python 侧行为及平台 token 化不一致，可能导致同一请求在双栈下产出不同提示词。

实现拆解

1. 变更入口：rust/src/chat/src/renderer/kimi_k3/encoding.rs 的 write_tool_declare 函数，负责把工具列表序列化为嵌入 system 消息的 JSON 声明。

2. 核心改造：

   • description 由 unwrap_or_default() 恒输出空字符串，改为仅当 tool.description 为 Some 时才插入；
   • strict 由从不输出改为当 tool.strict 为 Some(bool) 时插入 Value::Bool(strict)，从而保证 strict: false 也能被保留，缺省时才省略；
   • parameters 沿用 sort_json 处理且不清理 JSON 内部的 null，用户写入的 "default": null、["integer", "null"] 等 schema 内容得以原样保留。

3. 测试配套：tests.rs 新增三个测试，覆盖缺失可选字段时省略、显式可选字段保留、malformed 参数按 raw-text 渲染三个行为；dynamic_system_tool_declare_input.json 增加 strict: true、strict: false 及嵌套 default: null 的 schema，dynamic_system_tool_declare_output.txt 同步更新为新的期望输出。

4. 验证方式：按 Test Plan 执行 cargo fmt、cargo clippy -D warnings、cargo test -p vllm-chat renderer::kimi_k3::tests --lib，17 个 K3 渲染器测试全部通过。

5. 影响范围：仅影响 Rust chat renderer 的 K3 tool 声明输出，不触及推理内核、Python 前端或其他模型渲染路径。

rust/src/chat/src/renderer/kimi_k3/encoding.rs

核心渲染逻辑所在文件，write_tool_declare 的 description/strict 序列化策略是本 PR 的行为变更点。

rust/src/chat/src/renderer/kimi_k3/tests.rs

新增三个回归测试，锁定缺失字段省略、显式字段保留和 malformed 参数 raw-text 回退行为，是本 PR 的质量保障核心。

关键源码片段

rust/src/chat/src/renderer/kimi_k3/encoding.rs

核心渲染逻辑所在文件，write_tool_declare 的 description/strict 序列化策略是本 PR 的行为变更点。

// 生成 tool 声明段：description / strict 仅在显式提供时输出，
// 与 Python 侧 encoding_k3.py 及 checkpoint 编码保持一致。
fn write_tool_declare(
    out: &mut K3TokenWriter<'_>,
    tools: &[ChatTool],
    dynamic: bool,
) -> Result<()> {
    let mut specs = Vec::with_capacity(tools.len());
    for tool in tools {
        let mut function = Map::new();
        // description 缺省时不再输出空字符串，避免与平台行为不一致
        if let Some(description) = &tool.description {
            function.insert(
                "description".to_string(),
                Value::String(description.clone()),
            );
        }
        function.insert("name".to_string(), Value::String(tool.name.clone()));
        // parameters 整体 Json 值原样保留，包括用户写入的 null 默认值
        function.insert("parameters".to_string(), sort_json(&tool.parameters));
        // strict 显式提供时保留布尔值（包括 false），缺省则省略该字段
        if let Some(strict) = tool.strict {
            function.insert("strict".to_string(), Value::Bool(strict));
        }
        specs.push(json!({
            "function": Value::Object(function),
            "type": "function",
        }));
    }
    // 以 compact_json 序列化为单行 JSON，嵌入 system 消息体
    let payload = compact_json(&sort_json(&Value::Array(specs)))?;
​
    let body = if dynamic {
        format!(
            "## New Tools Available\n\
             The system dynamically extends the toolset via lazy-loading.\n\
             You have access to all existing and extended tools.\n\
             Here are the specs for the extended tools.
​
\
             ```json\n\
             {payload}\n\
             ```"
        )
    } else {
        format!(
            "# Tools\n\
             Here are the available tools, described in JSONSchema.
​
\
             ```json\n\
             {payload}\n\
             ```"
        )
    };
​
    // 以内部 system 消息形式写入 token 流
    write_internal_system(out, "tool-declare", &body)
}

评论区精华

本 PR 没有实质性的 review 讨论线程：

• zhewenl 批准并仅评论 "LGTM"；
• Isotr0py 直接批准，未留评论；
• claude[bot] 仅输出仓库配置提示，无技术内容。

由于语义已在 PR#50228 中确立，本 PR 属于明确的对齐修复，评审没有产生争议或未解决疑虑。

风险与影响

1. 行为变更风险：对缺失 description 的 tool，prompt 中不再出现 "description":""；对显式设置 strict 的 tool 会新增对应字段。这会使 Rust 渲染出的提示词与旧版本不同，可能影响依赖旧格式的回归基准、日志记录或基于提示词内容的缓存命中。
2. 双栈漂移风险：Rust 与 Python 渲染逻辑仍各自独立实现，本 PR 只对齐当前已知差异，后续 Python 侧若再次调整（如 #50228 之后的迭代），Rust 侧仍可能重新漂移，当前缺少跨栈 golden 对比测试来兜底。
3. 测试覆盖层面：新增单测和 fixture 已锁定三个关键行为，但未对消息级 tool（developer 消息内 tools）单独做 Rust 侧断言，该场景目前只通过 fixture 间接覆盖。
4. 安全风险：无，变更仅涉及提示词文本序列化。

影响范围方面：使用 Kimi K3 模型并通过 Rust 前端发起 tool-calling 请求的用户会观察到提示词中 tool 声明的变化，更加贴近 Python 平台行为；系统层面仅涉及 rust/src/chat 模块，对推理性能无影响；团队层面需要意识到双栈一致性的长期维护成本。

关联脉络

本 PR 的直接上游是 PR#50228（Python 侧同问题修复），二者共同构成 Kimi K3 tool 声明行为对齐的完整方案。#50228 中还提及早期前端支持 PR#50093，说明这是一条逐层补全的功能线。同仓库近期的 PR#50886、#50656 等展示 Kimi K3 支持正从推理内核（reasoning 判定、共享专家分片）持续扩展到前端渲染一致性，本 PR 是该演进方向上的一环，建议后续将 Python/Rust 两侧的渲染语义沉淀为共享契约或跨栈 golden 测试，防止再次漂移。