Knuspr CLI 技能

使用 knuspr-cli 与 Knuspr.de（德国杂货配送平台）交互——该工具为纯 Python 编写的命令行程序，已作为本技能的一部分打包在 {baseDir}/knuspr_cli.py 中。

配置要求

1. 需 Python 3.8 或更高版本（无外部依赖）
2. 登录方式：运行 python3 {baseDir}/knuspr_cli.py auth login（或设置环境变量 KNUSPR_EMAIL 和 KNUSPR_PASSWORD）
3. 最低订单金额：€39

关键规则

1. 严禁完成下单操作——仅允许构建购物车并预留配送时段。必须始终提醒用户通过 cart open 命令或 Knuspr 网站/应用自行审核并完成结算。
2. 务必使用 --json 参数，以便程序化解析输出结果。
3. 执行破坏性操作前必须确认（例如清空购物车、删除清单、释放已预约的配送时段）。
4. 向购物车添加商品时，需显示单价与小计，确保用户实时掌握费用信息。

CLI 使用方式

python3 {baseDir}/knuspr_cli.py   [options]

核心工作流

搜索商品并加入购物车

# 搜索商品（建议使用 --json 参数便于解析）
python3 {baseDir}/knuspr_cli.py product search "Hafermilch" --json
python3 {baseDir}/knuspr_cli.py product search "Käse" --bio --sort price_asc --json
python3 {baseDir}/knuspr_cli.py product search "Joghurt" --rette --json  # 折扣商品

# 加入购物车
python3 {baseDir}/knuspr_cli.py cart add  -q 
python3 {baseDir}/knuspr_cli.py cart show --json  # 查看购物车内容及总价以确认

配送时段管理

python3 {baseDir}/knuspr_cli.py slot list --detailed --json  # 列出所有可选时段及其 ID
python3 {baseDir}/knuspr_cli.py slot reserve        # 预约一个 15 分钟准时送达时段（ON_TIME）
python3 {baseDir}/knuspr_cli.py slot reserve  --type VIRTUAL  # 预约一个 1 小时窗口时段（VIRTUAL）
python3 {baseDir}/knuspr_cli.py slot current --json          # 查询当前已预约的时段
python3 {baseDir}/knuspr_cli.py slot release                 # 取消当前预约（执行前必须询问用户确认！）

购物清单管理

python3 {baseDir}/knuspr_cli.py list show --json             # 列出全部购物清单
python3 {baseDir}/knuspr_cli.py list show  --json   # 查看某清单中的具体商品
python3 {baseDir}/knuspr_cli.py list create "Wocheneinkauf"
python3 {baseDir}/knuspr_cli.py list add  
python3 {baseDir}/knuspr_cli.py list to-cart        # 将整张清单导入购物车
python3 {baseDir}/knuspr_cli.py list duplicate      # 复制一张清单

订单历史与复购

python3 {baseDir}/knuspr_cli.py order list --json
python3 {baseDir}/knuspr_cli.py order show  --json
python3 {baseDir}/knuspr_cli.py order repeat       # 将该订单中全部商品加入购物车

完整命令参考

所有命令、选项与标志的详细说明，请参阅 {baseDir}/references/commands.md。