dsh-waimai

DeepSeek Harness 多平台外卖插件。淘宝闪购和盒马通过 HTTP 读取账号、配送地址、历史订单与商品。闪购支持购物车、结算报价、页面确认创建订单和官方支付入口；盒马支持规格加购，结算与支付接入待完成；美团、京东尚未接入。

插件页面

Agent 会话中的盒马商品提供「查看规格」弹窗；get_product_details 的工具卡片显示包装、最低数量、步长、库存和计价单位。历史工具结果提示重新核验价格和库存；刷新绑定记录中的账号，并复核当前配送地址。插件与聊天弹窗共用规格和数量选择、等待反馈及悬浮购物车；点击加购后仅在目标 SKU 数量及其他商品回读一致时显示成功。规格读取和加购重查原搜索页及门店售卖状态；非售卖时段或商品已移出该页时停止加购。称重商品和跨平台商品的加购方式未确认时停止。

购物车弹窗内部滚动商品，较多商品时保留标题和关闭入口。

Agent 使用 get_cart(platformId: hema) 获取当前购物车版本，再通过 add_product_to_cart 提交 productRef、skuId、整数数量、revision 和固定的 operationRef。原生加购仅发送一次。完整购物车快照和结果保存在当前账号目录的 hema-cart-attempts.json；接口超时或回读延迟时只刷新购物车，重载后也不重发。未核对的操作会阻止新的加购。购物车价格不作为会员优惠、运费或最终实付的结算证据。

顶部统一选择平台和账号，账号选项标明淘宝扫码或短信登录；五个页签共用当前账号视图。淘宝闪购沿用 ele.me 的业务接口域名，页面使用淘宝闪购品牌。

淘宝扫码账号显示同一登录会话的淘宝昵称和本人头像；账号编号只放在账号详情。头像昵称与当前淘宝身份不匹配时不显示该头像，读取或加载失败显示昵称首字和刷新提示。昵称为空时显示未命名账号。读取前后同时核验淘宝身份和闪购业务身份，身份变化时停止显示资料。

各渠道从平台注册表读取登录方式和默认入口。淘宝闪购提供淘宝扫码与手机号短信；盒马默认提供「手机号短信（淘宝授权）」，也可选择淘宝授权扫码或明确复用已登录淘宝账号。短信走阿里账号的官方网页入口，取得登录会话后独立核验盒马本人资料和订单，不伪称调用盒马 App 的设备登录接口。仅支持已有账号，需要注册或额外验证时停止；手机号和验证码只经私人页面提交。盒马 App 扫码尚未接通，选择它不会生成淘宝二维码。默认入口不宣称已经核实为官方推荐。账号格式变化见 0.5.0 升级说明。

• 账号与地址：优先显示登录状态、头像、昵称、账号 ID、脱敏手机号和当前配送地址；其他地址折叠为可展开列表。已登录时隐藏登录表单，点击「添加账号」后显示当前平台的默认登录入口；淘宝闪购也可选手机号短信；短信入口提示订单可能属于不同账号。复核业务账号、资料和订单后才加入列表。多个账号保持独立登录，下拉只改变当前页面视图，不影响其他窗口或任务；切到任务或设置后返回仍保留所选账号。地址选择与账号绑定。
• 点餐：顶部选择或更改配送地址，未选有效地址时不查询店铺。自动加载附近推荐店铺，展示图片、评分、月售、距离、配送时间和起送价，支持翻页及本页筛选；也可查看最近订单店铺。菜单支持分类、图片、标价、售罄及规格选择。单规格直接加购，多规格打开弹框选择份量、口味、配料和数量；显示加价、必选项及互斥选项。加购立即显示等待状态，购物车回读确认后显示成功反馈；失败保留具体原因。右下角悬浮购物车显示数量和金额，点击打开购物车弹框，可减一件、刷新及结算。结算显示平台实付、优惠、费用、商品、地址和配送时间；勾选确认再创建订单，随后点击官方支付入口。切换地址清空旧视图并丢弃迟到请求；同地址刷新失败保留已读结果。
• 历史订单：优先显示商家、状态、时间、餐品和金额；订单号按需展开。支持刷新、下一页和返回最新记录；每次成功翻页替换当前列表，普通刷新失败时保留最后已校验的页面并显示重试入口，账号不一致时清除资料。
• 任务：显示当前平台的任务，设置时间、日期、参考菜单与预算。新任务暂停，预览不购买；关闭预览的任务报告接口未验证并停止。
• 设置：默认平台、预览和金额上限优先显示；结算报价有效期、人工支付说明与本机登录、分页设置按需展开。通过 Host 表单的版本检查保存修改，保留未编辑字段。

