用途：dub-pp-cli 是驱动 Dub 的命令行工具，面向需要在工作区规模上管理 Dub 的智能体或操作者，覆盖批量链接操作、活动级 UTM 重写、合作伙伴计划审计、赏金分诊，以及基于本地 SQLite 的跨资源离线分析。官方 dub-cli 之外的链接缩短或工作区配置需求可考虑本工具。
主要能力：本地状态类命令包括 links stale（查找归档、过期或零流量链接）、links drift（检测周环比点击率下降超阈值的链接）、links duplicates（查找指向同一目标 URL 的重复链接）、links lint（审计短链 slug 的相似冲突、保留字违规与品牌冲突）、links rollup（按标签或文件夹聚合点击、线索、销售）、funnel（每条链接或活动的点击到线索到销售转化率）、customers journey（单个客户的完整点击、成为线索、购买时间线）。智能体类命令包括 links rewrite（发送前预览将变更的链接与补丁，支持 --dry-run）、health（跨资源晨间报告）、since（最近 N 小时的活动摘要）。合作伙伴类命令包括 partners leaderboard、partners audit-commissions、bounties triage、bounties payout-projection。命令参考还覆盖 bounties、commissions、customers、domains、dub-analytics、events、folders、links、partners、payouts、qr、tags、tokens、track 等资源。
使用方式：先安装并验证 CLI。安装命令为 npx -y @mvanhorn/printing-press-library install dub --cli-only，验证命令为 dub-pp-cli --version；若 npx 安装失败，可回退到 go install github.com/mvanhorn/printing-press-library/library/marketing/dub/cmd/dub-pp-cli@latest（需 Go 1.26.6 或更新）。认证读取环境变量 DUB_API_KEY（也接受 DUB_TOKEN），密钥为工作区级，可从 dub.co/settings/tokens 获取，并用 dub-pp-cli doctor 验证连通性。任意命令可加 --agent（展开为 --json --compact --no-input --no-color --yes），支持 --select 过滤字段、--dry-run 预览、--deliver 输出到 stdout、file:<path> 或 webhook:<url>，以及 profile save/list/show 保存命名配置。不确定命令时可用 dub-pp-cli which "<能力描述>" 查询。
适用场景：批量链接清理与归档、活动 UTM 批量替换前预览、合作伙伴佣金与赏金审计、按标签的绩效汇总、客户归因排查、定时智能体报告。
限制：需先安装并确保二进制目录在 PATH 中，否则命令不可用；API 密钥为工作区级；部分命令（如 domains register）仅企业版可用；本地 SQLite 相关能力需先 sync；反馈默认仅本地存储，除非设置 DUB_FEEDBACK_ENDPOINT 并显式发送。