勤发发 客户端使用手册
从资料准备,到完整流程运行

把每一步操作,
变成可复用的流程。

勤发发客户端详细使用教程。按顺序完成第一次配置,也可以随时查找一个动作、一个参数或一个问题。

源码核查:2026-11-21 · 28 个章节 · 109 项数据与集成动作速查 · 离线可用
开始使用 / 01

先理解勤发发的工作方式

把可复用的资料,交给按顺序执行的流程。

勤发发客户端把产品资料、企业资料、公共素材与网站操作放在同一个工作台。您先准备内容,再为网站配置流程,流程中的动作读取当前资料、操作网页、记录结果。软件账号登录与目标网站登录是两件事。

选择项目准备产品与素材选择站点与流程配置并测试动作运行与核验
概念它负责什么新手要记住
项目一组业务资料和工作上下文先确认项目,再修改产品或流程。
产品 / 型号产品公共信息与不同规格的资料运行前核对当前产品及型号,避免填入另一款资料。
站点 / 账号要操作的网站及其账号设置客户端登录成功不代表网站已登录。
流程 / 模块按顺序组织的动作及可调用的步骤组合流程负责操作次序;资料负责实际填写的值。
动作访问、输入、点击、判断、采集等一步操作动作窗口的确定用于保存;运行指令会真实执行。
变量在步骤之间传递的文字、数字或结构化数据区分变量范围、类型及当前值。
开始使用 / 02

登录、创建项目与首次准备

从一个独立练习项目开始,先把环境和资料对应起来。

  1. 启动并登录客户端

    从正式安装目录启动勤发发。登录页以账号密码入口为主,按当前界面填写账号和密码;需要注册或找回密码时使用对应入口。记住登录只应在自己使用的电脑上开启。验证码、手机号绑定等入口的可用性取决于当前服务配置。

  2. 检查登录设置与资料位置

    在登录设置中核对资料位置及账号相关设置。切换资料位置前确认自己打开的是原有资料,避免误以为资料丢失。遇到准备或载入提示,等本次操作完成再切换。

  3. 新建或选择项目

    使用菜单中的“新建项目”,填写可辨识名称,例如“教程练习”。已有项目从项目选择入口切换。进入后再次核对当前项目名称。项目切换会改变工作上下文,不宜在流程执行中操作。

  4. 准备最小练习资料

    先建一个产品、一个型号、一段说明和一张本地图片;准备一个自己有权限操作的测试站点或草稿页面。初次学习不需要一次导入全部资料。

  5. 确认网页能正常打开

    在工作台访问目标站点,手动完成必要的网站登录。若网页无法打开,先处理网络或登录问题,再配置自动化动作。客户端使用 WebView2;缺少运行环境时按安装包要求修复。

  6. 检查保存与运行状态

    底部状态栏会显示保存、运行和当前步骤信息。离开当前流程前确认保存状态;遇到未保存或保存失败提示,先处理再继续。

开始使用 / 03

认识发布工作台

围绕当前产品、当前网站、当前流程检查操作对象。

功能分区示意,帮助理解工作关系,不是当前客户端截图。

区域常用操作检查重点
产品与标题选择当前产品、型号和标题;管理或切换标题示例内容是否来自预期型号。
站点分组与发布站点选择站点、账号及流程;右键添加或编辑站点是否在预期网站和账号下。
网页窗口浏览页面、登录、切换标签、拾取元素元素是否已加载、弹窗是否遮挡。
步骤列表添加、修改、移动、复制、克隆和删除动作执行顺序、缩进范围、操作窗口。
动作指令库搜索名称、展开分类、收藏常用动作搜不到时清空搜索,检查当前分类。
底部调试区切换运行日志和变量列表,拖动分隔条调整高度失败原因、输出变量、最近运行状态。

动作库包括网页操作、等待、AI动作技能、流程控制、数据处理、产品资料、共享素材、Excel、群通知、数据库和工具与脚本。常用动作可以收藏;分类可收拢。教程内的搜索是查询本手册,客户端动作库搜索用于查找可添加的指令。

准备资料 / 04

产品、型号与企业资料

先整理内容,再让流程读取;不要在每个输入动作里重复维护同一份资料。

  1. 新增产品

    在产品列表使用“增加产品资料”,填写产品名称并选择分类。名称用于自己查找,建议包含能区分产品的关键词。保存后在列表中重新选中,确认资料已出现。

  2. 录入基本属性与自定义属性

    在对应页签中录入规格、用途、参数等信息;按字段含义填写,不把所有内容混成一段文字。属性名称与网站字段名称尽量清楚,便于后续手动映射或 AI 参考。

  3. 建立型号

    为不同规格建立型号,分别维护型号参数、标题及内容。先检查某项内容是继承产品还是型号独立内容,再编辑;对继承图片执行修改时,按窗口提示决定是否转为型号独立内容。

  4. 整理标题与正文

    维护标题列表、纯文本内容和富文本内容。普通输入框优先填纯文本;需要排版的网页编辑区再测试富文本能力。不要把 HTML 标签直接当普通正文提交。

  5. 添加图片、文件和视频

    在相应内容入口添加素材,使用可识别名称和分类。确认文件实际存在且能预览。外链地址与本地文件是不同来源,上传动作应选择网站接受的类型。

  6. 完善企业资料

    通过企业资料入口维护公司与联系信息,后续从变量选择器或输入菜单插入。修改企业资料后,先预览本次展开值,再批量运行。

  7. 验证当前选择

    返回工作台重新选择该产品与型号,检查标题、正文、属性、图片均正确。后续“变换产品”会改变流程读取的资料对象。

准备资料 / 05

导入、导出与资料备份

