新特性（花漾TK插件）

1、发布概览

本阶段共完成 144 个非合并提交，其中包含 30 项功能建设、63 项问题修复，以及多项重构、性能与工程化调整。插件版本从 2.8.x 持续演进至 3.0.11，重点完善了侧边栏认证、达人营销、订单与投流数据同步、跨区域任务调度及长任务稳定性。

本轮发布的核心价值包括：

• 用户可直接在插件侧边栏完成登录、注册及找回密码，并支持第三方登录和图形验证码。
• 订单同步新增按日状态记录与强制重抓能力，便于识别失败日期并进行定向补数。
• 联盟达人、公开合作及邀约流程持续增强，补充更多业务字段、筛选条件和异常降级策略。
• 商品 SKU、投流素材、TikTok 视频等数据同步能力进一步完善。
• 后台任务增加标签页唤醒、连接恢复、超时提示和版本校验，提升长时间 RPA 任务的可用性。

2、版本发布历史

3.2.1（09-08）— Open API 与隐藏运行

• 插件侧边栏新增 Open API 授权入口、未授权提示和授权中主动关闭入口。
• 商品、样品和定向计划支持通过 Open API 执行；店铺同步会根据授权状态校验执行方式，并沿用用户上次的选择。
• 新增 RPA 隐藏运行模式；任务结束后自动关闭隐藏运行产生的标签页分组，并修复非普通窗口中的标签页分组异常。
• 用户栏增加团队 ID 和套餐过期时间展示，修复套餐过期时团队 ID 为空可能引发的异常。
• 索样记录更新支持设置数量上限，并记录定向邀约计划的同步时间。
• 视频分析支持自定义日期范围，并调整默认结束日期，减少数据尚未稳定造成的采集偏差。
• 给指定达人发送消息时优先从公海达人库获取达人 ID，公海库无数据时再查询达人广场，减少频繁出现验证码的情况。
• 支持从公海达人库获取创作者公开信息，优化达人基础信息和画像数据的抓取与状态判断。
• 修复验证码处理异常未捕获、登出失败时本地登录凭证未清除，以及订单信息获取失败后仍继续执行的问题。
• 买家订单超过查询上限时自动拆分时间区间，提高大订单量店铺的数据同步完整性。
• 迁移达人时同步更新达人原计划，并补充达人索样状态和可邀约商品数量日志。

3.2.0（09-01）— 达人带货视频

• 新增达人带货视频抓取能力，用于补充达人内容表现及带货分析数据。
• 同步更新相关后端接口定义。

3.1.7（09-01）— 达人信息抓取与欧洲站点

• 新增多个欧洲站点的店铺绑定支持。
• 达人基础画像获取失败时自动重试一次，并补充重试失败日志。
• 修复达人信息更新遇到验证码时可能遗漏部分达人的问题。
• 定向邀约遇到被排除达人时，改为逐个邀约并过滤不可邀约达人，提高批量任务成功率。

3.1.6（08-28）— 达人迁移修复

• 修复使用插件迁移达人并选择已有计划时，目标计划达人 ID 未同步的问题。

3.1.5（08-27）— 视频详情接口适配

• 适配 TikTok 视频详情接口的新响应格式，避免接口结构变化导致视频数据解析失败。

3.1.4（08-27）— 空参数兼容

• 修正空数组参数的默认值处理，降低空筛选条件造成的流程异常。

3.1.3（08-26）— 任务状态与商品 SKU

• 将 RPA 任务临时状态迁移到后台管理，提升页面切换和刷新场景下的任务稳定性。
• 商品 SKU 同步默认开启，并修复 SKU 同步条件判断错误。
• 识别达人市场访问受限错误码，提供更准确的任务状态和提示。
• 将单笔买家订单金额查询上限调整为 50,000，以适应更高金额订单。

3.1.2（08-26）— 数据完整性与页面就绪

• ES 数据查询改为获取全部结果，避免默认数量限制导致数据遗漏。
• 页面加载完成后增加短暂等待，确保 RPA 方法已挂载再开始执行。

