电子邮件网页界面技能

描述

用于代理邮箱通信（如 Lourens、Ace 等）的网页界面。通过 Gmail/Gog CLI 集成，提供收件箱查看、草稿创建/编辑及邮件发送功能。

适用场景

• 用户需要访问代理邮箱收件箱时
• 需撰写并发送非机器人类邮件时
• 需查看和管理邮件草稿时
• 现有网页邮件界面操作笨重时

备选方案

方案 A：现有网页邮件解决方案

1. Roundcube（推荐）

   • 优点：成熟稳定、功能丰富、插件生态完善
   • 缺点：资源占用较高，基于 PHP 构建

2. RainLoop

   • 优点：界面现代、轻量级、移动端支持良好
   • 缺点：项目相对年轻、功能较少

3. SnappyMail

   • 优点：响应迅速、界面类似 Gmail
   • 缺点：较新项目，社区规模较小

方案 B：自定义界面

构建一个基于 React/Node.js 的自定义界面，具备以下能力：

• 通过 Gog CLI 接入 Gmail API
• 提供简洁、极简的用户界面
• 与 Mission Control 深度集成
• 针对我方具体需求定制开发

推荐方案

优先采用 Roundcube，并按需定制。Roundcube 具备以下优势：

• 开箱即用的完整邮件功能
• 支持 IMAP/SMTP（兼容 Gmail）
• 提供插件系统，便于扩展与定制
• 稳定可靠，文档完备

实施流程

1. 安装 Roundcube

# 安装依赖
apt-get update
apt-get install -y roundcube roundcube-core roundcube-mysql roundcube-plugins

# 或使用 Docker
docker run -d --name roundcube 
  -p 8081:80 
  -e ROUNDCUBEMAIL_DEFAULT_HOST=ssl://imap.gmail.com 
  -e ROUNDCUBEMAIL_DEFAULT_PORT=993 
  -e ROUNDCUBEMAIL_SMTP_SERVER=tls://smtp.gmail.com 
  -e ROUNDCUBEMAIL_SMTP_PORT=587 
  roundcube/roundcubemail

2. 配置 Gmail 访问权限

Ace 的 Gmail 账户需完成以下配置：

1. 应用专用密码（若启用两步验证）：在 Google 账户 → 安全性中生成
2. 启用 IMAP：设置 → 转发和 POP/IMAP → 启用 IMAP
3. 允许不够安全的应用（如需）：可能需开启“允许不够安全的应用”选项

3. Roundcube 配置

// config/config.inc.php
$config['default_host'] = 'ssl://imap.gmail.com';
$config['default_port'] = 993;
$config['smtp_server'] = 'tls://smtp.gmail.com';
$config['smtp_port'] = 587;
$config['smtp_user'] = 'ace.agent.email@gmail.com';
$config['smtp_pass'] = 'APP_PASSWORD_HERE';
$config['imap_conn_options'] = array(
  'ssl' => array(
    'verify_peer' => false,
    'verify_peer_name' => false,
  ),
);

4. 自定义集成（如需）

若 Roundcube 使用体验不佳，可构建自定义界面：

# 使用 Gog CLI 构建的自定义邮件界面
from flask import Flask, render_template, request, jsonify
import subprocess
import json

app = Flask(__name__)

class EmailInterface:
    def __init__(self):
        self.gog_path = "/usr/local/bin/gog"
    
    def get_inbox(self, limit=50):
        """通过 Gog CLI 获取收件箱邮件。"""
        cmd = [self.gog_path, "gmail", "messages", "list", 
               "--limit", str(limit), "--format", "json"]
        
        try:
            result = subprocess.run(cmd, capture_output=True, text=True)
            if result.returncode == 0:
                return json.loads(result.stdout)
        except Exception as e:
            print(f"获取收件箱失败：{e}")
        
        return []
    
    def get_message(self, message_id):
        """获取指定邮件内容。"""
        cmd = [self.gog_path, "gmail", "messages", "get",
               message_id, "--format", "json"]
        
        try:
            result = subprocess.run(cmd, capture_output=True, text=True)
            if result.returncode == 0:
                return json.loads(result.stdout)
        except Exception as e:
            print(f"获取邮件失败：{e}")
        
        return None
    
    def send_email(self, to, subject, body):
        """通过 Gog CLI 发送邮件。"""
        cmd = [self.gog_path, "gmail", "messages", "send",
               "--to", to, "--subject", subject, "--body", body]
        
        try:
            result = subprocess.run(cmd, capture_output=True, text=True)
            return result.returncode == 0
        except Exception as e:
            print(f"发送邮件失败：{e}")
            return False

@app.route('/')
def inbox():
    """收件箱视图。"""
    email_iface = EmailInterface()
    messages = email_iface.get_inbox(limit=20)
    return render_template('inbox.html', messages=messages)

@app.route('/message/')
def view_message(message_id):
    """查看指定邮件。"""
    email_iface = EmailInterface()
    message = email_iface.get_message(message_id)
    return render_template('message.html', message=message)

@app.route('/compose', methods=['GET', 'POST'])
def compose():
    """撰写新邮件。"""
    if request.method == 'POST':
        to = request.form['to']
        subject = request.form['subject']
        body = request.form['body']
        
        email_iface = EmailInterface()
        success = email_iface.send_email(to, subject, body)
        
        return jsonify({'success': success})
    
    return render_template('compose.html')

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8082, debug=True)

5. 与 Mission Control 集成

将邮件界面添加至 Mission Control 侧边栏：

// mission-control 侧边栏配置
{
  name: "📧 Ace Email",
  path: "/email",
  icon: "email",
  external: true,
  url: "http://localhost:8081"  // Roundcube
  // 或："http://localhost:8082"  // 自定义界面
}

6. 安全注意事项

1. HTTPS：使用带 SSL 的反向代理
2. 身份认证：为邮件界面增加登录机制
3. 速率限制：防止滥用
4. 日志记录：监控邮件访问行为
5. 备份机制：定期备份重要邮件

实施步骤

第一阶段：快速部署（今日）

1. 通过 Docker 安装 Roundcube
2. 使用 Ace 的 Gmail 凭据完成配置
3. 测试基础邮件功能（收发、查看等）
4. 在 Mission Control 中添加快捷入口

第二阶段：定制优化（本周）

1. 评估 Roundcube 的实际可用性与用户体验
2. 若体验不佳，启动自定义界面开发
3. 实现核心功能：
   • 支持会话线程的收件箱
   • 富文本编辑的撰写界面
   • 草稿自动保存
   • 全文搜索功能

第三阶段：深度集成（下周）

1. 与 Mission Control 实现深度集成（状态同步、上下文共享等）
2. 新增新邮件通知系统
3. 内置常用回复模板
4. 增强搜索与高级筛选能力

测试清单

• 可正常查看收件箱
• 可正常阅读邮件内容
• 可正常撰写新邮件
• 可正常发送邮件
• 可正常保存草稿
• 搜索功能可用
• 移动端适配良好
• 安全机制完备（HTTPS、身份认证等）

备用方案

若 Roundcube 实际运行效果不理想：

1. 尝试 RainLoop（更轻量的替代方案）
2. 构建最小可行自定义界面
3. 直接调用 Gog CLI，搭配简易 Web 封装层

参考资料

• Roundcube：https://roundcube.net
• Gmail IMAP 设置说明：https://support.google.com/mail/answer/7126229
• Gog CLI：https://github.com/openclaw/gog
• Mission Control 集成指南