xiaoyaotsyx-dotcom
xiaoyaotsyx-dotcom/aliexpress-auto-listing-skill
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/xiaoyaotsyx-dotcom/aliexpress-auto-listing-skill --skill aliexpress-store-ops命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | aliexpress-store-ops |
| description | 速卖通店铺运营自动化 — 每日巡检/每周策略/商品上架/数据分析全流程。填入你的店铺名即可使用。 |
| domain | ecommerce |
| version | 1.0.0 |
| modelVersion | 1.0.0 |
| lastUpdated | 2026-07-19 |
| compatibility | Hermes Agent ≥ v1.0 | Claude Code ≥ v2.0 | Codex ≥ v1.0 |
| authors | ["Rigi AI Commons (小红书 @瑞吉AI人民公社)"] |
| license | MIT |
| lifecycle | active |
| triggers | ["用户说\"帮我看看店铺\"、\"分析数据\"、\"上品\"、\"发新品\"、\"做策略\"","用户需要定时查看店铺运营状态","用户需要数据驱动的产品营销策略","用户说\"帮我在店小秘上架\"、\"采集1688\"、\"参考产品上架\"","用户打开1688页面和店小秘编辑页，需要帮忙填写产品信息","用户说\"先学习这个再填那个\"、\"照这个产品填\"（参考产品法）","用户打开多个浏览器标签页需要Agent在标签页间操作学习"] |
这是最高优先级规则，违反会导致数据全丢，必须重新操作。
进入编辑页（smt/edit?id=...）后，在全部操作完成（保存并移入待发布）之前：
browser_navigate 刷新页面page.goto() 重载编辑页唯一允许刷新的场景： 页面死机/卡住/完全无法操作。
正确的数据查看方式： 用 page.evaluate() 在页面内读取 DOM 值，不要刷新页面。
正确的数据保存方式： 全部填完后一次性点「保存并移入待发布」。不要依赖「保存」按钮存草稿。
如果必须查其他页面的数据（如 1688 参数）：
ctx.new_page() 或浏览器新标签）Windows Chrome (--remote-debugging-port=9222)
↕ Relay2.exe (0.0.0.0:9255 → 127.0.0.1:9222)
↕ 开机 VBS 自启 (Startup/hermes-chrome-relay.vbs)
Windows IP (172.24.48.x:9255)
↕ WSL chrome_relay.py (localhost:19223 → GW:9255)
详见 references/cdp-recovery.md
致命错误： gateway重启/断连后，直接调用 browser_navigate 会创建新标签页，而不是连回已有的填好数据的标签页。这会导致之前所有未保存的填写工作"消失"（实际在另一个标签页中）。
正确恢复步骤：
1. browser_cdp → Target.getTargets # 列出所有标签页
2. 从返回的 targetInfos 中找到店小秘编辑页（title="店小秘--编辑速卖通产品"）
3. 对每个编辑页 target: Runtime.evaluate 读取页面状态（标题、hash、bodyText片段）
4. 确认哪个标签页有已填数据（英文标题、已选属性值等）
5. 关闭空白/重复标签页: Target.closeTarget
6. 激活正确的标签页: Target.activateTarget
7. 此时 browser_snapshot 应该显示已填数据
禁止操作：
dxm-basic-info | ✅ | 07-19 |\n| 2. 店小秘信息 | 只读，跳过 | — | — |\n| 3. 属性信息 | dxm-attributes | ✅ | 07-19 |\n| 4. 产品图片 | dxm-product-images | ✅ | 07-19 |\n| 5. SKU定价 | dxm-sku-pricing | ✅ | 07-19 |\n| 6. PC端描述 | | ✅ | 07-19 |\n| 7. 包装 | | ✅ | 07-19 |\n| 8. 模板 | | ✅ | 07-19 |\n| 9. 其他信息 | | ✅ | 07-19 |\n| 总调度 | | ✅ 完整 | 07-19 |\n\n> 产品"折叠喝水神器"从 Step 0 到 Step 9 全部走通。所有星号必填项已填。剩余已知问题：3个非星号下拉（电源/电压/动力）对所有automation免疫 → 跳过不纠缠（已记录 pitfall #14）。"\n\n## 上架流水线 — 分步操作流程dxm-pc-descriptiondxm-packagingdxm-templatesdxm-other-infodxm-listing-workflowStep 0 → 进入采集箱
Step 1 → 点「编辑」进编辑页
Step 2 → 标题改为英文
Step 3 → 选分类（弹窗树）
Step 4 → 开1688查参数（新标签页）
Step 5 → 填产品属性（红色星号必填）
Step 6 → 删除自定义属性
Step 7 → 产品图片选图
Step 7.5 → 批量改尺寸800×800
Step 7.6 → 图片翻译中文→英文
Step 7.7 → 营销图片一键生成
Step 7.8 → 颜色SKU：改英文名+图改尺寸+图翻译
Step 8 → SKU定价栏
Step 8.5 → PC端描述（引用模板 + 批量改图片尺寸）
Step 9 → 保存并移入待发布
详细操作指南（含代码片段、坐标、验证方法、已知坑点）全部放入以下参考文件：
| 文件 | 内容 | 来源步骤 |
|---|---|---|
references/cdp-recovery.md | CDP 中继重启/故障恢复 | 架构 |
references/sku-table-fields.md | SKU表HTML结构、select索引、颜色配置、字段映射 | Step 8 |
references/sku-variant-config.md | VXE Table 结构、批量行vs单行、颜色配置 | Step 8 |
references/step-by-step-mode.md | 步进模式、三击全选、交互规则 | 通用 |
references/batch-listing-workflow.md | 30品/天上架流水线作业手册 | 通用 |
references/publishing-checklist.md | 发布前检查清单 | Step 9 |
references/pc-description-template.md | PC端描述所有操作：引用模板 + 批量改图片尺寸 + 图片翻译 | Step 8.5 |
scripts/detect-chinese-text.py | OCR检测图片中是否含中文文案，配合图片翻译使用 | Step 8.5 |
references/attribute-fill-cdp.md | 属性批量填写：CDP坐标两步法 + 狗携带用品属性值速查 | Step 5 |
references/playwright-coordinate-click.md | Playwright mouse.click(x,y) 坐标法填 ant-select（比CDP更可靠触发Vue3） | Step 5 |
references/1688-json-extraction.md | 1688嵌入JSON正则提取法 | Step 4 |
references/cdp-direct-operation.md | browser_cdp 直连模式：弹窗拦截绕过 + 鼠标事件 + 截图 | 通用 |
references/sku-code-patterns.md | SKU配置代码模式速查 | Step 8 |
https://www.dianxiaomi.com/web/smt/edit?id={product_id}nativeInputValueSetter 操作ctx.new_page() 在新标签页打开 1688 URLreferences/1688-json-extraction.md⚠️ 2026-07-19 方法更新：JS强制显示dropdown+点击（替代CDP坐标法）
详见 dxm-attributes skill（以该skill为准，它是属性的权威模块）。
核心方法：
// 找含目标选项的dropdown → 强制显示 → 点击
dd.classList.remove('ant-select-dropdown-hidden');
dd.style.display = ''; dd.style.opacity = '1'; dd.style.pointerEvents = 'auto';
item.click(); item.dispatchEvent(new MouseEvent('mousedown', {bubbles: true}));
检测带星号字段： 使用 span.attr-label.required（不是 .ant-form-item-required）。
🚨 auto-complete 型字段填充方法（2026-07-19 攻克）： ant-select-auto-complete 型字段（如最大出餐量、材质）可用 Playwright keyboard.type() + 点空白处blur（不提Enter） 填充。详见 dxm-attributes skill pitfall #9。值存储在 input.value 而非 .ant-select-selection-item，验证时需分别检查。
验证规则： 只有所有带星号字段都填完才算通过。7/9 ≠ 完成，8/9 ≠ 完成。必须9/9。验证时注意 ant-select-auto-complete 型字段值在 input.value 中（不在 .ant-select-selection-item），需分别检查。
详见 references/sku-table-fields.md 图片处理章节
术语定义： SKU定价栏 = 零售价 + 货值 + 库存 + 长/宽/高 + 包装尺寸 + 是否原箱 + 物流属性 + 商品编码
字段规则：
| 字段 | 规则 |
|---|---|
| 零售价(CNY) | = 货值。不等于1688成本价！ 按定价公式计算 |
| 货值(CNY) | = 零售价（两列填同一个数） |
| 库存 | 1688库存>2000封顶写2000，≤2000如实写 |
| 重量(kg) | 从1688提取 |
| 包装尺寸(cm) | 有数据则填，无跳过 |
| 是否原箱 | 原生select，设为「是」(value=1) |
| 物流属性 | 无电→普货；有电→内电 |
| 商品编码 | 一键生成，1688有货号填前缀 |
定价公式：
零售价 = 货值 = (1688成本价 + 国内运费¥5) × 1.02 ÷ [0.70 × (1 - 21% - 净利率)]
= (成本 + 5) × 1.02 ÷ 0.413 （净利率20%时）
操作序列：
select_option('1') 设为「是」详见 references/pc-description-template.md
cke_combo）点击后打开空面板——不要点这个！ 真正的按钮在展开图片栏后的 images-options 区域（类 ant-dropdown-trigger）.cke_button__imagepaneltoggle）使其可见。CKEditor 按钮用 element.dispatchEvent(new MouseEvent('mousedown',{bubbles:true})) + .dispatchEvent(new MouseEvent('mouseup',{...})) + .dispatchEvent(new MouseEvent('click',{...})) 触发.images-options 按钮滚到视口 y≈400-700 的位置（window.scrollBy(0, r.top - 400)）Input.dispatchMouseEvent(mousePressed → mouseReleased) 在按钮坐标上触发——JS .click() 对 antd 无效.ant-dropdown-menu-item textContent 匹配Input.dispatchMouseEvent 点击 .ant-select-selector 坐标，然后在打开的 .ant-select-dropdown 中点 .ant-select-item（textContent === '自定义比例调整'）——默认是等比例，不切换则没有完整宽高输入input[name=valueW] 填 800（用 nativeValueSetter + dispatchEvent）.ant-checkbox-wrapper 中 textContent 包含「选择全部」的 labelreferences/pc-description-template.md「PC端描述—图片翻译操作流程」top: 5136-5612px），当页面滚动到下方时菜单渲染在视口外。解决方案： 点按钮前先 scroll 使按钮在视口 y≈400-700（预留下拉空间），然后 mousePressed+mouseReleased 点击。验证：dropdown 的 display!=='none' 但 getBoundingClientRect 全零 → 还在视口外 → 重新 scroll 并重试所有字段填写完成后，点击页面顶部右侧的「保存并移入待发布」按钮。
两种入口路径：
详见 references/step-by-step-mode.md
用户2026-07-18明确纠正：「为什么你突然去看谷歌趋势了？我们的上架流程还没有操作完。你错乱了，需要先完成上架工作流」
规则：
用户2026-07-18明确纠正：「我不想再看到你问我任何问题。因为你总结的skill里面已经全部都有了。」
规则：
用户2026-07-18明确纠正：「我确定我没有说过让你去做另外一件事情。你以后不许跟我撒谎，因为我会查看我们的聊天记录。」
发现： 代理任务（delegate_task）调用 browser_navigate 或 browser.new_page() 时，会在用户 Chrome 的同一个 CDP 上下文中创建新页面。如果 CDP 浏览器原本只有 2-3 个标签页（1688 + 店小秘编辑页），新页面可能覆盖编辑页标签，导致编辑页丢失，全部未保存数据丢失。
规避规则：
delegate_task 执行任何涉及浏览器操作的任务delegate_task 时，确保任务只使用 web_search / terminal / curl，不碰浏览器web_search + curl 或 execute_code 而非 delegate_task场景： 编辑页因意外关闭/标签页被覆盖/delegate_task干扰导致丢失，所有未保存数据可能丢失。
恢复步骤：
Target.getTargets 找 title="店小秘--编辑速卖通产品" 的 target）Runtime.evaluate 评估页面状态，可能页面还在只是 Playwright 连接断开https://www.dianxiaomi.com/web/smt/smtProductList/drafthttps://www.dianxiaomi.com/web/smtChoice/draft<a>编辑</a>）smt/edit?id={product_id}）div.anchor-menu-item（不是 .ant-tabs-tab），点击文本匹配的锚菜单项跳转page.evaluate 读取各输入框的值判断哪些字段需要重填⚠️ 重要： 编辑页关闭后会丢失的数据：
用户铁律：「你自己想办法」= 自己搞定。能填的全填上，最后汇报时可以说「这些字段CDP搞不定，你手动点一下」但不能问「你要不要自己操作」
同一操作3次不成功 → 立即停手汇报。不要换第4、第5种方法继续试。
涉及新工作流时：先做流程图 → 用户审核 → 确认后再执行。
核心问题： Playwright 通过 CDP 操作店小秘时，DOM 修改可能不被 Vue 3 的响应式系统捕获，导致用户页面看不到变化——即使代码执行成功。
用户明确要求：「你以后都要显示出来，不然的话我不知道你进行到哪一步了」
用户明确要求：「你要按照我的步骤来，不可以猜」——每步做完汇报，等用户指示下一步。不要一次性操作多步。
解决方式（按优先级）：
🥇 最高优先级： 每次操作后必须让用户看到页面变化。不要在后台默默执行多步操作。用户说看不到立即停手，换真实交互方式重做，而不是换 JS 方式继续试。
🥈 CDP Input.dispatchMouseEvent（antd 组件首选）： 对 ant-design 组件（.ant-dropdown-trigger, .ant-select-selector 等），JS programmatic .click() 无效。必须在浏览器_cdp 工具中用 Input.dispatchMouseEvent(type='mousePressed', x, y) + Input.dispatchMouseEvent(type='mouseReleased', x, y) 在按钮实际坐标上触发真实鼠标事件。
window.scrollBy(0, r.top - 400) 将按钮定位到视口上部🥉 Playwright page.mouse.click() + page.keyboard.type()： 用真实鼠标点击 + 键盘输入代替 JS setter/dispatchEvent。page.mouse.click() + page.keyboard.type() 能触发最完整的浏览器事件链。
❌ 避免的写法（已被证明对 Vue 3 + antd 无效）：
element.click() (JS programmatic)Runtime.evaluate 里的 .dispatchEvent(new Event(...))nativeInputValueSetter + dispatchEvent('input')DOM.setFileInputFiles（Vue 重渲染清除文件）验证方法： 每次 click 后检查弹出的 ant-dropdown/ant-select-dropdown 的 getBoundingClientRect()。如果 display 为 block 但 rect 为空数组（全零），说明 dropdown 被渲染到视口外——scroll 重试。
零售价 = 货值 = (1688成本价 + 国内运费¥5) × 1.02 ÷ [0.70 × (1 - 21% - 净利率)]
| 产品类型 | 物流属性 |
|---|---|
| 无电（硅胶碗、普通日用品） | 普货 |
| USB充电（风扇、净化器） | 内电→非纽扣锂离子电池 |
| 纽扣电池（LED灯） | 内电→纽扣式锂电池 |
| 干电池（遥控器） | 内电→干电池 |
| 充电宝/电池盒 | 内电→非纽扣锂离子电池 |
btn.innerText.trim() === '确 定' 匹配，不要 trim 后等于 '确定'（匹配失败）<select>，不用 ant-select，JS 改 value 可能不被 Vue 捕获 → 用 Playwright select_option().ant-checkbox-wrapper 精确匹配cke_combo（CKEditor原生combo，打开空面板）和 images-options 内的 ant-dropdown-trigger（真正的菜单）。必须在展开图片栏后，点击 images-options 区的按钮。误点cke_combo则用Esc关闭空面板style: top: 5612px 绝对定位，可能落在视口外。正确做法： 用 getBoundingClientRect() 找到按钮坐标，window.scrollBy(0, r.top - 400) 将按钮移到视口中部（y≈400-700），然后用 Input.dispatchMouseEvent(type='mousePressed', x, y) + (type='mouseReleased', x, y) 在按钮坐标处触发真实鼠标事件。验证：dropdown display!=='none' 但 rect 全零 → 仍在视口外 → 重新scroll。ant-select-selector（弹窗内下拉）同理需要坐标级 mousePressed+mouseReleased。page.evaluate() 改DOM或JS dispatchEvent可能不被Vue捕获。必须用真实鼠标交互。已验证有效的CDP click序列： ①获取按钮 getBoundingClientRect 坐标 ②window.scrollBy(0, r.top - 400) 将按钮移到视口中部 ③Input.dispatchMouseEvent(type='mousePressed', x, y) ④Input.dispatchMouseEvent(type='mouseReleased', x, y)。此方法对 ant-dropdown-trigger（images-options）和 ant-select-selector（弹窗内下拉）均有效。做完一步必须让用户确认看到变化再继续下一步。不许猜下一步，用户说一步你做一步。Input.dispatchKeyEvent(type='keyDown', key='Escape') + (type='keyUp', key='Escape') 在select操作之间清场。缺少这一步会导致后续所有select都打在上一个下拉的遮罩上。.ant-btn-primary，文本「一键翻译」）。错误操作： 点了「快速翻译」checkbox 然后等翻译 → 没用，因为这只是个模式开关。正确操作： 确认「快速翻译」已勾选（不用动它），然后点**「一键翻译」**按钮。Input.dispatchMouseEvent 坐标点击 ✅ 能打开 dropdown ❌ 选中后值不持久化；Playwright mouse.click() 同上；Playwright locator.click() 同上；keyboard ArrowDown+Enter 同上；JS element.click() 同上。疑似 Vue 3 select 组件的内部状态不响应外部事件。策略：优先填星号字段，非星号字段跳过不纠缠。超过3次尝试不成功立即停手，汇报给用户手动选。browser_snapshot 截断在约1500行，无法覆盖编辑页下半部分（SKU表、描述、包装、模板等）。替代方案： 用 execute_code + Python websockets 库直连 ws://127.0.0.1:19223/devtools/page/{targetId}，发送 Runtime.evaluate CDP命令执行 JS 表达式扫描页面全部数据（document.querySelectorAll、document.body.innerText 等），返回结构化 JSON。此法可一次性扫描所有带星号字段、请选择数量、body文本长度等，不受视口截断限制。详见 references/cdp-websocket-qa-scan.md。ant-modal-wrap notice-list-modal），会拦截所有 Playwright locator.click() 操作（元素可见但 pointer events 被弹窗拦截，30秒超时）。但 JS evaluate 操作不受影响。解决方案： 每次开始编辑前，先执行 JS 强制清除所有弹窗：document.querySelectorAll('.ant-modal-wrap, .notice-list-modal, .bullet-layer').forEach(m => m.remove())。如果清除不彻底（弹窗按钮的click不触发Vue），关掉后再用 locator.click({force: true})。selector.dispatchEvent(new MouseEvent('mousedown', {bubbles: true})); selector.dispatchEvent(new MouseEvent('mouseup', {bubbles: true})); selector.click() 打开 dropdown，然后 item.click() 选选项。但此方法在共享下拉池场景下不可靠（可能点到错误的dropdown）。如遇连续失败，不要死磕属性字段，先填其他模块，最后汇报给用户手动修正。Auto-launch failed: CDP WebSocket connect failed: HTTP error: 404 Not Found 时，browser.engine: cdp 也无法解决。回退到纯 browser_cdp 工具操作（Target.getTargets, Page.navigate, Runtime.evaluate, Target.createTarget, Page.captureScreenshot 等）。完整操作指南见 references/cdp-direct-operation.md。Input.dispatchMouseEvent、Playwright mouse.click()、JS element.click()、dispatchEvent、keyboard Enter 等任何已知方法。疑似Vue 3 + ant-modal-wrap双重拦截。「保存」按钮可用（Playwright mouse.click有效）。流程改为：自动化填完所有字段 → 点「保存」→ 通知用户手动点「保存并移入待发布」。connect_over_cdp('http://127.0.0.1:19223') 连接Chrome的CDP端点后，browser.contexts[0].pages 返回所有打开的标签页。不需要通过Target.getTargets + activateTarget来切换——直接用 for pg in browser.contexts[0].pages 找到目标页并操作。但每个page对象已绑定固定target，操作前务必确认 pg.url 匹配。Auto-launch failed: CDP WebSocket connect failed: HTTP error: 404 Not Found 时，browser.engine: cdp 也无法解决。回退到纯 browser_cdp 工具操作（Target.getTargets, Page.navigate, Runtime.evaluate, Target.createTarget, Page.captureScreenshot 等）。完整操作指南见 references/cdp-direct-operation.md。作者: Rigi AI Commons | 小红书 @瑞吉AI人民公社 | AI自动化专家工作流