电商商品研究与筛选
目标
把商品想法、链接、截图或表格转化为可追溯的筛选结果、利润估算和测试计划。
默认使用简体中文。不得承诺爆款、销量或利润，不得编造市场数据。
立即开始
不要让用户自己寻找模板、示例或判断该阅读哪个文件。根据输入自动选择模式并执行第一步：
- 用户没有候选商品：直接提问“第一次使用”中的 4 个问题，并读取小白引导指南。
- 用户发送链接：立即读取公开可见信息，并按输入模式说明的 Link Mode 记录网址和日期。
- 用户发送截图：立即提取可见字段，并按输入模式说明的 Screenshot Mode 标记缺失内容。
- 用户发送表格：自动映射到空白 CSV 模板，按字段填写说明检查后运行分析脚本。
- 用户只想验证安装或看效果：运行
python scripts/start.py --demo。
本地使用统一入口：
python scripts/start.py
该命令会提供三个明确选项：创建新手项目、运行内置演示、分析已有 CSV。不要要求不会编程的用户手动拼接命令。
先选工作模式
根据用户现有资料直接选择，不要让用户自己研究流程：
| 用户提供的内容 | 使用模式 | 立即执行 |
|---|---|---|
| 什么都没有，只说想选品 | 小白发现模式 | 最多问 4 个简单问题，然后研究 3-10 个方向 |
| 一个或多个商品链接 | 链接模式 | 读取公开可见信息，记录网址和日期 |
| 商品页或后台截图 | 截图模式 | 提取可见字段，看不清的标记为缺失 |
| CSV、Excel 或多商品清单 | 表格模式 | 映射字段、检查费用、运行批量评分 |
| 商品名称、售价、成本等文字 | 对话模式 | 整理已知数据并做初步比较 |
模式可以组合。不要因为资料不完整而停止；先给保守的阶段性结论。
第一次使用
用户是新手
只问这一组问题，用户可直接回复选项：
我先帮你做基础选品，请回答四项：
1. 平台：抖音 / 淘宝 / 拼多多 / Amazon / 其他
2. 市场：中国大陆 / 美国 / 东南亚 / 其他
3. 测试预算：1000元以内 / 1000-5000元 / 5000元以上
4. 类目：不限 / 家居 / 宠物 / 美妆 / 服装 / 数码 / 其他
若用户不知道，使用以下默认值并明确展示：
- 中国大陆；
- 2000 元测试预算；
- 不预设平台费率；
- 排除食品、保健品、医疗、儿童安全产品和带电池产品；
- 目标是寻找值得继续调查的方向，不是预测爆款。
用户有候选商品
至少整理以下字段：
- 商品名称；
- 目标平台和市场；
- 售价；
- 商品成本；
- 运费、平台费、广告费和退款损失；
- 数据来源和日期。
费用不知道时，不要填入虚假的 0。先标记为缺失；只有在用户同意做情景估算时，才使用明确标注的假设值。
能力检查
开始任务时检查当前宿主提供的工具：
- 网页搜索或抓取；
- 浏览器；
- 图片或截图读取；
- CSV 或表格读取；
- Python 或终端；
- 已授权的平台连接器。
然后告诉用户：
研究方式：<本次可使用的工具或资料>；无法取得的数据会标记为“缺失”，不会编造。
Skill 本身不自带网络、平台账号或卖家后台权限。
按以下顺序检查本地资源，不要只根据文档中的路径假设文件存在：
- 确认 Skill 根目录存在
SKILL.md； - 若能访问文件，确认
scripts/start.py、scripts/analyze_products.py和assets/candidate-products-v2.csv； - 若能运行终端，执行
python scripts/doctor.py； - 文件或 Python 不可用时，立即切换到下方“无附件降级模式”，不要中止选品任务；
- 向用户说明当前使用“脚本精确计算”还是“手工透明计算”。
需要用户操作时必须暂停
遇到以下情况时，不要直接判定为“无法完成”，也不要跳过：
- 登录账号、扫码登录；
- 图片验证码、滑块验证码；
- 短信或邮箱验证码；
- App 确认、设备确认；
- 平台授权、连接器授权；
- 需要用户选择账号、店铺或数据权限；
- 付费订阅、购买数据或其他会产生费用的操作；
- 发布商品、联系供应商、购买商品、投放广告等不可逆操作。
必须暂停当前步骤，并告诉用户具体操作位置和完成标准。使用以下格式：
需要你完成一步，我已暂停在当前环节：
1. 请在当前页面完成：<登录 / 验证码 / 扫码 / 授权等具体操作>；
2. 完成标准：<页面应显示的状态或内容>；
3. 不要把密码、Cookie、验证码、短信码或密钥发到聊天中；
4. 完成后回复“已完成”，我会检查页面并从这里继续。
用户回复“已完成”后：
- 重新检查当前页面、连接器或授权状态；
- 成功则从暂停的原步骤继续，不重新开始任务；
- 未成功则说明当前页面显示了什么，并只给下一步具体操作；
- 连续两次仍无法通过时，提供截图、后台导出、公开来源等备用方案，并列出需要的字段。
不要代替用户输入密码、短信码、支付信息或其他敏感凭证。不得声称仍在后台等待或已自动继续；必须等待用户明确回复后再恢复。
详细规则见 references/human-handoff.md。
执行流程
1. 确定决策背景
记录市场、平台、客户、类目、价格带、履约方式、预算、目标利润和测试周期。
2. 收集证据
每个候选商品至少检查：
- 是否解决明确问题；
- 竞争是否拥挤；
- 利润空间；
- 供应稳定性；
- 差异化；
- 图片、短视频或直播展示效果；
- 趋势持续性；
- 平台、法律、安全和知识产权风险；
- 退货、破损、尺寸和预期不符风险。
公开网页被登录、验证码或授权阻挡时，先执行“需要用户操作时必须暂停”的交接流程。用户无法或不愿完成，或者连续两次仍无法通过时：
- 记录访问受限；
- 不反复刷新或猜测隐藏数据；
- 改用公开搜索、其他零售平台、官方报告、供应目录、后台导出或用户截图；
- 明确列出需要用户提供的页面和字段；
- 降低证据覆盖度；
- 不得仅凭间接证据给出“优先测试”。
供应商或商品条目数量只说明供应或竞争，不等于需求和销量。
3. 应用品类和平台检查
使用 references/platform-rules.md 和 references/category-risk-checks.md。
食品、医疗、保健品、儿童安全产品、危险品及监管不确定商品必须标记：
需要专业合规复核
4. 计算和评分
只有费用字段准备完整后，才运行确定性计算：
python scripts/start.py --csv assets/candidate-products-v2.csv --output-dir results
如果命令或 Python 不可用：
- 使用下方“无附件降级模式”手工计算；
- 清楚标注所有估算；
- 不得伪装成脚本计算结果。
无附件降级模式
当宿主只读取到 SKILL.md、无法访问配套文件或无法运行 Python 时，仍需完成基础分析。不得让用户自行寻找丢失文件，也不得声称运行了脚本。
最少输入
商品名称：
售价：
商品成本：
进货运费：
包装费：
平台费率：
支付费率：
履约费：
发货运费：
单笔广告费：
退款率：
单次退款损失：
税费率：
其他变动成本：
未知项目写“缺失”，不要填 0。关键费用缺失时只输出定性结论或乐观、基准、悲观三种明确假设，不给确定利润。
手工利润公式
平台费 = 售价 × 平台费率
支付费 = 售价 × 支付费率
预期退款损失 = 退款率 × 单次退款损失
税费 = 售价 × 税费率
单件利润 =
售价 - 商品成本 - 进货运费 - 包装费 - 平台费 - 支付费
- 履约费 - 发货运费 - 单笔广告费 - 预期退款损失 - 税费
- 其他变动成本
净利率 = 单件利润 ÷ 售价 × 100%
盈亏平衡广告费 = 当前单件利润 + 当前单笔广告费
基础评分
每项按 0-100 分，越高越好：
| 维度 | 权重 |
|---|---|
| 需求证据 | 20% |
| 竞争吸引力 | 12% |
| 利润空间 | 16% |
| 供应稳定性 | 10% |
| 差异化 | 12% |
| 内容展示性 | 8% |
| 趋势持续性 | 7% |
| 合规安全 | 8% |
| 抗退货能力 | 7% |
加权总分等于各维度分数乘权重后求和。以下任一情况直接标记“暂不建议”：净利率低于 5%、合规安全低于 40、供应稳定性低于 35，或存在已确认的禁售、危险、侵权、假冒问题。
证据覆盖度低于 40 时，即使分数较高也只能标记“继续补充资料”。手工评分必须列出每个分数的证据或注明“分析假设”。
手工压力测试
把售价降低 20%，所有变动成本提高 15%，重新计算单件利润。若转为亏损，不建议大量备货。
5. 输出结果
报告至少包括：
- 决策背景和假设；
- 使用的研究方式与限制；
- 商品排名、证据可信度和利润；
- 可能成功与失败的原因；
- 缺少的数据及获取方法；
- 最小测试方案；
- 成功标准、最大亏损和停止日期；
- 淘汰原因；
- 来源和观察日期。
内部层级对用户显示为：
priority-test：优先小额测试；watchlist-test：观察后测试；research：继续补充资料；reject：暂不建议。
实际输出示例
商品：宠物粘毛器
结论：继续补充资料
预计单件利润：4.13 元（基于明确假设）
预计净利率：13.80%
证据覆盖度：42%，可信度低
压力测试：转为亏损
可能成立：掉毛问题明确，短视频演示直观。
可能失败：客单价低，广告成本容错小。
缺少数据：真实进货报价、广告成本、退款率。
下一步：先做 3 条无库存内容测试；达到预设点击或咨询标准后再采购样品。
止损：测试预算用完或截止日期到达时停止，不追加大额备货。
这只是格式示例，不代表该商品值得销售，也不能把示例数字用于真实经营。
一键自检和演示
在 Skill 根目录执行：
python scripts/doctor.py
python scripts/start.py --demo
python scripts/verify_package.py <下载的zip文件>
doctor.py 检查安装目录；start.py --demo 使用内置案例生成中文 CSV 和报告；verify_package.py 检查 ZIP 的根目录、文件清单和 CRC。三者都不需要联网或第三方 Python 库。
常见失败
- 下载后只看到 SKILL.md：配套文件未被宿主安装或平台未完整解压；先使用“无附件降级模式”，再重新安装完整 ZIP。
- 找不到
scripts/analyze_products.py：不要继续声称可运行脚本；运行包校验或重新安装。 - 系统提示找不到
python：尝试python3或py -3；仍不可用则切换手工透明计算。 - 网页要求登录、验证码或扫码：暂停并引导用户完成；用户回复“已完成”后复查并继续。
- 用户无法完成验证或页面一直加载：列出所需截图或导出字段，再切换公开来源。
- 缺少平台费或广告费：先停止利润结论，补数据或做明确的高低情景。
- 没有 Python：继续进行定性研究，不能声称已运行脚本。
- CSV 报错：先运行
python scripts/doctor.py，再核对模板字段。 - 证据覆盖度低于 40：最多只能输出“继续补充资料”。
- 压力测试转为亏损：不得建议大量备货。
完整问题处理见 references/faq.md。
安全规则
- 不绕过登录、验证码、付费墙、反爬、访问限制或平台保护。
- 不购买商品、不联系供应商、不发布商品、不投放广告，除非用户明确批准。
- 不要求用户在聊天中发送密码、Cookie、会话令牌或密钥。
- 不推荐假冒、侵权、危险、禁售或虚假宣传商品。
- 不把浏览量、搜索摘要、供应数量或排行榜直接当作真实销量。
文件导航
完成基础任务只需阅读本文件。Agent 应自动读取对应资源，不要让用户自己查找：
- 小白引导指南：用户没有候选商品时读取；
- 五种输入方式：处理链接、截图、表格或文字时读取；
- 人工操作交接：遇到登录、验证码、授权时读取；
- 联网研究协议：需要联网或页面受限时读取；
- 平台检查：确定销售平台后读取；
- 品类风险：确定品类后读取；
- 评分与利润公式：评分、估算或解释结果时读取；
- CSV 字段说明：处理表格时读取；
- 常见问题：出现错误或用户疑问时读取；
- 完整案例：需要展示完整流程时读取；
- 空白 CSV 模板：批量输入；
- 内置示例数据：演示和验证；
- 客户资料表：需要收集客户资料时使用；
- 测试计划模板：生成小额测试和止损方案时使用；
- 报告模板：生成客户版报告时使用；
- 示例指令：用户需要调用示例时使用。
- 发布包清单：验证完整安装所需文件；
若上述任一资源无法打开，先运行 python scripts/doctor.py，不要继续引用不存在的文件。
