腾讯企业邮箱 WebBridge 自动化

> 用途：通过 Kimi WebBridge 在浏览器环境中操作腾讯企业邮箱 Web 端。
> 核心挑战：iframe 嵌套 + 中文编码 + 动态 DOM 切换。

前置检查

操作前确认：
- [ ] 用户已登录 exmail.qq.com
- [ ] WebBridge 已注入目标页面
- [ ] 页面已完成初始加载（收件箱已渲染）

核心协议

1. 中文编码协议（强制）

WebBridge 传输 JS 会破坏 UTF-8 中文字面量。JS 代码中绝不写中文。

三种场景对应三种编码方式：

场景 A：富文本 DOM 操作

span.textContent = String.fromCharCode(20013, 25991); // "中文"

场景 B：读取中文返回
浏览器端返回码点数组：

(() => {
  const result = (() => { /* 原始代码 */ })();
  if (typeof result === 'string') {
    return JSON.stringify(Array.from(result).map(c => c.charCodeAt(0)));
  }
  return JSON.stringify(result);
})()

Python 端还原：

def decode_result(value):
    try:
        char_codes = json.loads(value)
        if isinstance(char_codes, list):
            return ''.join(chr(c) for c in char_codes)
    except:
        pass
    return value

辅助生成函数

def to_charcode_js(text):
    codes = [ord(c) for c in text]
    return f"String.fromCharCode({','.join(map(str, codes))})"

2. iframe 穿透协议

腾讯企业邮箱采用 iframe 嵌套，不跳转新 URL，内容动态切换。

快速定位所有 iframe

const iframes = document.querySelectorAll('iframe');
let results = [];
for (let i = 0; i < iframes.length; i++) {
  try {
    const doc = iframes[i].contentDocument;
    results.push({index: i, title: doc.title, textLen: doc.body.innerText.length});
  } catch(e) {}
}
return JSON.stringify(results);

3. 安全红线（不可违背）

• 绝不自动发送邮件 — 只能到草稿/关闭这一步
• 涉及发送的操作必须经过用户明确确认
• 提供的按钮操作仅限：存草稿、关闭

常见操作

回复/回复全部/转发

点击后等 1-2 秒，iframe[4] 切换为写信视图。

验证当前模式

const doc = document.querySelectorAll('iframe')[4].contentDocument;
const from_s = doc.querySelector('input[name="from_s"]');
return from_s ? from_s.value : 'not_found';

正文追加（不覆盖签名）

腾讯企业邮箱签名锚点：<sign signid="0">

const signEl = editorDoc.querySelector('sign');
const newDiv = editorDoc.createElement('div');
// ... 用 String.fromCharCode 构建内容 ...

if (signEl && signEl.parentNode) {
  signEl.parentNode.insertBefore(newDiv, signEl);
} else {
  editorDoc.body.appendChild(newDiv);
}

收件人读取

关键：收件人在 textContent 里，不在 value 里。

// 正确
const to = input.textContent; // "DoNotReply"<DoNotReply@notification.fortinet.net>;
// 错误
const to = input.value; // ""（空）

文件夹导航

通过 iframe[5]（folderlist）切换：

验证清单

• ✅ 读取邮件列表
• ✅ 打开邮件阅读
• ✅ 自动点击回复/回复全部/转发
• ✅ 修改主题
• ✅ 安全追加正文（不覆盖签名）
• ✅ 存草稿
• ✅ 关闭窗口
• ✅ 文件夹导航

未验证：附件操作、抄送/密送、新建邮件、删除邮件、邮件搜索。

详细参考

• 完整踩坑记录和调试技巧 → REFERENCE.md
• 编码协议实现细节 → REFERENCE.md 中文编码章节
• iframe 层级完整结构 → REFERENCE.md iframe 结构章节