用途:pp-forgejo 是驱动 forgejo-pp-cli 二进制的命令行技能,为任意 Forgejo/Codeberg 实例提供类似 GitHub CLI 的操作体验。适合在命令行中跨多个仓库和主机分诊 issue、管理 PR 与 release、监控 CI 与 runner,或编写发布流水线脚本,尤其适合自建 Forgejo 的团队。
主要能力:多主机 OAuth2 设备流认证;本地 SQLite 离线可搜索;跨仓库仪表盘。特色命令包括 issue dashboard(跨仓库/主机汇总待办 issue)、notification inbox(多实例通知收件箱)、issue sweep(清理长期无活动 issue,支持 --dry-run)、pr queue(汇总待你评审的 PR)、runner sweep(查看所有组织的 Actions runner 状态)、ci status(各仓库最新 CI 状态)、release changelog(按标签分组生成变更日志)、release upload(带进度、重试与大小校验上传发布资产)。还提供 activitypub、admin、notifications、orgs、packages、repos、teams、user 等分组命令,涵盖用户、组织、仓库、配额、runner、密钥等管理。
使用方式:先安装 CLI,安装后需验证二进制可用,未通过验证不要继续执行技能命令。 安装:npx -y @mvanhorn/printing-press-library install forgejo --cli-only 验证:forgejo-pp-cli --version 若 npx 安装失败(无 Node 或离线),可回退到 Go 直接安装(需 Go 1.26.6 或更新): go install github.com/mvanhorn/printing-press-library/library/developer-tools/forgejo/cmd/forgejo-pp-cli@latest 需确保 $GOPATH/bin(或 $HOME/go/bin)在 $PATH 中。
限制:若 --version 报“command not found”,说明二进制未加入 $PATH,此时不应继续执行。文档未提供具体收费、价格或性能数据;部分 admin 命令(如 get-registration-token、get-runner-registration-token、search-run-jobs)在 Forgejo 15 中已弃用。