用途：对 1688.com 国内批发目录做只读选品与供应商调研，比较价格、起订量与可靠性，区分工厂与贸易商，并跟踪价格与回头率变化。不用于 Alibaba.com 国际站、淘宝/天猫零售，也不支持下单、加购或联系供应商；英文关键词效果差，建议先用中文。
安装：npx -y @mvanhorn/printing-press-library install 1688 --cli-only；验证 1688-pp-cli --version。若失败可在 Go 1.26.6+ 下执行 go install github.com/mvanhorn/printing-press-library/library/commerce/1688/cmd/1688-pp-cli@latest，并确保 $GOPATH/bin 在 PATH 中。无需认证，可用 1688-pp-cli doctor 检查。
主要能力：factory-find 按工厂可能性排序并标注 trader/likely-factory/verified-factory；repurchase-top 按回头率排名并设最低成交门槛；region-spread 按省份汇总最低/中位/最高价与成交量；drift 对比本地快照显示价格、回头率、30 天成交量变化；compare 并排比较多个报价；supplier-report 汇总单个店铺的评分、均回头率、总成交、认证、报价数与价格区间；watch 重跑搜索仅输出新增与变动；offers 查看报价详情；which 用自然语言匹配命令。
用法：加 --agent 展开为 --json --compact --no-input --no-color --yes；--select 过滤字段；--dry-run 预览；--deliver file:<path>/webhook:<url> 投递；可用 profile 保存常用参数。输出为 meta/results 信封，从 .results 取数据、.meta.source 判断实时或本地。退出码 0 成功、2 用法错误、3 未找到、5 API 错误、7 限流、10 配置错误。
限制：严格只读，不做创建、修改、发布、下单等变更操作；部分参数与收费、平台范围等细节暂未提供。可通过 feedback 命令在本地记录使用反馈。