酒云网AI助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,将 @vinehoo/vinehoo-ai-helper 安装到你的 AI 助手中。
技能介绍
在对接葡萄酒电商平台时,直接让大模型解析商品库通常会遇到响应不稳定、合规链接易被截断或改写,以及模型容易把“推荐商品”夸大成“已完成购买”的情况。@vinehoo/vinehoo-ai-helper 不重新造一套商品检索逻辑,而是把请求路由到技能根目录中经过版本校验的 vinehoo CLI,让模型负责理解意图,工具负责返回结构化 JSON。
核心工作机制
- 严格保留用户请求:技能会原样保留用户提到的前提,例如具体的预算区间、购买数量、饮用场景、款式偏好与品牌措辞,而不是让大模型自行压缩或改写需求。
- 执行环境校验:所有工具命令前都会运行
vinehoo version,只有输出精确等于vinehoo 0.1.1时才会继续执行。如果本地缺少 CLI、下载失败或版本不符,检查脚本会按系统架构重新拉取官方版本并再次校验。 - CLI 标准输出解析为 JSON:回答商品相关问题时,技能只依据 CLI 返回结果中的字段处理,不给它添加额外的编造项。
- 会话上下文保持连续:同一轮对话中会保存非空的
session_id,使围绕同一酒款或同一需求的后续追问具备上下文连续性;遇到无关用户或独立新对话时,技能不会复用旧会话。 - 授权流程优先级最高:一旦 CLI 返回授权 JSON,技能会先展示完整的原始授权 URL,然后立即调用
wait_for_auth并等待命令结束;只有在命令正常完成后,再用完整原始请求重新执行检索。
输出边界与注意点
- 只输出五项关键商品字段:当
data.products非空时,技能只展示商品标题、价格、酒款介绍、150px 宽度缩略图(带有?x-oss-process=image/resize,w_150参数)和购买链接。buy_url会被原样呈现,不截断、不补全、不重写域名或查询参数。商品图片、购买链接等字段缺失时,直接标记该结果不完整,不假造数据。如果商品推荐为空,也不会自动退回模型生成的其他内容,避免虚假推荐出现。 - 不负责结账动作:
vinehoo-cli不提供结账命令,因此技能会严格区分“推荐”与“购买”两种状态。除非工具明确返回完成状态,否则模型不会声称订单已创建、已支付或已发货。 - 满足平台支持要求:默认下载与校验流程面向 macOS、Linux 的 AMD64/ARM64 架构,以及 Windows 的 AMD64/ARM64 架构。目前不支持 Linux ARM64,遇到未支持架构时会停下说明,而不是强行处理。
- 默认搜索超时为 300 秒:除非发起方明确指定其他时长,技能会保持这个默认超时。遇到 401 时,技能会提示使用者在本地刷新授权,然后重试。
使用场景
- 在对话里把用户的预算、数量和款式偏好原样传给酒云网 CLI,返回商品推荐
- 处理授权 JSON 时,先展示完整授权链接,再执行 wait_for_auth 并复跑搜索
- 在 CLI 标准输出中解析 error_code、session_id 和 data,按字段决定应答
- 当商品缺少非空 buy_url 时,说明链接不完整,避免伪造购买入口
适合人员
- 搭建对话式导购 Agent 的后端工程师,需要稳定调用酒云网 CLI
- 编写工具型技能的开发团队,关注版本校验、JSON 解析和错误处理
- 维护购买链路、需要区分推荐与下单状态的工程师
- 处理跨会话上下文,且不能复用 session_id 的 Agent 工程师