| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
A5文件挂载与环境变量设置 Co-authored-by: weixin_63825906<gaopeng140@huawei.com> # message auto-generated for no-merge-commit merge: !324 merge A5_mouth into master A5文件挂载与环境变量设置 Created-by: weixin_63825906 Commit-by: weixin_63825906 Merged-by: towncharlie Description: ## **1. 合入背景** >A5存在较多额外环境配置，要写入启动脚本以减少手动修改的操作 Fixes [#205](https://gitcode.com/Ascend/MindIE-PyMotor/issues/205) ## **2. 修改内容** > 在A5环境下，新增pod挂载路径以及环境变量，以确保服务正常运行 ## **3. 资料变更** > 不涉及 ## **4. 接口变更** > 不涉及 ## **5. 测试结果** > A5 服务拉起后正常推理  ## **6. CheckList** > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] [ ] 代码注释完备 [ ] 正确记录维测日志 [ ] 是否有UT用例 [ ] 若涉及多线程场景，考虑了并发场景，不存在死锁问题 See merge request: Ascend/MindIE-PyMotor!324 | 5 小时前 | |
docs: 重构 docs/zh 文档目录结构，统一分类体系 Co-authored-by: 吕有辉<lvyouhui@huawei.com> # message auto-generated for no-merge-commit merge: !263 merge pcp_cross_node into master docs: 重构 docs/zh 文档目录结构，统一分类体系 Created-by: codeDogPro Commit-by: 吕有辉 Merged-by: towncharlie Description: ## **1. 合入背景** https://gitcode.com/Ascend/MindIE-PyMotor/issues/173 ## 背景 docs/zh/ 下文档日渐增多但缺乏统一分类体系，主要问题： 1. **developer_guide/ 三类内容混在一起**：设计文档、用户部署指南（docker-only）、贡献工具（build_docs）混放 2. **features/ (顶层) 和 user_guide/features/ 同名异义**：前者是设计概念说明，后者是特性部署操作指南，读者容易混淆 3. **features/ (顶层) 与 developer_guide/ 中的设计文档内容性质相同**，却分散在两处 4. **user_guide/ 顶层 13 个 md 文件平铺**，缺少二级分类 ## 方案 将 docs/zh/ 重构为 **5 个一级板块**，每个板块有唯一受众和内容定位： docs/zh/ ├── index.md # 首页 ├── architecture.md # 架构概览 ├── release_note.md # 版本说明 │ ├── user_guide/ # 【用户手册】 │ ├── quick_start.md # 快速开始 │ ├── environment_preparation.md # 环境准备 │ ├── deployment/ # 部署 │ │ ├── k8s/ │ │ │ ├── deploy_mode_guide.md # K8s · 部署模式说明 │ │ │ ├── pd_disaggregation_deployment.md # K8s · PD 分离部署 │ │ │ ├── pd_hybrid_deployment.md # K8s · PD 混部部署 │ │ │ ├── config_reference.md # K8s · 配置参考 │ │ │ └── update_config_whitelist.md # K8s · 更新配置白名单 │ │ └── docker/ │ │ ├── single_container.md # Docker · 单容器部署 │ │ └── multi_container.md # Docker · 多容器部署 │ ├── features/ # 特性指南 │ │ ├── EPD_disaggregation.md # EPD 分离 │ │ ├── KV_cache_affinity.md # KV Cache 亲和 │ │ ├── KV_pool.md # KV Pool │ │ ├── manual_instance_scaling.md # 手动扩缩容 │ │ ├── standby.md # 主备倒换 │ │ └── tracing.md # 链路追踪 │ ├── operations/ │ │ ├── log_config_guide.md # 日志配置 │ │ └── cli_to_engine_config_guide.md # 命令行转换工具 │ └── troubleshooting/ # 故障排查 │ └── solutions_to_common_problems.md │ ├── design/ # 【特性设计文档】 │ ├── pd_disaggregation.md # PD 分离 │ ├── fault_tolerance/ # 可靠性 │ │ ├── overview.md # 能力总览 │ │ ├── scale_p2d.md # ScaleP2D 故障恢复 │ │ └── fault_manager.md # FaultManager 设计 │ ├── manual_scaling.md # 手动扩缩容 │ ├── crd_deployment.md # CRD 部署设计 │ └── metrics.md # Metrics 可观测性 │ ├── developer_guide/ # 【开发者指南】 │ ├── build_docs.md # 本地构建文档 │ ├── make_image.md # 镜像制作 │ └── components/ # 组件实现设计 │ ├── controller.md │ ├── coordinator.md │ ├── engine_server.md │ └── node_manager.md │ └── api_reference/ # 【API 参考】 ├── interface_description.md # 接口说明 ├── service_interface.md # 服务接口 ├── management_and_monitoring_interfaces.md # 管理与监控接口 └── observability_interface.md # Observability 接口 ### 核心设计原则 | 板块 | 受众 | 判断标准 | |------|------|---------| | user_guide/ | 使用者 | "我要部署/配置/排查某个东西" | | design/ | 深度用户/二次开发者 | "我要理解某个特性/模块怎么设计的" | | developer_guide/ | 本项目贡献者 | "我要构建/修改这个项目本身" | | api_reference/ | 调用方 | "我要查这个接口的参数和返回值" | ### 具体变更 | # | 操作 | 说明 | |---|------|------| | 1 | features/(顶层) → design/ | 合并 PD分离、可靠性、ScaleP2D | | 2 | developer_guide/ 中设计文档 → design/ | FaultManager、手动扩缩容、CRD、Metrics | | 3 | developer_guide/docker_only/ → user_guide/docker/ | 本质是用户部署指南，非开发者文档 | | 4 | user_guide/ 平铺文件 → 二级目录 | deployment/ features/ operations/ troubleshooting/ | | 5 | user_guide/solutions_to_common_problems.md → troubleshooting/ | 为未来拆分为多文件留空间 | | 6 | 更新 .nav.yaml | 补全 release_note、observability_interface；移除不存在的文件 | | 7 | 修复 ~30 处失效相对链接 | service_deployment→deployment, features/→design/ 等 | ## **2. 修改内容** > 请<ins>**描述修改内容的具体实现**</ins>，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列。 > 如果是需求或者重构类的PR，需要<ins>**补充详细设计文档**</ins>（说明上下游组件关系、时序图、类图、DFX能力等内容）。 ## **3. 资料变更** 涉及 ## **4. 接口变更** 不涉及 ## **5. 测试结果**   ## **6. CheckList** > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] [ ] 代码注释完备 [ ] 正确记录维测日志 [ ] 是否有UT用例 [ ] 若涉及多线程场景，考虑了并发场景，不存在死锁问题 See merge request: Ascend/MindIE-PyMotor!263 | 8 天前 | |
docs: 重构 docs/zh 文档目录结构，统一分类体系 Co-authored-by: 吕有辉<lvyouhui@huawei.com> # message auto-generated for no-merge-commit merge: !263 merge pcp_cross_node into master docs: 重构 docs/zh 文档目录结构，统一分类体系 Created-by: codeDogPro Commit-by: 吕有辉 Merged-by: towncharlie Description: ## **1. 合入背景** https://gitcode.com/Ascend/MindIE-PyMotor/issues/173 ## 背景 docs/zh/ 下文档日渐增多但缺乏统一分类体系，主要问题： 1. **developer_guide/ 三类内容混在一起**：设计文档、用户部署指南（docker-only）、贡献工具（build_docs）混放 2. **features/ (顶层) 和 user_guide/features/ 同名异义**：前者是设计概念说明，后者是特性部署操作指南，读者容易混淆 3. **features/ (顶层) 与 developer_guide/ 中的设计文档内容性质相同**，却分散在两处 4. **user_guide/ 顶层 13 个 md 文件平铺**，缺少二级分类 ## 方案 将 docs/zh/ 重构为 **5 个一级板块**，每个板块有唯一受众和内容定位： docs/zh/ ├── index.md # 首页 ├── architecture.md # 架构概览 ├── release_note.md # 版本说明 │ ├── user_guide/ # 【用户手册】 │ ├── quick_start.md # 快速开始 │ ├── environment_preparation.md # 环境准备 │ ├── deployment/ # 部署 │ │ ├── k8s/ │ │ │ ├── deploy_mode_guide.md # K8s · 部署模式说明 │ │ │ ├── pd_disaggregation_deployment.md # K8s · PD 分离部署 │ │ │ ├── pd_hybrid_deployment.md # K8s · PD 混部部署 │ │ │ ├── config_reference.md # K8s · 配置参考 │ │ │ └── update_config_whitelist.md # K8s · 更新配置白名单 │ │ └── docker/ │ │ ├── single_container.md # Docker · 单容器部署 │ │ └── multi_container.md # Docker · 多容器部署 │ ├── features/ # 特性指南 │ │ ├── EPD_disaggregation.md # EPD 分离 │ │ ├── KV_cache_affinity.md # KV Cache 亲和 │ │ ├── KV_pool.md # KV Pool │ │ ├── manual_instance_scaling.md # 手动扩缩容 │ │ ├── standby.md # 主备倒换 │ │ └── tracing.md # 链路追踪 │ ├── operations/ │ │ ├── log_config_guide.md # 日志配置 │ │ └── cli_to_engine_config_guide.md # 命令行转换工具 │ └── troubleshooting/ # 故障排查 │ └── solutions_to_common_problems.md │ ├── design/ # 【特性设计文档】 │ ├── pd_disaggregation.md # PD 分离 │ ├── fault_tolerance/ # 可靠性 │ │ ├── overview.md # 能力总览 │ │ ├── scale_p2d.md # ScaleP2D 故障恢复 │ │ └── fault_manager.md # FaultManager 设计 │ ├── manual_scaling.md # 手动扩缩容 │ ├── crd_deployment.md # CRD 部署设计 │ └── metrics.md # Metrics 可观测性 │ ├── developer_guide/ # 【开发者指南】 │ ├── build_docs.md # 本地构建文档 │ ├── make_image.md # 镜像制作 │ └── components/ # 组件实现设计 │ ├── controller.md │ ├── coordinator.md │ ├── engine_server.md │ └── node_manager.md │ └── api_reference/ # 【API 参考】 ├── interface_description.md # 接口说明 ├── service_interface.md # 服务接口 ├── management_and_monitoring_interfaces.md # 管理与监控接口 └── observability_interface.md # Observability 接口 ### 核心设计原则 | 板块 | 受众 | 判断标准 | |------|------|---------| | user_guide/ | 使用者 | "我要部署/配置/排查某个东西" | | design/ | 深度用户/二次开发者 | "我要理解某个特性/模块怎么设计的" | | developer_guide/ | 本项目贡献者 | "我要构建/修改这个项目本身" | | api_reference/ | 调用方 | "我要查这个接口的参数和返回值" | ### 具体变更 | # | 操作 | 说明 | |---|------|------| | 1 | features/(顶层) → design/ | 合并 PD分离、可靠性、ScaleP2D | | 2 | developer_guide/ 中设计文档 → design/ | FaultManager、手动扩缩容、CRD、Metrics | | 3 | developer_guide/docker_only/ → user_guide/docker/ | 本质是用户部署指南，非开发者文档 | | 4 | user_guide/ 平铺文件 → 二级目录 | deployment/ features/ operations/ troubleshooting/ | | 5 | user_guide/solutions_to_common_problems.md → troubleshooting/ | 为未来拆分为多文件留空间 | | 6 | 更新 .nav.yaml | 补全 release_note、observability_interface；移除不存在的文件 | | 7 | 修复 ~30 处失效相对链接 | service_deployment→deployment, features/→design/ 等 | ## **2. 修改内容** > 请<ins>**描述修改内容的具体实现**</ins>，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列。 > 如果是需求或者重构类的PR，需要<ins>**补充详细设计文档**</ins>（说明上下游组件关系、时序图、类图、DFX能力等内容）。 ## **3. 资料变更** 涉及 ## **4. 接口变更** 不涉及 ## **5. 测试结果**   ## **6. CheckList** > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] [ ] 代码注释完备 [ ] 正确记录维测日志 [ ] 是否有UT用例 [ ] 若涉及多线程场景，考虑了并发场景，不存在死锁问题 See merge request: Ascend/MindIE-PyMotor!263 | 8 天前 | |
docs: 重构 docs/zh 文档目录结构，统一分类体系 Co-authored-by: 吕有辉<lvyouhui@huawei.com> # message auto-generated for no-merge-commit merge: !263 merge pcp_cross_node into master docs: 重构 docs/zh 文档目录结构，统一分类体系 Created-by: codeDogPro Commit-by: 吕有辉 Merged-by: towncharlie Description: ## **1. 合入背景** https://gitcode.com/Ascend/MindIE-PyMotor/issues/173 ## 背景 docs/zh/ 下文档日渐增多但缺乏统一分类体系，主要问题： 1. **developer_guide/ 三类内容混在一起**：设计文档、用户部署指南（docker-only）、贡献工具（build_docs）混放 2. **features/ (顶层) 和 user_guide/features/ 同名异义**：前者是设计概念说明，后者是特性部署操作指南，读者容易混淆 3. **features/ (顶层) 与 developer_guide/ 中的设计文档内容性质相同**，却分散在两处 4. **user_guide/ 顶层 13 个 md 文件平铺**，缺少二级分类 ## 方案 将 docs/zh/ 重构为 **5 个一级板块**，每个板块有唯一受众和内容定位： docs/zh/ ├── index.md # 首页 ├── architecture.md # 架构概览 ├── release_note.md # 版本说明 │ ├── user_guide/ # 【用户手册】 │ ├── quick_start.md # 快速开始 │ ├── environment_preparation.md # 环境准备 │ ├── deployment/ # 部署 │ │ ├── k8s/ │ │ │ ├── deploy_mode_guide.md # K8s · 部署模式说明 │ │ │ ├── pd_disaggregation_deployment.md # K8s · PD 分离部署 │ │ │ ├── pd_hybrid_deployment.md # K8s · PD 混部部署 │ │ │ ├── config_reference.md # K8s · 配置参考 │ │ │ └── update_config_whitelist.md # K8s · 更新配置白名单 │ │ └── docker/ │ │ ├── single_container.md # Docker · 单容器部署 │ │ └── multi_container.md # Docker · 多容器部署 │ ├── features/ # 特性指南 │ │ ├── EPD_disaggregation.md # EPD 分离 │ │ ├── KV_cache_affinity.md # KV Cache 亲和 │ │ ├── KV_pool.md # KV Pool │ │ ├── manual_instance_scaling.md # 手动扩缩容 │ │ ├── standby.md # 主备倒换 │ │ └── tracing.md # 链路追踪 │ ├── operations/ │ │ ├── log_config_guide.md # 日志配置 │ │ └── cli_to_engine_config_guide.md # 命令行转换工具 │ └── troubleshooting/ # 故障排查 │ └── solutions_to_common_problems.md │ ├── design/ # 【特性设计文档】 │ ├── pd_disaggregation.md # PD 分离 │ ├── fault_tolerance/ # 可靠性 │ │ ├── overview.md # 能力总览 │ │ ├── scale_p2d.md # ScaleP2D 故障恢复 │ │ └── fault_manager.md # FaultManager 设计 │ ├── manual_scaling.md # 手动扩缩容 │ ├── crd_deployment.md # CRD 部署设计 │ └── metrics.md # Metrics 可观测性 │ ├── developer_guide/ # 【开发者指南】 │ ├── build_docs.md # 本地构建文档 │ ├── make_image.md # 镜像制作 │ └── components/ # 组件实现设计 │ ├── controller.md │ ├── coordinator.md │ ├── engine_server.md │ └── node_manager.md │ └── api_reference/ # 【API 参考】 ├── interface_description.md # 接口说明 ├── service_interface.md # 服务接口 ├── management_and_monitoring_interfaces.md # 管理与监控接口 └── observability_interface.md # Observability 接口 ### 核心设计原则 | 板块 | 受众 | 判断标准 | |------|------|---------| | user_guide/ | 使用者 | "我要部署/配置/排查某个东西" | | design/ | 深度用户/二次开发者 | "我要理解某个特性/模块怎么设计的" | | developer_guide/ | 本项目贡献者 | "我要构建/修改这个项目本身" | | api_reference/ | 调用方 | "我要查这个接口的参数和返回值" | ### 具体变更 | # | 操作 | 说明 | |---|------|------| | 1 | features/(顶层) → design/ | 合并 PD分离、可靠性、ScaleP2D | | 2 | developer_guide/ 中设计文档 → design/ | FaultManager、手动扩缩容、CRD、Metrics | | 3 | developer_guide/docker_only/ → user_guide/docker/ | 本质是用户部署指南，非开发者文档 | | 4 | user_guide/ 平铺文件 → 二级目录 | deployment/ features/ operations/ troubleshooting/ | | 5 | user_guide/solutions_to_common_problems.md → troubleshooting/ | 为未来拆分为多文件留空间 | | 6 | 更新 .nav.yaml | 补全 release_note、observability_interface；移除不存在的文件 | | 7 | 修复 ~30 处失效相对链接 | service_deployment→deployment, features/→design/ 等 | ## **2. 修改内容** > 请<ins>**描述修改内容的具体实现**</ins>，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列。 > 如果是需求或者重构类的PR，需要<ins>**补充详细设计文档**</ins>（说明上下游组件关系、时序图、类图、DFX能力等内容）。 ## **3. 资料变更** 涉及 ## **4. 接口变更** 不涉及 ## **5. 测试结果**   ## **6. CheckList** > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] [ ] 代码注释完备 [ ] 正确记录维测日志 [ ] 是否有UT用例 [ ] 若涉及多线程场景，考虑了并发场景，不存在死锁问题 See merge request: Ascend/MindIE-PyMotor!263 | 8 天前 | |
[资料]k8s安装指导优化，新增step by step安装指导 Co-authored-by: weixin_63825906<gaopeng140@huawei.com> # message auto-generated for no-merge-commit merge: !299 merge ziliao3 into master [资料]k8s安装指导优化，新增step by step安装指导 Created-by: weixin_63825906 Commit-by: weixin_63825906 Merged-by: towncharlie Description: ## **1. 合入背景** > 当前motor强依赖k8s和mindcluster软件环境，但环境部署操作步骤较为复杂，本PR优化了k8s的安装流程，并提供了自动化部署脚本，提高环境部署效率 > 注意： Fixes #ISSUE ID会自动关闭issue，如问题部分解决请不要使用Fixes，可以用Fix part of #ISSUE ID替代. Fixes [#182](https://gitcode.com/Ascend/MindIE-PyMotor/issues/182) ## **2. 修改内容** > 优化k8s的安装流程，并提供自动化部署脚本，提高环境部署效率 ## **3. 资料变更** > 涉及 ## **4. 接口变更** > 不涉及 ## **5. 测试结果**  ## **6. CheckList** > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] [ ] 代码注释完备 [ ] 正确记录维测日志 [ ] 是否有UT用例 [ ] 若涉及多线程场景，考虑了并发场景，不存在死锁问题 See merge request: Ascend/MindIE-PyMotor!299 | 8 天前 | |
文档修正（修改文档：environment_preparation.md 修改内容：ascend docker runtime需要在所有节点安装、且安装指导不应局限于Containerd场景） Co-authored-by: weixin_63825906<gaopeng140@huawei.com> # message auto-generated for no-merge-commit merge: !307 merge ziliao4 into master 文档修正（修改文档：environment_preparation.md 修改内容：ascend docker runtime需要在所有节点安装、且安装指导不应局限于Containerd场景） Created-by: weixin_63825906 Commit-by: weixin_63825906 Merged-by: towncharlie Description: ## **1. 合入背景** > docker runtime 必须全部节点安装，当前文档内容需要 Fixes [#186](https://gitcode.com/Ascend/MindIE-PyMotor/issues/186) ## **2. 修改内容** > 请<ins>**描述修改内容的具体实现**</ins>，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列。 > 如果是需求或者重构类的PR，需要<ins>**补充详细设计文档**</ins>（说明上下游组件关系、时序图、类图、DFX能力等内容）。 ## **3. 资料变更** > 请确认<ins>**是否涉及资料变更**</ins>。\ > 如涉及，需要在PR中体现，并简要说明修改内容。\ > 如不涉及，需填写“不涉及”。 ## **4. 接口变更** > 请确认<ins>**是否涉及跨代码仓或者客户面可见的接口变更**</ins>。\ > 如涉及，需详细说明接口以及对应的变更内容，同时需要在资料中体现。\ > 如不涉及，需填写“不涉及”。 ## **5. 测试结果** > 需体现<ins>**测试场景，测试方法以及测试结果**</ins>。\ > 测试用例设计时需考虑硬件、部署方式、功能、性能、精度、显存等维度。 ## **6. CheckList** > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] [ ] 代码注释完备 [ ] 正确记录维测日志 [ ] 是否有UT用例 [ ] 若涉及多线程场景，考虑了并发场景，不存在死锁问题 See merge request: Ascend/MindIE-PyMotor!307 | 1 天前 | |
docs: 重构 docs/zh 文档目录结构，统一分类体系 Co-authored-by: 吕有辉<lvyouhui@huawei.com> # message auto-generated for no-merge-commit merge: !263 merge pcp_cross_node into master docs: 重构 docs/zh 文档目录结构，统一分类体系 Created-by: codeDogPro Commit-by: 吕有辉 Merged-by: towncharlie Description: ## **1. 合入背景** https://gitcode.com/Ascend/MindIE-PyMotor/issues/173 ## 背景 docs/zh/ 下文档日渐增多但缺乏统一分类体系，主要问题： 1. **developer_guide/ 三类内容混在一起**：设计文档、用户部署指南（docker-only）、贡献工具（build_docs）混放 2. **features/ (顶层) 和 user_guide/features/ 同名异义**：前者是设计概念说明，后者是特性部署操作指南，读者容易混淆 3. **features/ (顶层) 与 developer_guide/ 中的设计文档内容性质相同**，却分散在两处 4. **user_guide/ 顶层 13 个 md 文件平铺**，缺少二级分类 ## 方案 将 docs/zh/ 重构为 **5 个一级板块**，每个板块有唯一受众和内容定位： docs/zh/ ├── index.md # 首页 ├── architecture.md # 架构概览 ├── release_note.md # 版本说明 │ ├── user_guide/ # 【用户手册】 │ ├── quick_start.md # 快速开始 │ ├── environment_preparation.md # 环境准备 │ ├── deployment/ # 部署 │ │ ├── k8s/ │ │ │ ├── deploy_mode_guide.md # K8s · 部署模式说明 │ │ │ ├── pd_disaggregation_deployment.md # K8s · PD 分离部署 │ │ │ ├── pd_hybrid_deployment.md # K8s · PD 混部部署 │ │ │ ├── config_reference.md # K8s · 配置参考 │ │ │ └── update_config_whitelist.md # K8s · 更新配置白名单 │ │ └── docker/ │ │ ├── single_container.md # Docker · 单容器部署 │ │ └── multi_container.md # Docker · 多容器部署 │ ├── features/ # 特性指南 │ │ ├── EPD_disaggregation.md # EPD 分离 │ │ ├── KV_cache_affinity.md # KV Cache 亲和 │ │ ├── KV_pool.md # KV Pool │ │ ├── manual_instance_scaling.md # 手动扩缩容 │ │ ├── standby.md # 主备倒换 │ │ └── tracing.md # 链路追踪 │ ├── operations/ │ │ ├── log_config_guide.md # 日志配置 │ │ └── cli_to_engine_config_guide.md # 命令行转换工具 │ └── troubleshooting/ # 故障排查 │ └── solutions_to_common_problems.md │ ├── design/ # 【特性设计文档】 │ ├── pd_disaggregation.md # PD 分离 │ ├── fault_tolerance/ # 可靠性 │ │ ├── overview.md # 能力总览 │ │ ├── scale_p2d.md # ScaleP2D 故障恢复 │ │ └── fault_manager.md # FaultManager 设计 │ ├── manual_scaling.md # 手动扩缩容 │ ├── crd_deployment.md # CRD 部署设计 │ └── metrics.md # Metrics 可观测性 │ ├── developer_guide/ # 【开发者指南】 │ ├── build_docs.md # 本地构建文档 │ ├── make_image.md # 镜像制作 │ └── components/ # 组件实现设计 │ ├── controller.md │ ├── coordinator.md │ ├── engine_server.md │ └── node_manager.md │ └── api_reference/ # 【API 参考】 ├── interface_description.md # 接口说明 ├── service_interface.md # 服务接口 ├── management_and_monitoring_interfaces.md # 管理与监控接口 └── observability_interface.md # Observability 接口 ### 核心设计原则 | 板块 | 受众 | 判断标准 | |------|------|---------| | user_guide/ | 使用者 | "我要部署/配置/排查某个东西" | | design/ | 深度用户/二次开发者 | "我要理解某个特性/模块怎么设计的" | | developer_guide/ | 本项目贡献者 | "我要构建/修改这个项目本身" | | api_reference/ | 调用方 | "我要查这个接口的参数和返回值" | ### 具体变更 | # | 操作 | 说明 | |---|------|------| | 1 | features/(顶层) → design/ | 合并 PD分离、可靠性、ScaleP2D | | 2 | developer_guide/ 中设计文档 → design/ | FaultManager、手动扩缩容、CRD、Metrics | | 3 | developer_guide/docker_only/ → user_guide/docker/ | 本质是用户部署指南，非开发者文档 | | 4 | user_guide/ 平铺文件 → 二级目录 | deployment/ features/ operations/ troubleshooting/ | | 5 | user_guide/solutions_to_common_problems.md → troubleshooting/ | 为未来拆分为多文件留空间 | | 6 | 更新 .nav.yaml | 补全 release_note、observability_interface；移除不存在的文件 | | 7 | 修复 ~30 处失效相对链接 | service_deployment→deployment, features/→design/ 等 | ## **2. 修改内容** > 请<ins>**描述修改内容的具体实现**</ins>，涉及哪些组件之间进行交互，可以用1、2、3、...进行罗列。 > 如果是需求或者重构类的PR，需要<ins>**补充详细设计文档**</ins>（说明上下游组件关系、时序图、类图、DFX能力等内容）。 ## **3. 资料变更** 涉及 ## **4. 接口变更** 不涉及 ## **5. 测试结果**   ## **6. CheckList** > PR提交人对以下CheckList自检项进行全量自检，自检通过或不涉及，均修改 [ ] 为 [x] [ ] 代码注释完备 [ ] 正确记录维测日志 [ ] 是否有UT用例 [ ] 若涉及多线程场景，考虑了并发场景，不存在死锁问题 See merge request: Ascend/MindIE-PyMotor!263 | 8 天前 |
简介
Motor提供一键式 PD 分离与 PD 混部部署，基于云原生插件化架构灵活适配多种推理引擎（vLLM、SGLang），结合高性能调度与负载均衡能力，构建高可用、可扩展的大规模推理服务。
快速开始
环境准备：安装前的相关软硬件环境准备，以及安装步骤，请参见环境准备。
快速部署：快速体验启动服务、接口调用、精度&性能测试和停止服务全流程，请参见快速部署。
最佳实践：PD 分离部署请参见PD 分离服务部署详细指导，PD 混部部署请参见PD 混部服务部署详细指导。