简短版本
Despacer 是一款免费开源的 Mac 菜单栏应用,用来修复在终端中从 Claude Code 和 Codex 复制的长命令。这两个智能体会自己折行,插入真正的换行符和两个空格的缩进,所以复制的命令粘贴后是断开的,无法运行。Despacer 分两步修复来自终端的复制内容。折行规则会立即去掉缩进,把折行造成的换行重新接上。稍后,它会在 Claude Code 和 Codex 保存在 Mac 上的会话文件中查找复制的文本,一旦匹配,就把智能体写下的原始命令原样放进剪贴板。它不理会其他应用中的复制,不连接网络,不收集数据,只在内存中保留最近十次修复,供「撤销上次修复」使用。它需要 macOS 14 Sonoma 或更新版本,目前需要用一个脚本从源码构建安装。
我受够了从 Claude Code 或 Codex 复制命令,粘贴到终端后却发现命令被拆散。这些换行并不只是显示效果,它们也被一起复制了。
于是我做了 Despacer,一款将折行命令重新拼好的小巧 Mac 菜单栏应用。照常复制粘贴即可。它会修复折行,还能从本地智能体会话历史中找回原始文本。
它免费开源,采用 MIT 许可证。没有网络访问,没有分析追踪,也不收集数据。如果修复有误,「撤销上次修复」可以恢复原来的复制内容。
为什么从 Claude Code 和 Codex 复制的长命令粘贴后是断的?
Claude Code 和 Codex 自己绘制输出,而且都会先按终端宽度把长行折好,再打印出来。每一处折行都是一个真正的换行符,后面跟着两个空格的缩进。终端从来看不到一整行长命令,它看到的、复制的,都是一行行分开的文本。
所以终端的任何设置都解决不了这个问题,因为原始的行尾根本没有到达终端。README 里的例子是一条很长的 curl 命令,带着一个很长的下载 URL。复制出来是四行带缩进的文本,URL 从中间被截断,无法运行。
Despacer 是怎么修复一次复制的?
Despacer 每秒检查剪贴板 20 次,因为 macOS 没有剪贴板变化通知。如果复制来自终端应用,它会分两步修复。来自其他应用的复制,它一概不看。
第一步:折行规则,立即生效
它去掉两个空格的缩进和行尾的空白,再把所有因折行产生的换行重新接上:也就是下一个词放不进上一行而产生的换行。一个词如果长到一行放不下,说明它是从中间被截断的,这处换行会不加空格直接接上。其他所有换行都会保留,以反斜杠结尾的行也一样。这个结果会立刻放进剪贴板。
第二步:稍后进行精确匹配
在后台,Despacer 会在 Claude Code 和 Codex 保存在你 Mac 上的会话文件中查找复制的文本,查找时忽略所有空格和换行。它检查最近一天内活跃过的会话,从最新的开始。一旦匹配成功,它就把智能体写下的原始文本原样放进剪贴板,除非你在这期间又复制了别的内容。
大多数命令光靠折行规则就能修对。但有些换行确实无法区分,比如从一行中间开始的选区,这些情况由精确匹配来解决。
应用本身不到 1,400 行 Swift 代码,修复引擎大约 250 行,测试用例来自真实的断行复制。
如何安装和设置 Despacer?
目前,Despacer 需要从源码构建安装,大约需要一分钟。
- 如果还没有 Apple 的命令行工具,先安装:
xcode-select --install。 - 克隆仓库并运行
./build.sh --install。它会构建 Despacer.app,复制到「应用程序」文件夹并打开。 - 在设置窗口的「系统」中打开「登录时打开」,让 Despacer 随时待命。
较新版本的 macOS 会询问是否允许 Despacer 读取你复制的内容。请选择「允许」。如果你选了「不允许」,可以在「系统设置」>「隐私与安全性」>「从其他 App 粘贴」中更改。Despacer 的「权限」面板有一个直达该处的按钮。
之后就没有什么新东西要学了:选中命令,按 Cmd+C,然后粘贴。Despacer 内置支持 Terminal、iTerm2、Ghostty、Warp、kitty、Alacritty、WezTerm、Hyper、Tabby 和 Rio。在「终端」中,你可以添加其他应用,比如内置终端的代码编辑器,也可以取消勾选不想让它监视的应用。
Despacer 不做什么
Despacer 只做一件事,其他的一概不碰:
- 不读取终端列表以外的应用中的复制内容。
- 不改动从未断开过的文本,比如普通的终端输出。它只修复带有智能体所输出的两个空格缩进的文本,或者在它们的会话历史中逐字找到的文本。
- 不连接网络,没有账户、分析、崩溃报告或追踪。
- 从不修改、复制或上传智能体的会话文件。它只读取这些文件,而且「匹配会话历史」可以关闭这项功能。
- 不保存你的修复记录。最近十次修复只保存在内存中,方便你撤销,Despacer 退出后就会消失。
不过它仍然可能出错。没有精确匹配时,折行规则只能猜测。如果某次复制被错误地接在了一起,菜单栏中的「撤销上次修复」能恢复你复制时的原样,「修复」中的「最近的修复」会保留最近十次。如果这种情况反复出现,关闭「修复其他自动换行的文本」,让 Despacer 只修复它在会话历史中找到的内容,并在 GitHub Issue 中把那段文本发给我,帮助改进这些规则。
能在命令行里使用吗?
可以。同一个引擎也是一个命令行过滤器,可以用在脚本里,或者处理已经粘贴到别处的文本。先用 swift build -c release 构建,再运行 pbpaste | .build/release/despacer | pbcopy。加上 --explain 可以查看它用了哪种方法,加上 --no-transcripts 则只使用折行规则。
从哪里获取 Despacer
Despacer 支持 macOS 14 Sonoma 及更新版本,提供九种语言。它采用 MIT 许可证免费提供,没有任何需要购买或解锁的内容。
详细说明见简体中文版 README,其中介绍了每一项设置、故障排除和卸载方法。想看更简短的介绍,可以访问 Despacer 项目页面。