用客户端提供的模板保持字段和素材对应关系。

  1. 先取得当前模板

    从产品相关菜单选择“下载产品内容交付模板”。以当前模板为准填写,不沿用来源不明的旧表头;型号资料工作表应保留模板中的产品名称、型号编号、型号分类名称等字段。

  2. 先导入一个样例

    使用产品“导入”入口选择支持的文件或资料包。多文件导入时逐项查看进度及重名处理提示,先核对一个产品及其型号、正文和图片,再导入剩余数据。

  3. 处理重名与异常

    遇到同名产品、缺少必需字段或文件缺失,按提示修正。不要仅凭进度结束判断成功,应在列表中打开实际资料,核对数量和内容。

  4. 导出需要的范围

    在产品导出入口选择所需内容;需要全部产品交付时使用“导出全部产品 AI 交付包(ZIP)…”。导出后检查包内文件及图片是否齐全,再发给接收方。

  5. 分享站点时移除账号资料

    站点菜单提供“导出不含用户名和密码”。向他人分享配置时优先使用这一入口,仍应自行检查说明及步骤中是否写有私人信息。

  6. 保留可恢复副本

    大批量修改前导出对应资料,妥善保存原始文件。资料导出不是整台电脑或所有软件设置的完整备份;在另一练习项目核对导入结果后再认为可恢复。

准备资料 / 06

公共素材、共享表格与敏感词

把多产品共用的内容集中维护。

  1. 按用途组织公共库

    公共素材包括文字、图片、外链图片、视频、文件及共享表格。建议按“公司介绍”“产品主图”“资质附件”等实际用途建立分类,避免用难以辨识的默认文件名。

  2. 保存并回读文字素材

    选择文字素材后填写正文并保存。重新选中检查多行、标点和变量引用是否保留。内容编辑不等于已保存,按界面保存入口完成写入。

  3. 管理图片和文件

    导入后检查预览、名称、用途、标签及说明。删除被引用的素材可能被阻止,应先检查产品引用。视频或文件移出素材索引不应被理解为磁盘文件必然删除。

  4. 共享表格传递多行数据

    建立列名一致的表格,检查每行字段是否对齐。可通过“读取共享表格”“追加共享表格行”等动作接入流程;追加前先比对列结构,避免把不同用途的表混在一起。

  5. 配置敏感词分组

    在敏感词管理中维护对应分组并保存。输入文字高级设置可以选择不使用、默认组或多个自选组;处理发生在变量展开后,只改变本次输入内容。

  6. 检查处理后的实际文字

    先用练习内容测试替换结果。若替换后为空或分组不可用,动作会失败;AI生成的文字再次输入时仍可能再经过敏感词处理。

网站与流程 / 07

配置站点、账号和流程

一个站点可以有不同账号和流程;先明确本次操作身份。

  1. 添加站点

    在站点区域右键选择“添加站点”,填写网站信息并归入合适分组。已有站点用“编辑站点”修改。先用“访问首页”核对地址是否正确。

  2. 设置网站账号

    在站点账号相关入口维护账号和密码,必要时通过“站点账号设置”动作参与流程。保存账号不代表网站已自动登录,仍应打开页面确认。

  3. 选择要编辑的流程

    在工作台流程区域选择对应流程,核对步骤列表。把登录、填写、提交或查询按业务过程组织;已有流程先阅读步骤和目标窗口,再运行。

  4. 绑定发布流程

    需要让产品发布使用某个流程时,在站点的流程相关设置中核对发布流程绑定。绑定的是执行方案,不会替您证明网站发布成功。

  5. 先手动走一遍目标页面

    记录访问地址、登录条件、必填字段、上传规则、提交按钮及成功提示。遇到验证码或人工确认,把这一环节纳入流程设计。

  6. 保存并检查状态栏

    编辑完成后确认流程保存成功。离开站点或切换流程前核对当前内容,避免把步骤误加到另一个站点。

网站与流程 / 08

实战:搭建第一个填写流程

示例任务:把一个产品填入您有权限操作的网站草稿页,并由您确认后提交。

  1. 准备一条可核验的资料

    选择练习产品和型号,确认标题、正文和图片。手动进入网站草稿页,确保已登录。下面的字段名称是假设示例,请替换成您页面上的实际字段。

  2. 添加“访问网址”

    在动作库搜索并添加“访问网址”,填写实际草稿页面地址,设置加载等待与超时。先测试能到达该页面;不能用示例域名代替自己的地址。

  3. 添加“输入文字”:标题

    打开输入动作,拖圆环到“商品标题”输入框,确认目标高亮正确。通过变量选择器插入当前标题,先运行这一条,再观察页面是否出现完整标题。

  4. 添加“输入文字”或“多项输入”:正文和参数

    单个正文用输入文字;多个稳定字段用多项输入,逐项配置目标及内容。检查数字、单位和换行,必要时分别建立动作以便排错。

  5. 添加下拉框、勾选和上传

    对分类使用“设置下拉框”并指定选项;对协议使用复选框动作指定选中状态;图片或附件使用对应上传动作。每新增一项先单步测试。

  6. 添加提交前检查

    使用网页条件或属性条件检查必填项和登录状态。先把流程停在提交前,人工核对标题、内容、价格、分类及图片。不要用“点击已发送”作为资料正确的依据。

  7. 最后添加“元素点击”

    拾取真实提交按钮。能明确成功文字或地址时,在高级设置中配置预期结果。测试此动作会真正提交,只在确认页面内容后执行。

  8. 记录并验证结果

    提交后观察成功提示、最终地址或站点后台记录。增加日志或提取动作记录结果。单条通过后再设计循环;任何失败先看日志和页面状态,避免重复发布。

示例动作顺序

访问网址 → 输入标题 → 填写正文及参数 → 设置分类 → 上传图片 → 条件检查 → 元素点击 → 检查结果 → 输出日志

网站与流程 / 09

新增、修改、保存与单步调试

