连接你的 EzCNet 工作舱

Runner 必须运行在 EzCNet 客户端所在的电脑。它主动连接 Control Plane，不需要把本机端口暴露到公网。

三端 Workbench 客户端

Workbench 管理本机 Runner 子进程、EzCNet Bridge 适配器和 Relay；Runner 仍是独立进程并主动连接 Control Plane。下载后先安装同平台 EzCNet，再用控制台生成一次性配对文件。

Windows x64 Workbench 客户端 · EzCNet Windows x64 安装包
Linux x64 Workbench 客户端 · EzCNet Linux x64 DEB · RPM
macOS Apple Silicon Workbench 客户端 · EzCNet macOS ARM64 PKG（当前为未公证现场联调包，不提供 Intel 版本）

配对与启动

在“店铺与 Runner”点击“配对 Runner”，将一次性显示的 JSON 保存为 runner.json，每台电脑独立配对。
完整解压客户端包，打开 Start-Workbench.cmd（Windows）、Start-Workbench.command（macOS）或运行 ./Start-Workbench.sh（Linux）。
本机 GUI 会在默认浏览器打开。在“连接设置”导入配对文件并保存，然后在“运行概览”启动 Runner。程序路径自动识别，已有文件可在高级设置中填写绝对路径。

GUI 只监听 127.0.0.1:19090。若下载包尚未包含 GUI，仍可使用包内说明配置并启动旧宿主；GUI 开发完成不代表公网发布已经更新。

./ezecomop-workbench
# 不自动打开浏览器
./ezecomop-workbench -no-open
# 兼容原只读宿主
./ezecomop-workbench -headless -config ./workbench.json

关闭浏览器不会停止 Runner；请使用界面的“停止 Runner”或“退出 Workbench”。停止前先在云端暂停或完成任务，在途结果不确定时先核对。Workbench、Runner、EzCNet 仍是独立进程。

巴西订单列表复测

2.4.0-br 签名候选增加中文与葡萄牙语订单结构检查，区分“明确 0 条”、加载中和未知页面，保留当前筛选。更新后工作舱列表会显示“巴西订单识别 v2 已就绪”。该候选默认未启用，仍需真实店铺复测；旧 Runner 不能领取它。

分页采集与导出

更新 Runner 后，管理员可在工作流页查看订单与商品的分页候选。每个任务最多读取授权条数和签名页数，只导出记录 ID 与状态；未读到明确末页时保留部分结果，不显示为完成。所有者可在运行证据页下载 CSV 或 JSON。当前候选尚未通过真实巴西页面验收，请在运营同事可配合时核对页面再发布。

经营分析报表

报表候选可读取当前页面所选日期范围的 GMV、订单数、访客数与转化率，并在运行证据页展示日期、币种和时区，提供 CSV / JSON 下载。它不会修改筛选条件；读数变化、单位缺失或字段不唯一时暂停。该候选尚待巴西页面现场核对，默认未启用。GMV 不等同于利润或结算金额。

固定出口核验

Agent 启动平台页面之前、每次操作之前，都会通过该店铺的同一个独立代理核对实际出口 IP。IPv4/IPv6 必须与 EzCNet 绑定节点相符；不匹配或核验服务不可用时暂停。控制面只保存出口与节点摘要，不上传代理参数。请同步更新客户端和 Runner，并保持工作舱系统时间准确。

下载链接绑定当前发布版本，避免浏览器缓存把新旧客户端与 Runner 混用。正在使用的手动店铺窗口需要先正常关闭，再为 Agent 开启独立授权会话。

启用 Codex 决策工作流

管理员导入并发布 reasoning: codex 的签名版本后，由云端 Control Plane 配置 Super Codex。Workbench 和 Runner 不需要、也不会读取模型 API Key；不要把云端密钥写进 runner.json、客户端环境或发送给他人。

新版 workbench.v2 inspection bundle 会在授权范围内向云端发送真实订单、商品和报表业务字段，帮助 Super Codex 做规划与校验；不会发送密码、Cookie、OTP、代理认证参数、原始 DOM、脚本、截图原图或消息正文。签发授权时勾选模型推理；控制台默认每次任务上限 40 次模型调用。模型只能选择已签名定位器，不能增添任意浏览器动作。云端 Super Codex 不可用时，Runner 仍可运行确定性工作流，模型工作流会安全暂停。

此接口尚未在你的模型账户和真实店铺联调；本轮只完成本地契约与模拟执行验证。

接入验证提供方

需要 OTP、MFA、身份或支付 token 的签名流程，先在控制台“验证提供方”绑定店铺、用途、本机服务引用、平台来源和有效期。这里只填写引用，不要填写秘密原文。

通过 -secret-broker C:\你的安全目录\provider.exe 指定本机可执行文件。它从标准输入读取带 account_id、task_id、step_id、session_id、workflow_sha256、origin、provider_id、local_ref、purpose、key、nonce、expires_at 的 JSON，标准输出必须是 {value, nonce, expires_at} JSON；有效期不得超过请求，输出不超过 16 KiB。旧版裸文本输出不再支持。提供方应从合法的本机凭据服务获取当前结果，并独立校验用途。

验证码只在本机短期使用。身份和支付步骤还要求签名能力、数量/金额预算及平台后置断言；目前没有上线真实平台的身份提交或付款插件。控制台中的预算与提供方入口不代表这些业务已经通过真实店铺验收。

人工交接

操作员认领工单后获取一次性令牌，在同一台电脑打开本机 Relay。交接只暴露签名流程允许的控件和当前画面；页面正文、Cookie、长期凭据不进入 Control Plane。

版本与校验

下载 SHA-256 校验清单。Windows 安装包尚未配置 Authenticode 代码签名，下载后请核对发布哈希。

当前验收边界

执行链已通过 PostgreSQL + Mock Bridge E2E。真实 TikTok Shop 不同地区的页面，需要在已授权的真实店铺中验收；出现未知验证时必须停止自动操作。本站不提供验证码破解或风控规避。