📚 新用户操作教学

第一部分：设置产品

产品管理是系统的数据基础，正确设置产品信息是后续自动化操作的前提。

1.1 产品信息设置详解

产品信息包含多个字段，每个字段都有其特定的用途：

必填字段

可选字段（但建议填写）

1.2 产品设置操作流程

1. 打开产品管理界面
   在主界面中找到"产品管理"模块，点击进入。
2. 创建产品分类（如需要）
   如果还没有产品分类，需要先创建。分类会在左侧树形结构中显示。
3. 填写产品基本信息
   
   • 在"产品名称"输入框中输入产品名称（必填）
   • 在"产品分类"下拉框中选择或输入分类名称（必填）
4. 设置产品模板
   点击"产品模板"编辑框，可以输入HTML格式的内容。点击"查看HTML源码"按钮可以打开HTML源码编辑器进行详细编辑。
   提示：产品模板中可以使用变量占位符，如 {关键词}、{型号} 等，系统在执行自动化脚本时会自动替换为实际值。
5. 填写产品数据
   在多行文本框中填写产品相关数据：
   • 关键词：每行一个关键词
   • 型号：每行一个型号
   • 城市：每行一个城市名称
   • 用途：每行一个用途描述
   • 特性：每行一个特性描述
   • 后缀：每行一个后缀
6. 设置标题匹配格式
   在"标题匹配格式"输入框中输入标题生成规则，支持占位符：
   【关键词】【型号】【城市】【用途】【特性】【后缀】
7. 保存产品
   点击"保存"按钮，系统会保存产品信息到文件系统。保存成功后，产品会出现在左侧树形结构中。

1.3 标题生成规则详解

标题生成是产品管理的重要功能，可以根据产品数据和匹配格式自动生成大量标题。

占位符说明

标题生成示例

标题生成操作步骤

1. 确保产品已保存
   标题生成需要从已保存的产品数据中读取信息，所以必须先保存产品。
2. 设置标题匹配格式
   在"标题匹配格式"输入框中输入包含占位符的格式字符串。
3. 设置生成参数
   
   • 生成长度：设置生成标题的最大长度（字节数）
   • 生成数量：设置要生成的标题数量
4. 生成标题
   点击"生成标题"按钮，系统会根据匹配格式和产品数据生成标题列表。
5. 处理标题（可选）
   生成后可以使用以下功能处理标题：
   • 过滤标题：根据重复字符依据过滤掉包含重复词的标题
   • 解析标题：解析标题并显示匹配结果和长度
   • 去除重复词：检测标题中的重复词语
   • 替换标题中重复词语：自动替换重复词语，保留一个

1.4 产品设置注意事项

第二部分：设置项目

项目是自动化脚本的组织单位，每个项目都有独立的数据库存储脚本配置。

2.1 项目结构说明

项目采用三级分类体系：

• 一级分类：项目的主分类（如：电商项目、内容管理项目）
• 二级分类：一级分类下的子分类（如：淘宝项目、京东项目）
• 项目：具体的自动化项目（如：淘宝商品发布项目）

2.2 项目创建操作流程

1. 打开项目管理界面
   在主界面中找到"项目管理"模块，点击进入。
2. 选择或创建分类
   
   • 在"项目一级分类"下拉框中选择或输入一级分类名称
   • 选择一级分类后，"项目二级分类"下拉框会自动更新为该一级分类下的所有二级分类
   • 在"项目二级分类"下拉框中选择或输入二级分类名称
   • 如果分类不存在，系统会在创建项目时自动创建分类目录
3. 输入项目名称
   在"项目名称"输入框中输入项目的名称。项目名称建议使用简洁明了的名称，如"淘宝商品发布"、"文章批量发布"等。
4. 创建项目
   点击"添加项目"按钮，系统会执行以下操作：
   • 创建项目目录结构：Runtime/Storage/一级分类/二级分类/项目名称/
   • 创建SQLite数据库文件：项目名称.db
   • 初始化数据库表结构（webcef_setpaction表等）
   • 设置数据库连接
