Productividad · SKILL.md

han-jr-system

han-jr-system

小翰系统：1688平台自动化供应商联系系统。使用场景：用户需要联系1688供应商、发送询价消息、收集报价时。触发于如联系1688铅笔供应商、搜索dgx spark供应商等任务。严格遵守逐家联系、验证优先、准确性优先原则。

Independent GitHub snapshot · Automated classification · Original documentation governs

Lleoyeai / openclaw-master-skillsMIT

Documentación de la Skill

GitHub

name: han-jr-system version: 1.0.0 description: 小翰系统：1688平台自动化供应商联系系统。使用场景：用户需要联系1688供应商、发送询价消息、收集报价时。触发于如联系1688铅笔供应商、搜索dgx spark供应商等任务。严格遵守逐家联系、验证优先、准确性优先原则。

Han Jr System - 1688 供应商联系系统

Overview

小翰系统提供完整的1688供应商联系自动化工作流，强调：

逐家联系：一次只联系一家供应商，等待回复后再联系下一家
严格验证：每个步骤后10秒First Check，失败则20秒Double Check
准确性优先：宁可慢，不要错，所有操作必须验证后才报告成功
真实执行：使用实际脚本（playwright + Chrome CDP），非模拟

⚠️ 重要：反爬虫解决办法

问题现象

当搜索频繁或触发安全机制时，页面会跳转到包含 _____tmd_____ 的URL，并显示滑块验证码。

解决方法

使用 slider_captcha.py 脚本自动解决滑块验证码：

python slider_captcha.py --selector "#nc_1_n1z" --distance 260 --duration 1.5

参数说明：

--selector: 滑块元素的CSS选择器（默认: #nc_1_n1z）
--distance: 拖动距离（像素，默认: 260）
--duration: 拖动持续时间（秒，默认: 1.5）

滑块元素常见选择器：

#nc_1_n1z
.nc_iconfont.btn_slide
span[aria-label="滑块"]
[data-spm-anchor-id*="slide"]

工作流程（含反爬虫处理）

# 1. 启动Chrome
python chrome_launch.py

# 2. 搜索供应商
python search_box_v2.py --keyword "铅笔" --num 5 --output suppliers.json

# 3. 如果遇到滑块验证码，自动解决
python slider_captcha.py --selector "#nc_1_n1z" --distance 260

# 4. 继续搜索或联系供应商
python search_box_v2.py --keyword "钢笔" --num 5 --output suppliers2.json

注意事项

真正的反爬虫标志：页面上出现 "Sorry, we have detected unusual traffic from your network."
URL包含 _____tmd_____ 不一定是反爬虫，可能是其他错误
解决验证码后，页面会恢复正常，可以继续操作
建议搜索间隔：每个关键词之间等待 3-5 秒，避免频繁触发

依赖安装

首次使用前安装依赖：

pip install playwright requests beautifulsoup4 easyocr pillow numpy
playwright install chromium

Workflow

Step 1: 启动Chrome

python chrome_launch.py

启动Chrome with remote debugging (port 9222)
10秒First Check：验证CDP连接
失败则20秒Double Check

Step 2: 搜索供应商（搜索框输入方式）

python search_box_v2.py --keyword "铅笔" --num 5 --output suppliers.json

必须通过搜索框输入关键词，不要通过URL参数搜索
在1688真实搜索（非百度）
提取供应商名称、链接、价格、地区
10秒First Check：验证结果包含关键词
保存到JSON文件（UTF-8编码，避免乱码）

重要： 搜索框输入方式更稳定，不易触发反爬虫机制

Step 3: 处理反爬虫/滑块验证码

python slider_captcha.py --selector "#nc_1_n1z" --distance 260

当页面出现滑块验证码时执行
模拟人类拖动行为（带随机抖动和缓动函数）
验证成功后继续操作

Step 4: 联系供应商（逐家）

python 1688_send_message.py --offer <供应商链接> "需要铅笔，请报价"

打开供应商页面
点击"客服"按钮
发送询价消息
10秒First Check：截图验证消息已发送

Step 5: 验证步骤

python verify_step.py --step "step_name" --text "期望文本" --double

截图当前页面
OCR识别内容
检查是否包含期望文本
失败时自动Double Check

Step 6: 完整工作流

python pencil_workflow.py

执行完整流程（启动→搜索→联系→验证）
自动处理所有步骤
记录到文件

脚本说明

scripts/

