已合并
[Doc] 量化算法、PTQ对应资料内容整体整改 #972
wanlongze123创建于 3 天前
[Doc] 量化算法、PTQ对应资料内容整体整改 #972
已合并
Pull Request已成功合入, 合并人@ascend-robot
(感谢 wanlongze123 的贡献)3 天前 创建了 pull request,commit 2ac73702
atomgit-bot
3 天前 评论:
3 天前 评论:
变更摘要
本 PR 为纯文档整改,旨在规范化 docs/zh/knowledge_base/ptq 与 docs/zh/knowledge_base/quantization_algorithms 两个知识库目录的资料:使术语词条聚焦通用量化特性(剥离 modelslim 特有内容)、让 PTQ 与量化算法使用指南形成「模型适配 → 校准集 → 保存格式 → 算法 → runner → 量化命令」的完整可操作路径、精简接入指南并聚焦接口职责,同时统一校准集推荐数量、删除不合规的 W4A16 相关内容并修正格式问题。整个变更不涉及 CLI、API、YAML 等接口,无行为变更。
主要改动
- PTQ 词条去私有化重构:
ptq目录下 PTQ、LLM、VLM、DiT、权重转换等 term 词条剥离 modelslim 特有内容(逐层量化、runner 等),按词条模板组织,删减量化特点篇幅并重点突出 LLM/VLM/DiT 三类模型的量化特点。 - PTQ 使用指南流程重写:
usage_large_language_model_quantization.md等 usage 文档去掉流程总览与操作步骤旧结构,统一按步骤 1-6(模型适配 V1 interface → 选择校准集 → 选择保存格式 → 选择算法 → runner → 量化命令)重写,补充静态/动态量化 yaml 与 W8A8 完整示例配置及命令行,校准集统一为推荐 50 条。 - PTQ 接入指南精简并去重:LLM/VLM/DiT 三篇 integration_guide 精简大段代码展示,聚焦接口含义与输入输出说明,补充 DeepSeek、Kimi 等实际模型量化案例的跳转链接;V1 Interface 介绍收敛至接入指南,使用指南改为链接引用以避免重复。
- 量化算法词条整改:
quantization_algorithms下 33 个算法目录的 term 词条统一去私有化表述、校准集推荐 50 条,删除 W4A16 相关内容,清理 AI 味提示词,并修正标题层级与标点格式。 - 量化算法使用指南补齐模型适配阶段:usage 文档在流程开头新增「模型适配」阶段,覆盖
msmodelslim/msmodelslim/model/interface_hub.py涉及的适配接口(先适配、后算法),文末统一新增「更多量化信息」跳转链接至权重量化使用指南(usage_weight_quantization.md),整体格式对齐usage_quarot.md。


不准确?
AtlasAccount
3 天前 评论:
3 天前 评论:
atomgit-bot
3 天前 评论:
3 天前 评论:
🤖 本次改动均为数据 / 生成 / 二进制文件(如测试用例、锁文件、媒体资源),没有可审查的代码逻辑,已跳过 AI 代码审查。


不准确?
3 天前 添加了label:stat/needs-squash
此处折叠了122条消息 查看更多
keith_wa
2 天前 评论:
2 天前 评论:
/lgtm
/approve


2 天前 添加了label:approvedlgtm
2 天前 关闭了关联的issue
2 天前 合入了pull request
ascend-robot
2 天前 评论:
2 天前 评论:
Pull Request 已合并或已关闭。
If you want to solve this problem, you can click here to do it in the FAQs.


