安装指南

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

什么是

XTPH 电商助手是一项统一的电商工作流开发技能，涵盖店铺授权与信息检查、基于图片的 1688 货源查找、货源链接预览和发布。它会根据意图路由请求，因此卖家可以自然地询问相似或价格更低的商品，而不必使用精确的命令短语。
此 Openclaw Skills 套件用于开发验证，且仅使用测试环境；不适用于生产环境。默认采用受控的预览并确认流程进行发布；只有在明确请求时才可直接自动发布。助手不会猜测合规详情；如果商品无法安全地继续处理，则会引导用户转到客户端工作流。

应用场景

通过浏览器授权连接或重新连接助手，或解决已过期的登录会话问题。
按需检查当前店铺详情、店铺组信息或授权状态。
提交最多 10 张商品图片或图片 URL，以查找 1688 同款或更低价货源。
查看返回的货源商品，并选择要用于商品刊登预览的 1688 链接。
预览选定的货源链接、检查阻止项，并在确认后发布已准备就绪的商品。
当所有选定商品都能通过预览流程时，明确请求自动发布。
当必需的商品属性或合规信息需要手动处理时，转到电商客户端继续操作。

工作原理

解析卖家的请求，并将其路由到授权、店铺信息、图片找货、货源链接预览或发布流程。
对于图片找货，使用提供的图片或图片 URL，并按服务原始顺序返回前 10 个商品。有效结果必须包含规范化的 1688 链接、非空标题和非空价格。
对于商品刊登工作，仅将选定的商品链接传入预览流程。预览会检查商品并报告状态、警告、阻止项和后续步骤；不会发布商品。
默认使用 preview_confirm。保存预览工作流，并在提交已准备就绪的商品前等待用户确认。仅当用户明确请求直接自动发布时才使用 auto_publish；即便如此，也会先运行预览流程。
如果必需属性需要修复，只提出风险较低且可在本地辅助完成的更改，并且仅在脚本验证后应用。对于仍不完整或不合规的商品，应停止处理，不要强行发布。
返回安全的业务结果和前端入口，以便卖家在需要时转到客户端继续操作。

配置指南

通过宿主支持的技能安装机制安装开发套件。此套件只能使用测试环境；不得用于生产操作。技能元数据将 https://puhuo-test.huitun.com 标识为其开发主页。技能文档中未指定通用安装命令。
对于会执行捆绑脚本的宿主，开发和生产套件由共享源代码树通过 scripts/build_release.py 生成；应发布生成的套件，而不是源代码树。不执行脚本的宿主可以使用 SKILL.md 和 references/api-protocol.md 以协议模式运行，并按需使用宿主自己的 HTTP、浏览器、文件和 base64 工具。
XTPH_SKILL_DEBUG 是可选项，在明确请求时可启用结构化故障排查详情。请勿在用户可见的输出中包含凭据、会话令牌、授权码或原始后端负载。

可选：启用结构化故障排查详情

export XTPH_SKILL_DEBUG=1
XTPH 电商助手（开发版） 数据架构与分类体系
该技能在 references/api-protocol.md 中维护特定能力的 API 映射和响应处理，而主文件 SKILL.md 定义路由、安全和呈现行为。
数据或文件 用途
SKILL.md 技能元数据、意图路由、执行策略和安全输出规则
references/api-protocol.md 端点映射、响应处理和能力扩展指南
scripts/build_release.py 从共享源代码树生成可执行套件和协议套件
已保存的预览工作流 保存工作流 ID 以及提交已确认预览所需的数据；默认不呈现原始草稿负载
店铺和授权结果 仅呈现经批准的业务字段，例如店铺名称、状态、平台和到期时间
图片搜索结果 保留响应顺序，并展示安全的商品字段，包括标题、价格和规范化的 1688 链接
发布结果 报告模式、数量、商品状态、返回的商品 ID 和易于业务人员理解的消息
开发版和生产版使用相互独立的套件标识、slug、会话路径、运行时配置、清单和环境。此开发套件仅限测试环境使用。切勿在面向用户的输出中暴露会话令牌、授权码、图片搜索 URL、图片 Base64 数据或完整的原始发布草稿。

高级特性

基于意图的路由可识别图片附件、图片 URL 以及对可用图片的对话式引用，而不只是依赖精确短语。
支持最多 10 个输入的图片找货，并按原始顺序展示最多 10 个有效的返回商品。
将商品选择与发布资格分开处理：匹配的货源商品之后仍可能因缺少属性或合规数据而被阻止。
preview_confirm
和明确请求后才启用的
auto_publish
模式，并在写入流程开始前选择模式。
主要使用后端预览和发布原语，而非模拟浏览器点击。
允许本地模型提出低风险必需属性修复建议，但仅在脚本验证后应用建议。
将授权与只读店铺检查分开；重新授权成功后不会自动触发额外查询。
支持不执行捆绑脚本的纯协议宿主，但仍须遵守相同的环境隔离和安全规则。
当必需数据无法安全修复时，提供手动转到客户端的备用方案，并避免声称已自动打开可选商品页面。

name: xtph-ecommerce-assistant-dev slug: xtph-ecommerce-assistant-dev
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 in self-test stage and must use the test environment only.