---
url: /wave-agent/specs/ui/long-text-placeholder.md
description: 用 `[LongText#ID]` 占位符替换粘贴的长文本，提交时展开
---

# 功能规格说明：长文本占位符

**创建日期**：2026-03-24

## 用户场景与测试 *（必填）*

### 用户故事：长输入占位符（优先级：P1）

作为用户，当我在输入框中粘贴一大段文本时，我希望它被替换为占位符，以便 UI 保持整洁和可控。

**为什么是这个优先级**：通过防止输入框被大量文本淹没来改善用户体验。

**独立测试**：将超过 200 个字符的字符串粘贴到输入框中，验证它被替换为 `[LongText#ID]` 占位符。

**验收场景**：

1. **假设**用户粘贴的文本超过 200 个字符，**当**粘贴事件被处理时，**则**文本必须被替换为 `[LongText#ID]` 占位符。
2. **假设**输入框中存在占位符，**当**用户提交消息时，**则**占位符必须在发送给 agent 之前展开为原始文本。

***

### 边界情况

* **多个占位符**：用户应该能够粘贴多个长文本块，每个都有唯一的 ID。
* **历史导航**：导航历史记录时，占位符应保留在输入框中，其原始文本应正确映射。
* **混合内容**：占位符与其他文本、图片或斜杠命令混合时应正常工作。

## 假设

* 用户更喜欢整洁的 UI，而不是看到大块的粘贴文本。
* 200 个字符的阈值是"长"文本的合理限制。