未接入平台显示明确空状态，不读取淘宝账号或发送登录请求。切换平台或账号视图时销毁旧资料、地址、订单和店铺列表并丢弃迟到的请求。账号会话按平台和账号隔离，不同账号可并行读取；每个平台同一时间只保留一个待完成登录。默认账号数上限为 10，可配置到 100。美团和京东登录接口仍未接入，不能因多账号界面可用而视为其登录可用。

当前能力

Agent 的 search_shops 支持 nextCursor 分页；本页没有关键词匹配时仍返回下一页，不把空筛选结果解释为附近没有商超。游标在本机 MCP 进程保留，绑定账号、关键词、范围及原生地址分页，有效期和容量可在高级设置调整。重载或过期后从第一页重新查询。

search_products 用商品名称查询最多十家已选店铺，返回商品原名、规格描述、标价和可售状态；查询范围明确为 selected-stores-only，不是全平台搜索。重复分类中的商品按店铺与商品身份去重；某店读取失败时结果标记 complete:false，不伪装成缺货。平台返回空菜单和明确状态时展示原提示，例如「暂无可售商品，请改天再来」；没有状态说明的异常空值仍报错误。购买整箱水时必须核对实际 SKU 的单瓶容量、瓶数和包装，价格比较以实时报价及配送费为准。

平台	登录/账号	地址/历史	店铺/菜单	结算/创建订单/支付
淘宝闪购	HTTP 可用	HTTP 可用	附近推荐分页、最近店铺、菜单与购物车 HTTP 可用	结算实测可用；确认下单与支付入口已实现，真实购买待用户验收
盒马	手机号短信（淘宝授权）、淘宝扫码或复用已登录淘宝账号	HTTP 可用，订单分页	配送门店、商品名称搜索分页、规格、购物车与整数规格加购	结算、会员优惠与支付待验证
美团外卖	尚未接入	尚未接入	尚未接入	禁用
京东外卖	尚未接入	尚未接入	尚未接入	禁用

接口字段来自 2026-10-11 的真实账号请求与官方客户端代码。登录初始化读取 /mini_login.htm 中的 JSON，再调用 /newlogin/sms/send.do 与 /newlogin/sms/login.do，每次发送前获取新 CSRF。登录返回经过 HTTPS 域名限制的 Cookie 同步地址，再通过 mtop.alsc.user.session.ele.check 独立确认账号。账号资料、地址和订单每次读取均复核会话与账号。

盒马在平台下拉中单独选择。添加账号可用淘宝 App 扫码，也可点击「使用已登录淘宝账号」并明确选择已保存的扫码账号；不支持未经验证的盒马短信登录。入口先复核来源淘宝身份，再复制限定淘宝域名的 Cookie 到独立盒马会话，依次确认淘宝身份、盒马本人资料和订单；失败不加入列表。不会读取手机私有目录，也不调用注册、绑定、换绑或购买接口。已有闪购账号的 Cookie 文件、默认账号和配送选择保持原样。

盒马资料通过 mtop.wdk.iseeku.user.profile.get 读取，必须返回本人资料；头像只使用经过校验的 HTTPS 图片 CDN。地址来自 mtop.wdk.lbs.location.UserAddressReadApi.getAllAddress，配送门店由当前已选地址的 decidedShopData.groupList 确认；不将它们标成外卖附近推荐。订单使用 mtop.hema.trade.order.buyer.list.search，保留超出 JavaScript 安全整数范围的完整订单号，金额由分转元，订单时间按中国时区解析，分页与盒马账号绑定。每次私人读取前后复核身份。

