看完代码先留几条批注,再一起交给终端里的工具
总览页能把修改连起来看以后,下一件想做的事就很自然了:看到这里有问题,先记下来,全部读完再一起处理。
以前只能在脑子里记行号,或者边读边往终端输入。前者容易忘,后者会打断阅读。所以 alpha.12 给砚加了本地评审批注,沿着 Mayoi 的交互做了一次适配。
一条批注,要带上当时看到的代码
在已保存文件、工作区 diff、暂存区 diff 或历史提交里,选中几行,就能添加批注。没选范围时,用光标所在行。
只存“第 42 行有问题”是不够的。前面插入几行,第 42 行就换人了;并排 diff 又可能把长行裁掉,屏幕上看到的还不是完整内容。
所以批注保存原始引用、对应侧的坐标和 diff 摘录。即使屏幕只显示半行,导出的反馈也保留整行。选区恰好停在下一行开头时,不把那一行误算进去。
这些信息看似啰嗦,但过一会儿再回来看,才知道自己当时为什么留这句话。
代码动了,批注怎么办
引用的那些行还在,就跟着它们移动;原文找不到了,标成过期,保留当时的内容。
我没有让它悄悄换成附近“看起来差不多”的代码。批注里的旧话可能还成立,也可能已经解决,需要人再看一眼。
源文件边上和概览条里能看到标记,diff 里直接显示批注卡片。可以逐条跳转、修改、复制、删除,也可以打开整个项目的批注列表。删除和清空都能撤销,没送出去的批注随项目保存。
历史提交里的意见也保留在对应历史内容上,不会因为现在打开了同名文件,就贴到当前代码里。
送给刚才那个终端,先别替我按回车
读完以后,可以把所有批注整理成带相对路径和代码引用的文本,送到当前项目里最近获得焦点的终端。底部面板和编辑区终端标签都能接。
这里最重要的动作其实是少做一步:只粘贴,不提交。文字先留在输入区,让人最后看一遍。
多行文本也不能直接往普通 shell 里塞。接收终端需要开启 bracketed paste;条件不满足,就复制到剪贴板,原批注继续留着。发送成功才清空列表,而且这次清空可以撤销。
“发送成功”的意思也只到输入队列为止。终端里的工具有没有理解、有没有执行,是后面的事。
用真实 shell 检查有没有误执行
这一块不能光靠看界面。原生验证把多行反馈送进编辑区的真实 shell,检查文本到达,同时确认用于探测执行的标记文件没有产生。测试用独立配置和应用副本,不碰日常工作区。
还有一些不显眼的用例:上一个项目的终端不能接收,关掉的终端不能再用,复制出来的代码围栏不能被代码自身的反引号截断。
做到这里,审查过程终于可以先集中在代码上。要改的地方留在原处,读完再一起交出去,不用一边翻 diff 一边重新描述“刚才那个文件的那几行”。
下载试用
本文功能进入 v0.1.0-alpha.12,可以下载对应版本体验。
下载地址核对于 2026-10-19。安装包适用于 macOS 13+、Apple Silicon,目前尚未 Apple 公证,首次打开说明见发布页。
仓库留档
- 实现与设计:docs/review-comments.md、core/review/review.go、core/app/review.go、ui/gui/review.go。
- 测试入口:core/review/review_test.go、core/app/review_test.go、ui/gui/review_native_test.go。本轮只核对源码、历史报告与发布信息,没有重跑产品测试或安装包。