我为你的代码写了一个 Vibe Check（在土豆上运行 🥔）

Source: Dev.to

你有没有那种凌晨 3 点推代码时，确信自己在某处留下了 // FIXME: 的感觉？
是的，我们都有这种经历。

VibeCheck 是一个高性能的 Zig CLI 工具，用于扫描代码库中的“未完成的氛围”——TODO、硬编码的密钥、调试打印以及其他开发者绝望的迹象。它编译成约 149 KB 的单一静态二进制文件，零运行时依赖。

什么是 VibeCheck？

• 递归扫描指示未完成或不安全代码的模式。
• 可在任何能够运行静态二进制文件的平台上运行（Linux、macOS、Windows）。
• 没有 node_modules 的黑洞，没有运行时，仅一个甚至可以在土豆 🥔 上运行的超小可执行文件。

内置包：关键氛围

如果发现上述任意标记，VibeCheck 会大声报告。

性能与体积

• **体积：**约 149 KB（静态链接，已剥离）
• **速度：**在 < 1 秒内扫描 50 000 文件的单体仓库
• **依赖：**无

它还包含可选的 AI 模式，内置 MCP（模型上下文协议）服务器，支持与 Claude Desktop 或其他 LLM 工具集成。

使用方法

人类可读的扫描

vibecheck .

示例输出

[WARN] Desperation Marker (FIXME)
  src/main.js:42:10
    | // FIXME: terrible hack, remove before launch

CI/CD 集成

如果氛围不对则让构建失败：

vibecheck . --json   # 机器可读的输出

你也可以使用 --github 为 GitHub Actions 添加注解。

特性

• ⚡ 极速： 递归扫描成千上万的文件，仅需毫秒。
• 🪶 轻量： ~149 KB 静态二进制，零依赖。
• 📦 可移植： 单一可执行文件，支持 Linux、macOS、Windows。
• 🛡️ 经受考验： 在 50 000 文件的“Google 规模”单体仓库上验证。
• 🧩 模块化： 通过 JSON 插件系统加载自定义模式包。
• 🤖 CI/CD 原生： 非零退出码用于构建失败，支持 JSON 输出和 GitHub Actions。
• 🧠 AI 就绪： 内置 MCP 服务器，便于 LLM 集成。

安装

从源码构建

# 要求：Zig 0.13+ 和 Git
git clone https://github.com/copyleftdev/vibecheck.git
cd vibecheck
zig build -Doptimize=ReleaseSmall

生成的二进制文件将放置在 zig-out/bin/vibecheck。

预编译二进制（可选）

你也可以从 GitHub 仓库的 Releases 页面下载现成的发行版。

许可证

VibeCheck 在 MIT 许可证 下开源。

在 GitHub 上查看 – 给它点星，尝试在你的项目中使用，看看这些“未完成”的氛围到底有多浓。

祝编码愉快。 🤙