「门店与商品」选择配送门店后输入商品名称，调用 mtop.wdk.search.item 分页读取商品、标价单位、图片和库存状态；商品所属原生门店必须位于当前地址的配送组。成功翻页替换当前列表，失败保留最后已确认的一页；可返回首批。分页令牌只在后端保存，页面及模型仅获得与账号、地址、门店和搜索词绑定的随机引用。每个会话最多保留 32 个分页引用、1000 个商品引用；单次搜索超过 1000 件时要求更具体的搜索词，过期引用须重新搜索。

「查看规格」通过 mtop.wdk.detail.openservice 核对商品和原生门店，显示销售规格、最低数量、数量步长、库存及计价单位。只有接口明确标记价格未经转换时才显示规格标价，否则显示「价格暂无法确认」，price 与 originalPrice 为 null；不使用转换后的数字猜测价格。商品列表标价不代表结算实付。搜索词建议、跟踪数据、购物车动作、动态签名和购买链接不进入显示结果。

盒马头像和商品图片仅接受允许的图片 CDN；接口返回的协议相对地址和 HTTP 图片地址转换为 HTTPS，仍拒绝含凭据、非默认端口、查询参数及外部主机的图片。

「查看购物车」通过新版 mtop.trade.query.bag 按所选地址读取当前账号购物车，显示数量、平台显示单价及单位、手机已勾选状态和不可售原因，不修改商品或选择。单价读取 pay.nowTitle，不将整行金额 afterPromPrice 除以 100 后当作单价。旧购物车接口的空返回不能证明购物车为空；新版组件层级、商品或价格无法完整确认时明确报错。列表分批展开，刷新失败保留已读列表，账号或地址变化后清空。分类菜单仍属于闪购；盒马支持整数规格加购，结算、下单与支付待接入。2026-10-11 已核对真实账号两批共 57 件商品，无重复，并读取规格及与手机一致的 40 条购物车记录。

附近推荐通过 mtop.alsc.eleme.miniapp.homepagev1 与 mtop.alsc.eleme.miniapp.collection.homepagev1 HTTP POST 按已选地址查询。仅将明确的 isAd: true 或 isAd: "true" 视为推广，默认过滤；在「点单设置」关闭「隐藏推广店铺」并保存后，展示推广店铺和广告标签，"false" 和空广告信息不影响普通店铺；整页推广被过滤时保留下一页入口。分页位置按未过滤的原始页计算，与账号、地址绑定，不接受任意查询参数。菜单使用 mtop.alsc.waimai.store.miniapp.store.detail.body.query.v2 HTTP POST。折叠与售罄商品可使用数字店铺 ID：先核对菜单中相同商品的店铺引用；没有可核对的商品时，通过 mtop.alsc.waimai.store.miniapp.store.detail.head.query.v2 独立复核加密店铺 ID 和唯一数字别名。其他店铺商品、冲突别名和无法确认的详情仍拒绝展示，历史购买记录不参与别名确认。读取结束再次复核账号和地址。只返回图片、菜品与选项等展示字段，不返回购买链接、购物车动作、历史重购记录或跟踪数据。菜单标价不代表实付金额。人工验证时停止；菜单读取不执行创建订单、取消订单、购买券包或扣款。

淘宝二维码通过官方 /havanaone/loginLegacy/qrCode/generate.do 获取，并轮询 /havanaone/loginLegacy/qrCode/query.do。二维码在后端生成 PNG，临时令牌与 Cookie 不返回页面。每次扫码使用独立会话，取消、过期或切换页签会停止检查。淘宝确认后，通过 mtop.alibaba.ucc.taobao.apply.usertoken 与 mtop.alibaba.ucc.oauthLogin 换取闪购业务会话。仅接受 Eleme 站点的已确认会话，校验 Cookie 域名及账号 ID，再用业务接口复核本地 ID、Havana ID、资料与订单，全部通过后才保存。授权失败或额外验证时保留原账号；注册、绑定、换绑接口不会自动调用。

打开插件页面的扫码入口后自动生成二维码。页面显示扫码、手机确认、完成登录三步进度；手机确认后自动复核业务授权，无需点击检查按钮。临时请求失败会自动重试，确认后的复核默认最多 60 秒；超时、淘宝会话未建立或平台要求额外验证时停止并显示原因，可重新扫码。取消或离开账号页会停止当前尝试。

