Matt Senter
现在项目关于联系博客

← Blog

介绍 Despacer:复制,粘贴,完整无缺。

2026年10月23日 · Matt Senter · 更新于 2026年11月8日

在 Despacer 标题下,断开的橙色代码行汇成一条连续的薄荷绿线。

简短版本

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 需要从源码构建安装,大约需要一分钟。

  1. 如果还没有 Apple 的命令行工具,先安装:xcode-select --install。
  2. 克隆仓库并运行 ./build.sh --install。它会构建 Despacer.app,复制到「应用程序」文件夹并打开。
  3. 在设置窗口的「系统」中打开「登录时打开」,让 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 项目页面。

在 GitHub 获取 Despacer

Matt Senter

Matt Senter

Founder, entrepreneur, and CEO based in Durham, NC, with 30 years building software and 18 companies and products founded. Currently Founder & CEO of Senternet and Co-Founder, COO, and CTO of BeeReady, and the builder behind Orgabot, Highwire, StockCar, Premail, Comoji, Burly, and Weatherling. More about Matt · Get in touch.

本页内容

  • 为什么从 Claude Code 和 Codex 复制的长命令粘贴后是断的?
  • Despacer 是怎么修复一次复制的?
  • 如何安装和设置 Despacer?
  • Despacer 不做什么
  • 能在命令行里使用吗?
  • 从哪里获取 Despacer

继续阅读

  • 介绍 CommandH:把最后一个应用也隐藏起来在 Mac 上,Cmd+H 会隐藏当前应用,但应用仍在运行。CommandH 是我开发的免费开源应用,让 Cmd+H 也能隐藏最后一个可见应用。
  • App Store 4.3 拒绝:先上架的 App 真的更有优势吗?App Store 的 spam 规则会让先上架的 App 占优势吗?Dumpling 被 4.3 拒绝,引出了关于差异化、申诉和独立分发的问题。
  • Weatherling 登上 Mac App Store 实用工具榜第八名。一切从雨开始。发布仅四天,Weatherling 就凭口碑登上美国 Mac App Store 实用工具榜第八名。这是我开发这款桌面天气应用的故事。

更多关于独立软件的文章 →

这篇文章讲的是 Despacer。 阅读 Despacer 的案例研究 →

© 2026 Matt Senter · 由 Senternet 的 Matt Senter 创建 Senternet使用 Orgabot 构建北卡罗来纳州达勒姆为创造者而建关于博客工具隐私条款
EnglishEspañol简体中文Français日本語PortuguêsDeutsch