Xiaotian Ecommerce Assistant

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install xtph-ecommerce-assistant
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 xtph-ecommerce-assistant。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Xiaotian Ecommerce Assistant 是一款面向电商卖家的 Openclaw Skills 套件，适用于需要连接店铺、查看店铺和授权详情、在 1688 采购商品，以及准备或发布商品刊登的卖家。卖家可以提供商品图片或图片 URL，搜索同款或价格更低的货源，然后查看返回的商品链接并创建刊登预览。
此技能将商品选择与发布分开，默认采用先预览的工作流程。除非卖家明确要求自动发布，否则只有在确认后才会发布；如果缺少必要的商品或合规信息，技能会停止操作，而不会猜测。此生产渠道 Openclaw Skills 套件连接生产服务，并以简洁、便于卖家理解的语言呈现结果。

应用场景

使用商品图片、图片 URL 或可用的图片附件，查找同款或价格更低的 1688 货源。
查看返回的商品匹配结果，并选择用于采购的 1688 链接。
生成刊登预览，检查选定的 1688 商品是否可以刊登。
卖家确认后，从已保存的预览发布商品。
在明确提出要求且选定商品已准备好预览时，执行自动发布。
通过浏览器授权连接或重新连接助手，或查看店铺详情、店铺群组信息和授权状态。
当商品属性或合规信息阻止发布时，转交给人工店铺客户端处理。

工作原理

将卖家的请求路由到相关功能：授权、店铺信息、图片货源搜索、刊登预览或发布。
对于图片货源搜索，使用提供的图片或图片 URL 搜索 1688 商品。检查结果是否包含有效商品链接、标题和价格，然后按照返回顺序最多展示前 10 条结果。
如果卖家想要刊登商品，只将选定的商品链接传入预览流程。若卖家提出一键发布请求但未选择商品，则默认使用展示结果中的前五项；如果卖家指定数量，则使用前述数量的结果。
生成预览并报告商品详情、状态、警告和阻塞原因。对于预览确认后发布的流程，保存工作流并等待卖家确认。
仅在确认后发布已就绪的商品，或者仅在卖家明确要求时使用自动发布。自动发布仍会先运行预览流程。
如果可以安全修复必填属性，则提出低风险的属性值，并且只应用通过脚本验证的提议。如果商品仍被阻止发布，则说明原因，并引导卖家使用相应的店铺客户端流程。

配置指南

通过宿主的技能注册表或安装程序安装生产套件；SKILL.md 未指定通用安装命令。生产套件只能与生产服务搭配使用。不支持内置 Python 脚本执行的宿主可以使用协议模式，配合 SKILL.md 和 references/api-protocol.md，并通过宿主自身的工具调用后端。协议模式的会话状态必须遵循该参考文档中定义的 slug 作用域路径。
可选设置 XTPH_SKILL_DEBUG 仅用于明确要求的故障排查。日常面向卖家使用时请勿设置；将其设为 1 可能会显示结构化诊断字段，但绝不会显示凭据或私有推理。
export XTPH_SKILL_DEBUG=1
Xiaotian Ecommerce Assistant 数据架构与分类体系
此套件在 references/api-protocol.md 中保存能力映射和后端协议详情。发布包由共享源代码树生成；生产套件使用独立的套件标识、运行时配置、会话存储和更新清单。仅协议模式的安装不包含脚本，也不使用 WorkBuddy 安装路径。
数据或产物 用途与处理方式
店铺和授权结果 显示安全的业务字段，例如店铺名称、ID、平台、版本、状态和过期时间。排除会话令牌和原始授权密钥。
图片搜索商品 保留响应顺序，最多展示 10 件商品。显示标题、价格和完整的标准化 1688 链接；也可能提供图片和代发价格。
已保存的预览工作流 保存后续确认发布所需的工作流 ID 和预览信息。使用已保存的工作流来组装提交数据，而不要暴露原始发布草稿。
预览和发布结果 报告数量、目标店铺、批次和任务状态、商品详情、警告、阻塞原因、已提交商品状态以及后续步骤。
本地属性修复提议 提出安全修复方案时，包含目标属性、来源证据、置信度和原因。只应用通过脚本验证的提议。
敏感或内部数据 不要向用户显示会话令牌、授权码、原始发布草稿、图片搜索 URL、图片 Base64 或上游请求/响应转储。

高级特性

基于意图的路由可以根据图片附件、图片 URL 或对可用图片的引用识别图片货源搜索请求，而不只依赖完全匹配的短语。
支持使用最多 10 张商品图片或图片 URL 搜索，并保留服务返回的商品顺序。
默认要求先预览、再确认发布；只有在明确要求时才能使用单独的自动模式。
将基于图片的商品选择与发布资格分开处理；即使选中了商品，仍可能因数据缺失、无效或不合规而无法发布。
支持本地模型提出低风险的必填属性修复方案，并在将方案应用于已保存的预览工作流之前进行脚本验证。
区分开发和生产套件的标识及环境；生产套件必须仅使用生产服务。
在没有脚本运行时的宿主上支持协议模式，按照 API 协议参考文档使用宿主的 HTTP、浏览器、文件和 Base64 工具。
使用适合卖家的生产环境回复；如果代理端处理无法完成任务，则提供前端入口以便后续跟进。

name: xtph-ecommerce-assistant slug: xtph-ecommerce-assistant
displayName: 小天铺货AI助手
version: 1.0.15
summary: 小天铺货电商助手正式版协议版，调用生产环境服务。支持店铺授权、图片找1688同款、店铺信息查询、授权状态查询和 1688 铺货预览发布等电商工作流。
license: MIT-0
description: 小天铺货AI助手正式版协议版。Use when the user asks for 小天铺货, shop authorization, shop information, source-product selection, 1688 same-style or lower-price sourcing from an image or image URL, selecting source products, previewing or publishing source links, or asks what the Skill can do. Match the user's intent and attached image context, not only exact keywords. This package is the production channel and must use the production environment only.