用途：从 GitHub 仓库中取出文件而不做完整克隆，适合下载子目录（文档、数据集、模板等）并保留目录结构，或预览下载成本、校验本地副本是否与远端一致、以最小带宽保持镜像更新。公开仓库可免认证使用，每次操作最多消耗少量 API 请求。
主要能力：plan 预览将下载的文件列表、大小、总字节、API 请求成本与 LFS 指针警告；verify 按 git blob SHA 比对本地与远端（match/changed/missing/extra），无需重新下载；sync-dir 原地更新已下载目录，仅拉取变更或缺失文件；stats 单次请求给出路径的大小与文件数分布；search 在本地存储中按名称或模式搜索已抓取的仓库列表；另有 blobs、contents、rate-limit、releases、repos、tarball、trees 等命令。所有命令支持 --agent（展开为 --json --compact --no-input --no-color --yes），可用 --select 裁剪字段。
使用方式：先安装 CLI，npx -y @mvanhorn/printing-press-library install github-contents --cli-only，并用 github-contents-pp-cli --version 验证；若失败可回退 go install github.com/mvanhorn/printing-press-library/library/developer-tools/github-contents/cmd/github-contents-pp-cli@latest（需 Go 1.26.6+）。认证可选，设置 GITHUB_TOKEN 或 GH_TOKEN 可将限额从 60 次/时提升到 5000 次/时并访问私有仓库。典型用法如 github-contents-pp-cli fetch mjwoon/AI-readings/books --out ./books、plan ... --agent、verify ./books ...、sync-dir ./books ...。
限制：只读，不能创建、提交或推送文件；不适用于需要 git 历史的克隆、issue/PR/actions、跨 GitHub 代码搜索；不解析 Git LFS 二进制（仅检测并警告）；contents 接口单文件上限 1 MB，大文件经 raw CDN 流式传输。路径可通过 --home 或 GITHUB_CONTENTS_HOME 等环境变量重定位。