| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
[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 | 28 天前 | |
[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 | 1 天前 | |
[Doc] 补全权重转换 CLI/YAML/多卡说明并纠正知识库结构 Co-authored-by: Rigel_Chen<chenruijie9@huawei.com> # message auto-generated for no-merge-commit merge: !956 merge docs/weight-convert-534 into master [Doc] 补全权重转换 CLI/YAML/多卡说明并纠正知识库结构 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 一致） **建议标题：** [Doc] 补全权重转换 YAML/CLI/多卡说明并纠正知识库结构 ## 1. 影响面评估 **接口变更（按需）：** 无 > 仅文档与示例 YAML 注释/落盘格式写法；不改 CLI 参数、API、运行时 YAML schema。 **输出件变更（按需）：** 无 > 备注：若无变更请保留「无」；涉及导出格式、产物路径等请在此项补充说明。 **非兼容变更（按需）：** 无 > 备注：若无变更请保留「无」；若有非兼容变更请说明迁移方式。 **SIG 评审结论（按需）：** 无 > 提醒：非兼容、安全风险等高危 PR 须经 SIG 评审后合入；无则保留「无」。 ## 2. 修改描述 **修改背景（可选）：** issue [#534](https://gitcode.com/Ascend/msmodelslim/issues/534)：权重转换的 YAML 配置、使用说明、config 介绍、知识库整体结构与多卡机制存在多处资料问题（约 18 处）。表现为：转换命令不可直接复制、--model_type/--quant_type 与量化路径混写、save.type 别名过多、defaults 与 save 优先级不清、量化 DP/EP/DTS 被误套到 convert、PTQ 接入指南缺权重转换入口。 **修改目的：** 按现网 convert 实现补全用户侧资料：给出可复制命令与示例 YAML，写清用户真正要调的配置，划清量化多卡与权重转换并行方案，并保持与 master 词条/可调参数口径一致。 **修改内容：** - docs/cli：msmodelslim quant 增加权重转换示例（§7.6）；写明转换不需要 --model_type / --quant_type；NPU 多卡示例为 --device npu --device_id 0 1 2 3。 - docs/config：modelslim_convert 配置页修正 apiversion 固定为 modelslim_convert（不再展示基类占位 Unknown 及其他任务取值）；明确 defaults.dst_format 与 spec.save 的覆盖关系（配了 save 不走 defaults）；日常保存格式只写 huggingface / ascend_v1；并行只区分 CPU workers 与 NPU --device_id，保留用户可调的 max_group_size（MoE 切组防拖尾），使用指南调参表隐去日常不改的 linears.route。 - docs/ptq：使用指南补 INT4 路径、可点击示例 YAML、可复制转换命令与多卡命令；步骤 4 聚焦 match / target / save / workers / max_group_size。PTQ 知识库接入指南补权重转换行（配置驱动、无需模型适配器）。术语词条保留 master 原有机制说明（虚拟模块树、tick-tock、7 阶段流水线等），仅规范保存格式名与 NPU/CPU 设备口径。 - docs/parallel：文首与使用说明写明本目录只覆盖量化多卡（DP / EP / DTS），不覆盖 convert；convert 走自身并行方案，入口见权重转换使用指南。 - docs/knowledge_base：ptq 入口改为 ptq/README.md，避免误链到转换使用页。 **概念域参考（填写提示）：** - cli：命令行 quant / analyze / tune - app：最佳实践量化、量化分析、精度反馈自动调优等 - core：算法、量化服务、调度、张量量化、调优策略、最佳实践、上下文等 - infra：模型适配、调优计划/历史/缓存、测评服务等 - utils：日志、错误处理、插件等 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） **复现步骤（可选）：** 文档核对（无运行时行为变更）。对照页： - docs/zh/knowledge_base/ptq/convert/usage_weight_conversion.md - docs/zh/api_reference/cli/msmodelslim_quant.md §7.6 - docs/zh/api_reference/config/task/modelslim_convert.md - docs/zh/knowledge_base/ptq/README.md - docs/zh/knowledge_base/parallel/README.md bash # 仅文档变更，无功能复现命令 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据 - [ ] 是否未采集或打印敏感信息 - [ ] 是否已正确设置文件权限 - [ ] 是否充分考虑浮点运算溢出、除零等异常场景 - [ ] 是否已对正则表达式做 ReDos 检查 **DT** - [ ] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因） - [ ] 是否需要添加冒烟：否（若「是」请说明冒烟场景及对应用途） See merge request: Ascend/msmodelslim!956 | 1 天前 | |
[Doc] API 参考文档对齐当前 CLI：参数改用规范名并对齐配置文档与文档规范 #483 Co-authored-by: rookie_hongchuan<hongchuan6@h-partners.com> # message auto-generated for no-merge-commit merge: !860 merge docs/fix-api-reference into master [Doc] API 参考文档对齐当前 CLI：参数改用规范名并对齐配置文档与文档规范 #483 Created-by: rookie_hongchuan Commit-by: rookie_hongchuan Merged-by: ascend-robot Description: 关联 issue：#483 ## 1. 影响面评估 **接口变更（按需）：** 无 > 仅文档表述，不涉及代码接口。 **输出件变更（按需）：** 无 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 > 纯文档改动，无接口/安全/架构变更，无需 SIG 评审。 ## 2. 修改描述 **修改背景（可选）：** CLI 已把参数改用规范名（ --config_path→--config、 --tag→--tags、--pattern→--patterns、--topk→--top_k），但已合入的 API 参考 文档仍沿用旧名称，且部分配置文档/docstring 与文档规范（数字单位间距、术语、标题标号）未对齐。 **修改目的：** 让 API 参考与配置文档对齐当前 CLI 契约与文档规范，消除文档与实现漂移。 **修改内容：**（按「概念 - 变化」分条） - cli：quant/analyze/tune 命令行 API 文档改用规范名 --config/--tags/--patterns/--top_k， 补充 --device_id/--log_level/-v/-q，修正 --trust_remote_code 与设备语义 - config：api_reference/config/** 相关配置文档按文档规范统一描述与术语 - docs：docs_standards 的 01/03 checklist 与模板按标题标号与规范修订 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验 - [ ] 本地自验用例截图（文档改动，未涉及） **复现步骤（可选）：** N/A（纯文档改动） ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据：N/A（纯文档） - [x] 是否未采集或打印敏感信息 - [x] 是否已正确设置文件权限：N/A（纯文档） - [x] 是否充分考虑浮点运算溢出、除零等异常场景：N/A（纯文档） - [x] 是否已对正则表达式做 ReDos 检查：N/A（纯文档） **DT** - [x] 是否具备 UT 测试用例看护：N/A（纯文档改动，不涉及代码逻辑） - [x] 是否需要添加冒烟：否（文档改动） See merge request: Ascend/msmodelslim!860 | 23 天前 | |
[Doc] 量化算法、PTQ对应资料内容整体整改 Co-authored-by: qq_46439621<wanlongze1@huawei.com> # message auto-generated for no-merge-commit merge: !972 merge ziliao_fix_0914 into master [Doc] 量化算法、PTQ对应资料内容整体整改 Created-by: qq_46439621 Commit-by: qq_46439621 Merged-by: ascend-robot Description: # PR 描述 **PR 标题：** [Doc] 规范化PTQ与量化算法知识库文档（词条去私有化、使用指南流程重构、接入指南精简、格式整改、旧接入文档移除重定向）并补全权重转换 CLI/YAML/多卡说明 **涉及提交：** - 08cb03a3 [Doc] 规范化PTQ与量化算法知识库文档：词条去私有化、使用指南流程重构与格式整改、旧接入文档移除重定向、产品系列名称规范化，并补全权重转换 CLI/YAML/多卡说明（110 个文件，+4286/-5918） 提交前请阅读 [贡献指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/contributing/contributing_guide.md)，开发者文档：[PTQ 接入指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/knowledge_base/ptq/README.md) PR 标题前缀：[Feature]、[Bugfix]、[Doc]、[Test]（与 CONTRIBUTING 一致） ## 1. 影响面评估 **接口变更（按需）：** 无 > 备注：本 PR 为纯文档变更，不涉及 CLI、API、YAML 等接口。 **输出件变更（按需）：** 无 > 备注：不涉及导出格式、产物路径等。 **非兼容变更（按需）：** 无 > 备注：仅知识库文档内容整改，无行为变更，无需迁移。 **SIG 评审结论（按需）：** 无 > 说明：非兼容、安全风险等高危项均不涉及。 ## 2. 修改描述 **修改背景（可选）：** 知识库 docs/zh/knowledge_base/ptq 与 docs/zh/knowledge_base/quantization_algorithms 两个目录的资料经测试反馈存在以下问题： 1. 词条（term）文件掺杂 modelslim 特有特性（逐层量化、runner 等），不符合「词条讲述通用量化特性」的定位，且未按[词条模板](docs/zh/contributing/development_guide/docs_standards/01_term_glossary_template.md)组织； 2. 校准集数量表述不统一，需统一为推荐 50 条；W4A16 相关内容按规范不应体现；部分文档残留明显 AI 味提示词； 3. PTQ 使用指南流程总览与操作步骤结构冗余，缺少可直达的操作路径； 4. 量化算法使用指南（usage）整体流程不完整，缺少前置的「模型适配」阶段（未体现 msmodelslim/model/interface_hub.py 相关接口），且缺少指向 user guide 的更多信息跳转链接； 5. 格式低错：标题层级、标点符号，term 词条章节分隔方式不统一，usage/integration_guide 步骤间残留多余分隔线，流程图长节点未换行、缺少流程总览图； 6. knowledge_base/model 目录下三个旧接入文档（integrating_models.md、integrating_multimodal_generation_model.md、integrating_multimodal_understanding_model.md）与新 ptq 接入指南内容重复且已废弃，需移除并重定向全库引用； 7. 权重转换 CLI 命令文档与 modelslim_convert 配置协议说明不完整，缺少 CLI 命令、YAML 配置与多卡执行等关键说明；知识库部分 README 与实际目录结构不一致。 **修改目的：** 规范化 PTQ 与量化算法知识库文档，使术语词条聚焦通用量化特性、使用指南形成「适配 → 校准集 → 保存格式 → 算法 → runner → 量化命令」的完整可操作路径、接入指南聚焦接口职责并串联实际案例，统一文档格式规范，移除废弃旧接入文档并统一引用入口至 ptq 接入指南，补全权重转换 CLI/YAML/多卡资料并纠正知识库结构，提升资料准确性、一致性与易用性。 **修改内容：** - **docs / PTQ 词条**：PTQ、LLM、VLM、DiT、权重转换等 term 词条剥离 modelslim 特有内容（逐层量化、runner 等），按词条模板重构，删减量化特点篇幅，重点突出 LLM/VLM/DiT 三类模型的量化特点。 - **docs / PTQ 使用指南**：usage_large_language_model_quantization.md 等 usage 文档去掉流程总览与操作步骤旧结构，统一按步骤 1-6（模型适配 V1 interface → 选择校准集 → 选择保存格式 → 选择算法 → runner → 量化命令）重写，补充静态量化/动态量化 yaml 与 W8A8 完整示例配置及命令行；校准集统一为推荐 50 条。 - **docs / PTQ 接入指南**：LLM/VLM/DiT 三篇 integration_guide 精简大段代码展示，聚焦接口含义与输入输出说明，补充 DeepSeek、Kimi 等实际模型量化案例的跳转链接，并与使用指南去重（V1 Interface 介绍收敛至接入指南，使用指南以链接引用）。 - **docs / 量化算法词条**：quantization_algorithms 下 33 个算法目录的 term 词条去私有化表述，统一校准集推荐 50 条，删除 W4A16 相关内容，清理 AI 味提示词，修正标题与标点格式。 - **docs / 量化算法使用指南**：usage 文档在流程开头新增「模型适配」阶段，覆盖 msmodelslim/msmodelslim/model/interface_hub.py 涉及的适配接口（先适配、后算法）；文末统一新增「更多量化信息」跳转链接至 [权重量化使用指南](https://gitcode.com/Ascend/msmodelslim/blob/master/docs/zh/user_guide/usage_weight_quantization.md)；整体格式参考 usage_quarot.md 对齐。 - **docs / 格式整改**：知识库 term 词条章节统一以 --- 分隔；usage/integration_guide 删除步骤间多余分隔线；使用指南新增流程总览图并优化流程图长节点换行（涉及 ptq、quantization_algorithms 等 47 个文件）。 - **docs / 旧接入文档移除重定向**：移除 knowledge_base/model 目录下三个旧接入文档（integrating_models.md、integrating_multimodal_generation_model.md、integrating_multimodal_understanding_model.md），best_practices、user_guide、knowledge_base、mkdocs.yml 等全库引用统一重定向至 ptq 目录下对应接入指南（llm/vlm/dit 三类 integration_guide），消除死链与内容重复（23 个文件）。 - **docs / 权重转换资料补全**：msmodelslim quant CLI 文档补全权重转换命令说明；modelslim_convert 配置协议说明补充 YAML 配置与多卡执行等字段说明；纠正 knowledge_base 及 parallel 目录 README 与实际结构不一致问题。 - **docs / 流程总览与死链收尾**：llm/vlm/dit 三篇 usage 流程总览「前置条件：模型适配」改为独立文字段落，阶段列表与流程图节点对齐；修复 skills、example 中引用已删除文档的残留死链；Wan2.2 W4A4F4 案例产品系列名称规范化（昇腾950PR&950DT → Ascend 950PR&950DT）。 **概念域参考：** - core：量化算法词条与使用指南（33 个算法的 term/usage） - infra：模型适配（interface_hub 接口）相关文档、PTQ 使用/接入指南 ## 3. 功能验证 本 PR 为纯文档变更，不涉及代码路径，冒烟由 CI 门禁检查。 - [x] 功能自验（文档本地渲染预览、文内互链与外链可达性人工检查、与源码 interface_hub.py 接口一致性核对） - [ ] 本地自验用例截图：N/A（纯文档变更，无运行时输出） **复现步骤（可选）：** bash # 查看本 PR 全部改动（也可直接查看分支整体 diff：git diff upstream/master..ziliao_fix_wlz -- docs/ skills/ example/） git diff 08cb03a3^..08cb03a3 -- docs/zh mkdocs.yml skills example # 本地预览（可选） # 使用任意 Markdown 渲染工具查看上述文档渲染效果 ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [ ] 是否已校验外部数据：N/A（纯文档变更，无代码） - [ ] 是否未采集或打印敏感信息：N/A（纯文档变更，无代码；文档内容不含密钥等敏感信息，gitleaks 扫描因本机缺少二进制跳过，已人工核对无敏感信息） - [ ] 是否已正确设置文件权限：N/A（纯文档变更） - [ ] 是否充分考虑浮点运算溢出、除零等异常场景：N/A（纯文档变更） - [ ] 是否已对正则表达式做 ReDos 检查：N/A（纯文档变更） **DT** - [ ] 是否具备 UT 测试用例看护：N/A（纯文档变更，不涉及代码逻辑，无新增/变更用例路径） - [ ] 是否需要添加冒烟：否（纯文档变更，无功能场景） See merge request: Ascend/msmodelslim!972 | 1 天前 | |
[Doc] 重组中文资料目录并同步导航与链接 Co-authored-by: joejoezhou<zhourongchen1@huawei.com> # message auto-generated for no-merge-commit merge: !761 merge feature/docs-dirs into master [Doc] 重组中文资料目录并同步导航与链接 Created-by: joejoezhou Commit-by: joejoezhou 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. 影响面评估 **接口变更（按需）：** 无 **输出件变更（按需）：** 无 **非兼容变更（按需）：** 无 **SIG 评审结论（按需）：** 无 ## 2. 修改描述 **修改背景（可选）：** 中文资料目录层级混乱，流程与概念混杂，导航与相对链接随历史迁移积累了失效路径。 **修改目的：** 重组 docs/zh 目录结构，统一以流程指南/知识库/案例参考三类文档分层，并同步导航、索引与全库相关链接。 **修改内容：** - docs：新增推理加速知识库 knowledge_base，按 knowledge_base / user_guide / contributing / api_reference / best_practices / legal 重组中文资料 - docs：每个算法单独子目录、每个调优策略单独子目录、每个量化格式单独子目录 - docs：更新流程指南，区分业务流程和工具使用流程；算法总览补齐子算法 - docs：修复迁移后失效/过时链接，同步 mkdocs 导航（仅改路径，顶层序号与 master 一致） - docs：按评审意见修正相对路径、书名号外层、文档链接书名号与完整句句号 - docs：PR 模板中模型接入路径对齐新目录；清除 V0 案例残留 ## 3. 功能验证 冒烟由 CI 门禁检查，无需填写「冒烟是否通过」。 - [x] 功能自验 - [ ] 本地自验用例截图（请勿包含个人信息；可附复现命令） ## 4. 自检（请逐项确认，不适用标 N/A） **典型安全编码问题** - [x] 是否已校验外部数据（N/A） - [x] 是否未采集或打印敏感信息（N/A） - [x] 是否已正确设置文件权限（N/A） - [x] 是否充分考虑浮点运算溢出、除零等异常场景（N/A） - [x] 是否已对正则表达式做 ReDos 检查（N/A） **DT** - [x] 是否具备 UT 测试用例看护（路径：用例路径；未添加请说明原因）：文档重组，无代码逻辑变更，不新增 UT - [x] 是否需要添加冒烟：否 See merge request: Ascend/msmodelslim!761 | 1 个月前 |
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
| 28 天前 | ||
| 1 天前 | ||
| 1 天前 | ||
| 23 天前 | ||
| 1 天前 | ||
| 1 个月前 |