跳转到内容
Last updated

客户端安装与启动

先检测安装状态,已安装则打开;仅在 status=not_installed 且确需安装时执行安装。检测错误、超时、JSON 非法或 detection_inconclusive 均不能视为未安装。

ml-cli client status --output-json
ml-cli client open --output-json
ml-cli client install --interactive --output-json

client open 支持 Windows、macOS、Linux。already_running 避免重复进程;launch_requested 只表示系统受理启动请求,不代表窗口出现、登录完成或 Local API 就绪,应另查 status/doctor。检测失败会在启动前停止。

macOS 普通 status 不运行 codesign/Gatekeeper,返回 integrityStatus=not_checked。严格检查使用 client status --require-integrity --output-json;失败可返回 installed_with_integrity_warning、退出 2,不能据此判断 App 不存在。已安装旧客户端不会被覆盖,安装流程可提示 nextAction=update_in_client。

Windows x64 仅在 PE、产品、Authenticode、发布者校验通过后复用安装包。macOS 每次下载全新的匹配架构 DMG;由于没有可独立使用的发布者签名/校验和,installerVerified=false、signatureStatus=null、publisher=null 是预期值,磁盘映像检查不等于发布者验证。Linux 不提供客户端下载安装,client open 可打开已有标准安装。

--interactive 仅请求系统打开已准备的安装包,不会接受许可、批准 UAC/Gatekeeper、完成安装向导、把 macOS App 复制到 Applications,也不代表安装完成。无窗口时检查返回的 installerPath,手动完成后重新运行 status。