脚本	功能	用法
`chrome_launch.py`	启动Chrome并验证	`python chrome_launch.py`
`search_box_v2.py`	1688搜索（搜索框输入）	`python search_box_v2.py --keyword "铅笔" --num 5`
`slider_captcha.py`	解决滑块验证码	`python slider_captcha.py --selector "#nc_1_n1z"`
`batch_contact_final.py`	批量联系供应商（推荐）	`python batch_contact_final.py --keyword "棒球帽" --message "询价" --num 20`
`wangwang_chat_manager.py`	旺旺聊天管理器	`python wangwang_chat_manager.py --list`
`search_contact_fixed.py`	搜索旺旺联系人（重要）	`python search_contact_fixed.py --name "供应商"`
`supplier_manager.py`	供应商管理系统	`python supplier_manager.py list`
`1688_send_message.py`	发送询价消息	`python 1688_send_message.py --offer "链接" "消息"`
`verify_step.py`	截图OCR验证	`python verify_step.py --step "name" --text "期望"`
`batch_search.py`	批量搜索多个关键词	`python batch_search.py`
`pencil_workflow.py`	完整工作流	`python pencil_workflow.py`

references/

soul_rules.md - SOUL.md核心规则摘要
popup_handling.md - 1688弹窗处理指南
inquiry_template.md - 询价消息模板
antibot_handling.md - 反爬虫处理指南（重要）

关键规则

逐家联系：一次只联系一家，等待回复后再下一家
硬性验证：每个步骤后必须10秒First Check，失败则20秒Double Check
验证后才报告：绝不报告"应该成功了"，只报告"已验证成功"
准确性>速度：宁可慢，不要错
Chrome启动：必须使用指定命令，失败告知用户
搜索方式：必须通过搜索框输入，不要通过URL参数搜索
编码：所有输出和文件必须使用UTF-8编码，避免乱码
反爬虫处理：遇到滑块验证码使用 slider_captcha.py 解决
聊天页面管理：每次只能有一个旺旺聊天页面打开，发送完消息后必须关闭，再回到搜索结果页联系下一家

🔍 旺旺图标定位规则（重要）

搜索结果页旺旺图标

在搜索结果页，每张产品卡片右下角有旺旺图标：

HTML特征：

<span class="J_WangWang ww-light ww-static" data-nick="供应商名称">
  <a href="https://air.1688.com/app/ocms-fusion-components-1688/def_cbu_web_im/..." 
     target="_blank" class="ww-link ww-inline ww-online">
    <span>旺旺在线</span>
  </a>
</span>

选择器优先级（按可靠性排序）：

.J_WangWang - 主要class名
.ww-light 或 .ww-link - 旺旺链接
a[href*="air.1688.com"][href*="im"] - 聊天页面链接
a:has-text("旺旺在线") - 包含"旺旺在线"文本
[data-spm-anchor-id*="offerlist"] - 商品列表中的旺旺

使用方法：

# 从搜索结果页直接联系供应商
python search_and_contact.py --keyword "棒球帽" --message "询价内容" --num 10

店铺页旺旺图标

在供应商店铺页，旺旺图标通常在：

页面顶部/侧边栏
产品详情页右下角
特征：img[src*="O1CN01is8OHl"] 或 img[src*="wangwang"]

使用方法：

# 进入店铺页联系
python contact_supplier_wangwang.py --link "店铺链接" --message "询价内容"

📋 旺旺聊天页面 iframe 处理方法（重要）

问题

旺旺聊天页面使用 iframe 架构，消息输入框不在主页面，而是在特定的 frame 中。

解决方案

Frame 结构

旺旺聊天页面通常包含 4 个 frames：

Frame 0: 主聊天框架（联系人列表）
Frame 1: 消息输入区域 ← 在这里发送消息
Frame 2: 分析/统计
Frame 3: 空白

正确的发送消息代码

# 遍历所有 frames 找到输入框
for frame in chat_page.frames:
    try:
        # 在 frame 中查找输入框
        inp = frame.locator("pre[contenteditable='true']").first
        if inp.is_visible():
            inp.click()
            inp.fill(message)
            
            # 点击发送按钮
            btn = frame.locator("button:has-text('发送')").first
            if btn.is_visible():
                btn.click()
                print("✓ 消息已发送")
                break
    except:
        continue

关键要点

✅ 使用 page.frames 遍历所有 frames
✅ 消息输入框通常在 Frame 1
✅ 使用 frame.locator() 在特定 frame 中查找元素
✅ 不需要点击联系人，直接发送消息即可

