moviepilot 是 MoviePilot V2 的本地安装与管理入口，适用于 macOS 和 Linux 源码部署场景。
它负责：
Windows 用户如需使用本地 CLI，建议优先在
WSL中运行；原生 Windows 仍建议使用安装版或 Docker。
curl -fsSL https://raw.githubusercontent.com/jxxghp/MoviePilot/v2/scripts/bootstrap-local.sh | bash
脚本会自动：
git、curl、Python 3.12+MoviePilotMoviePilot-Frontend 最新 releaseMoviePilot-Resources 资源文件resources.v2/* 同步到后端 app/helperNode 运行时并安装前端运行依赖moviepilot 命令如果安装完成后当前终端仍提示找不到 moviepilot：
~/.local/bin，执行 source ~/.zshrc 或 source ~/.bashrc本地 CLI 默认将配置目录放在程序目录外，避免删除程序目录时把配置一并删掉。
~/Library/Application Support/MoviePilot${XDG_CONFIG_HOME:-~/.config}/moviepilot也可以在安装时手动指定：
moviepilot setup --config-dir /path/to/moviepilot-config
查看当前实际配置目录：
moviepilot config path
moviepilot setup --wizard 或 moviepilot init --wizard 会进入本地初始化向导。
向导当前支持配置：
API_TOKENSQLitePostgreSQL，并填写主机、端口、数据库名、用户名、密码用户名、UID、Passkey 等参数AI_AGENT_ENABLELLM_PROVIDER、LLM_MODEL、LLM_API_KEY、LLM_BASE_URLmoviepilot install deps
moviepilot install frontend
moviepilot install resources
moviepilot init --wizard
moviepilot setup --wizard
说明：
install deps：创建虚拟环境并安装后端依赖install frontend：下载前端 release，并自动安装本地 Node 运行时install resources：下载 MoviePilot-Resources 并同步到 app/helperinit：初始化本地配置setup：串行执行依赖安装、前端安装、资源同步和初始化moviepilot start
moviepilot stop
moviepilot restart
moviepilot status
moviepilot logs
moviepilot logs --frontend
moviepilot logs --stdio
moviepilot version
说明：
start/stop/restart/status 统一管理本地前后端服务moviepilot start 管理起来的，本地安装模式也支持内建重启logs --frontend 查看前端启动日志logs --stdio 查看后端启动标准输出moviepilot update backend
moviepilot update frontend
moviepilot update all
常见用法：
moviepilot stop
moviepilot update all
moviepilot start
也可以指定版本：
moviepilot update backend --ref v2.9.31
moviepilot update frontend --frontend-version v2.9.31
说明：
update backend 会更新 Git 仓库并重新安装后端依赖update frontend 会更新前端 releaseupdate all 会同时更新后端、前端，并默认同步资源文件moviepilot stopmoviepilot agent 帮我分析最近一次搜索失败的原因
moviepilot agent --user-id admin 帮我检查当前下载器配置
moviepilot agent --session cli-debug-1 帮我看看为什么没有自动整理
说明：
moviepilot agent 会直接向本地 Agent 发送一次请求AI_AGENT_ENABLEmoviepilot config path
moviepilot config list
moviepilot config get PORT
moviepilot config set PORT 3001
moviepilot config keys
moviepilot config describe API_TOKEN
moviepilot tool list
moviepilot tool show query_schedulers
moviepilot tool run query_schedulers
moviepilot scheduler list
moviepilot scheduler run subscribe_refresh
根帮助：
moviepilot --help
moviepilot help
moviepilot commands
分级帮助：
moviepilot help install
moviepilot help init
moviepilot help setup
moviepilot help update
moviepilot help agent
moviepilot help config
moviepilot help config set
moviepilot help tool
moviepilot help scheduler
moviepilot install deps
moviepilot install frontend
moviepilot install resources
moviepilot init
moviepilot setup
moviepilot update backend
moviepilot update frontend
moviepilot update all
moviepilot agent
moviepilot start
moviepilot stop
moviepilot restart
moviepilot status
moviepilot logs
moviepilot version
moviepilot config path
moviepilot config list
moviepilot config get
moviepilot config set
moviepilot config keys
moviepilot config describe
moviepilot tool list
moviepilot tool show
moviepilot tool run
moviepilot scheduler list
moviepilot scheduler run
moviepilot help
moviepilot commands
MoviePilot-Resources 下载，不需要手工复制到 app/helpermoviepilot update ...