🐰 Hopp
本地优先、私有 AI 的 API 工作台 — 不是又一个 Postman 替代品
本地优先、私有 AI 的 API 工作台 — 不是又一个 Postman 替代品
数据不出机器的 API 工具，AI 是可选的增强。
基于 Flutter 构建，原生性能体验，无 Electron 负担。
支持 macOS、Windows、Linux。
Params、Headers、Body，支持 JSON / Form / Text。
嵌套文件夹组织请求，支持导入 / 导出。
同时处理多个请求。
支持浅色 / 深色 / 跟随系统主题。
内置简体中文和英语。
响应体、Headers、状态码、大小、耗时一览。
查看 SSL/TLS 证书详细信息。
DNS、TCP、TLS、TTFB、下载分段时间。
虚拟化渲染，支持 >50 KB 响应体。
Cmd+N、Cmd+Enter、Cmd+S、Cmd+W 等。
内置 HTTP 指令服务器，支持自动化测试。
多环境 + 全局变量，{{var}} 插值、动态变量与 secret 掩码。
声明式登录 → token 提取，401 自动重跑，sha1/aes/hmac 变量转换，无 JS 沙箱。
OpenAPI 3.x / Swagger 2.0，支持文件或 URL 导入 + 勾选预览。
状态/Header/Body/JSONPath 断言、Tests 结果页签，hopp run 跑 CI。
深色 / 浅色主题、耗时分析、预请求链、响应断言与 OpenAPI 导入。
开发与构建 Hopp 所需的环境和命令。
# 克隆仓库 git clone https://github.com/scottli139/hopp.git cd hopp # 安装 FVM（如尚未安装） dart pub global activate fvm # 使用项目指定的 Flutter 版本并安装依赖 fvm use fvm flutter pub get # 在 macOS 上运行 fvm flutter run -d macos
# 构建 macOS / Windows / Linux 版本
fvm flutter build macos --release
fvm flutter build windows --release
fvm flutter build linux --release
在表现层、状态层、领域层与数据层之间保持清晰边界。
Screens 与可复用 Widgets 负责渲染 UI。
Riverpod providers 与 notifiers 管理异步状态。
Freezed 模型与业务服务。
Hive、SharedPreferences 与 Dio 负责存储和网络。
hopp/ ├── lib/ │ ├── models/ # 数据模型 (Freezed + Hive) │ ├── providers/ # Riverpod 状态管理 │ ├── services/ # HTTP 与存储服务 │ ├── widgets/ # UI 组件 │ ├── screens/ # 应用页面 │ ├── utils/ # 工具类 │ └── l10n/ # 国际化 ├── macos/ # macOS 平台代码 ├── windows/ # Windows 平台代码 ├── linux/ # Linux 平台代码 ├── test/ # 单元与 Widget 测试 └── docs/ # 文档
| 类别 | 技术 |
|---|---|
| 框架 | Flutter 3.27.x, Dart 3.6+ |
| 状态管理 | Riverpod 2.x |
| HTTP 客户端 | Dio 5.x |
| 本地存储 | Hive + SharedPreferences |
| UI | Material Design 3 |
| 代码生成 | Freezed, json_serializable |
| 测试 | Mockito, integration_test, Peekaboo |
每次 push 都会触发 CI，执行静态分析、格式检查、代码生成校验与完整测试套件。
| 结果 | 数量 |
|---|---|
| 通过 | 617 |
| 跳过 | 2 |
| 总计 | 619 |
产品、架构、计划与工程指南，均在 GitHub 上渲染阅读。
欢迎贡献！请在提交 Issue 或 Pull Request 前阅读相关指南。