PR 描述
PR 标题: [Doc] 规范化PTQ与量化算法知识库文档(词条去私有化、使用指南流程重构、接入指南精简、格式整改、旧接入文档移除重定向)并补全权重转换 CLI/YAML/多卡说明
涉及提交:
08cb03a3[Doc] 规范化PTQ与量化算法知识库文档:词条去私有化、使用指南流程重构与格式整改、旧接入文档移除重定向、产品系列名称规范化,并补全权重转换 CLI/YAML/多卡说明(110 个文件,+4286/-5918)提交前请阅读 贡献指南,开发者文档:PTQ 接入指南
PR 标题前缀:[Feature]、[Bugfix]、[Doc]、[Test](与 CONTRIBUTING 一致)
1. 影响面评估
接口变更(按需): 无
输出件变更(按需): 无
非兼容变更(按需): 无
SIG 评审结论(按需): 无
2. 修改描述
修改背景(可选):
知识库
docs/zh/knowledge_base/ptq与docs/zh/knowledge_base/quantization_algorithms两个目录的资料经测试反馈存在以下问题:msmodelslim/model/interface_hub.py相关接口),且缺少指向 user guide 的更多信息跳转链接;knowledge_base/model目录下三个旧接入文档(integrating_models.md、integrating_multimodal_generation_model.md、integrating_multimodal_understanding_model.md)与新 ptq 接入指南内容重复且已废弃,需移除并重定向全库引用;modelslim_convert配置协议说明不完整,缺少 CLI 命令、YAML 配置与多卡执行等关键说明;知识库部分 README 与实际目录结构不一致。修改目的:
规范化 PTQ 与量化算法知识库文档,使术语词条聚焦通用量化特性、使用指南形成「适配 → 校准集 → 保存格式 → 算法 → runner → 量化命令」的完整可操作路径、接入指南聚焦接口职责并串联实际案例,统一文档格式规范,移除废弃旧接入文档并统一引用入口至 ptq 接入指南,补全权重转换 CLI/YAML/多卡资料并纠正知识库结构,提升资料准确性、一致性与易用性。
修改内容:
usage_large_language_model_quantization.md等 usage 文档去掉流程总览与操作步骤旧结构,统一按步骤 1-6(模型适配 V1 interface → 选择校准集 → 选择保存格式 → 选择算法 → runner → 量化命令)重写,补充静态量化/动态量化 yaml 与 W8A8 完整示例配置及命令行;校准集统一为推荐 50 条。quantization_algorithms下 33 个算法目录的 term 词条去私有化表述,统一校准集推荐 50 条,删除 W4A16 相关内容,清理 AI 味提示词,修正标题与标点格式。msmodelslim/msmodelslim/model/interface_hub.py涉及的适配接口(先适配、后算法);文末统一新增「更多量化信息」跳转链接至 权重量化使用指南;整体格式参考usage_quarot.md对齐。---分隔;usage/integration_guide 删除步骤间多余分隔线;使用指南新增流程总览图并优化流程图长节点换行(涉及 ptq、quantization_algorithms 等 47 个文件)。knowledge_base/model目录下三个旧接入文档(integrating_models.md、integrating_multimodal_generation_model.md、integrating_multimodal_understanding_model.md),best_practices、user_guide、knowledge_base、mkdocs.yml 等全库引用统一重定向至 ptq 目录下对应接入指南(llm/vlm/dit 三类 integration_guide),消除死链与内容重复(23 个文件)。msmodelslim quantCLI 文档补全权重转换命令说明;modelslim_convert配置协议说明补充 YAML 配置与多卡执行等字段说明;纠正 knowledge_base 及 parallel 目录 README 与实际结构不一致问题。概念域参考:
3. 功能验证
本 PR 为纯文档变更,不涉及代码路径,冒烟由 CI 门禁检查。
复现步骤(可选):
# 查看本 PR 全部改动(也可直接查看分支整体 diff:git diff upstream/master..ziliao_fix_wlz -- docs/ skills/ example/) git diff 08cb03a3^..08cb03a3 -- docs/zh mkdocs.yml skills example # 本地预览(可选) # 使用任意 Markdown 渲染工具查看上述文档渲染效果4. 自检(请逐项确认,不适用标 N/A)
典型安全编码问题
DT