一个开源工具「知返 AhaDiff 」：把 AI 写的每次改动都给你讲清楚，让你 vibe coding 时不再无脑点继续

我用 AI 写代码经常是这样：用 ai 写出一大段代码，我大致看一眼，回复继续；只要没出错就一直继续。如果报错或者不符合我的需求就把问题告诉 ai ，进行改动。项目完成了，各个功能都正常运行了，跑得也不错。可是有个问题，假如你回头问我「这个地方为什么这么写」，很大可能是一脸懵逼的状态，因为 ai 替我完成了 90%以上的代码改动。

并且在论坛中我经常看到类似的讨论，很多人都提及了这个问题：通过 vibe coding 指挥 AI 把活干了，效率确实高，可一个项目做完，自己好像没怎么长进，没有从中学到真东西。

我想要的其实很简单：AI 写完之后，有个东西能把这次改动给我讲清楚，为什么要这么改，这么改的作用何在，并且把这次改动的知识进行内化，形成自己脑子中的知识，于是就开发了知返这个项目。

它就干一件事：把 ai 的改动变成能查证的笔记，能让你学到真知识

知返通过读你的一次代码改动，把它变成一份完整的学习材料：形成一篇完整的「改了什么、为什么这样修改」的课程，一份每条结论都标了出处的清单。同时附带完善的测验和带复习周期的复习卡片，通过复习曲线设置，一遍遍的重复，避免相关知识的遗忘，而不仅仅只是展现相关改动的相关知识点。

运行面板：每学一次就多一条记录，带评分和质量趋势

并且为了避免 ai 的幻觉问题：笔记里每一句话，都要绑到某个文件的某一行代码上，再附带这个学习笔记对应的一个状态：

• verified 有据可查
• weak 证据偏弱
• not_proven 没验证到
• contradicted 和代码对不上
• rejected 被否决

课程页：AI 把这次改动的相关知识点展现给你看

差异页：左边是代码 diff ，右侧的 claim 卡片点开，会跳转到对应 diff ，同时能看到这次改动对应的知识点

光看知识点还不够，那么我们学习完成之后测试你真的会了吗，并且根据 fsrs 算法，会加入之前做过的测验题

看懂了 lesson 的笔记知识点，不代表你真的会了，并且会用了，所以学习完课程之后还附带了测验和复习卡片。

测验是 通过选择题的方式呈现给你，可在 settings 中动态设置测验题的数量。

每道题答题完成之后，能看这道题对应的知识点，以及这道题经常出错的地方

测验页：以选择题的形式呈现，答完才显示这道题目对应的代码改动

复习用的是间隔重复，就是 Anki 复习卡片那套思路，背后是 FSRS 算法。学过的东西会按遗忘曲线，在合适的时间点加入到复习部分让你再过一遍，避免看一遍就忘的情况。

复习页：到期的卡片按 Again / Hard / Good / Easy 评分

测验和复习还嫌不够的话，再来个 Challenge （ opt-in 的进阶玩法）：它把某次改动做成一道挑战，让你自己先过一遍，再拿你的结果和真实 diff 逐条比对，把你漏掉、没掌握的地方挑出来，然后反馈到复习中。对着某个 run id 跑 ahadiff challenge build <run_id>，就能在 webui 中体现。

学得多了，知识会自己连成网，形成真正的概念图谱

借鉴了 llm-wiki 和 graphify 的思路。

同一个概念在好几次改动里反复出现，知返会把它们收集起来，连成一张概念图谱。

概念图谱：横跨多次改动的知识地图

每次学习都打分，能看出自己在不在进步

每跑一次，知返会从准确性、证据、覆盖率等八个维度打个 0 到 100 的分，判定这次学习算不算合格。你也可以另开一个模型当「第二评委」复核一遍，不过它只是参考，不会推翻判定。分数是透明的，点开能看到每一个维度的评分细节。

运行详情：八个维度的评分明细

觉得某次讲得还不够好？让它重学几遍，分数更高才留

打完分，你可能会觉得某次讲得还不够透，想让它再讲好一点。improve-run 能够解决这个问题。

对着某次 run 跑 ahadiff improve-run <run_id>，它会在你自己的项目里，拿这次改动把课程用更高质量重新生成几遍（默认 3 遍，专门盯着上次得分最低的那一维改进），再进行一次重新打分。只有新生成的分数确实比原来高，才会留下来。

整个改进过程它不碰 git 、不改 prompt 、也不覆盖你原来那条已经保存的记录。

怎么用：先装上，然后基本就两条命令

现在已经可以直接从 pip 安装：

pip install ahadiff

装好并配好 provider 之后，核心就两步：

# 学一次最近的改动
ahadiff learn HEAD~1..HEAD

# 打开本地网页，看笔记、做测验、复习
ahadiff serve

serve 会提供 webui ，供你学习。想学暂存区里还没提交的改动，就 ahadiff learn --staged。改动从哪来都行：最近的提交、暂存区、补丁文件、两个目录的对比，一共支持十种来源，不仅仅是从 git diff 中进行学习。

几个让你省心的点：

• 你的代码 diff 默认不外传。隐私默认是 strict_local，diff 和代码都待在你本机；想用远端模型，得你自己显式打开，建议调成脱敏远端模式，日常使用更加方便。
• 用你自己的 key（ BYOK ），支持八种 AI 服务格式。如果不想使用 api ，避免隐私泄露的情况，也支持接入本地的 LM Studio 或 Ollama 。
• 能导出成 Anki 卡片，复习完成后还能导出为 anki 卡片，接入自己日常使用的 anki 软件。
• 能给 AI 助手写本地规则和 skills。如果你希望 Claude 、Codex 、Cursor 、Copilot 、Gemini 这些工具也知道怎么使用知返，可以在项目里运行 ahadiff install --detect，再按需要执行 ahadiff install codex 或 ahadiff install claude。它写的是项目本地指引，不会把代码上传出去。
• 改动太大也不怕撑爆模型。默认会按你选的模型上下文，自动算出这次最多捕获多少 diff （综合模型上下文、输出预留和中文 diff 的密度），不会一股脑全塞进去；想自己定也行，在 settings 里切成手动模式。
• 懒得每次手动跑。ahadiff watch 能盯着你的仓库，文件一改就自动触发 learn ，适合边 vibe coding 边顺手把这次改动学掉。

设置页：填 key 、选模型、调隐私和捕获上限，都在这

部分限制

• 现在已经发布到 PyPI ，直接 pip install ahadiff 即可。源码安装主要给贡献者开发时使用：uv tool install --editable .。

• 默认功能不需要额外安装；只有 FSRS 参数自动优化这种重依赖能力需要单独装 pip install 'ahadiff[optimizer]'。

• Windows 上核心的 learn 和 serve 均可使用；但是需要注意的是，个别功能（比如 --compare-dir 目录对比）目前只在 macOS / Linux 上支持。

链接

• GitHub：https://github.com/AGI-is-going-to-arrive/ahadiff
• 项目主页：https://agi-is-going-to-arrive.github.io/ahadiff/

演示视频（中文，带字幕）：

https://www.bilibili.com/video/BV1b57k6yEWm

如果你也常有「这代码是 AI 写的，我想从中学到真东西」这种想法，欢迎尝试👏。

让你从每次 vibe coding 中学到真东西，而不只是无脑确认/继续。

觉得有用的欢迎给这个项目点个✨

有问题的或者觉得可以改进的地方的欢迎提 pr 和 issues 。