用途：在当前仓库安装或升级 MegaLinter，用于搭建代码检查 CI。核心原则是始终用 npx mega-linter-runner 生成或升级配置，不要手写 .mega-linter.yml 或 CI 工作流，只在生成后做微调。
主要能力与用法：先分析仓库，确定 flavor（如 python、javascript、java、go、terraform、security 等，混合或不明用 all）、CI 系统（依据 .github/、.gitlab-ci.yml、azure-pipelines.yml、bitbucket-pipelines.yml、Jenkinsfile、.drone.yml 等判断）和默认分支。无配置时非交互安装：npx mega-linter-runner --install --no-prompt --flavor <flavor> --setup-ci <ci> --setup-default-branch <branch> --fix；若报 Invalid option，改用 npx mega-linter-runner@latest。已有配置则升级：npx mega-linter-runner --upgrade --no-prompt。升级后必须把 Docker 镜像引用改为 ghcr.io/ 前缀（v9.5.0 起仅发布到 GitHub Container Registry），但不动 GitHub Action 引用和文档 URL。安装会备份冲突文件为 <file>.megalinter-setup.bak，需对比并重新应用用户定制后删除备份。
其他：可刷新 MegaLinter 技能与三个子代理（megalinter-watcher、megalinter-runner、megalinter-fixer），插件方式安装则更新插件而非技能。可选接入 Grafana、Datadog、Elastic、New Relic 可观测性仪表盘，用 npx mega-linter-runner --upload-dashboards <provider> 配置。
限制：本地运行基于 Docker、首次需下载数 GB 镜像，较耗资源，通常推荐在 CI 中运行；未经用户确认不得提交或推送，且不得推送到默认分支。自定义 flavor 仓库需另按 custom-flavor.md 处理。