Crisp Grocery

该技能用于支持用户授权的 Crisp 杂货采购规划与账户信息查看。默认为只读模式，严禁执行下单、修改收货地址、更新支付信息、联系客服或结算等操作。

安全规则

• 将账户数据视为私密信息。除非用户明确要求输出某一特定字段，否则不得打印承载令牌（bearer token）、一次性登录验证码、邮箱地址、电话号码、收货地址、IBAN 片段、发票 URL 或完整的原始账户响应载荷。
• 禁止在生成的文件、示例代码、问题报告或 ClawHub 提交内容中包含任何密钥（secrets）。
• 默认仅使用只读接口（read-only endpoints）。
• 对购物篮（basket）的任何变更操作，均需获得用户明确确认，并须具体说明涉及的产品/食谱 ID、数量及预期操作类型。
• 结算、支付、地址/电话修改、账户删除、客服消息发送及订单取消等功能均不在本技能范围内，除非用户针对某项具体操作给出精确且无歧义的确认指令。
• 不得绕过身份验证、速率限制、机器人检测（bot checks）、TLS 加密、应用层控制或服务端防护机制。
• 保持低频、用户驱动的网络请求行为。在单次会话中应对 API 响应进行缓存，避免重复调用同一接口。
• 确保应用版本号 / User-Agent 可配置。若 /client 接口返回 outdated 状态块，则立即中止流程，并提示用户升级至最新版应用。

配置

推荐使用的环境变量：

• CRISP_BEARER_TOKEN：已存在的、经用户授权的 bearer token。
• CRISP_TOKEN_FILE：本地 token 文件路径。仅当 CRISP_BEARER_TOKEN 未设置时使用该变量。
• CRISP_API_BASE：默认值为 https://crispapp.nl/v1。
• CRISP_USER_AGENT：默认值为 crisp/app/android/634；当 Crisp 发布新版 Android 应用时，请根据其安装包中的 versionCode（即构建号）同步更新此值。
• CRISP_OUTPUT_DIR：默认值为 artifacts/api。

用户发起登录时的 Token 获取流程：

1. 向用户询问其用于 Crisp 登录的邮箱地址。
2. 生成一个 20 位随机字母数字组合的本地 bearer token；或复用用户显式提供的已有 token 文件。
3. 使用该 bearer token 向 POST /user/login 接口发送请求，请求体为 { "email": "...", "country": "nl" }。
4. 向用户索取其从 Crisp 收到的一次性验证码（one-time code）。
5. 使用相同的 bearer token，再次向 POST /user/login 接口发送请求，请求体为 { "email": "...", "code": "...", "country": "nl" }。
6. 仅将获取到的 token 存储于用户可控的本地密钥存储（secret store）或 token 文件中，绝不可将其嵌入技能包（skill package）内。

工作流

1. 首先调用 /client 接口检查授权状态与应用版本。若运行于 Android 平台，User-Agent 应基于已安装应用的 versionCode（构建号）动态生成，例如：crisp/app/android/634。
2. 查询配送时段与运费时，调用 /basket/main 接口。
3. 实现个性化推荐时，调用 /yourShop 接口；必要时可补充调用 /order/history 接口。
4. 获取促销信息时，调用 /promo/current 接口，并按折扣比例、欧元节省金额、用户历史行为、菜单相关性及膳食适配度进行排序。
5. 进行餐食规划（meal planning）时，结合订单历史与 /recipe/:id 接口返回的详情页数据。不可仅依赖标签（tags），须解析食材清单与过敏原信息，并据此推理可行的替代方案。
6. 加载图片资源时，使用 recipe/product 的 blob ID 构造 URL：https://crispapp.nl/blob/?thumb=。
7. 对任何拟议的购物篮修改操作，须先展示精确的变更差异（diff），并等待用户确认后方可执行。

常用命令

如当前技能目录下存在辅助脚本，请优先使用：

python3 scripts/crisp_api.py get /client
python3 scripts/crisp_api.py get /basket/main --save basket-main.json
python3 scripts/crisp_api.py get /promo/current --summary promos
python3 scripts/crisp_api.py get /yourShop --summary your-shop
python3 scripts/crisp_api.py get /order/history --summary orders
python3 scripts/crisp_api.py login-start user@example.com --country nl --token-file ./secrets/crisp_token.txt
python3 scripts/crisp_api.py login-code user@example.com 123456 --country nl --token-file ./secrets/crisp_token.txt
python3 scripts/crisp_api.py basket-add-product 6339 1 --from-screen YourShop --confirm "add product 6339 quantity 1"

参考文档

• 阅读 references/api-map.md 了解各接口的行为定义与响应载荷字段说明。
• 阅读 references/planning-rules.md 了解促销排序逻辑、餐食规划策略、膳食适配处理方式以及购物篮变更确认政策。