1688-shopkeeper

统一入口：python3 {baseDir}/cli.py <command> [options]

命令速查

所有命令输出 JSON：{"success": bool, "markdown": str, "data": {...}} 展示时直接输出 markdown 字段，Agent 分析追加在后面，不得混入其中。

标准流程

选品→铺货：check → search → 用户筛选(Agent 推荐 + 用户确认) → shops → publish 首次使用：check → 按 data 字段分支：

• ak_configured: false → 先 configure（优先级最高，其他命令都依赖 AK）
• shops_count: 0 → 引导开店
• expired_count > 0 → 提示重新授权
• 全部正常 → 进入选品流程

刚配置 AK：当前会话命令前加 ALI_1688_AK=xxx，重启 Gateway 后全局生效

执行前置（必须）

• 执行 search 前：先完整阅读 references/search.md
• 执行 shops / publish 前：先完整阅读 references/publish.md
• 执行 configure 前：先完整阅读 references/configure.md

AK 引导话术

"需要先配置 AK。打开 1688 AI版 APP（没装的话点链接下载），首页点击「一键部署开店Claw，全自动化赚钱🦞」，进入页面获取 AK，然后告诉我：'我的AK是 xxx'"

开店引导话术

"还没有绑定店铺。打开 1688 AI版APP → 首页「一键开店」，开好后告诉我。"

FAQ 经营知识（按需加载）

用户问经营问题时，先加载对应文件再回答，不凭经验泛泛而谈。