3.1.1（08-25）— 更新交互与请求修复

• 优化新版本提示弹窗的按钮交互。
• 刷新登录凭证时不再携带团队 ID，避免跨团队或登录状态变化时刷新失败。
• 调整视频媒体信息更新请求参数，兼容最新接口要求。

3.1.0（08-23）— 公海达人筛选

• 达人筛选新增公海达人库数据源，扩大可触达达人范围。
• 将全球达人搜索单页数量从 1,000 调整为 100，降低单次请求压力。
• 修复订单达到同步上限时未推进同步时间的问题，避免后续任务重复抓取相同区间。
• 修正店铺信息同步过程中订单时间的更新条件。

3.0.12（08-21）— 邀约消息投递与认证资料

• 邀约卡片支持通过消息队列发送，提升批量邀约的可控性和稳定性。
• 更新登录区号列表，覆盖更多国家和地区。

3.0.11（08-20）

• 修复目标计划商品 ID 参数异常。
• 优化达人信息同步逻辑。
• 目标计划数据补充创建者头像字段。
• 调整跨区域切换后的店铺一致性校验时机；该项仍存在下述发版阻断风险。

3.0.10（08-18）— 长任务恢复与达人降级

• 连接检查超时前先尝试激活任务标签页，减少冻结或后台标签页造成的误判。
• 达人搜索失败时增加降级处理并向后端传递执行状态。
• 更新索样状态映射，并修复目标计划参数取值错误。

3.0.9（08-14）— 公海库异步任务复用

• 公海库补充达人改为复用异步任务，改善长任务的恢复能力和执行一致性。
• 同步更新相关后端 API 定义。

3.0.8（08-13）— 公开合作容错与任务模式

• 公开合作达人同步增加字段缺失保护、异常容错和后端结果上报。
• 根据任务执行模式决定是否触发同步，避免不符合条件的重复任务。
• 优化买家 ID 抓取开关的展示逻辑和提示文案。

3.0.6（08-10）— 强制重抓与公开计划达人

• 新增订单按日同步状态持久化，支持按指定日期强制重抓。
• 重构投流素材同步，同样支持按日状态记录和强制重抓。
• 店铺同步支持 OpenAPI 授权模式。
• 新增公开计划达人数据同步。
• 移除旧“达人分析数据同步”入口及自动执行逻辑。
• 请求超时时提供更明确的中文错误提示。

3.0.5（08-07）— 订单同步状态追踪

• 实现订单同步状态追踪与联盟订单跳过逻辑。
• 修复空订单日期增量游标不推进、买家订单日期过滤和任务中断提示问题。
• 防止验证码容器重复渲染和图形验证码重复提交。
• 修复店铺同步中 pdpLinkMap 缺失引发的异常。

3.0.4（08-06）— 联盟订单类型拆分

• 联盟订单同步增加达人订单与服务商订单的类型区分及独立处理。
• 修复定向计划同步的页面校验和空值处理。
• 该版本的部分订单重构在后续 3.0.5 中回退，并由同步状态方案替代，最终行为以 3.0.5 及以上版本为准。

3.0.3（08-04）— 任务标签页恢复与业务字段

• 检测并自动激活被冻结的任务标签页。
• 申请列表和订单项补充计划类型、创作者来源字段。
• 索样审核回调补充审批状态。
• 计划名称增加统一长度限制。

3.0.2（08-01）— 验证码登录修复

• 修复验证码登录流程，并统一登录与图形验证码的请求配置和会话处理。
• 优化未配置账号密码时的错误提示。

3.0.1（07-31）— 第三方登录与版本控制

• 新增第三方登录组件。
• 认证页动态显示当前插件版本。
• 任务执行前校验服务端要求的最低插件版本，提示旧版本用户升级。

3.0.0（07-31）— 侧边栏完整认证

• 用户可直接在插件侧边栏完成登录、注册和找回密码，不再依赖门户标签页。
• 支持手机号、邮箱、密码、验证码和图形验证码等认证流程。
• 完成窄屏表单布局，优化区号选择器、密码框、验证码异常和用户协议入口。

