메뉴
CLI agent 大文本粘贴处理机制。当用户询问"粘贴大量文本怎么处理"、"输入框粘贴"、"paste handling"、"large text input"、"多行输入折叠"、"bracketed paste"时使用。也适用于实现粘贴折叠、引用展开、终端兼容性处理等功能。触发词：粘贴、paste、大文本、折叠、collapse、bracketed paste、终端兼容。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | cli-input-paste-handling |
| description | CLI agent 大文本粘贴处理机制。当用户询问"粘贴大量文本怎么处理"、"输入框粘贴"、"paste handling"、"large text input"、"多行输入折叠"、"bracketed paste"时使用。也适用于实现粘贴折叠、引用展开、终端兼容性处理等功能。触发词：粘贴、paste、大文本、折叠、collapse、bracketed paste、终端兼容。 |
用户粘贴大量文本到 CLI 输入框时，需要解决：
| 路径 | 触发条件 | 实现位置 |
|---|---|---|
| Bracketed Paste | 终端支持 \x1b[200~ ... \x1b[201~ | handle_paste 事件处理器 |
| Fallback 检测 | 不支持 bracketed paste 的终端 | _on_text_changed 回调 |
# config.yaml
paste_collapse_threshold: 5 # 行数阈值
paste_collapse_char_threshold: 2000 # 字符数阈值
paste_collapse_threshold_fallback: 5 # Fallback 模式的行数阈值
触发条件（满足任一即折叠）：
line_count >= threshold（默认 5 行）len(text) >= char_threshold（默认 2000 字符）not buf.text.strip().startswith('/')）用户粘贴
↓
handle_paste(event)
├─ 规范化换行：\r\n → \n, \r → \n
├─ 清理泄漏标记：_strip_leaked_bracketed_paste_wrappers()
├─ 清理鼠标报告：_strip_leaked_terminal_responses_with_meta()
├─ 纯图片粘贴？→ _should_auto_attach_clipboard_image_on_paste()
├─ 清理 surrogate 字符
└─ 判断是否折叠
├─ 超阈值 → 保存到文件，插入占位符
└─ 未超阈值 → 直接插入 buf.insert_text()
当终端不支持 bracketed paste 时，通过 _on_text_changed 检测：
def _on_text_changed(buf):
# 两种启发式（满足任一即判定为粘贴）：
# 1. chars_added > 1 — 终端一次性交付所有字符
# 2. newlines_added >= 4 — 终端逐字符交付但批量换行
is_paste = chars_added > 1 or newlines_added >= 4
if (lines_hit or chars_hit) and is_paste and not text.startswith('/'):
# 折叠处理
[Pasted text #1: 10 lines → C:\Users\29924\.hermes\pastes\paste_1_143052.txt]
文件路径：~/.hermes/pastes/paste_{counter}_{HHMMSS}.txt
用户提交输入时，_expand_paste_references 将占位符替换回完整内容：
def _expand_paste_references(self, text: str | None) -> str:
"""Expand [Pasted text #N -> file] placeholders into file contents."""
paste_ref_re = re.compile(r'\[Pasted text #\d+: \d+ lines \u2192 (.+?)\]')
def _expand_ref(match):
path = Path(match.group(1))
try:
return path.read_text(encoding="utf-8")
except (OSError, IOError):
return match.group(0) # 文件丢失则保留占位符
return paste_ref_re.sub(_expand_ref, text)
调用位置：
cli.py:14403）cli.py:4590）prompt_toolkit 的 Vt100Parser.feed() 在等待 \x1b[201~ 结束标记时可能永远卡住（终端 race、SSH 断连等）。Hermes 的补丁：
def _apply_bracketed_paste_timeout_patch():
_BP_TIMEOUT_S = 2.0 # 最多等 2 秒
def _patched_vt100_feed(self_parser, data):
if self_parser._in_bracketed_paste:
# 超时后强制 flush 为 BracketedPaste 事件
if now - bp_start > _BP_TIMEOUT_S:
paste_content = self_parser._paste_buffer
self_parser.feed_key_callback(
_PtKeyPress(_PtKeys.BracketedPaste, paste_content)
)
终端解析失败时，bracketed paste 标记可能泄漏为字面文本：
def _strip_leaked_bracketed_paste_wrappers(text: str) -> str:
text = text.replace("\x1b[200~", "").replace("\x1b[201~", "")
text = text.replace("^[[200~", "").replace("^[[201~", "")
# 处理降级形式
text = re.sub(r"(^|[\s\n>:\]\)])\[200~", r"\1", text)
text = re.sub(r"\[201~(?=$|[\s\n<\[\(\):;.,!?])", "", text)
return text
TUI 使用 PasteSnippet 接口：
interface PasteSnippet {
label: string // 如 "Pasted text #1"
path?: string // 可选的文件路径
text: string // 粘贴内容
}
限制：
PASTE_SNIP_MAX_COUNT = 32（最多 32 个粘贴片段）PASTE_SNIP_MAX_TOTAL_BYTES = 4 * 1024 * 1024（总计 4MB）展开逻辑：
const expandSnips = (snips: PasteSnippet[]) => {
const byLabel = new Map<string, string[]>()
for (const { label, text } of snips) {
const hit = byLabel.get(label)
hit ? hit.push(text) : byLabel.set(label, [text])
}
return (value: string) =>
value.replace(PASTE_SNIPPET_RE, tok => byLabel.get(tok)?.shift() ?? tok)
}
占位符格式：[[Pasted text #1: 10 lines]]
/command 开头的输入Automate browser interactions, test web pages, work with Playwright tests, and operate browser-hosted terminals such as ttyd/xterm.js.
Navi Agent 设计参考库。当用户询问 navi agent 的架构设计、功能方案、技术选型、或某个具体实现应该如何做时，自动参考 Claude Code (cc_src/)、KIMI-CLI (kimi-cli/)、Hermes (hermes-agent/) 三个成熟项目的源码来提供建议。触发场景包括：讨论 agent loop 设计、工具系统、审批机制、会话管理、UI/CLI 交互、技能系统、插件机制、subagent、MCP 集成等任何 navi 的功能设计问题。也适用于：添加新工具、修改工具行为、集成外部 API。也适用于：多智能体系统设计、Worker 模式、sub_agent 委派模式、Interactive SubAgent 模式、Human-in-the-Loop 模式。也适用于：LangGraph 功能评估、工具调用兼容性分析、模型适配方案选型。
CLI agent 工具输出架构设计与调试。当排查工具输出重复、输出丢失、输出乱序、实时流与结果渲染冲突、输出截断策略等问题时使用。也适用于为新的 CLI agent 工具设计输出通道。触发词：工具输出重复、output twice、双份输出、流式输出、tool result rendering、输出截断、truncat。
Navi Agent 工具开发指南。当需要为 Navi 添加新工具（tool）、修改已有工具、或理解工具注册机制时使用。触发场景：用户说"写一个 XX 工具"、"添加工具"、"tool 怎么写"、"注册工具"、涉及 tool.py 或 runtime.py 中工具注册部分的修改。也适用于：集成外部工具协议（MCP 等）、添加工具子系统、批量注册动态发现的工具。也适用于：添加或修改斜杠命令（/xxx）、斜杠命令子命令。
演示文稿创建、编辑和分析。当用户需要处理 PowerPoint 演示文稿（.pptx 文件）时使用，包括创建新演示文稿、修改内容、处理布局、添加批注或演讲者备注等。也适用于将 guizang-ppt HTML 转换为 PPTX。也适用于基于 Word/文本文档生成学术汇报 PPT（docx→PPT），包含中文学术 PPT 配色方案、卡片布局、条形图、表格等常用模式。触发词：做PPT、做个PPT、演示文稿、slides、presentation、汇报PPT。
Discover agent-native CLIs for professional software. Access the live catalog to find tools for creative workflows, productivity, AI, and more.