logo打工助手数据录入辅助工具

参考文档

本文档面向使用「打工助手·数据录入辅助工具」v5.0 的用户，介绍从安装到编写脚本的完整用法。

一、产品简介

打工助手·数据录入辅助工具是一款纯本地运行的浏览器插件（支持 Chrome / Edge），用于把 Excel 数据自动填充到任意网页表单。它不是一个"表单识别 AI"，而是一个基于「流程脚本（选择器 + 动作 + 取值）+ 数据源（Excel 数据集）」的自动化执行引擎。

核心优势：无需联网、数据不出本机、不上传任何隐私；一次编排，可批量循环录入成百上千行数据。

二、安装与加载

插件以解压后的文件夹形式交付，需通过浏览器"开发者模式"加载：

  1. 下载并解压插件包（见 下载页）。
  2. 打开浏览器扩展管理页：地址栏输入 chrome://extensions（Edge 为 edge://extensions）。
  3. 右上角打开「开发者模式」开关。
  4. 点击「加载已解压的扩展程序」，选择解压后的插件文件夹。
  5. 固定插件到工具栏，点击图标即可使用。
注意：通过开发者模式加载的插件，浏览器更新后可能需要重新加载一次。正式版可联系作者获取安装器。

三、快速开始

从安装到跑通第一条数据，只需三步：

1

准备数据

在插件「添加数据」页用在线表格粘贴 / 导入 Excel，每一行 = 一条待录入记录。

2

编排流程

在「编排流程」页写脚本：每行一次操作（元素选择器 + 动作 + 取值）。也可用可视化选元素一键生成。

3

一键执行

打开目标网页，选择数据集与脚本、设定起始行，点击执行，实时查看进度与日志。

四、数据集（添加数据）

「添加数据」页内置类 Excel 在线表格：

  • 可直接粘贴从 Excel 复制的内容，或导入 .xlsx 文件。
  • 支持多个工作表（Sheet），执行时在下拉框中选择对应的数据集。
  • 数据仅保存在本机浏览器存储（chrome.storage.local），不上传网络。
  • Ctrl/Cmd + S 可快速"完成准备"并保存。

五、流程编排脚本

「编排流程」页用一张"脚本表"描述每一步操作。列定义如下：

列字段说明
AorderNo序号（步骤顺序）
Bdesc步骤描述（备注）
Cselector元素 CSS 选择器，支持 :contains()、:eq() 等 jQuery 扩展语法与多 frame 拼接
Daction动作：input（填充）、click（点击）、mousedown 等
Evalue填充值：填数据集列编号即引用 Excel 对应列；也支持 number() / text() / attr() / read() 等表达式
FdelayTm该步之后的延迟（秒）
Gcondition执行条件：exist(选择器) / noexist(选择器)，可组合 && / ||
HloopFlag循环标志（相同标志位之间的步骤循环执行）
IloopCount循环次数

取值引用示例

value 列填写数据集的列编号即可引用当前行的对应单元格。多值用 | 分隔，多 frame 用 & 拼接。

selector : #username
action   : input
value    : 2        // 引用数据集第 2 列的值填充到 #username
delayTm  : 0.5

表达式

复杂取值可用表达式（在沙箱中安全求值）：

value : number(3)        // 取第 3 列并转为数字
value : text(2) & "-" & text(3)
value : attr(1, "href")  // 取第 1 列的链接属性
value : read("页面文本")

六、可视化元素选择器

不会写选择器也没关系：

  • 点击「选择元素」，鼠标在页面上悬停即高亮目标元素。
  • 点击目标元素，自动生成 CSS 选择器并填入脚本。
  • 快捷键：Q 开始选择，ESC 停止。
  • 可将选择结果保存为"常用"，或一键生成"快速流程"。

七、组合流程

「组合流程」用于把多个"数据集 + 脚本"按网址串联：

  • 每行配置：数据集 + 脚本名 + 匹配网址(URL) + 执行次数等。
  • 模式 1 跨页面跳转：按 URL 匹配，依次执行不同页面的流程（如"列表页→详情页"）。
  • 模式 2 单页重复：在同一页面反复执行同一套流程。
  • 执行进度与断点持久化，刷新页面可续跑。

八、条件与循环

条件（condition 列）：

exist("#dialog")        // 元素存在才执行
noexist("#loading")     // 元素不存在才执行
exist("#a") || exist("#b")

循环：给若干步骤设置相同的 loopFlag，并填写 loopCount，这些步骤会被重复执行指定次数（常用于分页、列表项）。

九、AI 助手

右侧 AI 面板（需自行配置 API 地址 / Key / 模型）可：

  • 把当前页面 HTML 发给大模型，辅助生成选择器与脚本；
  • 对话式排错、改写流程；
  • 支持 SiliconFlow / Ollama 等兼容接口。
AI 助手属于增强能力，需自行准备可用的模型 API，未激活时不可用。

十、激活说明

插件采用激活码 + 本机绑定 + 有效期的授权方式：

  • 在「设置 → 激活码设置」中输入激活码完成激活，显示有效期与授权名。
  • 未激活状态仅可体验"元素选择"，无法批量执行。
  • 激活码与本机序列号绑定，可在「迁移」区生成绑定到目标浏览器的迁移码（24 小时有效，原码作废）。
  • 获取激活码与授权管理，请联系作者或查看 激活 / 价格 页说明。

十一、常见问题

Q1：插件需要联网吗？

正常录入无需联网。仅 AI 助手、激活校验等增强功能需要网络。

Q2：我的数据安全吗？

数据集与脚本仅存于本机浏览器存储，不会上传。请在处理敏感数据时自行评估使用环境。

Q3：为什么有些网站填不进去？

插件目前可覆盖约 80% 的常见网站操作；少数使用特殊前端框架或强校验的站点可能需要调整选择器或自定义脚本。你也可用「自定义脚本」扩展点进一步适配。

Q4：需要会前端吗？

基础使用借助"可视化选元素"即可，无需前端知识；编写复杂条件 / 循环表达式时，了解少量选择器语法会更顺手。

Q5：激活码能换电脑吗？

激活码与本机序列号绑定。如需换设备，请使用「迁移」功能生成迁移码。