Selva

面向 AI 智能体的购物平台。可在 Amazon 上搜索、比价并购买实体商品。

用户体验

• 语言简洁、自然，符合人类表达习惯。除非用户明确要求，否则不描述命令执行过程。
• 优先采用“结果先行”的沟通方式：
  • 推荐示例：“您已注册成功，现在可以开始搜索了。需要我为您查找 的可选商品吗？”
  • 避免示例：“CLI 已安装……API 密钥已保存……下一步命令是……”
• 仅请求完成下一步所必需的缺失信息。
• 分享链接时，在支持 Markdown 的环境中使用友好的链接标签：
  • [打开设置页面](https://...)
• 向聊天客户端展示商品列表时，每个商品应单独发送一条消息，包含：
  • 商品图片（作为照片附件）
  • 简短说明（含标题、价格、评分/评论数、预计送达时间）
  • 最后一条纯文本消息，询问用户希望打开或购买哪个商品

默认对话流程

1. 静默注册
   • 如需注册，则自动完成，并仅作简要确认。
2. 检查就绪状态
   • 若缺少姓名或地址，以自然方式向用户询问。
   • 若缺少支付卡且用户意图下单，提供设置页面链接。
3. 搜索与引导
   • 清晰呈现最优选项（标题、价格、评分、预计送达时间 / Get-it-by、图片 URL、简要推荐理由）。
   • 提出简单后续问题：“需要其中任一商品的详细信息吗？”
4. 下单购买
   • 确认用户选定的商品及支付方式。
   • 若启用了审批流程且当前触发该流程，请简要说明下一步操作。

初始化配置

1. npx selva-cli register — 生成 API 密钥，并本地存储于 ~/selva/config.json
2. npx selva-cli settings set-name --name "Jane Doe" — 下单前必填
3. npx selva-cli settings set-address --street "123 Main St" --line2 "Apt 4B" --city "Austin" --state "TX" --zip "78701" --country "US" — 下单前必填（--line2 为可选参数）
4. 可选：设置电话号码：npx selva-cli settings set-phone --phone "+14155551234"
5. 可选：设置邮箱用于接收订单收据和审批通知：npx selva-cli settings set-email --email "you@example.com"
6. 在网页版设置页面中绑定支付卡，并可选设置审批阈值：npx selva-cli settings page

命令说明

搜索

npx selva-cli search ""
返回最多 10 条标准化结果，字段包括：selva_id、标题、价格、评分、来源、URL、delivery_estimate（即 Get-it-by 时间）、image_url。
向用户展示搜索结果时，必须始终包含预计送达时间 / Get-it-by 文本。
优先采用“一张图 + 一段说明文字”的独立消息形式（每件商品一条消息），而非 Markdown 图片链接。
提供地址可获得最佳搜索结果，但无地址时仍可运行。

详情

npx selva-cli details
从原始供应商处获取完整商品详情。请使用搜索结果中的 selva_id（例如：amzn_B0EXAMPLE）。

购买

npx selva-cli buy --method
需已配置姓名、地址及可用的支付卡档案。下单将创建订单记录，并返回其当前状态。
若已配置审批阈值且商品价格超过该阈值，则订单状态变为 awaiting_approval，并发送审批邮件。

选项说明：

• --method saved — 使用网页设置页面中已绑定的支付卡。若未绑定任何卡片，命令失败；此时应提示用户前往设置页面绑定卡片。
• --method card --number --exp --cvv — 通过 Stripe 对卡片信息进行令牌化处理，并保存一份可用于后续处理的支付方式快照。卡片敏感信息不会传输至 Selva API。