mcpField
M
moviepilot-update

moviepilot-update

github.com/jxxghp云与 DevOps12.0k127 次安装今天更新
代码仓库

关于 moviepilot-update

用于通过内置 API 管理 MoviePilot 重启和升级的技能,涵盖版本检查、分阶段准备 Release 更新,以及需确认的安装或重启操作。

主要功能

  1. 01检查可用版本
  2. 02查看更新进度
  3. 03准备应用和资源更新
  4. 04安装或重启前要求确认

适用场景

  1. 01查看 MoviePilot 可用版本
  2. 02准备稳定版 Release 更新
  3. 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 不可用时,才回退到手动容器命令。

评论

支持 Markdown