ApiArk：隐私优先的 API 客户端

项目简介

ApiArk 是一个隐私优先的 API 平台，使用 Tauri v2 构建。它不需要登录、不上传云端，常驻内存约 60 MB，启动时间小于 2 秒。所有请求都以标准 YAML 文件保存在本地，集合就是文件夹，可以直接用 Git 做版本管理，不锁定任何专有格式。

主要功能

• 多协议支持：在一个应用里调试 REST、GraphQL、gRPC、WebSocket、SSE、MQTT、Socket.IO。
• 本地优先存储：每个请求是一个 .yaml 文件，集合是目录，方便 diff 与协作。
• 主题与外观：Dark、Light、Black/OLED 三种主题，8 种强调色。
• TypeScript 脚本：请求前后脚本带完整类型定义，提供 ark.test()、ark.expect()、ark.env.set()。
• 集合运行器：支持用 CSV/JSON 做数据驱动测试，可配置迭代次数，输出 JUnit/HTML 报告。
• 本地 Mock 服务器：基于集合生成 Mock API，支持 Faker.js 数据、延迟模拟和错误注入。
• 定时监控：基于 Cron 的自动化测试，支持桌面通知与 Webhook 告警，全部在本地运行。
• 文档生成：从集合生成 HTML + Markdown 接口文档。
• OpenAPI 编辑器：编辑与校验 OpenAPI 规范，集成 Spectral。
• 响应 Diff：并排比较多次请求的响应结果。
• 代理抓包：内置本地 HTTP/HTTPS 拦截代理，可查看并重放流量。
• AI 助手：用自然语言生成请求、自动编写测试，兼容 OpenAI 接口。
• 插件系统：用 JavaScript 或 WASM 插件扩展功能。
• 一键迁移：支持导入 Postman、Insomnia、Bruno、Hoppscotch、OpenAPI 3.x、HAR、cURL。

安装与使用

从 Releases 页面下载对应安装包：

平台	安装包
Windows	.exe 安装器 / .msi
macOS	Apple Silicon .dmg / Intel .dmg
Linux	.AppImage / .deb / .rpm

也可以通过包管理器安装：

# Homebrew (macOS)
brew tap berbicanes/apiark
brew install --cask apiark

# Scoop (Windows)
scoop bucket add apiark https://github.com/berbicanes/apiark
scoop install apiark

# APT (Debian/Ubuntu)
curl -fsSL https://berbicanes.github.io/apiark-apt/install.sh | sudo bash
sudo apt install apiark

同时上架 Microsoft Store。

从 Postman 迁移

1. 导出 Postman 集合（Collection v2.1 JSON）
2. 打开 ApiArk
3. Ctrl+K > "Import Collection" > 选择文件
4. 完成后请求即变为你自己拥有的 YAML 文件

命令行

# 运行一个集合
apiark run ./my-collection --env production

# 数据驱动测试
apiark run ./my-collection --data users.csv --reporter junit

# 导入 Postman 集合
apiark import postman-export.json

从源码构建

需要 Node.js 22+、pnpm 10+、Rust 工具链以及 Tauri v2 系统依赖。

git clone https://github.com/berbicanes/apiark.git
cd apiark
pnpm install
pnpm tauri build

注意事项

• 数据以纯 YAML 明文保存在本地文件系统中，请自行注意密钥与敏感信息的管理，建议配合环境变量使用。
• 接口界面目前仅提供英文，国际化基于 react-i18next，可通过 locales/ 目录贡献翻译。
• 项目以 MIT 许可证开源，欢迎通过 GitHub Issues 与 Discussions 反馈问题或提出需求。

---

本作品整理自 GitHub 开源项目 berbicanes/apiark，原作者 @berbicanes，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。