把一步做对,再连接成完整流程。

  1. 找到动作

    在右侧动作指令库输入动作名称;也可在步骤列表右键使用“插入动作”。右键插入前先核对选中行,添加后确认实际插入位置。

  2. 填写常规参数

    为目标元素、输入内容、文件路径或输出变量填入明确值。可用的字段旁通过变量选择器插入引用,不手工猜测复杂对象语法。

  3. 设置高级与错误处理

    按需要设置输入方式、等待、验证、超时等;在错误处理页选择失败终止或记录失败后继续。只有动作提供且您明确配置时才启用重试。

  4. 确定保存与重新打开

    确定保存只记录配置,不应被当作动作测试。重新打开该步骤检查关键参数、变量范围和定位方式是否正确。右上角“使用说明”可查看该动作的就地帮助。

  5. 运行单条动作

    选择“执行本行动作”或动作窗口的运行指令。它会产生真实输入、点击、文件写入或请求。观察日志及页面结果,测试过程中可停止。

  6. 从指定行运行

    使用“从本行动作开始执行”前,确保前置网页、登录、变量和对象已准备好。跳过前面的初始化步骤,常会导致变量为空或窗口不存在。

  7. 调整顺序和范围

    通过上移、下移、移动、克隆及粘贴调整动作;结构化 If、循环和 Try 要同时检查所属范围与结束标记,不只看行号。删除或粘贴替换前核对选择。

网站与流程 / 10

网页窗口与多窗口操作

动作绑定哪个窗口,由步骤列表统一管理。

  1. 先选当前网页

    添加动作之前切换到要操作的浏览器标签。新动作默认绑定当前网页窗口,并在步骤列表体现其名称。

  2. 检查或批量调整绑定

    在步骤列表选中一条或多条动作,右键选择“设置操作窗口…”,指定实际应操作的浏览器窗口。编辑动作参数不会自动把原绑定改成当前网页。

  3. 用窗口管理组织标签

    “窗口管理”动作可新增、切换、重命名或关闭浏览器窗口。名称应能表达用途,例如“登录页”“发布页”“结果页”;后续动作绑定到对应窗口。

  4. 应对弹出窗口

    网站打开新标签或弹窗后,先确认真正出现在哪个窗口,再设置后续步骤。不能因为界面上看到了新页面,就假定旧步骤绑定已自动变化。

  5. 排查窗口失效

    提示目标窗口不存在或已关闭时,先检查创建窗口步骤是否执行、名称是否被修改、窗口是否提前关闭。修正后从合理的前置步骤重新测试。

网页动作 / 11

拾取元素与智能定位

定位解决“操作谁”;动作参数解决“对它做什么”。

  1. 让网页进入正确状态

    先展开实际菜单、滚到目标区域、关闭遮挡弹层,确保目标可见。若在 Iframe 中,保留页面真实框架上下文。

  2. 拖动捕获圆环

    按住动作窗口的圆环,拖到网页输入框、按钮或其他目标上松开。检查捕获说明及高亮,避免误选外层容器或相邻图标。也可在网页元素上右键选择快捷元素动作。

  3. 保持新建默认智能定位

    新捕获默认使用智能模式。程序利用元素条件、上下文和必要路径来定位;出现结构依赖提示时,页面结构变化后要复测。智能定位并不保证任意网页变化后都命中。

  4. 使用定位测试

    测试目标是否唯一,以及是否可见、可编辑或可点击。多个匹配时补充标签、文字、属性或容器范围;不能把“不确定是哪一个”当作通过。

  5. 需要时编辑定位

    在编辑定位中调整条件,或手动选择 CSS、QPath、XPath、结构等方式。手动选择后保存和重载应保持您的方式。定位字段可通过变量选择器使用运行时条件。

  6. 保存后在真实状态复测

    保存动作,再次打开确认。跨页面、刷新、切换产品或动态加载后测试定位是否仍指向同一业务目标。定位成功后再执行动作。

现象处理方法
重复按钮或同名输入框先限定业务区域,再添加身份条件或使用相对/同类定位。
框架内元素找不到确认 Iframe 已加载且可访问,重新拾取并核对框架范围。
纯图标或图片检查拾取到实际按钮还是内部图形,核对图片、链接或上下文线索。
画布内部像素、封闭区域可能没有可独立定位的 DOM 元素;评估图片或坐标点击,并额外验证结果。
定位正确却点不动检查遮挡、禁用、滚动位置和动作方式;延长等待前先找原因。
网页动作 / 12

共享元素、相对位置与同类元素

重复使用的目标集中维护,规则变更前先看引用范围。

  1. 使用本站共享元素

    在元素动作的操作目标下拉框中打开共享元素盒,按名称或页面路径搜索,单击选中,再点“使用元素”或双击绑定。元素按当前项目和站点组织。

  2. 编辑公共定位

    在共享盒中查看或编辑元素名称、说明和定位。保存时分清更新公共定义与另存新定义:更新公共定位会影响引用它的步骤。先核对受影响动作。

  3. 删除前检查引用

    删除被引用元素时查看引用步骤提示。仍有动作依赖的元素不能随意移除,先调整引用,再回到共享盒处理。

  4. 配置相对元素位置

    选择参考元素,可从本站元素盒取定义副本或重新拾取。测试参考元素后,用目标拾取测量相对偏移,或填写 X/Y。偏移基于参考中心和网页 CSS 像素,不是桌面缩放后的屏幕像素。

  5. 拾取同类元素

    使用“拾取同类”选取两个样本,必要时向上选择父元素,推导共同匹配条件。可用 CSS、QPath 或 XPath;在预览中查看匹配集合及本次取用对象。

  6. 明确同类取用方式

    选择唯一、首项、末项或指定序号;指定序号从 1 开始,可使用变量。列表动态变化后执行会重新计算,因此必须确认业务上允许按顺序取用。

网页动作 / 13

点击、输入、粘贴、下拉与勾选

按控件性质选择动作,避免用同一种方式处理所有页面。

动作怎么配置如何确认
元素点击拾取目标 → 选择点击方式 → 设置等待和可选预期结果 → 选择错误策略。观察页面变化;未配置预期结果时,只能确认点击已发送。
输入文字拾取可编辑目标 → 输入文字或插入变量 → 设置输入方式、节奏、完成动作与验证。检查实际值、换行、单位与焦点。按 Enter 可能提交表单。
剪切板粘贴拾取目标 → 选择写入位置 → 在高级页选择驱动、模拟键盘或 JS 等提供的方式。驱动与模拟键盘走网页粘贴处理;JS 仅插入纯文本。空内容或焦点移走应先排查。
设置下拉框拾取选择控件 → 按选项内容或位置配置 → 检查选项唯一且可用。内容匹配区分大小写,位置从 1 开始;每次选择一项。
复选框操作拾取复选框 → 指定所需状态 → 测试并回读。确认最终是勾选还是未勾选,避免只按点击次数猜测。
元素属性操作 / 提取元素属性选择目标和属性或提取项目 → 指定输出变量或操作参数。区分文字、value、HTML、href 和 src,检查变量值。
高级点击按该动作设置目标集合、筛选或随机等规则。先缩小候选范围;随机结果不能代替固定目标核验。
图片点击准备清晰目标图及匹配范围,检查匹配结果后执行。页面缩放、主题和图片变化会影响匹配;歧义应修正。
坐标点击按编辑器选择坐标参考及点击类型,使用可复现页面状态。位置变化、滚动和遮挡后重新检查,提交操作尤其要核验。

