QD框架HAR编辑器完整使用教程：从零到精通

QD框架是一个基于HAR Editor和Tornado Server构建的HTTP请求定时任务自动执行框架，专门用于自动化网络请求任务。其中HAR编辑器是QD框架的核心组件，它能够录制、编辑和执行HTTP请求，帮助用户轻松实现各种网络自动化需求。🎯

什么是HAR文件？

HAR（HTTP Archive）文件是一种用于记录浏览器与网站交互过程的JSON格式文件。它包含了完整的HTTP请求和响应信息，包括请求头、响应头、Cookie等关键数据。通过HAR编辑器，您可以：

• 录制请求：自动捕获浏览器中的所有网络请求
• 编辑请求：修改请求参数、添加变量和逻辑
• 定时执行：设置任务执行频率，实现自动化运行

快速安装QD框架

通过1Panel安装

1. 打开1Panel控制面板，进入"应用商店"
2. 切换到"工具"分类，找到QianDao（QD）应用
3. 点击"安装"按钮开始安装过程

配置参数设置

在安装配置界面中，您需要设置以下关键参数：

• AES加密密钥：用于数据加密的安全密钥
• Cookie加密密钥：保护用户Cookie信息
• 端口外部访问：设置外部访问端口号
• 环境变量自定义：根据需求配置环境变量

重要提示：恢复旧数据库时需保持加密密钥一致，否则可能导致数据无法正常解密。

HAR文件导出操作

从浏览器导出HAR文件

1. 打开浏览器开发者工具（F12）
2. 切换到Network（网络）面板
3. 右键点击任意请求，选择"Save as HAR with Content"选项
4. 保存生成的HAR文件到本地

HAR编辑器核心功能详解

请求列表管理

HAR编辑器提供了强大的请求筛选功能：

• 所有请求：显示录制的全部HTTP请求
• 已选择请求：仅显示您标记的重要请求
• 推荐关联请求：智能推荐与目标请求相关的其他请求

请求类型筛选

您可以根据MIME类型筛选请求：

• 文档：HTML、XML等文档类型请求
• JavaScript：脚本文件请求
• 样式表：CSS样式文件请求
• 图片：图像文件请求
• 媒体：音频、视频等媒体文件请求

特殊请求标记

• XMLHttpRequest：标记AJAX异步请求
• Set-Cookie：标记设置Cookie的请求
• 请求中有变量：标记包含变量的请求

实战操作指南

第一步：定位目标请求

1. 在请求列表中浏览所有录制的请求
2. 找到执行关键操作的目标HTTP请求
3. 在请求前的复选框打勾，标记为重要请求

第二步：编辑请求参数

通过web/tpl/har/editor.html模板，您可以：

• 修改请求URL和参数
• 添加变量替换逻辑
• 设置请求头和Cookie信息

第三步：测试请求配置

1. 点击"测试"按钮进入测试模式
2. 在环境变量中填写必要的参数值
3. 执行测试验证请求是否正确

第四步：保存模板

在保存模板时，您需要填写：

• 网站名称：便于识别的模板名称
• 网站地址：目标网站的URL
• 备注信息：记录模板功能和使用说明
• 执行间隔：设置任务自动执行的频率

高级功能技巧

变量管理

HAR编辑器支持强大的变量替换功能：

• 使用{{用户名}}格式在请求中插入变量
• 支持循环变量（loop_index, loop_first等）
• 支持条件判断逻辑

请求重排序

通过拖拽功能，您可以调整请求的执行顺序，确保依赖关系正确。

常见问题解答

Q: 如何解决HAR文件过大的问题？

A: 可以删除不必要的请求，只保留关键操作相关的请求。

Q: 为什么测试时请求失败？

A: 检查环境变量是否正确设置，确认目标网站是否可访问。

总结

QD框架的HAR编辑器是一个功能强大的HTTP请求自动化工具，通过本教程的学习，您已经掌握了从安装配置到高级使用的完整流程。无论您是初学者还是有经验的用户，都能快速上手并实现各种网络自动化需求。🚀

核心优势：

• 可视化编辑界面，操作简单直观
• 支持复杂变量和逻辑控制
• 强大的请求筛选和管理功能
• 灵活的定时任务设置

现在就开始使用QD框架的HAR编辑器，让您的网络请求自动化变得轻松高效！