| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
【docs】补充伪量化推理资料 Co-authored-by: zhangz200102<zhangzheng183@huawei.com> # message auto-generated for no-merge-commit merge: !978 merge docs/for_fake_quant into master 【docs】补充伪量化推理资料 Created-by: zhangz200102 Commit-by: zhangz200102 Merged-by: ascend-robot Description: # PR 提交说明 提交前请阅读 [贡献指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](../docs/zh/knowledge_base/model/integrating_models.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及 CLI、API、YAML 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：**（问题现象、使用场景等） 详见关联issue：https://gitcode.com/Ascend/msmodelslim/issues/549 **修改目的：**（本 PR 要达成什么目标） 补充伪量化推理相关资料 **修改内容：**（按「概念 - 变化」分条，示例：core/算法：新增 SmoothQuant 离群值抑制） docs：补充伪量化推理相关资料 **概念域参考（填写提示）：** - cli：命令行 quant / analyze / tune - app：最佳实践量化、量化分析、精度反馈自动调优等 - core：算法、量化服务、调度、张量量化、调优策略、最佳实践、上下文等 - infra：模型适配、调优计划/历史/缓存、测评服务等 - utils：日志、错误处理、插件等 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验  - [x] 本地自验用例截图（请勿包含个人信息；可附复现命令） 仅资料，不涉及 **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 N/A - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） 仅资料，不涉及 - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） 仅资料，不涉及 See merge request: Ascend/msmodelslim!978 | 1 个月前 | |
【master】【docs】：aidd新增低错问题修改 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !986 merge master into master 【master】【docs】：aidd新增低错问题修改 Created-by: zzm30 Commit-by: zzm30 Merged-by: ascend-robot Description: # PR 提交说明 提交前请阅读 [CONTRIBUTING.md](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](../docs/zh/development_guide/integrating_models.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及 CLI、API、YAML 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** aidd新增低错问题修改； **修改目的：** aidd新增低错问题修改; **修改内容：** 1. aidd新增低错问题修改。 **概念域参考（填写提示）：** - cli：命令行 quant / analyze / tune - app：最佳实践量化、量化分析、精度反馈自动调优等 - core：算法、量化服务、调度、张量量化、调优策略、最佳实践、上下文等 - infra：模型适配、调优计划/历史/缓存、测评服务等 - utils：日志、错误处理、插件等 ## 3. 功能验证 - [x] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 - [x] 是否充分考虑浮点运算溢出、除零等异常场景 - [x] 是否已对正则表达式做 ReDos 检查 **DT** - [x] 是否具备 UT 测试用例看护 资料修改 - [ ] 是否需要添加冒烟：否 See merge request: Ascend/msmodelslim!986 | 1 个月前 | |
[Doc] 量化算法、PTQ对应资料内容整体整改 Co-authored-by: qq_46439621<wanlongze1@huawei.com> # message auto-generated for no-merge-commit merge: !972 merge ziliao_fix_0914 into master [Doc] 量化算法、PTQ对应资料内容整体整改 Created-by: qq_46439621 Commit-by: qq_46439621 Merged-by: ascend-robot Description: # PR 描述 **PR 标题：** [Doc] 规范化PTQ与量化算法知识库文档（词条去私有化、使用指南流程重构、接入指南精简、格式整改、旧接入文档移除重定向）并补全权重转换 CLI/YAML/多卡说明 **涉及提交：** - 08cb03a3 [Doc] 规范化PTQ与量化算法知识库文档：词条去私有化、使用指南流程重构与格式整改、旧接入文档移除重定向、产品系列名称规范化，并补全权重转换 CLI/YAML/多卡说明（110 个文件，+4286/-5918） 提交前请阅读 [贡献指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[PTQ 接入指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/knowledge_base/ptq/README.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：本 PR 为纯文档变更，不涉及 CLI、API、YAML 等接口。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 > 备注：仅知识库文档内容整改，无行为变更，无需迁移。 **SIG 评审结论（按需）：** 无 > 说明：非兼容、安全风险等高危项均不涉及。 ## 2. 修改描述 **修改背景（可选）：** 知识库 docs/zh/knowledge_base/ptq 与 docs/zh/knowledge_base/quantization_algorithms 两个目录的资料经测试反馈存在以下问题： 1. 词条（term）文件掺杂 modelslim 特有特性（逐层量化、runner 等），不符合「词条讲述通用量化特性」的定位，且未按[词条模板](docs/zh/contributing/development_guide/docs_standards/01_term_glossary_template.md)组织； 2. 校准集数量表述不统一，需统一为推荐 50 条；W4A16 相关内容按规范不应体现；部分文档残留明显 AI 味提示词； 3. PTQ 使用指南流程总览与操作步骤结构冗余，缺少可直达的操作路径； 4. 量化算法使用指南（usage）整体流程不完整，缺少前置的「模型适配」阶段（未体现 msmodelslim/model/interface_hub.py 相关接口），且缺少指向 user guide 的更多信息跳转链接； 5. 格式低错：标题层级、标点符号，term 词条章节分隔方式不统一，usage/integration_guide 步骤间残留多余分隔线，流程图长节点未换行、缺少流程总览图； 6. knowledge_base/model 目录下三个旧接入文档（integrating_models.md、integrating_multimodal_generation_model.md、integrating_multimodal_understanding_model.md）与新 ptq 接入指南内容重复且已废弃，需移除并重定向全库引用； 7. 权重转换 CLI 命令文档与 modelslim_convert 配置协议说明不完整，缺少 CLI 命令、YAML 配置与多卡执行等关键说明；知识库部分 README 与实际目录结构不一致。 **修改目的：** 规范化 PTQ 与量化算法知识库文档，使术语词条聚焦通用量化特性、使用指南形成「适配 → 校准集 → 保存格式 → 算法 → runner → 量化命令」的完整可操作路径、接入指南聚焦接口职责并串联实际案例，统一文档格式规范，移除废弃旧接入文档并统一引用入口至 ptq 接入指南，补全权重转换 CLI/YAML/多卡资料并纠正知识库结构，提升资料准确性、一致性与易用性。 **修改内容：** - **docs / PTQ 词条**：PTQ、LLM、VLM、DiT、权重转换等 term 词条剥离 modelslim 特有内容（逐层量化、runner 等），按词条模板重构，删减量化特点篇幅，重点突出 LLM/VLM/DiT 三类模型的量化特点。 - **docs / PTQ 使用指南**：usage_large_language_model_quantization.md 等 usage 文档去掉流程总览与操作步骤旧结构，统一按步骤 1-6（模型适配 V1 interface → 选择校准集 → 选择保存格式 → 选择算法 → runner → 量化命令）重写，补充静态量化/动态量化 yaml 与 W8A8 完整示例配置及命令行；校准集统一为推荐 50 条。 - **docs / PTQ 接入指南**：LLM/VLM/DiT 三篇 integration_guide 精简大段代码展示，聚焦接口含义与输入输出说明，补充 DeepSeek、Kimi 等实际模型量化案例的跳转链接，并与使用指南去重（V1 Interface 介绍收敛至接入指南，使用指南以链接引用）。 - **docs / 量化算法词条**：quantization_algorithms 下 33 个算法目录的 term 词条去私有化表述，统一校准集推荐 50 条，删除 W4A16 相关内容，清理 AI 味提示词，修正标题与标点格式。 - **docs / 量化算法使用指南**：usage 文档在流程开头新增「模型适配」阶段，覆盖 msmodelslim/msmodelslim/model/interface_hub.py 涉及的适配接口（先适配、后算法）；文末统一新增「更多量化信息」跳转链接至 [权重量化使用指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/user_guide/usage_weight_quantization.md)；整体格式参考 usage_quarot.md 对齐。 - **docs / 格式整改**：知识库 term 词条章节统一以 --- 分隔；usage/integration_guide 删除步骤间多余分隔线；使用指南新增流程总览图并优化流程图长节点换行（涉及 ptq、quantization_algorithms 等 47 个文件）。 - **docs / 旧接入文档移除重定向**：移除 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 个文件）。 - **docs / 权重转换资料补全**：msmodelslim quant CLI 文档补全权重转换命令说明；modelslim_convert 配置协议说明补充 YAML 配置与多卡执行等字段说明；纠正 knowledge_base 及 parallel 目录 README 与实际结构不一致问题。 - **docs / 流程总览与死链收尾**：llm/vlm/dit 三篇 usage 流程总览「前置条件：模型适配」改为独立文字段落，阶段列表与流程图节点对齐；修复 skills、example 中引用已删除文档的残留死链；Wan2.2 W4A4F4 案例产品系列名称规范化（昇腾950PR&950DT → Ascend 950PR&950DT）。 **概念域参考：** - core：量化算法词条与使用指南（33 个算法的 term/usage） - infra：模型适配（interface_hub 接口）相关文档、PTQ 使用/接入指南 ## 3. 功能验证 本 PR 为纯文档变更，不涉及代码路径，冒烟由 CI 门禁检查。 - [x] 功能自验（文档本地渲染预览、文内互链与外链可达性人工检查、与源码 interface_hub.py 接口一致性核对） - [ ] 本地自验用例截图：N/A（纯文档变更，无运行时输出） **复现步骤（可选）：** bash # 查看本 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） **典型安全编码问题** - [ ] 是否已校验外部数据：N/A（纯文档变更，无代码） - [ ] 是否未采集或打印敏感信息：N/A（纯文档变更，无代码；文档内容不含密钥等敏感信息，gitleaks 扫描因本机缺少二进制跳过，已人工核对无敏感信息） - [ ] 是否已正确设置文件权限：N/A（纯文档变更） - [ ] 是否充分考虑浮点运算溢出、除零等异常场景：N/A（纯文档变更） - [ ] 是否已对正则表达式做 ReDos 检查：N/A（纯文档变更） **DT** - [ ] 是否具备 UT 测试用例看护：N/A（纯文档变更，不涉及代码逻辑，无新增/变更用例路径） - [ ] 是否需要添加冒烟：否（纯文档变更，无功能场景） See merge request: Ascend/msmodelslim!972 | 1 个月前 | |
【docs】: 产品系列名称规范化，昇腾系列名称替换为Atlas/Ascend目标名称 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !963 merge docs/series-name-rename into master 【docs】: 产品系列名称规范化，昇腾系列名称替换为Atlas/Ascend目标名称 Created-by: zzm30 Commit-by: zzm30 Merged-by: ascend-robot Description: # PR 提交说明 提交前请阅读 [CONTRIBUTING.md](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](../docs/zh/development_guide/integrating_models.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及 CLI、API、YAML 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** 最新要求已下达，昇腾系列名称替换为Atlas/Ascend目标名称； **修改目的：** 产品系列名称规范化； **修改内容：** 1. 产品系列名称规范化，昇腾系列名称替换为Atlas/Ascend目标名称。 **概念域参考（填写提示）：** - cli：命令行 quant / analyze / tune - app：最佳实践量化、量化分析、精度反馈自动调优等 - core：算法、量化服务、调度、张量量化、调优策略、最佳实践、上下文等 - infra：模型适配、调优计划/历史/缓存、测评服务等 - utils：日志、错误处理、插件等 ## 3. 功能验证 - [x] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 - [x] 是否充分考虑浮点运算溢出、除零等异常场景 - [x] 是否已对正则表达式做 ReDos 检查 **DT** - [x] 是否具备 UT 测试用例看护 资料修改 - [ ] 是否需要添加冒烟：否 See merge request: Ascend/msmodelslim!963 | 1 个月前 | |
[master][Docs] 修复量化基础/量化模式资料问题并补充多模态校准模态支持说明（issue #544 #526 #535） Co-authored-by: tanxiangyuu<tanxiangyu2@huawei.com> # message auto-generated for no-merge-commit merge: !981 merge fix-issues into master [master][Docs] 修复量化基础/量化模式资料问题并补充多模态校准模态支持说明（issue #544 #526 #535） Created-by: tanxiangyuu Commit-by: tanxiangyuu Merged-by: ascend-robot Description: # PR 提交说明 提交前请阅读 [贡献指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](../docs/zh/knowledge_base/model/integrating_models.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及 CLI、API、YAML 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** 修复 GitCode issue #544、#526、#535 的文档资料问题：量化基础/量化模式资料存在 8 处表述问题；多模态模型（Qwen3-Omni / Qwen3.5）缺失校准「模态支持情况」说明；全模态模型量化支持非全模态校准集的资料存在 5 处问题。 **修改目的：** 修正量化基础/量化模式资料表述；补齐多模态校准模态支持（支持组合、同质约束、visit/forward 差异）说明；补充全模态/非全模态模型校准集支持区别，使资料与代码语义一致。 **修改内容：** - docs/知识库-量化基础：修正 term_fp16_bf16.md 引号、term_fa_mxfp4_dynamic.md 粒度与 head_dim 描述、term_fa_q_fp8_dynamic_kv_fp8.md FP8(E4M3) 上限 448、term_float_sparse.md 码本描述、term_svdquant.md 阶段二换行，统一 6 个线性层词条「INT4 有符号」表述，修复 term_mxfp.md 错字（issue #544） - docs/知识库-量化模式：模式索引/模式清单降级为词条介绍子章节，关联链接直达 #modes 锚点（issue #544）；同步 26.2.0 补充修改——统一 kv_cache_quantization / linear_layer_quantization README「模式索引」表述，合并 term_w8a8_fp8_dynamic.md 重复的 FP8(E4M3) 448 上限说明 - docs/example：Qwen3-Omni / Qwen3.5 README 新增「校准模态支持」专节——支持模态组合、同任务内同质约束（含 video 是否带音轨）、有效音频判定、visit（data-free）/ forward（calibration）路径差异（issue #526） - docs/一键量化：VLM 适用模型类型补充 Qwen3-Omni / Qwen3.5·Qwen3.6，新增同质校准、模态同质性说明，index.jsonl 示例改为同质图文与纯文本示例（issue #526） - docs/索引与支持矩阵：VLM 模型索引、知识库模型 README 补充校准模态交叉引用（issue #526） - docs/PTQ-VLM 使用指南：步骤 2「校准集选择指南与推荐配置」补充全模态/非全模态模型校准集支持区别（issue #535） **概念域参考（填写提示）：** - docs：纯文档变更，不涉及 cli / app / core / infra / utils 代码逻辑 ## 3. 功能验证 - [x] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** 纯文档变更，无代码逻辑；本地 markdownlint 校验 0 issues，MR docs 门禁（markdownlint / link-validity / resource-existence / tag-closed）已通过。 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 —— N/A（纯文档变更，无外部数据输入） - [x] 是否未采集或打印敏感信息 —— 是 - [x] 是否已正确设置文件权限 —— N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 —— N/A - [x] 是否已对正则表达式做 ReDos 检查 —— N/A（无正则匹配外部输入） **DT** - [x] 是否具备 UT 测试用例看护 —— N/A（纯文档变更，无代码逻辑） - [ ] 是否需要添加冒烟：否 See merge request: Ascend/msmodelslim!981 | 1 个月前 | |
【master】【docs】：aidd新增低错问题修改 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !986 merge master into master 【master】【docs】：aidd新增低错问题修改 Created-by: zzm30 Commit-by: zzm30 Merged-by: ascend-robot Description: # PR 提交说明 提交前请阅读 [CONTRIBUTING.md](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](../docs/zh/development_guide/integrating_models.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及 CLI、API、YAML 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** aidd新增低错问题修改； **修改目的：** aidd新增低错问题修改; **修改内容：** 1. aidd新增低错问题修改。 **概念域参考（填写提示）：** - cli：命令行 quant / analyze / tune - app：最佳实践量化、量化分析、精度反馈自动调优等 - core：算法、量化服务、调度、张量量化、调优策略、最佳实践、上下文等 - infra：模型适配、调优计划/历史/缓存、测评服务等 - utils：日志、错误处理、插件等 ## 3. 功能验证 - [x] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 - [x] 是否充分考虑浮点运算溢出、除零等异常场景 - [x] 是否已对正则表达式做 ReDos 检查 **DT** - [x] 是否具备 UT 测试用例看护 资料修改 - [ ] 是否需要添加冒烟：否 See merge request: Ascend/msmodelslim!986 | 1 个月前 | |
[Doc] 快速入门资料按测试意见整改 Co-authored-by: zwling<906711886@qq.com> # message auto-generated for no-merge-commit merge: !944 merge fix/quick-start-doc-review into master [Doc] 快速入门资料按测试意见整改 Created-by: zwling Commit-by: zwling Merged-by: ascend-robot Description: # PR 提交说明 提交前请阅读 [贡献指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](../docs/zh/knowledge_base/model/integrating_models.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及 CLI、API、YAML 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：**（问题现象、使用场景等） 见issue https://gitcode.com/Ascend/msmodelslim/issues/522 **修改目的：**（本 PR 要达成什么目标） 快速入门资料整改 **修改内容：**（按「概念 - 变化」分条，示例：core/算法：新增 SmoothQuant 离群值抑制） 修改快速入门资料 （在此填写） **概念域参考（填写提示）：** - cli：命令行 quant / analyze / tune - app：最佳实践量化、量化分析、精度反馈自动调优等 - core：算法、量化服务、调度、张量量化、调优策略、最佳实践、上下文等 - infra：模型适配、调优计划/历史/缓存、测评服务等 - utils：日志、错误处理、插件等 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 - [x] 是否充分考虑浮点运算溢出、除零等异常场景 - [x] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [ ] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!944 | 1 个月前 | |
[Doc] FAQ 资料规范整改、文档链接修复与版本说明导航清理 Co-authored-by: LeeQT<liqitong@huawei.com> # message auto-generated for no-merge-commit merge: !967 merge docs-release-notes-faq into master [Doc] FAQ 资料规范整改、文档链接修复与版本说明导航清理 Created-by: LeeQT Commit-by: LeeQT Merged-by: ascend-robot Description: 提交前请阅读 [贡献指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/knowledge_base/model/integrating_models.md) ## 1. 影响面评估 **接口变更（按需）：** 无 **输出件变更（按需）：** 无 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景（可选）：** - FAQ 各篇标题编号不符合《公共校验清单》CE-13 的要求：二级标题误用 x.x、三级标题完全无序号。 - 硬件兼容篇在 FAQ 条目下架后，残留的引言文案沿用了「精度与调优」的表述，与主题不符。 - README 存在失效链接（msagent 文档大小写不符导致 404）与标点缺失。 - 上游 3d342f33 删除了 docs/zh/release_notes/release_notes.md，但 mkdocs.yml 的导航条目仍指向该文件，形成悬空引用。 **修改目的：** 使 FAQ 资料满足《msModelSlim 资料规范》，修复文档失效链接，清理悬空导航引用。 **修改内容：** - docs/support/faq*：按 CE-13 补齐标题编号——二级标题由 x.x 改为 x，三级标题补 x.x，同级序号连续；同步修正 4 篇引言与 2 篇预留分类中「新增条目按 1.x 顺序追加」的指引文字。 - docs/support/faq.md：修订记录由 3 条（v2.1/v2.0/v1.0）合并为 v1.0 单行，并按时间升序记录；分类索引中「硬件兼容」一行改为预留分类描述；frontmatter keywords 调整。 - docs/support/faq_hardware.md：FAQ 条目下架，参照预留分类样式补全——修正原引言误用「精度与调优」文案的问题，补充硬件兼容相关指引文档链接与新增条目约定。 - docs/support/faq_installation.md：将「操作系统版本，或通过以下命令规避」拆为「升级操作系统版本」「通过以下命令规避」两条独立的解决方法。 - docs/support/faq_warning.md：新增条目约定补充「关联文档（可选）」，匹配后续条目结构。 - README：最新消息 改指 GitCode Releases「发行版说明」页面；量化收益描述补齐「W8A8 量化后」；快速开始 行补句末句号；修正「AI 智能体（msagent）」文档链接大小写（Quantizer.md → quantizer.md，原链接 404）。 - mkdocs.yml：移除「九、附录」中指向已删除文件的「版本说明」导航条目。 **备注（合并冲突处理）：** 本分支曾重写 docs/zh/release_notes/release_notes.md，与上游 3d342f33 的删除操作构成 modify/delete 冲突。经确认接受上游删除，本分支的版本说明重写不再合入；同时补齐上游遗漏的 mkdocs.yml 悬空引用清理。当前分支已合并 center/master（3d342f33），无冲突。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验 - [ ] 本地自验用例截图（N/A：本 PR 为纯文档变更，无界面可截图；校验以脚本方式进行，见下） **复现步骤（可选）：** bash cd <repo_root> # 1) 标题编号校验（CE-13）：一级标题不带序号，二级须为 x，三级须为 x.x，同级连续 grep -nE '^#{1,3} ' docs/zh/support/faq*.md # 2) 篇内相对链接可达性校验：列出所有 ](../xxx.md) 链接并确认目标文件存在 grep -ohE '\]\(\.\.?/[^)#]+\)' docs/zh/support/faq*.md | tr -d ']()' | sort -u | while read -r p; do [ -e "docs/zh/support/$p" ] && echo "OK $p" || echo "BROKEN $p" done # 3) 确认 docs 内已无指向已删除 release_notes.md 的链接 grep -rn 'release_notes/release_notes\.md' docs/ mkdocs.yml || echo "无悬空引用" 本地校验结果：docs/zh/support/ 下 7 篇 FAQ 全部满足 CE-13；篇内 15 处相对链接全部可解析到仓库内实际文件；代码围栏均标注语言（CE-11）；docs/ 与 mkdocs.yml 中已无指向已删除文件的引用。 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 - [x] 是否充分考虑浮点运算溢出、除零等异常场景 - [x] 是否已对正则表达式做 ReDos 检查 **DT** - [x] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） --- 🤖 Generated with [Claude Code](https://claude.com/claude-code) See merge request: Ascend/msmodelslim!967 | 1 个月前 | |
[master][Docs] 修复量化基础/量化模式资料问题并补充多模态校准模态支持说明（issue #544 #526 #535） Co-authored-by: tanxiangyuu<tanxiangyu2@huawei.com> # message auto-generated for no-merge-commit merge: !981 merge fix-issues into master [master][Docs] 修复量化基础/量化模式资料问题并补充多模态校准模态支持说明（issue #544 #526 #535） Created-by: tanxiangyuu Commit-by: tanxiangyuu Merged-by: ascend-robot Description: # PR 提交说明 提交前请阅读 [贡献指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[模型接入指南](../docs/zh/knowledge_base/model/integrating_models.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及 CLI、API、YAML 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** 修复 GitCode issue #544、#526、#535 的文档资料问题：量化基础/量化模式资料存在 8 处表述问题；多模态模型（Qwen3-Omni / Qwen3.5）缺失校准「模态支持情况」说明；全模态模型量化支持非全模态校准集的资料存在 5 处问题。 **修改目的：** 修正量化基础/量化模式资料表述；补齐多模态校准模态支持（支持组合、同质约束、visit/forward 差异）说明；补充全模态/非全模态模型校准集支持区别，使资料与代码语义一致。 **修改内容：** - docs/知识库-量化基础：修正 term_fp16_bf16.md 引号、term_fa_mxfp4_dynamic.md 粒度与 head_dim 描述、term_fa_q_fp8_dynamic_kv_fp8.md FP8(E4M3) 上限 448、term_float_sparse.md 码本描述、term_svdquant.md 阶段二换行，统一 6 个线性层词条「INT4 有符号」表述，修复 term_mxfp.md 错字（issue #544） - docs/知识库-量化模式：模式索引/模式清单降级为词条介绍子章节，关联链接直达 #modes 锚点（issue #544）；同步 26.2.0 补充修改——统一 kv_cache_quantization / linear_layer_quantization README「模式索引」表述，合并 term_w8a8_fp8_dynamic.md 重复的 FP8(E4M3) 448 上限说明 - docs/example：Qwen3-Omni / Qwen3.5 README 新增「校准模态支持」专节——支持模态组合、同任务内同质约束（含 video 是否带音轨）、有效音频判定、visit（data-free）/ forward（calibration）路径差异（issue #526） - docs/一键量化：VLM 适用模型类型补充 Qwen3-Omni / Qwen3.5·Qwen3.6，新增同质校准、模态同质性说明，index.jsonl 示例改为同质图文与纯文本示例（issue #526） - docs/索引与支持矩阵：VLM 模型索引、知识库模型 README 补充校准模态交叉引用（issue #526） - docs/PTQ-VLM 使用指南：步骤 2「校准集选择指南与推荐配置」补充全模态/非全模态模型校准集支持区别（issue #535） **概念域参考（填写提示）：** - docs：纯文档变更，不涉及 cli / app / core / infra / utils 代码逻辑 ## 3. 功能验证 - [x] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** 纯文档变更，无代码逻辑；本地 markdownlint 校验 0 issues，MR docs 门禁（markdownlint / link-validity / resource-existence / tag-closed）已通过。 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 —— N/A（纯文档变更，无外部数据输入） - [x] 是否未采集或打印敏感信息 —— 是 - [x] 是否已正确设置文件权限 —— N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 —— N/A - [x] 是否已对正则表达式做 ReDos 检查 —— N/A（无正则匹配外部输入） **DT** - [x] 是否具备 UT 测试用例看护 —— N/A（纯文档变更，无代码逻辑） - [ ] 是否需要添加冒烟：否 See merge request: Ascend/msmodelslim!981 | 1 个月前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 | ||
| 1 个月前 |