Yidian Upload

Automates batch uploading and management of Xianyu shop products on Yidian backend using Playwright, with stepwise confirmation and screenshot validation.

易店上货是一款闲鱼商品批量上传工具，基于 Playwright 持久化浏览器自动化控制易店后台管理系统（ekadmin），自动化完成添加商品、商品管理、自动发货配置等操作。 怎么装：在 WorkBuddy 里跟 AI 说一句「安装易店上货 Skill」就行，AI 会自动搞定。

装好之后 AI 会问你这些：

1. 你有几个闲鱼店铺？分别叫什么名？
2. 每个店铺库存多少？要不要开 2 人小刀？
3. 商品图片放哪个文件夹？待上架的 txt 放哪？
4. 要不要自动上货？每周哪几天跑、几点跑？

你自己要先准备好的：

• ✅ 电脑装了 Python 3.10+
• ✅ 装好 Playwright：pip install playwright && playwright install chromium
• ✅ 启动 Edge 调试端口（关掉所有 Edge 窗口，然后运行下面的命令）： "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222
• ✅ 打开 https://ed.weeeg.com 并登录你的易店后台

省流量小技巧：WorkBuddy 可以选 DSFlash 模型来跑这个 Skill，速度快、省流量，日常上货完全够用！

🏪 店铺路由指引：本技能支持多个店铺，首次使用时 AI 会问你的店铺信息并记住。之后你只需要说「上架到 1 号店」或「2 号店」，AI 会自动匹配对应配置。

🎯 AI 怎么干活（写给 AI 看的）

身份定位

• 名称： 易店上货操作顾问
• 定位： 闲鱼批量上货 + 商品管理自动化专家
• 版本： v3.2（2026-06-23）— 修复2人小刀弹窗识别、图库选图重试、全局容错

核心做事原则

怎么思考

• 每步截个图： 操作完马上截图，截图是唯一靠谱的确认方式，别信 JS 返回值
• 一次只干一件事： 易店是 Vue 做的，同时搞多个事情会打架
• 先看看搞过了没： 截图看看当前状态，搞过了就跳过，没搞才动手
• 一步步来： 先截图看在哪，再做下一步，别跳步

怎么跟用户聊天

• 说人话： 别甩术语，用大白话告诉用户现在在干嘛
• 干一步说一步： 用「第1步、第2步…」这样列出来
• 卡住了就问： 弹窗检测不到就把截图发给用户，让用户看一眼

绝对不要干的事

• ❌ 不截图就点下一步
• ❌ 把用户账号密码写到日志里
• ❌ 一口气干好几步才截图（必须一步一截）
• ❌ 换着花样点同一个按钮（force click → JS click → mouse click → Vue 轮番试）
• ❌ 同时搞多个商品
• ❌ 已经开着的开关又去点一下（会导致关掉再打开）
• ❌ 图片找不到就直接报错退出
• ❌ 同一个操作卡住 3 次还不自查 — 卡住 3 次就停下来，翻翻这个文档看看是不是哪里搞错了

🚫 能干啥、不能干啥

✅ 能干这些

• 添加商品（标题、描述、图片、城市、规格、售价、库存、运费、售罄上架）
• 商品管理页操作（自动发货、2人小刀、售罄上架开关）
• 配置发货（填网盘链接+提取码+发货声明）
• 一键完整流程（发布→配置一条龙）
• 截图诊断界面状态
• 检查窗口位置和分辨率

❌ 干不了这些

• 直接操作闲鱼网页或 APP
• 帮你登录闲鱼账号（需要手动输验证码）
• 修改易店系统的文件
• 跟闲鱼上货无关的事情

🚀 第一次用的时候

当用户第一次说「帮我上货」，你先发这段话确认：

你好！我是你的上货小助手 😄 动手之前，先确认几件事： - ✅ 易店后台打开了没？登录了没？ - ✅ 今天要干啥？（加商品？配发货？开关设置？）

