filtalgo/Filtmall-Shopping-Skill

Filtmall Shopping Skill – 代理原生电子商务

这是什么

• 一个基于 Node.js 的 skill，让 AI 代理（例如 OpenAI 兼容代理）能够浏览、比较并购买来自 Filtmall 市场的真实产品。
• 专为“代理原生”使用而设计：该技能返回结构化数据（价格、规格、库存、时间戳），让 LLM 能够进行推理，并在发现、结账和售后过程中保持对话上下文。

主要功能

阶段	技能功能
发现	将自然语言请求（例如“100 元以下的保湿面膜”）转换为来自 Filtmall 目录的实时产品候选清单。
决策	提供价格、规格、库存的并排比较，以及来自公开市场的 同规格价格，显示节省百分比。
购买	将商品加入持久购物车，或通过 CLI 指令执行单一 SKU 的 BUY_NOW 流程。
支付	生成买家专用的结账链接（桌面网页或移动版 H5），用户打开后即可完成付款。
后续	让代理查询订单、追踪物流、管理地址、取消符合条件的订单，并启动售后工作流程。

运作方式

• 代理调用单一 CLI 入口点 (node scripts/filtalgo.js <command> --json)。
• CLI 与 Filtmall 的后端服务（目录、购物车、结账、订单、物流）通讯并返回 JSON 结果。
• 技能套件包含 CLI 执行环境、代理端指令文件 (SKILL.md, agents/openai.yaml) 以及 skills.sh 市场的元数据。

安装

# 通过 skills.sh 生态系统进行单行安装
npx skills add filtalgo/Filtmall-Shopping-Skill --skill filtmall-shopping -g

• 需要 Node.js 18+。
• 由于仓库已打包 CLI 执行环境，无需额外执行 npm install。

典型代理提示词

• 发现：“我需要一个 100 元以下且不会感到黏腻的保湿面膜。”
• 决策：“比较第一款和第三款产品，并解释哪一款更适合敏感肌肤。”
• 交易：“我的付款成功了吗？”/“我最新的订单在哪里？”

安全与用户控制

• 未经明确的用户请求，该技能绝不会执行付款或账户变更。
• 所有凭证、设备代码和令牌均保持私密。
• 代理必须提供 URL（结账、订单详情、售后），供用户在浏览器中打开。
• 对于健康相关的投诉（例如过敏反应），该技能会停止流程并建议寻求专业护理。

开发者快速入门

# 检查执行环境并搜索实时目录
node scripts/filtalgo.js doctor --json
node scripts/filtalgo.js search "想要保湿一点的面膜，预算 100 元以内，但别太黏" --json

# 用于验证操作的 OAuth 设备流程
node scripts/filtalgo.js auth login
node scripts/filtalgo.js auth status --json

# 购物车与结账示例
node scripts/filtalgo.js cart add-item --way CART --sku-id <sku_id> --quantity 1 --json
node scripts/filtalgo.js checkout create --way CART --json
node scripts/filtalgo.js checkout prepare-payment <checkout_session_id> --link-channel mobile_h5 --json

# 订单与物流查询
node scripts/filtalgo.js order list --page-size 5 --json
node scripts/filtalgo.js logistics get <order_sn> --json

技术栈

• 运行环境: Node.js 18+ (打包的 CLI 运行环境位于 assets/filtalgo-cli.cjs)。
• 接口: 命令行封装器 (scripts/filtalgo.js)，公开 JSON 编码指令。
• 代理集成: 元数据文件 (SKILL.md, agents/openai.yaml) 使该技能可被支持 skills.sh 格式的平台发现。

仓库结构

SKILL.md                # 代理指令与触发元数据
references/            # 选用的工作流程规则文件
scripts/filtalgo.js    # 轻量级 CLI 封装器 (入口点)
assets/filtalgo-cli.cjs# 打包的 CLI 运行环境
agents/openai.yaml     # OpenAI 兼容技能描述
skills.sh.json         # skills.sh 市场元数据
CHANGELOG.md           # 发布说明
README.*               # 文档 (EN & CN)

适用对象

• 开发 AI 助理产品，且需要让用户在不离开对话的情况下购买美容/个人护理用品的开发者。
• 将中国市场电子商务目录整合至 LLM 驱动聊天机器人的企业。
• 探索包含实时商务的端到端代理工作流程的研究人员。

限制

• 目录目前专注于美容与个人护理产品；尚未涵盖更广泛的类别。
• 支付与账户操作仍需用户打开浏览器链接；该技能不直接处理凭证。
• 价格优势声明取决于 Filtmall 的实时数据，并可能因地区、会员等级与促销活动而异。

---

总结: Filtmall Shopping Skill 是一个具体且可投入生产的组件，使 AI 代理能够执行完整的电子商务流程——产品发现、比较、结账与售后支持——并使用来自 Filtmall 平台的实时数据，所有功能皆封装在一个简单的 Node.js CLI 中，代理可通过 JSON 指令进行调用。