# postboy

**Repository Path**: zmsofts/postboy

## Basic Information

- **Project Name**: postboy
- **Description**: electron实现post和get请求客户端工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ReqHub 桌面版

## ReqHub 使用方法
1、下载ReqHub桌面版源码
2、执行npm run build
3、执行run.bat

## ReqHub 桌面版 – 功能清单

### 一、基础请求功能（HTTP 协议）
- 支持常用 HTTP 方法：GET、POST、PUT、DELETE、PATCH、HEAD、OPTIONS
- 请求 URL 输入框，支持手动输入或从历史/集合加载
- 支持 URL 路径参数（Path Variables）通过变量占位符管理（可选增强）
- 发送按钮与加载状态提示

### 二、请求组件配置（完整构建 HTTP 报文）
1. **Query Parameters**  
   - 键值对表格形式管理 URL 查询参数  
   - 自动拼接到最终请求 URL  
   - 支持启用/禁用单个参数  

2. **Headers**  
   - 自定义请求头键值对表格  
   - 常用预设快捷添加（如 Content-Type、Accept）  

3. **认证（Auth）**  
   - 无认证  
   - Bearer Token（自动添加 `Authorization: Bearer <token>`）  
   - Basic Auth（用户名/密码，自动生成 Base64 编码头）  

4. **请求体（Body）**  
   - 无 Body  
   - `x-www-form-urlencoded`（键值对表单）  
   - Raw 文本 / JSON（语法高亮辅助）  
   - 自动根据 Body 类型推荐 Content-Type（可手动覆盖）

### 三、桌面版本与跨域解决方案
- **桌面应用封装**：基于 Electron 等技术打包为原生桌面应用（Windows）
- **内置跨域解决机制**：  
  - 通过桌面端本地代理或去安全策略模式，绕过浏览器同源策略限制  
  - 支持直接请求任意第三方 API 而不会出现 CORS 错误  
  - 无需用户额外配置代理服务器

### 四、左侧集合（Collection）管理
- **集合列表**：左侧边栏展示用户保存的请求集合（可折叠/展开分组）
- **集合操作**：  
  - 新建集合（文件夹）  
  - 重命名、删除集合  
  - 在集合内添加请求（保存当前请求配置）  
  - 拖拽调整请求顺序（可选）
- **请求条目展示**：  
  - 显示请求方法（彩色标签）和 URL 简写  
  - 单击条目加载完整请求配置到右侧编辑区  
  - 右键菜单支持复制、删除、重命名

### 五、历史记录（自动保存）
- 自动保存每次发送的请求（方法 + URL + Headers + Body + 参数 + 认证）
- 历史列表同样位于左侧（与集合通过 Tab 切换）
- 支持清除单条历史或全部历史
- 历史记录上限可配置（默认 50 条）

### 六、响应查看器
- 显示 HTTP 状态码、状态文本、响应时间（毫秒）
- 响应体预览：  
  - JSON 自动格式化 + 语法高亮  
  - 支持文本、HTML、XML 等原始内容显示  
- 响应头展示（格式化 JSON）
- 一键复制响应体内容到剪贴板
- 响应大小显示（字节数）

### 七、请求与响应辅助功能
- **请求超时控制**：可设置超时时间（默认 30 秒）
- **请求取消**：发送中可中断请求
- **保存请求到集合**：从历史或当前编辑区一键保存到指定集合
- **导入/导出**：支持将整个集合或单个请求导出为 JSON 文件，也支持导入
- **环境变量**（可选高级功能）：  
  - 定义变量（如 `{{base_url}}`）并在 URL / Headers / Body 中使用  
  - 支持多环境切换（开发、生产等）

### 八、用户界面与体验
- **无登录要求**：所有数据本地存储（IndexedDB 或 LocalStorage）
- 明暗主题切换（深色/浅色模式）
- 响应式布局，左右分栏可调整宽度
- 快捷键支持：  
  - `Ctrl/Cmd + Enter` 发送请求  
  - `Ctrl/Cmd + S` 保存到集合  
  - `Ctrl/Cmd + D` 复制当前请求为新的标签页（多标签可选）

### 九、其他增强（视版本迭代）
- 多标签页管理：同时编辑多个请求，标签页独立配置
- 请求前后脚本（Pre‑request Script / Tests）支持简单的 JavaScript 脚本
- 生成代码片段（cURL、Python、JavaScript fetch 等）