Hyperfide：把「代码图谱、版本历史、任务规格、记忆」塞进一个 C11 单文件引擎

一句话概括

如果你让 Codex 或 Claude Code 接管一个真实项目，最先崩掉的往往不是模型能力，而是上下文：智能体不知道这个仓库"是什么"、"怎么变成今天这样的"、"接下来该做什么"、"上次为什么那么选"。Hyperfide（Sidiora Labs，原名 Codify，命令 hyperfide，兼容别名 cg）就是为这四件事造的一个纯 C11 单可执行文件 + 单 SQLite 数据库的智能体工作流引擎。

痛点场景：智能体在仓库里"漫游"

传统做法有两种：一是让智能体逐文件读源码，上下文窗口迅速被填满；二是靠 RAG 检索切片，但检索到的是文本片段，丢掉了调用关系和演化脉络。Hyperfide 换了个思路——把源码索引成一张可查询的图：符号、调用边、导入、类型、路由，加上一层 FTS5 trigram 全文索引。

于是有了 hyperfide context "password auth"：一次调用返回记忆、入口点、匹配符号、调用者、被调用者、相关路由，并按 token 预算（--budget，默认 4000）裁剪，超预算的部分会显式报告"省略了 N 项"而不是静默丢弃。hyperfide impact verifyLogin -d 3 做传递闭包的影响面分析，hyperfide why 把一个符号回溯到背后的决策。

类比：给智能体配一个"工程档案室"

• 代码图谱 = 现状体检报告，随时可查最新结构
• 快照系统（内容寻址，hyperfide changes） = 影像存档，不依赖外部 VCS 也能算变更爆炸半径
• kvx 规格引擎 = 任务派工单，每个任务挂验收标准（AC），spec done 是被验证过的，不是自说自话
• 记忆表 = 会议纪要，智能体上下文重置了它不重置，recall 按相关度与时效召回

核心功能：从"计划"到"证据"

README 里反复强调一个动词：qualify（合格）。任务状态里 implemented 只表示"代码写完了并附源码证据"，只有 done 才表示"可执行验证 + 图谱检查都通过"。这条设计贯穿全流程：

• hyperfide fleet up 拉起一个可崩溃恢复的监督进程，按主智能体 → 波次管理器 → 任务工人三级层级驱动 Codex CLI / Claude Code 子进程，每个工人在独立 worktree 里干活，合并前自动检查分支漂移、冲突任务和接口变更
• hyperfide guard 提醒改动跑出了任务声明的范围
• hyperfide handoff / resume 让任务跨会话接力，状态不丢
• 内置 MCP server 暴露 71 个工具，任何 MCP 客户端（含我们自己的 Hermes）都能直接调用
• 另有一层"意图层"：Anchors 约定——只有"人写得出但机器推不出"的注释（purpose / contract / danger / pointer）才算锚点，检索时优先给文档+签名而非函数体；代码变动后锚点被标记为 stale，警告但不阻断

本地 CLI 全程无遥测，核心循环不发起任何网络请求。需要联网的都是显式 opt-in：OPENROUTER_API_KEY（Jev 判定）、CENTRA_API_KEY（变更日志摘要）、以及 gh（提 PR 和 checkpoint）。

上手门槛：两条截然不同的路

路径 A：只用核心 CLI（推荐入门）。依赖一个 C 编译器、python3、以及 libsqlite3-dev / libcurl4-openssl-dev / libssl-dev（tree-sitter 运行时与语法已 vendor）。make && sudo make install，进项目 hyperfide init 即可，5-15 分钟跑通。

路径 B：完整平台运行时。platform/ 是一套 TypeScript/React monorepo（apps/app Web、apps/desktop Electron、apps/mobile Expo、apps/server、apps/host-daemon、apps/ai-gateway，外加 packages/ 与 40+ 插件），要求 Node 24 + pnpm 9.15，pnpm -C platform install --frozen-lockfile && pnpm -C platform dev。再往上还有 services/hyperfide 分布式控制平面（Node + PostgreSQL 17 做权威库）和 deploy/hyperfide 下的一组 systemd unit 与沙箱引导脚本。整体 30-60 分钟，且需要一台常驻的服务器。

争议与局限

1. 版本状态不稳定。README 自己写明："This tree is Hyperfide 2.0 in development; hyperfide version prints 2.0.0-dev, and nothing in it is a production release."，安装脚本 scripts/install.sh 明确不作为 Hyperfide 发行版对外宣传，要等 spec 里的 25.4 / 26.2 任务关闭。已发布的 Release 仍停留在 1.6.0（2026-10-15）且仍以 Codify 名义命名——改名与发行渠道都还没收口，生产使用需谨慎。
2. Windows 缺失。官方一键安装仅覆盖 Linux x86_64（codify.centra.ag/install），其他平台只能从源码编译。
3. 仓库卫生偏重。主分支 10660 个文件，platform/ 一层就占 8454 个，.ts/.tsx 合计 6248 个；分支列表长到 90+，绝大多数是 feat/hyperfide-XX.X-source 式的开发分支。对只想"读代码"的人来说，噪声很大。
4. 社区极小。GitHub 贡献者仅 5 人，累计 7554 次提交、10 个已关闭 Issue、11 个已关闭 PR——协作痕迹很少，代码质量主要靠作者自律（CI 里确实有 build + unit + integration + Postgres 集成作业）。
5. 闭源部分与开源部分边界模糊。官网 hyperfide.com 展示的是"100 sandboxes、200 concurrent frontier agents、48–72 hrs unattended"的商业发行版，而 GitHub 上开源的是"核心工作流"。同时 Sidiora Labs 另有 machine-genome、centra-llm-agents、Paxeer X 等仓库，说明 Hyperfide 是整个实验室产品线的一块。
6. 安全面需要留意。项目自带 SECURITY.md，承认三处攻击面：解析不可信源码、快照恢复的路径穿越、cg mcp-install 往编辑器配置文件写内容时的配置注入（恶意仓库可能植入条目），以及 spec done 执行规格文件里的 verify_cmd——这是任意命令执行入口，用陌生仓库的 spec 要格外小心。私有漏洞报告渠道已开，承诺 3 个工作日确认、90 天内出修复。

行业意义

Hyperfide 代表了 AI 编程工具的一条新路线：从"给智能体更好的模型"转向"给智能体更好的工程上下文"。它的赌注是——真正卡住大规模自动化编程的，不是模型智力，而是状态的可追溯性与验证闭环。

具体做法是把业界已有的几块拼图重做并压进一个二进制：tree-sitter 做多语言语法抽取（原生适配 30+ 语言，框架感知路由覆盖 Express、Next.js、FastAPI、Spring、Axum 等）、SQLite FTS5 做检索、spec-as-code 借鉴了构建系统的依赖波次与门禁模型、Anchors 则是把"注释即意图"做成了可检索的一等公民。

MIT 协议、单二进制、零遥测、本地 SQLite——这些选择对自建 Agent 基础设施的团队有直接吸引力：不用交给云端，就能把代码图谱、任务状态与决策记忆留在自己的机器上。把它当作 Claude Code / Codex 的外部记忆与验证层，比替换掉它们更符合它的设计意图。

关键数据速览