2.9.7（07-31）— 达人搜索与店铺健康

• 达人搜索补充店铺 ID 和忽略邀请商品参数。
• 店铺状态改用健康评分接口计算。
• 增加达人同步异常保护，并修正忽略规则日志顺序。

2.9.6（07-28）— 达人补充任务续跑

• 公海库补充达人的翻页偏移改为数据库持久化，中断后可从上次位置继续。
• 邀请同步分片大小降低至 10，减少单批请求压力。
• 增加运行期间不要最小化任务窗口的提示。

2.9.4（07-27）— 墨西哥地区适配

• 增加墨西哥地区联系方式字段处理与校验。
• 补充浏览器窗口最小化导致任务超时的明确提示。

2.9.3（07-27）— 站内信筛选

• 站内信任务支持按已售件数 itemsSold 过滤达人。

2.9.2（07-25）— 全球达人搜索

• 达人搜索切换至全球搜索接口，并重构请求参数。
• 修复搜索缓存键生成逻辑，避免不同搜索条件错误共用缓存。
• 修正联盟订单汇总查询默认值。

2.9.1（07-21）— 邀约达人筛选

• 优化邀约计划的达人过滤规则，减少重复邀请或不符合条件的达人进入任务。

2.8.18（07-21）— 跨区域任务执行

• 跨区域任务改为等待地区切换完成后再开始执行流程。
• 修复广告账号信息获取和请求重试逻辑。

2.8.17（07-17）— 视频详情与素材兼容

• TikTok 视频优先通过详情接口获取，提升视频字段完整度。
• 商品同步补充 SKU 缩略图 URL。
• 优化联盟消息发送失败及任务标签页不存在时的提示。
• 调整图片参数和网盘路径处理，改善素材上传兼容性。

2.8.14（07-16）— 达人带货能力字段升级

• 达人带货能力支持新版属性，同时兼容旧字段，避免接口字段升级造成数据缺失。
• 保留旧数据解析路径，降低新旧店铺或区域接口差异带来的影响。

2.8.12（07-14）— 邀约与索样兼容

• 放宽邀约详情校验条件，兼容更多达人数据结构。
• 索样记录增加视频和直播产出信息日志。
• 达人信息抓取改用通用切片并逐条并发，降低批量请求失败影响。

2.8.11（07-09）— 视频同步稳定性

• 视频任务补充页面恢复等待、重试次数和超时定时器清理。
• 联盟索样数据补充机构名称字段。
• 修复绑定店铺时“其他门店”的判断逻辑。

2.8.9（07-07）— 买家订单与视频恢复

• 重构买家订单昵称获取与同步逻辑，并明确默认不查询买家 ID。
• TikTok 视频同步增加连接错误重试，提升页面连接波动时的成功率。
• 优化定向邀约计划同步完成提示。

2.8.8（07-02）— 投流校准

• 投流素材同步增加校准天数配置，可按业务需要调整历史数据回溯范围。
• 移除无法可靠使用的买家头像拼接逻辑。

2.8.6（07-01）— 商品 SKU 与同步配置

• 新增商品 SKU 同步任务及操作入口，完善商品与 SKU 数据映射。
• 支持按配置跳过索样记录同步。
• 修复投流视频同步起始时间早于店铺创建时间、视频列表总数为空等问题。
• 统一清理达人头像 URL 的签名和查询参数。

2.8.5（06-26）— 联盟数据与异常处理

• 联盟订单补充 SKU ID、计划类型和计划 ID，为订单归因提供更完整的数据。
• 邀约和站内信流程过滤不支持类目，并记录不支持的二级类目。
• 增加联盟信息获取、邀约计划空值及 IM 查询异常的降级处理。
• 将买家 ID 抓取调整为默认关闭，降低非必要的数据请求。

3、最新版本下载与安装说明

最新版本下载地址，请阅读 花漾TK插件的下载 一文。

在不同浏览器中安装花漾TK插件的操作指引，请阅读 花漾 TK 插件下载与操作指引 一文。