archived-MoviePilot-Plugins/plugins/docs/MAINTENANCE_COMMANDS.md

仓库维护命令索引

这份文档只列当前常用的仓库维护与发布命令，不解释历史方案。

当前状态

• 当前插件版本：AgentResourceOfficer 0.2.68
• 当前 Skill helper 版本：0.1.46
• 当前 Release：https://github.com/liuyuexi1987/MoviePilot-Plugins/releases/tag/v0.2.68

最常用入口

• 仓库卫生检查：

bash scripts/repo-hygiene.sh

• 发版前完整检查：

bash scripts/release-preflight.sh

• 低层发布检查：

bash scripts/pre-release-check.sh

推荐顺序

• 日常看状态或准备整理仓库：

bash scripts/repo-hygiene.sh

• 想清理本地生成文件或顺手删除 dist/：

bash scripts/clean-generated.sh
bash scripts/clean-generated.sh --dist

• 准备发版、打包、更新 Draft Release 之前：

bash scripts/release-preflight.sh

• 准备在 GitHub 上创建或更新 Draft Release：

bash scripts/create-draft-release.sh <tag> --dry-run

• 想确认最近一次 GitHub Actions 产物是否完整：

bash scripts/verify-release-preflight-artifact.sh

状态与审计

• 检查当前状态文档是否和代码版本一致：

python3 scripts/check-doc-current-state.py

• 审计远端和本地历史分支：

python3 scripts/audit-remote-branches.py

• 归档本地非 main 分支到 archive/* tag：

python3 scripts/archive-local-branches.py
python3 scripts/archive-local-branches.py --apply

打包与发布

• 创建 Draft Release 前 dry-run：

bash scripts/create-draft-release.sh <tag> --dry-run

• 创建 Draft Release：

bash scripts/create-draft-release.sh <tag>

• 用当前 dist/ 覆盖已有 Draft Release 附件：

bash scripts/update-draft-release-assets.sh <tag>

• 校验公开 Release 下载附件：

bash scripts/verify-release-download.sh <tag>

• 单独打包公开 Skill ZIP：

bash scripts/package-skills.sh

Artifact 与产物校验

• 下载并校验最近一次成功的 Release Preflight workflow artifact：

bash scripts/verify-release-preflight-artifact.sh
bash scripts/verify-release-preflight-artifact.sh <run_id>

• 校验本地 release 资产目录：

bash scripts/verify-release-assets.sh
bash scripts/verify-release-assets.sh /path/to/release-assets

• 校验插件 ZIP：

DIST_DIR=dist bash scripts/verify-dist.sh

• 校验 Skill ZIP：

DIST_DIR=dist/skills bash scripts/verify-skill-dist.sh

汇总输出

• 打印插件 ZIP Markdown 表格：

bash scripts/print-release-summary.sh

• 打印 Skill ZIP Markdown 表格：

bash scripts/print-skill-release-summary.sh

• 生成 Release notes：

bash scripts/generate-release-notes.sh <tag>

帮助

这些脚本现在都支持 --help 或 -h，包括：

• repo-hygiene.sh
• release-preflight.sh
• pre-release-check.sh
• check-skills.sh
• clean-generated.sh
• package-plugin.sh
• package-skills.sh
• sync-repo-layout.sh
• sync-package-v2.sh
• create-draft-release.sh
• update-draft-release-assets.sh
• generate-release-notes.sh
• write-dist-sha256.sh
• patch-p115strmhelper-mp-compat.sh
• verify-release-preflight-artifact.sh
• verify-ci-artifact.sh
• verify-release-download.sh
• verify-release-assets.sh
• verify-dist.sh
• verify-skill-dist.sh
• print-release-summary.sh
• print-skill-release-summary.sh
• check-doc-current-state.py
• audit-remote-branches.py
• archive-local-branches.py