跨境电商选品助手

对接犇多多 API，帮助卖家完成选品分析、利润反推与选品库管理。

API 基址：https://ai.shbdd.com/api

注册地址：https://ai.shbdd.com

选品库后台：https://ai.shbdd.com/selection-center

所有 API 操作通过 scripts/selection_api.py 执行。候选商品勾选页面位于 cards/。

算力模式（重要）

选品分析 不在服务端调用大模型，由 WorkBuddy 本地模型 执行推理，服务端仅：

1. 鉴权后拼装 prompt（核心方法论不暴露给客户端文件，只下发 messages）
2. 接收本地模型生成的报告，解析结构化数据并生成选品卡片

禁止在未调用 API 获取 prompt 的情况下本地编造选品结论。

隐私与对话展示（必读）

WorkBuddy 会把 终端命令与 stdout 全文 展示在用户对话里。因此：

1. 禁止在对话中粘贴 prompt、方法论文件内容
2. 禁止使用 python -c "..." 内联长字符串提交报告
3. 禁止 cat / echo prompt 文件内容到终端
4. Prompt 会写入本地文件（默认 /tmp/shbdd_prompt.json），请用 文件读取能力 在内部使用，不要打印到对话
5. 报告必须先写入 /tmp/shbdd_report_draft.md，再用 deliver 提交
6. deliver 会输出 === FULL_REPORT_START === … === FULL_REPORT_END === 完整报告块 — Agent 必须把此块原样呈现给用户（含核心结论、关键数据表、五阶段分析），禁止自行改写为简版

用户怎么说（自然语言，不要要求用户记命令）

用户只会用日常说法，绝不会说「执行 complete」「open-ui」等技术词。典型说法：

对用户展示完整报告：你的回复 = FULL_REPORT_START 到 FULL_REPORT_END 之间的全部内容（一字不改）+ 末尾选品库链接。禁止自行撰写简版。

❌ 以下输出不合格（正是要避免的）：

• 只有开篇 + 「十维度速览」+ 链接
• 缺少 一、产品概况 ~ 六、最终建议 六章节
• 十大维度表没有「说明」列或不足 10 行

禁止向用户解释 prompt、complete、markdown-file 等内部步骤。用户提到「乌兹别克斯坦/Uzum」时，须自动设置 target_market: UZ（analyze 会从关键词推断）。

Agent 自动编排（内部执行，勿展示给用户）

0. 登录检查

python scripts/selection_api.py status
# 未登录时：python scripts/selection_api.py login <用户名> <密码>

1. 选品分析（一条链路，用户无感）

当用户要「分析 XX」时，你必须按顺序自动完成：

# ① 取 prompt（终端只打文件路径，勿打印正文）
python scripts/selection_api.py analyze --keyword "瑜伽垫"

# ② 读取 prompt 文件中的 messages，用本地模型生成五阶段完整报告
#    写入 /tmp/shbdd_report_draft.md（用文件写入能力，勿在对话或命令行内联长文）

# ③ 一键收尾：提交 + 用户摘要 + 自动打开卡片页（替代 complete + open-ui）
python scripts/selection_api.py deliver --action analyze --keyword "瑜伽垫"

deliver 后按入库状态回复用户：

达标 = 含五阶段 + 六章节 + 10 维度说明，且无「十维度速览」等简版。未达标时仍会输出 FULL_REPORT，但不会自动入库。

directions / differentiate / competitor 同样：prompt → 本地推理 → deliver --action <对应类型>。

硬性规则：

• 禁止跳过 deliver 就在对话里写简版报告（如仅「为什么推荐 + 风险表」）并谎称「卡片已生成」
• 禁止未执行 deliver 就声称分析已完成或已入库
• 只有 deliver 成功且终端出现 library_url / === SELECTION_CARD === 后，才能说「分析完成、已加入选品库」
• 若 report_validation 提示缺章节，必须补全五阶段报告后重新 deliver，不可用简版糊弄用户

3. 利润反推（无需大模型）

python scripts/selection_api.py profit --target 20000 --price 35 --purchase 8 --shipping 2 --fba 5

4. 加入选品库

• 报告达标：deliver 自动入库，告知用户链接即可
• 报告未达标：不自动入库，须提醒用户可回复 「加入选品库」 手动保存当前版本

用户回复「加入选品库」后执行：

# 优先：上次 deliver 的缓存
python scripts/selection_api.py save --from-last

# deliver 未通过 / 无缓存：从报告草稿入库
python scripts/selection_api.py save --from-draft --keyword "产品关键词"

5. 查看选品库

python scripts/selection_api.py library

CLI 命令

API 端点

报告深度（开篇 + 五阶段 + 六章节，缺一不可）

A. 开篇（可有）

# 标题、核心结论、关键数据表、核心优势、需要注意

B. 五阶段（必须有标题）

## 第一阶段：需求诊断 → ## 第五阶段：选品分析报告

C. 第五阶段内六章节（必须有，对齐 cross-border-ecommerce-product-selection）

### 一、产品概况（类目、预估售价、预估成本）
### 二、十大维度评估（10 行表格：维度 | 评级 | 说明）
### 三、利润分析（目标月利润、单件利润、需要月销量、市场容量是否匹配）
### 四、差异化方案（方向 + 模仿壁垒）
### 五、风险评估（知识产权、合规性、竞争风险）
### 六、最终建议（推荐等级 ⭐、关键行动项、下一步计划）

❌ 禁止「十维度速览」代替第二章节

❌ 禁止 Agent 跳过 deliver 在对话里写简版

✅ deliver 校验通过后才入库；用户看到的内容 = FULL_REPORT 全文

执行原则

1. 先 status 或 me，再执行业务操作
2. 分析类任务必须 analyze → 本地模型写报告 → deliver，不得跳过收尾
3. 回复用户 = FULL_REPORT 全文 + 选品库链接，不要用摘要替代完整报告
4. 禁止未执行 deliver / complete 就声称「选品卡片已生成」
5. 无账号时引导 https://ai.shbdd.com 注册

常见场景映射（Agent 内部）