店铺管理

通过编程手段管理店铺运行实例，包含启动、关闭、查询和删除等完整生命周期控制。帮助用户通过程序化的方式实现功能。

店铺管理的作用​

• 店铺指纹

通过自定义或随机化参数（如用户代理、屏幕分辨率、字体、时区、WebGL渲染等），使每一个店铺环境的指纹信息不同，避免被识别为同一用户。

• 多账号管理

店铺环境允许用户在同一设备上同时登录多个账号（如电商、社交媒体、广告账号），而不会因指纹相同导致关联封号。

• 防止跨站追踪

阻断网站通过指纹技术跨平台收集用户行为数据，减少精准广告推送或隐私泄露风险。

• 自动化与测试

为开发者或营销人员提供隔离的店铺环境，方便测试多账号操作、广告投放或爬虫任务。

• 提升效率: 通过程序自动化减少手动配置，提升效率。

• 降低成本: 按需使用资源，减少非必要资源浪费。

核心配置​

启动店铺: 动态创建店铺实例。

关闭店铺: 安全终止进程，自动清理临时文件与内存占用。

删除店铺: 终止运行中的实例并释放所有关联资源（如计算资源、存储卷），确保无残留数据。

本地 WebSocket API

本节说明稳卖 AI 浏览器外壳通过本地 WebSocket 调用店铺管理能力的协议。请求体统一使用 JSON，通过 method 字段分发。兼容说明：旧接口 queryEnv 保持原逻辑不变，仍走旧店铺列表查询；新版店铺列表查询使用 queryEnvV2。

通用请求格式

{
  "method": "queryEnvV2",
  "pageNum": 1,
  "pageSize": 20
}

成功响应统一放在 response 字段内；失败响应会返回 status: "error"、code 和 msg。

接口总览

method	功能	底层调用	关键入参
queryEnvV2	新版店铺列表查询，支持店铺状态、平台和关键词筛选	queryListV2	pageNum、pageSize、storeStatus/type、actualPlatform、platform、keyword、searchType
createEnv	新增店铺	addAccount	storeName/name、platform、storeAccount/username、storePassword/password
modifyEnv	编辑店铺信息	storeUpdateNew	storeId/id 必填，其他字段同新增店铺
bindEnvDevice	绑定设备	bindStoreIp	storeId/id、ipId、equipmentType
unbindEnvDevice	解绑设备	unBindStoreIp	storeId/id
rebindEnvDevice	换绑设备	reBindStoreIp	storeId/id、ipId、equipmentType、riskLevel
clearEnvCache	清除店铺本地缓存，可选同步清除云端 Cookie	外壳 managerClearStoreCache，可联动 clearStoreCookie	storeId/id、clearCookie、cookieOptions
clearEnvCookie	清除店铺云端 Cookie	clearStoreCookie	storeId/id、urls、cookieContext、type

queryEnvV2：新版店铺列表查询

用于查询店铺列表，支持全部店铺、最近打开、可用店铺、待绑定设备、平台筛选和关键词搜索。

店铺状态参数可传 storeStatus 或 type：

• 0 或 all：全部店铺
• 1 或 recent：最近打开
• 2 或 available：可用店铺
• 4、pendingBind、waitBind 或 unbind：待绑定设备

关键词搜索通过 keyword 与 searchType 配合使用。searchType 支持：global、storeName、deviceName、ipId、region、storeAccount。

{
  "method": "queryEnvV2",
  "pageNum": 1,
  "pageSize": 20,
  "storeStatus": "available",
  "actualPlatform": "Amazon",
  "platform": "US",
  "platformType": 1,
  "keyword": "test-store",
  "searchType": "storeName"
}

返回示例：

{
  "method": "queryEnvV2",
  "response": {
    "code": 200,
    "msg": "success",
    "total": 1,
    "page": 1,
    "pageSize": 20,
    "pageTotal": 1,
    "envs": [
      {
        "id": 10001,
        "storeId": 10001,
        "name": "test-store",
        "storeName": "test-store",
        "platform": "US",
        "actualPlatform": "Amazon",
        "storeAccount": "seller@example.com",
        "ipId": 20001,
        "ipAddress": "127.0.0.1",
        "equipmentType": "cloud",
        "bindUserName": "张三",
        "tags": [],
        "storeStatus": 2,
        "sortBy": 0
      }
    ]
  }
}

createEnv：新增店铺

{
  "method": "createEnv",
  "storeName": "test-store",
  "platform": "US",
  "actualPlatform": "Amazon",
  "platformType": 1,
  "storeAccount": "seller@example.com",
  "storePassword": "password",
  "storeUrl": "https://sellercentral.amazon.com",
  "tagIdList": [],
  "lockAccount": false
}

响应中会返回 storeId 和后端原始 data。

modifyEnv：编辑店铺信息

{
  "method": "modifyEnv",
  "storeId": 10001,
  "storeName": "new-store-name",
  "platform": "US",
  "actualPlatform": "Amazon",
  "platformType": 1,
  "storeAccount": "seller@example.com",
  "storePassword": "new-password",
  "storeUrl": "https://sellercentral.amazon.com"
}

storeId 和 id 二选一；内部会转换成后端需要的 id。

设备绑定相关

绑定设备：bindEnvDevice

{
  "method": "bindEnvDevice",
  "storeId": 10001,
  "ipId": 20001,
  "equipmentType": "cloud",
  "riskLevel": 0
}

解绑设备：unbindEnvDevice

{
  "method": "unbindEnvDevice",
  "storeId": 10001
}

换绑设备：rebindEnvDevice

{
  "method": "rebindEnvDevice",
  "storeId": 10001,
  "ipId": 20002,
  "equipmentType": "cloud",
  "riskLevel": 0
}

清理缓存和 Cookie

清除本地缓存：clearEnvCache

{
  "method": "clearEnvCache",
  "storeId": 10001,
  "clearCookie": true,
  "cookieOptions": {
    "urls": [],
    "cookieContext": "",
    "type": "extension"
  }
}

clearCookie 为 true 时，会在清除本地缓存后同步调用云端 Cookie 清理。

清除云端 Cookie：clearEnvCookie

{
  "method": "clearEnvCookie",
  "storeId": 10001,
  "urls": [],
  "cookieContext": "",
  "type": "extension"
}