输入异常的排查顺序

先检查目标是否真正可编辑,再确认内容变量是否有值,随后检查输入方式和焦点,最后检查网页是否要求失焦、选择确认或单位联动。不要同时改多个参数,否则难以知道哪项修正起作用。

网页动作 / 14

多项输入与动态表单填充

固定字段、成对属性和 AI 识别表单分别处理。

  1. 固定字段使用多项输入

    添加“多项输入”,逐项拾取输入框,为每行填写内容或插入变量。以“标题、品牌、型号”这样的清晰字段名称区分,先测试一行再测试整组。

  2. 检查输入的高级参数

    输入方式、节奏、点击、完成动作、等待、延迟及验证沿用输入文字的逻辑。字数限制按输入框名称和变量展开后的实际内容生效。

  3. 成对自定义属性使用动态表单填充

    先识别或捕获网页的自定义属性区域,再勾选当前型号属性或手动新增待填属性。手动新增内容保存在当前动作,不会自动改写产品资料。

  4. 决定顺序、数量与原值策略

    顺序填写按列表从上到下,随机填写每次重新排序;填写数量为 0 表示全部。明确选择保留网页原值还是覆盖,避免误覆盖已有字段。

  5. 处理数量与重复名称

    跳过项及保留的网页原值不计入实际填写数量。同名属性优先使用勾选的新增值,先检查勾选列表再运行。

  6. 核对部分执行后的页面

    某项失败时,前面已填内容不会自动回滚。先看当前网页和日志,再决定从哪里继续;避免整组重跑导致重复行。

网页动作 / 15

上传图片、上传文件与下载

把网页触发动作和文件传输步骤衔接起来。

  1. 确定文件来源

    图片可来自产品、共享素材或动作提供的路径来源;附件选择实际本地文件。检查文件存在、格式和大小符合目标网站要求。

  2. 配置上传目标

    按上传动作界面捕获目标或设置文件对话框处理。若网站点击后才打开上传窗口,确保触发步骤与上传处理次序一致;不能把普通文本框当文件输入。

  3. 先上传一份

    单步执行后观察网页缩略图、文件名和网站上传进度。弹出选择框关闭或动作返回不一定代表服务端已完成上传。

  4. 处理对话框

    对确认、提示等使用对应对话框处理动作,并先明确它属于网页提示还是系统文件窗口。验证码需按“验证码”动作及网站要求人工处理,不能假定自动识别。

  5. 区分两类下载

    “下载文件”用于明确文件地址的下载;浏览器“文件下载”用于网页触发的下载链路。按动作提供的设置配置目录、名称和等待,然后用触发下载的步骤衔接。

  6. 核对落地文件

    检查输出目录中是否出现预期文件、大小是否正常、是否能打开。下载失败先查地址权限、登录状态、目录可写性及等待超时,不直接反复触发。

AI与数据 / 16

配置模型与生成文字、图片

先选对模型能力,再把结果接入后续步骤。

  1. 打开 AI大模型设置

    从菜单进入“AI大模型设置”,按界面配置平台模型或自有 API 等当前可用来源,选择所需模型。配置项随模型来源变化,以该界面为准;不要把密钥写入共享流程说明。

  2. 核对模型用途

    文字生成使用支持文字任务的模型;图片任务选择可用于生图的模型。能进行聊天不代表能接收图片或返回图片,先做最小任务验证。

  3. 配置 AI生成内容

    选择模型、参考资料和提示词,明确需要的格式、长度和事实依据;设置结果保存目标。提示词可插入产品信息和变量,保存动作本身不代表已经调用模型。

  4. 审阅生成结果

    运行后检查输出变量和内容,核对型号、数字、单位及宣传表述。后续输入动作通过变量引用生成结果,避免直接复制到多处造成版本不一致。

  5. 配置 AI生图

    选择模型,填写提示词、尺寸及数量,按需要选择参考图来源、匹配方式和具体图片;设置输出位置、命名方式与需要的输出变量。并非每个模型都接受全部参数。

  6. 检查图片保存和输出

    运行后打开实际图片,核对数量、尺寸及保存位置。若动作未确认完成,先查询原结果或检查保存文件,避免重复生成产生额外用量。

  7. 维护内置提示词

    通过菜单“内置提示词设置”编辑和恢复对应默认文本。它与单个动作保存的自定义提示词不同,修改后用小样确认本次任务实际效果。

AI与数据 / 17

AI执行步骤:识别并填写网页表单

当前动作名称为“AI执行步骤”,以运行时的临时步骤展示处理过程。

  1. 准备参考资料

    先选好产品和型号,检查属性、标题、正文及图片信息。只选择本次填写需要的参考资料,缺少依据的字段不应交给模型猜测。

  2. 设置处理范围

    添加“AI执行步骤”。未指定容器时处理当前网页及可访问子框架;指定容器后只处理其范围。抓错容器时重新拾取,或在容器框右键恢复整页范围。

  3. 编写明确任务

    例如:“依据当前型号资料填写标题、品牌、型号和包装规格;没有依据的字段跳过,不提交表单。”这只是示例指令,实际仍要核对生成的步骤和最终页面。

  4. 理解动态追加识别

    只有勾选动态表单追加 AI 识别,才会继续处理新出现字段;默认不勾选。最大轮次包含首轮,每增加一轮都可能增加模型请求和用量。

  5. 观察临时步骤和日志

    运行中使用“查看AI临时步骤”观察分析和执行记录,临时步骤为只读。留意跳过字段、选择路径及失败原因。模型返回方案还需通过客户端校验。

  6. 检查选择控件

    地区级联按路径逐级选择,自定义下拉按可识别选项处理。已有规格可选择;新增自定义规格、删除和文件上传使用专用动作。

  7. 人工核对后再提交

    检查必填项、数值单位、选项和已保留原值。失败不会回滚此前填写。提交使用单独受控步骤,尤其留意输入后的 Enter 是否会触发表单提交。

