约 10 MB 的轻量跨平台 API 调试工具。一个安装包，开箱即用。
语言 / Language：简体中文 · English
同类工具把整个 Chromium/Node.js 运行时打包进安装包，RustFox 用 Rust + Tauri 2 + 系统 WebView——不内置浏览器内核、无 Node 沙箱、无 JRE，装完即用。
| 维度 | RustFox | Postman | Bruno | Insomnia |
|---|---|---|---|---|
| 安装包体积 | ~10 MB | ~310 MB (Electron) | ~433 MB (Electron) | ~200 MB (Electron) |
| 首屏启动 | < 1 秒 | 2–4 秒 | 2–5 秒 | 2–4 秒 |
| 运行时内存 | ~40 MB | ~500 MB+ | ~300 MB+ | ~200 MB+ |
| 应用壳 | 系统 WebView（无内置 Chromium） | Chromium + Node.js | Chromium + Node.js | Chromium + Node.js |
同等工作负载下，安装包体积缩小 20–40 倍、启动快 2–5 倍、占用内存减少一个数量级。
Rust LTO 优化 + 单一进程模型 + SQLite 零拷贝本地存储——秒开、秒搜、秒发；请求 / Mock / 测试 / 压测全部内置，不依赖云端服务。
数据只存在本机 rustfox.db，环境变量值 AES-256-GCM 加密存储；一键备份为 JSON，随时可恢复。
- 8 种 HTTP 方法、6 种请求体（JSON / Form / x-www-form-urlencoded / Multipart / GraphQL / Text）
- Params / Headers / Body / Auth / Tests / Docs 分页编辑，未保存草稿自动标记
- cURL 一键粘贴导入，自动识别方法 / URL / Header / Body / Basic Auth
- 环境变量
{{name}}任意位置自动解析（环境 > 项目 优先级）
- API Key / Basic / Bearer / OAuth2（Authorization Code / Client Credentials / Password / Implicit 四模式）
- 令牌自动附加请求头，无需手写
- 格式化 JSON 树 / Raw / 响应头 / 状态码 / 耗时 / 大小
- 流式下载保存到本地，请求历史可重发、可删除
- 本地 axum Mock（端口 4010 起自动探测），无需联网
- Mock 规则（方法 + 路径 + Header + Body 匹配）优先，接口「响应示例」兜底
- 模板变量：
{{params.id}}{{headers.X-Token}}{{mock.uuid|email|name|word|int}}
- JSON 测试脚本：
pre_request注入变量、extract提取传递、assertions断言 - 单接口 / 文件夹 / 全项目一键运行，结果与历史留存
- 压测：并发 × 总请求数，输出 QPS、平均耗时、P50/P90/P99、错误样例，chart.js 图表
- OpenAPI 3.x / Swagger 2.0 / Postman Collection v2.1 导入导出
- 单接口 / 全项目导出 Markdown 文档
- 客户端代码生成：cURL / JavaScript / Java / Go / Rust / Python / PHP（自动含变量替换与认证头，带语法高亮）
- GraphQL 调试视图
- 备份（JSON）与恢复（ID 全量重映射，绝不覆盖现有数据）
- 深色 / 浅色 / 跟随系统主题
RustFox 内置 Agent 控制面（应用启动时自动拉起）：本机回环地址上的带令牌 HTTP API， 让 AI Agent（Claude / Cursor / 任意能执行命令的工具）直接把 cURL 命令保存为接口，无需人工粘贴。
完整指南（获取 rustfox-mcp、各客户端配置、HTTP API 手册、排障）：docs/AGENT.md
前置：MCP 配置需要
rustfox-mcp二进制。v0.0.10+ 安装包不在 PATH，必须填安装包内绝对路径（macOS 安装包：/Applications/RustFox.app/Contents/MacOS/rustfox-mcp）。 v0.0.10 起安装包已内置，无需额外安装；更早版本请先按 docs/AGENT.md 构建。
Claude Code 等支持 MCP 的客户端，在项目 .mcp.json 中配置一次：
{ "mcpServers": { "rustfox": { "command": "/Applications/RustFox.app/Contents/MacOS/rustfox-mcp" } } }仅当二进制已加入 PATH 时才可写裸
rustfox-mcp（如 Linux .deb 安装、或cargo build --release -p fox-mcp后放入/usr/local/bin）。
配好后直接让 AI 把接口存进 RustFox（贴 cURL 或贴代码都行）：
把这个接口保存到 RustFox：
@PostMapping("/orders")
public Result<Long> createOrder(@RequestBody CreateOrderReq req) { ... }
之后对话里说「把这个 curl 存到 RustFox」即可。提供 4 个工具：
| 工具 | 说明 |
|---|---|
save_curl |
解析 cURL 并保存为接口（URL 拆 base_url + 路径 + query） |
list_projects |
项目列表 |
list_endpoints |
项目下的接口列表 |
agent_info |
控制面地址与令牌文件位置 |
任何能发 HTTP 的工具也可以直接调用控制面：
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /agent/curl |
{command, projectId?, name?, folderId?} → endpointId |
| GET | /agent/projects |
项目列表 |
| GET | /agent/endpoints/:projectId |
接口列表 |
| GET | /agent/health |
存活探针 |
鉴权：请求头 Authorization: Bearer <token> 或 X-Agent-Token；
token 位于数据目录 agent-token 文件（0600），应用内「Agent 状态」或
agent_status 命令可查路径。端口从 4110 起自动探测。
安全设计：只绑定 127.0.0.1；写操作仅限导入；不覆盖已有 base_url 配置（冲突时返回 warning）。
在 Releases 下载对应平台安装包：
| 平台 | 安装包 |
|---|---|
| Windows | RustFox_*-x64-setup.exe（NSIS 安装包，SmartScreen 提示时选「更多信息 → 仍要运行」） |
| macOS | RustFox_*-aarch64.dmg（Apple Silicon）/ RustFox_*-x64.dmg（Intel） |
| Linux | .deb / .rpm / .AppImage |
macOS 首次打开提示「已损坏，无法打开」？ 应用本身没有损坏——这是 Gatekeeper 对未做 Apple 签名公证应用的拦截。把应用拖入「应用程序」后，在终端执行一次：
xattr -cr /Applications/RustFox.app然后右键 →「打开」即可。详见使用手册。
安装后可在应用内「关于 → Check for Updates」检查并一键升级新版本（v0.0.3 起支持自动更新）。
前置：Rust 工具链 + Node 22。
cargo build --workspace # 构建全部后端 crate
cargo test --workspace # 运行全部测试
npm --prefix frontend install
npm --prefix frontend run tauri dev # 开发模式（Vite HMR）
scripts/package-tauri.sh # 一键打包分发包架构原理、Crate 划分、IPC 与数据流等开发细节见 docs/ARCHITECTURE.md（Tauri 2 + Vue 3 三层架构，含架构图）。
| 文档 | 说明 |
|---|---|
| docs/ARCHITECTURE.md | 架构总览（Tauri 2 + Vue 3，含架构图与界面布局图） |
| docs/USER_GUIDE.md | 用户手册 |
| docs/AGENT.md | AI Agent 集成（MCP / HTTP 控制面） |
| docs/SPEC.md | 详细规范（模型 / 数据库 / 命令） |
| docs/SMOKE_TEST.md | 手动验收清单 |
| docs/DEPLOY.md | 发布与部署 |
| docs/MILESTONES.md | 里程碑总览 |
| docs/PROGRESS.md | 开发进度记录 |