从 AdsPower 迁移：表格导入与脚本修改

整理 AdsPower 导出的表格

准备 AdsPower 导出的环境表格，并保留一份原文件用于核对。如果文件是 Excel 格式，先另存为 UTF-8 编码的 CSV。CSV 第一行需要是表头，后面每行对应一个环境；不要把说明文字或合并单元格放进数据区域。

导入也接受由扁平对象组成的 JSON 数组，这类文件同样走列映射流程。这里的扁平 JSON 与本软件导出的完整配置 JSON 不同，不能把任意嵌套结构当作表格处理。开始前先确认文件能看见明确的字段名和逐行环境数据。

建议保留原有环境名称、平台、账号名及代理对应关系。表格里没有 Cookie 或其他登录数据时，迁移完成后需要重新登录。需要区分完整备份与表格的用途，可查看云同步与环境导出。

识别中英文表头与手动映射

导入器会自动识别常见表头，例如「环境名称」、name、profileName，「账号」、username、account，以及「备注」、remark。分组、标签、平台网址、启动网址、语言、时区和两步验证密钥也有对应字段。自动识别后仍应核对预览。

对于没有识别出的列，在映射中手动选择目标字段。尤其要区分平台账号密码与代理账号密码；两者虽然都用于认证，但对应的登录对象不同。平台网址与启动网址也应分别核对，避免把多个页面地址误放进单个字段。

Cookie 列会按其内容解析。名称相同不表示内容格式必然有效，逐行预览会给出校验问题。对来源不明确的空值，应回到原表格核对，不要为了通过导入而随意填入其他环境的账号、密码或代理。

映射拆开的代理列

表格中的代理不必拼成一列。可以分别映射「代理类型」「代理主机」「代理端口」「代理账号」「代理密码」，对应 proxyType、proxyHost、proxyPort、proxyUsername 和 proxyPassword。代理类型支持 HTTP、HTTPS、SOCKS5。

如果同时映射了完整的「代理」列，导入以这一列为准，不再根据拆分列拼接。因此应先确定采用哪种表示方式。完整代理列为空但拆分列有值时，也要检查映射，不能只凭拆分列看起来正确就判断环境已经绑定代理。

拆分代理列中的主机与端口需要对应实际代理服务。端口格式错误、账号密码错位或类型填错，都会影响后续连接。导入完成后再做出口检测，操作步骤见指纹浏览器怎么配置代理。

执行导入与处理同名环境

导入后先对照成功数量与原文件行数。超出套餐或成员可建数量的有效行不会继续创建，格式错误的行也需要单独处理。为便于回查，可以先把这一批环境放在单独分组中，确认后再按店铺或平台整理。

1. 在环境页选择「导入」，打开 CSV 或扁平 JSON，查看自动生成的列映射和样例。逐列核对后，修正未识别或识别错误的字段。
2. 选择设备模板与默认分组。表格不含完整指纹时，按模板生成指纹；可选 Windows 10、Windows 11 或 Apple 芯片 Mac，不要把模板选择当成原指纹的完整恢复。
3. 检查逐行预览中的有效行、错误行、名称冲突和剩余可建环境数量。按需要选择同名自动改名、跳过或保留原名，再提交导入。

修改自动化脚本与迁移后核对

瓦罐指纹浏览器不兼容 AdsPower Local API。更换软件后，不能只修改主机地址就沿用原有请求；需要按Local API 教程调整接口路径、请求体、鉴权方式和返回值处理。默认服务地址使用本机端口 54345，开启时生成新的密钥。

脚本打开环境后，应使用接口返回的 CDP 地址连接 Puppeteer 或 Playwright，并用新环境 ID 替换旧标识。先完成一个环境的打开、读取页面和正常关闭，再接入批量流程。如果改用插件运行，功能入口与运行方式见自动化插件。

人工核对时，依次检查账号与环境对应关系、代理出口、时区语言、设备模板及登录状态。CSV 不含完整指纹，本地存储也不会从普通表格自动恢复。迁移的验收应以实际导入内容和网站结果为准，不以文件能被读取作为全部完成的依据。

常见问题