AI与数据 / 18

变量、对象、列表和字典

变量的名称、范围、类型和当前值需要一起核对。

范围用途常见问题
项目变量当前项目内的流程数据换项目后读不到原值。
站点变量当前站点相关状态或配置选错站点,读到不同上下文。
产品变量当前产品相关数据变换产品后值随上下文变化。
全局变量需跨项目使用的变量修改影响范围更大,避免复用含义不同的同名项。
  1. 用变量列表查看当前值

    打开底部“变量列表”,选择需要的范围和类型。运行中以观察为主,避免一边运行一边修改数据。不能把定义中的默认值和当前运行值混淆。

  2. 通过选择器插入引用

    在动作字段旁打开变量或对象选择器,选择对应对象与属性。让程序插入正确表达式;复杂名称、列表项和字典字段不要凭印象拼写。

  3. 创建并保存输出目标

    需要动作输出时,明确选择可写变量及范围。只读产品或系统字段不能当作普通输出目标;集合动作应选择匹配的列表、字典或数据表格类型。

  4. 先验证一个转换

    例如新建文本变量“练习文本”,内容设为“型号 A”,用“添加前后缀”输出到另一变量,观察实际结果后再接输入文字。

  5. 处理列表和字典

    拆分多行文本后可得到列表;按键名组织资料可用字典。取值前检查位置或键是否存在,集合为空时先处理分支,不强行继续。

  6. 使用剪切板系统变量

    需要当前文本剪切板时,可从选择器插入“【$系统.剪切板内容】”。它在运行时读取文本;教程不会自动读取您的系统剪切板。需要网页粘贴行为时使用独立粘贴动作。

AI与数据 / 19

采集网页数据与翻页

先预览当前页面,再开启翻页和输出。

  1. 选择单条或列表

    添加“采集”。单条资料用于一个详情页;列表多条用于商品卡片、文章行或表格。先让目标网页加载完毕。

  2. 编辑采集目标

    添加字段列,拖动字段圆环捕获对应内容,或按目标编辑窗口提示使用 Ctrl+单击。列表范围通过相似元素或范围圆环确定,再逐列核对定位。

  3. 给字段命名并选择内容

    使用“产品名称”“价格”“详情链接”等清晰列名。按需要选择文字、图片地址、链接地址、输入框内容或 HTML 内容;检查必填字段及提取属性。

  4. 预览采集

    预览只读取当前页面,不翻页、不保存。检查第一行与后续行对应关系,尤其确认没有把第二张卡片的价格配到第一张卡片上。

  5. 配置分页与滚动

    当前编辑器提供无分页、翻页按钮和加载更多按钮,并提供滚动到底部或一屏等设置。逐项检查按钮目标、间隔和停止条件,再用少量页面测试。

  6. 选择输出

    当前输出为“数据表格”或“Excel”。表格写入本项目的表格变量;Excel填写明确文件路径。不要按旧教程把采集 JSON 写入文本变量。

  7. 运行并核对

    确认字段数、行数、必填值、去重结果及最终文件。输出或翻页异常时看错误策略和日志,先修正当前页面,再增加范围。

AI与数据 / 20

Excel:文件读写与桌面对象

两组相似名称的动作具有不同的使用方式。

路径适合场景操作顺序
Excel读取内容 / Excel写入内容直接读写 .xlsx 文件中的文字或表格内容路径、工作表、起始行列、区域大小、内容或输出变量。无需先取得桌面 Excel 对象。
Excel 分类的对象动作工作簿会话、格式、公式、Sheet、图片、宏等操作启动Excel或获取当前激活的Excel对象 → 对该对象操作 → 保存/另存 → 关闭。环境需具备对应桌面 Excel 能力。
  1. 先用副本练习

    把练习表放到独立路径,避免直接操作唯一原件。确认路径和工作表名称;文件方式支持 .xlsx,行从 1 开始,列可用 A、AA 或数字。

  2. 读取并查看输出

    文件读取指定起始行列及行列数量;单格得到显示文本,多格按制表符和换行组织。读取后在变量列表检查前导零、日期显示和空单元格。

  3. 明确写入模式

    文件写入默认整段写入一个单元格;表格模式按制表符分列、换行分行。追加行接到最后一个有内容行之后,仍使用指定起始列。

  4. 区分文字与公式

    文件写入把内容当普通文本;桌面对象动作中提供“值/公式”等选项。需要公式时选择支持公式的动作并明确写入方式。

  5. 正确释放工作簿

    桌面 Excel 流程保存后关闭对象;文件方式若提示占用,先关闭打开该文件的 Excel 再重试。不要直接强制结束别人的工作簿进程。

  6. 核对保存结果

    重新打开副本,检查目标单元格、工作表及未操作区域。文件写入保留同目录 .xlsx.bak 时,可用于对应版本恢复,但不能代替长期备份。

AI与数据 / 21

数据请求、脚本、数据库与群通知