5. 验证项目创建
   创建成功后，项目会出现在左侧项目树中。可以展开分类查看项目。

2.3 项目操作功能

2.4 项目设置注意事项

第三部分：设置文章

文章管理用于存储和管理要发布的文章内容，支持单个添加和批量导入。

3.1 文章结构说明

文章采用两级分类体系：

• 一级分类：文章的主分类（如：技术文章、产品文档）
• 二级分类：一级分类下的子分类（如：前端技术、后端技术）
• 文章：归属于某个二级分类的具体文章

3.2 单个文章添加流程

1. 打开新文章管理界面
   在主界面中找到"新文章管理"模块，点击进入。
2. 选择文章分类
   
   • 在"文章分类"下拉框中选择或输入一级分类名称
   • 选择一级分类后，"文章分类二"下拉框会自动更新为该一级分类下的所有二级分类
   • 在"文章分类二"下拉框中选择或输入二级分类名称
3. 输入文章标题
   在"文章标题"输入框中输入文章的标题。标题将作为文章的唯一标识。
4. 输入文章内容
   在"文章内容"编辑框中输入文章的正文内容。支持HTML格式，可以直接编辑HTML代码。
   提示：文章内容支持HTML格式，可以包含格式化文本、链接、图片等。
5. 保存文章
   点击"添加文章"按钮，系统会保存文章到文件系统。保存成功后，文章会出现在文章列表中。
6. 验证文章保存
   在左侧"文章标题treeView"中展开分类，点击二级分类节点，右侧"标题treeView"会显示该分类下的所有文章。

3.3 批量导入文章流程

批量导入功能可以快速导入多个文本文件作为文章，大大提高效率。

1. 准备文本文件
   将要导入的文章内容保存为.txt格式的文本文件。文件名将作为文章标题，文件内容将作为文章内容。
   注意：

   • 文件必须是.txt格式
   • 文件名将作为文章标题，建议使用有意义的文件名
   • 文件内容将作为文章内容，支持多行文本
   • 文件编码建议使用UTF-8，避免乱码
2. 选择目标分类
   在"文章分类"和"文章分类二"下拉框中选择要导入到的分类。
3. 打开批量导入对话框
   点击"批量导入文章"按钮，系统会打开文件选择对话框。
4. 选择多个文件
   在文件选择对话框中：
   • 按住Ctrl键可以多选不连续的文件
   • 按住Shift键可以多选连续的文件
   • 也可以使用Ctrl+A全选文件夹中的所有文件
5. 开始导入
   选择文件后，点击"打开"按钮，系统会开始导入：
   • 系统会读取每个文件的内容
   • 文件名作为文章标题
   • 文件内容作为文章内容
   • 文章分类设置为选中的分类
6. 查看导入结果
   导入完成后，系统会显示导入结果：
   • 成功导入的文章数量
   • 失败的文章数量
   • 失败的文件列表（如果有）
7. 验证导入结果
   在文章列表中查看导入的文章，确认导入是否成功。

3.4 文章管理注意事项

第四部分：如何添加脚本

脚本是自动化操作的核心，通过配置脚本可以实现网页的自动化操作。

4.1 脚本添加流程（contextMenuStrip1）

脚本添加通过右键菜单的"添加"功能实现，具体流程如下：

1. 选择项目
   在脚本管理界面中，从"项目类型"、"脚本分类"、"执行脚本"等下拉框中选择要添加脚本的项目。
   提示：选择项目后，系统会自动加载该项目的所有脚本到脚本列表中。
2. 打开添加脚本窗口
   在脚本列表区域右键点击，选择"添加"菜单项（或使用快捷键），系统会：
   • 获取当前项目对象
   • 查询数据库获取当前最大序号（maxid）
   • 创建新的WebCef_SetpAction对象，序号设置为maxid + 1
   • 打开HtmlHandle配置窗口（type=1表示添加模式）
