init-co-jp/diff-tour

如果你要评审或接手一段从 diff 里看不出意图的改动，tour 值得一试。它目标单一、流程清楚，成本也交代得比较实在，但依赖你已经配好并登录的编程 CLI，产出是耗时数分钟、由大模型写成的讲解，而非确定性的结果。

解决什么问题

评审之前，你通常想先弄明白：这次改动是为了什么、风险集中在哪里、哪些没被改到的周边文件也值得看。直接读 diff 回答不了这些问题，因为 diff 只显示行，不显示意图和上下文。自己翻文件、还原推理过程又很慢，尤其是别人的代码或 AI 写的代码。diff-tour 换掉的正是这一步：你选择一个分支、单个 commit 或区间，然后用 → 和 ← 逐步浏览一份按顺序组织的讲解。结果是若干屏内容，说明改动目的、指出该跳到哪些文件，并提出评审时值得想的问题。

有什么不同

它的机制值得了解，因为这同时决定了收益和代价。tour 会把 base 和 head 两个 commit 归档，取出 diff 和 commit message，把该目录交给某个以只读权限运行的编程 CLI，让模型以 JSON 形式写出讲解。随后工具会校验 JSON 指向的每个文件和行，发现不对就让模型只修那一处，最多两次。屏幕上显示的代码始终从对应 commit 的 git 中读取，而不是照抄模型的回复；每一步还能展示流程图、数据库 schema，以及标注为 Example、并不在仓库里的示例代码。校验加 git 取码是它真正的差异点，能降低讲解指错行的概率。

代价是讲解内容本身由大模型生成。README 明确说一次要 2 到 5 分钟，因为模型会读改动周围的文件而不只是 diff。约 250 行的改动，在 Claude Code 套餐上按 API 价格折算约 1.00 到 1.50 美元。保存的讲解再次打开不花钱，也能以 JSON 分享，但重新打开只是读取快照，不会对照之后的 commit 重新校验。

谁值得试

适合：面对新功能、重构或需要接手的 AI 生成代码，而 diff 里看不出「为什么」的评审者；也适合刚接触陌生分支的人，或想给同事做一份可分享说明的团队。不适合：一行就能看完的修复（README 自己说这时直接读 diff 更快），以及不能把仓库文件发给外部大模型的环境。文档中的安装路径都要求 git 加已登录的 Claude Code、Codex、Gemini、OpenCode 2 或 Copilot CLI，没有离线或本地模型的路径，这一条基本决定了谁能用。

使用条件与边界

硬性前提是 git 和上述编程 CLI 之一，且已安装并登录；README 给出了每个 CLI 的版本检查和登录命令。模型会收到两个 commit 下被跟踪的文件、diff、commit message 和提示词，游览未提交改动时还包括未被忽略的未跟踪文件。这是实实在在的数据外发决定，不是脚注。安装可选 curl 脚本、go install（Go 1.27+）或 PowerShell 方式，但 Windows 明确尚未测试。日常维护意味着保持所选 CLI 处于登录状态，并在分支变化后重新生成讲解；保存的讲解文件是快照，不是实时视图。README 自述讲解格式和界面仍属早期、可能变化，schema 渲染目前只支持 SQLite migration。

HotRepo 点评

HotRepo 在 2026-10-24 记录到 296 个总 star、新项目榜第 15 名，此前没有历史数据；这只是这个 14 天新项目的一次快照，不是增长曲线，无法判断热度能否持续。采用前请对照自己仓库的敏感程度核对 README 的数据外发说明，因为整个流程都建立在把被跟踪文件交给所选 CLI 之上。

项目链接：README、示例讲解 JSON。