[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"$f265fn32h4w3px":3},{"code":4,"message":5,"data":6,"timestamp":34},10000,"success",{"full_name":7,"position":8,"description":9,"language":10,"stars":11,"forks":12,"stars_gained":13,"age_days":14,"hn_threads":15,"one_liner":16,"summary_md":17,"topic":18,"github_topics":21,"license":30,"homepage":31,"updated_at":32,"history":33},"init-co-jp\u002Fdiff-tour",15,"Walk through a diff the way a senior engineer reads it. A read-only TUI that turns a git change into a guided tour.","Go",296,22,21,14,[],"把一次 git 改动变成由大模型撰写、可逐步浏览的讲解，帮助工程师理解改动的来龙去脉。","如果你要评审或接手一段从 diff 里看不出意图的改动，`tour` 值得一试。它目标单一、流程清楚，成本也交代得比较实在，但依赖你已经配好并登录的编程 CLI，产出是耗时数分钟、由大模型写成的讲解，而非确定性的结果。\n\n## 解决什么问题\n\n评审之前，你通常想先弄明白：这次改动是为了什么、风险集中在哪里、哪些没被改到的周边文件也值得看。直接读 diff 回答不了这些问题，因为 diff 只显示行，不显示意图和上下文。自己翻文件、还原推理过程又很慢，尤其是别人的代码或 AI 写的代码。`diff-tour` 换掉的正是这一步：你选择一个分支、单个 commit 或区间，然后用 → 和 ← 逐步浏览一份按顺序组织的讲解。结果是若干屏内容，说明改动目的、指出该跳到哪些文件，并提出评审时值得想的问题。\n\n## 有什么不同\n\n它的机制值得了解，因为这同时决定了收益和代价。`tour` 会把 base 和 head 两个 commit 归档，取出 diff 和 commit message，把该目录交给某个以只读权限运行的编程 CLI，让模型以 JSON 形式写出讲解。随后工具会校验 JSON 指向的每个文件和行，发现不对就让模型只修那一处，最多两次。屏幕上显示的代码始终从对应 commit 的 git 中读取，而不是照抄模型的回复；每一步还能展示流程图、数据库 schema，以及标注为 Example、并不在仓库里的示例代码。校验加 git 取码是它真正的差异点，能降低讲解指错行的概率。\n\n代价是讲解内容本身由大模型生成。README 明确说一次要 2 到 5 分钟，因为模型会读改动周围的文件而不只是 diff。约 250 行的改动，在 Claude Code 套餐上按 API 价格折算约 1.00 到 1.50 美元。保存的讲解再次打开不花钱，也能以 JSON 分享，但重新打开只是读取快照，不会对照之后的 commit 重新校验。\n\n## 谁值得试\n\n适合：面对新功能、重构或需要接手的 AI 生成代码，而 diff 里看不出「为什么」的评审者；也适合刚接触陌生分支的人，或想给同事做一份可分享说明的团队。不适合：一行就能看完的修复（README 自己说这时直接读 diff 更快），以及不能把仓库文件发给外部大模型的环境。文档中的安装路径都要求 git 加已登录的 Claude Code、Codex、Gemini、OpenCode 2 或 Copilot CLI，没有离线或本地模型的路径，这一条基本决定了谁能用。\n\n## 使用条件与边界\n\n硬性前提是 git 和上述编程 CLI 之一，且已安装并登录；README 给出了每个 CLI 的版本检查和登录命令。模型会收到两个 commit 下被跟踪的文件、diff、commit message 和提示词，游览未提交改动时还包括未被忽略的未跟踪文件。这是实实在在的数据外发决定，不是脚注。安装可选 curl 脚本、`go install`（Go 1.27+）或 PowerShell 方式，但 Windows 明确尚未测试。日常维护意味着保持所选 CLI 处于登录状态，并在分支变化后重新生成讲解；保存的讲解文件是快照，不是实时视图。README 自述讲解格式和界面仍属早期、可能变化，schema 渲染目前只支持 SQLite migration。\n\n## HotRepo 点评\n\nHotRepo 在 2026-10-24 记录到 296 个总 star、新项目榜第 15 名，此前没有历史数据；这只是这个 14 天新项目的一次快照，不是增长曲线，无法判断热度能否持续。采用前请对照自己仓库的敏感程度核对 README 的数据外发说明，因为整个流程都建立在把被跟踪文件交给所选 CLI 之上。\n\n项目链接：[README](https:\u002F\u002Fgithub.com\u002Finit-co-jp\u002Fdiff-tour\u002Fblob\u002Fmain\u002FREADME.md)、[示例讲解 JSON](https:\u002F\u002Fgithub.com\u002Finit-co-jp\u002Fdiff-tour\u002Fblob\u002Fmain\u002Ftours\u002Fexample-coupons.en.json)。",{"slug":19,"name":20},"developer-tools","开发工具",[22,23,24,25,26,27,28,29],"cli","code-review","git","go","learning","llm","onboarding","tui","MIT",null,"2026-10-25T03:23:39Z",[],1792912609]