03. 给助手上下文
粘贴与片段
大段粘贴不该淹没输入栏。Matcha CLI 会把它折成可再打开的片段。
概念
短粘贴落成普通文字。四行及以上（紧凑模式下两行及以上），或大于 10 KB 的粘贴，会变成一个整块片段：
[Pasted: 12 lines]
[Pasted: 24 KB]
[Pasted: 1.0 MB]普通多行粘贴用行数做标签；内容一旦变大，即使行数很多，也改用十进制大小（1000 进位的 KB / MB）。
全文仍在输入栏里。片段是折叠，不是丢弃。发送时，助手收到完整粘贴。
为何重要
错误日志、diff 和 JSON 大段是有用的上下文，却是糟糕的草稿文字。片段让输入栏保持可读，让你能核对贴了什么，同时仍发送每一行。
内容已在剪贴板时，粘进输入栏。内容已在仓库里时，用 @。
如何粘贴
| 操作 | macOS | Linux | Windows |
|---|---|---|---|
| 从剪贴板粘贴 | Cmd+V | Ctrl+V | Ctrl+V |
| 截图 /「复制图像」 | Cmd+V | Ctrl+V | Alt+V（见「图片」） |
不少终端还有自己的粘贴组合键（Shift+Insert、右键）。它们以括号粘贴到达，走同一条片段路径。
在 Linux X11 / XWayland 上，Ctrl+V 读取 CLIPBOARD（显式复制）。未改键的中键点击在设置了 DISPLAY 时读取 PRIMARY（当前鼠标选区）。SSH 时优先用终端的 Shift+Insert，让本地终端送出文字。
重新打开片段
| 光标位置 | Enter | 再粘贴同一段文字 | 双击 |
|---|---|---|---|
| 在片段上 | 展开为原文 | 展开 | 展开 |
| 紧挨片段之后（粘贴后光标通常在这里） | 发送当前输入 | 展开 | 展开（点击会先落到片段上） |
光标在片段上或紧随其后时，会显示粘贴内容的预览。提示与表一致：Enter 会展开时显示 enter；Enter 会发送时显示 paste again。
「再粘贴」仅在新粘贴与片段逐字节相同（Matcha CLI 会按部分终端的方式规范化裸
换行）时展开。不同的粘贴会插入第二个片段。光标离开片段后再贴同一段文字，也会插入第二个片段。
重复粘贴与分段粘贴
Windows 和部分终端可能把一次粘贴拆成几批。短粘贴末尾的换行会留在缓冲区里，好让这几批正确拼上，而不是丢掉空行。
空剪贴板内容会被忽略。