m0n0x41d/haft

这是什么？

核心功能

• 01将问题、备选方案、决策和证据保存为类型化的项目记录
• 02内核端 MCP 校验必填字段、方案对比缺口和缺失证据
• 03证据随时间衰减，过期结论和漂移会被标记以供复查
• 04代码图查询可显示约束某个文件或符号的决策
• 05提供源码级 FPF 查询、查找和检视命令
• 06为 Claude Code 和 Codex 提供初始化集成，并管理项目指令段落

适用场景

• 记录架构选择的理由，供后续工作查阅和依赖
• 用多个并行假设排查故障，并保存结论以便交接
• 用当前测量结果检验过去的技术决策是否仍然成立
• 让 AI 辅助修改共享代码库时，权限始终由人工明确授权

快速上手

1. 1

   运行 README 中的官方安装脚本

2. 2

   为你的编程代理初始化项目（此处以 Claude Code 为例；其他宿主见 README）

   haft init --claude
3. 3

   重启或重新连接你的编程代理，然后正常使用，需要时调用 /h-reason

使用前须知

• !许可证不明确（元数据显示为 NOASSERTION），使用前请查看仓库的许可证。
• !只有 Claude Code 和 Codex 是稳定支持的宿主，其他代理集成为实验性或遗留适配器。
• !可选的嵌入式边车进程预热后可能占用约 1-2 GB 内存。

收录于专题

标签

常见问题

haft 是什么？

为 AI 编码智能体提供本地项目记忆与治理层，记录问题、方案比较、人工决策和过期证据。 Haft 是一个本地治理层，为 Claude Code、Codex 等 AI 编码智能体提供持久的项目记忆。它记录项目正在解决的问题、比较过的方案、人工做出的决策以及支撑这些决策的证据。简单、可逆的推理可以留在对话中，而后续工作需要依赖的结果会写成类型化的项目记录，保存在本地 .haft/ 工件图中。

haft 可以免费使用吗？用的什么许可证？

haft 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

haft 还在维护吗？

半年内有更新。haft 最近一次提交是在 2026年9月28日。

haft 适合用来做什么？

记录架构选择的理由，供后续工作查阅和依赖 用多个并行假设排查故障，并保存结论以便交接 用当前测量结果检验过去的技术决策是否仍然成立 让 AI 辅助修改共享代码库时，权限始终由人工明确授权

haft 怎么安装和运行？

运行 README 中的官方安装脚本 为你的编程代理初始化项目（此处以 Claude Code 为例；其他宿主见 README）: haft init --claude 重启或重新连接你的编程代理，然后正常使用，需要时调用 /h-reason

在哪里获取 haft？

源代码和安装说明在 GitHub 上：https://github.com/m0n0x41d/haft