Initial release with production deploy config.

Add GitAtlas deploy assets, DATA_FILE support for isolated server data, and port documentation for sourcing.simosen.cn. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-15 00:52:31 +08:00
commit e9939ef9dc
45 changed files with 14376 additions and 0 deletions
@@ -0,0 +1,145 @@
+# 直播饰品选品采集系统
+
+这是一个本地运行的 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 元。后续可以继续做成可配置。
+
+## 启动本地服务
+
+在终端进入项目目录：
+
+```bash
+cd /Users/wangyuqiang/Documents/Codex/2026-06-13/skills/outputs/product-sourcing-capture
+npm start
+```
+
+打开后台：
+
+```text
+http://127.0.0.1:4777
+```
+
+数据会保存在：
+
+```text
+/Users/wangyuqiang/Documents/Codex/2026-06-13/skills/outputs/product-sourcing-capture/data/items.json
+```
+
+## 安装 Chrome 插件
+
+1. 打开 Chrome。
+2. 访问 `chrome://extensions/`。
+3. 开启右上角“开发者模式”。
+4. 点击“加载已解压的扩展程序”。
+5. 选择这个目录：
+
+```text
+/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 页面结构继续优化命中率。