loginDiagnostics 默认开启，启动器的 web-host.stderr.log 中按 [waimai-login] 和 attemptId 记录二维码确认、业务初始化、令牌与 UCC 接口返回码及授权类型、资料和订单核验、失败和取消。日志仅保留固定字段、类型与数量，不记录远端说明、URL、二维码内容、Token、Cookie 或个人资料；重复等待状态不重复记录。关闭该配置停止记录，登录行为保持原样。

手机号登录的订单可能与淘宝账号所关联的闪购账号不同，仅改变订单查询渠道不能证明账号一致。真实验收已取得淘宝扫码对应的闪购会话，读取昵称、头像与当日订单，并与原短信账号分别保存。平台可能不提供手机号，此时不显示手机号。购买流程要求复核淘宝身份和独立的闪购买家会话；这两个 ID 不应直接比较。

闪购结算与购买

可选配料组的额度为 0 时仍展示基础规格和口味，配料禁选，不把 0 猜成无限制。零额度与默认或必选配料矛盾时停止；不绕过平台数量规则。

购物车使用 mtop.eleme.waimai.carts.shop.operate.um，结算使用 mtop.alsc.bpgw.trade.order.build，确认提交使用 mtop.alsc.bpgw.trade.order.submit，固定请求主机为 alsc-buy2.ele.me。加购从刚读取的菜单中提取 SKU，调用方只传商品引用，不能提供原生规格参数。减一件只调整指定商品，不清空其他商品或更改勾选状态。规格通过 mtop.alsc.waimai.store.detail.item.purchased 读取，各 SKU 的口味和必选配料分别校验。选择引用绑定账号、地址、店铺和商品，加购前重读价格、库存、配料与互斥规则；变化后要求重新选择。套餐、带组合规则或配料数量规则的商品仍停止加购。每次修改只发送一次，并以目标 SKU、口味、配料和数量回读确认；接口成功但数量未变化时提示核对购物车。

报价核对当前账号、闪购买家会话、原始配送地址、店铺、SKU、数量和多个金额字段，不用菜单标价估算实付。原生结算参数和压缩提交数据只保留在后端，页面只接收展示字段、随机报价引用和有效期。付费附加服务或不支持的支付选项会停止。报价有效期可配置，默认 120 秒；购物车、账号、地址变化后旧报价不能提交。

自动任务预览默认开启，不创建订单。手动点餐可在插件页面或会话卡片中获取报价，明确确认商品、配送时间、地址和金额后创建本笔订单，无需关闭全局预览；单笔及每日上限在服务端检查。每日累计包含已创建订单和结果未确认的尝试，不自动因取消或退款返还额度。提交前写入共享本机记录并获取文件锁，不重试创建订单请求；未知结果、相同未变化购物车、重复确认和遗留锁都会阻止再次提交。请先核对官方历史订单，不能用重复提交检查是否成功。

创建成功后显示订单号和限定官方 HTTPS 支付入口，插件不调用扣款或免密支付接口。入口不代表已付款，支付结果以官方订单为准；平台未返回受支持入口时在官方客户端继续。自动任务实际购买和自动扣款仍禁用。Agent 可推荐、选规格、修改指定购物车并生成下单确认卡片，工具调用本身不创建订单；用户点击确认后才提交。2026-10-12 已实测奶茶杯型及必选配料、餐品份量和辣度加购，各增加一件后逐件移除并回读确认恢复；2026-10-11 已真实验证加购、读回、实付报价 ¥31.50 与逐件移除恢复原购物车；订单创建、异常提交和支付入口用模拟响应验证，未创建测试订单或扣款。

Agent 会话点餐

菜单和点餐准备结果中的 orderingAvailable 表示用户确认下单可用；automaticOrderingAvailable: false 表示自动购买不可用，userConfirmationRequired: true 要求明确用户确认。

会话中的店铺、菜单、推荐餐品、购物车、报价和付款工具结果使用公开 tool.call.toolview 展示卡片。点击店铺或餐品可在当前会话中选择规格、配料和数量、加购、减一件与结算；插件页面继续使用悬浮购物车，会话卡片使用内嵌购物车。卡片绑定记录中的 accountRef，不会随其他窗口切换账号。地址和付款 URL 只通过鉴权 RPC 读取，不写入模型结果。

