开发者作品 · 看懂模型改了什么
Twain:把‘这里为什么这样改’留在代码旁边
模型交来一批代码,人的问题怎样准确传回去?这个 Git 差异查看器把文件对照、逐行评论与代理可读的命令行接在一起,也暴露了本地协作和版本变化的边界。
Twain 的 v0.1.0、v0.1.1 原发行时间分别为 10 月 14 日与 16 日 UTC,北京时间为 15 日与 17 日。本文于 10 月 18 日核对作者原图、发行附件与固定代码 1f9150e5;最新源码和已发布安装包分开描述。本站没有安装运行 GTK 客户端,也没有用它指挥模型修改项目。

先把一批修改放在眼前
AI 一次改动多个文件时,人先要找到变化之间的联系。Twain 沿用类似 Meld 的左右对照,把一个 Git diff 的文件依次放进同一视图,左边的文件树负责跳转;可以只看修改处,也可以逐步展开未改动部分,搜索范围覆盖整批修改文件。这样既能找到某一行,也能回看它周围的上下文。
当前源码还接受类似 git diff 的修订和路径参数,例如比较两个修订,或只聚焦指定文件。这个扩展来自 10 月 18 日的提交;10 月 16 日 UTC 发行的 v0.1.1 不能自动继承之后的源码变化。选择安装包还是跟进源码,会影响实际能用到什么。
来源与延伸阅读
- Twain · 本轮固定源码与 README作者代码 · GPL-3.0固定于 1f9150e5281fc0c5659f7380f3a11f3cbadf1e09;README 的能力声明与代码实现一起核对,不把主分支更新当成旧安装包能力。
- 作者页面与界面原图作者展示 · 非本站实测界面原图展示 Git 两个修订的对照,没有展示一轮真实人机评论往返。
- 本轮源码更新:修订与路径筛选原提交 · 2026 年 10 月 18 日当前源码扩展类似 git diff 的参数和路径聚焦;最新稳定发行仍是 v0.1.1。
把问题留在具体的行,而不是另发一段模糊描述
作者给出的入口很轻:选中一行或一组行,按 C 或右键留下评论。代理不必靠看截图猜位置,可以用 twain comment list --json 读取线程、用 reply 回复,再由人回到同一个位置核对。‘这里的空值分支是否漏了?’就能和对应代码一起保存。这是使用方式的例子,不是本站运行过的修复记录。
命令行还支持作者筛选、未解决线程和 watch 等待变化。行号从 1 开始,默认指工作区文件而非 diff 上显示的旧行;已删除的行要按 --old 的约定处理。要让代理参与,先让它读当前版本的 twain comment --help,比把旧截图行号直接粘给它更准确。
来源与延伸阅读
- Twain · 本轮固定源码与 README作者代码 · GPL-3.0固定于 1f9150e5281fc0c5659f7380f3a11f3cbadf1e09;README 的能力声明与代码实现一起核对,不把主分支更新当成旧安装包能力。
- 评论命令与行号约定原代码 · 输入输出契约list/add/reply/resolve/watch;行号从 1 开始,默认指工作区新文件,删除行另用 --old。
- 评论保存、线程与行位置变化原代码 · 本机状态SQLite 以仓库根路径、文件路径和 ID 组织记录;图形窗口与 CLI 共享状态,不等于远程托管协作。
评论能跟着代码移动,但仍有失去上下文的时候
评论与回复存在本机 SQLite,按仓库根路径、相对文件路径和 ID 区分,图形窗口与命令行共享这份状态。代码保存被评论行的内容,用来在文件变化后寻找位置;相关行消失或不再匹配时,会报告 outdated。这个提示有用,因为一次修订之后,昨天评论指向的代码未必还在。
因此,resolve 只是把线程标成已解决,不会证明程序正确。也不能把同机窗口间共享,理解成评论已经随 Git 提交同步到另一台电脑或 GitHub。人的下一步仍是重看最新差异、核对问题是否被回答,并运行适合该项目的检查。模型回复、线程状态和软件行为是三件事。
来源与延伸阅读
- 评论命令与行号约定原代码 · 输入输出契约list/add/reply/resolve/watch;行号从 1 开始,默认指工作区新文件,删除行另用 --old。
- 评论保存、线程与行位置变化原代码 · 本机状态SQLite 以仓库根路径、文件路径和 ID 组织记录;图形窗口与 CLI 共享状态,不等于远程托管协作。
它补的是审阅环节,能否少返工仍待实际使用
目前发布附件面向 Linux 的 x86_64 和 aarch64,另有 Flatpak;源码构建需要 GTK 4、GtkSourceView 5 和 libadwaita。项目使用 GPL-3.0。README 明确列出尚未提供合并、三方比较、其他版本控制系统和直接编辑文件等功能,不能把它当完整 IDE 或自动审查器介绍。
晨轮整理的 Anthropic 工作研究已经提出一个问题:生成更快以后,复核工作去了哪里?Twain 给出一个具体作品层面的回应——让人可以把判断和疑问传回到准确位置。我们仍需要看到真实项目中的完整往返、过期评论怎样恢复,以及审阅时间和返工怎样变化,才能判断它是否真的减轻了负担。
来源与延伸阅读
- Twain · 本轮固定源码与 README作者代码 · GPL-3.0固定于 1f9150e5281fc0c5659f7380f3a11f3cbadf1e09;README 的能力声明与代码实现一起核对,不把主分支更新当成旧安装包能力。
- v0.1.1 · 实际发行附件原发行记录 · 2026 年 10 月 16 日 UTCLinux x86_64、aarch64 二进制与 Flatpak;不能据源码可读就声称有 macOS/Windows 成品。
- 作者页面与界面原图作者展示 · 非本站实测界面原图展示 Git 两个修订的对照,没有展示一轮真实人机评论往返。