用途：在 GitHub 上做查询、分诊与写入时，先查本地 Gitcrawl 归档，再按需调用 Octopool 支持的 gh 获取实时元数据，以减少 API 配额消耗并保持结果一致。
主要能力：本地归档检索（gitcrawl search prs、gitcrawl threads，--include-closed 保留已关闭/已合并候选）；用 gh search issues/prs、gh issue list、gh pr list、gh issue view、gh pr view、gh pr checks、gh run list、gh pr diff 等命令做窄字段 JSON 读取；用 octopool whoami/health/stats 检查缓存与配额行为。
使用方式：默认先读归档，需要当前状态时用 PATH 上的 gh。归档状态可能滞后，不能作为当前状态证明。写入、评论、关闭、合并、重跑或编辑前，以及推送后验证 CI、用户要求最新状态时，必须走实时调用。需要 PR 文件、提交、检查或运行摘要时用 gitcrawl sync owner/repo --numbers 123 --with pr-details 水合，该操作消耗 API 并更新 Gitcrawl 归档，不会自动更新 Octopool 缓存。写入后只做一次针对性回读，可用 OCTOPOOL_FRESH=1 或 Cache-Control: max-age=0。
限制：gitcrawl gh 已退役并以退出码 2 提示迁移，不要据此调整登录、令牌、PATH 或绕过 shim。避免逐条 gh issue view 的宽循环；CI 不要紧密轮询，应锁定单个 run 后按 30s、60s、120s 间隔观察，并核对 head SHA 与 run attempt。gh api --include 使用原生 gh 与调用者凭据，会改变身份、配额与可见性，不是新鲜度开关。OCTOPOOL_NO_FALLBACK=1 仅用于已知支持的受限中继读取，不可全局设置。缓存统计是响应复用指标，不等于 GitHub 配额节省。