首页 / 使用文档

ShopCrew 快速上手与操作指南

欢迎使用 ShopCrew (Project Zenith)。本指南将指导您从零完成客户端环境准备、店铺接入、自动化发品与素材审计的全流程配置。

1. 新手快速上手 (3分钟流程)

遵循以下标准操作链路,即可快速启动自动化流程:

  1. 下载与解压/安装:根据您的操作系统下载对应的客户端安装包。
  2. 登录店铺中台:启动 ShopCrew 后,在“店铺管理”中点击“添加店铺”,通过内置安全浏览器完成首次扫码登录。
  3. 导入商品素材:将待发布的商品文件夹拖入工作台,系统将自动进行合规性审计与类目匹配。
  4. 一键批量发布:核对规格价格无误后,点击“启动队列”,后台自动进行拟人化回填。
💡
建议提示: 首次使用前,建议先在单个店铺中发布 1~2 款测试商品,熟悉规格回填与尺码表匹配逻辑后,再开启批量队列。

2. Windows 系统安装说明

支持环境:Windows 10 / Windows 11 (64位操作系统)。

  • 下载 ShopCrew-Setup.exe 安装包。
  • 双击运行安装向导,选择安装目录(建议避免安装在含有空格或特殊字符的深层路径)。
  • 如遇 Windows Defender 拦截提示,请点击“更多信息”并选择“仍要运行”。

3. macOS 系统安装说明

支持环境:macOS 12 (Monterey) 及以上版本,仅支持 Apple Silicon (M1/M2/M3/M4 系列芯片),暂不支持 Intel 架构处理器。

  • 下载 ShopCrew.dmg 磁盘镜像。
  • 打开镜像并将 ShopCrew.app 拖拽至 Applications (应用程序) 文件夹。
  • 首次打开时若提示“未识别的开发者”,请在“系统设置 > 隐私与安全性”中点击“仍要打开”。

4. 店铺账号与授权绑定

ShopCrew 采用沙箱隔离机制保障店铺登录凭证安全:

  • 进入 店铺管理面板,选择目标平台(拼多多 MMS / 抖店 / 天猫淘宝千牛后台)。
  • 点击 “拉起授权登录窗”,在弹出的专属沙箱浏览器中扫码或短信登录。
  • 登录成功后,系统会自动抓取 (dom, name, path) 凭证并安全写入本地 cookies.db 独立分库中。
🔒
安全承诺: ShopCrew 绝对不会向任何云端服务器回传您的店铺密码或 Cookie,所有操作与数据通信均在您的本地电脑与电商官方服务器之间直接发生。

5. 多平台智能发品指南

发品模块针对各电商平台长规格表格(如几十种颜色与尺码组合)进行了深度优化:

  • React 虚拟滚动表格秒级同步:采用 30% 视口重叠步进式寻路,彻底杜绝超长规格漏填。
  • 多值材质与成分勾选:自动解析商品属性描述,匹配百分比数值并触发平台 React 状态变更。
  • 尺码表自动对账:自动提取长宽衣长数据生成标准尺码模版。

6. 本地目录与 OCR 违规审计

规范的商品素材文件夹结构能让发品效率提升 10 倍:

标准商品文件夹结构
商品目录/
├── 2026-秋款纯棉休闲卫衣/
│   ├── 主图/ (01.jpg, 02.jpg ... 05.jpg)
│   ├── 详情图/ (01_detail.jpg ... 10_detail.jpg)
│   ├── 颜色图/ (黑色.jpg, 白色.jpg, 雾霾蓝.jpg)
│   ├── 尺码表/ (size_chart.jpg)
│   └── info.json (可选: 包含价格、货号与属性预设)

在“本地审计面板”选择该根目录后,点击“全景扫描”,系统将自动运行离线 RapidOCR 排查极限词,并通过千问 AI 预测推荐类目。

7. 防风控与热更新机制

拟人化行为流 (Stealth Mode)

所有由 ShopCrew 发起的浏览器自动化操作,均注入了贝塞尔物理鼠标轨迹模拟、按键延迟微抖动与防自动化特征抹除技术,确保发品过程平滑稳定。

超微原子热更新

当平台前端改版导致元素选择器变化时,客户端启动时会自动检测远端补丁并载入新节点逻辑,商户端零感知即可恢复正常发品。

8. 常见故障排查

  • 问题 1:启动发品时提示“店铺登录态失效”?
    解答:电商平台 Cookie 通常有 3~7 天有效期,若失效请进入“店铺管理”重新点击“刷新登录态”扫码即可。
  • 问题 2:发品时某些特殊属性未选中?
    解答:请确认本地 info.json 或文件夹名称是否包含对应属性关键词,可在发品配置中开启“未匹配项智能备选”。
  • 问题 3:发品速度可以调快吗?
    解答:在“全局设置 > 拟人化参数”中可微调延时倍率,建议保持默认以获得最佳防风控效果。