PR 提交说明

提交前请阅读 贡献指南，开发者文档：模型接入指南

PR 标题前缀：[Doc]

1. 影响面评估

接口变更（按需）： 无

备注：纯文档改动，不涉及 CLI、API、YAML 等。

输出件变更（按需）： 无

备注：不涉及导出格式、产物路径等。

非兼容变更（按需）： 无

备注：文档结构重构，不涉及任何行为变更。

SIG 评审结论（按需）： 无

提醒：纯文档改动，无代码与非兼容变更，不涉及 SIG 评审。

2. 修改描述

修改背景（可选）： docs/zh/best_practices/qwen3_32b_w8a8_precision_tuning_case.md 为自由格式编写的案例文档，未遵循《通用案例模板》（docs/zh/contributing/development_guide/general_case_template.md），与新增案例文档（如 deepseek_v4_flash_w8a8_quick_quantization_case.md、deepseek_v4_pro_w4a8_new_llm_quantization_case.md）的结构不一致，案例评审口径不统一。

修改目的： 将本案例按通用案例模板重构，对齐案例编写规范，并通过《通用案例检查清单》（general_case_checklist.md）逐项校验。

修改内容：

• docs/案例：Qwen3-32B W8A8 精度调优案例重构为模板 7 节结构（案例背景 → 环境与版本 → 输入和交付件 → 操作步骤 → 结果与经验 → 异常处理 → 附录）
• docs/案例：操作步骤补齐「目标 / 输入 / 操作 / 输出 / 记录 / 下一步」六要素，关键命令与 YAML 配置以代码块给出，保证可执行可追溯
• docs/案例：新增「环境与版本」（产品形态、依赖及版本、本次前置事实）与「输入和交付件」（含验收方式）章节
• docs/案例：背景补充关联流程链接（《量化精度调优指南》），经验总结补充适用边界
• docs/案例：删除模板说明注释；案例实测数据（AIME25/GPQA 精度、量化时间）保持不变

概念域参考： 纯文档改动，不涉及 cli / app / core / infra / utils 代码域。

3. 功能验证

冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。

• 功能自验（文档类：模板结构校验与内容一致性比对，无运行行为）
• 本地自验用例截图（请勿包含个人信息；可附复现命令）——文档改动无运行截图，复现命令如下

复现步骤（可选）：

4. 自检（请逐项确认，不适用标 N/A）

典型安全编码问题（纯文档改动，无代码逻辑，逐项 N/A）

• N/A是否已校验外部数据 — N/A（无代码逻辑；文档未引入外部数据输入）
• N/A是否未采集或打印敏感信息 — N/A（无代码逻辑；文档未包含账号、密钥、内网地址等敏感信息）
• N/A是否已正确设置文件权限 — N/A（无代码逻辑）
• N/A是否充分考虑浮点运算溢出、除零等异常场景 — N/A（无代码逻辑）
• N/A是否已对正则表达式做 ReDos 检查 — N/A（无代码逻辑）

DT

• N/A 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因）— N/A（纯文档改动；案例文档由 general_case_checklist.md 校验条目看护）
• 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途）——文档类改动不涉及运行行为