用途:pp-judgeme 用于同步和管理 Judge.me 评论,覆盖评论同步、审核状态检查、导出、店面组件调用以及按客户语言做 syndication 分析。当需要精确的语料完整性或可重复筛选时,优先使用本地镜像。
安装:先安装 CLI。默认二进制的安装命令为: npx -y @mvanhorn/printing-press-library install judgeme --cli-only 验证:judgeme-pp-cli --version 若 npx 安装失败,可改用 Go 安装(需 Go 1.26.6 或更新版本): go install github.com/mvanhorn/printing-press-library/library/marketing/judgeme/cmd/judgeme-pp-cli@latest
认证:设置 JUDGEME_API_KEY 为私有令牌,JUDGEME_SHOP_DOMAIN 为商店的 myshopify.com 域名;令牌只通过 X-Api-Token 头发送并会从日志中脱敏。运行 judgeme-pp-cli doctor 验证配置。
主要能力:sync 可镜像完整评论语料,并在唯一 ID 与 Judge.me 实时计数不符时拒绝成功;reviews export 可导出已发布、隐藏、待审或全部评论为 JSON 或 CSV;reviews populations 统计店面可见与内部审核群体;reviews syndication 查找同一规范化评论体被挂到多个产品的情况;reviews unique-bodies 每个规范化评论体返回一个确定性代表并保留源行数;另提供 private-replies、replies、reviewers、reviews、settings、shops、webhooks、widgets 等命令管理回复、审核者、设置、商店、Webhook 和组件。
用法:任意命令可加 --agent,等价于 --json --compact --no-input --no-color --yes;--dry-run 预览请求;--select 可裁剪字段。同步示例:judgeme-pp-cli sync --resources reviews --full --max-pages 1 --agent。通过 --home 或 JUDGEME_HOME 等环境变量控制路径,状态存于 SQLite 和 credentials.toml。
限制:不要用原始 reviews index 分页作为全语料完整性的证明;不要在未检查 dry-run 并通过显式 apply 标志的情况下执行变更命令;不要用该 CLI 推断 Syndication 中哪个产品关联才是真实关联。新鲜度只覆盖已注册的读取路径,--data-source local 不会刷新,--data-source live 读取 API 且不修改本地存储。