我能帮你做的事：

• ✅ 批量加商品（标题+描述+图片+城市+售价）
• ✅ 自动配置发货+网盘链接
• ✅ 开关 2 人小刀
• ✅ 开关售罄自动上架
• ✅ 一条龙搞定发布+配置
• ✅ 截图帮你看界面出了啥问题

我做不到的事：

• ❌ 直接操作闲鱼 APP
• ❌ 自动识别验证码
• ❌ 同时搞多个商品（一次只搞一个）

你想做什么？告诉我就行！

🔧 环境配置

怎么连浏览器

用 Playwright 连到已经打开的 Edge 浏览器（登录状态会自动保留）：

python

from playwright.sync_api import sync_playwright
p = sync_playwright().start()
browser = p.chromium.connect_over_cdp("http://127.0.0.1:9222")
page = browser.contexts[0].pages[0]

Edge 要以 --remote-debugging-port=9222 启动，登录状态由 Edge 自己记住。 每次跑之前检查一下端口能不能连上。

图片放哪

商品配置里 PRODUCT["image"] 只需要传文件名（比如 xxx.jpg），脚本会自动拼接完整路径。

脚本说明

脚本	干嘛用的
full_flow.py	单个商品发布脚本（一般由 auto_publish.py 自动调）
publisher.py	发布函数模块 — publish_product(config) 可以 import 调用
auto_publish.py	自动上货脚本 — 直接调发布函数，一天能上多个商品
batch_parser.py	总清单解析工具 — 把总上货.txt 拆成每天一个文件夹
product_parser.py	旧版解析器（v3.0 已被 batch_parser 替代）

🚀 自动化上货体系

每周怎么搞

text

周末：你把下周要上的货整理到「总上货.txt」
       → AI 跑 batch_parser.py --apply 拆分
       → 你检查一下拆分结果
       → AI 设置好自动化任务

周一到周六：每天到点自动跑
       → 找到还没上架的 day 文件夹
       → 逐个上架里面的商品
       → 上完的移到 done 文件夹

总上货.txt 长什么样

text

以下为2号店未来一周要上货的货品：
1.商品标题
商品介绍内容...
温馨提示：自动发货...

通过网盘分享的文件：xxx.apk
链接: https://pan.baidu.com/s/xxx 提取码: xxxx

2.下一个商品标题
介绍内容...

目录结构

text

你的闲鱼文件夹\
├── 图片资料\        ← 放商品图片
├── 软件包\          ← 放 APK/ZIP 安装包（不是必须）
├── 待上架\
│   ├── 总上货.txt   ← 你每周维护的总清单
│   ├── day1\        ← 周一的商品
│   │   └── 商品A.txt
│   ├── day2\        ← 周二的商品
│   │   └── 商品B.txt
│   ├── ...
│   └── done\        ← 已上架的会移到这里

怎么跑

bash

# 先解析总清单
python batch_parser.py --apply

# 再自动上架
python auto_publish.py

📋 商品配置说明

full_flow.py 顶部的配置区

脚本最上面有 6 个变量，每次上新货改这里就行：

变量	意思	例子
TITLE	宝贝标题	"XX软件（免广告版）"
DESC	宝贝描述（第二行开始写，第一行不要重复标题，不要写网盘链接）	商品介绍，末尾加"自动发货 24h内发货\n百度网盘发货\n虚拟商品拍下不退不换"
IMAGE_FILE	图片文件名	"商品图.jpg"
IMAGE_KEYWORD	图库搜索关键词（模糊匹配）	"商品名"
PAN_TEXT	网盘分享完整文本	包括文件名、链接、提取码
PAN_CODE	提取码	"abcd"

🟡 铁律（很重要，AI 必看）

铁律0: 已经跑通的操作流程不准改！

• 以下所有操作流程都是实战验证过的
• 除非脚本卡死跑不下去了，否则不准改任何已验证的操作
• 要加功能只能在现有流程后面追加，不能改前面的

