用途:pp-github 驱动 github-pp-cli 二进制,将 GitHub 协作核心数据(issue、PR、提交、分支、内容、标签、发布、搜索)同步到本地 SQLite,之后可离线查询,并支持在线 API 难以一次表达的跨实体关联。
主要能力:离线全文搜索与跨实体关联,如 issues dupes 查找重复 issue、mentions 跨 issue/PR/评论/提交检索符号、issues context 汇总某 issue 的评论与相关提交;发布与评审操作,如 pulls review-load 统计评审积压、pulls stale 列出长期无活动的 PR、repos changelog 按作者分组生成变更日志;仓库情报,如 repos who-touched 按路径统计提交者、labels coverage 统计标签覆盖。
使用方式:先安装 CLI,npx -y @mvanhorn/printing-press-library install github --cli-only,验证 github-pp-cli --version;若 npx 失败可用 go install github.com/mvanhorn/printing-press-library/library/developer-tools/github/cmd/github-pp-cli@latest。同步需指定仓库:github-pp-cli sync --repo cli/cli。认证通过 GITHUB_TOKEN 或 GH_TOKEN 设置个人访问令牌。可用 github-pp-cli which "<能力描述>" 查找命令。
适用场景:需要反复或离线查询 issue、PR、提交与代码搜索;需要跨实体答案(符号在 issue+PR+提交中的出现、按评审人统计积压、文件归属);智能体需一次读取某 issue 的完整工作集。
限制:不适用于 GitHub Actions、工作流运行或 CI 状态;不适用于组织、团队或企业管理;不适用于 clone、push、rebase 等 git 操作;不适用于通知、gist 或市场。安装后若 --version 报 command not found,需将二进制目录加入 PATH 后再使用。其余细节暂未提供。