这些动作需要明确输入和输出,建议在网页流程稳定后使用。

  1. 数据请求:先配置最小接口

    填写自己获准调用的 URL、方法、参数和必要请求头。JSON嵌套对象、数字、布尔或数组使用自定义请求体,不要用全部字符串键值替代。Cookie和Content-Type按专门设置填写。

  2. 读取状态及响应

    指定响应变量,可选状态码变量;按需要设置 JSONPath 提取字段。非成功状态、无效 JSON 或路径不匹配时查看日志,不把旧变量值当成本次结果。接口失败不应盲目重试。

  3. 区分浏览器请求与普通请求

    需要浏览器会话上下文时,评估“浏览器POST”等专门动作;普通请求并不自动等同页面上的表单提交,登录、Cookie、跨域和站点规则仍需核对。

  4. 运行JS脚本

    明确脚本作用的网页和范围,先用只读查询验证结果,再进行写入。脚本执行成功不代表网站业务成功;不要粘贴来源不明、含账号信息或不可解释的脚本。

  5. 数据库动作成对使用

    连接数据库并保存对象 → 查询或执行 SQL → 使用结果 → 关闭数据库。连接类型包括当前界面提供的 SQLServer、MySQL、PostgreSQL;驱动和连接参数须与运行环境匹配。先用只读查询验证。

  6. 群通知先做测试消息

    选择企业微信、飞书或钉钉动作,配置自己的机器人地址、消息格式及所需签名信息。先发一条无敏感内容的测试,再引用流程结果;确认接收群和通知次数。

运行与排错 / 22

判断、循环、异常与模块调用

用结构化流程表达分支,不依赖旧式命令跳转。

动作结构用途配置与检查
If / Else / End If根据变量、网页或属性条件选择分支明确比较对象、运算关系及条件组合;检查步骤缩进和结束位置。
循环 / 跳出循环 / 继续循环逐条处理数据或重复业务步骤明确次数或数据来源,设置退出条件;先用 2 条练习数据。
Try / Catch / End Try捕获一组步骤的错误并组织后续处理在异常分支写日志和必要收尾,不能把未完成的发布记为成功。
退出判断结束当前判断范围中的处理确认跳出的是判断范围,不等同结束整个流程。
调用动作模块复用登录、导航、填写等步骤选择目标模块,明确输入上下文;跨站调用后核对目标站点及窗口。
日志 / 注释记录关键结果或解释步骤用途日志写本次实际值;注释说明前置条件和业务目的。
变换标题 / 变换产品切换当前运行资料切换后重新确认标题、型号和关联变量,再填写网页。
倒计时等待明确间隔用于必要停顿;持续找不到元素时先修正定位或页面状态。

示例:采集后逐条处理

采集到数据表格 → 循环每行 → 判断必填字段 → 处理并记录结果 → 继续下一行 → 输出汇总。

示例:失败时保留诊断

把一组相关动作放在 Try 范围,Catch 中记录当前产品、失败阶段和原因,再按业务规则停止或转入安全收尾。不要在异常分支直接重新提交全部内容。

运行与排错 / 23

正式运行、定时与结果核验

一次跑通与长期稳定是两个验收阶段。

  1. 执行运行前检查

    确认项目、产品、型号、站点、账号、流程、窗口绑定、输出目录及保存状态。网页处于流程预期的起始状态,所有前置文件可访问。

  2. 先单条、再小批量

    关键动作逐条测试后运行一条完整业务。检查结果落到网站或文件中,再逐步增加批量范围。先关注数据正确性,再调整运行速度。

  3. 使用日志与变量观察

    运行中查看当前步骤、等待信息和错误原因。必要时展开变量列表核对值;不要仅凭步骤高亮或进度判断提交成功。

  4. 停止后检查现场

    “停止”应终止后续执行,但不会回滚已经提交的表单、已写文件或已经发送的请求。查看最后执行步骤和目标系统记录,再决定从哪里恢复。

  5. 配置定时任务

    通过“定时”入口配置任务、计划及对应运行内容。正式启用前手动运行同一流程,核对客户端状态、网站登录和电脑可用性;不要假设关机或退出客户端后仍能执行。

  6. 定时后复查结果

    到点后查看实际运行记录、最终数据和错误。首次定时要有人核验;网站登录过期、验证码、弹窗或页面改版都可能让原流程停止。

  7. 按需调整运行设置

    使用菜单“运行设置”调整与执行有关的参数。降低等待时间前确认网页响应稳定;速度更快不代表业务完成率更高。

进阶与参考 / 24

AI产品连接与外部 AI 协作

让外部 AI 通过授权连接读写资料,并以实际回执确认完成。

  1. 打开 AI产品连接

    先在客户端登录并打开目标项目,再进入连接向导与诊断。核对连接对应的电脑、项目及当前状态。使用向导显示的当前地址和方式,不复制历史测试部署地址。

  2. 连接外部 AI 应用

    按向导在支持的 AI 宿主添加连接并完成授权。连接码只在授权流程中使用,不发到公开聊天。需要另一应用时使用新增应用连接码等现有入口。

  3. 先做只读连通检查

    要求 AI 查询当前项目和设备,并做连接测试;只有实际收到探针和完成回执才能说明客户端链路可用,列表显示在线仅是近期状态参考。

  4. 设置权限与审核

    在连接与权限、公共素材权限及免审核设置中检查读取、写入、删除、运行等权限。默认保留审核;放开某项可能允许授权应用直接操作,不宜一次全部放开。

  5. 提出明确保存任务

    示例:“把附件整理为当前授权项目的产品资料,保留原图,不运行发布;完成后回读产品编号、型号数和图片数。”素材入库可明确“不创建产品”。

  6. 核对任务记录和回执

    在任务记录查看原任务,确认已经保存,再回读对应产品或素材。上传成功、排队成功或聊天里说成功,都不等于资料已经入库。

  7. 处理未知与冲突

    结果未知时查询原任务和客户端现场,不换任务号重发;版本冲突先重新读取并比较。重复提醒先检查已有产品,不默认另建。撤销应用权限不回滚此前写入。

运行与排错 / 25

常见问题排查表

先定位失败发生在哪一层,再改对应设置。

