TrueGrowth/docs/TEXT_PASTE_FEATURE.md

文本粘贴功能

功能概述

Opentu 现在支持智能文本粘贴功能，当你从外部复制文本并粘贴到画布时，系统会自动控制文本宽度，避免文本过长。

功能特点

1. 自动换行

• 当文本行超过 50 个字符时，自动换行
• 优先在空格处断行，保持单词完整性
• 如果空格位置不合适，则在最大字符数处强制断行

2. 智能断行

• 在空格处断行时，会检查空格位置是否在合理范围内（70% 以上）
• 避免在行首或行尾留下过短的单词片段
• 自动去除断行后的多余空格

3. 保留原有格式

• 保留原文本中的换行符
• 每个原始行独立处理，不会合并多行

技术实现

核心文件

• packages/drawnix/src/plugins/with-text-paste.ts - 文本粘贴插件
• packages/drawnix/src/plugins/with-common.tsx - 插件注册

配置参数

const TEXT_CONFIG = {
  /** 最大字符数（超过则换行） */
  MAX_CHARS_PER_LINE: 50,
  /** 默认文本框宽度（像素） */
  DEFAULT_WIDTH: 400,
  /** 最大文本框宽度（像素） */
  MAX_WIDTH: 600,
  /** 估算字符宽度（像素） */
  CHAR_WIDTH: 8,
};

插件链顺序

// 在 with-common.tsx 中
return withTextPastePlugin(withImagePlugin(newBoard));

插件按以下顺序处理粘贴事件：

1. withTextPastePlugin - 检查是否为纯文本，如果是则处理并返回
2. withImagePlugin - 检查是否为图片，如果是则处理并返回
3. 默认处理 - 处理其他类型的粘贴（如 Plait 元素）

使用方法

基本使用

1. 从任何地方复制文本（浏览器、编辑器、文档等）
2. 在 Opentu 画布上按 Ctrl+V (Windows/Linux) 或 Cmd+V (Mac)
3. 文本会自动插入到鼠标位置，并自动换行

示例

输入文本：

This is a very long line of text that exceeds the maximum character limit and should be automatically wrapped to multiple lines.

输出效果：

This is a very long line of text that exceeds
the maximum character limit and should be
automatically wrapped to multiple lines.

注意事项

1. 不影响现有功能

   • 图片粘贴功能正常工作
   • Plait 元素复制粘贴正常工作
   • 只处理纯文本粘贴

2. 文本宽度限制

   • 默认最大 50 字符/行
   • 可以通过修改 TEXT_CONFIG.MAX_CHARS_PER_LINE 调整

3. 中英文混排

   • 当前按字符数计算，中文字符和英文字符同等对待
   • 中文文本可能需要调整 MAX_CHARS_PER_LINE 参数

未来改进方向

1. 智能宽度检测

   • 根据实际字符宽度（中文 vs 英文）动态调整
   • 支持等宽字体和比例字体的不同处理

2. 用户配置

   • 在设置中允许用户自定义最大字符数
   • 支持开启/关闭自动换行功能

3. 富文本支持

   • 保留粘贴文本的格式（粗体、斜体等）
   • 支持 Markdown 格式自动转换

相关文件

• packages/drawnix/src/plugins/with-text-paste.ts - 文本粘贴插件实现
• packages/drawnix/src/plugins/with-common.tsx - 插件注册
• packages/drawnix/src/plugins/with-image.tsx - 图片粘贴插件（参考实现）
• packages/drawnix/src/mcp/tools/canvas-insertion.ts - 画布插入工具（文本插入参考）