关于 moviepilot-update
用于通过内置 API 管理 MoviePilot 重启和升级的技能,涵盖版本检查、分阶段准备 Release 更新,以及需确认的安装或重启操作。
主要功能
- 01检查可用版本
- 02查看更新进度
- 03准备应用和资源更新
- 04安装或重启前要求确认
适用场景
- 01查看 MoviePilot 可用版本
- 02准备稳定版 Release 更新
- 03确认后重启 MoviePilot
MCP 相关
该技能使用内置的 `moviepilot_api` 工具;主机负责固定 API 路由、身份验证、授权和确认策略。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jxxghp/ moviepilot --skill moviepilot-update安装后在 Claude Code 中输入/moviepilot-update确认已加载。
详细介绍
MoviePilot 更新
使用此技能执行 MoviePilot 重启和升级操作。
仅使用内置的 moviepilot_api 工具。主机会选择固定的 API 路由,使用可信 Agent 身份进行身份验证,并应用管理员和确认策略。绝不要请求或传递 API 令牌、URL、HTTP 方法、shell 命令或旧版辅助脚本。
操作
检查版本
{"operation_id":"system.versions","path_params":{},"query":{},"body":{}}
此只读操作会列出可用的 MoviePilot 版本。
重启 MoviePilot
{"operation_id":"system.restart","path_params":{},"query":{},"body":{}}
重启需要明确确认,并会中断当前 Agent 会话。
版本更新
检查最新的稳定版 V3 Release 并查看当前进度。手动检查可能会用较新版本替换较早准备的目标;检查失败时会保留已下载的软件包:
{"operation_id":"system.update.check","path_params":{},"query":{},"body":{}}
{"operation_id":"system.update.status","path_params":{},"query":{},"body":{}}
当 supports_batch_update=true 时,一并准备最新的后端、匹配的前端和站点资源。此操作不会重启 MoviePilot:
{"operation_id":"system.update.download","path_params":{},"query":{},"body":{"target":"all"}}
当 updates 中每个非空闲项都报告 state=ready,且没有任何项出现检查错误后,安装仍需单独明确确认:
{"operation_id":"system.update.install","path_params":{},"query":{},"body":{"target":"all"}}
install 会写入一条经过验证的安装意图,并重启 MoviePilot 一次。只有在用户明确确认重启后才能调用它。对于用户明确要求的单目标更新,请使用 target=application 或 target=resources。对于不支持 supports_batch_update 的较旧主机,继续使用单目标流程;省略目标时默认为 application。
Dev 更新与重启
{"operation_id":"system.upgrade.dev","path_params":{},"query":{},"body":"dev"}
请求正文必须是精确的 JSON 字符串 "dev"。稳定版 Release 更新必须使用检查、下载、状态查询和安装流程。
注意事项
- 所有操作都需要 MoviePilot 管理员或已验证的通知渠道管理员授权。主机负责执行授权;模型不得臆造管理员标记。
- 只有重启、Release 安装和 Dev 升级会中断当前 Agent 会话。检查和下载操作期间服务仍保持在线。
- 计划检查会保留已下载的软件包;只有在存在更高版本时,显式检查才会刷新较早准备的目标。正在进行的下载和安装会受到保护。验证匹配的暂存软件包后,先前被覆盖的资源状态可以恢复为
ready;请使用updates检查每个目标,并请求安装确认,而不要再次下载。 - 优先使用上述 API 流程。仅当 API 不可用时,才回退到手动容器命令。