问题先检查下一步
登录或项目载入失败客户端账号、网络、资料位置与准备提示保留错误原文,修正当前连接或资料路径,不反复切换目录。
找不到产品或素材当前项目、分类、搜索词及是否保存清空筛选并核对实际资料;MCP保存后查看原任务和回执。
动作填错窗口步骤列表的操作窗口用“设置操作窗口…”修正绑定,核对多选范围。
元素未找到页面加载、Iframe、展开状态和定位条件重新测试目标,补充范围或身份条件。
出现多个相似目标重复名称或容器过大限定容器或使用明确同类规则,禁止任取一个冒充正确。
输入后内容丢失焦点、动态重建、单位联动和确认事件先观察实际字段行为,再选输入方式或完成动作。
点击了但业务没完成网站验证、登录、上传进度与成功证据看页面提示和后台记录,不立即重复提交。
AI字段跳过参考资料缺少事实或字段不支持补充真实资料,必要时改为手动配置专用动作。
AI请求失败或结果未知模型能力、权限、网络及原请求记录先检查已有结果和用量,避免自动重复计费请求。
采集列错位或空值列表行范围、列定位和内容类型只预览当前页,逐列修正后再打开翻页。
Excel写入失败路径、工作表、文件占用及对象状态用副本和小范围复测;确认选对文件方式或对象方式。
变量为空或类型错误范围、初始化步骤、输出目标和类型看变量列表实际值,从必要初始化步骤开始执行。
停止后仍看到已发布内容提交是否发生在停止之前停止不回滚;核对网站实际记录后处理重复。
旧流程不能编辑或执行是否包含已退出动作或失效定位按提示用现行动作重建并重新测试。
浏览器缓存或初始化异常安装目录完整性、当前用户目录写入权限修复安装或权限;不要随意删除缓存或从别的工作副本复制脚本。

反馈问题时附上这些信息

客户端版本、发生时间、动作名称与步骤位置、期望结果、实际结果、日志错误原文,以及已脱敏的页面截图。说明是否能稳定复现、刷新后是否恢复。不要附上密码、密钥、Cookie或未经处理的客户资料。

进阶与参考 / 26

上线前检查清单

逐项确认后,再扩大自动运行范围。

勾选状态仅保存在当前浏览器,不会操作客户端或发送任何数据。

进阶与参考 / 27

动作参数速查

按当前代码登记的动作名称与字段整理,可用手册搜索直达。

以下清单对应当前动作库的数据处理与集成动作。字段后的“/”表示可选项,“=”后为界面登记的默认值或选项;实际填写仍以动作窗口为准。通用顺序是选择来源或对象、填写参数、选择输出、设置错误处理、保存、用小样验证。