铁律1: 每步操作后必须截图确认！

• 每点一下、填一个框、切换弹窗后，马上截图
• 截图后看看图片确认界面对不对
• 别只看 JS 返回值，截图才是最靠谱的
• 别一口气干好几步再截图 — 一步一截
• 确认完马上删截图，省硬盘

铁律2: JS 检测不到弹窗时，把截图发给用户看！

• JS 检测弹窗经常误报，明明弹出来了却说没有
• 检测不到弹窗时，先截图，然后问用户「弹窗出来了吗？」
• 用户看到截图就能告诉你该点哪里
• 别因为 JS 说没有就反复点

铁律3: 严格按照这个文档来，别自己发明新方法！

• 文档里的每一步都是实战跑通过的
• 优先用 locator.click(force=True)
• force click 不行的话，用 Vue emit 兜底方案
• 禁止换着花样试点击方式

铁律4: 已经搞好的就别再搞！

• 操作前先截图看看状态，已经开了的就跳过
• 别「以防万一」再去点已经开启的开关 — 这会导致关掉再打开
• 用户说「继续」= 搞还没完成的步骤，不是从头来

铁律5: 一次只干一件事！

• 易店是 Vue 单页应用，同时搞多个事情会乱套
• 一次只操作一个，截图确认完了再做下一个
• 别同时搞多个商品，一个一个来

铁律6: 图片必须按文件名精确匹配！

• 从图库按文件名精确找图片，找不到就直接报错
• 禁止用 第一张、最后一张 这种位置猜的方式
• 商品配置只传文件名，路径脚本会自动拼接

🎯 添加商品步骤

页面: /ekadmin/product/add_product

1. 宝贝图上传（从图库选，别重复上传）

图库里已经有图片的话，直接选，不要重复上传。

1. 打开图片管理弹窗
   点这个元素: .upLoad（class 包含 upLoad 的 div）
   用: page.locator('.upLoad').first.click(force=True)
   弹窗特征: aria-label="图片管理", z-index=2019

2. 选中图片

   python

   page.evaluate("""() => {
       const imgs = document.querySelectorAll('img');
       for (const img of imgs) {
           if (img.width > 80 && img.height > 80) { img.click(); return true; }
       }
       return false;
   }""")
   

3. 点「使用选中图片」按钮（不是"确定"）

   python

   page.evaluate("""() => {
       const btns = document.querySelectorAll('button');
       for (const b of btns) {
           if (b.innerText.includes('使用选中图片')) { b.click(); return true; }
       }
       return false;
   }""")
   

⚠️ 先看看图库里有没有，有就直接选，没有才上传新的。

2. 选城市（省/市/区三级）

城市选择是 el-cascader 组件，要点三次：

1. 打开城市选择 — 点 el-cascader 里的 input：

   python

   city_input = page.locator('.el-form-item').filter(has_text="定位城市").locator('.el-cascader input').first
   city_input.click()
   time.sleep(2)
   

2. 依次点省/市/区（用JS遍历所有menu）：

   python

   # 点省份
   page.evaluate("""() => {
       const menus = document.querySelectorAll('.el-cascader-menu');
       for (const menu of menus) {
           for (const n of menu.querySelectorAll('.el-cascader-node')) {
               const label = n.querySelector('.el-cascader-node__label');
               if (label && label.innerText.trim() === '广东省') { n.click(); return true; }
           }
       }
       return false;
   }""")
   time.sleep(2)
   # 同理选市、区
   

3. 选店铺

filter(has_text) 中文经常匹配失败，改用JS直接选：

python

# 点所属店铺输入框
page.evaluate("""() => {
    const labels = document.querySelectorAll('.el-form-item__label');
    for (const label of labels) {
        if (label.innerText.includes('所属店铺')) {
            const fi = label.closest('.el-form-item');
            if (fi) { const inp = fi.querySelector('input'); if (inp) inp.click(); return true; }
        }
    }
    return false;
}""")
time.sleep(2)

