看完代码先留几条批注,再一起交给终端里的工具

看完代码先留几条批注,再一起交给终端里的工具

总览页能把修改连起来看以后,下一件想做的事就很自然了:看到这里有问题,先记下来,全部读完再一起处理。

以前只能在脑子里记行号,或者边读边往终端输入。前者容易忘,后者会打断阅读。所以 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 公证,首次打开说明见发布页。


仓库留档

相关推荐
云浪15 小时前
Go 并发实战:从零实现一个高并发安全的任务调度器
javascript·后端·go
敲代码的玉米C15 小时前
并排 diff、提交标签:砚的 Git 阅读体验又补了一轮
go
敲代码的玉米C15 小时前
给编辑器补拖拽:标签挪过去,状态也得跟过去
go
敲代码的玉米C15 小时前
写到这里,砚还要继续照着 IDE 加功能吗
go
敲代码的玉米C16 小时前
把终端拖进编辑区,别把正在跑的 shell 弄丢了
go
敲代码的玉米C16 小时前
给砚加一个「所有改动」页,提交前少来回点几次
go
我不会起名字3222 天前
微服务链路超时怎么设:逐层收敛的 4 条规则与 1 个反例
微服务·go·超时·熔断
我的div丢了肿么办2 天前
go语言安装包详细讲解
后端·go
我不会起名字3222 天前
Go 写 Kafka 消费者:sarama 的 3 个坑与优雅退出写法
kafka·消息队列·go·sarama