# 介绍 Despacer：复制，粘贴，完整无缺。

URL: https://www.mattsenter.com/zh/blog/introducing-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](https://github.com/MattSenter/despacer/issues) 中把那段文本发给我，帮助改进这些规则。

## 能在命令行里使用吗？

可以。同一个引擎也是一个命令行过滤器，可以用在脚本里，或者处理已经粘贴到别处的文本。先用 `swift build -c release` 构建，再运行 `pbpaste | .build/release/despacer | pbcopy`。加上 `--explain` 可以查看它用了哪种方法，加上 `--no-transcripts` 则只使用折行规则。

## 从哪里获取 Despacer

Despacer 支持 macOS 14 Sonoma 及更新版本，提供九种语言。它采用 MIT 许可证免费提供，没有任何需要购买或解锁的内容。

详细说明见[简体中文版 README](https://github.com/MattSenter/despacer/blob/main/README.zh-Hans.md)，其中介绍了每一项设置、故障排除和卸载方法。想看更简短的介绍，可以访问 [Despacer 项目页面](https://www.mattsenter.com/zh/projects/despacer)。

[在 GitHub 获取 Despacer](https://github.com/MattSenter/despacer)