会话 · 5 项
动作主要设置
启动Excel对象=Excel对象;文件;可见=否/是;只读=否/是
获取当前激活的Excel对象对象=Excel对象
保存/另存Excel对象=Excel对象;文件;允许覆盖=否/是
关闭Excel对象=Excel对象;保存更改=否/是
运行Excel宏对象=Excel对象;宏名称
内容读写 · 16 项
动作主要设置
循环Excel内容对象=Excel对象;工作表;区域;遍历方式=按行/按列/按单元格;循环项=Excel项;循环序号=Excel序号
读取Excel内容对象=Excel对象;工作表;区域;输出=Excel内容;首行为列名=否/是
按单元格写入内容至Excel工作表对象=Excel对象;工作表;单元格=A1;内容;写入方式=值/公式
按行写入内容至Excel工作表对象=Excel对象;工作表;起始单元格=A1;内容
按列写入内容至Excel工作表对象=Excel对象;工作表;起始单元格=A1;内容
按区域写入内容至Excel工作表对象=Excel对象;工作表;起始单元格=A1;内容
获取Excel总行数对象=Excel对象;工作表;输出=Excel行数
获取Excel总列数对象=Excel对象;工作表;输出=Excel列数
查找/替换数据对象=Excel对象;工作表;区域;查找内容;方式=查找/替换;替换为;匹配方式=包含/完全;区分大小写=否/是;输出=Excel匹配结果
复制Excel内容对象=Excel对象;工作表;区域=A1
粘贴Excel内容对象=Excel对象;工作表;起始单元格=A1;粘贴方式=值和公式/仅值
获取列尾首个空白单元格对象=Excel对象;工作表;列=A;输出=空白单元格
获取单元格公式对象=Excel对象;工作表;单元格=A1;输出=Excel公式
单元格插入图片对象=Excel对象;工作表;单元格=A1;文件;宽度;高度
导出单元格图片对象=Excel对象;工作表;区域=A1;文件
删除Excel图片对象=Excel对象;工作表;区域
格式与筛选 · 9 项
动作主要设置
自动填充对象=Excel对象;工作表;源区域=A1:A2;目标区域=A1:A10;填充方式=默认/复制/序列
合并/拆分单元格对象=Excel对象;工作表;区域=A1:B2;方式=合并/拆分
设置单元格格式对象=Excel对象;工作表;区域=A1;数字格式;字体;字号;加粗=保持/是/否;字体颜色;填充颜色
清除单元格格式对象=Excel对象;工作表;区域=A1
设置行高/列宽对象=Excel对象;工作表;区域=A1;行高;列宽
Excel区域截图对象=Excel对象;工作表;区域=A1:B2;文件
Excel筛选对象=Excel对象;工作表;区域;筛选列=1;筛选条件
读取筛选内容对象=Excel对象;工作表;区域;输出=筛选内容;首行为列名=是/否
清除筛选条件对象=Excel对象;工作表
行/列操作 · 5 项
动作主要设置
插入空行对象=Excel对象;工作表;起始行=1;数量=1
插入空列对象=Excel对象;工作表;起始列=A;数量=1
删除Excel行对象=Excel对象;工作表;起始行=1;数量=1
删除Excel列对象=Excel对象;工作表;起始列=A;数量=1
删除Excel中的重复行对象=Excel对象;工作表;区域;对比列=1;首行为列名=是/否
Sheet操作 · 6 项
动作主要设置
添加Sheet页对象=Excel对象;新名称
删除Sheet页对象=Excel对象;工作表
激活Sheet页对象=Excel对象;工作表
拷贝Sheet页对象=Excel对象;工作表;新名称
重命名Sheet页对象=Excel对象;工作表;新名称
获取Sheet页名称对象=Excel对象;输出=Sheet名称列表
群通知 · 3 项
动作主要设置
企业微信群通知机器人地址;消息格式=文本/Markdown/文件/图片/图文;内容;@群成员
飞书群通知机器人地址;签名密钥;消息格式=文本/图片;内容
钉钉群通知机器人地址;签名密钥;消息格式=文本/Markdown/图文;内容;标题;@群成员
数据库 · 5 项
动作主要设置
连接数据库数据库类型=SQLServer/MySQL/PostgreSQL;连接方式=连接字符串/配置向导;连接字符串;服务器;端口;数据库名;用户名;密码;ODBC驱动;对象=数据库对象
执行SQL语句对象=数据库对象;SQL语句;超时秒数=30
查询数据库对象=数据库对象;SQL语句;超时秒数=30;输出=数据库表格数据
数据库批量插入数据对象=数据库对象;数据源=数据表格/Excel文件;来源;工作表;SQL语句;超时秒数=30
关闭数据库对象=数据库对象
产品资料 · 11 项
动作主要设置
添加产品资料产品名称;产品分类=未分类;基本属性;自定义属性;型号标题;纯文本内容;富文本内容
添加产品型号资料目标分类;目标产品;型号名称;基本属性;自定义属性;型号标题;纯文本内容;富文本内容
修改产品资料目标分类;目标产品;新产品名称;产品分类;基本属性;自定义属性;型号标题;纯文本内容;富文本内容
修改产品型号资料目标分类;目标产品;目标型号;新型号名称;基本属性;自定义属性;型号标题;纯文本内容;富文本内容
删除产品资料目标分类;目标产品;确认删除=否/是
删除产品型号资料目标分类;目标产品;目标型号;确认删除=否/是
修改产品属性参数目标分类;目标产品;目标型号;属性列表
删除产品属性参数目标分类;目标产品;目标型号;属性列表;确认删除=否/是
新增产品资料图片目标分类;目标产品;目标型号;图片路径;图片名称;继承内容处理=保留继承并报错/转为型号独立内容
修改产品型号图片目标分类;目标产品;目标型号;目标图片名称;新图片名称;替换图片路径;继承内容处理=保留继承并报错/转为型号独立内容
删除产品型号图片目标分类;目标产品;目标型号;目标图片名称;继承内容处理=保留继承并报错/转为型号独立内容;确认删除=否/是
共享素材 · 10 项
动作主要设置
新增共享文字素材分类=未分类;素材名称;内容
删除共享文字素材分类=未分类;素材名称;确认删除=否/是
新增共享图片素材分类=未分类;图片路径;图片名称;图片用途;标签;说明
修改共享图片属性素材分类=未分类;目标图片名称;新图片名称;移至素材分类;图片用途;标签;说明
删除共享图片素材分类=未分类;目标图片名称;确认删除=否/是
新增共享表格表格名称;表格数据
修改共享表格表格名称;新表格名称;表格数据
删除共享表格表格名称;确认删除=否/是
读取共享表格表格名称;输出=共享表格结果
追加共享表格行表格名称;表格数据
文本处理 · 7 项
动作输入与选项
添加前后缀原文本;前缀;后缀
去除空格原文本;去除方式;首尾空白;所有空白
拆分文本原文本;分隔符
文本替换原文本;查找内容;替换为
正则匹配原文本;正则表达式;捕获组
改变文本的大小写原文本;转换为;大写;小写
截取文本原文本;起始位置;截取长度
日期时间 · 5 项
动作输入与选项
时间文本格式转换时间文本;输出格式;原格式(可空)
计算时间差开始时间;结束时间;单位
增加/减少时间原时间;增减数量;单位
日期时间转换为时间戳原时间;时间戳单位;秒;毫秒
时间戳转换为日期时间时间戳;时间戳单位;秒;毫秒;输出格式(可空)
变量与转换 · 9 项
动作输入与选项
文本转换为数值数字文本
数值转换为文本数值;数字格式(可空)
设置变量新值
新建变量初始值;变量类型;文本;数值;布尔;列表;字典
文本转为 JSON 对象JSON 文本
对象转 JSON 文本JSON 对象或列表
URL 解码待解码文本
URL 编码参数文本
产生随机数最小整数;最大整数
列表操作 · 12 项
动作输入与选项
新建列表初始列表(可空)
清空列表来源列表
插入数据到列表来源列表;要插入的值;插入位置
获取列表项来源列表;位置
删除列表数据来源列表;位置
修改列表来源列表;位置;新值
合并列表第一个列表;第二个列表
反转列表来源列表
列表排序来源列表;排序方式;升序;降序
列表转文本来源列表;连接符(可空)
列表去重来源列表
获取列表交集第一个列表;第二个列表
字典操作 · 6 项
动作输入与选项
新建字典初始字典(可空)
写入数据到字典来源字典;键名;写入值
删除字典数据来源字典;键名
获取指定键的值来源字典;键名
获取字典所有键名来源字典
获取字典所有键值来源字典

完整界面字段会根据所选动作和模式显隐。不要把所有字段同时填写;例如数据库配置向导与连接字符串、不同 Excel 写入方式、素材来源各有适用范围。

进阶与参考 / 28

版本范围与学习建议

本手册说明当前操作逻辑,不把历史测试记录当作本次验收。

内容核查日期:2026-11-21。依据当前生产入口对应的主工作台、动作编辑器、执行分发、定位、变量、数据处理和集成动作代码,并参考项目上下文、开发记录与任务清单。旧文档与代码冲突处采用当前调用链。

状态本手册采用的含义
已实现当前生产编译项和调用链中存在;不自动代表所有网站、模型或部署均已通过验收。
部分实现 / 环境相关本地能力存在,但依赖账号权限、驱动、服务配置、外部宿主或具体网页。
计划 / 待确认不作为可以照着执行的现行功能介绍。

本轮仅制作教程,未替您登录网站、提交表单、调用计费模型、发送群通知或运行数据库写入;没有执行客户端全部回归测试。网页上的工作台图为功能示意,示例产品、字段和流程都不是实际生产数据。

建议学习顺序

首次使用:开始使用 → 准备资料 → 第一个填写流程。已有流程:窗口绑定 → 定位 → 单步调试 → 排错。进阶自动化:变量 → 采集或 Excel → 流程控制 → AI产品连接。

离线使用时打开下载的 HTML 文件即可。打印按钮可将全文打印或另存为 PDF;搜索会显示匹配章节,清空搜索恢复完整手册。阅读进度和检查清单仅在本浏览器保存,受浏览器本地存储设置影响。

回到顶部