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 指令進行呼叫。