完整示例

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")
    
    # 打开聊天页面
    chat_page = browser.contexts[0].new_page()
    chat_page.goto("旺旺链接", wait_until="domcontentloaded")
    time.sleep(4)
    
    # 发送消息
    message = "我要定制..."
    for frame in chat_page.frames:
        try:
            inp = frame.locator("pre[contenteditable='true']").first
            if inp.is_visible():
                inp.click()
                inp.fill(message)
                btn = frame.locator("button:has-text('发送')").first
                btn.click()
                print("✓ 消息已发送")
                break
        except:
            continue
    
    chat_page.close()
    browser.close()

注意事项

聊天页面加载需要 4-5 秒等待时间
发送完消息后等待 1-2 秒再关闭页面
每次只打开一个聊天页面，发送完必须关闭

示例：完整工作流程（含反爬虫处理）

场景1：批量联系供应商

# 1. 启动Chrome
python chrome_launch.py

# 2. 批量联系供应商（推荐）
python batch_contact_final.py --keyword "棒球帽" --message "我要定制1000顶，多少钱？" --num 20

# 3. 查看旺旺聊天页面列表
python wangwang_chat_manager.py --list

# 4. 打开第一个旺旺聊天页查看回复
python wangwang_chat_manager.py --open 0 --history

# 5. 回复消息
python wangwang_chat_manager.py --reply "好的，请发样品"

场景2：传统流程

# 1. 启动Chrome
python chrome_launch.py

# 2. 搜索第一个关键词
python search_box_v2.py --keyword "帽子" --num 5 --output hat_suppliers.json

# 3. 如果遇到滑块验证码，解决它
# （页面URL包含 _____tmd_____ 且显示滑块）
python slider_captcha.py --selector "#nc_1_n1z" --distance 260

# 4. 继续搜索其他关键词
python search_box_v2.py --keyword "外套" --num 5 --output coat_suppliers.json

# 5. 查看结果
cat hat_suppliers.json
cat coat_suppliers.json

# 6. 联系第一家供应商
python 1688_send_message.py --offer "https://detail.1688.com/offer/xxx.html" "需要帽子，请报价"

# 7. 验证发送成功
python verify_step.py --step "message_sent" --text "报价" --double

🆕 新功能1：旺旺聊天管理器

功能说明

wangwang_chat_manager.py 是一个全新的工具，用于管理旺旺聊天页面：

列出所有旺旺聊天页 - 查看当前打开的所有旺旺聊天页面
打开指定聊天页 - 切换到指定的旺旺聊天页面
搜索联系人 - 在联系人列表中搜索特定供应商
查看聊天记录 - 获取并显示聊天记录
回复消息 - 在指定聊天页面发送回复
打开最后访问的页面 - 快速回到上次访问的旺旺页

使用方法

# 列出所有旺旺聊天页
python wangwang_chat_manager.py --list

# 打开第1个旺旺聊天页
python wangwang_chat_manager.py --open 0

# 搜索联系人
python wangwang_chat_manager.py --open 0 --search "供应商名称"

# 查看聊天记录
python wangwang_chat_manager.py --open 0 --history

# 回复消息
python wangwang_chat_manager.py --open 0 --reply "好的，请报价"

# 打开最后访问的旺旺页
python wangwang_chat_manager.py --last

# 打开最后访问的页并回复
python wangwang_chat_manager.py --last --reply "收到"

工作流程示例

# 1. 先联系一批供应商
python batch_contact_final.py --keyword "帽子" --message "询价" --num 10

# 2. 等待一段时间后，查看有哪些供应商回复了
python wangwang_chat_manager.py --list

# 3. 打开第一个聊天页查看回复
python wangwang_chat_manager.py --open 0 --history

# 4. 如果有回复，继续沟通
python wangwang_chat_manager.py --reply "请问最低价格是多少？"

# 5. 查看其他供应商的回复
python wangwang_chat_manager.py --open 1 --history

🆕 新功能2：搜索旺旺联系人（重要）

功能说明

search_contact_fixed.py 用于搜索特定供应商并获取最新对话记录：

在搜索框输入供应商名称
按 Enter 触发搜索
点击第一个联系人
等待聊天内容加载（5秒）
获取完整对话记录
同步到本地数据库

重要步骤（已验证）

# 搜索供应商并获取最新对话
python search_contact_fixed.py --name "东莞宝瑞森"

关键要点：

搜索框选择器：input.ant-input (placeholder="搜索联系人")
输入后按 Enter 触发搜索
等待 4秒让搜索结果加载
点击联系人后等待 5秒让聊天内容加载
使用 bring_to_front() 确保页面激活
截图验证每一步

工作流程

# 1. 搜索并获取供应商最新回复
python search_contact_fixed.py --name "供应商名称"

# 2. 查看生成的截图验证
# step2_search_results.png - 搜索结果
# step4_chat_loaded.png - 聊天内容

# 3. 查看数据库中的记录
python supplier_manager.py get --id 27

