product-sourcing-capture/使用说明.md

直播饰品选品采集系统

这是一个本地运行的 MVP，用来把淘宝、小红书、1688 当前浏览器页面里已经可见的商品/笔记信息采集到本地选品库。

能做什么

• 一键采集当前页面可见的标题、图片、链接、价格、店铺/供应商、可见热度文本。
• 自动识别平台：淘宝、天猫、小红书、1688。
• 自动识别饰品赛道：藏式/民族风、耳饰、项链、手链/手镯、发饰、包挂/手机链等。
• 自动评分并给出：拿样、继续观察、暂不做。
• 自动测算建议直播价、预计毛利、毛利率。
• 自动生成直播卖点、供应商提问清单、风险提醒。
• 自动合并相似款组，方便对比竞品和 1688 货源。
• 在本地后台筛选、查看详情、批量改状态、批量打标签、写备注、导出 CSV。

后台工作区

电脑端左侧有主要工作区，手机端底部有 5 个 Tab：

• 候选库：所有采集款的主列表，可筛选、勾选、批量清理、批量改状态。
• 选品看板：看总数、价格带、赛道分布、优先推进款和系统建议动作。
• 拿样清单：集中查看建议拿样、问供应商、已拿样、直播测试中的款。
• 相似款组：系统把同款/近似款自动归组，方便找竞品对应的 1688 货源。
• 我的工具：手机端入口，集中放导出 CSV、插件目录、本地服务地址和数据文件位置。

当前界面已经按《直播饰品选品系统 UI 提示词体系》实现，定位是内部采购决策台，不是商城页或营销官网。电脑端偏高信息密度和批量处理，手机端偏单手筛选、直播现场快速判断。

筛选与扫货

候选库支持这些筛选：

• 关键词：标题、供应商、赛道、链接、备注、标签。
• 平台：小红书、淘宝、天猫、1688、其他。
• 赛道：藏式/民族风、耳饰、项链、手链/手镯、戒指、发饰、包挂/手机链等。
• 建议动作：拿样、继续观察、暂不做。
• 状态：新采集、待复核、问供应商、已拿样、直播测试、已放弃。
• 标签：支持人工标签和系统自动标签的模糊匹配，例如“低价”“藏式”。
• 价格带：10 元以内、10-30 元、30-100 元、100 元以上、待确认。
• 货源：只看 1688 或只看竞品平台。
• 风险：有风险提醒、高风险、低风险。

手机端顶部有常驻搜索框，可以直接搜标题、供应商和标签；点“筛选”会打开底部抽屉，适合直播间或外出看货时快速拉出“低价跑量款”“1688 货源”“高风险款”。

批量推进采购

1. 在候选库筛选出一批款。
2. 勾选要处理的卡片。
3. 电脑端可以批量点“问供应商”“已拿样”“直播测试”“放弃”。
4. 手机端点底部操作条里的“改状态”，再选择“问供应商”“已拿样”“直播测试”或“放弃”。
5. 可以点“加标签”，例如：低价跑量、藏式主推、直播待测。
6. 已推进的款会进入“拿样清单”，后面继续跟进。

看板判断

选品看板会把采集结果拆成几个更适合直播选品的区域：

• 采购动作：系统给下一步操作建议。
• 价格带：判断第一批 100 元以内跑量款的比例。
• 赛道分布：看藏式/民族风、耳饰、项链等赛道占比。
• 低价跑量款：优先看 10 元以内、适合直播测试的款。
• 利润健康款：优先看“可跑量”或“可测试”的款。
• 高风险提醒：集中复核天然、纯银、转运、功效等敏感话术。
• 优先推进款：按综合评分排序的候选。

利润和直播话术

点开任意候选款的“详情”，可以看到：

• 建议直播价。
• 预计毛利和毛利率。
• 直播卖点。
• 建议询问供应商的问题。
• 风险提醒。

详情页会把“可跑量/可测试/谨慎”“风险等级”“处理状态”放在商品图旁边，手机端会以大抽屉方式打开，便于快速判断是否拿样。

利润测算第一版使用默认模型：包装 1 元、快递 4 元、平台/交易费用 5%、直播让利 3 元。后续可以继续做成可配置。

启动本地服务

在终端进入项目目录：

cd /Users/wangyuqiang/Documents/Codex/2026-06-13/skills/outputs/product-sourcing-capture
npm start

打开后台：

http://127.0.0.1:4777

数据会保存在：

/Users/wangyuqiang/Documents/Codex/2026-06-13/skills/outputs/product-sourcing-capture/data/items.json

安装 Chrome 插件

1. 打开 Chrome。
2. 访问 chrome://extensions/。
3. 开启右上角“开发者模式”。
4. 点击“加载已解压的扩展程序”。
5. 选择这个目录：

/Users/wangyuqiang/Documents/Codex/2026-06-13/skills/outputs/product-sourcing-capture/extension

如果你已经安装过旧版本插件：

1. 回到 chrome://extensions/。
2. 找到“直播饰品选品采集器”。
3. 点击卡片上的刷新/重新加载按钮。
4. 如果仍然没反应，先移除旧插件，再重新“加载已解压的扩展程序”。

使用流程

1. 先运行 npm start。
2. 打开淘宝、小红书或 1688 搜索结果页/商品详情页。
3. 点击浏览器右上角插件。
4. 先点“测试保存到本地库”。如果后台出现一条测试款，说明插件到本地服务链路正常。
5. 再点“采集当前页”或“只采集主商品/笔记”。
6. 如果当前页没采到，先滚动页面让商品图片加载出来，再重新点击采集。
7. 回到 http://127.0.0.1:4777 查看选品库。

批量清理误采集

1. 在后台用关键词、平台、赛道或左侧建议动作先筛出一批候选。
2. 勾选商品卡片左上角的“选择”。
3. 如果当前筛选结果都要清理，点“全选当前结果”。
4. 误选了可以点单个勾选框取消，或点“取消选择”全部清空。
5. 点“删除所选”，工具条会进入确认状态。
6. 再点“确认删除”，会从本地选品库删除这些候选；点“返回”可以放弃删除。

批量删除只清理本地数据，不会影响淘宝、小红书或 1688 原页面。

注意边界

• 只采集当前页面已经显示出来的内容。
• 不绕过登录、验证码、平台限制或后台权限。
• 搜索量、成交量等如果页面没显示，系统不会凭空声称真实数据。
• 第一版是启发式采集，后续可以针对淘宝、小红书、1688 页面结构继续优化命中率。