安装 CrossKer Agent 插件（WooCommerce）教程

这个插件是做什么的

CrossKer Agent 是安装在您自己的 WordPress 网站上的执行插件。您在 CrossKer 平台上一键发布商品后：

平台只下发一份很轻的「商品清单」（文字数据 + 图片网址）；
由您的服务器自己创建商品、变体、分类，并直接从源站拉取图片；
发布速度更快，图片不经过平台中转（仅当源站拒绝下载时才由平台中转兜底）；
每个商品/每张图的成败明细在平台可见，个别失败不会拖垮整个任务。

安全说明：插件与平台之间的所有请求都经过签名校验；连接码一次性使用且 15 分钟过期；密钥在插件页只显示打码形式。平台从不主动访问您的网站，是插件主动向平台报到，无需在您服务器上开放任何入站端口。

安装前检查

项目	要求
PHP	≥ 7.4
WordPress	≥ 6.0
WooCommerce	≥ 7.0，且已启用
服务器权限	能安装/上传 WordPress 插件（管理员账号）

插件激活时会自动做上述检查，不满足会提示具体哪一项不达标，不会破坏网站。

第一步：安装插件

方式 A：后台上传（推荐）

下载插件安装包：crossker-agent-latest.zip（也可在平台「店铺管理 → 连接插件」弹窗内直接下载）；
登录您的 WordPress 后台，进入 插件 → 安装插件 → 上传插件；
选择 crossker-agent.zip，点击「现在安装」；
安装完成后点击「启用」。如果环境不满足要求，这里会直接提示原因，处理后再启用即可。

方式 B：FTP / 文件管理器上传

将 crossker-agent.zip 解压，得到 woo-crossker-agent 文件夹；
上传整个文件夹到网站的 wp-content/plugins/ 目录；
回到 WordPress 后台插件页面，找到 CrossKer Agent，点击「启用」。

启用成功后，插件会自动创建自己的数据表（用于断点续传与失败重试），不影响您网站的其他数据。

第二步：在 CrossKer 平台获取连接码

登录 CrossKer 平台，进入店铺管理（店铺绑定的通用操作见店铺绑定导读）；
找到对应的 WooCommerce 店铺，点击操作列的「连接插件」；
系统会弹出一个 8 位连接码。

连接码 15 分钟内有效，过期需重新生成；只能使用一次；且与该店铺的域名绑定，只能被这个域名使用。

第三步：在 WordPress 后台完成连接

进入您的 WordPress 后台 设置 → CrossKer Agent；
填写两项：CrossKer 服务地址（https://crossker.com，如页面已预填保持默认即可）和连接码（Pairing Code）（粘贴上一步生成的 8 位连接码）；
点击「连接」。

连接成功后，页面会切换为状态面板：

项目	说明
连接状态	已连接 / 未连接
店铺编号	该插件绑定的 CrossKer 店铺 ID
CrossKer 服务地址 / 本站 URL	绑定信息核对
最后心跳	插件最近一次向平台报到的时间（正常每 10~60 秒一次）
当前任务	正在执行的导入任务
错误日志	仅用于排障，日志中的地址与密钥均已自动脱敏

面板上还有两个按钮：「立即心跳」（手动报到一次，用于马上确认连通性）和「断开连接」（解绑并清空凭证，已有的导入数据保留）。本插件不提供任何手动导入入口——所有发布、补发、进度查看都在 CrossKer 平台完成，插件只是执行器。

连接后如何发布商品

在 CrossKer 平台照常选品、发起发布任务（发布入口与专辑设置见发布到店铺）；
平台检测到店铺已连接插件，会自动走 Agent 通道（更快、更省流量）；
在平台的任务详情里可以看到商品级 / 图片级的成败明细；
个别商品或图片失败属正常现象，任务不会整体失败；您可以在平台上确认后只补发失败项。

WooCommerce 支持两种独立的接入方式：本文的「Agent 插件」与传统的「API 密钥（REST）」绑定。两者任选其一即可——不想装插件就用密钥方式，装了插件就自动走本通道，互不替代、也无需迁移。

常见问题

现象 / 问题	说明与处理
启用插件时报「未检测到 WooCommerce」或版本过低	先安装并启用 WooCommerce（≥ 7.0）。WordPress < 6.0、PHP < 7.4 也会被拒，请先升级对应环境
提示连接码无效 / 已使用 / 已过期	连接码是 15 分钟一次性凭据。回到 CrossKer「店铺管理 → 连接插件」重新生成一个新的连接码再粘贴
提示域名与店铺不一致	连接码只对生成它的那家店铺域名有效。请确认您是在域名对应的那个 WordPress 后台操作；如果店铺换了域名，需在 CrossKer 平台上更新店铺信息后重新连接
连接成功但「最后心跳」一直不更新	插件是主动向外连接 CrossKer 的，请检查服务器是否限制了对外 HTTPS 请求（如防火墙、安全插件拦截出站请求）。可点击「立即心跳」测试；仍失败请联系 CrossKer 客服
导入几张图就失败、或商品建了一半停了	插件启动时会自动把可用内存提升到 256M（仅升不降）。若您的主机 `memory_limit` 被锁定在很低值，建议在主机面板调高 PHP 内存；具体失败原因以平台任务详情里的失败明细为准
换主题 / 换服务器 / 迁移网站，需要重新连接吗	域名不变的迁移通常无需重连；域名变了，平台会检测到并将店铺置为「待确认」暂停派任务，请在 CrossKer 平台确认后重新绑定
断开连接会丢失已导入的商品吗	不会。「断开连接」只清空绑定凭证并停止心跳，已建的商品、图片与本地记录全部保留

获取插件安装包

登录 CrossKer 平台，进入店铺管理，对 WooCommerce 店铺点击「连接插件」，弹窗内即可直接下载最新版插件安装包 crossker-agent-latest.zip，或点此下载：crossker-agent-latest.zip。

建议保持插件为最新版本：平台会在插件版本过低时提醒您升级。