前言¶
在 DeepSeek Harness（DSH）里做智能体时，若要让模型「搜商品、比价格、拿优惠券链接、甚至走到下单履约」，通常需要自己对接各平台开放能力、维护商品索引，并在工具层拼齐搜索、比价、转链等多条链路。MeshTok 维护的 dsh-plugin-yuantoutao（源头淘电商插件）把上述能力收成一套面向 DSH 的电商插件 / Streamable HTTP MCP server：安装进 DSH 后，对话侧可通过统一命名空间下的工具完成跨平台购物相关操作。下面介绍它的定位、能力与安装配置方式。
这是什么¶
dsh-plugin-yuantoutao 是 DeepSeek Harness 的电商类插件，仓库为 MeshTok/dsh-plugin-yuantoutao，社区目录页见 SkillHub 条目，分类为联网工具。插件描述为：在 Taobao / JD / Pinduoduo 等场景下提供商品搜索、比价、优惠券与 checkout；含 50k+ 精选 SKU 本地货架、联盟购买链接与订单履约能力（具体以 README 与 llms.txt 为准）。
DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。本插件以 MIT 许可证发布（package.json 版本 0.1.0，要求 dsh >= 0.2.0）。
核心功能¶
README 中归纳的能力如下，均通过 MCP 工具暴露，命名空间为 mcp__yuantoutao__*。
对话购物与可解释排序¶
- 对话购物：支持自然语言搜货，可带预算与偏好（例如礼品预算、强调正品或低价等表述）。
- 可解释排序：结果项带评分及分项原因（相对类目均价、店铺层级、销量、优惠券等），便于在对话中引用说明。
- 实时扇出：可向淘宝 / 京东 / 拼多多官方渠道并行查询（需具备相应 API 能力时启用，见下文密钥说明）。
本地货架与平台专项工具¶
- 本地精选货架：
shelf_search/shelf_item使用本地 curated shelf，不占用平台配额，可按相关度、销量、价格、上新等排序。 - 淘宝系：
cps_search_shops、cps_item_info、cps_tpwd（店铺搜索、商品详情、淘口令分享）。 - 京东：
cps_jd_goods_search、cps_jd_convert、cps_jd_orders。 - 拼多多：
cps_pdd_goods_search、cps_pdd_convert、cps_pdd_orders。 - 饿了么：
cps_eleme_convert（官方活动转链，如外卖红包场景）。
搜索、比价与履约¶
| 工具 | 作用 |
|---|---|
cps_smart_search |
旗舰购物搜索：自然语言 + 预算 + balanced/quality/price 模式，每项可解释三因子评分，可选 live fan-out |
cps_compare |
2–6 个商品并排对比（价对类目均价、券、店级、规格行等） |
search_goods / get_goods_detail |
履约链路中的搜货与详情 |
create_order / get_order_status / get_logistics / request_aftersale |
幂等下单、状态、运单、售后取件等 |
README 还提到：联盟购买链接可 attribution；归因订单有开发者分成说明（3%、月结等，以官方控制台与文档为准）；履约侧含服务端计价、微信支付二维码或跳转、运单跟踪、免费退货上门等描述。
无密钥即可用的只读能力¶
安装完成后，只读购物工具（搜索、比价、购买链接等）可在 不配置 API key 的情况下使用：无需注册、无 token、本地货架无配额限制（README 表述为 keylessly，可搜索 2M+ 商品）。若需要佣金相关能力、live fan-out、下单与分成提现，再申请免费 API key（控制台 yuantoutao.com/console，或通过 POST https://mcp.yuantoutao.com/mcp/trial 申请试用）。
安装与启用¶
先做插件安装，再重启 DSH Web 或 headless 进程。
dsh plugin add github:MeshTok/dsh-plugin-yuantoutao
# then restart: dsh web (or dsh headless)
安装前建议自行查看仓库源码与 MIT 许可证；插件在 当前 dsh 进程权限 下运行，涉及联网与订单时需按你的安全策略评估。
配置 API Key（可选）¶
仅在需要佣金、实时扇出、下单等能力时配置。在 yuantoutao.com/console 领取免费开发者 key（README 称 free keys 不过期），任选其一：
环境变量：
export YUANTOUTAO_API_KEY=ak_your_key
或在 DSH profile 的插件配置中设置 apiKey，并可选用 url、serverName、toolCallTimeoutMs、failOnStartupError。
典型用法（在对话 / 智能体中）¶
DSH 接入 MCP 后，模型可调用上述工具，例如：
- 用
cps_smart_search处理「500 以内送礼」「同品类最便宜且强调正品」类自然语言需求，并引用返回的 score 与分项原因回复用户。 - 用
cps_compare对候选 2–6 个 SKU 做矩阵对比后再推荐。 - 无 key 场景下用
shelf_search/shelf_item查本地精选货架；需要淘宝 / 京东 / 拼多多实时结果时再配置 key 并依赖 fan-out 类能力。 - 履约流程按
search_goods→get_goods_detail→create_order→get_order_status/get_logistics顺序由 agent 编排（具体参数见 llms.txt 与 API 控制台）。
完整工具列表与 API 说明以 README 表格及 yuantoutao.com/llms.txt 为准。
适用场景与注意¶
适合：在 DSH 里做 AI 购物 / 对话购物 agent、需要统一 MCP 接口覆盖淘系、京东、拼多多（及文档中的饿了么转链）搜索、比价、转链与可选履约闭环的开发者。
注意：
- 插件依赖
@deepseek-ai/dsh-mcp-client（peer：>=0.2.0-alpha.1 || >=0.2.0），需与本地 DSH 版本匹配。 - 无 key 与有 key 能力边界以 README 为准；分成、结算、订单与支付行为以源头淘官方文档与控制台条款为准。
- 安装与启用前请审查 GitHub 源码；勿在未审计的情况下在生产环境开放高权限进程。
结尾¶
dsh-plugin-yuantoutao 把跨平台电商搜索、可解释比价、联盟链接与可选履约收成 DSH 可安装的 MCP 插件，并支持零密钥起步的只读购物工具。目录页：https://www.skillhub.cn/plugins/MeshTok/dsh-plugin-yuantoutao；源码与安装说明：https://github.com/MeshTok/dsh-plugin-yuantoutao。
