巴事办热力图重点人员管理（人员任务）插件技术简介

一、概述

巴事办热力图重点人员管理（人员任务）插件（以下简称”本插件”）是一款面向政务服务场景的 Chrome 浏览器扩展，专为”巴事办”政务平台的重点人员任务管理工作而设计。

插件通过自动化技术，将原本需要人工逐条操作的重点人员任务处理流程（接收任务、修改任务类型、填写完成情况、上传佐证材料、保存提交等）转化为一键批量执行，大幅提升基层工作人员的办事效率，降低重复劳动强度，减少人工操作失误。

二、业务背景

在基层政务工作中，重点人员管理涉及大量周期性任务，例如：

•电话巡访：定期电话联系重点人员，了解其状态

•上门走访：实地走访重点人员，核实相关信息

这些任务通常以表格形式批量下发，工作人员需要在政务系统中逐条：

1.定位到对应人员所在的任务行

2.接收任务

3.修改任务类型

4.填写完成原因

5.上传走访/巡访佐证图片

6.保存提交

单条任务人工操作耗时较长，几十上百条任务累积后工作量巨大，且极易出现遗漏和错误。本插件正是为解决这一痛点而生。

三、核心功能

3.1 批量任务自动化处理

•Excel 批量导入：支持从 Excel 文件批量导入任务清单，自动解析姓名、手机号、身份证号、任务类型、完成原因、图片链接等字段

•智能任务匹配：内置多维度匹配引擎，可在政务系统表格中自动定位目标任务行

•一键批量执行：自动完成”接收 → 修改类型 → 填写原因 → 上传图片 → 保存”全流程

•实时进度反馈：popup 面板实时展示处理进度、任务状态和执行日志

3.2 灵活的执行模式

3.3 多维度任务匹配

3.4 智能字段映射

针对不同来源 Excel 的表头差异，插件内置字段别名映射表，兼容中英文、简繁体等多种表头写法（如”联系方式/联系电话/手机/phone/mobile”等），用户无需手动调整表头即可直接导入。

3.5 便捷的辅助功能

•Excel 模板下载：一键下载标准任务模板，规范填写格式

•步骤延迟配置：可自定义每步之间的等待时间，适配不同网络环境

•桌面通知提醒：任务处理完成后弹出桌面通知

四、技术特色

4.1 CDP 事件信任链

政务系统前端基于 React + Ant Design 构建，其下拉框等组件会校验事件的可信度（isTrusted），普通的脚本触发方式会被拒绝。本插件通过 Chrome DevTools Protocol（CDP）派发真实的键盘和鼠标事件，确保与人工操作行为完全一致。

4.2 四级降级 Select 操作策略

针对 Ant Design 下拉框在批量操作后可能出现的无法展开问题，插件采用四级降级容错策略：

1.原生事件派发：直接在元素上派发 mousedown 事件（坐标无关，首选）

2.CDP 鼠标点击：模拟真实用户点击

3.隐藏选项操作：直接操作已渲染但未显示的选项

4.React Fiber 直接设值：绕过界面层，直接操作组件内部状态

即使前三种方式全部失效，第四级兜底也能确保任务顺利完成。

4.3 残留弹窗清理

Ant Design 弹窗在多次打开关闭后可能产生 DOM 残留累积，导致组件状态混乱。插件在每次操作前主动清理隐藏的残留弹窗，从根源上保障批量操作的稳定性。

4.4 精准的组件关联

通过元素的 aria-controls / aria-owns 属性，将下拉框与其触发的选择器精确关联，避免页面存在多个下拉框时出现误选。

4.5 调试器生命周期管理

针对 CDP 调试器可能自动断开的问题，插件实现了完整的状态管理和自动恢复机制，确保长时间批量执行不中断。

4.6 并发安全控制

通过执行代数（generation）计数器，防止用户在修改设置后重复点击”开始”导致多个执行流程并发冲突。

五、技术架构

架构说明：

•popup 面板：用户交互界面，负责 Excel 导入、参数配置、执行控制

•background 后台：扩展后台服务，负责 CDP 事件派发、消息路由、桌面通知

•content 内容脚本：注入政务平台页面，负责任务匹配、界面交互、状态解析

三个模块通过 chrome.runtime.sendMessage 消息机制协同工作。

六、安全与合规

插件不收集、不上报、不外传任何用户数据，所有任务数据仅在本地内存中用于页面匹配和操作。

七、使用价值

八、适用场景

•基层政务重点人员电话巡访任务批量处理

•基层政务重点人员上门走访任务批量处理

•网格化管理中的任务接收与完成情况登记

•周期性走访任务的佐证材料批量上传

九、版本说明

本插件为内部政务办公自动化工具，旨在提升基层工作人员的任务处理效率。如需了解更详细的技术实现，请参阅《升级记录（开发日志）》《安全报告》《技术特色》等配套文档。