HTTP 请求测试工具

概述

📜 用户协议（User Agreement）

1. 本 Skill 仅供学习与参考用途。使用本 Skill 产生的任何结果，由使用者自行承担全部责任；本 Skill 不提供任何明示或暗示的保证。
2. 涉及法律、财务、税务、投资、医疗等专业决策时，请务必咨询持证专业人士。
3. 本代码受版权法保护，未经授权复制、反向工程或商业利用将被追究法律责任。

<!– user-agreement-injected –>

⚠️ 本内容仅供一般信息参考，不构成法律、财务、税务、投资或医疗建议。

涉及合同签署、报税、投资、诊疗等专业决策时，请务必咨询持证专业人士，并由使用者自行承担决策后果。

<!– professional-disclaimer-injected –>

HTTP 请求测试工具

人性化的命令行 HTTP 客户端，让 API 调试、接口测试、REST 请求更直观易读

一、能力边界（一页纸速查卡）

能做（核心能力）：

1. 发送 GET/POST/PUT/DELETE/HEAD/PATCH/OPTIONS 请求，零第三方依赖（Python 标准库）
2. 自定义请求头（-H "Key: Value"）、查询参数（-q key=value）、JSON/表单请求体
3. 响应格式化：状态码、响应头、JSON 美化输出、耗时统计
4. 超时控制、失败重试、--insecure 跳过 SSL 校验、--dry-run 只构造不发送
5. 批量测试：从 JSON 文件读取多组请求逐一执行并汇总
6. 认证支持：Bearer Token、Basic Auth、OAuth2 客户端凭证模式
7. 代理配置：支持 HTTP/HTTPS 代理，可通过环境变量或参数指定
8. SSL 证书处理：支持自定义 CA 证书、客户端证书、跳过校验三种模式

不做（边界声明）：

• 不做：不修改任何项目源代码或配置文件
• 不做：不执行系统命令（纯 HTTP 客户端，无 shell 调用）
• 不做：不保证对非 HTTP(S) 协议（FTP/gRPC/WebSocket）的支持
• 不做：不提供 GUI 界面，仅命令行交互

适用对象表：

如果用户的需求超出以上边界，明确告知无法处理并说明原因，不强行执行。

二、触发方式（说大白话就能用）

触发词表：

大白话触发示例（用户原话 → 触发动作）：

三、标准流程（5分钟上手路径）

Step 1: 收集最小信息集

向用户确认以下关键信息（缺失则引导补采，不臆测）：

• 要执行的具体任务/参数（如：请求方法、URL、请求头、请求体）
• 输入文件路径或数据来源（如：JSON 文件、CSV 文件）
• 期望的输出形式（如：仅状态码、完整响应、保存到文件）
• 认证方式（如：无认证、Bearer Token、Basic Auth）
• 网络环境（如：是否需要代理、SSL 证书校验方式）

输入示例：

失败处理

• 输入不符合预期 → 返回错误说明与正确的输入格式示例
• 执行中异常 → 保留中间结果，报告失败原因与已处理进度
• 依赖缺失 → 给出安装命令并重试一次

前置条件

• 无特殊环境要求

执行步骤

1. 收集用户输入并确认格式
2. 按功能逻辑处理输入内容
3. 生成结果并校验完整性

输出

• 结构化文本结果，附处理说明

许可证（License）

BSD 3-Clause License

Copyright (c) 2026, httpie contributors
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution.
3. Neither the name of the copyright holder nor the names of its
   contributors may be used to endorse or promote products derived from
   this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

<!– professional-license-embedded –>

稳定性保障

• 超时控制：单条处理设置上限，超时自动跳过并记入失败明细，避免整批卡死。
• 重试策略：可恢复类错误（临时占用、瞬时 IO 失败）自动重试 3 次，间隔递增。
• 降级方案：高级解析失败时自动回退到基础解析模式，保证有可用输出而非直接报错。
• 幂等性：重复执行同一批输入结果一致，不会产生重复追加。

FAQ 与反模式

Q：可以直接对原始文件覆盖写入吗？A：不建议。默认输出到独立文件，保留原始数据是可回溯的前提。

Q：处理到一半失败了怎么办？A：已完成部分的输出有效，查看失败明细后只重跑失败项即可，无需整批重来。

反模式 ①：不做试运行直接批量处理全量数据 —— 参数配错会一次性污染全部输出。

反模式 ②：忽略失败明细只看成功数 —— 静默跳过的条目会造成数据缺口。

反模式 ③：把工具输出直接作为最终结论 —— 关键字段务必人工抽检。

安全声明

• 全流程本地执行，不上传任何用户数据到第三方服务。
• 不读取与任务无关的目录，不写入系统目录。
• 处理含个人信息的数据时，请自行遵守《个人信息保护法》等相关法规。
• 本 Skill 代码由 AI 辅助生成并经自检验证，以 MIT 协议开源，使用者自负使用后果。