Mixuebingcheng Cli 1.11.1
Use when ordering 蜜雪冰城 (Mixue) drinks from the terminal — list shops, read the menu, place an order, check the pickup number. Checkout is gift-card only; requires the user's own login token captured from their own traffic.
mixuebingcheng-cli
命令行点蜜雪冰城:查门店、看菜单、下单、礼品卡结账、取餐号。
依赖
| 项 | 要求 |
|---|---|
| Python | 3.8+ |
| 第三方包 | cryptography(pip3 install cryptography) |
| 网络 | 只能访问 mxsa.mxbc.net |
| 平台 | Linux / macOS / Windows(WSL 亦可) |
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
MIXUE_TOKEN | ✅ | 小程序 Access-Token(JWT),必须是使用者自己的 |
MIXUE_OPENID | 支付必填 | 小程序 openId |
MIXUE_CUSTOMER_ID | 建议 | 结算接口需要 |
MIXUE_SHOP | 可选 | 默认门店 shopId |
MIXUE_KEY_PATH | ✅* | 签名私钥路径,默认 ./tools/mxbc_key.pem |
MIXUE_PRIVATE_KEY | ✅* | 内联 PEM(\n 转义),与上者二选一 |
MIXUE_ALLOW_NON_GIFTCARD_PAY | 已移除 | 本版不存在该开关,非礼品卡支付无法解锁 |
配置优先级:真实环境变量 → $MIXUE_ENV → ./.env → ~/.config/mixue/.env。
使用者必须先做的两件事
- 自备登录态:抓自己的小程序流量,导出
.har→mixuebingcheng-cli har 抓包.har(mixuebingcheng-cli needs会打印要抓哪个域名、哪几个接口) - 自备或确认签名私钥:
mixuebingcheng-cli key查看状态
授权与安全约束(对 AI Agent 尤其重要)
两层确认,缺一不可:
-
对话层(策略):Agent 在执行任何会扣款或改状态的操作前,必须先向使用者复述 商品、数量、口味、金额、门店与支付方式,并取得明确的放行词 (「好的 / 确定 / 可以 / 下单」)。 使用者报出参数(选商品、报数量、报口味如「正常冰 七分糖」)都不算授权, 必须再单独问一次并等到放行词;没等到就结束回合,不得自行推进。
-
命令层(机制):按命令区分,不要笼统说「没有 --yes 就不联网」:
命令 缺 --yes时是否联网 order只报价:走菜单 + 礼品卡 + settlement/update算价,不建单、不扣款会联网 place直接拒绝,不进业务逻辑 不联网 cancel直接拒绝 不联网 即:
order缺--yes是「允许报价、不得建单」;place/cancel缺--yes是「直接拒绝」。
其余约束:
- 只操作使用者本人账号的订单,不得代他人下单
- 非礼品卡支付(
pay/paylink/wechatqr)已停用,且没有任何环境变量开关 get/post只能访问只读白名单,不能用来绕过上述确认- 卡余额不足全额时不建单,不会留下无法支付的孤儿订单
各命令的真实副作用(准确说明,别笼统叫"只读")
| 命令 | 网络请求 | 服务端影响 | 需要 --yes |
|---|---|---|---|
order(无 --yes) | 有:菜单 + 礼品卡 + settlement/update 报价 | 不建单、不写购物车;但不保证服务端零痕迹 | — |
order --yes / place --yes | 有 | 建单 + 礼品卡扣款 | ✅ |
cancel | 无(缺 --yes 时直接拒绝) | — | ✅ |
cart-add / clear | 有 | 会改购物车 | —(不涉及扣款) |
key --set | 无 | 写本地 .env | —(本地配置) |
shops / menu / orders / giftcards / env / needs | 有或本地 | 无 | — |
- 输出默认脱敏(token / openId / customerId / 手机号 / 卡号 / paySign)。
不要把
--no-redact的结果贴到聊天、日志或提交记录里。 - 抓包文件(
.har)含完整登录态,等同密码:用完即删,不提交、不转发。
口味与加料(--attrs / --specs)
商品的 productAttrs(温度/糖度)与 productSpecs(加料/去料/换料)就在菜单接口
/api/v3/shop/menu/info 的响应里,不需要额外抓包。
mixuebingcheng-cli order --shop <id> --product <id> --attrs "正常冰,七分糖"
mixuebingcheng-cli order --shop <id> --product <id> --attrs "少冰,五分糖" --yes
--attrs逗号分隔,名字或 attributeId 都可以;同一组(如糖度)只能选一个, 选两个直接报同一组只能选一个;商品没有该属性时报商品没有这个属性: xxx并列出可用项。- 口味不额外收费:同一商品选任何温度/糖度,
total不变。 - 是否真的生效,以下单后的订单明细为准:
orderDetailList[].attr里是[{attributeId, attributeName}],可对照所选attributeId。 - 加料(
--specs)已直接拒绝(1.11.1 起):传了--specs会在发任何网络请求之前 返回加料/规格(--specs)暂不支持。原因:settlement/update的 products 里只要specIds非空就返回4000 参数错误,已试过 6 种字段形态(specIds:[id]、specs:[{specId}]、specIds:[{specId}]、specId标量、comboProductDetail、 带specName的对象)全部失败。要支持必须先拿到一份带加料下单的抓包确认字段名, 在此之前不得承诺可用、也不得让用户走到下单阶段才失败。
常用命令
mixuebingcheng-cli needs # 采集要求
mixuebingcheng-cli init # 生成 .env 模板
mixuebingcheng-cli har 抓包.har # 导入 token / openId / customerId
mixuebingcheng-cli whoami # 验证登录态
mixuebingcheng-cli shops --lat <纬度> --lng <经度>
mixuebingcheng-cli menu --shop <shopId> --table
mixuebingcheng-cli giftcards # 礼品卡余额
mixuebingcheng-cli order --shop <id> --product <id> --num 1 # 只算价
mixuebingcheng-cli order --shop <id> --product <id> --num 1 --attrs "正常冰,七分糖" # 指定口味
mixuebingcheng-cli order --shop <id> --product <id> --num 1 --yes # 建单+礼品卡支付
mixuebingcheng-cli place --shop <id> --product <id> --yes --wait # 一步到位
mixuebingcheng-cli watch --order <orderCode> # 等取餐号
行为约束
- 卡余额不足全额时不建单,并清空购物车(不留无法支付的孤儿订单)
- 请求体不进 URL:
sign仍在本地对「query + body」合并计算,URL 只带appId/t/sign - 不做任何形式的数据上报、遥测或第三方请求
许可与免责
代码以 MIT-0 许可发布:可自由使用、修改、再分发。
使用范围上的约束只有一条:这个工具只能用来操作使用者本人的蜜雪账号, 不得代他人下单或用于经营。接口为抓包逆向所得,官方随时可能变更或轮换密钥,届时工具会失效。
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 2w ago
- Current version
- v1.0.0
- License
- MIT-0
