| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
[master][Doc] 删除冗余一键量化完整指南 usage_quick_quantization.md,内容迁移至 usage_one_click_quantization 附录、配置文档与各使用指南 Co-authored-by: tanxiangyuu<tanxiangyu2@huawei.com> # message auto-generated for no-merge-commit merge: !997 merge codex/docs-quant-doc-carrier into master [master][Doc] 删除冗余一键量化完整指南 usage_quick_quantization.md,内容迁移至 usage_one_click_quantization 附录、配置文档与各使用指南 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 标题前缀:[Doc](与 CONTRIBUTING 一致) ## 1. 影响面评估 **接口变更(按需):** 无 > 备注:纯文档改动,不涉及 CLI、API、YAML 等接口变更。 **输出件变更(按需):** 无 > 备注:不涉及导出格式、产物路径等变更。 **非兼容变更(按需):** 无 > 备注:删除的 usage_quick_quantization.md 全部内容均已迁移至对应载体,无信息丢失。 **SIG 评审结论(按需):** 无 ## 2. 修改描述 **同步说明:** 本 PR 为 [master PR #997](https://gitcode.com/Ascend/msmodelslim/merge_requests/997) 的同步(cherry-pick 提交 7e807320),将「删除冗余一键量化完整指南并迁移内容」同步至 26.2.0 分支。 **修改背景(可选):** docs/zh/user_guide/ 下存在两篇一键量化文档(usage_quick_quantization.md《一键量化完整指南》与 usage_one_click_quantization.md《一键量化使用指南》),内容重叠冗余。为避免文档重复维护与入口混乱,删除冗余的《一键量化完整指南》;删除前逐节确认其全部内容在其他文档中均有载体(本次迁移 + 既有载体),并完成全部引用重映射。 **修改目的:** 统一一键量化文档入口为 usage_one_click_quantization.md;确保 usage_quick_quantization.md 删除后无任何内容丢失,且所有内容均有可追溯的承载文档链接。 **修改内容:**(按「概念 - 变化」分条) - docs/user_guide:删除 usage_quick_quantization.md;usage_one_click_quantization.md 末尾新增 ## 12. 附录 > ### 12.1 协议版本维护策略 - docs/api_reference/cli:msmodelslim_quant.md §4 参数关系新增「最佳实践匹配搜索优先级」1-6 - docs/api_reference/config/task:modelslim_v1.md §1 补充 modelslim_v1 相对 modelslim_v0 的三条优势 - docs/knowledge_base/parallel:README.md §3 新增 dp_layer_wise 算法名视角支持列表;data_parallelism_guide.md §10 补充校准集大小、算法支持说明 - docs/knowledge_base/ptq:LLM 量化指南 步骤5 补充调度器选型对照/适用场景/工作原理与优势对比/选型建议;VLM 量化指南 步骤2 后新增 <span id="dataset---校准数据路径配置"> 校准数据路径配置(参考) - example:multimodal_sd/Wan2_2/README.md 补充 3 个 wan2_2 yaml 链接、multimodal_vlm/Qwen3-VL-MoE/README.md 补充 qwen3_vl_moe_w8a8.yaml 链接 - 引用重映射:88 个文件指向 usage_quick_quantization.md 的链接(含锚点)全部重定向至新载体;导航入口(mkdocs.yml、docs/zh/user_guide/README.md、根 README.md)切换至 usage_one_click_quantization.md - 链接校验:改动覆盖的 92 个文件无新增 broken 链接 **概念域参考:** - cli:msmodelslim quant 命令格式 / 参数列表 / 使用示例 / 最佳实践匹配优先级 - app:一键量化使用指南(前置条件、操作步骤、交付件校验、协议版本维护策略) - core:runner / processor / save / dataset 配置详解,逐层量化与分布式逐层量化 - infra:lab_practice 最佳实践 YAML、示例仓库 README 相关资源 ### 被删文档内容承载映射(docs/zh/user_guide/usage_quick_quantization.md ) | 被删文档章节 | 内容承载位置 | 链接 | | --- | --- | --- | | §1 简介(一键量化概述、两种使用方式) | 一键量化使用指南 全文(入口统一);CLI §1 功能说明(quant_type/config 两种配置来源) | [usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md)、[msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §2 使用前准备(安装) | 安装指南;一键量化使用指南 §2 流程关系与前置条件 | [install_guide.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/install_guide/install_guide.md)、[usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §3.1 命令格式 | CLI §2 命令格式 | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.1 最佳实践搜索优先级 | CLI §4 参数关系「最佳实践匹配搜索优先级」1-6 | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.2 参数说明 | CLI §3 参数列表(原 #32-参数说明 引用已全部重映射至此) | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.3 使用示例(示例1/2/3) | CLI §7 使用示例(默认量化类型 / 自定义配置 / 多卡分布式) | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.4 输出说明 | 一键量化使用指南 §3 输入和交付件、§5 步骤7 校验交付件 | [usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §4.1.1 逐层量化简介 | 并行机制 README §1/§2 并行机制简述 | [parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md) | | §4.1.2 适用场景 | LLM 量化指南 步骤5 适用场景表 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md) | | §4.1.3 工作原理与优势对比 | LLM 量化指南 步骤5 工作原理与优势对比表 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md) | | §4.1.4 配置方法(runner / 单卡 / 多卡) | LLM 量化指南 步骤5 runner 配置;并行 README §4 多卡量化配置与使用;一键量化使用指南 步骤5/6 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md)、[parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md)、[usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §4.1.5 注意事项 | DP 指南 §10 产品形态与资源限制(校准集大小、算法支持);VLM 指南 步骤2 多模态 runner 支持说明 | [data_parallelism_guide.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/data_parallelism/data_parallelism_guide.md)、[usage_vision_transformer_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/vlm/usage_vision_transformer_quantization.md) | | §4.1.6 模型适配 | 并行 README §3 模型适配器支持列表;大模型支持矩阵 | [parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md)、[model/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/model/README.md) | | §4.1.7 算法适配 | 并行 README §3 dp_layer_wise 算法名视角支持列表 | [parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md) | | §5.1.1 量化配置协议基本结构 | modelslim_v1 / multimodal_vlm_modelslim_v1 / multimodal_sd_modelslim_v1 配置详解 | [modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/modelslim_v1.md)、[multimodal_vlm_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_vlm_modelslim_v1.md)、[multimodal_sd_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_sd_modelslim_v1.md) | | §5.1.2 协议版本说明 | 一键量化使用指南 §12 附录 12.1 协议版本维护策略 | [usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §5.2 modelslim_v1 配置详解(5.2.1-5.2.7) | modelslim_v1 配置详解全文(§1 功能说明补充 v0→v1 三条优势) | [modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/modelslim_v1.md) | | §5.3 multimodal_sd_modelslim_v1 配置详解(5.3.1-5.3.7) | multimodal_sd_modelslim_v1 配置详解全文;§5.3.7 使用示例 yaml → Wan2_2 示例 README 相关资源 | [multimodal_sd_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_sd_modelslim_v1.md)、[example/multimodal_sd/Wan2_2/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/example/multimodal_sd/Wan2_2/README.md) | | §5.4 multimodal_vlm_modelslim_v1 配置详解(5.4.1-5.4.7) | multimodal_vlm_modelslim_v1 配置详解全文;§5.4.6 dataset 校准数据路径配置 → VLM 指南新增锚点;§5.4.7 使用示例 yaml → Qwen3-VL-MoE 示例 README 相关资源 | [multimodal_vlm_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_vlm_modelslim_v1.md)、[usage_vision_transformer_quantization.md#dataset---校准数据路径配置](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/vlm/usage_vision_transformer_quantization.md)、[example/multimodal_vlm/Qwen3-VL-MoE/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/example/multimodal_vlm/Qwen3-VL-MoE/README.md) | | §5.5 modelslim_v0 配置说明 | 删除(v0 协议即将废弃,不推荐使用;策略见附录 12.1) | — | | §6.1 相关资料 | 量化算法 README(V1 架构支持算法);并行 README(逐层量化);示例 README 相关资源 | [quantization_algorithms/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/quantization_algorithms/README.md)、[parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md) | | §6.2 常见问题(Q1-Q5) | Q1-Q3 调度器选型/逐层量化判断 → LLM 指南 步骤5 选型建议;Q4 多卡加速 → DP 指南 §10;Q5 精度调优 → 量化精度调优指导 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md)、[data_parallelism_guide.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/data_parallelism/data_parallelism_guide.md)、[process_quantization_precision_tuning.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/process_quantization_precision_tuning.md) | ## 3. 功能验证 冒烟由 CI 门禁检查,无需填写「冒烟是否通过」。 - [x] 功能自验(纯文档改动:88 个文件引用重映射完成、全仓 git grep usage_quick_quantization 零残留、改动文件无新增 broken 链接) - [x] 本地自验用例截图(不适用:纯文档改动,N/A) **复现步骤(可选):** bash # 链接校验(仓库根目录) git grep -n "usage_quick_quantization" # 期望无输出 ## 4. 自检(请逐项确认,不适用标 N/A) **典型安全编码问题** - [ ] N/A 是否已校验外部数据:纯文档改动,无代码逻辑 - [ ] N/A 是否未采集或打印敏感信息:(纯文档改动,无代码逻辑) - [ ] N/A 是否已正确设置文件权限:(纯文档改动,无代码逻辑) - [ ] N/A 是否充分考虑浮点运算溢出、除零等异常场景:(纯 See merge request: Ascend/msmodelslim!997 | 7 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
[master][Doc] 删除冗余一键量化完整指南 usage_quick_quantization.md,内容迁移至 usage_one_click_quantization 附录、配置文档与各使用指南 Co-authored-by: tanxiangyuu<tanxiangyu2@huawei.com> # message auto-generated for no-merge-commit merge: !997 merge codex/docs-quant-doc-carrier into master [master][Doc] 删除冗余一键量化完整指南 usage_quick_quantization.md,内容迁移至 usage_one_click_quantization 附录、配置文档与各使用指南 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 标题前缀:[Doc](与 CONTRIBUTING 一致) ## 1. 影响面评估 **接口变更(按需):** 无 > 备注:纯文档改动,不涉及 CLI、API、YAML 等接口变更。 **输出件变更(按需):** 无 > 备注:不涉及导出格式、产物路径等变更。 **非兼容变更(按需):** 无 > 备注:删除的 usage_quick_quantization.md 全部内容均已迁移至对应载体,无信息丢失。 **SIG 评审结论(按需):** 无 ## 2. 修改描述 **同步说明:** 本 PR 为 [master PR #997](https://gitcode.com/Ascend/msmodelslim/merge_requests/997) 的同步(cherry-pick 提交 7e807320),将「删除冗余一键量化完整指南并迁移内容」同步至 26.2.0 分支。 **修改背景(可选):** docs/zh/user_guide/ 下存在两篇一键量化文档(usage_quick_quantization.md《一键量化完整指南》与 usage_one_click_quantization.md《一键量化使用指南》),内容重叠冗余。为避免文档重复维护与入口混乱,删除冗余的《一键量化完整指南》;删除前逐节确认其全部内容在其他文档中均有载体(本次迁移 + 既有载体),并完成全部引用重映射。 **修改目的:** 统一一键量化文档入口为 usage_one_click_quantization.md;确保 usage_quick_quantization.md 删除后无任何内容丢失,且所有内容均有可追溯的承载文档链接。 **修改内容:**(按「概念 - 变化」分条) - docs/user_guide:删除 usage_quick_quantization.md;usage_one_click_quantization.md 末尾新增 ## 12. 附录 > ### 12.1 协议版本维护策略 - docs/api_reference/cli:msmodelslim_quant.md §4 参数关系新增「最佳实践匹配搜索优先级」1-6 - docs/api_reference/config/task:modelslim_v1.md §1 补充 modelslim_v1 相对 modelslim_v0 的三条优势 - docs/knowledge_base/parallel:README.md §3 新增 dp_layer_wise 算法名视角支持列表;data_parallelism_guide.md §10 补充校准集大小、算法支持说明 - docs/knowledge_base/ptq:LLM 量化指南 步骤5 补充调度器选型对照/适用场景/工作原理与优势对比/选型建议;VLM 量化指南 步骤2 后新增 <span id="dataset---校准数据路径配置"> 校准数据路径配置(参考) - example:multimodal_sd/Wan2_2/README.md 补充 3 个 wan2_2 yaml 链接、multimodal_vlm/Qwen3-VL-MoE/README.md 补充 qwen3_vl_moe_w8a8.yaml 链接 - 引用重映射:88 个文件指向 usage_quick_quantization.md 的链接(含锚点)全部重定向至新载体;导航入口(mkdocs.yml、docs/zh/user_guide/README.md、根 README.md)切换至 usage_one_click_quantization.md - 链接校验:改动覆盖的 92 个文件无新增 broken 链接 **概念域参考:** - cli:msmodelslim quant 命令格式 / 参数列表 / 使用示例 / 最佳实践匹配优先级 - app:一键量化使用指南(前置条件、操作步骤、交付件校验、协议版本维护策略) - core:runner / processor / save / dataset 配置详解,逐层量化与分布式逐层量化 - infra:lab_practice 最佳实践 YAML、示例仓库 README 相关资源 ### 被删文档内容承载映射(docs/zh/user_guide/usage_quick_quantization.md ) | 被删文档章节 | 内容承载位置 | 链接 | | --- | --- | --- | | §1 简介(一键量化概述、两种使用方式) | 一键量化使用指南 全文(入口统一);CLI §1 功能说明(quant_type/config 两种配置来源) | [usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md)、[msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §2 使用前准备(安装) | 安装指南;一键量化使用指南 §2 流程关系与前置条件 | [install_guide.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/install_guide/install_guide.md)、[usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §3.1 命令格式 | CLI §2 命令格式 | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.1 最佳实践搜索优先级 | CLI §4 参数关系「最佳实践匹配搜索优先级」1-6 | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.2 参数说明 | CLI §3 参数列表(原 #32-参数说明 引用已全部重映射至此) | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.3 使用示例(示例1/2/3) | CLI §7 使用示例(默认量化类型 / 自定义配置 / 多卡分布式) | [msmodelslim_quant.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/cli/msmodelslim_quant.md) | | §3.4 输出说明 | 一键量化使用指南 §3 输入和交付件、§5 步骤7 校验交付件 | [usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §4.1.1 逐层量化简介 | 并行机制 README §1/§2 并行机制简述 | [parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md) | | §4.1.2 适用场景 | LLM 量化指南 步骤5 适用场景表 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md) | | §4.1.3 工作原理与优势对比 | LLM 量化指南 步骤5 工作原理与优势对比表 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md) | | §4.1.4 配置方法(runner / 单卡 / 多卡) | LLM 量化指南 步骤5 runner 配置;并行 README §4 多卡量化配置与使用;一键量化使用指南 步骤5/6 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md)、[parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md)、[usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §4.1.5 注意事项 | DP 指南 §10 产品形态与资源限制(校准集大小、算法支持);VLM 指南 步骤2 多模态 runner 支持说明 | [data_parallelism_guide.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/data_parallelism/data_parallelism_guide.md)、[usage_vision_transformer_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/vlm/usage_vision_transformer_quantization.md) | | §4.1.6 模型适配 | 并行 README §3 模型适配器支持列表;大模型支持矩阵 | [parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md)、[model/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/model/README.md) | | §4.1.7 算法适配 | 并行 README §3 dp_layer_wise 算法名视角支持列表 | [parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md) | | §5.1.1 量化配置协议基本结构 | modelslim_v1 / multimodal_vlm_modelslim_v1 / multimodal_sd_modelslim_v1 配置详解 | [modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/modelslim_v1.md)、[multimodal_vlm_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_vlm_modelslim_v1.md)、[multimodal_sd_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_sd_modelslim_v1.md) | | §5.1.2 协议版本说明 | 一键量化使用指南 §12 附录 12.1 协议版本维护策略 | [usage_one_click_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/usage_one_click_quantization.md) | | §5.2 modelslim_v1 配置详解(5.2.1-5.2.7) | modelslim_v1 配置详解全文(§1 功能说明补充 v0→v1 三条优势) | [modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/modelslim_v1.md) | | §5.3 multimodal_sd_modelslim_v1 配置详解(5.3.1-5.3.7) | multimodal_sd_modelslim_v1 配置详解全文;§5.3.7 使用示例 yaml → Wan2_2 示例 README 相关资源 | [multimodal_sd_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_sd_modelslim_v1.md)、[example/multimodal_sd/Wan2_2/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/example/multimodal_sd/Wan2_2/README.md) | | §5.4 multimodal_vlm_modelslim_v1 配置详解(5.4.1-5.4.7) | multimodal_vlm_modelslim_v1 配置详解全文;§5.4.6 dataset 校准数据路径配置 → VLM 指南新增锚点;§5.4.7 使用示例 yaml → Qwen3-VL-MoE 示例 README 相关资源 | [multimodal_vlm_modelslim_v1.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/api_reference/config/task/multimodal_vlm_modelslim_v1.md)、[usage_vision_transformer_quantization.md#dataset---校准数据路径配置](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/vlm/usage_vision_transformer_quantization.md)、[example/multimodal_vlm/Qwen3-VL-MoE/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/example/multimodal_vlm/Qwen3-VL-MoE/README.md) | | §5.5 modelslim_v0 配置说明 | 删除(v0 协议即将废弃,不推荐使用;策略见附录 12.1) | — | | §6.1 相关资料 | 量化算法 README(V1 架构支持算法);并行 README(逐层量化);示例 README 相关资源 | [quantization_algorithms/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/quantization_algorithms/README.md)、[parallel/README.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/README.md) | | §6.2 常见问题(Q1-Q5) | Q1-Q3 调度器选型/逐层量化判断 → LLM 指南 步骤5 选型建议;Q4 多卡加速 → DP 指南 §10;Q5 精度调优 → 量化精度调优指导 | [usage_large_language_model_quantization.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/ptq/llm/usage_large_language_model_quantization.md)、[data_parallelism_guide.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/knowledge_base/parallel/data_parallelism/data_parallelism_guide.md)、[process_quantization_precision_tuning.md](https://gitcode.com/tanxiangyuu/msmodelslim/blob/codex/docs-quant-doc-carrier/docs/zh/user_guide/process_quantization_precision_tuning.md) | ## 3. 功能验证 冒烟由 CI 门禁检查,无需填写「冒烟是否通过」。 - [x] 功能自验(纯文档改动:88 个文件引用重映射完成、全仓 git grep usage_quick_quantization 零残留、改动文件无新增 broken 链接) - [x] 本地自验用例截图(不适用:纯文档改动,N/A) **复现步骤(可选):** bash # 链接校验(仓库根目录) git grep -n "usage_quick_quantization" # 期望无输出 ## 4. 自检(请逐项确认,不适用标 N/A) **典型安全编码问题** - [ ] N/A 是否已校验外部数据:纯文档改动,无代码逻辑 - [ ] N/A 是否未采集或打印敏感信息:(纯文档改动,无代码逻辑) - [ ] N/A 是否已正确设置文件权限:(纯文档改动,无代码逻辑) - [ ] N/A 是否充分考虑浮点运算溢出、除零等异常场景:(纯 See merge request: Ascend/msmodelslim!997 | 7 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 | |
【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 Co-authored-by: zzm30<zhengzhimin1@h-partners.com> # message auto-generated for no-merge-commit merge: !1056 merge master into master 【master】【docs】:mindie sd统一名称;处理器实现修改为代码实现 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. 修改描述 **修改背景(可选):** 产品侧mindie sd统一名称。 **修改目的:** 产品侧mindie sd统一名称。 **修改内容:** 1. mindie sd统一名称; 2. 处理器实现修改为代码实现。 **概念域参考(填写提示):** - 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!1056 | 5 天前 |
线性层量化
词条类别:量化数据格式(量化模式)
英文名称:Linear Layer Quantization
应用领域:大语言模型量化压缩、推理加速
msModelSlim 实现:msmodelslim/ir/w8a8_static.py(*FakeQuantLinear系列)
1. 概述
线性层量化是对大语言模型中占比最高的线性层(Linear / MatMul)的权重(W)与激活(A)进行量化的一类量化模式,属于量化模式中的主体类别。它量化的对象是线性层矩阵乘法两侧的张量:权重是静态参数、每个 token 都必须整体读取;激活是随输入实时变化的中间张量。对这两类张量的位宽组合,通常用 WxAy 记法表示,如 W8A8 表示权重与激活均为 8bit(INT8)。
为何聚焦线性层:每个 token 前向都要读取全部权重,权重位宽直接决定访存带宽瓶颈;激活位宽则决定整数 GEMM 能否落地。因此此类模式数量最多,是量化模式的主体。典型如 W8A8 静态量化——对线性层权重与激活均做 INT8 静态量化。
2. 词条介绍
2.1 线性层如何运算与可量化对象
线性层(Linear / MatMul)是 Transformer 的主体计算——Q/K/V 投影、注意力输出投影、MLP 的上/门/下三层都是线性层。一次线性层计算就是一次矩阵乘法:
Y=X⋅W+bY = X \cdot W + b Y=X⋅W+b
其中 XXX 是输入激活(形状 (batch,seq,in_dim)(batch, seq, in\_dim)(batch,seq,in_dim)),WWW 是权重(形状 (in_dim,out_dim)(in\_dim, out\_dim)(in_dim,out_dim)),bbb 是偏置,YYY 是输出激活。LLM 推理分两个阶段:prefill 一次处理整个输入 prompt(计算密集),decode 逐个生成 token(访存密集)。
矩阵乘法只有两个输入张量,因此线性层中可量化对象也只有两个:
- 权重 WWW:静态张量,训练后固定、每步推理都要整体读取一次。decode 阶段权重访存是主要吞吐瓶颈,因此权重量化侧重压缩——压低位宽以减小访存,如 W8A8 静态量化 的 INT8 权重、W4A8 动态量化 的 INT4 权重。
- 输入激活 XXX:动态张量,由前一层实时产生、分布随输入变化,对量化误差敏感。激活量化侧重保精度,因此通常优选动态量化等细粒度的量化方式,如 W8A8 动态量化 的激活 per-token 动态量化。
量化模式本质上是对这两个张量分别应用某种量化(位宽、数据类型、参数获取方式、量化粒度、对称性)后的组合:如 W8A8 静态量化 对 W 与 A 均做 8bit INT8 静态量化、W8A16 静态量化 只量化 W 而 A 保持 16bit、W4A8 动态量化 则 W 4bit、A 8bit 且激活走动态。两个张量各自的维度选择,就构成下述"该类一般的量化选择"。
2.2 该类一般的量化选择
同一类线性层结构可实施不同的量化方式,差异体现在以下几个维度:
- 位宽组合:权重与激活可取相同或不同位宽。相同位宽(W8A8、W4A4)压缩与精度较均衡;激活位宽高于权重(W8A16、W4A8)牺牲部分压缩换取精度。见 W8A16 静态量化、W4A8 动态量化。
- 参数获取方式:静态(离线校准、推理时固化,如 W8A8 静态量化)或动态(推理在线统计、免校准,如 W8A8 动态量化、W4A4 动态量化)。
- 量化粒度:权重通常按通道(per-channel)或分组(per-group)静态量化;激活通常按 token(per-token)动态量化或按整个张量(per-tensor)静态量化;MX 系列采用按块(per-block)块级共享指数。
- 数据类型:INT 整数(INT8/INT4)、FP8 浮点(如 W8A8 FP8 动态量化)、MX 块级共享指数(如 W4A4 MX 动态量化、W4A4 MX 双 Scale 量化)。
- 特殊变体:W8A8 PD-Mix 量化 按 Prefill/Decode 阶段切换激活策略;W8A8 稀疏量化 不铺满 INT8 的 256 个档位,再经二次压缩提高压缩率;浮点稀疏量化 不降位宽、对浮点权重做置零稀疏。
各类模式在精度损失(相对浮点基线的劣化程度)与性能(权重/激活访存与计算收益)之间取舍。精度损失分 低 / 中 / 高 三档,不直接比较精度高低。
| 模式 | 精度损失 | 性能(定性) | 取舍要点 |
|---|---|---|---|
| W8A8 动态量化 | 低 | 高 | 激活 per-token 动态,8bit 方案里损失较小 |
| W8A8 FP8 动态量化 | 低 | 高 | 与 W8A8 动态同档,依赖 FP8 算子 |
| W8A8 PD-Mix 量化 | 低 | 高 | Prefill per-token、Decode 静态,整体与 W8A8 动态同档 |
| W8A8 静态量化 | 低 | 高 | 满量程 INT8 静态,损失仍属低档 |
| W8A8 MX 动态量化 | 低 | 高 | 8bit MX per-block,与其他 W8A8 同档 |
| W8A16 静态量化 | 低 | 中 | 激活不量化,损失低;无整数 GEMM,性能收益减半 |
| 浮点稀疏量化 | 中 | 中 | 不降位宽,但置零会引入中等精度损失 |
| W8A8 稀疏量化 | 中 | 高 | 只用 256 档中的子集,损失高于满量程 W8A8,换更高压缩率 |
| W4A8 动态量化 | 中 | 高 | 权重 4bit、激活 8bit 动态,损失中等 |
| W4A8 MX 动态量化 | 中 | 高 | 与 W4A8 动态同档 |
| W4A4 动态量化 | 高 | 最高 | 双 4bit,精度损失高,访存收益最大 |
| W4A4 MX 动态量化 | 高 | 最高 | W4A4 类,双 4bit MX |
| W4A4 MX 双 Scale 量化 | 高 | 高 | 仍属 W4A4 类;双层 scale 只减轻损失,不改变档位 |
注:表中"性能"特指量化后的权重/激活访存与计算收益;实际损失与收益取决于目标硬件算子支持与模型分布,详见各模式词条与模式索引。
2.3 该类下的模式清单
以下为 msModelSlim 支持的线性层量化模式清单(完整规格含承载 IR 类与量化参数,见模式索引):
| 模式 | 一句话 |
|---|---|
| W8A8 静态量化 | 权重与激活均 INT8 静态 |
| W8A8 动态量化 | 权重静态、激活 per-token 动态 |
| W4A4 动态量化 | 权重与激活均 INT4、激活动态 |
| W8A16 静态量化 | 仅权重 INT8,激活 FP16 不量化 |
| W4A8 动态量化 | 权重 INT4、激活 INT8 动态 |
| W8A8 PD-Mix 量化 | 激活策略随 Prefill/Decode 阶段切换 |
| W8A8 FP8 动态量化 | 权重与激活均 FP8(E4M3) 动态 |
| W8A8 MX 动态量化 | 权重与激活均 MXFP8 per-block 动态 |
| W4A8 MX 动态量化 | 权重 MXFP4、激活 MXFP8 per-block 动态 |
| W4A4 MX 动态量化 | 权重与激活均 MXFP4 per-block 动态 |
| W4A4 MX 双 Scale 量化 | MXFP4 双 scale、per-block 动态 |
| W8A8 稀疏量化 | INT8 只用码本子集,再经 W8A8SC 二次压缩,压缩率高于 W8A8 |
| 浮点稀疏量化 | 16bit 权重/激活,权重置零稀疏;W16A16SC 为二次压缩形态 |
| SVDQuant 量化 | 低秩分解 + 残差低比特量化,配合线性层量化使用 |
3. 关联流程
4. 关联词条
- 量化模式:上位概念,本词条是"线性层量化"类别。
- KVCache 量化:同位概念,作用于注意力 K/V 缓存的量化类别,可与本类叠加。
- FA 量化:同位概念,KVCache 量化的进阶。
- W8A8 静态量化:下位概念,本类别下最基础的静态模式。
- W8A8 稀疏量化:下位概念,INT8 收窄码本后再二次压缩。
- 浮点稀疏量化:下位概念,不降位宽的置零稀疏基线。
- 线性量化算法:配套术语,描述线性层量化模式的代码实现。
5. 参考文档
- 《线性量化参数配置流程指南》
- 《量化模式》