PR 提交说明

提交前请阅读 贡献指南，开发者文档：模型接入指南

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 门禁检查，无需填写「冒烟是否通过」。

• 功能自验：生成器 --check 无 drift；py_compile 通过；MR 全量 106 个变更文件通过 pre-commit（ruff / codespell / pylint / bandit / typos）。
• 本地自验用例截图（请勿包含个人信息；可附复现命令）

复现步骤（可选）：

python3 skills/docs-management/scripts/gen_config_api_docs.py --check

4. 自检（请逐项确认，不适用标 N/A）

典型安全编码问题

• 是否已校验外部数据 N/A
• 是否未采集或打印敏感信息
• 是否已正确设置文件权限 N/A
• 是否充分考虑浮点运算溢出、除零等异常场景 N/A
• 是否已对正则表达式做 ReDos 检查 N/A

DT

• 是否具备 UT 测试用例看护：否（生成脚本不保留单测，正确性由 --check 与文档门禁校验兜底）
• 是否需要添加冒烟：否（文档生成与描述修复，不改变量化运行时行为）