本页目录0.2.1 (2026-10-14)0.2.0 (2026-10-09)0.1.2 (2026-10-03)0.1.1 (2026-10-03)0.1.0 (2026-10-03)破坏性变更约定
更新日志
0.2.1 (2026-10-14)
- 开发者分成调整为成交金额的 3%(原 5%):有效订单成交金额的 3% 归接入 agent,按月结算,满 10 元提现——话术统一为「用户下单,你拿 3%」
- 终端归因
client_ref(可选):转链/搜索时传你的终端用户标识([A-Za-z0-9-]≤40),随联盟链接回流到你的订单记录——用GET /v1/cps/attribution/orders按client_ref对账,自行给你的用户做积分/折扣等激励;服务端原样保存不解读 - MCP:
cps_jd_convert/cps_pdd_convert/cps_smart_search/shelf_search/shelf_item支持client_ref;搜索类buy_url自动携带?ak=&ref=
0.2.0 (2026-10-09)
- 商品智能搜索上线(
cps_smart_search/ GET /v1/cps/smart_search):三因子可解释排序(相关性/质量/价值),店铺层级分层(官方旗舰/旗舰店高于普通店铺),自然语言+预算+模式(均衡/品质/低价)筛选,breakdown.reasons直接可引用的推荐理由 - 商品对比(
cps_compare/ POST /v1/cps/compare):2-6 个商品的对比矩阵(价格 vs 类目均价/店铺层级/规格行) - 榜单(
cps_rankings/ GET /v1/cps/rankings):销量/最新/大额券/降价幅度四种榜单,缓存 1 小时 - 货架检索升级:
shelf_search默认相关性排序(带 score/breakdown),支持 sales/price/latest - 推荐跳转开放:淘宝/京东/拼多多官方渠道商品开放推荐与购买跳转(
buy_url自动带归因),开发者分成覆盖推荐跳转(成交金额 5%,月结) - 新增指南:商品推荐与购买跳转、本地生活优惠(美团)
- 语义检索:搜索支持自然语言语义匹配(如"送妈妈的礼物"),与关键词匹配混合排序
- MCP 工具扩至 20 个(新增
cps_smart_search/cps_compare等)
0.1.2 (2026-10-03)
- 开发者分成政策公布:成交金额 5% 归接入 agent,按月结算
- 购物 agent 教程上线;工具参考独立成页
0.1.1 (2026-10-03)
- 跨平台自然人识别(human_key):免费上门取件月配额按自然人共享,跨 agent 同手机号同配额
- 开发者文档站上线(快速开始 / 支付 / 订单 / 售后 / 身份 / 错误码 / API 参考)
- 推单闸门与预存余额扣减已在生产链路验证
0.1.0 (2026-10-03)
- MCP 端点上线:
search_goods / get_goods_detail / create_order / get_order_status / get_logistics / request_aftersale - REST v1 同源开放(幂等下单 / 状态时间线 / 轨迹 / 售后)
- 订单状态机、售后自动化(上门取件→入库确认→自动原路退款)
- 平台自营模式:收单/退款/商家结算全部平台持有,agent 永不碰钱
破坏性变更约定
错误码与字段只增不改;破坏性变更提前在此公告并保留迁移期。建议解析代码对新字段宽容。