{"id":"9030f6c5-1e8e-4062-bc79-bde968456564","entityType":"agent","slug":"clawhub-1688aiinfra-1688-distribution","name":"1688 Distribution","canonicalUrl":"https://www.xpersona.co/agent/clawhub-1688aiinfra-1688-distribution","canonicalPath":"/agent/clawhub-1688aiinfra-1688-distribution","generatedAt":"2026-10-11T14:16:20.782Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T10:20:45.185Z","emptyReason":null},"description":"1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Skill: 1688 Distribution Owner: 1688aiinfra Summary: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-05-06T02:41:54.490Z | auto Initial release of the 1688-distribution skill — unified entry for all 1688 distribution business workflows. - Provides a single command-line interface for product selection/","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s177df9srv6z2y0gd1kw90rern83hzxb:1688-distribution","sourceUrl":"https://clawhub.ai/1688aiinfra/1688-distribution","homepage":"https://clawhub.ai/1688aiinfra/skills/1688-distribution","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/1688aiinfra/1688-distribution","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/1688aiinfra/skills/1688-distribution","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Skill: 1688 Distribution Owner: 1688aiinfra "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:20:45.185Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:20:45.185Z","emptyReason":null},"stars":null,"forks":null,"downloads":1089,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:20:45.114Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T10:20:45.185Z","lastCrawledAt":"2026-10-11T10:20:45.114Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T10:20:45.114Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-05-06T02:41:54.490Z","changelog":"Initial release of the 1688-distribution skill — unified entry for all 1688 distribution business workflows. - Provides a single command-line interface for product selection/distribution, order management, knowledge-base query, and shop binding. - Strict output, error-handling, and compliance rules: no fabricated data, no unauthorized brand distribution, no extra suggestions or guidance in user responses. - Requires reference.md to be read before any business CLI is executed, ensuring command schema accuracy. - Automatic, silent handling of Access Key (AK) authorization; never exposes AK details or links to users. - Covers full flow for product selection, shop confirmation, distribution, order queries, risk handling, and knowledge search, with explicit markdown output formats. - Includes comprehensive, codified business restrictions and exception handling to ensure compliance with 1688 distribution requirements.","fileCount":46,"zipByteSize":75871}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177df9srv6z2y0gd1kw90rern83hzxb:1688-distribution","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T14:16:20.781Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T10:20:45.185Z","emptyReason":null},"readme":"Skill: 1688 Distribution\n\nOwner: 1688aiinfra\n\nSummary: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-05-06T02:41:54.490Z | auto\n\nInitial release of the 1688-distribution skill — unified entry for all 1688 distribution business workflows.\n\n- Provides a single command-line interface for product selection/distribution, order management, knowledge-base query, and shop binding.\n- Strict output, error-handling, and compliance rules: no fabricated data, no unauthorized brand distribution, no extra suggestions or guidance in user responses.\n- Requires reference.md to be read before any business CLI is executed, ensuring command schema accuracy.\n- Automatic, silent handling of Access Key (AK) authorization; never exposes AK details or links to users.\n- Covers full flow for product selection, shop confirmation, distribution, order queries, risk handling, and knowledge search, with explicit markdown output formats.\n- Includes comprehensive, codified business restrictions and exception handling to ensure compliance with 1688 distribution requirements.\n\nArchive index:\n\nArchive v0.1.0: 46 files, 75871 bytes\n\nFiles: README.md (839b), scripts/__init__.py (0b), scripts/_sys/__init__.py (0b), scripts/_sys/_ak_crypto.py (6457b), scripts/_sys/_auth.py (3974b), scripts/_sys/_authorize.py (8776b), scripts/_sys/_callback_server.py (15138b), scripts/_sys/_const.py (2889b), scripts/_sys/_errors.py (1720b), scripts/_sys/_http.py (5953b), scripts/_sys/_output.py (2354b), scripts/_sys/_skill_discovery.py (7203b), scripts/biz/__init__.py (0b), scripts/biz/const.py (754b), scripts/biz/distribute_helper/__init__.py (0b), scripts/biz/distribute_helper/cmd.py (4239b), scripts/biz/distribute_helper/reference.md (3844b), scripts/biz/distribute_helper/service.py (3222b), scripts/biz/knowledge_helper/__init__.py (0b), scripts/biz/knowledge_helper/cmd.py (2334b), scripts/biz/knowledge_helper/reference.md (6118b), scripts/biz/knowledge_helper/service.py (4143b), scripts/biz/offer_info/__init__.py (0b), scripts/biz/offer_info/cmd.py (3056b), scripts/biz/offer_info/reference.md (4343b), scripts/biz/offer_info/service.py (4039b), scripts/biz/order_helper/__init__.py (0b), scripts/biz/order_helper/cmd.py (3954b), scripts/biz/order_helper/reference.md (8514b), scripts/biz/order_helper/service.py (20505b), scripts/biz/product_search_helper/__init__.py (0b), scripts/biz/product_search_helper/cmd.py (2042b), scripts/biz/product_search_helper/reference.md (11945b), scripts/biz/product_search_helper/service.py (6183b), scripts/biz/shop_info/__init__.py (0b), scripts/biz/shop_info/cmd.py (1590b), scripts/biz/shop_info/reference.md (3691b), scripts/biz/shop_info/service.py (1952b), scripts/capabilities/__init__.py (61b), scripts/capabilities/configure/__init__.py (64b), scripts/capabilities/configure/cmd.py (3907b), scripts/capabilities/configure/service.py (2270b), scripts/cli.py (5989b), skill-card.md (2854b), SKILL.md (12692b), _meta.json (136b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: 1688-distribution\ndescription: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。\nmetadata: {\"openclaw\": {\"emoji\": \"🚀\", \"version\": \"1.0.0\", \"requires\": {\"bins\": [\"python3\"]}}}\n---\n\n# 1688 分销\n\n统一入口：`python3 scripts/cli.py <command> [options]`\n\n所有命令输出 JSON：`{\"success\": bool, \"markdown\": str, \"data\": {...}}`\n\n**展示时直接输出 `markdown` 字段内容，禁止在后面追加任何\"后续建议\"\"操作指引\"\"后续操作\"等自创内容（无论是否含链接）。**\n\n## ⚠️ 核心限制\n\n**失败时直接告知用户，不编造！**\n\n```\n❌ 禁止：编造商品数据、伪造链接、臆测店铺信息、用搜索引擎补充数据、改写CLI返回结果...\n✅ 仅允许：原样输出CLI工具返回的markdown，禁止擅自增加额外内容；失败时告知用户原因\n```\n\n**严格禁止（NEVER DO）：**\n\n1. 🚫 禁止编造数据/链接 — 所有数据必须来自接口返回，不得自行构造 URL\n2. 🚫 禁止未经确认执行铺货 — 铺货不可逆，必须用户明确确认商品和目标店铺\n3. 🚫 禁止品牌未授权商品铺货 — `isBrandOffer=true` 且 `isBrandAuth=false` 绝对不能铺货\n4. 🚫 禁止擅自添加筛选条件 / 改写用户原话 / 猜测渠道和店铺\n5. 🚫 禁止向用户展示授权链接 — 浏览器授权流程中不得将 URL 展示给用户\n6. 🚫 禁止使用搜索引擎、访问外部网站获取业务数据\n7. 🚫 禁止失败后自行重试、补充、编造 — 直接告知用户失败原因，等待指示\n8. 🚫 **禁止在任何操作完成后追加\"后续建议\"\"后续操作\"\"操作指引\"等内容** — 无论是否含链接，一律不加\n9. 🚫 **禁止在未阅读 reference.md 前执行任何业务命令** — 必须**先 read_file 加载对应 reference.md → 再执行命令**。命令的动作名、参数名、参数格式必须从 reference.md 中获取，不得凭记忆或猜测拼凑\n\n---\n\n## AK 授权处理\n\nAK（Access Key）用于身份认证，存储在 `{workspace}/.1688-AK/.ak_store.json`。\n\n**授权检查**：任何业务操作前执行 `python3 scripts/capabilities/configure/cmd.py --status`，已授权则直接执行，同一会话内无需重复检查。\n\n**未授权时自动处理（静默执行，不询问用户）：**\n\n```\n1. 执行：python3 scripts/capabilities/configure/cmd.py --get-ak\n2. 命令输出 JSON（含 action: \"browser_use\" 和 url）\n3. 必须使用 browser_use 工具打开该 url（不是展示给用户）\n4. 执行 --status 确认 AK 已配置\n5. 继续执行原查询\n```\n\n**禁止**：将授权链接展示给用户 / 让用户手动打开 / 向用户提及 AK、授权等细节。\n\n**手动配置 AK**（浏览器获取失败时的兜底）：\n1. 用户前往 https://clawhub.1688.com/ 登录后右上角点击🔑复制 AK\n2. 执行：`python3 scripts/capabilities/configure/cmd.py <AK值>`\n3. `--status` 确认\n\n**重置 AK**：`python3 scripts/capabilities/configure/cmd.py --reset <新AK值>`，或 `--clear` 后重新授权。\n\n---\n\n## 意图判断\n\n| 用户意图 | 路由到 | 触发关键词 |\n|---------|--------|------------|\n| 选品 + 铺货 | [选品铺货助手](#选品铺货助手) | 选品、找商品、推荐、铺货、上架、分销 |\n| 订单管理 | [订单助手](#订单助手) | 查订单、退款、风险订单、催发、催揽、旺旺 |\n| 知识查询 | [知识库助手](#知识库助手) | 怎么操作、教程、流程、指南、发货流程 |\n| 查店铺 | [店铺查询](#店铺查询) | 查店铺、绑店、授权 |\n| 重置 AK | [AK 授权处理](#ak-授权处理) | 重新设置 AK、重置 AK、更新 AK |\n\n> 判断不清时优先询问用户意图，不要猜测。与1688分销无关的话题不触发本技能。\n\n---\n\n## ❗ 执行前置（最高优先级）\n\n> ⛔ **铁律：先读文档 → 再执行命令。read_file 加载对应 reference.md 之前，禁止执行该场景的任何 CLI 命令。**\n\n| 业务场景 | 执行前必须阅读的参考文档 |\n|---------|---------------------|\n| 选品（关键词/图搜） | `scripts/biz/product_search_helper/reference.md` |\n| 分销参谋（商品详情） | `scripts/biz/offer_info/reference.md` |\n| 铺货执行 | `scripts/biz/distribute_helper/reference.md` |\n| 店铺查询 | `scripts/biz/shop_info/reference.md` |\n| 订单管理 | `scripts/biz/order_helper/reference.md` |\n| 知识库查询 | `scripts/biz/knowledge_helper/reference.md` |\n\n同一会话内后续重复调用可复用已加载知识，无需重复阅读。\n\n---\n\n## 选品铺货助手\n\n流程：**检查AK → 选品 → 决策分析 → 确认店铺 → 铺货 → 结果反馈 → 后续触发**\n\n> 每步执行前须确保已阅读对应 reference.md（见[执行前置](#-执行前置最高优先级)）。\n\n### 第一步：选品（用户已有商品 ID 时跳过）\n\n根据用户输入自动选择模式：\n- **文字描述** → 关键词选品（`distribution_select_offer`）\n- **图片链接/文件** → 图搜选品（`same_img_offer_search`）\n\n**选品数量策略** — 超量请求再精选，防止接口去重/过滤导致不足：\n\n| 用户要求 N | 实际请求 page_size | 说明 |\n|-----------|-------------------|------|\n| N ≤ 25 | min(N × 2, 50) | 请求 2 倍，精选 N 个 |\n| 25 < N ≤ 50 | 50 | 已达上限 |\n| 未指定 | 20 | 取前 10 个候选 |\n\n精选优先级：代发价低 > 30天分销单量高 > 服务好（包邮、一件代发、退货保障）。展示时以实际精选数量为准，禁止虚报。\n\n### 第二步：选品决策分析（选品后自动执行）\n\n对每个候选商品查询分销参谋数据，查询失败的静默过滤。综合分析推荐理由和风险，按推荐指数排序展示，询问用户确认。\n\n**🚫 品牌授权检查（必须执行）**：当 `isBrandOffer=true` 且 `isBrandAuth=false` 时，该商品**不能铺货**（侵权风险），展示时标记 `🚫 不可铺货`，并给出授权链接：\n> `https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId}`\n\n### 第三步：确认目标店铺\n\n调用 `shop_and_tool_info` 查询店铺列表，过滤已过期的工具/店铺：\n- **单店铺** → 直接使用\n- **多店铺** → **必须列出所有可用店铺，等待用户指定，禁止自动选择**\n\n### 第四步：执行铺货\n\n调用铺货接口，根据 errorCode 展示结果反馈。\n\n### 第五步：铺货后续触发（自动执行）\n\n铺货完成后，若会话中有选品候选列表，自动检查未铺货商品，询问用户是否继续。\n\n---\n\n## 订单助手\n\n流程：**检查AK → 查询订单 → 催发催揽 → 查询商家回复**\n\n### 查询订单\n\n根据用户意图构造查询参数（订单 ID / 时间范围 / 状态 / 退款状态），无条件时默认查当天。展示订单统计、列表、风险订单、退款订单。\n\n### 催发催揽（有风险订单时）\n\n从查询结果筛选风险订单，按卖家分组，为每个卖家生成催发消息并通过旺旺发送。\n\n### 查询商家回复（用户主动触发）\n\n催发后告知用户商家通常 5-10 分钟回复，用户要求查询时用 `task_id` 调用 `query_reply`。\n\n---\n\n## 知识库助手\n\n流程：**检查AK → 解析意图 → 确认渠道/工具 → 检索知识库 → 总结输出**\n\n识别 query（原封不动）、渠道、工具三要素，用户未明确时**必须先询问**。query 参数严禁改写，必须传递用户原话。按参考文档中的召回判断规则和展示格式输出。\n\n---\n\n## 店铺查询\n\n调用 `shop_and_tool_info` 查询绑定的分销工具和店铺，自动过滤已过期项。\n\n- **单店铺** → 直接使用\n- **多店铺** → **必须列出所有可用店铺，等待用户指定目标店铺，禁止自动选择**\n- **未绑定店铺（toolList 为空）** → 输出绑店引导：\n\n> 您还没有绑定店铺到 1688 分销系统，需要先完成绑店才能铺货。\n>\n> ### 绑店步骤\n> 1. 进入绑店页面，选择下游平台（抖音/淘宝/拼多多等）\n> 2. 授权 1688 分销工具，勾选\"我同意并签署协议\"\n> 3. 订购并授权下游工具（铺货工具 + 交易工具）\n> 4. 确认显示\"已授权\"后，绑店完成\n>\n> **绑店入口：**\n> - [一件代发页面](https://air.1688.com/app/channel-fe/search/index.html?#/result)\n> - [AI 工作台绑店](https://air.1688.com/app/channel-fe/distribution-work/ai-assistant.html#/multi-agent-shop-binding)\n>\n> 遇到问题可加入官方钉钉群（群号：41361847）咨询。绑店完成后告诉我，我继续帮您铺货。\n\n查询完成后主动询问用户是否需要铺货或其他操作。\n\n---\n\n## 输出格式\n\n### 选品结果展示\n\n> ❗ **每个商品必须包含链接**，格式：`[{offerId}](https://detail.1688.com/offer/{offerId}.html)`，嵌入到商品ID中。缺少链接 = 严重错误。\n\n**卡片格式（≤3个商品）：**\n```\n### [{offerId}](https://detail.1688.com/offer/{offerId}.html) {title}\n**代发价**：¥{dfPrice}（邮费 ¥{dfPost}） | **30天分销单量**：{fxOrdCnt30d}\n**风险提示**：🚫 品牌未授权不可铺货 → [申请授权](https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId})\n```\n\n**表格格式（>3个商品）：**\n```\n| 商品ID | 商品名称 | 代发价 | 邮费 | 30天分销单量 |\n|--------|----------|--------|------|------------|\n| [{offerId}](https://detail.1688.com/offer/{offerId}.html) | {title} | ¥{dfPrice} | ¥{dfPost} | {fxOrdCnt30d} |\n```\n\n⚠️ 输出前逐行自检\"商品ID\"列是否含链接，缺失则补全后再输出。品牌未授权商品在表格后单独标注风险提示。\n\n### 铺货结果展示\n\n铺货命令返回的 `markdown` 字段已是完整回复，**直接原样转发给用户，不得修改、不得追加任何内容**。调用时传入 `shop_name` 和 `tool_name` 参数。铺货后若有未铺商品，询问用户是否继续。**禁止追加\"后续操作建议\"等任何自创内容。**\n\n### 订单列表展示\n\n```\n## 订单查询结果\n**查询范围**：{时间范围} | **总计**：{totalCount} 笔\n| 订单号 | 状态 | 商品 | 金额 | 卖家 |\n|--------|------|------|------|------|\n| {orderId} | {orderStatusText} | {productName} | ¥{fee} | {seller} |\n⚠️ 风险订单：{N} 笔（需及时催发）\n```\n\n---\n\n## Tool 总览\n\n| 工具名 | 用途 | 调用方式 |\n|--------|------|----------|\n| `distribution_select_offer` | 关键词选品 | `python3 scripts/cli.py product_search_helper search --filters='[...]'` |\n| `same_img_offer_search` | 图搜选品 | `python3 scripts/cli.py product_search_helper search --image_url=\"...\"` |\n| `distribution_offer_info` | 商品分销参谋 | `python3 scripts/cli.py offer_info query --offer_id=\"...\"` |\n| `shop_and_tool_info` | 店铺和工具列表 | `python3 scripts/cli.py shop_info query` |\n| `distribute_offer` | 铺货到下游店铺 | `python3 scripts/cli.py distribute_helper execute --app_key=\"...\" --shop_code=\"...\" --channel=\"...\" --offer_ids=\"...\"` |\n| `fx_query_order` | 查询分销订单 | `python3 scripts/cli.py order_helper query [--order_id=...] [--order_status=...]` |\n| `fx_send_ww` | 旺旺催发 | `python3 scripts/cli.py order_helper send --question=\"...\" --order_ids=...` |\n| `fx_ww_reply` | 查询商家回复 | `python3 scripts/cli.py order_helper query_reply --task_id=...` |\n| `distribution_knowledge_tool` | 分销知识库 | `python3 scripts/cli.py knowledge_helper query --query=\"...\" [--channel=\"...\"] [--business=\"...\"]` |\n\n---\n\n## 异常处理\n\n| 场景 | 处理方式 |\n|------|----------|\n| AK 未授权 | 自动执行 `configure --get-ak`；失败则引导用户手动配置 |\n| 所有工具均已过期 | 提示用户续订分销工具 |\n| `result.success` 为 false | 根据返回的 `markdown` 或 `message` 给出失败原因 |\n| 接口调用异常 | 提示检查网络或联系技术支持 |\n| 未绑定店铺 | 输出绑店引导话术 |\n| 品牌商品未授权 | 不能铺货，引导申请品牌授权 |\n\n**核心原则**：失败时直接告知用户，不要尝试其他方式获取或补充数据。\n\n**全局输出规则**：所有操作（铺货、选品、订单查询、知识库等）完成后，只输出工具返回的结果，**禁止在末尾追加任何\"后续操作建议\"\"后续建议\"\"操作指引\"等自创内容（无论是否含链接）**。\n\nFile v0.1.0:README.md\n\n免责声明：\n1、您理解并同意，技能运行结果和输出内容可能因适用的AI agent、大模型不同而产生差异或幻觉，请您对重要的信息进行甄别核实。\n2、您应妥善保管您的Access Key（AK），这是您运行1688技能的身份凭证，请勿提供给第三人，避免身份凭证泄露造成损失。\n3、您下载安装1688技能运行时应始终保持其完整性，不得擅自篡改技能的代码、相关文件或其他内容，否则1688不对技能运行结果和输出内容承担任何法律责任。\n4、受限于当前技术发展，我们无法保证技能所有运行结果、输出内容的准确性、真实性、时效性，请您谨慎核实技能运行结果和输出内容，除法律规定由我们承担赔偿责任的场景外，我们不承担其他赔偿责任。\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn76msg8cwkep3b08z7zffx9fx82p5wj\",\n  \"slug\": \"1688-distribution\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1778035314490\n}\n\nFile v0.1.0:scripts/biz/distribute_helper/reference.md\n\n# 铺货执行参考文档\n\n将 1688 商品铺货到用户的下游店铺（抖音、拼多多、淘宝等）。\n\n---\n\n## 一、CLI 调用\n\n```bash\npython3 scripts/cli.py distribute_helper execute \\\n  --app_key=\"{appKey}\" \\\n  --shop_code=\"{shopCode}\" \\\n  --channel=\"douyin\" \\\n  --offer_ids=\"983715805496,983715805497\" \\\n  --shop_name=\"大小姐精品铺子\" \\\n  --tool_name=\"逸淘分销铺货\"\n```\n\n### 接口工具名\n\n`distribute_offer`\n\n### 参数说明\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `app_key` | 是 | 三方服务商唯一标识，从 shop_info 查询结果的 `toolList[].appKey` 获取 |\n| `shop_code` | 是 | 目标店铺编码，从 shop_info 查询结果的 `shopList[].shopCode` 获取 |\n| `channel` | 是 | 渠道标识（如 `douyin`、`pinduoduo`、`taobao`），从 shop_info 查询结果获取 |\n| `offer_ids` | 是 | 商品 ID，多个用英文逗号分隔，如 `\"983715805496,983715805497\"` |\n| `shop_name` | 否 | 店铺名称（用于展示），从 shop_info 查询结果的 `shopList[].shopName` 获取 |\n| `tool_name` | 否 | 铺货工具名称（用于展示），从 shop_info 查询结果的 `toolList[].appName` 获取 |\n\n> 接口实际传参：`outShopListStr` 为 `[{\"code\":\"{shopCode}\",\"channel\":\"{channel}\"}]` 的 JSON 序列化字符串，CLI 内部自动拼装。\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"errorCode\": \"200\",\n    \"failCount\": 0,\n    \"successCount\": 1,\n    \"allCount\": 1,\n    \"appKey\": \"{appKey}\",\n    \"brandInvalidOfferIds\": [],\n    \"successOfferIds\": [\"983715805496\"],\n    \"failOfferIds\": []\n  }\n}\n```\n\n---\n\n## 二、结果反馈\n\n根据返回的 `errorCode` 字段给出对应提示：\n\n| errorCode | 含义 | 向用户展示的提示 |\n|-----------|------|----------------|\n| `200` / `0` | 全部成功 | ✅ 铺货完成！成功 {successCount} 件，共 {allCount} 件 |\n| `210` | 部分成功 | ⚠️ 铺货部分成功。成功 {successCount} 件，失败 {failCount} 件，共 {allCount} 件 |\n| `511` | 店铺授权失效 | ❌ 铺货失败：下游店铺授权信息已失效，请重新授权后再试 |\n| `512` | 未完成铺货设置 | ❌ 铺货失败：您未完成铺货设置，请先完成设置后再铺货 |\n| 其他 | 三方工具服务错误 | ❌ 铺货失败：三方工具服务请求错误，请稍后重试或联系技术支持 |\n\n### 反馈模板\n\n铺货命令返回的 JSON 中 `markdown` 字段已是完整的用户回复。**直接将 `markdown` 原样转发给用户，不得修改或追加任何内容。**\n\n`markdown` 输出示例：\n```\n✅ 铺货完成！成功 1 件，共 1 件\n店铺：大小姐精品铺子 | 铺货工具：逸淘分销铺货\n- 成功商品 ID：700407352258\n\n---\n\n> ℹ️ 铺货结果到此结束。如有未铺货商品，请询问用户是否继续。\n```\n\nAgent 收到后只做两件事：\n1. 原样转发 `markdown` 给用户\n2. 如有未铺货商品，询问用户是否继续\n\n**不得追加任何链接或额外文字，禁止增加‘后续操作建议’**。\n\n> `errorCode` 为 `200`、`0` 或 `210` 时视为整体成功（`success: true`），其他均为失败。\n\n---\n\n## 三、注意事项\n\n- 铺货前必须先通过 shop_info 确认目标店铺，获取 `appKey`、`shopCode`、`channel`\n- 品牌商品（`brandInvalidOfferIds` 非空）铺货会失败，且有侵权风险。铺货前必须检查品牌授权状态（在选品决策分析阶段已检查），未授权商品引导用户申请授权：`https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId}`\n- 单次铺货支持多个商品 ID，用逗号分隔\n- **不得编造链接**：铺货结果反馈中只展示接口实际返回的数据，不得自行构造任何 URL（如\"查看铺货进度\"、\"采购设置\"、\"自动售后\"等链接均为虚构，会导致 404）\n\nFile v0.1.0:scripts/biz/knowledge_helper/reference.md\n\n# 知识库助手参考文档\n\n查询 1688 分销知识库，获取发货流程、铺货操作、订单管理等分销相关文档。支持按渠道（21 个）和工具（24 个）筛选。\n\n**完整流程：解析意图 → 确认渠道/工具 → 检索知识库 → 判断召回 → 总结输出**\n\n---\n\n## 一、CLI 调用\n\n```bash\n# 默认查询（不限渠道和工具）\npython3 scripts/cli.py knowledge_helper query --query=\"铺货流程\"\n\n# 指定渠道和工具\npython3 scripts/cli.py knowledge_helper query --query=\"发货\" --channel=\"抖音\" --business=\"自动分销\"\n\n# 列出所有支持的渠道\npython3 scripts/cli.py knowledge_helper channels\n\n# 列出所有支持的工具\npython3 scripts/cli.py knowledge_helper businesses\n```\n\n### 接口工具名\n\n`distribution_knowledge_tool`\n\n### 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `query` | string | 是 | 用户查询问题，**原封不动传递用户原话，严禁修改** |\n| `channel` | string | 否 | 渠道中文名（如 \"抖音\"），未指定时传 `\"default\"` |\n| `business` | string | 否 | 工具中文名（如 \"逸淘分销铺货\"），未指定时传 `\"default\"` |\n\n### 返回结构\n\n`data` 为精排后的文档数组（最多 20 条），每条包含：\n\n| 字段 | 说明 |\n|------|------|\n| `score` | 相关度分数（0-1，越高越相关） |\n| `chunking_val` | 文档正文内容 |\n| `source_url` | 原始文档链接 |\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"data\": [\n      {\n        \"score\": 0.99,\n        \"chunking_val\": \"工具名称：逸淘分销铺货;内容：...\",\n        \"source_url\": \"https://peixun.1688.com/article/xxx\"\n      }\n    ]\n  }\n}\n```\n\n---\n\n## 二、query 原则（必须严格遵守）\n\n- **不要去掉任何词语**\n- **不要改写、精简或翻译用户问题**\n- 原封不动地将用户原话作为 query 参数传递\n- **唯一例外**：召回结果与用户问题完全无关时，才允许对 query 做极小调整（仅补充 1-2 个关键词），重试仅允许 1 次\n\n---\n\n## 三、渠道与工具确认（强制询问）\n\n**如果用户没有明确说明渠道和工具，必须先询问用户，不能跳过！**\n\n- 用户明确提到了渠道和工具 → 直接使用中文名称传参\n- 用户未明确渠道或工具（即使只缺一个） → **必须停下来追问**，使用以下话术：\n\n```\n为了给您提供更精准的知识，请告诉我您想查询的渠道和工具：\n\n📱 **渠道**（您的店铺所在平台）：\n淘宝、天猫、抖音、拼多多、快手、小红书、京东、微信小店、有赞、微店、淘特、快团团、微信小商店、支付宝、苏宁、闲鱼、饿了么、美团、度小店、微盟、微购相册\n或选择\"不限\"使用通用知识库\n\n🔧 **工具**（您使用的分销工具）：\n逸淘分销铺货、自动分销、代发助手王、店长铺货、妙手分销、速当家分销、智淘分销、甩手易分销、无忧分销王、晓风分销、大泽云铺货、顶卖分销、铺货代发、1688官方铺货、普云铺货、麦爆了分销、马上分销、掌中宝分销、智汇分销、微购相册、抖掌柜分销、旺分销铺货、小天分销、火牛分销王\n或选择\"不限\"使用通用知识库\n\n请直接回复渠道和工具名称，例如：\"淘宝 + 逸淘分销铺货\"\n```\n\n**然后停止，等待用户回复，不要继续执行任何操作！**\n\n用户回复\"不限\"或\"默认\"时，对应参数传 `\"default\"`。\n\n---\n\n## 四、召回结果判断\n\n拿到 `data` 数组后，在总结之前先做相关性判断：\n\n**直接进入总结（满足任一条件）：**\n- 最高 `score` ≥ 0.3\n- `chunking_val` 内容与用户问题有明显关联（哪怕 score 较低）\n- 有任意文档内容提到了用户问题中的核心关键词\n\n**允许调整 query 重试 1 次（需同时满足）：**\n- 所有文档的 `score` 都低于 0.15\n- 且 `chunking_val` 内容与用户问题完全无关\n\n**重试规则：**\n- 仅允许重试 **1 次**，不得多次重试\n- query 调整方式：仅提取用户问题中最核心的 1-2 个关键词，不得大幅改写\n- 重试后无论结果如何，直接进入总结\n\n---\n\n## 五、结果展示格式\n\n基于检索到的文档，按以下格式输出：\n\n### 查询总结（详细版）\n\n```\n## 查询总结\n\n根据知识库，关于「[用户问题]」的完整操作指南如下：\n\n### 操作步骤\n\n**第 1 步：[步骤名称]**\n[详细说明这一步要做什么，在哪里操作]\n[如果文档中有图片，必须展示：![操作示意图](图片URL)]\n\n**第 2 步：[步骤名称]**\n[详细说明]\n[相关图片]\n\n...\n\n### 注意事项\n- [从文档中提取的重要提示]\n- [常见问题或特殊情况说明]\n```\n\n### 详细参考\n\n列出相关度较高的文档（score > 0.3），每篇包含：\n- 关键内容（不要过度精简，保留操作细节）\n- 文档中的所有图片（使用 markdown 图片语法展示）\n- 来源链接（`source_url`）\n- 相关度评分（`score`）\n\n### 总结要求\n\n1. **精准解决问题**：直接回答用户的问题，不能泛泛而谈\n2. **保留图片信息**：文档中的图片链接必须完整保留，使用 `![图片说明](图片URL)` 格式展示\n3. **步骤详细列举**：操作步骤逐步编号，每步清晰说明\n4. **内容不能过于简短**：至少包含完整的操作流程，不能省略关键细节\n\n---\n\n## 六、渠道与工具列表\n\n### 21 个渠道\n\n淘宝、天猫、抖音、拼多多、快团团、小红书、快手、微信小店、京东、有赞、微店、淘特、微信小商店、支付宝、苏宁、闲鱼、饿了么、美团、度小店、微盟、微购相册\n\n### 24 个工具\n\n逸淘分销铺货、自动分销、代发助手王、店长铺货、妙手分销、速当家分销、智淘分销、甩手易分销、无忧分销王、晓风分销、大泽云铺货、顶卖分销、铺货代发、1688官方铺货、普云铺货、麦爆了分销、马上分销、掌中宝分销、智汇分销、微购相册、抖掌柜分销、旺分销铺货、小天分销、火牛分销王\n\nFile v0.1.0:scripts/biz/offer_info/reference.md\n\n# 商品分销参谋数据查询参考文档\n\n> 本文档供 AI 在需要查询商品详细分销参谋数据时按需加载。\n\n## 接口信息\n\n- **工具名**：`distribution_offer_info`\n- **参数**：`{\"offerId\": \"商品ID\"}`\n- **用途**：查询单个商品的分销参谋详情，包括分销价、渠道支持、参谋指标、运费、服务保障、品牌信息等\n\n## 调用方式\n\n```bash\npython3 scripts/cli.py offer_info query --offer_id=\"1021484012198\"\n\n# 提取决策因素（用于选品分析）\npython3 scripts/cli.py offer_info query --offer_id=\"1021484012198\" --decision=true\n```\n\n## 返回数据结构\n\n### 核心字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `offerId` | Long | 商品 ID |\n| `priceInInfo` | Object | 分销价信息 |\n| `supportList` | Array | 支持的面单渠道列表 |\n| `adviseList` | Array | 代发参谋建议数据（核心指标） |\n| `freightInfo` | Object | 运费信息 |\n| `protectionInfoList` | Array | 分销服务保障列表 |\n| `brandInfo` | Object | 品牌分销信息（仅品牌商品） |\n| `downstreamPerformance` | Object | 下游渠道表现 |\n| `goodsOwnerInfo` | Object | 货主信息 |\n| `alreadyUpgrade` | Boolean | 是否已升级为分销品 |\n\n### 分销价信息（priceInInfo）\n\n| 字段 | 说明 |\n|------|------|\n| `onePiecePriceInteger` + `onePiecePriceDecimal` | 一件包邮价 |\n| `multiPiecePriceInteger` + `multiPiecePriceDecimal` | 分销专属价 |\n| `startNum` | 起批量 |\n| `onePieceFreePostage` | 是否支持一件包邮 |\n| `freepostage` | 多件是否包邮 |\n\n### 运费信息（freightInfo）\n\n| 字段 | 说明 |\n|------|------|\n| `freeDeliverFee` | 是否包邮 |\n| `officialLogistics` | 是否官方物流 |\n| `totalCost` | 运费金额 |\n\n### 品牌信息（brandInfo）\n\n| 字段 | 说明 |\n|------|------|\n| `isBrandOffer` | 是否品牌商品 |\n| `isAuth` | 当前买家是否已获得品牌授权 |\n| `brandName` | 品牌名称 |\n\n> 🚫 **品牌授权检查（重要）**：当 `isBrandOffer=true` 且 `isAuth=false` 时，该商品 **不能铺货**，否则有侵权风险。必须引导用户先申请品牌授权：\n> `https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId}`\n\n### 下游渠道表现（downstreamPerformance）\n\n| 字段 | 说明 |\n|------|------|\n| `highExperienceScoreList` | 商品体验分高的渠道 |\n| `highPerfectLgtRateList` | 完美履约率高的渠道 |\n\n### 服务保障（protectionInfoList）\n\n每项包含 `serviceName`（服务名称）和 `description`（服务描述）。\n\n## 选品决策分析流程\n\n选品后，对候选商品批量查询分销参谋数据，综合以下维度进行分析：\n\n### 推荐维度（正面因素）\n\n1. **价格优势**：一件包邮价低、分销专属价有折扣\n2. **包邮支持**：支持一件包邮 > 多件包邮 > 不包邮\n3. **渠道匹配**：商品支持用户目标渠道的密文面单\n4. **高体验分**：在目标渠道有高体验分（影响店铺权重）\n5. **高履约率**：在目标渠道有高完美履约率（影响物流评分）\n6. **服务保障**：有退换货保障、品质保障等\n7. **官方物流**：使用官方物流更可靠\n8. **已升级分销品**：已升级的商品铺货更顺畅\n\n### 风险维度（负面因素）\n\n1. **品牌未授权（严重）**：品牌商品但未获得授权，**不能铺货，有侵权风险**。必须引导用户申请授权：`https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId}`\n2. **运费高**：非包邮且运费高，影响利润\n3. **起批量高**：起批量过高不适合小卖家\n4. **渠道不匹配**：不支持用户目标渠道\n\n### 分析输出格式\n\n对每个候选商品输出：\n```\n### [{offerId}](https://detail.1688.com/offer/{offerId}.html) {title}\n\n**推荐指数**：⭐⭐⭐⭐⭐（5/5）\n\n**推荐理由**：\n- ✅ 一件包邮价 ¥22.0，价格有竞争力\n- ✅ 支持抖音、拼多多密文面单\n- ✅ 抖音渠道体验分高\n- ✅ 有 7 天无理由退货保障\n\n**风险提示**：\n- 🚫 品牌商品未授权，不能铺货，有侵权风险\n- 👉 [申请品牌授权](https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId})\n\n**综合建议**：需先完成品牌授权申请后才能铺货\n```\n\nFile v0.1.0:scripts/biz/order_helper/reference.md\n\n# 订单助手参考文档\n\n查询 1688 分销订单/退款单信息、识别风险订单、自动催发催揽。\n\n- **多条件查询** — 支持按订单 ID、创建时间、支付时间、订单状态、退款状态筛选\n- **风险识别** — 自动识别有发货风险的订单，按商家分组展示\n- **批量催发** — 一键向多个卖家发送旺旺催发消息，智能按卖家分组合并\n\n**完整流程：查询订单 → 识别风险 → 催发催揽**\n\n---\n\n## 一、订单查询\n\n### CLI 调用\n\n```bash\n# 查询当天订单（默认）\npython3 scripts/cli.py order_helper query\n\n# 按订单 ID 查询\npython3 scripts/cli.py order_helper query --order_id=4502201509012068443\n\n# 按订单状态查询\npython3 scripts/cli.py order_helper query --order_status=waitbuyerreceive\n\n# 按退款状态查询\npython3 scripts/cli.py order_helper query --refund_status=waitselleragree\n\n# 按时间范围查询\npython3 scripts/cli.py order_helper query --create_start_time=\"2026-03-20 00:00:00\" --create_end_time=\"2026-03-25 23:59:59\"\n```\n\n### 接口工具名\n\n`fx_query_order`\n\n### 请求参数\n\n| CLI 参数 | 接口参数 | 类型 | 必填 | 说明 |\n|---------|---------|------|------|------|\n| `--order_id` | orderId | string | 否 | 订单 ID |\n| `--create_start_time` | createStartTime | string | 否 | 创建开始时间，格式：YYYY-MM-DD HH:mm:ss |\n| `--create_end_time` | createEndTime | string | 否 | 创建结束时间，格式：YYYY-MM-DD HH:mm:ss |\n| `--pay_start_time` | payStartTime | string | 否 | 支付开始时间，格式：YYYY-MM-DD HH:mm:ss |\n| `--pay_end_time` | payEndTime | string | 否 | 支付结束时间，格式：YYYY-MM-DD HH:mm:ss |\n| `--order_status` | orderStatus | string | 否 | 订单状态（见下方映射表） |\n| `--refund_status` | refundStatus | string | 否 | 退款状态（见下方映射表） |\n| `--auto_default_today` | - | string | 否 | 默认 `true`，传 `false` 可禁用默认当天查询 |\n\n### 默认查询行为\n\n- **无筛选条件**：自动查询当天订单\n- **有筛选条件**：按条件查询，不应用默认当天逻辑\n- **禁用默认**：`--auto_default_today=false`\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"success\": true,\n    \"totalCount\": 100,\n    \"orders\": [\n      {\n        \"orderId\": \"4502201509012068443\",\n        \"createTime\": \"2026-03-23 15:30:38\",\n        \"payTime\": \"2026-03-23 15:30:40\",\n        \"orderStatus\": \"waitbuyerreceive\",\n        \"orderStatusText\": \"等待买家收货\",\n        \"sellerLoginId\": \"卖家账号\",\n        \"actualTotalFee\": 2.0,\n        \"productName\": \"测试商品\",\n        \"riskOrderDesc\": \"\",\n        \"isRiskOrder\": false,\n        \"refundStatus\": \"\",\n        \"refundStatusText\": \"无退款\"\n      }\n    ],\n    \"warning\": \"⚠️ 重要提示：符合条件的订单共有 5000 笔，但单次最多返回 3000 笔...\"\n  }\n}\n```\n\n> `warning` 字段仅在 `totalCount > 3000` 时出现。\n\n### 返回数量限制\n\n单次查询最多返回 **3000** 笔订单明细。当 `totalCount > 3000` 时，建议：\n- 缩小时间范围（如查询 1 天而不是 7 天）\n- 指定订单状态\n- 指定退款状态\n\n---\n\n## 二、旺旺催发\n\n### CLI 调用\n\n```bash\n# 发送旺旺消息（系统自动根据订单 ID 定位卖家）\npython3 scripts/cli.py order_helper send --question=\"请尽快发货\" --order_ids=4502201509012068443\n\n# 多个订单（逗号分隔）\npython3 scripts/cli.py order_helper send --question=\"请尽快发货\" --order_ids=4502201509012068443,4502201509012068444\n```\n\n### 接口工具名\n\n`fx_send_ww`\n\n### 请求参数\n\n| CLI 参数 | 接口参数 | 类型 | 必填 | 说明 |\n|---------|---------|------|------|------|\n| `--question` | question | string | 是 | 消息内容 |\n| `--order_ids` | orderIds | string[] | 是 | 关联订单 ID，CLI 中逗号分隔 |\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"success\": true,\n    \"task_id\": \"taskId字符串\"\n  }\n}\n```\n\n---\n\n## 三、查询商家回复记录\n\n催发后查询商家是否已回复。\n\n### CLI 调用\n\n```bash\npython3 scripts/cli.py order_helper query_reply --task_id=xxx\n```\n\n### 接口工具名\n\n`fx_ww_reply`\n\n### 请求参数\n\n| CLI 参数 | 接口参数 | 类型 | 必填 | 说明 |\n|---------|---------|------|------|------|\n| `--task_id` | wwTaskId | string | 是 | 催发任务 ID（由 `fx_send_ww` 返回） |\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"success\": true,\n    \"hasReply\": true,\n    \"replies\": […]\n  }\n}\n```\n\n- `hasReply: true` → 商家已回复，展示回复内容\n- `hasReply: false` → 商家暂未回复\n\n---\n\n## 四、催发后查询商家回复\n\n催发成功后，告知用户：\"催发已发送，商家通常会在 5-10 分钟内回复。您可以稍后让我查询商家回复。\"\n\n当用户要求查询回复时：\n\n1. 使用催发返回的 `task_id` 调用：\n   ```bash\n   python3 scripts/cli.py order_helper query_reply --task_id=xxx\n   ```\n2. 根据结果向用户反馈：\n   - `hasReply: true` → 展示商家回复内容\n   - `hasReply: false` → 告知用户\"商家暂未回复，建议稍后再查询或再次催发\"\n\n---\n\n## 五、批量催发流程\n\n从订单查询结果中自动筛选风险订单，按卖家分组发送催发消息：\n\n1. 从订单列表中筛选风险订单（`isRiskOrder=true`）\n2. 按卖家（`sellerLoginId`）分组\n3. 对每个卖家生成催发消息并发送\n4. 同一卖家的多个订单合并为一条消息（最多展示前 5 个订单号）\n\n### 消息模板\n\n| 模板 | 说明 | 示例 |\n|------|------|------|\n| `default` | 默认 | 老板您好，我这边有几个订单需要发货：{订单号}，麻烦尽快处理一下哦，谢谢！ |\n| `polite` | 礼貌版 | 老板好，我这边有几个订单想催一下：{订单号}，麻烦帮忙尽快安排发货哈，谢谢啦！ |\n| `urgent` | 紧急版 | 老板，这几个订单已经超过 48 小时没有揽收了：{订单号}，买家那边催得比较急，麻烦尽快处理一下哥！ |\n\n---\n\n## 六、风险订单判断\n\n- `riskOrderDesc` 为空 → 正常订单\n- `riskOrderDesc` 非空 → 检查订单是否已结束：\n  - 订单已取消/已完成 **且** 退款已成功/已关闭 → 不是风险订单（交易已结束）\n  - 其他情况 → 风险订单（`isRiskOrder=true`）\n\n---\n\n## 七、订单状态映射\n\n| 状态码 | 中文含义 | 说明 |\n|--------|----------|------|\n| cancel / cancelled | 已取消 | 订单已取消 |\n| waitbuyerpay | 等待买家付款 | 买家未付款 |\n| waitsellersend | 等待卖家发货 | 卖家尚未发货 |\n| waitbuyerreceive | 等待买家收货 | 已发货，等待确认收货 |\n| waitingsellerconfirm | 等待卖家确认 | 退款/退货流程中 |\n| finish | 完成 | 订单已完成 |\n| success | 交易完成 | 交易完成 |\n\n> 状态码不区分大小写\n\n---\n\n## 八、退款状态映射\n\n| 退款状态码 | 中文含义 | 说明 |\n|------------|----------|------|\n| （空） | 无退款 | 订单没有退款 |\n| waitselleragree | 等待卖家同意 | 买家已申请退款 |\n| refundsuccess | 退款成功 | 退款已完成 |\n| refundclose | 退款关闭 | 退款已关闭 |\n| waitbuyermodify | 商家拒绝待修改 | 卖家拒绝，等待买家修改 |\n| waitbuyersend | 待寄回退货 | 等待买家寄回商品 |\n| waitsellerreceive | 等待卖家确认收货 | 等待卖家确认收到退货 |\n| waitbuyerreceive | 等待买家确认收货 | 等待买家确认收到退款 |\n\n> 状态码不区分大小写，同时支持下划线格式（如 `wait_seller_agree`）\n\n---\n\n## 九、输出格式要求\n\n订单查询结果的展示需遵循以下规范：\n\n### 结构层次\n\n1. **重要提示**（如返回结果有 `warning` 字段，**必须在最开始醒目展示**）\n2. **标题**：显示查询时间范围\n3. **统计**：总订单数、风险订单数、正常订单数、退款订单数\n4. **订单列表**：最多展示 10 个，按创建时间倒序\n5. **风险订单明细**：按商家分组详细展示（**重要**）\n6. **退款订单明细**：简单说明\n\n### 展示规则\n\n- 风险订单用 ⚠️ 标记，按卖家分组展示（**最重要**）\n- 商品名称展示前 6-8 个字符\n- 使用 Markdown 格式（标题、表格、列表）\n- 关键章节加图标（📊 📋 ⚠️ 💰）\n\n---\n\n## 十、注意事项\n\n- 无需传入 userId，API 通过 AK 自动认证\n- 卖家分组自动处理，无需手动指定卖家\n- 同一卖家的多个订单 ID 自动拼接到消息中\n\nFile v0.1.0:scripts/biz/product_search_helper/reference.md\n\n# 选品助手参考文档\n\n选品助手提供两种选品模式，根据用户输入自动判断：\n\n| 模式 | 触发条件 | 接口工具名 |\n|------|---------|-----------|\n| 关键词选品 | 用户提供**文字描述** | `distribution_select_offer` |\n| 图搜选品 | 用户提供**图片链接或图片文件** | `same_img_offer_search` |\n\n**完整流程：选品 → 选品决策分析 → 展示推荐 → 确认铺货**\n\n---\n\n## 一、关键词选品\n\n### CLI 调用\n\n```bash\n# 基础调用\npython3 scripts/cli.py product_search_helper search --filters='[{\"code\":\"title\",\"value\":[\"垃圾袋\"],\"queryType\":\"contains_any\"}]'\n\n# 包邮 + 一件代发 + 按价格升序\npython3 scripts/cli.py product_search_helper search --filters='[{\"code\":\"title\",\"value\":[\"垃圾袋\"],\"queryType\":\"contains_any\"},{\"code\":\"is_free_post\",\"value\":\"Y\",\"queryType\":\"equal\"},{\"code\":\"is_yjdf\",\"value\":\"Y\",\"queryType\":\"equal\"}]' --rank_type=ASC --rank_field=df_price\n\n# 价格区间\npython3 scripts/cli.py product_search_helper search --filters='[{\"code\":\"title\",\"value\":[\"垃圾袋\"],\"queryType\":\"contains_any\"},{\"code\":\"df_price\",\"value\":[5.0,10.0],\"queryType\":\"range\"}]'\n```\n\n### 筛选条件（retrieveFilters）\n\n从用户描述中提取筛选条件，每个条件格式：\n```json\n{ \"code\": \"字段key\", \"value\": [\"值\"], \"queryType\": \"操作符\" }\n```\n\n**操作符说明**：\n\n| queryType | 含义 | 适用场景 |\n|-----------|------|---------|\n| `contains_any` | 包含任意一个 | 关键词、STRING 多值 |\n- `equal`：等于（用于 Y/N 类型的 STRING 字段）\n- `range`：范围查询（用于 DOUBLE/BIGINT 数值区间，value 格式: [最小值, 最大值]，null 表示不限制）\n\n### 筛选字段速查表\n\n**商品基础**\n\n| 用户说 | 字段 key | 类型 | 用法示例 |\n|--------|---------|------|---------|\n| 关键词/标题 | `title` | STRING | `contains_any: [\"垃圾袋\", \"加厚\"]` |\n| 一级类目 | `cate_level1_name` | STRING | `contains_any: [\"家居\"]` |\n| 二级类目 | `cate_level2_name` | STRING | `contains_any: [\"清洁用品\"]` |\n| 叶子类目 | `cate_name` | STRING | `contains_any: [\"垃圾袋\"]` |\n\n**价格与物流**\n\n| 用户说 | 字段 key | 类型 | 用法示例 |\n|--------|---------|------|---------|\n| 包邮 | `is_free_post` | STRING | `equal: \"Y\"` |\n| 一件代发 | `is_yjdf` | STRING | `equal: \"Y\"` |\n| 代发价格范围 | `df_price` | DOUBLE | `range: [5.0, 10.0]` |\n| 代发邮费范围 | `df_post` | DOUBLE | `range: [null, 5.0]` |\n\n**发货与服务**\n\n| 用户说 | 字段 key | 类型 | 用法示例 |\n|--------|---------|------|---------|\n| 24小时发货 | `is_24hour_send_fx` | STRING | `equal: \"Y\"` |\n| 48小时发货 | `is_48hour_send_fx` | STRING | `equal: \"Y\"` |\n| 7天无理由退货 | `is_no_reason_to_return_7d_fx` | STRING | `equal: \"Y\"` |\n| 退款处理快 | `is_rfd_process_fast` | STRING | `equal: \"Y\"` |\n| 24小时揽收率高 | `is_24h_got_rate_high` | STRING | `equal: \"Y\"` |\n| 48小时揽收率高 | `is_48h_got_rate_high` | STRING | `equal: \"Y\"` |\n| 先采后付 | `is_xchf` | STRING | `equal: \"Y\"` |\n| 实力工厂 | `is_shili_factory` | STRING | `equal: \"Y\"` |\n\n**销量与数据**\n\n| 用户说 | 字段 key | 类型 | 用法示例 |\n|--------|---------|------|---------|\n| 近30天分销订单量 | `fx_ord_cnt_30d` | BIGINT | `range: [100, null]` |\n| 近30天订单量 | `ord_cnt_30d` | BIGINT | `range: [500, null]` |\n| 7天内新品 | `is_7d_create` | STRING | `equal: \"Y\"` |\n| 30天内新品 | `is_30d_create` | STRING | `equal: \"Y\"` |\n\n**品质评分**\n\n| 用户说 | 字段 key | 类型 | 用法示例 |\n|--------|---------|------|---------|\n| 淘宝商品体验分高 | `is_tb_pxi_score_high` | STRING | `equal: \"Y\"` |\n| 货描相符大于均值 | `is_score_hm_high` | STRING | `equal: \"Y\"` |\n| 响应速度大于均值 | `is_score_xy_high` | STRING | `equal: \"Y\"` |\n| 发货速度大于均值 | `is_score_fh_high` | STRING | `equal: \"Y\"` |\n\n**密文面单渠道（channels 字段）**\n\n`channels` 使用 `and` 作为 `queryType`，`value` 为渠道枚举数组：\n\n| 渠道 | 枚举值 |\n|------|--------|\n| 抖音 | `dy` |\n| 拼多多 | `pdd` |\n| 淘宝 | `tb` |\n| 京东 | `jd` |\n| 小红书 | `xhs` |\n\n示例 — 用户说\"支持抖音和拼多多密文面单\"：\n```json\n{ \"code\": \"channels\", \"value\": [\"dy\", \"pdd\"], \"queryType\": \"and\" }\n```\n\n### 分页与排序\n\n| 参数 | 类型 | 说明 | 默认值 |\n|------|------|------|--------|\n| `page_no` | int | 页码，从 1 开始 | 1 |\n| `page_size` | int | 每页数量，最大 50 | 20 |\n| `rank_type` | string | `ASC` 升序 / `DESC` 降序 | 默认排序 |\n| `rank_field` | string | 排序字段（`df_price`、`fx_ord_cnt_30d` 等） | 默认排序 |\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"total\": 1486,\n    \"data\": [\n      {\n        \"offerId\": \"894529405810\",\n        \"title\": \"户外便携式懒人充气沙发...\",\n        \"dfPrice\": 22.0,\n        \"dfPost\": 2.53,\n        \"offerPic\": \"https://cbu01.alicdn.com/...\",\n        \"fxOrdCnt30d\": \"120\",\n        \"ordCnt30d\": \"280\",\n        \"ciphertextInfoList\": [\n          { \"name\": \"淘宝(菜鸟)\", \"key\": \"thyny\" },\n          { \"name\": \"抖音\", \"key\": \"douyin\" },\n          { \"name\": \"拼多多\", \"key\": \"pinduoduo\" }\n        ],\n        \"baseServiceInfo\": {\n          \"isFreePost\": false,\n          \"isYjdf\": true,\n          \"isNoReasonToReturn7dFx\": true\n        }\n      }\n    ]\n  }\n}\n```\n\n> 商品数组在 `data.data`（外层 data 是接口返回，内层 data 是商品列表），`data.total` 是总数。\n\n---\n\n## 二、图搜选品\n\n### CLI 调用\n\n```bash\n# 图片 URL 搜索\npython3 scripts/cli.py product_search_helper search --image_url=\"https://example.com/sample.jpg\"\n\n# 图片 + 辅助关键词\npython3 scripts/cli.py product_search_helper search --image_url=\"https://example.com/sample.jpg\" --keyword=\"连衣裙\"\n\n# 图片 + 主体圈选\npython3 scripts/cli.py product_search_helper search --image_url=\"https://example.com/sample.jpg\" --region=\"100,100,300,400\"\n```\n\n### 图片参数\n\n| 参数 | 说明 | 备注 |\n|------|------|------|\n| `image_url` | 图片 URL 地址 | 用户给链接时使用 |\n| `image_base64` | 图片 Base64 编码 | 用户直接给图片时使用 |\n| `region` | 主体圈选坐标（可选） | 格式：\"x1,y1,x2,y2\" |\n\n> **二选一**：`image_url` 和 `image_base64` 至少传一个。\n\n### 其他参数\n\n| 参数 | 类型 | 说明 | 默认值 |\n|------|------|------|--------|\n| `page_no` | int | 页码 | 1 |\n| `page_size` | int | 每页大小，最大 50 | 20 |\n| `keyword` | string | 辅助关键词（可选） | - |\n| `rank_field` | string | 排序字段（如 `price`） | - |\n| `rank_type` | string | `ASC` / `DESC` | - |\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"total\": 100,\n    \"data\": [\n      {\n        \"offerId\": 7890123456,\n        \"title\": \"2026新款夏季女装连衣裙\",\n        \"offerPic\": \"https://cbu01.alicdn.com/...\",\n        \"price\": 39.9,\n        \"yjby\": true,\n        \"ciphertextInfoList\": [],\n        \"dfSalesForSort\": null\n      }\n    ],\n    \"extendInfo\": {\n      \"yoloCropRegion\": \"0.1,0.2,0.8,0.9\"\n    }\n  }\n}\n```\n\n**图搜特有字段**：\n- `yjby`：是否一件代发包邮（true 时 price 为包邮价）\n- `dfSalesForSort`：月代发销量（精确值，用于排序）\n- `extendInfo.yoloCropRegion`：YOLO 模型识别的主体裁剪区域\n\n> 图搜超时 60 秒（比关键词选品更长），商品字段与关键词选品一致，后续流程相同。\n\n---\n\n## 三、选品后处理规则\n\n1. 按 SKILL.md 中的「选品数量策略」确定展示数量（用户指定 N 个 → 超量请求再精选 N 个）\n2. **自动触发选品决策分析**（见下方）\n3. 综合展示选品数据 + 参谋分析结果给用户\n4. 询问用户确认要铺货的商品（可全选或选择部分）\n\n---\n\n## 四、选品决策分析\n\n选品返回后，**自动**对候选商品批量查询分销参谋数据，综合分析后给出推荐。\n\n### 执行步骤\n\n1. 加载分销参谋参考文档：`read_file: scripts/biz/offer_info/reference.md`\n2. 对每个候选商品调用分销参谋接口：\n   ```bash\n   python3 scripts/cli.py offer_info query --offer_id=\"{offerId}\" --decision=true\n   ```\n3. 综合选品数据 + 参谋数据，生成推荐分析\n4. 按推荐指数排序展示，询问用户确认铺货商品\n\n### 推荐维度（正面因素）\n\n| 维度 | 数据来源 | 判断标准 |\n|------|----------|----------|\n| 价格优势 | 选品 `dfPrice` + 参谋 `priceInInfo` | 一件包邮价低、分销专属价有折扣 |\n| 包邮支持 | 参谋 `priceInInfo.onePieceFreePostage` | 一件包邮 > 多件包邮 > 不包邮 |\n| 渠道匹配 | 参谋 `supportList` | 支持用户目标渠道的密文面单 |\n| 高体验分 | 参谋 `downstreamPerformance.highExperienceScoreList` | 在目标渠道有高体验分 |\n| 高履约率 | 参谋 `downstreamPerformance.highPerfectLgtRateList` | 在目标渠道有高完美履约率 |\n| 服务保障 | 参谋 `protectionInfoList` | 有退换货保障、晚揽必赔等 |\n| 代发数据 | 参谋 `adviseList` | 近30天代发量大、揽收率高 |\n| 分销品 | 参谋 `alreadyUpgrade` | 已升级为分销品，铺货更顺畅 |\n\n### 风险维度（负面因素）\n\n| 维度 | 数据来源 | 判断标准 |\n|------|----------|----------|\n| 品牌未授权（严重） | 参谋 `brandInfo.isBrandOffer` + `isAuth` | 品牌商品但未授权，**不能铺货，有侵权风险**。必须引导用户申请授权 |\n| 运费高 | 参谋 `freightInfo` | 非包邮且运费高，影响利润 |\n| 起批量高 | 参谋 `priceInInfo.startNum` | 起批量过高不适合小卖家 |\n| 渠道不匹配 | 参谋 `supportList` | 不支持用户目标渠道 |\n| 包邮排除区域多 | 参谋 `priceInInfo.excludeAreaList` | 排除区域过多影响覆盖范围 |\n\n### 展示格式\n\n**每个商品必须包含商品链接**：`https://detail.1688.com/offer/{offerId}.html`，**链接必须嵌入到商品ID中**。offerId 从接口返回数据中获取（文搜和图搜都有返回 offerId 字段）。\n\n```\n### [{offerId}](https://detail.1688.com/offer/{offerId}.html) {title}\n\n**推荐指数**：⭐⭐⭐⭐⭐（5/5）\n\n**选品数据**：\n- 代发价 ¥{dfPrice} | 邮费 ¥{dfPost} | 近30天分销订单 {fxOrdCnt30d}\n\n**参谋分析**：\n- ✅ 一件包邮，价格有竞争力\n- ✅ 支持抖音、拼多多等 6 个渠道密文面单\n- ✅ 近30天代发 9000+，48h揽收率 100%\n- ✅ 有官方仓退货、晚揽必赔保障\n\n**风险提示**：\n- 🚫 品牌商品未授权，不能铺货，有侵权风险\n- 👉 [申请品牌授权](https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId})\n\n**综合建议**：需先完成品牌授权申请后才能铺货\n```\n\n> **图搜字段映射**：图搜返回的字段名与文搜略有不同，但 `offerId` 和 `title` 是相同的。图搜中 `price` 对应文搜的 `dfPrice`，`yjby=true` 表示包邮。无论文搜还是图搜，商品链接的拼接方式都是 `https://detail.1688.com/offer/{offerId}.html`。\n\n---\n\n## 五、品牌授权检查（重要）\n\n选品决策分析时，必须检查每个候选商品的品牌授权状态：\n\n- **`isBrandOffer=true` 且 `isBrandAuth=false`**：该商品 **不能铺货**，有侵权风险\n- 必须在展示时明确标记，并给出授权申请链接：\n  `https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId}`\n- 用户确认铺货时，**自动排除未授权品牌商品**，并提示用户原因\n\n---\n\n## 六、铺货后续触发逻辑\n\n铺货完成后，若当前会话中有选品候选列表：\n\n1. 检查候选列表中是否还有未铺货的商品\n2. 如果有，主动询问用户：「还有 N 个商品未铺货，是否继续铺货？」\n3. 用户确认后，跳过已铺货商品，继续铺货剩余商品\n4. 重复直到所有商品处理完毕或用户主动停止\n\nFile v0.1.0:scripts/biz/shop_info/reference.md\n\n# 店铺信息查询参考文档\n\n查询用户绑定的三方分销工具和店铺列表，过滤已过期的工具/店铺，为铺货提供目标店铺选择。\n\n---\n\n## 一、CLI 调用\n\n```bash\n# 查询店铺和工具信息（自动过滤已过期的工具和店铺）\npython3 scripts/cli.py shop_info query\n```\n\n### 接口工具名\n\n`shop_and_tool_info`\n\n### 请求参数\n\n无需传入任何参数，API 通过 AK 自动识别用户身份。\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"toolList\": [\n      {\n        \"appKey\": \"{appKey}\",\n        \"appName\": \"{工具名称}\",\n        \"toolAuthContent\": \"已订购\",\n        \"toolExpired\": false,\n        \"channelList\": [\n          {\n            \"channel\": \"douyin\",\n            \"channelDesc\": \"抖音\",\n            \"shopList\": [\n              {\n                \"shopCode\": \"{shopCode}\",\n                \"shopName\": \"{店铺名称}\",\n                \"channelAuthExpired\": false\n              }\n            ]\n          }\n        ]\n      }\n    ]\n  }\n}\n```\n\n### 关键字段说明\n\n| 字段 | 说明 |\n|------|------|\n| `appKey` | 三方服务商唯一标识（铺货时需要） |\n| `appName` | 工具名称 |\n| `toolExpired` | 工具是否已过期（true=过期，自动过滤） |\n| `channel` | 渠道标识（如 douyin、pinduoduo、taobao） |\n| `channelDesc` | 渠道中文名（如 抖音、拼多多、淘宝） |\n| `shopCode` | 店铺编码（铺货时需要） |\n| `shopName` | 店铺名称 |\n| `channelAuthExpired` | 店铺授权是否过期（true=过期，自动过滤） |\n\n### 过滤规则\n\nCLI 返回的数据已自动过滤：\n- `toolExpired: true` 的工具整个移除\n- `channelAuthExpired: true` 的店铺移除\n- 过滤后无店铺的渠道移除，无渠道的工具移除\n\n---\n\n## 二、确认铺货目标\n\n### toolList 为空（用户未绑定任何分销工具）\n\n输出绑店引导话术，然后**停止当前流程，等待用户完成绑店后重新发起**：\n\n> 您还没有绑定店铺到 1688 分销系统，需要先完成绑店才能铺货。\n>\n> ### 绑店步骤\n> 1. 进入绑店页面，选择你的下游平台（抖音/淘宝/拼多多等）\n> 2. 授权 1688 分销工具，勾选\"我同意并签署协议\"\n> 3. 订购并授权下游工具（铺货工具 + 交易工具）\n> 4. 确认显示\"已授权\"后，绑店完成\n>\n> **绑店快速入口：**\n> - [一件代发页面](https://air.1688.com/app/channel-fe/search/index.html?#/result)\n> - [AI 工作台绑店](https://air.1688.com/app/channel-fe/distribution-work/ai-assistant.html#/multi-agent-shop-binding)\n>\n> 遇到问题可加入官方钉钉群（群号：41361847）咨询。\n> 绑店完成后，告诉我\"绑好了\"，我继续帮您铺货。\n\n### 用户已明确指定渠道但该渠道下没有可用店铺\n\n提示用户当前没有该渠道的店铺，列出已有的渠道和店铺供选择，或引导用户去绑定目标渠道的店铺。\n\n### toolList 不为空，正常选择店铺\n\n- **只有 1 个可用店铺** → 直接使用，无需询问\n- **有多个可用店铺** → 列出供用户选择\n- 用户已明确指定渠道时，优先过滤该渠道\n\n### 展示格式\n\n```\n您当前绑定的店铺如下：\n\n**【{工具名称}】**\n  - 抖音 · {店铺名称}（店铺编码：{shopCode}）\n**【另一个工具】**\n  - 拼多多 · {店铺名称2}（店铺编码：{shopCode2}）\n\n请问您要将商品铺货到哪个店铺？\n```\n\n---\n\n## 三、注意事项\n\n- 无需传入 userId，API 通过 AK 自动认证\n- 所有已过期的工具和店铺已在返回前自动过滤\n- 铺货时需要的关键信息：`appKey`（工具标识）、`shopCode`（店铺编码）、`channel`（渠道标识）\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nProvides a single entry point for 1688 distribution workflows, including product selection and listing, order management, knowledge-base lookup, and shop binding.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[1688aiinfra](https://clawhub.ai/user/1688aiinfra)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and commerce operators use this skill to manage 1688 distribution tasks through an agent, including selecting products, confirming shops, distributing listings, querying orders, sending seller follow-up messages, and retrieving 1688 distribution guidance.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can store and use a 1688 Access Key for account-specific operations.\n\nMitigation: Install only from a trusted publisher, review credential storage behavior before use, and avoid sharing or exposing the Access Key.\n\nRisk: The skill can query account, shop, and order data.\n\nMitigation: Use it only in workspaces where access to 1688 account and order information is appropriate.\n\nRisk: The skill can perform distribution actions and send seller messages.\n\nMitigation: Require explicit confirmation before browser authorization, credential reset or clear actions, product distribution, and outbound seller messaging.\n\nRisk: The security scan advises review of AK storage/status leakage and callback server binding/authentication before use.\n\nMitigation: Review or fix those areas before deploying the skill in production or shared environments.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/1688aiinfra/skills/1688-distribution)\n- [1688 authentication portal](https://clawhub.1688.com/)\n- [Product selection reference](scripts/biz/product_search_helper/reference.md)\n- [Offer information reference](scripts/biz/offer_info/reference.md)\n- [Distribution execution reference](scripts/biz/distribute_helper/reference.md)\n- [Shop information reference](scripts/biz/shop_info/reference.md)\n- [Order management reference](scripts/biz/order_helper/reference.md)\n- [Knowledge-base query reference](scripts/biz/knowledge_helper/reference.md)\n\n## Skill Output:\n\n**Output Type(s):** [Markdown, JSON, Shell commands, API Calls, Guidance]\n\n**Output Format:** [JSON responses containing markdown, with shell command invocations for local CLI tools]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires python3 and uses 1688 Access Key authorization for account-specific operations.]\n\n## Skill Version(s):\n\n0.1.0 (source: server release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.","readmeExcerpt":"Skill: 1688 Distribution Owner: 1688aiinfra Summary: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-05-06T02:41:54.490Z | auto Initial release of the 1688-distribution skill — unified entry for all 1688 distribution business workflows. - Provides a single command-line interface for product selection/","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"❌ 禁止：编造商品数据、伪造链接、臆测店铺信息、用搜索引擎补充数据、改写CLI返回结果...\n✅ 仅允许：原样输出CLI工具返回的markdown，禁止擅自增加额外内容；失败时告知用户原因"},{"language":"text","snippet":"1. 执行：python3 scripts/capabilities/configure/cmd.py --get-ak\n2. 命令输出 JSON（含 action: \"browser_use\" 和 url）\n3. 必须使用 browser_use 工具打开该 url（不是展示给用户）\n4. 执行 --status 确认 AK 已配置\n5. 继续执行原查询"},{"language":"text","snippet":"### [{offerId}](https://detail.1688.com/offer/{offerId}.html) {title}\n**代发价**：¥{dfPrice}（邮费 ¥{dfPost}） | **30天分销单量**：{fxOrdCnt30d}\n**风险提示**：🚫 品牌未授权不可铺货 → [申请授权](https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId})"},{"language":"text","snippet":"| 商品ID | 商品名称 | 代发价 | 邮费 | 30天分销单量 |\n|--------|----------|--------|------|------------|\n| [{offerId}](https://detail.1688.com/offer/{offerId}.html) | {title} | ¥{dfPrice} | ¥{dfPost} | {fxOrdCnt30d} |"},{"language":"text","snippet":"## 订单查询结果\n**查询范围**：{时间范围} | **总计**：{totalCount} 笔\n| 订单号 | 状态 | 商品 | 金额 | 卖家 |\n|--------|------|------|------|------|\n| {orderId} | {orderStatusText} | {productName} | ¥{fee} | {seller} |\n⚠️ 风险订单：{N} 笔（需及时催发）"},{"language":"bash","snippet":"python3 scripts/cli.py distribute_helper execute \\\n  --app_key=\"{appKey}\" \\\n  --shop_code=\"{shopCode}\" \\\n  --channel=\"douyin\" \\\n  --offer_ids=\"983715805496,983715805497\" \\\n  --shop_name=\"大小姐精品铺子\" \\\n  --tool_name=\"逸淘分销铺货\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: 1688-distribution\ndescription: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。\nmetadata: {\"openclaw\": {\"emoji\": \"🚀\", \"version\": \"1.0.0\", \"requires\": {\"bins\": [\"python3\"]}}}\n---\n\n# 1688 分销\n\n统一入口：`python3 scripts/cli.py <command> [options]`\n\n所有命令输出 JSON：`{\"success\": bool, \"markdown\": str, \"data\": {...}}`\n\n**展示时直接输出 `markdown` 字段内容，禁止在后面追加任何\"后续建议\"\"操作指引\"\"后续操作\"等自创内容（无论是否含链接）。**\n\n## ⚠️ 核心限制\n\n**失败时直接告知用户，不编造！**\n\n```\n❌ 禁止：编造商品数据、伪造链接、臆测店铺信息、用搜索引擎补充数据、改写CLI返回结果...\n✅ 仅允许：原样输出CLI工具返回的markdown，禁止擅自增加额外内容；失败时告知用户原因\n```\n\n**严格禁止（NEVER DO）：**\n\n1. 🚫 禁止编造数据/链接 — 所有数据必须来自接口返回，不得自行构造 URL\n2. 🚫 禁止未经确认执行铺货 — 铺货不可逆，必须用户明确确认商品和目标店铺\n3. 🚫 禁止品牌未授权商品铺货 — `isBrandOffer=true` 且 `isBrandAuth=false` 绝对不能铺货\n4. 🚫 禁止擅自添加筛选条件 / 改写用户原话 / 猜测渠道和店铺\n5. 🚫 禁止向用户展示授权链接 — 浏览器授权流程中不得将 URL 展示给用户\n6. 🚫 禁止使用搜索引擎、访问外部网站获取业务数据\n7. 🚫 禁止失败后自行重试、补充、编造 — 直接告知用户失败原因，等待指示\n8. 🚫 **禁止在任何操作完成后追加\"后续建议\"\"后续操作\"\"操作指引\"等内容** — 无论是否含链接，一律不加\n9. 🚫 **禁止在未阅读 reference.md 前执行任何业务命令** — 必须**先 read_file 加载对应 reference.md → 再执行命令**。命令的动作名、参数名、参数格式必须从 reference.md 中获取，不得凭记忆或猜测拼凑\n\n---\n\n## AK 授权处理\n\nAK（Access Key）用于身份认证，存储在 `{workspace}/.1688-AK/.ak_store.json`。\n\n**授权检查**：任何业务操作前执行 `python3 scripts/capabilities/configure/cmd.py --status`，已授权则直接执行，同一会话内无需重复检查。\n\n**未授权时自动处理（静默执行，不询问用户）：**\n\n```\n1. 执行：python3 scripts/capabilities/configure/cmd.py --get-ak\n2. 命令输出 JSON（含 action: \"browser_use\" 和 url）\n3. 必须使用 browser_use 工具打开该 url（不是展示给用户）\n4. 执行 --status 确认 AK 已配置\n5. 继续执行原查询\n```\n\n**禁止**：将授权链接展示给用户 / 让用户手动打开 / 向用户提及 AK、授权等细节。\n\n**手动配置 AK**（浏览器获取失败时的兜底）：\n1. 用户前往 https://clawhub.1688.com/ 登录后右上角点击🔑复制 AK\n2. 执行：`python3 scripts/capabilities/configure/cmd.py <AK值>`\n3. `--status` 确认\n\n**重置 AK**：`python3 scripts/capabilities/configure/cmd.py --reset <新AK值>`，或 `--clear` 后重新授权。\n\n---\n\n## 意图判断\n\n| 用户意图 | 路由到 | 触发关键词 |\n|---------|--------|------------|\n| 选品 + 铺货 | [选品铺货助手](#选品铺货助手) | 选品、找商品、推荐、铺货、上架、分销 |\n| 订单管理 | [订单助手](#订单助手) | 查订单、退款、风险订单、催发、催揽、旺旺 |\n| 知识查询 | [知识库助手](#知识库助手) | 怎么操作、教程、流程、指南、发货流程 |\n| 查店铺 | [店铺查询](#店铺查询) | 查店铺、绑店、授权 |\n| 重置 AK | [AK 授权处理](#ak-授权处理) | 重新设置 AK、重置 AK、更新 AK |\n\n> 判断不清时优先询问用户意图，不要猜测。与1688分销无关的话题不触发本技能。\n\n---\n\n## ❗ 执行前置（最高优先级）\n\n> ⛔ **铁律：先读文档 → 再执行命令。read_file 加载对应 reference.md 之前，禁止执行该场景的任何 CLI 命令。**\n\n| 业务场景 | 执行前必须阅读的参考文档 |\n|---------|---------------------|\n| 选品（关键词/图搜） | `scripts/biz/product_search_helper/reference.md` |\n| 分销参谋（商品详情） | `scripts/biz/offer_info/reference.md` |\n| 铺货执行 | `scripts/biz/distribute_helper/reference.md` |\n| 店铺查询 | `scripts/biz/shop_info/reference.md` |\n| 订单管理 | `scripts/biz/order_helper/reference.md` |\n| 知识库查询 | `scripts/biz/knowledge_helper/reference.md` |\n\n同一会话内后续重复调用可复用已加载知识，无需重复阅读。\n\n---\n\n## 选品铺货助手\n\n流程：**检查AK → 选品 → 决策分析 → 确认店铺 → 铺货 → 结果反馈 → 后续触发**\n\n> 每步执行前须确保已阅读对应 reference.md（见[执行前置](#-执行前置最高优先级)）。\n\n### 第一步：选品（用户已有商品 ID 时跳过）\n\n根据用户输入自动选择模式：\n- **文字描述** → 关键词选品（`distribution_select_offer`）\n- **图片链接/文件** → 图搜选品（`same_img_offer_search`）\n\n**选品数量策略** — 超量请求再精选，防止接口去重/过滤导致不足：\n\n| 用户要求 N | 实际请求 page_size | 说明 |\n|-------"},{"path":"README.md","content":"免责声明：\n1、您理解并同意，技能运行结果和输出内容可能因适用的AI agent、大模型不同而产生差异或幻觉，请您对重要的信息进行甄别核实。\n2、您应妥善保管您的Access Key（AK），这是您运行1688技能的身份凭证，请勿提供给第三人，避免身份凭证泄露造成损失。\n3、您下载安装1688技能运行时应始终保持其完整性，不得擅自篡改技能的代码、相关文件或其他内容，否则1688不对技能运行结果和输出内容承担任何法律责任。\n4、受限于当前技术发展，我们无法保证技能所有运行结果、输出内容的准确性、真实性、时效性，请您谨慎核实技能运行结果和输出内容，除法律规定由我们承担赔偿责任的场景外，我们不承担其他赔偿责任。"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn76msg8cwkep3b08z7zffx9fx82p5wj\",\n  \"slug\": \"1688-distribution\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1778035314490\n}"},{"path":"scripts/biz/distribute_helper/reference.md","content":"# 铺货执行参考文档\n\n将 1688 商品铺货到用户的下游店铺（抖音、拼多多、淘宝等）。\n\n---\n\n## 一、CLI 调用\n\n```bash\npython3 scripts/cli.py distribute_helper execute \\\n  --app_key=\"{appKey}\" \\\n  --shop_code=\"{shopCode}\" \\\n  --channel=\"douyin\" \\\n  --offer_ids=\"983715805496,983715805497\" \\\n  --shop_name=\"大小姐精品铺子\" \\\n  --tool_name=\"逸淘分销铺货\"\n```\n\n### 接口工具名\n\n`distribute_offer`\n\n### 参数说明\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| `app_key` | 是 | 三方服务商唯一标识，从 shop_info 查询结果的 `toolList[].appKey` 获取 |\n| `shop_code` | 是 | 目标店铺编码，从 shop_info 查询结果的 `shopList[].shopCode` 获取 |\n| `channel` | 是 | 渠道标识（如 `douyin`、`pinduoduo`、`taobao`），从 shop_info 查询结果获取 |\n| `offer_ids` | 是 | 商品 ID，多个用英文逗号分隔，如 `\"983715805496,983715805497\"` |\n| `shop_name` | 否 | 店铺名称（用于展示），从 shop_info 查询结果的 `shopList[].shopName` 获取 |\n| `tool_name` | 否 | 铺货工具名称（用于展示），从 shop_info 查询结果的 `toolList[].appName` 获取 |\n\n> 接口实际传参：`outShopListStr` 为 `[{\"code\":\"{shopCode}\",\"channel\":\"{channel}\"}]` 的 JSON 序列化字符串，CLI 内部自动拼装。\n\n### 返回结构\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"errorCode\": \"200\",\n    \"failCount\": 0,\n    \"successCount\": 1,\n    \"allCount\": 1,\n    \"appKey\": \"{appKey}\",\n    \"brandInvalidOfferIds\": [],\n    \"successOfferIds\": [\"983715805496\"],\n    \"failOfferIds\": []\n  }\n}\n```\n\n---\n\n## 二、结果反馈\n\n根据返回的 `errorCode` 字段给出对应提示：\n\n| errorCode | 含义 | 向用户展示的提示 |\n|-----------|------|----------------|\n| `200` / `0` | 全部成功 | ✅ 铺货完成！成功 {successCount} 件，共 {allCount} 件 |\n| `210` | 部分成功 | ⚠️ 铺货部分成功。成功 {successCount} 件，失败 {failCount} 件，共 {allCount} 件 |\n| `511` | 店铺授权失效 | ❌ 铺货失败：下游店铺授权信息已失效，请重新授权后再试 |\n| `512` | 未完成铺货设置 | ❌ 铺货失败：您未完成铺货设置，请先完成设置后再铺货 |\n| 其他 | 三方工具服务错误 | ❌ 铺货失败：三方工具服务请求错误，请稍后重试或联系技术支持 |\n\n### 反馈模板\n\n铺货命令返回的 JSON 中 `markdown` 字段已是完整的用户回复。**直接将 `markdown` 原样转发给用户，不得修改或追加任何内容。**\n\n`markdown` 输出示例：\n```\n✅ 铺货完成！成功 1 件，共 1 件\n店铺：大小姐精品铺子 | 铺货工具：逸淘分销铺货\n- 成功商品 ID：700407352258\n\n---\n\n> ℹ️ 铺货结果到此结束。如有未铺货商品，请询问用户是否继续。\n```\n\nAgent 收到后只做两件事：\n1. 原样转发 `markdown` 给用户\n2. 如有未铺货商品，询问用户是否继续\n\n**不得追加任何链接或额外文字，禁止增加‘后续操作建议’**。\n\n> `errorCode` 为 `200`、`0` 或 `210` 时视为整体成功（`success: true`），其他均为失败。\n\n---\n\n## 三、注意事项\n\n- 铺货前必须先通过 shop_info 确认目标店铺，获取 `appKey`、`shopCode`、`channel`\n- 品牌商品（`brandInvalidOfferIds` 非空）铺货会失败，且有侵权风险。铺货前必须检查品牌授权状态（在选品决策分析阶段已检查），未授权商品引导用户申请授权：`https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId}`\n- 单次铺货支持多个商品 ID，用逗号分隔\n- **不得编造链接**：铺货结果反馈中只展示接口实际返回的数据，不得自行构造任何 URL（如\"查看铺货进度\"、\"采购设置\"、\"自动售后\"等链接均为虚构，会导致 404）"},{"path":"scripts/biz/knowledge_helper/reference.md","content":"# 知识库助手参考文档\n\n查询 1688 分销知识库，获取发货流程、铺货操作、订单管理等分销相关文档。支持按渠道（21 个）和工具（24 个）筛选。\n\n**完整流程：解析意图 → 确认渠道/工具 → 检索知识库 → 判断召回 → 总结输出**\n\n---\n\n## 一、CLI 调用\n\n```bash\n# 默认查询（不限渠道和工具）\npython3 scripts/cli.py knowledge_helper query --query=\"铺货流程\"\n\n# 指定渠道和工具\npython3 scripts/cli.py knowledge_helper query --query=\"发货\" --channel=\"抖音\" --business=\"自动分销\"\n\n# 列出所有支持的渠道\npython3 scripts/cli.py knowledge_helper channels\n\n# 列出所有支持的工具\npython3 scripts/cli.py knowledge_helper businesses\n```\n\n### 接口工具名\n\n`distribution_knowledge_tool`\n\n### 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `query` | string | 是 | 用户查询问题，**原封不动传递用户原话，严禁修改** |\n| `channel` | string | 否 | 渠道中文名（如 \"抖音\"），未指定时传 `\"default\"` |\n| `business` | string | 否 | 工具中文名（如 \"逸淘分销铺货\"），未指定时传 `\"default\"` |\n\n### 返回结构\n\n`data` 为精排后的文档数组（最多 20 条），每条包含：\n\n| 字段 | 说明 |\n|------|------|\n| `score` | 相关度分数（0-1，越高越相关） |\n| `chunking_val` | 文档正文内容 |\n| `source_url` | 原始文档链接 |\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"data\": [\n      {\n        \"score\": 0.99,\n        \"chunking_val\": \"工具名称：逸淘分销铺货;内容：...\",\n        \"source_url\": \"https://peixun.1688.com/article/xxx\"\n      }\n    ]\n  }\n}\n```\n\n---\n\n## 二、query 原则（必须严格遵守）\n\n- **不要去掉任何词语**\n- **不要改写、精简或翻译用户问题**\n- 原封不动地将用户原话作为 query 参数传递\n- **唯一例外**：召回结果与用户问题完全无关时，才允许对 query 做极小调整（仅补充 1-2 个关键词），重试仅允许 1 次\n\n---\n\n## 三、渠道与工具确认（强制询问）\n\n**如果用户没有明确说明渠道和工具，必须先询问用户，不能跳过！**\n\n- 用户明确提到了渠道和工具 → 直接使用中文名称传参\n- 用户未明确渠道或工具（即使只缺一个） → **必须停下来追问**，使用以下话术：\n\n```\n为了给您提供更精准的知识，请告诉我您想查询的渠道和工具：\n\n📱 **渠道**（您的店铺所在平台）：\n淘宝、天猫、抖音、拼多多、快手、小红书、京东、微信小店、有赞、微店、淘特、快团团、微信小商店、支付宝、苏宁、闲鱼、饿了么、美团、度小店、微盟、微购相册\n或选择\"不限\"使用通用知识库\n\n🔧 **工具**（您使用的分销工具）：\n逸淘分销铺货、自动分销、代发助手王、店长铺货、妙手分销、速当家分销、智淘分销、甩手易分销、无忧分销王、晓风分销、大泽云铺货、顶卖分销、铺货代发、1688官方铺货、普云铺货、麦爆了分销、马上分销、掌中宝分销、智汇分销、微购相册、抖掌柜分销、旺分销铺货、小天分销、火牛分销王\n或选择\"不限\"使用通用知识库\n\n请直接回复渠道和工具名称，例如：\"淘宝 + 逸淘分销铺货\"\n```\n\n**然后停止，等待用户回复，不要继续执行任何操作！**\n\n用户回复\"不限\"或\"默认\"时，对应参数传 `\"default\"`。\n\n---\n\n## 四、召回结果判断\n\n拿到 `data` 数组后，在总结之前先做相关性判断：\n\n**直接进入总结（满足任一条件）：**\n- 最高 `score` ≥ 0.3\n- `chunking_val` 内容与用户问题有明显关联（哪怕 score 较低）\n- 有任意文档内容提到了用户问题中的核心关键词\n\n**允许调整 query 重试 1 次（需同时满足）：**\n- 所有文档的 `score` 都低于 0.15\n- 且 `chunking_val` 内容与用户问题完全无关\n\n**重试规则：**\n- 仅允许重试 **1 次**，不得多次重试\n- query 调整方式：仅提取用户问题中最核心的 1-2 个关键词，不得大幅改写\n- 重试后无论结果如何，直接进入总结\n\n---\n\n## 五、结果展示格式\n\n基于检索到的文档，按以下格式输出：\n\n### 查询总结（详细版）\n\n```\n## 查询总结\n\n根据知识库，关于「[用户问题]」的完整操作指南如下：\n\n### 操作步骤\n\n**第 1 步：[步骤名称]**\n[详细说明这一步要做什么，在哪里操作]\n[如果文档中有图片，必须展示：![操作示意图](图片URL)]\n\n**第 2 步：[步骤名称]**\n[详细说明]\n[相关图片]\n\n...\n\n### 注意事项\n- [从文档中提取的重要提示]\n- [常见问题或特殊情况说明]\n```\n\n### 详细参考\n\n列出相关度较高的文档（score > 0.3），每篇包含：\n- 关键内容（不要过度精简，保留操作细节）\n- 文档中的所有图片（使用 markdown 图片语法展示）\n- 来源链接（`source_url`）\n- 相关度评分（`score`）\n\n### 总结要求\n\n1. **精准解决问题**：直接回答用户的问题，不能泛泛而谈\n2. **保留图片信息**：文档中的图片链接必须完整保留，使用 `![图片说明](图片URL)` 格式展示\n3. **步骤详细列举**：操作步骤逐步编号，每步清晰说明\n4. **内容不能过于简短**：至少包含完整的操作流程，不能省略关键细节\n\n---\n\n## 六、渠道与工具列表\n\n### 21 个渠道\n\n淘宝、天猫、抖音、拼多多、快团团、小红书、快手、微信小店、京东、有赞、微店、淘特、微信小商店、支付宝、苏宁、闲鱼、饿了么、美团、度小店、微盟、微购相册\n\n### 24 个工具\n\n逸淘分销铺货、自动分销、代发助手王、店长铺货、妙手分销、速当家分销、智淘分销、甩手易分销、无忧分销王、晓风分销、大泽云铺货、顶卖分销、铺货代发、1688官方铺货、普云铺货、麦爆了分销、马上分销、掌中宝分销、智汇分销、微购相册、抖掌柜分销、旺分销铺货、小天分销、火牛分销王"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Skill: 1688 Distribution Owner: 1688aiinfra Summary: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-05-06T02:41:54.490Z | auto Initial release of the 1688-distribution skill — unified entry for all 1688 distribution business workflows. - Provides a single command-line interface for product selection/","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":770,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T10:20:45.185Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T10:20:45.185Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:16:20.782Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}