QD-Today项目使用指南：从HAR文件获取到定时任务创建全流程

什么是HAR文件及其重要性

在开始使用QD-Today项目前，我们需要先了解HAR文件。HAR（HTTP Archive）文件是一种标准格式，用于记录网页浏览器与网站之间的交互过程。它包含了完整的HTTP请求和响应信息，是自动化测试和模拟用户行为的重要基础。

获取HAR文件的详细方法

浏览器内置开发者工具捕获

Chrome/Edge浏览器

1. 打开开发者工具：使用快捷键F12或Ctrl+Shift+I，或通过菜单选择"更多工具">"开发者工具"
2. 切换到"网络(Network)"标签页
3. 确保左上角的录制按钮显示为红色（表示正在记录）
4. 勾选"保留日志(Preserve log)"选项
5. 点击"清除"按钮清空现有记录
6. 执行你需要记录的操作流程
7. 完成后右键点击任意请求，选择"另存为HAR文件"

Firefox浏览器

1. 打开开发者工具（F12或"工具">"Web开发者">"网络"）
2. 执行需要记录的操作
3. 右键点击请求列表，选择"全部保存为HAR"

专业抓包工具方法

Windows平台使用Fiddler

1. 打开Fiddler，进入"工具">"选项"
2. 在"HTTPS"标签页勾选"捕获HTTPS连接"
3. 在"连接"标签页勾选"解密HTTPS流量"
4. 执行需要记录的操作
5. 导出时选择HTTPArchive格式

iOS平台使用Stream

1. 安装并打开Stream应用
2. 安装CA证书并在系统设置中信任
3. 点击开始抓包按钮，允许网络配置
4. 执行需要记录的操作
5. 停止抓包并导出HAR文件

使用社区共享的HAR模板

1. 点击"我的模板"右侧的"社区模板"按钮
2. 更新仓库获取最新HAR文件列表
3. 选择需要的模板并点击"订阅"
4. 根据实际需求修改模板内容

上传并编辑HAR模板

1. 登录QD框架后，点击"我的模板"旁的"+"按钮
2. 上传之前获取的HAR文件
3. 开始编辑模板，关键步骤包括：
   • 将用户名、密码等个性化内容替换为{{变量名}}格式
   • 使用Jinja2模板语法增强灵活性
   • 在测试面板验证模板的正确性
   • 设置成功/失败断言，用于自动检测任务状态
   • 使用正则表达式提取变量，实现请求间的数据传递
   • 使用__log__提取任务日志信息
4. 完成编辑后使用整体测试功能验证
5. 保存或下载最终模板

创建定时任务的完整流程

1. 点击"我的任务"旁的"+"按钮创建新任务
2. 选择之前创建或订阅的模板
3. 配置任务参数：
   • 填写任务变量值
   • 设置执行间隔（定时或周期性）
   • 指定任务分组
   • 设置具体执行时间
4. 使用测试功能验证任务配置
5. 保存任务配置

最佳实践建议

1. 对于复杂流程，建议分阶段捕获HAR文件
2. 在模板编辑时，充分考虑各种异常情况的处理
3. 定期检查社区模板更新，获取最新适配版本
4. 对于重要任务，设置合理的失败重试机制
5. 利用变量提取功能实现请求间的数据依赖

通过以上步骤，您可以充分利用QD-Today项目实现各种自动化任务。从HAR文件获取到最终定时任务创建，每个环节都至关重要，建议新用户按照指南逐步操作，确保每个步骤的正确性。