服务化参数自动寻优部署

工作范围

本 skill 负责将工具装好并验证能用。

其他内容由对应 skill 负责：

• 运行环境检查：msmodeling-env-installer
• 首次参数范围推荐与 config.toml 配置：msmodeling-optix-param-recommend

支持的硬件产品

寻优工具仅支持以下昇腾推理产品：

产品类型	是否支持
Atlas A3系列产品	√
Atlas A2系列产品	√
Atlas 200I/500 A2推理产品	√
Atlas 200/300/500推理产品	√
Atlas训练系列产品	x

• 目标运行环境不支持 Windows
• 昇腾的训练系列产品不支持，请确认使用的是推理系列产品

安装流程

用户说"安装""部署"时，直接执行以下步骤，不要只给命令。

0. 默认使用阿里云 PyPI 镜像

为减少安装等待时间，默认优先使用阿里云镜像：

https://mirrors.aliyun.com/pypi/simple/

注意：不要写成 PYPI_MIRROR=... python -m pip install -i "$PYPI_MIRROR" ...。 这种写法里 "$PYPI_MIRROR" 会在临时环境变量生效前被 shell 展开，结果可能变成空字符串，导致 pip 实际拿到空的 index URL。

优先直接把镜像地址写进 -i 参数；如果确实要用环境变量，必须先单独 export，再在后续命令里使用。

若用户已有公司内网镜像、离线源或明确指定其他源，则尊重用户配置，不强制改成阿里云镜像。

1. 检查仓库是否存在

寻优工具已集成在 msmodeling 项目中。检查安装入口与默认配置：

ls pyproject.toml optix/config.toml

若仓库不存在，直接克隆：

git clone https://gitcode.com/Ascend/msmodeling.git
cd msmodeling

2. 判断当前目录和安装方式

msmodeling 仓库结构：

msmodeling/                  ← 仓库根目录
├── pyproject.toml           ← optix 安装入口
└── optix/
    ├── config.toml          ← 寻优工具默认配置
    └── ...                  ← 寻优工具源码（optimizer 代码等）

安装时不要依赖上一次 shell 的 cd 状态。应优先使用单条命令，把切目录和安装写在一起，避免误在其他目录执行 pip install -e .。

推荐安装命令如下：

cd msmodeling && python -m pip install -i https://mirrors.aliyun.com/pypi/simple/ -e .

若用户明确要求使用其他镜像，把上面的 URL 替换成用户指定源即可。

注意：当前仓库中 msmodeling CLI 由仓库根目录的 pyproject.toml 提供，安装时应进入 msmodeling/ 仓库根目录，而不是在 optix/ 子目录或其他位置执行 pip install -e .。

3. 验证

msmodeling optix --help

4. 汇报结果

告诉用户安装是否成功。若失败，给出具体缺失项和修复建议；并给下一步建议：运行环境检查、配置 config.toml 或开始参数推荐。

卸载

卸载前说明会移除 Python 包，征得同意后执行：

python -m pip uninstall optix

要求

• 始终中文回答。
• 用户同意安装后，要实际检查路径、执行安装并验证 CLI，不要只给命令。
• 不要把运行、配置、结果解读内容塞进本 skill；交给专项 skill 或文档。
• 涉及会创建目录、安装依赖、卸载包的动作，先说明影响并征得用户同意。