这个项目能做什么

Voiden 是一个离线、Git 原生的 API 工作空间,让开发者、QA 和技术文档撰写者在一个地方构建、测试、协作和记录 API。所有内容都存放在纯文本 `.void` 文件中,这些文件将 Markdown 文档与结构化请求块结合在一起,而不是锁在应用内部的不透明集合。这些文件可 diff、可 grep、可被 AI 编辑,并且易于合并,非常适合基于 Git 的协作。 主要功能包括: - **协议支持**:REST、GraphQL、gRPC 和 WebSockets,全部以可安装/卸载的插件形式实现。社区插件也可用。 - **导入**:从 Postman、Insomnia 和 Swagger/OpenAPI 导入现有集合。 - **单一事实来源**:将请求、测试、笔记和文档保存在同一个可执行的 `.void` 文件中。请求可以分解为可复用的构建块(endpoint、auth、params、body),并像函数一样跨文件复用。 - **脚本**:在发送请求前和收到响应后执行 JavaScript、Python 或 Shell 脚本。 - **Stitch runner**:使用 glob 模式按顺序批量执行多个 `.void` 文件,支持失败即停止、变量隔离、可配置延迟和环境选择。 - **协作**:使用 Git 分支和 pull request,而不是专有的团队工作空间。本地优先,无需注册或强制云同步。 - **AI 友好**:纯文本格式,支持面向 Claude 和 Codex 代理的 Voiden skills,并支持 MCP,将 Claude Code 或 Codex 直接连接到项目,使其能够运行 `.void` 请求或将其作为工具提供。 - **无头 CLI**:Voiden Runner 可在终端、CI/CD、Docker 和 cron 任务中运行 `.void` 文件,支持所有主要协议和请求链。 Voiden 使用 Electron、TypeScript 和 JavaScript 构建。它不需要账户,也没有遥测或云锁定。安装程序可通过直接下载、Homebrew、APT、Snap 和 Nix 用于 macOS、Windows 和 Linux。该项目是开源项目,采用 Apache 2.0 许可证。