108 lines
6.5 KiB
Markdown
108 lines
6.5 KiB
Markdown
---
|
||
name: dianxiaomi-multiplatform-listing
|
||
description: "在店小秘（dianxiaomi）把同一批商品批量建到多个跨境平台的「待发布」，并诊断「点保存没反应」。覆盖 Ozon/TikTok/Shopee/Walmart/速卖通/SHEIN/Temu 的店铺选择、类目弹窗、字段 store 落点、价格币种、图片外链写法、SKU 表结构。触发词：店小秘、dianxiaomi、批量建品、待发布、铺货、多平台、保存没反应、静默拦截、SHEIN 建品、Temu 建品、Temu 全托管、Walmart 建品、速卖通建品、TikTok 建品、Shopee 建品。"
|
||
---
|
||
|
||
# 店小秘多平台批量建品
|
||
|
||
> 完整配方与逐平台踩坑：Gitea `admin9webs/dianxiaomi-crossborder-playbook`（本机 `~/gitea-push/dianxiaomi-crossborder-playbook/`）
|
||
> 本技能是可复用的**操作约定 + 通用技术事实**；具体字段表看仓库各平台目录。
|
||
|
||
## 0. 第一原则：遇到「点保存没反应」先挂钩子，不要猜字段
|
||
|
||
**症状**：点「保存」→ 不发 POST、无界面提示、无 `.ant-form-item-has-error`。
|
||
|
||
**根因**：校验失败了，但报错被 **`MYJ.message.error` 吞掉**；而且报错**层层递进**
|
||
（修完 A 才显示 B）——不修完前一层，后一层根本不显示。
|
||
|
||
**解法**（在点保存**之前**注入）：
|
||
```js
|
||
window.__cap=[];
|
||
function wrap(o,n,l){const f=o[n];o[n]=function(){
|
||
window.__cap.push(l+': '+[...arguments].map(a=>typeof a==='string'?a:JSON.stringify(a)).join(' '));
|
||
return f.apply(o,arguments);};}
|
||
['error','warning','info','success'].forEach(k=>wrap(MYJ.message,k,'MYJ.'+k));
|
||
['error','warning','info','success'].forEach(k=>wrap(antd.message,k,'antd.'+k));
|
||
```
|
||
点保存 → 读 `window.__cap`。
|
||
|
||
**为什么「必填扫描」不够**：扫 `.ant-form-item-required` 且为空，会漏掉
|
||
**条件必填**（Temu 省份：产地=中国才出现）和**类目相关的文件字段**
|
||
（速卖通商品说明书：部分类目强制）。
|
||
|
||
已用此法定位：
|
||
| 平台 | 被吞掉的报错 |
|
||
|---|---|
|
||
| 速卖通 | `商品说明书 → 请上传文件！`（类目相关） |
|
||
| SHEIN | `有必选规格未选择，请完善后再提交` |
|
||
| Temu | `产地选择中国时，省份必填` → `产品变种不能为空！` → `尺寸不能为0或空` → `净重必须小于重量` → `请上传预览图` |
|
||
|
||
## 1. 通用技术事实
|
||
|
||
- 站点是 **Vue3 + Pinia SPA**，读 store：
|
||
```js
|
||
document.querySelector('#app').__vue_app__.config.globalProperties.$pinia._s.get('<store>').$state
|
||
```
|
||
- Chrome CDP 端口 **9223**，profile `/tmp/dxm7`；helper `/tmp/cdp3.mjs`（**ESM，不能用 require**）
|
||
- VNC：`http://192.168.9.122:6097/vnc.html` / `:6100`（免密）
|
||
- 列表 API 一律 `POST /api/<平台>Product/pageList.json`，列表在 `data.page.list`
|
||
- **`idStr ≠ id`**：大整数 JS 精度丢失，服务端操作（删除/详情）一律用 `idStr`
|
||
|
||
## 2. 交互约定（血泪换来的）
|
||
|
||
| 场景 | 正确做法 |
|
||
|---|---|
|
||
| antd select 选项 | **DOM click** `.ant-select-item-option` 通常可行 |
|
||
| 只吃真实鼠标的组件 | `Input.dispatchMouseEvent` 发 `mousePressed`/`mouseReleased` |
|
||
| **hover 触发的下拉** | 先 `mouseMoved` 到目标，再 `click`（Walmart「选择图片」） |
|
||
| 类名含 `!` 的选择器 | `input[class*="!w-200"]`（`input.!w-200` 是非法 CSS） |
|
||
| 长下拉（几百项） | 先 `scrollTop=0`（会残留上次位置），再滚动找 |
|
||
| 有 store 直读列表 | **优先读 store**（Temu 类目 1038 个在 `dataState.categories`），比驱动 UI 可靠 |
|
||
| 文本输入 | `Object.getOwnPropertyDescriptor(proto,'value').set.call(el,v)` + `input`/`change`/`blur` 事件 |
|
||
| 改 store 后校验仍失败 | UI **异步同步**，**再点一次保存**可能就过了 |
|
||
|
||
## 3. 各平台最独特的一点
|
||
|
||
| 平台 | 必须知道 |
|
||
|---|---|
|
||
| **Ozon** | 保存按钮是**「保存并移入待发布」**；价格 **CNY**；改价必须**同时抬高原价**，否则 `售价需小于原价`；回读走 API `variantList[].price(原价)/salePrice(售价)` |
|
||
| **TikTok** | 价格 **MYR**；店铺**锁站点**（一个品牌 × 多站点）；图片 store 直接吃**外链数组** |
|
||
| **Shopee** | 用**单件模式** `type='single'` 绕开变种；价格 **CNY**；列表字段是 `itemName` **不是** title |
|
||
| **Walmart** | 保存体是 **zip 的 multipart**（zip 内 `walmartSave.txt`）；Brand 必须**点「无品牌」勾选框**（打字无效）；图片必须 **hover → 网络图片** 贴 URL |
|
||
| **速卖通** | **`check_box` 属性值必须是数组**（否则 `P.forEach is not a function`）；图片列用外链 `{id,url,name,width,height,imgId,checked}` |
|
||
| **SHEIN** | **店铺锁品类**（箱包店选不了发夹）；类目要**两个规格**（点 `.theme-select-box` 加 `尺寸(Size)`）；⚠️ **加规格会重建 SKU 行**，顺序必须「规格 → SKU → 尺码表」 |
|
||
| **Temu** | 规格用 **`.theme-value-add`** 块（值输入 + 添加按钮），**必须手动输值再点添加**，改 store 无效；报错层层递进 |
|
||
|
||
## 4. 图片
|
||
|
||
全部用**外链**（alicdn 等），且必须**无水印**（平台会删带联系方式的图）。
|
||
字段形如 `{url, imgUrl, name, width, height}`，多数平台存**数组**，
|
||
Walmart 例外（必须走「网络图片」UI，落成 `|` 分隔字符串）。
|
||
|
||
## 5. 定价口径
|
||
|
||
Ozon ≤500g 档（用户给定的表，已解出公式）：
|
||
```
|
||
运费成本 = 4.2 + 重量(g) × 0.045
|
||
合计成本 = 进货价 + 运费成本
|
||
售价 = 合计成本 ÷ (1 − 20%佣金 − 利润率)
|
||
价格带 = 0–1500₽ / 0–113¥（≈13.27₽/¥）
|
||
```
|
||
其它档：budget 500-2500g `重量×0.02345+15.96`；small 1-2000g `重量×0.02534+14.07`。
|
||
跨币种：MYR ≈ CNY×0.60；USD = CNY÷6.68525（店小秘 `siteAndUsCurrencyRate`）。
|
||
|
||
## 6. EAN-13 台账（湖北易千亿彩 · 69803093 段）
|
||
|
||
- 结构：`69803093` + 4 位产品码 + 1 位校验
|
||
- 校验：`(10 - sum(d*(1 if i%2==0 else 3) for i,d in enumerate(d12)) % 10) % 10`
|
||
（左起权重 1,3,1,3…；**UPC-A 权重相反**）
|
||
- 台账唯一来源 **S03 `/root/ean_*.txt`**（KVM-2 够不到）→ 用号后**必须去 S03 落盘**，否则撞号
|
||
- 说明书 §1 例子 `pc 1000 → 6980309310004` 是**错的**，正确 `6980309310007`
|
||
|
||
## 7. 批量作业约定
|
||
|
||
- 动辄 1 小时 → `nohup bash run.sh > out.log 2>&1 &` 后台跑，**每条一个日志文件**
|
||
- 脚本写成「一个 oid 一条命令」+ shell 循环，**单条失败不拖垮整批**
|
||
- **跑之前先检查是否已存在**，否则重试会产生重复（本会话踩过：某商品被建了 3 份）
|
||
- 删重复：速卖通 `POST /api/smtProduct/batchDelete.json` body `ids=<idStr>`
|