Agent 推荐时调用 show_order，只能使用当前菜单中的真实 itemIds。获得购物车 revision 后可调用 get_item_options、change_cart，再用 submit_order 请求真实报价。报价卡片重新读取当前购物车和报价，展示有效期、费用、优惠、配送地址和实付；预算超限、过期、身份或购物车变化阻止提交。用户确认后显示订单和官方付款入口；付款后刷新官方状态。请求成功或打开链接都不能当作已付款。迁移见 0.3.0 说明。

下单阶段日志使用 waimai-order 分组，仅记录尝试引用、阶段和金额，不记录地址、账号、餐品、付款 URL 或凭据。订单结果未确认时保留预算占用，先查官方订单，不重试提交。

安装与开发

npm install
npm run check
npm test
dsh plugin --profile web add --save-exact github:vb2250158/dsh-waimai#<40位提交>

插件没有构建步骤，lib/ 就是发布产物。普通登录与账号读取无需安装或打开 Chromium；人工平台验证由用户在官方窗口完成。MCP 子进程由 Host 使用包内绝对路径启动，配置变更后重启该子进程。

工具

模型工具：list_platforms、list_connections、get_status、prepare_ordering、search_shops、search_products、get_menu、get_product_details、get_item_options、get_cart、change_cart、show_order、preview_checkout、submit_order、request_payment、get_order_status 和 Host 的 preview_task。list_connections 只返回平台和本机保存的账号引用，不返回昵称、手机号或凭据；每次使用仍复核会话。浏览器记住上次的平台和各平台账号，刷新或重新进入插件时复核后恢复；仅保存引用，不保存昵称、手机号或登录凭据。浏览器间不同步，清除站点数据后回到默认选择。已移除的账号回到可用默认账号，平台验证或临时查询失败不会改查其他账号。多个账号时，账号工具必须提供对应 accountRef，不会按当前页面的选择改变其他调用。search_shops 的 scope 默认 nearby，分页查询已选地址的附近推荐；recent 查询最近一页订单店铺，keyword 仅筛选当前页结果，不能声称搜索平台全量商家。get_menu 要求返回的稳定 shopId 和该账号已选地址；盒马还须 keyword，后续页原样传回 nextCursor。get_product_details 用搜索结果的 productRef 读取盒马规格。模型结果不包含账号 ID、地址或私人平台分页令牌。淘宝点餐卡片支持用户确认提交；未接入平台返回结构化错误。原有调用迁移见 0.2.5 迁移说明。

短信、账号资料、地址、完整历史订单、确认提交与私人支付入口仅在鉴权的 /waimai-login RPC 可用，内部端点不注册给模型。模型购物车工具复用相同账号所有者，只返回商品、金额及版本。preview_checkout 要求淘宝平台、accountRef 和 shopId，返回不含地址或支付链接的报价；submit_order 用 accountRef、shopId 和 maxAmount 生成预算内的确认卡片；request_payment 和 get_order_status 用本机订单引用核对官方状态。实际创建需用户在卡片确认，官方付款入口从私人 RPC 读取，不进入模型结果。手机号、验证码、Cookie、地址和购物车摘要不写入共享配置；异常消息不返回网络 URL 或令牌。见 0.2.16 升级说明。

配置

字段	默认	说明
defaultPlatform	taobao	默认平台，另可选 hema、meituan、jd
dryRun	true	自动任务预览；手动下单仍需明确确认，不自动付款
persistLogin	true	本机 Cookie 持久化；关闭则仅当前子进程有效
maxAccountsPerPlatform	10	每个平台最多保存的账号数，整数 1–100；重复登录同一身份更新原条目
loginTimeoutMs	20000	请求超时毫秒，1000–120000
smsResendSeconds	60	验证码发送间隔秒，60–600；结果不明也占用间隔
qrLifetimeSeconds	180	单次扫码等待上限秒，整数 60–600；平台可提前使二维码失效
qrPollSeconds	2	扫码检查间隔秒，整数 2–15
qrAuthorizationSeconds	60	手机确认后自动复核上限秒，整数 15–300
browsePageSize	10	附近店铺每页数量，1–20
browseCursorSeconds	600	Agent 店铺分页有效期，整数 30–3600 秒
browseCursorLimit	100	Agent 保留的店铺分页引用数，整数 1–1000
hemaProductPageSize	30	盒马商品查询每页数量，整数 1–50
hideSponsoredShops	true	隐藏推广店铺；可在「点单设置」关闭，保存后保留广告标签展示，查询会等候接口重连完成
checkoutQuoteSeconds	120	闪购报价有效期，整数 30–300 秒
historyPageSize	10	每页订单条数，整数 1–20
maxOrderAmount	35	单笔金额上限，元；任务只能收紧
dailyBudget	0	全局每日上限，元；0 表示无限制
autoTasks	[]	任务列表，当前只支持预览