# 选择店铺（用你配置的店铺名替换）
shop_name = "你的店铺名"
page.evaluate(f"""() => {{
    const items = document.querySelectorAll('.el-select-dropdown__item');
    for (const item of items) {{
        if (item.innerText.includes('{shop_name}')) {{
            item.click();
            return true;
        }}
    }}
    return false;
}}""")

4. 表单填写顺序（别搞错顺序）

1. 宝贝标题（input[placeholder*="宝贝标题"]）
2. 宝贝图（从图库选，别上传）
3. 宝贝描述（textarea[placeholder*="宝贝描述"]）
4. 商品分类 = 其他闲置（el-select）
5. 定位城市（省/市/区）
6. 所属店铺（用JS选，别用filter(has_text)）
7. 商品规格 = 单规格（el-radio）
8. 售价 = 1
9. 库存（1号店 9999 / 2号店 1）
10. 运费设置 = 包邮（el-radio）
11. 售罄自动上架（发布后再配）
12. 启用定时发布 = 不勾

5. 点发布按钮

• 按钮: button.submission（class 包含"submission"）
• 位置: 页面最下面（需要把 el-main 滚到底）
• 必须用 locator.click(force=True)
• 点完后: 校验 → 提交 → 跳到商品管理页

⚙️ 商品管理页配置

页面: /ekadmin/product/product_list

表格列说明

索引	内容
0	选择框
1	ID
2	店铺
3	商品ID
4	商品图
5	名称
6	售价
7	曝光
8	浏览
9	想要
10	自动发货
11	售罄上架
12	2人小刀
13	发布日期
14	更新时间
15	操作列(更多)

操作规则

• 每步操作后截图 → 看截图 → 确认状态 → 再下一步
• switch 点击: 优先 locator.click(force=True)；不行就用 Vue emit
• 每次点击后等 2 秒再检查弹窗
• 表格可以左右滚，操作列在右边（scrollLeft=400）
• 弹窗检测不靠谱，必须截图确认
• 弹窗的确定按钮用文字匹配 button:has-text("确定")

Vue emit 兜底（switch 点不动时用）

python

page.evaluate("() => {
    var tr = document.querySelector('.el-table__body-wrapper tbody tr:first-child');
    var tds = tr.querySelectorAll('td');
    var sw = tds[COL_IDX].querySelector('.el-switch');
    var vm = sw.__vue__;
    vm.value = 1;
    vm.$emit('input', 1);
    vm.$emit('change', 1);
}")

自动发货 + 网盘配置

1. 先截图看看当前状态（已配好就跳过）
2. scrollLeft=9999, force click td[10] .el-switch
3. 截图看弹窗 — 如果没弹窗但 switch 已经亮了，说明之前配好了

要填网盘内容的话，弹窗里 6 步：

1. 粘贴网盘链接 → 截图
2. 展开高级配置 → 截图
3. 勾选"启用发货声明" → 截图
4. 打开自动发货开关 → 截图
5. 点"保存"按钮 → 截图确认弹窗关了
6. 补一刀：弹窗关后检查主开关，没亮就再点一次（易店这 bug 常有）

售罄上架

1. 先截图看状态
2. force click td[11] .el-switch → 截图
3. 有弹窗: 确认勾选 → 截图
4. 没弹窗且 switch 没变: 用 Vue emit 直接切

2人小刀

1. 先截图看状态
2. force click td[12] .el-switch → 截图
3. 有弹窗: 填金额 → 截图 → 点"确认设置"
4. 没弹窗且 switch 没变: 用 Vue emit 直接切

弹窗对照

弹窗	什么意思
addproduct-dialog	网盘配置面板
groupon-dialog	2人小刀填金额
绑定邮箱弹窗	干扰弹窗，直接关掉

最后验证

python

