Function createRangeForMatch

src/renderer/src/hooks/useSearchHighlight.ts:185–247

* 为单个匹配创建 Range

(
  container: HTMLElement,
  messages: ChatMessage[],
  match: SearchMatch
)

 * 为单个匹配创建 Range
 */
function createRangeForMatch(
  container: HTMLElement,
  messages: ChatMessage[],
  match: SearchMatch
): Range | null {
  const messageEl = container.querySelector(`[data-message-id="${match.messageId}"]`)
  if (!messageEl) return null

  // 查找消息内容区域
  const contentEl = messageEl.querySelector('.message-item__body')
  if (!contentEl) return null

  // 获取要匹配的文本
  const messageContent = messages.find((m) => m.id === match.messageId)?.content ?? ''
  const matchText = messageContent.slice(match.startOffset, match.endOffset)
  if (!matchText) return null

  // 收集所有文本节点
  const textNodes: Text[] = []
  const walker = document.createTreeWalker(contentEl, NodeFilter.SHOW_TEXT, null)
  let node: Text | null
  while ((node = walker.nextNode() as Text)) {
    if (node.textContent) {
      textNodes.push(node)
    }
  }

  // 在文本节点中查找所有匹配位置
  // 首先拼接所有文本节点的内容
  let fullText = ''
  const nodeOffsets: { node: Text; start: number; end: number }[] = []
  for (const textNode of textNodes) {
    const text = textNode.textContent ?? ''
    nodeOffsets.push({
      node: textNode,
      start: fullText.length,
      end: fullText.length + text.length
    })
    fullText += text
  }

  // 找到第 N 个匹配（根据 globalIndex 在该消息中的位置）
  // 计算这是该消息中的第几个匹配
  const matchIndexInMessage = countMatchesBefore(messages, match)

  let currentMatchIndex = 0
  let searchStartIndex = 0

  while (true) {
    const idx = fullText.indexOf(matchText, searchStartIndex)
    if (idx === -1) break

    if (currentMatchIndex === matchIndexInMessage) {
      // 找到了目标匹配，创建 Range
      return createRangeFromFullTextOffset(nodeOffsets, idx, idx + matchText.length)
    }

    currentMatchIndex++