3. 配置脚本基本信息
   在HtmlHandle配置窗口中：
   • 执行名称：输入操作的名称，用于在脚本列表中显示
   • 序号：系统自动设置为当前最大序号+1，可以手动修改
   • 延时：设置操作执行前的等待时间（毫秒）
4. 选择执行方式
   在"执行方式"区域选择操作类型，系统支持50+种操作类型：
   • 输入操作：设置数据、设置HTML、逐字输入等
   • 点击操作：点击、双击、右键点击等
   • 获取操作：获取数据、获取HTML、获取链接等
   • 系统操作：打开URL、回车、滚动等
   • 其他操作：下拉选择、判断、POST请求等
5. 配置元素选择器
   在"元素选择器"输入框中输入或使用工具生成选择器：
   • 可以使用CSS选择器，如 #id、.class、div > span
   • 可以使用XPath，如 //div[@class='example']
   • 可以使用元素选择器工具可视化选择元素
6. 配置操作参数
   根据选择的操作类型，配置相应的参数：
   • 输入操作：配置输入的值（支持变量占位符）
   • 点击操作：通常只需要选择器
   • 获取操作：配置保存到的变量名
   • POST请求：配置URL、请求头、请求体等
7. （可选）配置数据验证
   如果需要在执行前或执行后验证数据：
   • 勾选"验证"选项
   • 添加验证条件（如：检查值是否包含某字符串）
   • 设置验证失败时的处理方式
8. （可选）配置字符处理
   如果需要对数据进行字符处理：
   • 勾选"字符前处理"选项
   • 添加字符处理方式（如：替换、截取、去重等）
   • 可以添加多个处理方式，按顺序执行
9. 保存脚本
   点击"添加"按钮，系统会：
   • 验证必填字段
   • 检查数据库是否存在，不存在则创建
   • 将脚本配置保存到SQLite数据库
   • 刷新脚本列表显示

4.2 脚本查看和编辑流程

1. 查看脚本
   在脚本列表中双击脚本行，或右键选择"查看"，系统会：
   • 从数据库查询脚本配置
   • 打开HtmlHandle配置窗口（type=5表示查看/编辑模式）
   • 自动填充所有配置信息
2. 编辑脚本
   在配置窗口中修改需要更新的配置项，点击"修改"按钮保存更改。

4.3 临时变量操作（contextMenuStrip4）

临时变量用于在执行过程中存储和传递数据，是脚本间数据传递的重要机制。

添加临时变量

1. 打开添加变量窗口
   在临时变量列表区域右键点击，选择"添加临时变量"菜单项。
2. 输入变量信息
   
   • 变量名：输入变量的名称（必填，不能与现有变量重复）
   • 变量值：输入变量的值（可以是文本、数字等）
3. 保存变量
   点击"确定"按钮，变量会添加到临时变量列表中。

编辑临时变量

1. 选择变量
   在临时变量列表中点击要编辑的变量行。
2. 打开编辑窗口
   右键点击变量行，选择"编辑此变量"菜单项。
3. 修改变量值
   在编辑窗口中修改变量的值（变量名通常不能修改）。
4. 保存更改
   点击"确定"按钮保存更改。

删除临时变量

1. 选择变量
   在临时变量列表中点击要删除的变量行。
2. 删除变量
   右键点击变量行，选择"刪除此变量"菜单项，系统会删除该变量。

变量使用说明

4.4 脚本执行流程详解（全部执行ToolStripMenuItem_Click）

脚本执行是系统的核心功能，理解执行流程有助于更好地配置和使用脚本。

执行流程总览

详细执行流程

1. 全部执行ToolStripMenuItem_Click方法
   这是执行的入口方法：
   • 清空日志显示区域（ClearText）
   • 获取执行次数（从ExeCount文本框）
   • 调用DoAllAsync方法开始执行
