显示 HN：Voiden – 一个离线、Git 原生的 API 工具，基于 Markdown 构建。

显示 HN：Voiden – 一个离线、Git 原生的 API 工具，基于 Markdown 构建。
Show HN: Voiden – an offline, Git-native API tool built around Markdown

原始链接: https://github.com/VoidenHQ/voiden

Voiden 是一款新的、**优先离线的 API 客户端**，专为喜欢代码式工作流而非传统 SaaS 仪表盘的开发者、测试人员和写作者设计。它允许用户将 API 请求**构建、测试和组织为可重用的模块**，具有诸如对响应（JSON、XML、PDF、视频）进行评论、环境管理和自定义主题等功能。至关重要的是，**Voiden 完全在本地运行 – 无需云连接、帐户或同步。** 1.1.0 版本现已发布，适用于 Windows、macOS 和 Linux。该项目是开源的（Apache 2.0 许可），欢迎贡献。本地开发需要 Node.js、Yarn 以及 Windows 平台的特定构建工具。详细的安装指南和文档可在 GitHub 项目的 `docs/` 文件夹中找到，以及报告错误和建议新功能的说明。本质上，Voiden 为本地开发和测试提供了一个快速、透明且可版本化的“API 实验室”。

## Voiden：开源、Git原生API工具 Voiden 是一款新的开源 API 工具，旨在成为 Postman 等臃肿的云平台的一个轻量级替代方案。它将 API 工具视为文件，利用 Markdown、Git 和本地存储来管理规范、测试和文档——所有这些都可以在工具内部执行。主要特性包括：离线优先、无需账户或同步，以及通过插件支持 gRPC 和 WSS，以及 REST 和 GraphQL 的可扩展性。开发者旨在通过将所有内容保持在本地并使用 Git 进行版本控制，提供更简单、更友好的开发者体验。早期用户称赞 Voiden 能够将 API 文档直接集成到代码库中，提供安全灵活的解决方案。该项目现已开源，旨在避免专有 API 工具中常见的“地毯式拉人”行为。虽然有些人觉得笔记本格式过于自由，但开发者正在积极寻求反馈以进行改进。你可以在 GitHub 上找到该仓库 ([https://github.com/VoidenHQ/voiden](https://github.com/VoidenHQ/voiden))，并在 [https://voiden.md/download](https://voiden.md/download) 下载它。

原文

Voiden is an offline-first API client for developers, Testers and Technical Writers who want their API work to feel like code—not a SaaS dashboard.

Voiden lets you build, test, and link API requests like reusable blocks, comment on JSON or XML, preview responses (even PDFs or videos), and manage environments, themes, and scripts. The best part is that Voiden enables all this without ever needing the cloud. Voiden is your API lab: fast, transparent, versionable, and unapologetically opinionated.

No accounts, no sync, no cloud required.

Version 1.1.0 is now available!

👉 Download Voiden ↗️

The website will automatically detect your operating system and highlight the correct installer for you. (Windows, macOS Intel/Apple Silicon, and Linux).

🔧 Looking for the beta builds? Download beta versions ↗️

Head over to the Issues tab and click "New issue". Use the Bug report template to give us everything we need to fix it.

We love hearing about new possibilities. Use the Feature request template to tell us what you have in mind.

3. Just want to say something?

Open a general issue or leave a note.

Thanks for sharing your thoughts with us 💜

Quick Start (Local Development)

Node.js v21.x
Yarn v4.3.1
Windows Only: Visual Studio Build Tools with:
- "Desktop development with C++" workload
- MSVC (C++ compiler)
- Windows SDK

git clone https://github.com/VoidenHQ/voiden.git
cd voiden
yarn install 
yarn workspace @voiden/core-extensions build
cd apps/electron && yarn start

Note : yarn install may fail on Windows due to a non-PTY build issue. See the troubleshooting guide: Build Errors (Windows)

See the Full Installation Guide for detailed setup including Windows requirements.

All documentation is in the docs/ folder:

See the Documentation Index for the complete list.

voiden/
├── apps/
│   ├── electron/          # Electron main process
│   └── ui/                # React renderer
├── core-extensions/       # Built-in extensions
└── docs/                  # Documentation

We welcome contributions! Please read:

This project is licensed under the Apache License 2.0.