用途:帮助用户把 SaaS Pegasus 代码库升级到最新版本,通过项目 Python 环境中的 pegasus 命令行工具触发升级流程。
主要能力与用法:先列出用户项目并找到正确的项目,可用 pegasus projects list,再将项目名与 pegasus-config.yaml 中定义的内容对比以确定项目 id。如需要,先通过 CLI 认证(pegasus auth)。升级前确保 main 分支是最新的:运行 git checkout main && git pull,因为合并是针对 main 进行的,必须包含最新改动。推送时使用非交互式参数以避免需要 stdin 的交互提示:升级到最新稳定版用 pegasus projects push <project_id> --upgrade;升级到最新 dev 版用 pegasus projects push <project_id> --dev。务必传入 --upgrade 或 --dev,否则 CLI 会显示在非交互环境中无法正常工作的交互菜单。若用户未指定稳定版还是 dev 版,默认使用 --upgrade(稳定版)。如用户要求特定 PR 标题,可通过 --pr-title 传入,例如 pegasus projects push <project_id> --upgrade --pr-title "Your custom title";若未提及标题则省略该参数,由服务器根据版本生成合理默认值。
推送完成后:运行 git fetch origin 查看新分支,分支名格式为 pegasus-<version>-<timestamp>(例如 pegasus-2026.2.1.3-1771252378.779356);用 git checkout <branch-name> 切换到该分支(推送后它已是最新);再使用“resolve pegasus conflicts”技能把用户默认分支(通常为 main)合并到升级分支中,该技能负责合并后的验证与推送流程。
限制:资料未提供支持的操作系统、依赖版本、失败处理或回滚细节。