2. DoAllAsync方法
   这是批量执行的主方法：
   • 设置IsThreadStop = false（允许执行）
   • 获取脚本列表数量
   • 获取当前项目对象
   • 循环遍历脚本列表中的每一行
   • 对每个脚本调用ExcetAsync方法
   • 检查IsThreadStop标志，如果为true则停止执行
   • 更新执行状态显示
3. ExcetAsync方法
   这是单个脚本的执行方法：
   • 检查脚本是否被勾选（Check列）
   • 如果未勾选，跳过执行
   • 从数据库加载脚本配置（GetSetpActionById）
   • 检查是否设置了"执行多次"（Action_IsDoPeach）
   • 如果执行多次，循环执行指定次数
   • 检查是否是系统跳转操作（WebCef_Action_IsSystemGoto）
   • 如果是跳转，处理跳转逻辑并返回目标序号
   • 如果不是跳转，调用DoScriptAsync方法执行脚本
   • 等待延时时间（WebCef_Action_TimeOut）
   • 更新执行状态为"执行完毕"
4. DoScriptAsync方法
   这是脚本执行的核心方法，执行流程如下：
   1. 解密数据（UnEscape） 2. 判断操作类型： - 如果是POST请求（Action_IsPost == 1）： → 调用执行Post方式_5方法 - 如果是常规JS操作： → 调用组装数据_1方法（组装数据） → 调用组装执行路径_2方法（组装选择器） → 调用数据处理_3方法（字符处理） → 调用组装JS_4方法（生成JavaScript代码） → 调用执行方式_5方法（执行JavaScript） 3. 调用结果处理_7方法（处理执行结果）
5. 组装数据_1方法
   组装操作的数据值：
   • 使用CpControl.标签转化数据Api方法替换变量占位符
   • 支持产品数据、标题数据、临时变量、文章数据的替换
   • 执行自定义转义处理（CustomToEscape）
6. 组装执行路径_2方法
   组装元素选择器路径：
   • 替换选择器中的变量占位符
   • 如果启用了验证，执行验证并更新选择器
   • 执行自定义转义处理
7. 数据处理_3方法
   对数据进行字符处理：
   • 如果启用了验证，执行验证处理
   • 如果启用了字符前处理，执行字符处理链
   • 支持替换、截取、AI处理、长度限制等多种处理方式
8. 组装JS_4方法
   根据操作类型生成JavaScript代码：
   • 根据执行方式（WebCef_Action_ScriptType）选择对应的JS模板
   • 将选择器和数据值填充到JS模板中
   • 返回完整的JavaScript代码字符串
9. 执行方式_5方法
   根据执行方式执行操作：
   • JS代码：直接在浏览器中执行JavaScript
   • JS代码调用：调用页面中的JavaScript函数
   • 本地AI获取数据：调用本地AI模型处理数据
   • 真实粘贴输入：使用WinAPI模拟真实粘贴
   • 其他方式：根据配置执行相应操作
10. 结果处理_7方法
    处理操作执行结果：
    • 获取操作返回的结果数据
    • 如果启用了结果处理，执行字符处理
    • 如果配置了保存变量，将结果保存到临时变量
    • 更新临时变量列表显示

执行流程总结

4.5 脚本配置最佳实践

使用流程总结

完整的自动化操作流程如下：

1. 设置产品
   创建产品分类 → 添加产品信息 → 设置产品模板 → 填写产品数据 → 设置标题匹配格式 → 生成标题
2. 设置项目
   选择或创建分类 → 输入项目名称 → 创建项目 → 验证项目创建
3. 设置文章
   选择文章分类 → 添加文章（或批量导入） → 验证文章保存
4. 添加脚本
   选择项目 → 添加脚本 → 配置操作 → 保存脚本 → 测试脚本
5. 执行脚本
   选择项目 → 检查脚本列表 → 执行脚本 → 查看执行结果