🆕 新功能3：供应商管理系统

功能说明

supplier_manager.py 是一个本地供应商管理系统，可以：

记录供应商信息 - 名称、产品、价格、链接、联系方式等
管理沟通历史 - 记录所有发出的消息和收到的回复
标记供应商状态 - 待联系、已联系、已回复、已成交等
搜索和筛选 - 按状态、产品类型筛选供应商
导入导出 - 从搜索结果导入，导出供应商列表

数据文件

所有数据保存在 suppliers_database.json 文件中

使用方法

# 从搜索结果导入供应商
python supplier_manager.py import

# 列出所有供应商
python supplier_manager.py list

# 列出已回复的供应商
python supplier_manager.py list --status 已回复

# 查看供应商详情
python supplier_manager.py get --id 1

# 添加沟通记录（发出消息）
python supplier_manager.py communicate --id 1 --message "询价内容" --direction out

# 添加沟通记录（收到回复）
python supplier_manager.py communicate --id 1 --message "供应商回复内容" --direction in

# 更新供应商状态
python supplier_manager.py update --id 1 --status 已回复

# 显示统计信息
python supplier_manager.py stats

# 导出供应商列表
python supplier_manager.py export --file my_suppliers.json

工作流程示例

# 1. 搜索并联系供应商
python batch_contact_final.py --keyword "棒球帽" --message "询价" --num 20

# 2. 导入到供应商管理系统
python supplier_manager.py import

# 3. 查看所有供应商
python supplier_manager.py list

# 4. 记录沟通历史
python supplier_manager.py communicate --id 1 --message "已发送询价" --direction out

# 5. 收到回复后更新
python supplier_manager.py communicate --id 1 --message "价格5元，可以接单" --direction in
python supplier_manager.py update --id 1 --status 已回复

# 6. 查看详情
python supplier_manager.py get --id 1

# 7. 查看统计
python supplier_manager.py stats

故障排除

问题	解决
Chrome启动失败	检查路径是否正确，是否有其他Chrome占用9222端口
搜索无结果	检查网络连接，1688是否可访问
消息发送失败	检查Chrome是否已登录1688
OCR识别失败	安装easyocr: `pip install easyocr`
滑块验证码	使用 `slider_captcha.py` 脚本解决
页面乱码	确保使用UTF-8编码输出和保存文件
搜索被拦截	使用搜索框输入方式，避免URL参数搜索

注意：所有脚本使用真实浏览器操作，非模拟。执行前确保已安装依赖。

重要提醒：

搜索必须通过搜索框输入
输出必须使用UTF-8编码
遇到滑块验证码使用 slider_captcha.py 解决
真正的反爬虫页面会显示 "Sorry, we have detected unusual traffic from your network."

MAKE IT PART OF YOUR WORKFLOW

Instalar Skill

TERMINAL

npx skills add leoyeai/openclaw-master-skills --skill han-jr-system

Ejecuta el comando en tu terminal. Revisa el código y la licencia antes de instalar.

ZIP · Complete skill directory with resources and licenses

SKILL.md · Instructions file only

Estrellas del repositorio: Not synced
Licencia: MIT
Versión / rama: HEAD · 58c6fe9c
Repositorio actualizado: Not synced

Revisa los scripts y los permisos antes de instalar.

Código fuente

han-jr-system

Documentación de la Skill

Han Jr System - 1688 供应商联系系统

Overview

⚠️ 重要：反爬虫解决办法

问题现象

解决方法

工作流程（含反爬虫处理）

注意事项

依赖安装

Workflow

Step 1: 启动Chrome

Step 2: 搜索供应商（搜索框输入方式）

Step 3: 处理反爬虫/滑块验证码

Step 4: 联系供应商（逐家）

Step 5: 验证步骤

Step 6: 完整工作流

脚本说明

scripts/

references/

关键规则

🔍 旺旺图标定位规则（重要）

搜索结果页旺旺图标

店铺页旺旺图标

📋 旺旺聊天页面 iframe 处理方法（重要）

问题

解决方案

Frame 结构

正确的发送消息代码

关键要点

完整示例

注意事项

示例：完整工作流程（含反爬虫处理）

场景1：批量联系供应商

场景2：传统流程

🆕 新功能1：旺旺聊天管理器

功能说明

使用方法

工作流程示例

🆕 新功能2：搜索旺旺联系人（重要）

功能说明

重要步骤（已验证）

工作流程

🆕 新功能3：供应商管理系统

功能说明

数据文件

使用方法

工作流程示例

故障排除

More skills to explore

executing-plans

huashu-nuwa

cangjie-skill