用途：jobber-pp-cli 是只读的 Jobber 命令行工具，面向需要对 Jobber 租户做离线分析的代理或用户，例如 AR 账龄、发票付款追踪、周对比快照差异、同步数据的全文检索，以及对本地存储的临时 SQL 查询。设计上不写入 Jobber，需要完整对账时可与 QBO 等会计 CLI 搭配。不适用于创建、更新、删除、发布、留言、下单、发消息等修改远程状态的操作。
主要能力：ar aging 按客户分 0-30/31-60/61-90/90+ 账龄桶并给出各桶合计；invoices trace 提供逐发票台账，--mismatched 可筛出付款与总额不符的发票；snapshot diff 对比两个带标签的 SQLite 快照，--save <label> 可给当前库打标签；search 对已同步资源做 FTS5 全文检索；sql 支持只读临时 SQL（写入令牌在 CLI 层被拒，sqlite 以只读模式打开）。命令覆盖 clients、invoices、jobber_jobs、payment-records、properties、quotes、visits。
使用方式：先安装并验证，npx -y @mvanhorn/printing-press-library install jobber --cli-only，然后运行 jobber-pp-cli --version；若 npx 失败可用 go install github.com/mvanhorn/printing-press-library/library/sales-and-crm/jobber/cmd/jobber-pp-cli@latest（需 Go 1.26.6+），并确保安装目录在 PATH 中。认证使用 OAuth2 授权码加刷新令牌轮换，读取 JOBBER_CLIENT_ID、JOBBER_CLIENT_SECRET、JOBBER_CALLBACK_URL、JOBBER_ACCESS_TOKEN、JOBBER_REFRESH_TOKEN、JOBBER_GRAPHQL_VERSION 环境变量，可用 jobber-pp-cli doctor 验证连接。所有命令可加 --agent（等效 --json --compact --no-input --no-color --yes），并支持 --select 字段裁剪、--deliver 输出到 stdout/file/webhook 等。可用 jobber-pp-cli which "<描述>" 查找匹配命令。
限制：只读，不支持任何修改操作；payment-records 的 entryDate 为双端排他，需前后各补一天；输出以 meta/results 信封包装，需解析 .results，.meta.source 表示数据来自 live 还是 local；部分行为细节以实际版本为准。