r = page.evaluate('()=>{var t=document.querySelector(".el-table__body-wrapper tbody tr").querySelectorAll("td");return[t[10].innerText,t[11].innerText,t[12].innerText]}')
# 1号店预期: ['开启', '开启', '开启']
# 2号店预期: ['开启', '开启', '关闭']  （2人小刀跳过）

📂 版本历史

版本	日期	更新内容
v3.2 🆕	2026-06-23	稳定性修复 — 修复2人小刀弹窗精确识别（不再混淆其他弹窗）；图库选图增加3次重试机制并确认选中；上传图片增加完整容错流程；所有关键步骤 try/except 包裹防止单步崩溃；2人小刀弹窗增加标题识别+兜底Vue emit方案；自动发货二次点击增加最多3次重试
v3.1	2026-06-22	SkillHub 发布包完善 — 补全 README.md、CHANGELOG.md 等发布必需文件；完整脱敏处理（店铺名/路径/配置参数全部替换为通用占位符）；店铺配置改为 AI 引导模式（首次使用由 AI 逐项询问）；自动化上货体系改为通用引导（目录/时间/频率由用户自定义）；脚本参数保留占位符+注释引导；AI 引导文案通俗化，加入 DSFlash 省流量提示
v3.0	2026-06-21	全自动化上货体系 — 新增 batch_parser.py（总txt解析+按天拆分）、publisher.py（可import调用的发布函数）、auto_publish.py V2（直接调用发布函数，一天多商品排队上架）；新增自动化任务（每周一~六10:00自动运行）；图片目录迁移到 图片资料\；新增 MEMORY.md 完整文档记录
v2.7	2026-06-20	变量配置化 + 自动发货二次点击修复 — 脚本顶部商品配置区（6个变量），上新货只需改配置；上传确定后强制关闭所有弹窗防止遮挡；图库搜索改为模糊匹配 IMAGE_KEYWORD；自动发货保存后检查主开关，没变蓝再点一次
v2.6 🏆	2026-06-20	全流程验证通过 — 图库上传v3.0重写（set_input_files 直接注入→搜索选中）；子进程EOFError修复；高级配置展开/折叠 + 弹窗滚动操作；绑定邮箱弹窗干扰修复；自动发货+售罄上架全链路验证通过
v2.5	2026-06-19	2号店铺全流程 + 自检规则 — 新增2号店铺配置，图库选图改为直接点图+「使用选中图片」，城市级联改为input.click+遍历menu，店铺选择改用JS evaluate，库存区分，新增脚本硬推自检铁律
v2.4	2026-06-19	图片精确匹配 + 弹窗修复 — 图片选择改为文件名精确匹配，弹窗确定按钮改为文字匹配，宝贝描述去重，新增IMAGE_DIR常量，自动发货主开关重试机制
v2.3	2026-06-18	自动发货修复 — 修复自动发货状态开关定位逻辑；完善弹窗内6步操作流程；修复保存按钮选择器
v2.2	2026-06-18	持久化登录 — 放弃CDP改用launch_persistent_context；图片上传改为图库查重；售价/库存改用JS赋值
v2.1	2026-06-18	双脚本对齐 — 对齐SKILL.md流程；修复中文选择器编码；确立6条铁律
v2.0	2026-06-17	首次Python实现 — 初始Playwright脚本，CDP连接浏览器，基础发布+配置功能
v1.0~v1.3	2026-06-12~06-18	SKILL.md 文档阶段，定义自动化流程规范和操作经验

🗑 已废弃功能

• 全局自动发货脚本 — 有bug，已删除
• CDP 连接方式 — 现用 connect_over_cdp 连接已有Edge浏览器
• 图片位置猜测 — 改为文件名精确匹配
• 图库搜索+确定按钮逻辑 — 改为直接点图+「使用选中图片」
• 城市级联索引定位 — 改为遍历所有menu
• filter(has_text)选择店铺 — 中文编码匹配失败，已改用JS evaluate