Bilibili Private Messaging

通过浏览器自动化发送B站私信、获取聊天记录。

⚠️ 执行模式

重要：连续执行所有步骤，中途不要停止！

⚠️ 减少快照

快照数据量大，可能导致网络超时。只在必要时获取快照： - 第一次：打开页面后，需要找到用户 - 最后一次：发送后确认结果

点击后不需要快照，直接发送消息！

前置条件

用户需要在浏览器中已登录 B站账号
需要知道目标用户的用户名（支持部分匹配）

发送私信流程

步骤 1：打开页面

browser action=open targetUrl=https://message.bilibili.com/#/whisper

步骤 2：获取快照，找到用户

browser action=snapshot

在快照中找到目标用户（按用户名部分匹配），记录 ref。

步骤 3：点击进入对话

browser action=act request={"kind": "click", "ref": "<用户ref>"}

步骤 4：直接发送消息（不要获取快照！）

点击后立即用 JavaScript 发送，不要再获取快照：

() => {
  const inputArea = document.querySelector('[contenteditable="true"]');
  if (inputArea) {
    inputArea.textContent = '消息内容';
    inputArea.dispatchEvent(new InputEvent('input', { bubbles: true }));
    const sendBtn = document.evaluate(
      "//div[contains(text(), '发送')]", 
      document, 
      null, 
      XPathResult.FIRST_ORDERED_NODE_TYPE, 
      null
    ).singleNodeValue;
    if (sendBtn) sendBtn.click();
    return 'Message sent';
  }
  return 'Input not found';
}

步骤 5：获取快照确认发送成功

browser action=snapshot

确认消息已出现在聊天记录中，然后向用户报告结果。

获取聊天记录

⚠️ 重要：确定发送方的方法

B站私信的 DOM class 哈希值（如 _MsgIsMe_o7f0t_9）可能因用户/会话不同而变化，不能硬编码！

推荐方法：通过头像位置判断

先获取快照或截图，观察消息布局
左侧头像 = 对方发送的消息
右侧头像 = 自己发送的消息

通过头像位置提取聊天记录

() => {
  const main = document.querySelector('main');
  if (!main) return 'No main';

  const msgBlocks = main.querySelectorAll('[class*="_Msg_"]');
  const messages = [];

  msgBlocks.forEach(block => {
    const text = block.textContent.trim();

    // 提取日期
    const dateMatch = text.match(/(202[56]年d+月d+日 d+:d+|今天 d+:d+)/);

    if (dateMatch) {
      const date = dateMatch[1];
      let content = text.replace(dateMatch[0], '').trim();
      content = content.replace(/^(d+:d+)?/, '').trim();

      if (content && content.length > 1) {
        // 通过头像位置判断发送方
        const img = block.querySelector('img');
        let sender = '对方'; // 默认

        if (img) {
          const imgRect = img.getBoundingClientRect();
          const blockRect = block.getBoundingClientRect();
          // 如果头像在右侧，是自己发送的
          if (imgRect.left > blockRect.left + blockRect.width / 2) {
            sender = '自己';
          }
        }

        messages.push({
          date,
          sender,
          content: content.substring(0, 200)
        });
      }
    }
  });

  // 去重
  const seen = new Set();
  return messages.filter(msg => {
    const key = msg.date + msg.content.substring(0, 50);
    if (seen.has(key)) return false;
    seen.add(key);
    return true;
  });
}

备用方法：通过 class 名称包含 "Me" 判断

如果 class 名称包含 "Me" 或 "Self" 等关键词，可以辅助判断：

const className = block.className;
const isMe = className.toLowerCase().includes('me') || 
             className.toLowerCase().includes('self');

但要注意： 哈希值部分可能变化，不要依赖完整的 class 名！

滚动加载历史记录

B站私信使用懒加载，需要滚动才能加载更早的记录：

() => {
  // 查找滚动容器（通过 overflow 样式）
  const allElements = document.querySelectorAll('*');
  for (const el of allElements) {
    const style = window.getComputedStyle(el);
    if ((style.overflow === 'auto' || style.overflowY === 'auto') && 
        el.scrollHeight > el.clientHeight &&
        el.closest('main')) {
      el.scrollTop = 0;
      return 'Scrolled container: ' + el.className;
    }
  }
  return 'No scroll container found';
}

滚动后等待 1-2 秒让内容加载，再获取快照或提取消息。

注意事项

消息长度限制：500字符（超过需分段发送）
发送频率有限制，避免刷屏
如果找不到用户，先向用户确认用户名是否正确
获取历史记录时可能需要多次滚动触发懒加载
不要硬编码 DOM class 的哈希值，它们可能变化！用头像位置或关键词判断更可靠

bilibili-messager

Installation