任务包含唯一非空 id、name、platformId、enabled、triggerTime（本地 HH:mm）、dateRule（workday/weekend/everyday/custom）、customDays、skipDates、menuPool（每行 店铺 | 菜品 | 参考价格）、menuStrategy（rotate/random/history）、金额限制和通知选项。每分钟轮询，仅触发指定分钟，不补跑错过的任务。同一任务每天只触发一次，先保存触发记录再执行预览或失败通知。

旧浏览器、自动支付和自动领券字段保留加载兼容，当前不执行相应操作；结算优惠以平台报价为准。升级已有调用与任务前阅读 0.2.0 升级说明。

本机数据

文件均位于 $DSH_HOME/waimai/，未设置时使用 ~/.dsh/waimai/。accounts.json 保存平台账号引用和已验证的显示资料，凭据和配送地址引用分别在 accounts/<platform>/<uuid>/login-state.json 与 delivery-selection.json。手机号输入、验证码、地址文本、完整历史订单和未确认扫码会话不持久化；trade-attempts.json 独立保存下单金额、账号、购物车指纹、结果、订单号与私人支付入口，用于避免重复提交。即使关闭记住登录，下单尝试仍持久化。每次使用重读账号与地址，缓存资料不能证明会话有效。本机私人缓存不进入共享配置。

首次加载会把旧 login-state.json 和配送地址引用复制到一个独立淘宝账号目录，保留原文件；索引成功保存后只使用新账号目录。重复登录已保存身份时刷新该条目，旧凭据文件保留用于恢复。取消添加只清除待完成登录，不删除已有账号或凭据。升级说明见 0.2.2 多账号说明。

扫码成功且闪购业务复核通过后，先保存在独立待登录账号目录，再加入账号索引。扫码不读取已有账号的 Cookie，也不会用已有账号的订单冒充扫码账号的订单。含凭据的旧备份只留在本机。

automation-state.json 保存触发和预览历史，notifications.jsonl 记录任务通知，mcp-server.log 为进程日志。既有 browser-profile/、截图、支付流水及 payment-state.json 保留原处，不会清理未确认的预算占用，也不被用于点餐。含账号数据的运行目录、截图和抓包文件不可随环境同步或发布。

验证范围

2026-10-11 已在空购物车中通过正式后端加购餐品和无需餐具，读取平台实付 ¥31.50、打包费 ¥2、配送费 ¥3.50、优惠和次日配送时间，再逐件移除并确认恢复为空。预览模式阻止实际提交。此前旧客户端渠道返回 F-10008-11-10-006，当前小程序渠道和结算请求已成功。真实订单创建和扣款未执行，不能把有效报价当作购买完成。

针对性测试覆盖平台、账号、地址、菜单、商品和购物车验证，报价展示及金额矛盾、财务请求不重试、预算与持久记录、RPC 鉴权、React 页面和 MCP 进程。真实账号已验证闪购和盒马资料、地址、历史订单、店铺与商品；闪购加购和结算可用。盒马整数 SKU 原生加购已实测，原有商品数量和勾选状态保持；结算、会员优惠和支付仍待验收。订单创建和支付仅完成模拟响应与页面流程验证。

MIT

加购脱敏日志使用 waimai-cart 分组，仅记录操作引用、发送及数量确认阶段和数量变化；不记录账号、地址、商品、配料、URL、Token 或 Cookie。沿用 loginDiagnostics 开关及 Host 的 web-host.stderr.log。

界面语言

插件列表中的名称和描述随 DSH 的中文、英文语言设置切换。