Star333
204
代码
代码
Issues79
Pull Requests106
Actions
项目讨论
Wiki
分析
Star333
204
ascend-robotascend-robot[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新）
5120200e创建于 4 天前历史提交
文件最后提交记录最后更新时间
adapt_rotation.md
[Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1021 merge master into master [Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1021
8 天前
autoround_quant.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
awq.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
binary_analysis.md
[Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1021 merge master into master [Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1021
8 天前
binary_operator_layer_wise.md
[Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1021 merge master into master [Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1021
8 天前
binary_operator_model_wise.md
[Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1021 merge master into master [Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1021
8 天前
dynamic_cache.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
fa3_quant.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
flatquant.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
flex_awq_ssz.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
flex_smooth_quant.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
float_sparse.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
group.md
[Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1021 merge master into master [Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1021
8 天前
iter_smooth.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
kv_smooth.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
linear_quant.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
load.md
[Doc]修复遗留的旧参数问题 Co-authored-by: Rigel_Chen<chenruijie9@huawei.com> # message auto-generated for no-merge-commit merge: !974 merge docs-fix into master [Doc]修复遗留的旧参数问题 Created-by: Rigel_Chen Commit-by: Rigel_Chen 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. 修改描述 **修改背景（可选）：**（问题现象、使用场景等） **修改目的：** 修复残留的旧参数文档问题 **修改内容：**（按「概念 - 变化」分条，示例：core/算法：新增 SmoothQuant 离群值抑制） tag->tags,config_path->config **概念域参考（填写提示）：** - cli：命令行 quant / analyze / tune - app：最佳实践量化、量化分析、精度反馈自动调优等 - core：算法、量化服务、调度、张量量化、调优策略、最佳实践、上下文等 - infra：模型适配、调优计划/历史/缓存、测评服务等 - utils：日志、错误处理、插件等 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [ ] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [ ] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!974
16 天前
oasq.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
online_quarot.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
quarot.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
saver.md
[Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1021 merge master into master [Doc] 修复 issue 528 part.1（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1021
8 天前
smooth_quant.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
svd_res.md
[Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !845 merge docs/optimize-api-reference into master [Doc] 优化接口文档：配置文档源码自动生成与结构重组，接口文档按检视整改 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan 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 解析与量化运行时行为。 > 备注：CLI 文档（模板 05）为手工维护、对照实现与 --help 撰写，本 PR 不改变任何命令行行为。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景：** 接口层配置文档（模板 04）此前靠手工维护，新增处理器、改 Field 约束后容易与实现不一致；同时历史检视意见遗留若干文档问题（术语、表格矛盾、路径错误、Markdown 格式等）。 **修改目的：** 从源码自动生成量化配置接口文档并可用 --check 防漂移；按 AI 检视意见整改文档与规范模板；修复 pre-commit 门禁问题，使 MR 全量变更文件通过检查。 **修改内容：** - **配置文档自动生成**：生成器移入 skills/docs-management/scripts/（gen_config_api_docs.py 驱动 / gen_quant_config_docs.py 装配 / quant_config_docgen.py 渲染），从 Pydantic JSON Schema 抽取字段、默认值、约束与 type 分派，--check 逐字节核对生成稿与源码是否漂移；生成稿带 generated-by 标记、不手工编辑。 - **文档结构重组**：配置文档按 config/{task,processor,format,tuning}/ 分类子目录组织；task 与 spec 合并为一页、不再单独生成 spec/ 页面；删除 config/README.md 索引；页内跳转统一使用 HTML 锚点（<h3 id> / <a href>），弃用 {#anchor} 语法。 - **源码注解补齐并重新生成**：为各配置类补全/修正类 docstring、Field(description=)、validator docstring 并同步重新生成全部配置文档；修正评估服务校验器路径描述（evaluation.datasets）等。 - **CLI 文档补齐**：新增/完善 docs/zh/api_reference/cli/msmodelslim_{quant,analyze,tune}.md（模板 05），修正参数默认值、条件必选、行为描述等。 - **规范与模板同步**：更新量化配置文档模板与校验清单、生成器设计文档、资料规范 README、docs-management skill 场景文档；回退 CLI 文档模板中与上游不一致的编号说明。 - **检视整改**：按检视意见修复术语（敏感性/敏感度、落盘、回退 等）、表格矛盾（默认值/取值范围/必选）、路径错误、Markdown 格式问题（MD038/MD031/MD051）等。 - **pre-commit 门禁修复**：ruff 格式重排、日志惰性格式化（W1202/W1203）、pylint/bandit 豁免、typos 变量改名、codespell 白名单补充 TE；MR 全量变更文件通过 pre-commit。 **概念域参考（填写提示）：** - cli：本 PR 仅文档，不改 CLI 代码 - docs：配置/CLI 接口文档、资料规范与模板 - skills：docs-management 文档生成 skill ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash python3 skills/docs-management/scripts/gen_config_api_docs.py --check ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据 N/A - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限 N/A - [x] 是否充分考虑浮点运算溢出、除零等异常场景 N/A - [x] 是否已对正则表达式做 ReDos 检查 N/A **DT** - [x] 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底） - [x] 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为） See merge request: Ascend/msmodelslim!845
1 个月前
trainable_linear_quant.md
[master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Co-authored-by: jiamingxuaa<xujiaming19@h-partners.com> # message auto-generated for no-merge-commit merge: !1043 merge master into master [master] [Doc] 修复 issue 528 part.2（cli 和 config 文档问题及相关引用更新） Created-by: jiamingxuaa Commit-by: jiamingxuaa 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 等请在此项补充说明。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 文档路径调整（书签/外链需迁移） - docs/zh/api_reference/config/task/ → docs/zh/api_reference/config/quant/ - 删除手写页 docs/zh/api_reference/config/auto_precision_tuning.md，改由 config/tuning/README.md + 既有 tuning/* 字段页承接 - docs/zh/api_reference/config/processor_group.md → docs/zh/user_guide/usage_processor_group.md 迁移：将旧链接中的 config/task/ 改为 config/quant/；自动调优协议说明改链至 config/tuning/README.md；组合处理器用法改链至 user_guide/usage_processor_group.md。仓库内交叉引用已同步更新。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** API Reference 中配置文档按类型组织，缺少统一的“先选协议 / 再按 type 查处理器”导航；CLI 与配置字段说明、示例标签等与现状不完全一致；自动调优手写长文与 tuning/ 生成页并存，入口分散；以及[测试提出的各种修改建议](https://gitcode.com/Ascend/msmodelslim/issues/528)。 **修改目的：** 理顺cli / config 文档层级与导航，校准命令行与配置字段说明，并同步全库交叉链接与文档生成约定，降低查阅与后续维护成本。 **修改内容：** - cli：新增 api_reference/cli/README.md（全局/公共参数、子命令总览）；校准 quant / analyze / eval / tune 参数表、互斥关系、权重转换省略 --model_type、--save_path 公共化、tags 示例等表述 - docs/api_reference/config：新增手写导航 config/README.md、config/quant/README.md、config/tuning/README.md；任务配置目录 task/ 重命名为 quant/；删除 auto_precision_tuning.md；组合处理器说明迁至 user_guide/usage_processor_group.md - docs/api_reference/config（生成页）：更新 processor/*、format/*、tuning/* 及 quant/* 字段说明/结构（如 modelslim_convert、evaluation_service_oriented、group、trainable_linear_quant 等） - docs/knowledge_base & user_guide & skills：批量将 config/task/ 链接改为 config/quant/，并同步自动调优/组合处理器相关入口 - docs/contributing & skills/docs-management：更新 api_reference_docgen.md 与脚本 README，明确 quant/ 产出目录、手写 README.md 受 MANUAL_KEEP 保护、配置块编号最多 3 段等约定 **概念域参考（填写提示）：** 说明：本 PR 为文档与导航重构，未改动 app / core / infra / utils 运行时代码；修改内容主要落在 cli（文档） 与文档体系本身。 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [ ] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** bash # 在此粘贴可复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [x] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [x] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!1043
4 天前
unary_analysis.md
[Doc] RA Compress 文档更新 Co-authored-by: zwling<906711886@qq.com> Co-authored-by: Rigel_Chen<chenruijie9@huawei.com> # message auto-generated for no-merge-commit merge: !991 merge docs/ra_compress-refine-docs into master [Doc] RA Compress 文档更新 Created-by: zwling Commit-by: zwling;Rigel_Chen Merged-by: ascend-robot Description: # PR 提交说明 ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：本 PR 仅涉及文档。文档中同步的 CLI 行为（attn_head 默认使用内置校准集、--calibration_dataset 变为可选）与配置字段（unary_analysis.metric_params）均由配套特性 PR 引入，文档侧无代码接口变更。 **输出件变更（按需）：** 无 > 备注：仅修正 head.pt 的用途描述（交付推理框架用于长序列 KV Cache 压缩），产物格式与路径未变。 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景（可选）：** RA Compress（attn_head 范围分析）相关文档与当前实现存在多处不一致：校准集仍被描述为「必须显式指定 calib_dummy.jsonl」；head 选择比例（14% / 1%）被描述为「不通过 YAML 配置」；head.pt 的用途被描述为「用于 RA Compress 量化流程」，而实际是交付推理框架做长序列 KV Cache 压缩；unary_analysis 处理器文档未收录 ra_compress 指标与 metric_params；另有失效的相对链接。 关联issue https://gitcode.com/Ascend/msmodelslim/issues/510 **修改目的：** 使 6 篇文档与实现保持一致，使用户能按文档正确完成 attention head 分析、head 选择比例调优与 head.pt 交付，并清理过期表述与失效链接。 **修改内容：** - cli：api_reference/cli/msmodelslim_analyze.md —— 功能说明与退出码 0 说明补充 head.pt 交付推理框架用于长序列 KV Cache 压缩（附 MindIE 支持模型列表引用）；attn_head 示例移除 --calibration_dataset calib_dummy.jsonl；5.6 节标题与说明调整并新增 ratio 覆盖 YAML 示例；修正 ra_compress.yaml 模板链接层级（../../ → ../../../../）。 - core（配置参考）：api_reference/config/processor/unary_analysis.md —— metrics 取值新增 ra_compress；新增 metric_params 字段（induction_head_ratio 默认 0.14、echo_head_ratio 默认 0.01）及配置约束（仅 ra_compress 可用，未知键 / 越界值直接报错）；补充完整 YAML 示例。 - core（算法知识库）：knowledge_base/quantization_algorithms/README.md —— 新增「4. 注意力头分析算法」章节并顺延后续章节编号；将敏感层分析口径拆分为「量化敏感度（linear/layer/attn）」与「KV Cache 压缩头筛选（attn_head）」；attn_head 条目改为默认使用内置 ra_compress_dummy 校准集。 - core（术语）：ra_compress/term_ra_compress.md —— 校准数据表述统一为内置 ra_compress_dummy（1 个 BOS + 2500×4 = 10001 tokens）；删除过期条目（必须显式指定 calib_dummy.jsonl、ratio 不通过 YAML 配置、内部接口实现清单）；补充 ratio 覆盖方式与模板渲染链路说明；参考文献补充 arXiv 链接。 - core（使用指南）：ra_compress/usage_ra_compress.md —— 前置条件、输入与参数表、流程图、操作步骤同步为「默认内置校准集」；明确内置 10001 tokens 与自定义校准集「2500 的整数倍 + 1（≥ 10000 tokens）」的对齐要求；新增 ratio 覆盖示例、head.pt 交付说明及异常处置（得分为空、Q/K 投影层未命中、GQA 分组报错）。 - app（用户指南）：user_guide/usage_sensitive_attn_head_analysis.md —— 步骤 5、验收条件与异常处置同步校准集与 ratio 变更；术语统一为 induction / echo head。 - utils / 全量：清理 calib_dummy.jsonl 过期引用，统一术语与相对链接写法。 **合入依赖：** 文档所描述的代码行为由配套特性 PR feature/ra_compress-refine-v2 引入；其中 term_ra_compress.md 引用的 msmodelslim/infra/dataset_loader/builtin_datasets/ra_compress_dummy.py 在 master 上尚不存在，建议代码 PR 先行合入，或两者同期合入。 ## 3. 功能验证 - [x] 功能自验 - [x] 本地自验用例截图（请勿包含个人信息；可附复现命令） > 本 PR 为纯文档改动，无运行输出可截图；自验方式为静态检查与链接解析校验，结果如下。 **复现步骤（可选）：** bash # 1) 静态检查（typos / end-of-file / markdown 等 hook 全部通过） pre-commit run --files \ docs/zh/api_reference/cli/msmodelslim_analyze.md \ docs/zh/api_reference/config/processor/unary_analysis.md \ docs/zh/knowledge_base/quantization_algorithms/README.md \ docs/zh/knowledge_base/quantization_algorithms/ra_compress/term_ra_compress.md \ docs/zh/knowledge_base/quantization_algorithms/ra_compress/usage_ra_compress.md \ docs/zh/user_guide/usage_sensitive_attn_head_analysis.md # 2) 文档内相对链接可解析性检查（唯一剩余项为上述待合入的 ra_compress_dummy.py） ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [N/A] 是否已校验外部数据 - [N/A] 是否未采集或打印敏感信息 - [N/A] 是否已正确设置文件权限 - [N/A] 是否充分考虑浮点运算溢出、除零等异常场景 - [N/A] 是否已对正则表达式做 ReDos 检查 > 以上均为纯文档改动，不涉及代码逻辑。 **DT** - [N/A] 是否具备 UT 测试用例看护（纯文档改动，无需新增 UT） - [ ] 是否需要添加冒烟：否 See merge request: Ascend/msmodelslim!991
8 天前