| name | msmodeling-optix-deploy |
| description | 当用户需要部署 msmodeling optix 服务化自动寻优工具时使用。负责安装与验证。 |
| version | 0.1.0 |
| source | local-session-analysis |
服务化参数自动寻优部署
工作范围
本 skill 负责将工具装好并验证能用。
其他内容由对应 skill 负责:
- 运行环境检查:
msmodeling-env-installer
- 首次参数范围推荐与
config.toml 配置:msmodeling-optix-param-recommend
支持的硬件产品
寻优工具仅支持以下昇腾推理产品:
| 产品类型 | 是否支持 |
|---|
| Atlas A3 训练系列产品/Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品/Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | x |
- 目标运行环境不支持 Windows
- Atlas 训练系列产品不支持,请确认使用的是推理系列产品
安装流程
用户说"安装""部署"时,直接执行以下步骤,不要只给命令。
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 或文档。
- 涉及会创建目录、安装依赖、卸载包的动作,先说明影响并征得用户同意。